Difference between revisions of "DualCam SMS commands"

From Wiki Knowledge Base | Teltonika GPS
m
(Created page with "==Camera firmware version== Additional SMS/GPRS command for cameras’ firmware checking. Since both cameras are separate, there are two versions returned. {| class="wikitab...")
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__TOC__
 
 
==Camera firmware version==
 
==Camera firmware version==
  
Line 35: Line 34:
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |camreq:
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |camreq:
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |<file_type>,<file_source>,<timestamp>,<duration>
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |<file_type>,<file_source>,<timestamp>,<duration>
,<domain>,<port>,<u><resolution>(Only applied to photos)</u>
+
,<domain>,<port>
| rowspan="1" style="text-align: left; style=" width: 150px; background: white; color: black;" |Captures appropriate file with the provided details. If the connection to server is opened, them files immediately become available for download. If not, then the connection is tried to be made. <br>If <b><domain></b> and <b><port></b> parameters are included, the device will send footage of the command to that address.<br>
+
| rowspan="1" style="text-align: left; style=" width: 150px; background: white; color: black;" |Captures appropriate file with the provided details. If the connection to server is opened, them files immediately become available for download. If not, then connection is tried to be made. If <domain> and <port> parameters are included, the device will send footage of the command to that address.
If <b><resolution></b> parameter is included when requesting a photo, the device will send the photo with the selected resolution.
 
<br><b>Please note,</b> that if the resolution parameter is not included in the SMS/GPRS command, the device will request a photo with configured resolution.
 
 
|}
 
|}
 
The arguments are as follows:
 
The arguments are as follows:
Line 45: Line 42:
 
**0 - Video
 
**0 - Video
 
**1 - Photo
 
**1 - Photo
 
 
*<file_source>
 
*<file_source>
 
**1 - Front camera
 
**1 - Front camera
 
**2 - Rear camera
 
**2 - Rear camera
 
**3 - Both cameras
 
**3 - Both cameras
 
 
*<timestamp>
 
*<timestamp>
 
**Unix timestamps in decimal (not required for photo download)
 
**Unix timestamps in decimal (not required for photo download)
 
 
*<duration>
 
*<duration>
 
**Video duration in seconds from provided timestamps (not required for photo download), (max 30 sec)
 
**Video duration in seconds from provided timestamps (not required for photo download), (max 30 sec)
 
*<resolution> (<b>Only applied to photos</b>)
 
**0 – Use the resolution provided in the configuration
 
**1 – 160x120
 
**2 – 320x240
 
**3 – 640x480
 
**4 – 1280x720
 
**5 – 1920x1080
 
  
 
'''Structure examples:'''
 
'''Structure examples:'''
Line 75: Line 61:
  
 
For example: camreq:0,1,1624960616,5,212.59.13.226,7160
 
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
 
 
  
  
Line 93: Line 74:
  
  
Video  request from source <1-3> for <1-30> seconds since YYYY-MM-DD  HH:MM:SS.
+
Video  request from source <1-3> for <1-255> seconds since YYYY-MM-DD  HH:MM:SS.
  
 
'''(If  video request)'''
 
'''(If  video request)'''
Line 164: Line 145:
 
|}
 
|}
 
<br>
 
<br>
 
==Camera SD card format command==
 
The following command will format the SD card of the selected camera, and return the status (success or fail) of the format SD card command.
 
 
{| class="wikitable"
 
|+
 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Command'''
 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Arguments'''
 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Explanation'''
 
|-
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |camget_sdformat:
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |<cam id>
 
| rowspan="1" style="text-align: left; style=" width: 150px; background: white; color: black;" |
 
*1 – Front camera
 
*2 – Rear camera
 
|}
 
Example: <b>camget_sdformat:1</b>
 
 
==Camera restart command==
 
The following command will restart the selected camera, and return the status (success or fail) of the sent command
 
 
{| class="wikitable"
 
|+
 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Command'''
 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Arguments'''
 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Explanation'''
 
|-
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |camget_restart:
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |<cam id>
 
| rowspan="1" style="text-align: left; style=" width: 150px; background: white; color: black;" |
 
*1 – Front camera
 
*2 – Rear camera
 
|}
 
Example: <b>camget_restart:1</b>
 
<br>
 
 
 
[[Category:Teltonika DualCam]]
 

Revision as of 13:59, 14 July 2022

Main Page > Video Solutions > Teltonika DualCam > DualCam SMS commands

Camera firmware version

Additional SMS/GPRS command for cameras’ firmware checking. Since both cameras are separate, there are two versions returned.

Command Arguments Explanation
camgetver None Used to check firmware versions.

Returns version in the format: V<major>.<minor>.<revision>. For example, V1.9.3.

Because there are two cameras, two versions are returned. The complete response would look like this: Front camera V1.9.3. Rear camera V1.9.3.

If there are problems reading the version or if the camera is not responding/connected, the return would be this: The front camera camgetver failed. The rear camera camgetver failed.

Camera request command

A new camera request has been added, which allows the server to request files from a camera. The format is as provided below in the table:

Command Arguments Explanation
camreq: <file_type>,<file_source>,<timestamp>,<duration>

,<domain>,<port>

Captures appropriate file with the provided details. If the connection to server is opened, them files immediately become available for download. If not, then connection is tried to be made. If <domain> and <port> parameters are included, the device will send footage of the command to that address.

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)

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


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-255> 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