TCR Command Line Interface
V2.2 | V2.1 | V2.0 | V1.3 | V1.1 | V1.0
Introduction
This document describes the command line interface of TCR / TCR-S with Firmware Version 1.0.x
TCR can be configured using a USB cable. Windows 10 brings the necessary drivers pre-installed.
Serial Port Settings
Use 19200 8N1 to communication with device. All commands are terminated by \r\n (Carriage Return, Line Feed)
Device Information
Get Device Type
Device types include:
|---|----------------------| |TCR |Radar Traffic Counter | |TCR-S |Radar Traffic Counter with integrated SBX Solar Powerbank|
LoRaWAN™ bands include:
|---|----------------------| |EU868 |EU 863-870MHz ISM Band | |AS923|AS923MHz ISM Band| |US915|US 902-928MHz ISM Band| |AU915 |Australia 915-928MHz ISM Band
Command
get typestr
Example:
get typestr
TCR-EU868-S
Get Firmware Version
Command
get fw_version
Example:
get fw_version
1.0.0
Get Serial Number
Get the device unique serial number
Command
get serial
Example:
get serial
3334373981377504
Get Device Status
This returns the actual device status
|-|-| |init| Device is initializing | |joining| Device trying to join a LoRaWAN™ network | |active| Device is connected to LoRaWAN™ network| |error| Hardware or Configuration Error |
Command
get status
Example:
get status
joining
Get CPU temperature
Get the intenal CPU temperature. Temperature is in 1/10 °
Examples:
|---|------:| |210| 21.0°C| |321| 32.1°C|
Commands
get temp
Example:
get temp
330
Get Left-to-Right Counter Value of a speed class
Commands
get ltr <sg>
Example:
get ltr 1
1
Get Right-to-Left Counter Value of a speed class
Commands
get rtl <sg>
Example:
get rtl 2
4
Clear all counters
Commands
clear
Example:
clear
ok
Application Settings
Get/Set Operation Mode
TCR can run in four different modes:
|-|-| |0|Timespan, used to sum up detection and send after a certain time (Sending Interval)| |1|Trigger, Send on every events. Events can be filtered with Hold Off setting|
New mode will be active only after a restart
.
Commands
get mode
set mode <val>
Example:
get mode
2
set mode 0
0
restart
Get/Set Radar Sensititivy
Set the radar sensitivity can be set from 10 ... 100% (100% is very sensitive) Default: 50
Commands
get sens
set sens <val>
Example:
get sens
80
set sens 50
50
restart
Get/Set Measurement Interval
Set the accumulation interval in minutes (1...1440 minutes). Default: 10 During this time, alle persons will be counted and sums are transfered. After transfer counters will be reset.
Commands
get interval
set interval <val>
Example:
get interval
15
set interval 60
60
Get/Set Hold Off time
This is a timer (0...600s) can be used to filter events. Default: 0
Commands
get hold
set hold <val>
Example:
get hold
60
set hold 0
0
Get/Set Speedgroup Start [km/h]
This defines the start of 0..4 counting bins, defined with start and end speeds.
Commands
set sg_start <sg> <speed>
Example:
get sg_start 1
8
set sg_start 1 7
7
Get/Set Speedgroup End [km/h]
This defines the end of 0..4 counting bins.
Commands
set sg_send <sg> <speed>
Example:
get sg_end 1
20
set sg_end 1 25
25
LoRaWAN™ Network Settings
Get/Set Enabled
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
Commands
lora get enabled
lora set enabled <val>
Example:
lora get enabled
1
lora set enabled 0
0
LTR
LTR
RTL
.
.
.
Get/Set Device Class
Set the LoRa Device class to A or C
Commands
lora get class
lora set class [A|C]
Example:
lora get class
A
lora set class C
C
restart
Get/Set DevEUI
Set / Get the uniqe 64 bit end-device identifier (EUI-64)
Commands
lora get deveui
lora set deveui <val>
Example:
lora get deveui
0123456789abcdef
lora set deveui 0123456789abcdf
01234567890abcdef
Get/Set AppEUI
Set / Get the unique 64 bit application identifier (EUI-64)
Commands
lora get appeui
lora set appeui <val>
Example:
lora get appeui
deadbeefdeadbeef
lora set appeui deadbeefdeadbeef
deadbeefdeadbeef
Get/Set AppKey
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.
Commands
lora get appkey
lora set appkey <val>
Example:
lora get appkey
deadbeefdeadbeefdeadbeefdeadbeef
lora set appkey deadbeefdeadbeefdeadbeefdeadbeef
deadbeefdeadbeefdeadbeefdeadbeef
Get/Set Frequency Sub-Band (FSB)
For US915 and AU915 devices only. 8 sub-bands are available (set 1-8). 0 = all channels enabled
Hints: - Use FSB1 for Comcast machineQ networks - Use FSB2 for myDevices networks
Commands
lora get fsb
lora set fsb <val>
Example:
lora get fsb
1
lora set fsb 0
0
Enable/Disable Confirmed Uplink Messages
Enable/Disable confirmed uplink messages.
Default: 0
Commands
lora get confirmed
lora set confirmed <val>
Example:
lora get confirmed
0
lora set confirmed 1
1
restart
Set/Get LinkCheck Interval
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.
Commands
lora get lci
lora set lci <val>
Example:
lora get lci
10
lora set lci 1440
1440
restart