Teltonika DualCam

Introduction to the product

Teltonika DualCam is connected to FMX125 and FMU126 devices using the RS232 interface.

How to insert microSD cards

Teltonika DualCam can hold 2 x microSD cards, which are inserted on both sides of the camera (front and rear).
When the card is inserted correctly, it locks in with a "click". How the cards are inserted is depicted in the photos.

Basic characteristics

Technical data	Description
Supported by	FMC125, FMM125, FMU125, FMU126, FMB125
Day & Night Vision Effect	Day (Color), Night (Black & White)
Angle of View	Horizontal 120°, Vertical 70°
Dual Camera	Front and Rear (equal characteristics)
Camera casing dimensions	126.2 x 36.6 x 36.6 mm
Camera mounting	Sticky tape (3M) or screws
Supported microSD card sizes	16 GB, 32 GB, 64 GB

Electrical parameters	Description
Input voltage range	9 ~ 36 V
Working temperature and humidity	Temperature: -30 °C ~ 85 °C Humidity: <90%
Stand-by electric current	60 mA

Function parameters	Description
Real time clock (RTC) synchronization	Available over FM (via NTP, NITZ or GNSS)
Picture resolution	1280 x 720 (default) (50KB transfer period 18 sec), Configurable: 160 x 120; 320 x 240; 640 x 480; 1920 x 1080
IR Distance	2 Meters
Cable length	RS232 (3.5 m)
Video compression	H.265
Video resolution	720P (20 sec. – 6MB, transfer period ~ 320 sec.)
Video storage	2psc. MicroSD card (Max 64GB up to 72 hours of video)

Certifications & Approvals

• Teltonika DualCam REACH

Installation

To connect the DualCam to a supported device, you have to make sure to connect 4 PINs of the camera to the PINs of your device correctly.

PIN NUMBER	PIN NAME	DESCRIPTION
1	RS232-Tx	DualCam output for data transmission through RS232
2	RS232-Rx	DualCam input for data reception through RS232
3	VCC(9-36V) (+)	Power supply for the DualCam
4	GND (-)	Ground

DualCam RS232 camera support

DualCam camera support was introduced from firmware version 03.27.00.Rev.100. A new RS232 mode "DualCam" was added with parameters for setting control. The details of the RS232 mode parameter are provided in the table below.

Parameter name	Parameter ID	Parameter value
RS232 Mode	151	18

Configuration version 8.1.6.0 has to be used if configuration is being made in offline mode.

Camera Feature Settings

Once this mode is enabled, new tab “Camera Settings” appears on the left sidebar. This will contain the main parameters for configuring the camera settings The parameter IDs and values are provided in the table below. Once configuration is saved to device, these parameters are updated.

Parameter name	Parameter ID	Parameter values	Default values
Camera Picture Resolution	66000
		0 - 160 x 120	3
		1 - 320 x 240
		2 - 640 x 480
		3 - 1280 x 720
		4 - 1920 x 1080
Camera Picture Compression	66001	[0 - 100] (%)	50
OSD Display	66002	0 - Disabled	0
		1 - Enabled
Video Frame Rate	66003	20, 25 and 30 (frames per second)	30

OSD display - On Screen Display feature displays date and time in the upper left corner of the photo. This feature can be enabled or disabled.

Camera Scenario Settings

"Camera settings" tab also contains scenario settings that trigger camera video/photo capture when specific condition is met.

Parameter name	Parameter ID	Parameter values	Default values
Periodic Image sending	66006	0 - Disabled	0
		1 - Enabled
Sending interval	66007	[10-1800] (seconds)	600
Image Sending Trigger	66022
		0 - None	0
		1 - DIN1
		2 - DIN2
		3 - Crash
		4 - Towing
		5 - Idling
		6 - Geofence
		7 - Unplug
		8 - Green Driving
Video sending trigger	66023
		0 - None	0
		1 - DIN1
		2 - DIN2
		3 - Crash
Video duration before trigger	66009	[1-10] (seconds)	5
Video duration after trigger	66010	[1-10] (seconds)	5

Periodic image sending scenario

Periodic image sending triggers photo capture from a front camera, whenever the timeout is reached (sending interval parameter).

Update: Since 03.27.03.Rev.04 firmware, Periodic Image Sending Enable/Disable switch was replaced by a camera selection:

• Both cameras deselected – periodic image sending is disabled (value 0)
• Front camera selected – front camera’s pictures will be sent periodically (value 1)
• Rear camera selected – rear camera’s pictures will be sent periodically (value 2)
• Both cameras selected – both cameras’ pictures will be sent periodically (value 3)

If the camera has not finished uploading pictures to the server, then the photo capture is skipped.

Video sending by trigger

Video sending by trigger scenario monitors the selected trigger (video sending trigger parameter) and captures video before and after the event (video duration before trigger and video duration after trigger parameters). If the previously captured video has not finished downloading, then a new video capture is skipped until the old one has been sent. When this scenario is triggered, high priority eventual record is generated with the value corresponding to what triggered the scenario. See the table below.

Parameter name	Parameter AVL ID	Parameter value
SOS trigger	499	0 - Server request
		1 - DIN1
		2 - DIN2
		3 - Crash

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)

Conditions	Command response
Arguments are invalid	Invalid argument in camera request cmd!
Photo requested	Request for photo from source <1-3> received
Video requested	Request for video from source <1-3> received for <1-30> seconds since YYYY-MM-DDHH:MM:SS

Camera ping transmission and TF status checking

Camera pinging was implemented to periodically check if a camera is connected to a device. This is done via “Get TF status” command for both front and rear camera every 20 seconds when ignition is on. The received result from this command is stored in two corresponding AVL elements “Front camera state” and “Rear camera state”. The following do not only store TF status, but also if response from the camera was received or not.

Parameter name	Parameter AVL ID	Parameter values
Front camera state:	498	0 - Camera not detected
		1 - No card
Rear camera state:	497
		2 - Card mount failed
		3 - Card mounted
		4 - Card faulty

Camera RTC synchronization

Camera RTC synchronization is done anytime the device itself is synchronized (via NTP, NITZ or GNSS).

How to read camera data from SD card

The software for reading camera data can be downloaded here

Data reading steps:

1. Double-click “VideoPlayer.exe” to open the player
2. When the software starts, first select the directory where the TF card files are located. Once located, click "OK". The software starts analyzing the pictures and videos existing in the TF card files.
3. Software will automatically detect the video and picture in the TF card files, which will last for a few seconds and then enter the software, as shown.,

The upper part of the software is a calendar. You can choose to view whether there is a video in the current month according to the year and month. The number of the year/month can be entered by keyboard after selecting it, and then press the “Enter” key to jump to the entered year/month. You can press to view the previous year/month and to view the next year/month. The date of the recorded video in the current month will be marked in blue. The lower part of the software is the preview interface, divided into two parts: "Video View" and "Image View".

Video View

Video view shows the video information. Left click on the date of the video in the calendar, then the following "Video View" section will show which time period there is a video, as shown. For video recording, the time period during which the video is recorded will be marked in blue.

Click on the blue part of the timeline to get the time you clicked, and the video thumbnail of the current time will be displayed in the middle of the screen. The timeline length is 24 hours and it is difficult to locate the exact number of seconds. Hold down the timeline with the left mouse button and then swipe to the right to zoom in on the timeline. For example, we need to carefully view the video at 05:00-07:00. Then, the left mouse button is pressed at the 05:00 position and slide to the right to the position of 07:00, so that this part of time can be enlarged to the entire timeline.

Note: If you need to restore, then left-click and hold the time axis to slide left.

Video Playback

Left click on the timeline will view the video thumbnail of the clicked time point, and double click the left mouse button to start playing the video from the current time. By default, the video will be played for two minutes from the selected time. If you click to find the location you want to play, you don't need to move the mouse, double click again will pop up the play form.

Video playback interface contains
	Stop button		Speed up play button
	Pause button		Screenshot button
	Slow down play button		Full screen button

Note: Closing the current playback interface does not exit the player software.

Image view

"Image View" displays the image information (the camera saves the image in the TF card after the person takes the initiative to take the photo, here you can see the photo taken by the camera). We first click on "Image View" to switch the software to the image page.

After switching to the picture interface, you can view when the photo is taken according to the directory. As shown below, after expanding the index, we can see how many pictures in total were taken.

After the expansion, click the time of the image generation to see the preview on the left side. Clicking on the preview image will pop up the image viewing window. The size of the window is the size of the image itself. The scroll wheel zooms in and out of the picture. You can right click on the preview to save the original image to your hard disk.

Export MP4

Click the "Convert" button to convert the video in the TF card to MP4 and export it.

Then first select the folder you want to export to, enter the MP4 start time and end time to be exported, and then click Export, if you need, cancel the export.

Then wait for the export to complete. The time of export is not certain. Depending on the performance of the computer, it takes about 1 to 5 minutes for each 1-hour duration video.

Other camera related functionality

Camera is configured if all of these conditions are met:

1. RS232 mode is selected (DualCam)
2. Camera was not configured since startup or one of the related parameters were changed (compression, framerate or OSD)
3. Camera file transfer is not active

Active camera reconfiguration is accompanied by two consecutive camera shutter clicks. If camera is disconnected and later reconnected, a device will detect it by periodic camera ping packet. Once camera is detected, the device will reissue the reconfiguration procedure.

Camera file transfer reconnection

If FMU1YX device has bad reception, server is not reachable or wrong server details are configured, then the device tries to open a link to a camera server few consecutive times. If no connection was possible to be established, then the connection is postponed for 30 minutes and tried again (or tried every configured sending interval if periodic image sending is enabled).

DualCam camera file transfer support

Once camera has at least one file captured, it starts connection to a remote server, which is configured by parameters “Domain” and “Port” found in the “Camera Settings” tab.

Initialization packet

On connection, a device sends an initialization packet.

Header(0x0000)	Protocol ID	IMEI	Settings
2 bytes	2 bytes	8 bytes	4 bytes

Protocol ID – just a reference for the protocol version that is running on a device (for server cross compatibility with older versions). Firmware FMB.Ver.03.27.00.Rev.100 and up have protocol ID 5. Settings flag contains information on what is available for download. Structure is provided below:

Settings, 4 B
Byte 3								Byte 2								Byte 1								Byte 0
		1	2	3	4

1. Video, rear (%videor)
2. Video, front (%videof)
3. Photo, rear (%photor)
4. Photo, front (%photof)

If identifier sent to a server is not valid, device disconnects.

General command structure

General communication packet structure is as in the table bellow. It consist of CMD_ID (2 bytes), Data length of a command and a payload.

Command ID	Data length	Data
2 bytes	2 bytes	[data length] bytes

Communication protocol

Close a session command (CMD ID 0x0000)
In case when a device connects to a server, but the server does not expect it to connect, server will respond by sending a CLOSE command after which the connection will be terminated. This command is also used when device connects to a server for a custom file sending and server finishes to send all custom files to the device.

Command ID	Data length
0x0000	0x0000

Start file transfer command (CMD ID 0x0001)
After device received file request command from the server (0x0008) device sends START command with file data (packet count).

Command ID	Data length	File Packets (4 bytes)	Blank field (2 bytes)
0x0001	0x0006	0x12345678	0x0000 (always same value)

File request command (CMD ID 0x0008)
After device is connected for a file upload, server initiates file transfer by sending a FILE REQ command.

Command ID	Data length	File Identifier
0x0008	2 bytes	See the table below

Device should answer with a START command described above indicating a size and CRC of the requested file.

File source, type	Identifier (ASCII chars)
Photo from camera, rear	%photor
Photo from camera, front	%photof
Video from camera, rear	%videor
Video from camera, front	%videof

Resume file transfer command (CMD ID 0x0002)
In a response to the START command a RESUME command must be sent from server.

Command ID	Data length	Packet offset (4 bytes)
0x0002	0x0004	0x00000001

To begin file transfer from the start, offset should be set to 1 (4 bytes value). In case when the file transfer was interrupted, to resume file transfer, offset can be set to the desired value (1 ≤ [offset] ≤ [file packets]).

Synchronize file transfer command (CMD ID 0x0003)
In a response to the RESUME command a SYNC command is sent from device.

Command ID	Data length	File offset (4 bytes)
0x0003	0x0004	0x00000001

By sending SYNC command it is ensured that next data command will contain file data starting from the specified offset.

File data transfer command (CMD ID 0x0004)
After sending a SYNC command, a file data transfer is started by sending DATA commands.

Command ID	Data length	File data (up to 1024 bytes)	Data CRC (2 bytes)
0x0004	0x0402	...	...

A File data is split into 1024 byte parts, each part wrapped into a DATA command and is sent.
Note: if a command with a bad CRC is received, RESUME command should be sent with the last valid file offset, after receiving a RESUME command, server will stop sending DATA commands and continue communication from “Resume file transfer” step.
CRC polynomial expression: 0x8408 Initial value, when calculating CRC, is previously received packet (CMD ID 0x0004) CRC value.

File transfer status command (CMD ID 0x0005)
After a file transfer is completed and no more files are required from the device, a server should send a COMPLETED command to the device (this command does not work after executing repeat init command0 x0009 – in this case the server should send a CLOSE SESSION 0x0000 command mentioned before).

Command ID	Data length	Status (4 bytes)
0x0005	0x0004	0x00000000

In case of the server using invalid arguments, commands or not following the file request flow, the device will send this command with a Status field set to one of the few possible error codes. List of possible ones is provided below.

Status value (hexadecimal)	Description	Notes
0x00000000	File transfer process completed	Sent from server
0x00000002	Failed to close GPRS	Sent from device
0x00000003	Failed to close socket	Sent from device
0x00000005	Invalid response from server to init packet	Sent from device
0x00000011	This error code forces the device to disconnect from server	Sent from device. Possible causes: Camera is not configured The requested file is not available by camera

After a COMPLETED command device should disconnect from the server.

Initialization packet repeat command (CMD ID 0x0009)
When sent, the initialization packet is repeated. This is used, when all of the files are downloaded and additional check is carried out for any additional files, that may have been captured during the download operation.

File transfer visual flow