Jump to content

Test-AC: Difference between revisions

From Teltonika Telematics Wiki
No edit summary
No edit summary
 
(38 intermediate revisions by one other user not shown)
Line 1: Line 1:
==Camera request command==
=External RTK coordinate via CAN/RS232 interface with FMC650=
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:
==Overview==
{| class="wikitable"
Activating '''RTK (Real-Time Kinematic)''' coordinate acquisition enables the FMC650 device to process RTK data from CAN.
|+
When configured, the RTK module can provide high-precision coordinates using:
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Command'''
*RTK receiver via RS232 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Arguments'''
*RTK data via CAN 
! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Explanation'''
*Internal GNSS receiver (GNS) as fallback 
|-
The device automatically chooses the best available source based on configuration and data quality.
| 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> <br>
''<file_source> <br>
''<timestamp> <br>
''<duration> <br>
''<domain> <br>
''<port> <br>
<u>''<resolution>''<br>(Only applied to photos)</u>
| 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, the files immediately become available for download. If not, then connection is attempted.  


*If <b><domain></b> and <b><port></b> parameters are included, the device will send footage of the command to that address.
The following specifications indicate the minimum firmware and configurator version requirement to use RTK coordinate acquisition via CAN on FMC650.


*If <b><resolution></b> parameter is included when requesting a photo, the device will send the photo with the selected resolution.
*<b>Platform:</b> FM65 
*<b>Device:</b> FMC650 
*<b>Firmware version:</b> 03.01.03.Rev.228 
*<b>Configurator version:</b> B.FMX6_R.192 


<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.
==Method of Operation==
|-
When the RTK option is enabled, the device always tries to use RTK sources first and falls back to internal GNSS if needed.
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |icam_req:
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |
''<camera_type><br>
''<peripheral><br>
''<file_type><br>
''<timestamp><br>
''<duration><br>
''<resolution><br>
''<domain><br>
''<port><br>
|
This command is used '''ONLY''' when both of the connected cameras are of the same type. It works only on DualCam or DashCam devices.
|}
The arguments are as follows:


*<camera_type>
'''Source priority'''
**0-DSM
#'''RS232 (primary RTK source)'''
**1-MDAS
#:*The device checks whether any COM port (COM1 or COM2) is configured in RTK mode. 
**2-DualCam front
#:*If at least one COM port is configured for RTK and valid data is present, coordinates are taken from RS232. 
**3-DualCam rear
#'''CAN RTK (secondary RTK source)'''
**4-DashCam
#:*If RS232 RTK data is not available or is invalid, the device checks the CAN RTK status. 
#:*If valid CAN RTK data is available, coordinates are taken from CAN. 
#:*A timing check is applied if the time difference between received CAN RTK frames is greater than 2 seconds. The device automatically switches to the internal GNSS receiver (GNS) to keep coordinates up to date.
#'''Internal GNSS (GNS) Fallback'''
#:*If neither RS232 nor CAN provide valid RTK data, the device uses the internal GNSS receiver (GNS) for coordinates. 
#'''RTK Disabled'''
#:*If the RTK option is disabled, coordinates are always taken from the internal GNSS receiver.


*<peripheral>
'''RTK data from CAN'''
**1-COM1
**2-COM2


*<file_type>
When CAN is used as the RTK source, the device reads: 
**0- Video
*'''Latitude''' 
**1 - Photo
*'''Longitude''' 
*'''Altitude''' 
*'''Ground speed''' 
*'''Course'''


*<file_source>
These values are taken from standard CAN messages designed for GNSS/RTK data. Exact PGNs and signal layouts depend on whether external RTK/ECD/ISOBUS system is being used.
**1 - Front camera
**2 - Rear camera
**3 - Both cameras


*<timestamp>
==Configurator Setup== 
**Unix timestamps in decimal (not required for photo download)
This section describes how to enable RTK as a location source and configure RS232 and CAN usage through the Configurator.


*<duration>
'''Enabling RTK as a location source'''
**Video duration in seconds from provided timestamps (not required for photo download), (max 30 sec)
[[File:Source Location from RTK.png|right]]
#Open the Configurator and connect to the FMC650 device.
#Navigate to the System tab. 
#Find the option “Source Location from RTK” in the '''System Settings''' section.
#Set this option to '''Enable'''.


*<resolution> (<b>Only applied to photos</b>)
When enabled, the device will use RTK data from RS232/CAN if available, with automatic fallback to internal GNSS.
**0 – Use the resolution provided in the configuration
**1 – 160x120
**2 – 320x240
**3 – 640x480
**4 – 1280x720
**5 – 1920x1080


For advanced configuration (e.g. via commands):


'''''camreq:'' Structure examples:'''
Source Location from RTK <br>
'''Parameter ID:''' 55000 <br>
'''Values:''
*'''0''' – Disabled (device uses only internal GNSS) 
*'''1''' – Enabled (device uses RTK sources if available)


'''camreq:<file type>,<file source>(if video, add ",<timestamp>,<duration>)'''
Configuring RS232 for RTK Use 
If you plan to use an external RTK receiver via RS232:
#Open the RS232/RS485 tab in the Configurator. 
#For COM1 or COM2 (or both), set the mode to RTK.


However, if there is a need to send to the specific server without configuring, you can add two extra parameters.  
Relevant parameter IDs: 
The complete structure:
*'''COM1 mode''' – Parameter ID 151 
*'''COM2 mode''' – Parameter ID 173 
*'''RTK mode''' – Value 60 
If at least one COM port is configured to RTK mode and valid RTK data is received, the device will use RS232 as the main coordinate source.


'''camreq:<file type>,<file source>(if video, add ",<timestamp>,<duration>),<domain>,port'''
[[File:RS232 settings - RTK.png|right]]


For example: camreq:0,1,1624960616,5,212.59.13.226,7160
'''Using CAN as the RTK Source'''
CAN-based RTK is used in the following cases:
*None of the RS232 COM ports are configured in RTK mode, or 
*RS232 RTK data is not valid or not present. 
When those conditions are met and valid CAN RTK data is received:
*The device uses CAN as the coordinate source. 
*The device continuously monitors the time between RTK messages. 
*If CAN RTK messages are delayed by more than 2 seconds, the device automatically reverts to internal GNSS to avoid stale coordinates.
<br>
RTK data taken from CAN includes: 
*'''Latitude 
*'''Longitude 
*'''Altitude 
*'''Ground speed 
*'''Course 
 
Configuration of RTK over CAN (e.g. PGN, source address, bitrate) depends on your external CAN/ISOBUS/RTK infrastructure and should follow that system’sdocumentation. 
 
'''ISOBUS Data Visibility''' 
When used in ISOBUS or similar environments: 
[[File:ISOBUS - RTK.png]]
*RTK-related data from CAN is visible in the ISOBUS section of the Configurator. 
 
*This allows you to verify that RTK data is being received and interpreted correctly by the device. 
 
==Active Location Source Monitoring==
To understand which source is currently being used for position data, you can check the '''Location Source''' parameter.
 
'''Location Source Values'''
 
In the Configurator: 
#Navigate to the '''I/O''' tab (or equivalent I/O monitoring view).
#Find the parameter '''Location Source'''.
[[File:Location source.png]]
 
Possible values:
 
*'''0 – GNS'''
Location is taken from the internal GNSS receiver. This is the default when RTK is disabled or when no valid RTK data is available.
 
*'''1 – RS232'''
Location is taken from the RTK receiver connected via RS232.


'''camreq:1,<file source>,<domain>,<port>,<resolution>'''
*'''2 – CAN'''
Location is taken from RTK data arriving over CAN.


Upload with domain, port, and resolution provided by a request. Example: camreq:1,1,192.168.1.1,12345,4
*'''3 – Err'''
Location is taken from the internal GNSS receiver, but this status indicates that RTK data from RS232 and/or CAN is invalid or unavailable. This helps distinguish normal GNSS use from “RTK expected but not available” situations.


'''''icam_req:''  Structure examples:'''
This parameter is used for diagnostics and for confirming that your device is using the intended RTK source.


'''icam_req:<camera_type>,<peripheral>,<file_type>,<resolution>,<domain>,<port>
==NMEA Fix Type Monitoring (RS232 RTK Only)==
When RTK coordinates are received via RS232, you can also monitor the NMEA Fix Type to understand the quality of the GNSS/RTK fix. 


Usage example: 1,2,0,1,server.com,1234
'''Configurator Steps'''
#Open the Configurator. 
#Go to the I/O tab (or relevant section). 
#Locate the parameter '''NMEA Fix Type'''.  


'''icam_req:<camera_type>,<peripheral>,<file_type>,<timestamp>,<domain>,<port>
[[File:NMEA Fix Type.png]]


Usage example: 1,2,1,1609459200000,server2.com,5678
'''Note:''' This parameter is '''only available when coordinate data is received via RS232 RTK'''.


'''icam_req:<camera_type>,<peripheral>,<file_type>,<timestamp>,<duration>
'''NMEA Fix Type Values'''


Usage example: 1,2,2,1609459200000,10
*'''NotValid''' - No valid GNSS fix is available.<br>
{| class="wikitable"
|+
! rowspan="1" style="width: 600px; background: #0054A6; color: white;" |'''Conditions'''
! colspan="3" rowspan="1" style="width: 600px; background: #0054A6; color: white;" |'''Command response'''
|-  
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Request successful and server  connection successful. Device is ready to send selected file
| rowspan="14" style="text-align: left; style=" width: 150px; background: white; color: black;" |Photo  request from source <1-3>.


'''(If  photo request)'''
*'''GPS''' - Standard GPS fix using satellites only.<br>


*'''DGNSS''' - Differential GNSS fix (e.g. DGNSS, SBAS, etc.).<br>


Video  request from source <1-3> for <1-30> seconds since YYYY-MM-DD  HH:MM:SS.
*'''NotApplicable''' - Fix quality is not applicable in the current context. <br>


'''(If  video request)'''
*'''RTK_Fixed''' - RTK Fixed; high-precision RTK fix (including xFill if supported by the receiver).<br>
| colspan="2" |Preparing to send file  from timestamp <timestamp of the file>
 
|-
*'''RTK_Float''' - RTK Float; typically, a converging RTK solution or similar intermediate status.<br>
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Request successful but the device  was already connected to the server. Device is ready to send selected file
 
| colspan="2" |Already connected.  Preparing to send file from timestamp <timestamp of the file>
*'''INS_DR''' - INS Dead Reckoning; position estimated by inertial sensors and previous GNSS/RTK data.<br> 
|-
 
| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Request received but the capture  failed
This information is beneficial for:
| colspan="2" |Error: capture failed
*Verifying that the external RTK receiver is working correctly.
|-
*Assessing overall RTK performance and stability.
|Request received but the device  cannot proceed with the capture and sending because ignition is off
*Logging and diagnostics in advanced deployments.
| colspan="2" |Error: Cannot capture  because ignition is off
 
|-
==Parameter IDs and AVL IDs==
|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
 
| colspan="2" |Warning: Photo / Video  already captured previously, trying to send it
Below is a list of AVL IDs and Configurator IDs assigned to a specific item.
|-
 
|Request received but the device was already connected to the server. New media is not captured. The device is ready to send previous capture
<table class="nd-othertables_2" style="width:50%; border-collapse: collapse;">
| colspan="2" |Already connected. Warning:  Photo / Video already captured previously, trying to send it
 
|-
<tr>
|Request received but the camera doesn’t acknowledge sent command. Nothing will be sent
<th style="width:8%; vertical-align: middle; text-align: left;">Name</th>
| colspan="2" |Error: DualCam NAK
<th style="width:15%; vertical-align: middle; text-align: center;">Parameter ID</th>
|-
<th style="width:5%; vertical-align: middle; text-align: center;">AVL ID</th>
|Request received but the camera is  not connected or not working
</tr>
| colspan="2" |Error: DualCam not  present
 
|-
<tr>
|Request received but the camera is  not connected or not working
<td style="vertical-align: middle; text-align: center;">RTK Longitude</td>
| colspan="2" |Error: requested file  does not exist
<td style="vertical-align: middle; text-align: center;">151790</td>
|-
<td style="vertical-align: middle; text-align: center;">14145</td>
|Request received but the device  cannot connect to the server
</tr>
| colspan="2" |Error: connect to  server
 
|-
<tr>
|Request received but the modem is  not ready for operation (network or modem issue)
<td style="vertical-align: middle; text-align: center;">RTK Latitude</td>
| colspan="2" |Error: modem not ready  to start send
<td style="vertical-align: middle; text-align: center;">151800</td>
|-
<td style="vertical-align: middle; text-align: center;">14146</td>
|Request received but the device  cannot proceed with the capture and sending because the camera is being  reconfigured
</tr>
| colspan="2" |Cannot send, DualCam  configuration is in progress
 
|-
<tr>
|Request received but file capture time was exceeded.
<td style="vertical-align: middle; text-align: center;">RTK Altitude</td>
| colspan="2" |Error: Media request  timeout
<td style="vertical-align: middle; text-align: center;">151810</td>
|-
<td style="vertical-align: middle; text-align: center;">14147</td>
|Request received but capture  completed incorrectly
</tr>
| colspan="2" |Error: Media request problem
 
|-
<tr>
|File type parameter incorrect in the  request command
<td style="vertical-align: middle; text-align: center;">RTK Speed</td>
| rowspan="4" |Error:  Invalid
<td style="vertical-align: middle; text-align: center;">151820</td>
|File Type
<td style="vertical-align: middle; text-align: center;">14148</td>
| rowspan="4" |argument  in camera request cmd!
</tr>
|-
 
|File Source parameter incorrect in  the request command
<tr>
|File Source
<td style="vertical-align: middle; text-align: center;">RTK Angle</td>
|-
<td style="vertical-align: middle; text-align: center;">151830</td>
|Timestamp parameter incorrect in the  request command
<td style="vertical-align: middle; text-align: center;">14149</td>
|Timestamp
</tr>
|-
 
|Duration parameter incorrect in the  request command
<tr>
|Duration
<td style="vertical-align: middle; text-align: center;">Source Location from RTK</td>
|-
<td style="vertical-align: middle; text-align: center;">55000</td>
|Cannot proceed with the request,  ignition is off
<td style="vertical-align: middle; text-align: center;">-</td>
| colspan="3" |Error: Ignition not  detected!
</tr>
|-
 
|Request command structure incorrect
<tr>
| colspan="3" |Error: Invalid camera  request command!
<td style="vertical-align: middle; text-align: center;">Source Location from RTK</td>
|-
<td style="vertical-align: middle; text-align: center;">55000</td>
|RS232 and DualCam mode is not  enabled
<td style="vertical-align: middle; text-align: center;">-</td>
| colspan="3" |Error: DualCam is not  configured!
</tr>
|-
 
|Front or rear camera not found
<tr>
| colspan="3" |Error: Front / Rear  Camera not present
<td style="vertical-align: middle; text-align: center;">Location Source</td>
|}
<td style="vertical-align: middle; text-align: center;">53050</td>
<br>
<td style="vertical-align: middle; text-align: center;">10919</td>
</tr>
 
<tr>
<td style="vertical-align: middle; text-align: center;">NMEA Fix Type</td>
<td style="vertical-align: middle; text-align: center;">53060</td>
<td style="vertical-align: middle; text-align: center;">10920</td>
</tr>

Latest revision as of 14:46, 14 April 2026

External RTK coordinate via CAN/RS232 interface with FMC650

Overview

Activating RTK (Real-Time Kinematic) coordinate acquisition enables the FMC650 device to process RTK data from CAN. When configured, the RTK module can provide high-precision coordinates using:

  • RTK receiver via RS232
  • RTK data via CAN
  • Internal GNSS receiver (GNS) as fallback

The device automatically chooses the best available source based on configuration and data quality.

The following specifications indicate the minimum firmware and configurator version requirement to use RTK coordinate acquisition via CAN on FMC650.

  • Platform: FM65
  • Device: FMC650
  • Firmware version: 03.01.03.Rev.228
  • Configurator version: B.FMX6_R.192

Method of Operation

When the RTK option is enabled, the device always tries to use RTK sources first and falls back to internal GNSS if needed.

Source priority

  1. RS232 (primary RTK source)
    • The device checks whether any COM port (COM1 or COM2) is configured in RTK mode.
    • If at least one COM port is configured for RTK and valid data is present, coordinates are taken from RS232.
  2. CAN RTK (secondary RTK source)
    • If RS232 RTK data is not available or is invalid, the device checks the CAN RTK status.
    • If valid CAN RTK data is available, coordinates are taken from CAN.
    • A timing check is applied if the time difference between received CAN RTK frames is greater than 2 seconds. The device automatically switches to the internal GNSS receiver (GNS) to keep coordinates up to date.
  3. Internal GNSS (GNS) Fallback
    • If neither RS232 nor CAN provide valid RTK data, the device uses the internal GNSS receiver (GNS) for coordinates.
  4. RTK Disabled
    • If the RTK option is disabled, coordinates are always taken from the internal GNSS receiver.

RTK data from CAN

When CAN is used as the RTK source, the device reads:

  • Latitude
  • Longitude
  • Altitude
  • Ground speed
  • Course

These values are taken from standard CAN messages designed for GNSS/RTK data. Exact PGNs and signal layouts depend on whether external RTK/ECD/ISOBUS system is being used.

Configurator Setup

This section describes how to enable RTK as a location source and configure RS232 and CAN usage through the Configurator.

Enabling RTK as a location source

  1. Open the Configurator and connect to the FMC650 device.
  2. Navigate to the System tab.
  3. Find the option “Source Location from RTK” in the System Settings section.
  4. Set this option to Enable.

When enabled, the device will use RTK data from RS232/CAN if available, with automatic fallback to internal GNSS.

For advanced configuration (e.g. via commands):

Source Location from RTK
Parameter ID: 55000
Values:

  • 0 – Disabled (device uses only internal GNSS)
  • 1 – Enabled (device uses RTK sources if available)

Configuring RS232 for RTK Use If you plan to use an external RTK receiver via RS232:

  1. Open the RS232/RS485 tab in the Configurator.
  2. For COM1 or COM2 (or both), set the mode to RTK.

Relevant parameter IDs:

  • COM1 mode – Parameter ID 151
  • COM2 mode – Parameter ID 173
  • RTK mode – Value 60

If at least one COM port is configured to RTK mode and valid RTK data is received, the device will use RS232 as the main coordinate source.

Using CAN as the RTK Source CAN-based RTK is used in the following cases:

  • None of the RS232 COM ports are configured in RTK mode, or
  • RS232 RTK data is not valid or not present.

When those conditions are met and valid CAN RTK data is received:

  • The device uses CAN as the coordinate source.
  • The device continuously monitors the time between RTK messages.
  • If CAN RTK messages are delayed by more than 2 seconds, the device automatically reverts to internal GNSS to avoid stale coordinates.


RTK data taken from CAN includes:

  • Latitude
  • Longitude
  • Altitude
  • Ground speed
  • Course

Configuration of RTK over CAN (e.g. PGN, source address, bitrate) depends on your external CAN/ISOBUS/RTK infrastructure and should follow that system’sdocumentation.

ISOBUS Data Visibility When used in ISOBUS or similar environments:

  • RTK-related data from CAN is visible in the ISOBUS section of the Configurator.
  • This allows you to verify that RTK data is being received and interpreted correctly by the device.

Active Location Source Monitoring

To understand which source is currently being used for position data, you can check the Location Source parameter.

Location Source Values

In the Configurator:

  1. Navigate to the I/O tab (or equivalent I/O monitoring view).
  2. Find the parameter Location Source.

Possible values:

  • 0 – GNS

Location is taken from the internal GNSS receiver. This is the default when RTK is disabled or when no valid RTK data is available.

  • 1 – RS232

Location is taken from the RTK receiver connected via RS232.

  • 2 – CAN

Location is taken from RTK data arriving over CAN.

  • 3 – Err

Location is taken from the internal GNSS receiver, but this status indicates that RTK data from RS232 and/or CAN is invalid or unavailable. This helps distinguish normal GNSS use from “RTK expected but not available” situations.

This parameter is used for diagnostics and for confirming that your device is using the intended RTK source.

NMEA Fix Type Monitoring (RS232 RTK Only)

When RTK coordinates are received via RS232, you can also monitor the NMEA Fix Type to understand the quality of the GNSS/RTK fix.

Configurator Steps

  1. Open the Configurator.
  2. Go to the I/O tab (or relevant section).
  3. Locate the parameter NMEA Fix Type.

Note: This parameter is only available when coordinate data is received via RS232 RTK.

NMEA Fix Type Values

  • NotValid - No valid GNSS fix is available.
  • GPS - Standard GPS fix using satellites only.
  • DGNSS - Differential GNSS fix (e.g. DGNSS, SBAS, etc.).
  • NotApplicable - Fix quality is not applicable in the current context.
  • RTK_Fixed - RTK Fixed; high-precision RTK fix (including xFill if supported by the receiver).
  • RTK_Float - RTK Float; typically, a converging RTK solution or similar intermediate status.
  • INS_DR - INS Dead Reckoning; position estimated by inertial sensors and previous GNSS/RTK data.

This information is beneficial for:

  • Verifying that the external RTK receiver is working correctly.
  • Assessing overall RTK performance and stability.
  • Logging and diagnostics in advanced deployments.

Parameter IDs and AVL IDs

Below is a list of AVL IDs and Configurator IDs assigned to a specific item.

Name Parameter ID AVL ID
RTK Longitude 151790 14145
RTK Latitude 151800 14146
RTK Altitude 151810 14147
RTK Speed 151820 14148
RTK Angle 151830 14149
Source Location from RTK 55000 -
Source Location from RTK 55000 -
Location Source 53050 10919
NMEA Fix Type 53060 10920