TCR Users Manual 1.3

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

Change Uplink Interval

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>

Set Uplink Mode

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.

Initialization of Radar Processor. LEDs are constantly on.
Start Join-Procedure (only if LoRa Modem is enabled). LEDs are blinking slowly
After receiving Join Accept, the device sends its configuration the on port 190

Detection mode

LEDs are off and are quickly flashing if a vehicle gets detected.
After Interval time is up, the device sends the application payload on port 14. This can be done in Confirmed or Unconfirmed Mode.
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

Configuration is done with the TCR Command Line Interface. If device is installed settings might be changed by sending a downlink to port 190.

Command Line Interface (CLI)

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

RealTerm

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`
`radar get sens`	`<%>`	Get Radar Sensitivity	`radar get sens` `100`
`radar set sens <%>`	`<%>`	Set Radar Sensitivity	`radar set sens 95` `95`

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`

Table of Content