This document describes the command line interface of PCR2-IN/OD/R/T/T2 with Firmware Version 3.3.x
Older versions of this Document can be found here: V3.2.x
PCR2 devices can be configured using a USB cable an a Terminal Software such as RealTerm
Use 19200 8N1 to communication with device. All commands are terminated by \r\n (Carriage Return, Line Feed)
Device types include:
IN | Indoor People Counter |
OD | Outdoor People Counter |
R | Railway Counter |
T | General Traffic Counter |
XIO | Industrial object counter with digital outputs |
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
PCR2-EU868-IN
Command
get fw_version
Example:
get fw_version
3.3.0
Get the device unique serial number
Command
get serial
Example:
get serial
3334373981377504
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 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 the counter value of all left-to-right counts. You can overwrite the value by using the set command.
Commands
get ltr
Example:
get ltr
1
Get the counter value of all right-to-left counts. You can overwrite the value by using the set command.
Commands
get rtl
Example:
get rtl
22
Commands
clear
Example:
clear
ok
PCR2 can run in four different modes:
0 | Timespan, used to sum up detection and send after a certain time (Sending Interval) |
1 | NotZero, Same as Timespan but w/o sending if counters are 0 (zero) |
2 | Trigger, Send on every events. Events can be filtered with Hold Off setting |
3 | Capacity Alert Mode |
New mode will be active only after a restart
.
Commands
get mode
set mode <val>
Example:
get mode
2
set mode 0
0
restart
Set the radar sensitivity to 10 … 100% if you think the device is too sensitive. Default: 80
Commands
get sens
set sens <val>
Example:
get sens
80
set sens 50
50
restart
Set the accumulation interval in minutes (1…1440 minutes). Default: 10 During this time, alle persons will be counted and 2 sums (LTR and RTL) will be transfered. After transfer counters will be reset.
Commands
get interval
set interval <val>
Example:
get interval
15
set interval 60
60
This is a timer (0…600s) can be used to filter events that come close after another (eg. Car with Trailer). Default: 0
Commands
get hold
set hold <val>
Example:
get hold
60
set hold 0
0
Defines how the sum will be accumulated.
0 | LTR count will increase sum (default) |
1 | RTL count will increase sum |
Commands
get dir
set dir [0|1]
Example:
get dir
0
set dir
1
All Events will be accumulated in the sum. Depending on the Direction Settings LTR/RTL events will increase / decrease the sum. Sum is cleared on power loss.
dir | count | sum |
---|---|---|
0 | LTR | +1 |
0 | RTL | -1 |
1 | LTR | -1 |
1 | RTL | +1 |
Commands
get sum
get sum <val>
Example:
get sum
-21
set sum -20
-20
If the PCR2 is equiped with a XIO Board following operation modes can be enabled
0 | Off | Switch XIO Board off |
1 | Pulse | Generate a 500ms pulse on O1 if RTL detected, O2 if LTR is detected |
2 | Detection | O1 is always on. If LTR or RTL is detected, O2 will be on during holdoff time |
3 | CapacityAlert | O1 on when sum < lim, O2 on when sum >= lim |
Commands
get xiomode
set xiomode <val>
Example:
get xiomode
2
set xiomode 0
0
restart
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
.
.
.
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
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
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
For US915 and AU915 devices only. 8 sub-bands are available (set 1-8). 0 = all channels enabled
Hints:
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
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