This manual describes the command line interface (CLI) of Parametric RDR RFID/NFC Reader with LoRaWAN. The CLI is used to configure the devices once.
This manual relates to RDR with firmware V1.4.x
We recommend using a terminal emulator such as Realterm to open the serial connection and send/receive commands.
Use a USB cable with Micro-USB port to establish a connection between TCR’s CONFIG port and your PC.
Serial port settings:
Terminal Emulator Settings:
Commands are always terminated by a
However, for the sake of simplicity, the description of the individual commands does not include it.
Set commands and Get commands both return the parameters passed to the command. If a parameter is out of range, the return value is the default value. This can be used to check whether the parameter was stored correctly.
set mode 9999 0 set mode 1 1
This command gets the device type (SKU). This can be:
> get type
get type RDR-EU868
Device Firmware version in Format Maj.Min.Fix
> get version
get version 1.4.3
Returns the firmware version of the integrated LoRaWAN®modem.
Note: This is not the LoRaWAN®version
> get modem_version
get modem_version 1.0.2
Returns the unique serial number of the device. This is the same as DevEUI (See lora get deveui)
> get serial
get serial 333031377939870a
Enable audio signals for readings.
> get beep
> set beep [0|1]
Values: 0: No beep signals, 1: beep signals
get beep 0 set beep 1 1 save ok
Get or set the time of integrated realtime clock (RTC).
Internal RTC not buffered and will start at 0:00:00 UTC on device reset
> get time
> set time HH:mm:ss
get time 14:20:05 set time 15:20:25 15:20:25
Get or set the date of internal real time clock.
Internal RTC not buffered and date will start at 2000-01-01 on device reset
> get date
> set date yyyy-MM-dd
NOTE: Date must be a value of 2000-01-01 or later
get date 2000-01-01 set date 2021-02-07 2021-02-07
Heart beats are are uplink frames that can be enabled to check the connection when the device is not used.
Range: 10-1440 minutes (a day) or 0 to switch off this function.
Note: NFC readings will restart the heart beat interval
> lora get hbi
> lora set hbi <minutes>
lora get hbi 0 lora set hbi 1440 1440 save ok
LoRaWAN®modem can be disabled. In reader mode the device outputs all readings directly to the console. Connect an USB-Cable to the device to use this function.
Values: 0: Online Mode, 1: Reader Mode (USB-Connected)
Note: restart device by sending init
> set rdmode [0|1]
> get rdmode
get rdmode 0 set rdmode 1 1 save ok
Returns the unique LoRaWAN®device EUI. This is the same as the serial number (See get serial)
> lora get deveui
lora get deveui 333031377939870a
Sets or Returns or sets the LoRaWAN®application EUI a string of 16 hex characters.
Values: 0000000000000000 … FFFFFFFFFFFFFFFF
Use save to permanently store changes to persistent memory
> lora get appeui
> lora set appeui <16 hex characters>
lora get appeui 8CAE49CFFFFFFF05 lora set appeui 7766554433221100 7766554433221100 save ok
Sets or Returns or sets the LoRaWAN®application key a string of 32 hex characters. The device comes with a random AppKey pro-programmed.
Note: If you reset device to factory defaults the device will start with an error and the red LoRaWAN®LED will blink. Set a new application key an save it to the device.
Values: 00000000000000000000000000000000 … FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
Use save to permanently store changes to persistent memory
> lora get appkey
> lora set appkey <32 hex characters>
lora get appkey 00112233445566778899AABBCCDDEEFF lora set appkey 00112233445566778899AABBCCDDEEFF 00112233445566778899AABBCCDDEEFF save ok
Enable / Disable LoRaWAN®confirmed messaged.
Values: 1: Confirmed LoRa Uplinks, 0: Unconfirmed LoRa Uplinks
Note: Device will retry uplinks for 5 minutes when confirmed messages are neabled.
> lora get confirmed
> lora set confirmed [0|1]
lora get confirmed 0 lora set confirmed 1 save ok
Enable / Disable LoRaWAN®Public Network mode.
Values: 1: Public Network Mode enabled, 0: Public Network Mode disabled
> lora get pnm
> lora set pnm [0|1]
lora get pnm 1 lora set pnm 0 0 save ok
With this command you can reset RDR to factory settings.
Note: Use save for to save settings to NV memory
defaults ok save ok init ok
Enable / Disable LoRaWAN®Adaptive Data Rate. When ADR is enable the DR setting will be ignored.
Values: 1: Enabled, 0: Disabled
> lora get adr
> lora set adr [0|1]
lora get adr 1 lora set adr 0 0 save ok
Force the Data Rate the device is using. This settings gets active as soon as ADR is disabled.
Range: 0, 1, 2, 3, 4, 5, 6, 7 (0 is data rate with longest range and smalles payload)
> lora get dr
> lora set dr [0|1|2|3|4|5|6|7]
lora set adr 0 // disable ADR 0 lora get dr 0 lora set dr 1 1 save ok
Stores all changes you have done to ROM
Changes to device settings will getting active by restarting the device either by repowering or using the init command
RDR can be used as LoRaWAN®modem that can be directly controlled by AT Commands. When in AT mode NFC reader is not active anymore.
Use this for debugging purposes only as settings will not be permanently saved. Use lora set commands to change credentials permanentely.
You can enable the AT Mode by sending the following command. After device reset the AT mode will be disabled.
AT OK ATZ OK
The AT command set is a standard developed by â€œHayesâ€ to control modems. AT stands for attention. The command set consists of a series of short text strings providing operations such as joining, data exchange and parameters setting. In a context of LoRaÂ® modem, the Hayes command set is a variation of the standard AT Hayes commands.
The AT commands have the standard format â€œAT+XXXâ€, with XXX denoting the command.
There are four available command behaviours:
The output format is as below:
When no value is returned, the
<value>\r\n output is not returned at all.
Every command (except for ATZ used for MCU reset) returns a status string, which is preceded and followed by
\r\n in a
\r\n<Status>\r\n format. The possible status are:
More details on each command description and examples are given in the remainder of this section. Note that each command preceded by # is provided by the host to the module. Then the return of the module is printed.