Test-AC

Camera request command

A new camera request has been added, which allows the server to request files from a camera. It is also possible to to have two identical cameras connected at once. The format is as provided below in the table:

Command	Arguments	Explanation
camreq:	<file_type> <file_source> <timestamp> <duration> <domain> <port> <resolution> (Only applied to photos)	Captures appropriate file with the provided details. If the connection to server is opened, the files immediately become available for download. If not, then connection is attempted. If <domain> and <port> parameters are included, the device will send footage of the command to that address. If <resolution> parameter is included when requesting a photo, the device will send the photo with the selected resolution. Please note, that if the resolution parameter is not included in the SMS/GPRS command, the device will request a photo with configured resolution.
icam_req:	<camera_type> <peripheral> <file_type> <timestamp> <duration> <resolution> <domain> <port>	This command is used ONLY when both of the connected cameras are of the same type. It works only on DualCam or DashCam devices. If the <file_type> is a video, both <timestamp>and <duration>become mandatory. If the <file_type> is an image, <duration> and <timestamp> are not allowed. If the <file_type> is a timestamp image, <timestamp> is mandatory, whereas <duration> is not allowed. If an argument in the given context is optional and is not provided, its value will be taken from the device configuration.

The arguments are as follows:

• <file_type>
  • 0 - Video
  • 1 - Photo

• <file_source>
  • 1 - Front camera
  • 2 - Rear camera
  • 3 - Both cameras

• <timestamp>
  • Unix timestamps in decimal (not required for photo download)

• <duration>
  • Video duration in seconds from provided timestamps (not required for photo download), (max 30 sec)

• <resolution> (Only applied to photos)
  • 0 – Use the resolution provided in the configuration
  • 1 – 160x120
  • 2 – 320x240
  • 3 – 640x480
  • 4 – 1280x720
  • 5 – 1920x1080

• <type>
  • 0-DSM
  • 1-MDAS
  • 2-DualCam front
  • 3-DualCam rear
  • 4-DashCam

• <Peripheral>
  • 1-COM1
  • 2-COM2

camreq: Structure examples:

camreq:<file type>,<file source>(if video, add ",<timestamp>,<duration>)

However, if there is a need to send to the specific server without configuring, you can add two extra parameters. The complete structure:

camreq:<file type>,<file source>(if video, add ",<timestamp>,<duration>),<domain>,port

For example: camreq:0,1,1624960616,5,212.59.13.226,7160

camreq:1,<file source>,<domain>,<port>,<resolution>

Upload with domain, port, and resolution provided by a request. Example: camreq:1,1,192.168.1.1,12345,4

icam_req: Structure examples:

icam_req:<camera_type>,<peripheral>,<file_type>,<resolution>,<domain>,<port>

Usage example: 1,2,0,1,server.com,1234

icam_req:<camera_type>,<peripheral>,<file_type>,<timestamp>,<domain>,<port>

Usage example: 1,2,1,1609459200000,server2.com,5678

icam_req:<camera_type>,<peripheral>,<file_type>,<timestamp>,<duration>

Usage example: 1,2,2,1609459200000,10

Conditions	Command response
Request successful and server connection successful. Device is ready to send selected file	Photo request from source <1-3>. (If photo request) Video request from source <1-3> for <1-30> seconds since YYYY-MM-DD HH:MM:SS. (If video request)	Preparing to send file from timestamp <timestamp of the file>
Request successful but the device was already connected to the server. Device is ready to send selected file		Already connected. Preparing to send file from timestamp <timestamp of the file>
Request received but the capture failed		Error: capture failed
Request received but the device cannot proceed with the capture and sending because ignition is off		Error: Cannot capture because ignition is off
Request received but the previously captured and prepared photo/video was not sent. New media is not captured. The device is ready to send the previous capture		Warning: Photo / Video already captured previously, trying to send it
Request received but the device was already connected to the server. New media is not captured. The device is ready to send previous capture		Already connected. Warning: Photo / Video already captured previously, trying to send it
Request received but the camera doesn’t acknowledge sent command. Nothing will be sent		Error: DualCam NAK
Request received but the camera is not connected or not working		Error: DualCam not present
Request received but the camera is not connected or not working		Error: requested file does not exist
Request received but the device cannot connect to the server		Error: connect to server
Request received but the modem is not ready for operation (network or modem issue)		Error: modem not ready to start send
Request received but the device cannot proceed with the capture and sending because the camera is being reconfigured		Cannot send, DualCam configuration is in progress
Request received but file capture time was exceeded.		Error: Media request timeout
Request received but capture completed incorrectly		Error: Media request problem
File type parameter incorrect in the request command	Error: Invalid	File Type	argument in camera request cmd!
File Source parameter incorrect in the request command		File Source
Timestamp parameter incorrect in the request command		Timestamp
Duration parameter incorrect in the request command		Duration
Cannot proceed with the request, ignition is off	Error: Ignition not detected!
Request command structure incorrect	Error: Invalid camera request command!
RS232 and DualCam mode is not enabled	Error: DualCam is not configured!
Front or rear camera not found	Error: Front / Rear Camera not present