This manual relates to TCR Firmware V1.3.x
This manual describes the command line interface (CLI) of Parametric TCR Radar Traffic Counters. The CLI is used to configure the devices once.
After initial setup we recommend using LoRaWAN Configuration Downlinks to change settings remotely. You can find more informations in the TCR Configuration Payload Description.
We recommend using a terminal emulator such as Realterm to open the serial connection and send/receive commands.
Use a USB cable with Micro-USB port to establish a connection between TCR’s CONFIG port and your PC.
Serial port settings:
Terminal Emulator Settings:
Commands are always terminated by a CR
and LF
symbol.
However, for the sake of simplicity, the description of the individual commands does not include it.
Set commands and Get commands both return the parameters passed to the command. If a parameter is out of range, the return value is the default value. This can be used to check whether the parameter was stored correctly.
set mode 9999
0
set mode 1
1
This chapter contains the most important commands for commissioning the device. In particular, the settings for the measuring distance and the sensitivity are to be considered.
get sg_start <no>
get sg_end <no>
set sg_start <no> <kmh>
set sg_end <no> <kmh>
TCR devices allow to define up to 4 freely programmable speed groups. This makes it possible to separate road users based on the measured speed and direction.
LS/LSS devices are specifically designed for pedestrian/bicycle counts and outdoor sports. The default settings of the speed groups are shown in the table below.
no | sg_start | sg_end | |
---|---|---|---|
0 | 1 | 7 | Used to separate pedestrians walking by (1-7km/h) |
1 | 8 | 40 | Faster traffic such as bikes (8-40km/h) |
Note: There are only 2 speed groups awailable on TCR-LS/LSS
HS/HSS devices are used for general traffic statistics applications. The default settings for speed groups are listed in the following table.
no | sg_start | sg_end | |
---|---|---|---|
0 | 8 | 25 | Stop ‘n go traffic (no people counting ) (8-25km/h) |
1 | 26 | 49 | Slow city traffic (26-49km/h) |
2 | 50 | 79 | Fast city traffic (50-79km/h) |
3 | 80 | 120 | Highway (80-120km/h) |
set sg_start 0 1
1
set sg_end 0 7
7
set sg_start 1 8
8
set sg_end 1 40
40
get rtldist
set rtldist <cm>
get ltrdist
set ltrdist <cm>
Set the distance from the device This makes it possible to separate road users based on the measured speed and direction.
LS/LSS devices are specifically designed for pedestrian/bicycle counts and outdoor sports. The default settings of the speed groups are shown in the table below.
no | sg_start | sg_end | |
---|---|---|---|
0 | 1 | 7 | Used to separate pedestrians walking by (1-7km/h) |
1 | 8 | 40 | Faster traffic such as bikes (8-40km/h) |
Note: There are only 2 speed groups awailable on TCR-LS/LSS
HS/HSS devices are used for general traffic statistics applications. The default settings for speed groups are listed in the following table.
no | sg_start | sg_end | |
---|---|---|---|
0 | 8 | 25 | Stop ‘n go traffic (no people counting ) (8-25km/h) |
1 | 26 | 49 | Slow city traffic (26-49km/h) |
2 | 50 | 79 | Fast city traffic (50-79km/h) |
3 | 80 | 120 | Highway (80-120km/h) |
set sg_start 0 1
1
set sg_end 0 7
7
set sg_start 1 8
8
set sg_end 1 40
40
get mode
set mode [0|1]
Gets and Sets the operation mode. TCR devices can run in two different operation modes.
set mode 1
1
Following commands are useful to get device informations. These commands are read only.
get typestr
Reads the device typestring. This can be:
get typestr
TCR-EU868-HS
get fw_version
Reads the device firmware version in format MAJ.MIN.BUGFIX (Semantic versioning)
get fw_version
1.3.0
get radar_version
Reads the version of integrated radar processing module.
Example:
get radar_version
1.5.2
get serial
This command reads out the hardware serial number. This number is also printed on the type label and the QR.
Example:
get serial
353637315A306104
get status
LoRaWAN connection status includes 4 possible states:
init | Device is initializing |
joining | Device trying to join a LoRaWAN network |
active | Device is connected to LoRaWAN network |
error | Hardware or Configuration Error |
Example:
get status
active
get ltr <no>
get rtl <no>
These commands read the counter values from left-to-right (ltr) or right-to-left (ltr) counters.
Counter values are separated in directions and speed groups. So you need to always appedn the speed group no (0…3) to this command.
get ltr 1
12
get rtl 0
32
get temp
Reads the temperature of the integrated CPU in 1/10 °C. So 345 is 34.5 °C
get temp
323
get interval
set interval <val>
Set the measurement interval in minutes (1…1440 minutes). During this time, alle objects will be counted into the selected speed group.
This interval is also the LoRaWAN uplink interval.
get interval
15
set interval 60
60
get hold
set hold <val>
Holdoff can be used to filter burst events. Setting the holdoff timer to e.g. 10s will prevent double-coutings of a single vehicle if there are trailers attached.
Note: This function can be used to count trains.
get hold
60
set hold 0
0
clear
This will reset all counters in all speed group to zero
clear
ok
set defaults
This will reload factory settings. All your changes will be lost.
Note: command does not return but resets device
set defaults
get sens
set sens <val>
Setting the Radar Sensitivity correctly is critical for good counting accuracy. Sensitivity can be set from 10 … 100% (100% is very sensitive).
Start with a low value such as 70%. If you think the counts are too low, increase the value. If the counts are too high, decrease the value. You can also use LoRaWAN Configuration Downlinks to change this setting remotely without having to re-screw the device.
Alternatively, you can use the new Autotune function to let the device find its sensitivity automatically.
get sens
80
set sens 50
50
restart
lora get enabled
lora set enabled <val>
Enable or disable LoRaWAN radio. If disabled you can use the device as a wired-sensor connnected wie USB. ‘LTR’ or ‘RTL’ will be sent over the serial interface on detection
lora get enabled
1
lora set enabled 0
0
LTR
LTR
RTL
.
.
.
lora get class
lora set class [A|C]
TCR can be operated as a Class A (default) or as a Class C LoRaWAN device
lora get class
A
lora set class C
C
restart
lora get deveui
lora set deveui <val>
Set / Get the uniqe 64 bit end-device identifier (EUI-64). Defaults to the hardware serial number.
lora get deveui
0123456789abcdef
lora set deveui 0123456789abcdf
01234567890abcdef
Set / Get the unique 64 bit application identifier (EUI-64)
Commands
lora get appeui
lora set appeui <val>
lora get appeui
deadbeefdeadbeef
lora set appeui deadbeefdeadbeef
deadbeefdeadbeef
lora get appkey
lora set appkey <val>
Set / Get the Application Session Key (AppSKey). AppSKEy is used for encryption and decryption of the payload. The payload is fully encrypted between the Node and the Handler/Application Server component of The Things Network (which you will be able to run on your own server). This means that nobody except you is able to read the contents of messages you send or receive.
lora get appkey
deadbeefdeadbeefdeadbeefdeadbeef
lora set appkey deadbeefdeadbeefdeadbeefdeadbeef
deadbeefdeadbeefdeadbeefdeadbeef
lora get fsb
lora set fsb <val>
For US915 and AU915 devices only. 8 sub-bands are available (set 1-8). 0 = all channels enabled
Use FSB1 for Comcast machineQ networks. Use FSB2 for myDevices networks.
lora get fsb
1
lora set fsb 0
0
lora get confirmed
lora set confirmed <val>
Enable/Disable confirmed uplink messages.
We recommed to use confirmed uplinks to prevent data loss
lora get confirmed
0
lora set confirmed 1
1
restart
lora get lci
lora set lci <val>
We will send a LinkCheck MAC command together with an uplink regularly to make sure gateway responds properly. If there is no answer we try to re-join. lci is in range
LinkCheck can be disabled completely by setting to 0.
lora get lci
10
lora set lci 1440
1440
restart