TCR Manual 1.1.x

The following documentation relates to TCR devices with firmware V1.1.x only.


Device Setup

Default keys

TCR are shipped with a set of standard LoRaWAN™ keys.

  • DevEUI is the Hardware serial number printed on the device label and QR e.g. AABBCCDDEEFF0011
  • AppEUI is the same as the DevEUI e.g. AABBCCDDEEFF0011
  • AppKey is 2x the DevEUI lined up e.g. AABBCCDDEEFF0011AABBCCDDEEFF0011


Default keys represent a security risk and must not be used in productive environments!

Change LoRaWAN™ Keys

LoRaWAN™ keys can be changed by using the command line interface (CLI). (See below for CLI documentation)

Use the following commands to set keys

lora set appeui <YOUR_APPEUI>
lora set appkey <YOUR_APPKEY>

restart

Uplink interval can be set from 5 Minutes up to 1440 Minutes (= 1 Day) During this period left/right counting’s will be collected. After the period runs up a confirmed or unconfirmed LoRaWAN™ Uplink will start.

set interval <INTERVAL_IN_MINUTES>

Choose between unconfirmed or confirmed uplinks by passing a 0 or 1 to following command

lora set confirmed 1
Confirmed Uplinks Counters will be cleared when receiving the uplink ACK
Unconfirmed Uplinks Counters will be cleared when sending the uplink

Functionality

Device start-up sequence

After switching on the device, following sequence will start.

  1. Initialization of Radar Processor. LEDs are constantly on.

  2. Start Join-Procedure (only if LoRa Modem is enabled). LEDs are blinking slowly

  3. After receiving Join Accept, the device sends its configuration the on port 190

Detection mode

  1. LEDs are off and are quickly flashing if a vehicle gets detected.

  2. After Interval time is up, the device sends the application payload on port 14. This can be done in Confirmed or Unconfirmed Mode.

  3. If confirmed uplinks are enabled, LEDs are on until successful received a ACK. After receiving the ACK LTR and RTL counters will be reset.

If the device operated in Unconfirmed Mode counters will be immediately reset after sending w/o waiting for an ACK.

LoRaWAN™ Payload

After a successful join the a LoRaWAN™ network TCR devices send its configuration once. It’s good practice to store this information on the application server to have a inventory of devices.

Application payload is sent in regular intervals.

Detailed information can be found in the TCR2 Payload V2 Documentation

Command Line Interface (CLI)

TCR can be configured using an USB cable and a terminal emulation program such as RealTerm

Swiss Made

Serial Port Settings

Use 19200 8N1 to communication with device. All commands must be terminated with \r\n (Carriage Return, Line Feed)


Command list

Status Commands

Command Response Description Example
get typestr TCR-<BAND>-<TYPE> Get Model Information get typestr
TCR-EU868-LS
get fw_version <MAJ>.<MIN>.<FIX> Get Firmware Version get fw_version
1.1.0
get hw_revision <REV> Get Mainboard Revision get hw_revision
3
get radar_version <MAJ>.<MIN>.<FIX> Get Radar Firmware Version get radar_version
1.3.0
get serial <DEV_SERIAL> Get Device Serial get serial
3934353778377907
get status init
joining
active
error
Get LoRaWAN™ Status get status
active
get ltr [sg] <LTR_CNT> Get Left-to-right count of Speedgroup sg
0-1 Speedgroups on LS, LSS
0-3 Speedgroups on HS, HSS
get ltr 0
12
get rtl [sg] <RTL_CNT> Get Right-to-left count of Speedgroup sg get rtl 1
9

Application Settings Commands

Command Response Description Example
get mode <MODE> Get Operation Mode
0 = Timespan
1 = Trigger
get mode
0
set mode <MODE> <MODE> Set Operation Mode
0 = Timespan
1 = Trigger
set mode 1
1
get interval <MIN> Get Uplink Interval in Minutes get interval
10
set interval <MIN> <MIN> Set Uplink Interval in Minutes set interval 10
10
get hold <SEC> Get HoldOff Time in Seconds get hold
2
set hold <SEC> <SEC> Set HoldOff Time in Seconds set hold 2
2
set mode <MODE> <MODE> Set Operation Mode
0 = Timespan
1 = Trigger
set mode 1
1
get sg_start [sg] <KM/H> Get Start of Speedgroup sg Window in km/h get sg_start 0
1
set sg_start [sg] <KM/H> <KM/H> Set Start of Speedgroup sg Window in km/h set sg_start 0 1
1
get sg_end [sg] <KM/H> Get End of Speedgroup sg Window in km/h get sg_end 0
7
set sg_end [sg] <KM/H> <KM/H> Set End of Speedgroup sg Window in km/h get sg_end 0 7
7

LoRaWAN™ Setting Commands

Command Response Description Example
lora get enabled [0|1] Check if LoRa Modem is enabled
1 = enabled
lora get enabled
1
lora set enabled [0|1] [0|1] Enable/Disable LoRa Modem
1 = enabled
lora set enabled 0
0
lora get class [A|C] Get device class lora get class
A
lora set class [A|C] [A|C] Set device class lora set class C
C
lora get deveui <DEVEUI> Get DevEUI (16 hex chars) lora get deveui
3934353778377907
lora set deveui <DEVEUI> <DEVEUI> set DevEUI (16 hex chars) lora set deveui 3934353778377908
3934353778377908
lora get appeui <APPEUI> Get AppEUI (16 hex chars) lora get appeui
3934353778377907
lora set appeui <APPEUI> <APPEUI> Set AppEUI (16 hex chars) lora set appeui 3934353778377908
3934353778377908
lora get appkey <APPKEY> Get AppKey (32 hex chars) lora get appkey
39343537783779073934353778377907
lora set appkey <APPKEY> <APPKEY> Set AppKey (32 hex chars) lora set appkey 39343537783779073934353778377907
39343537783779073934353778377907
lora get fsb <FSB> Get Fequency Subband (US915, AU915 only) lora get fsb
0
lora set fsb <FSB> <FSB> Set Fequency Subband (US915, AU915 only) lora set fsb 1
1
lora get confirmed [0|1] Get Uplink Mode
0 = unconfirmed
1 = confirmed
lora get confirmed
0
lora set confirmed [0|1] [0|1] Set Uplink Mode
0 = unconfirmed
1 = confirmed
lora set confirmed 1
1
lora get lci <MIN> Get LinkCheck Interval in Minutes lora get lci
1440
lora set lci <MIN> <MIN> Set LinkCheck Interval in Minutes
0 = do not send LinkCheckReqs
lora set lci 60
60

Radar Setting Commands

Command Response Description Example
radar get beam <BEAM> Get Radar Beam Angle radar get beam
80
radar get ltrdist <CM> Get Distance to LTR Lane in cm radar get ltrdist
400
radar set ltrdist <CM> <CM> Set Distance to LTR Lane in cm radar set ltrdist 250
250
radar get rtldist <CM> Get Distance to RTL Lane in cm radar get rtldist
300
radar set rtldist <CM> <CM> Set Distance to RTL Lane in cm radar set rtldist 550
550

SBX Solar charger Commands (LSS, HSS only)

Command Response Description Example
sbx get pv_pow <MV> Get Current PV Voltage sbx get pv_pow
16741
sbx get batt_gauge <PERCENT> Get Current Battery Gauge in Percent sbx get batt_gauge
89

Device Control Commands

Command Response Description Example
restart ok Device Restart restart
ok
clear ok Clears all Counters clear
ok