PCR2 Command Line Interface Documentation

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

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:

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

Get Firmware Version

Command

get fw_version

Example:

get fw_version
3.3.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 (All speed classs)

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 Right-to-Left Counter Value (All speed classs)

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


Clear all counters

Commands

clear

Example:

clear
ok

Application Settings

Get/Set Operation Mode

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

Get/Set Radar Sensititivy

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

Get/Set Interval

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

Get/Set Hold Off time

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

Get/Set Direction

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

Get/Set Sum

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

Get/Set XIO Operation Mode

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

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