TCR Command Line Interface Documentation

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 neccessary 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.

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 ... 1440 minutes.

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