TCR Configuration Payload V3

This document describes version 3 of the configuration payload introduced with TCR Firmware V1.3.0

Older versions of this document:

Payload Format

This payload is sent once after a successful join. It is recommended to save the information for tracking the devices settings over time.

You could use the same format for creating a configuration downlink to port 190. Once received the device will restart and re-join.

Byte Property Description Uplink Values Downlink Values
0 Vendor ID Always 0xbe for Parametric Devices be ignored (*)
1 DeviceFamily Always 0x02 for TCR Devices 02 ignored (*)
2 PayloadVersion Always 0x02 for V2 Payload 03 ignored (*)
         
3 DeviceType 00: TCR-LS
01: TCR-LSS
02: TCR-HS
03: TCR-HSS
00-03 ignored (*)
4:6 FirmwareVersion 0x010300 = V1.3.0 010000-01ffff ignored (*)
         
7 OperatingMode 00: Timespan
01: Trigger
00-01 00-01
8 DeviceClass 00: Class A
02: Class C
00 or 02 00 or 02
9 UplinkType 00: Uncofirmed
01: Confirmed
00 or 01 00 or 01
10:11 UplinkInterval 1-1440 Minutes 0001-05a0 0001-05a0
12:13 LinkCheckInterval 1-1440 Minutes, 0 = No LinkChecks 0000-05a0 0000-05a0
         
14:15 HoldoffTime 0-600s 0000-0258 0000-0258
16 RadarAutotuning Enable / Diable Autotunig to find the right RadarSensitivity 00-01 00-01
17 RadarSensitivity 10-100% 0a-64 0a-64
18:19 LTRLaneDist Distance to lane with traffic from left (50-3000cm) 0032-0BB8 0032-0BB8
20:21 RTLLaneDist Distance to lane with traffic from right (50-3000cm) 0032-0BB8 0032-0BB8
         
22 SC0_START Speed class 0 window start
0-255 km/h
00-ff 00-ff
23 SC0_END Speed class 0 window end
0-255 km/h
00-ff 00-ff
         
24 SC1_START Speed class 1 window start
0-255 km/h
00-ff 00-ff
25 SC1_END Speed class 1 window end
0-255 km/h
00-ff 00-ff
         
26 SC2_START (**) Speed class 2 window start
0-255 km/h
00-ff 00-ff
27 SC2_END (**) Speed class 2 window end
0-255 km/h
00-ff 00-ff
         
28 SC3_START (**) Speed class 3 window start
0-255 km/h
00-ff 00-ff
29 SC3_END (**) Speed class 3 window end
0-255 km/h
00-ff 00-ff
30:32 SBXFirmwareVersion 0x040100 = V4.1.0 010000-ffffff ignored (*)

(*) These fields values are ignored by the device when downlinking this payload (**) Speed class 2 and 3 is not used on TCR-LS, TCR-LSS devices

Ports used

Uplink Port 190
Downlink Port 190

Configuration Payload (Hexstring)

be020300010300000001000a05a00000005a00fa00fa0107082800000000040100


Best Practice

Check Port and Payload Header in your decoder

    if(bytes[0] == 0xbe && bytes[1] == 0x02)
    {
        // its a TCR

        if(port == 15)
        {
            // it's an Application Payload

            if(bytes[2] == 0x01)    // V1
            {
                obj = app_payload_v1_decoder(bytes, port);
            }
            if(bytes[2] == 0x02)    // V2
            {
                obj = app_payload_v2_decoder(bytes, port);
            }
        }

        if(port == 190)
        {
            // it's a Configuration Payload

            if(bytes[2] == 0x01)    // V1
            {
                obj = config_payload_v1_decoder(bytes, port);
            }
            if(bytes[2] == 0x02)    // V2
            {
                obj = config_payload_v2_decoder(bytes, port);
            }
            if(bytes[2] == 0x03)    // V3
            {
                obj = config_payload_v3_decoder(bytes, port);
            }
        }
    }

Find more example code in our public repository.

Online Payload Decoder