Redpoint Positioning V7 User manual
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 2
Table of Contents
Introduction.................................................................................................................... 3
Partner Branding Guidelines ........................................................................................... 4
Hardware Design ............................................................................................................ 4
3.1. Storage and Operating Conditions.................................................................................................... 4
3.2. Pin Definition .................................................................................................................................... 5
3.2.1. Reset.......................................................................................................................................... 7
3.2.2. External Power Source Mode .................................................................................................. 7
3.2.3. UART.......................................................................................................................................... 7
3.2.4. Configurable IOs........................................................................................................................ 7
3.3. Power Supply Requirements............................................................................................................. 7
3.4. RF Transceiver................................................................................................................................... 8
3.5. Layout and Footprint ........................................................................................................................ 8
3.6. Reference Design .............................................................................................................................. 9
3.7. Packaging and Handling .................................................................................................................. 10
3.8. Recommend Reflow Soldering Profile ............................................................................................10
3.9. Certification and Marking ...............................................................................................................11
Software Design............................................................................................................ 11
4.1. Data Types and Sizes.......................................................................................................................11
4.2. Module Communication Interfaces ................................................................................................11
4.2.1. UART Interface ........................................................................................................................12
4.2.2. Outgoing Messages.................................................................................................................12
4.2.3. Incoming Messages and Commands.......................................................................................16
4.3. Firmware Update..........................................................................................................................20
4.3.1. Over the Air (OTA) ...............................................................................................................20
4.3.2. SWD interface.......................................................................................................................24
Regulatory Information................................................................................................. 24
5.1. FCC Interference Statement (Part 15.105 (b)) ................................................................................24
5.2. FCC Part 15 Clause 15.21: ...............................................................................................................24
5.3. FCC Part 15.19(a): ...........................................................................................................................24
5.4. ISED RSS-Gen Notice (in English and French):.................................................................................25
5.5. ISED Canada ICES-003 Compliance Label........................................................................................25
5.6. RF Exposure Guidance ....................................................................................................................25
5.7. Module integration instructions for the End-Product Manufacturer.............................................25
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 3
Introduction
The Redpoint RTLS Module is a full-function Real-Time Location System (RTLS) subsystem in a
compact form factor. The self-contained module delivers all RTLS functions including high-
accuracy positioning, data communication over Redpoint UWB network, and Bluetooth without
the need of additional hardware.
The module is designed to allow our partners and customers
to design their own location tags or add real-time location and
two-way data communication capability to their existing
products. The module can be used as it is, or as part of a larger
system. It can be connected to external processors and
peripherals through serial and GPIO interfaces. The single-
sided design with castellation pins is compatible with the
standard SMT assembly process and therefore allows the
module to be directly installed on custom-designed carrier
PCBs. The firmware is preloaded in the modules before they
are shipped and therefore no programming or configuration is
needed by the designers. The module will start operating when
the power is supplied, and the reset is de-asserted.
Figure 2 shows the functional blocks in the RTLS Module. The
module is a single PCB design consisting of a micro-controller, an UWB radio transceiver with
an external antenna, a 6-axis Inertial Measurement Unit (IMU), and power management
circuitry.
MCU + BT UWB RFIC
IMU
External UWB Antenna
Onboard
DC-DC
Onboard
Power Management
UART
GPIO
External NFC Antenna
Programming interface
Power
FIGURE 2. FUNCTIONAL BLOCK DIAGRAM
FIGURE 1. REDPOINT RTLS MODULE
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 4
Partner Branding Guidelines
Redpoint Positioning Corp. requires all partner companies to display the ‘Positioned by
Redpoint’ logo:
On your software UI if you access the Redpoint server API
On the outside of your tag if you use the Redpoint RTLS module
For questions about partner branding, or to obtain the logo, please contact
support@redpointpositioning.com.
Hardware Design
The module consists of an Ultra-Wideband (UWB) transceiver (Decawave DW1000 ASIC), a
Nordic nRF52 SoC, a 6-axis IMU and discrete components including UWB and Bluetooth
antennas, RF circuitry and power management circuitry. A block diagram of the high-level
architecture for the RTLS module is shown in Figure 3.
SoC
nRF52
DW1000
SPI
SPI
Interface
IMU
UWB RF
UART
GPIO / AIN
NFC RF
SWD
1.8V
DC-DC
ENABLE
+1.8V
VCC_UWB
+3.3V
VCC
+3.3V +3.3V
FIGURE 3. HARDWARE BLOCK DIAGRAM
3.1. Storage and Operating Conditions
The modules should be stored indoors with relative humidity no greater than 95%, and
temperature between -40 °C and 85 °C.
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 5
Parameter Maximum Rating
Temperature (°C) -40 to 85
Humidity (%) < 95
TABLE 1. STORAGE CONDITIONS
Parameter Min Max
Temperature (°C) -40 85
Humidity (%) N/A <90
Supply Voltage (V) 2.8 3.6
TABLE 2. OPERATING CONDITIONS
3.2. Pin Definition
The RTLS module has a total of 24 pins, including:
10 for power and ground
5 dedicated pins (reset, programming, and etc.)
2 for NFC Antenna
2 for UART
5 configurable IOs as special-purpose or general-purpose IOs (GPIOs)
The pin assignment and layout are shown in Figure 4.
VCC_UWB 1
GND 2
nALM_i/GPIO4 3
GND 5
EXT_PWR 4
nRST_o 6
GND 7
VCC 8
24 SWDIO
23 SWDCLK
22 nRST_i
20 TXD
21 RXD
17 GND
GND 9
19 NFC2
18 NFC1
GND 10
INT/GPIO2 13
nALM_o/GPIO3 14
GND 15
VCC 16
SDA/GPIO0 11
SCL/GPIO1 12
UWB
Antenna
Connector
TOP VIEW
FIGURE 4. PIN ASSIGNMENT AND LAYOUT
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 6
The external IOs can be grouped functionally as:
Dedicated pins
One (1) SWD programming interface
One (1) UART interface
Five (5) configurable IOs
One (1) NFC antenna port
The pin definitions are given in Table 3.
Category Pin name Type Pin Description
Power
VCC power input 8, 16 2.8V-3.6V
VCC_UWB power input 1 Power for UWB RF, must be the
same voltage with VCC
nRST_o output 6 Open drain reset output, needs
external pull-up, active low.
EXT_PWR input 4 External power source mode,
active high
GND ground 2,5,7,9,10,
15,17 Power ground
Programming
Interface
SWDCLK input 23 SWD programming interface with
internal pull-down resistor
SWDIO input /
output 24 SWD programming interface with
internal pull-up resistor
nRST_i input 22 Reset input with 13KOhm internal
pull-up resistor, active low
UART
TXD output 20 UART interface
RXD input 21 UART interface
NFC RF
NFC1 RF 18 NFC antenna port
NFC2 RF 19 NFC antenna port
Configurable
multipurpose
IOs
SDA / GPIO(0) digital IO /
analog in 11 I2C bus with 13KOhm internal pull-
up resistor / GPIO
SCL / GPIO(1) digital IO /
analog in 12 I2C bus with 13KOhm internal pull-
up resistor / GPIO
INT / GPIO(2) digital IO /
analog in 13 IRQ input with internal pull-up
resistor / GPIO
nALM_o / GPIO(3) digital IO /
analog in 14 Open drain alarm output, tri-state
in inactive mode, active low / GPIO
nALM_i / GPIO(4) digital IO /
analog in 3 User alarm input with internal pull-
up resistor, active low / GPIO
TABLE 3. PIN DEFINITION AND DESCRIPTION
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 7
3.2.1. Reset
The module can be reset externally by driving the nRST_i pin low for at least 0.5us. nRST_i is
internally pulled up and no external pull-up is necessary.
During bootup, the module will drive nRST_o low for at least 10ms. Once the module is
operational, the nRST_o will be tri-stated. Note that nRST_o is only asserted after nRST_i is
de-asserted.
3.2.2. External Power Source Mode
The module reads EXT_PWR to determine if there is an unlimited external power source. If
EXT_PWR is pulled up, the device is considered externally powered and operates in a high-
current consumption mode. If EXT_PWR is not connected or pulled down, the device is
considered battery-powered. EXT_PWR is connected to an internal 13K pull-down resistor, so
the external driver should provide at least 160uA to pull up the EXT_PWR reliability.
3.2.3. UART
The UART is the full duplex bi-directional serial interface and the primary communication
channel between the module and the external host or slave devices (e.g., host processor,
display controller, etc.). To communicate to the module through UART, the interface shall be
configured as follows:
Baud Rate 115,200
Flow Control None
Data format 8 bit
Parity None
Stop 1 bit
3.2.4. Configurable IOs
There are 5 multi-purpose pins that can be configured as GPIOs or special purpose pins. The
configurations of these IOs are defined by the CFG register (see details in 3.2.4.2). When
configured as special purpose IOs, these pins can be used as:
I2C bus: only supports the peripherals verified by RPP
Alarm output: user alarm output, active low
3.3. Power Supply Requirements
The power supplies for the UWB radio are separated from the rest of the circuit on the module
to improve the performance.
Power Rail Parameter Condition Min Typ Max Unit
VCC_UWB Voltage 2.8 3.3 3.6 V
Current @3.3V - 145 mA
VCC Voltage 2.8 3.3 3.6 V
Current @3.3V - 12 mA
TABLE 4. POWER INPUT REQUIREMENTS
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 8
3.4. RF Transceiver
The module has two complete radios, the UWB and the Bluetooth® radio.
The module contains a UWB radio operating in the unlicensed UWB band. The transmitted
signal bandwidth is 500 MHz or greater. The unit is calibrated such that the maximum radiated
spectrum density does not exceed -41 dBm/MHz and is fully compliant to the spectrum mask
defined in FCC part 15. It is also compliant with the similar spectrum regulation for regions and
countries including EU and China.
Parameter Min Max
Frequency Range (MHz) 3244 6999
10dB Bandwidth (MHz) 500
Center Frequency1(MHz) 3494.4 6489.6
Spectrum Density (dBm/MHz) N/A -41
TABLE 5. UWB RF PARAMETERS
Based on configuration via software, the module can operate on one of the four 500MHz wide
UWB channels specified in the table below.
Channel Number
F
c
enter
1
(MHz)
F
min
2
(MHz)
F
max
(MHz)
133494.4 3244.8 3744
2 3993.6 3774 4243.2
3 4492.8 4243.2 4742.4
5 6489.6 6240 6739.2
TABLE 6. UWB CHANNELS AND FREQUENCY
3.5. Layout and Footprint
The module can be installed on a carrier board using a standard SMT process. Figure 5shows
the recommended land pattern on the carrier board.
To achieve good positioning performance, the antenna patterns must be preserved. Therefore,
it is essential that there is no metal on any layer in the KEEP OUT AREA underneath the
antennas. The orientation of the module also affects the module performance as the UWB
antenna is linear polarized. In most cases, the optimal performance is achieved when the
module is in vertical position.
1The center frequency is software configurable. See table 6 for details.
2Fmin and Fmax are the 10 dB lower and upper band edges, i.e., the frequency at which the power density
drops 10 dB below the peak power density.
3Detection and Avoidance (DAA) is required in some countries for the channel(s). Redpoint’s system
does NOT implement DAA and therefore the user shall not operate the system in these channel(s).
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 9
FIGURE 5. MODULE LAND PATTERN
3.6. Reference Design
Figure 6. Reference Design
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 10
3.7. Packaging and Handling
The dimensions of the module are 32mm(L) x 25mm(W) x 3.11mm(T). There are 24 castellation
hole pin-outs around the module. The pitch is 100mil (2.54mm).
FIGURE 7. DIMENSION OF RTLS MODULE
3.8. Recommend Reflow Soldering Profile
FIGURE 8. RECOMMEND PB-FREE REFLOW SOLDERING PROFILE
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 11
3.9. Certification and Marking
The RTLS module is certified for the following countries and regions:
Country or Region (Certification Authority) ID or Marking
USA (FCC) 2ADX4-MODV7
Canada (IC) 12677-MODV7
European Union CE marking for emission, safety and environmental
China, including Hong Kong (CMIIT)
TABLE 7. REGULATORY CERTIFICATIONS
Products containing Redpoint RTLS modules are required to display the following on the
product label when sold in the US: “containing FCC ID 2ADX4-MOD7V.”
Products containing Redpoint RTLS modules are required to display the following on the
product label when sold in Canada: “containing IC: 12667-MOD7V.”
Software Design
4.1. Data Types and Sizes
Table 8 specifies data types and sizes used in this document.
Type Range Description
int8 -128 to 127 Signed 8-bit integer
int16 -32,768 to 32,767 Signed 16-bit integer
int32 -2,147,483,648 to 2,147,483,647 Signed 32-bit integer
uint8 0 to 255 Unsigned 8-bit integer
uint16 0 to 65,535 Unsigned 16-bit integer
uint32 0 to 4,294,967,295 Unsigned 32-bit integer
string ASCII ASCII character string
hex[N] 0-9,A-F, a-f Hexadecimal string representing N/2 bytes
TABLE 8DATA TYPES
4.2. Module Communication Interfaces
The RTLS module outputs various application data, such as tags’ positions, application alarms
and messages. The module accepts input messages including configuration, commands and
user data to be sent directly to the server.
For the rest of this document, the direction of the message is defined with respect to the
module.
Messages shall be ASCII strings terminated with the LF (0x0A). Output messages are preceded
with the # (pound) character followed by the message type. Optionally, a message can have
content fields. Content of the message is generally in the form of variable=value separated by
spaces.
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 12
The RTLS module supports communication over UART interfaces.
4.2.1. UART Interface
The UART is the full duplex bi-directional interface between the module and the external host
device.
The following is the physical configuration of the UART:
Baud rate: 115200.
No hardware flow control.
8N1 byte format.
4.2.1.1. UART Modes of Operation
The module’s UART has two modes of operation, command and binary.
Command mode is used to provide the communication interface described in this document.
Binary mode is used to provide the sensor interface communication channel described in “[3]
Sensor Interface User Guide”. When UART is set to operate in binary mode, the module does
not process incoming data and sends its payload as a binary sensor data packet directly to the
server.
During boot-up, the UART is configured to command mode for 30 seconds. After 30 seconds,
the module checks the “Keep CMD on” flag. If the flag is set, the UART stays in command mode
until it receives a different configuration from the server or is turned off using the command line.
If the flag is not set, the module turns off UART after 30 seconds. After it turns off, it can be
turned on again only after rebooting. The flag can be configured using the CFG UART
command described below.
4.2.2. Outgoing Messages
The available message types are:
#POS—calculated position
#ALM—alarm message
#MSG—text message received from the server
#IMU—raw output of the IMU
#VER—printing hardware and firmware versions
#CFG—module configuration
4.2.2.1. #POS - Position update
Position update messages start with a #POS preamble and have the following content fields:
Name
Type
Values
Description
x int32 Position X in mm.
y int32 Position Y in mm.
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 13
Name
Type
Values
Description
z int32 Position Z in mm.
sl uint16 Area ID
fom uint8 50-255 Figure of merit—confidence level of the position
estimate. A smaller value is better.
Note: Not available for 1D, 0D and PD positioning
mode.
er uint32 0D mode - distance to 0D anchor in mm.
1D mode – distance to the line connecting anchor
pair(mm).
Note
: Only available in 0D and 1D modes.
op string UWB|IMU,
0D|1D|2D|3D|PD,
E,I,A,S
Comma separated flags indicating various position
estimation options. Current values are:
UWB|IMU - position estimated from UWB or IMU
0D|1D|2D|3D|PD - positioning mode
E - edge correction applied
I - inactive state, IMU detected device not moving
A - ranging in non-synchronous mode (TW-TOA)
S
-
indicate tag being synchronized in network
ts uint32 Local timestamp. Number of milliseconds elapsed
since node boot up.
TABLE 9POSITION UPDATE CONTENT FIELDS
The following is an example of a position update message:
#POS x=10352 y=2768 z=1008 sl=7 fom=50 op=UWB,2D,E ts=45376
4.2.2.2. #IMU – IMU output
The raw reading of the on-board 6-axis IMU can be output directly to the UART. The sampling
rate of the IMU is 52Hz. The following table lists the content fields of the #IMU message:
Name
Type
Description
ax int32 Linear acceleration axis X in mg/s2
ay int32 Linear acceleration axis Y in mg/s2
az int32 Linear acceleration axis Z in mg/s2
rx int32 Angular rate axis X in rad*10-3/s
ry int32 Angular rate axis Y in rad*10-3/s
rz int32 Angular rate axis Z in rad*10-3/s
ts uint32 Local timestamp of the number of milliseconds elapsed since node boot
up
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 14
Name
Type
Description
md uint8 0 - no motion detected / 1 - motion detected
TABLE 10 CONTENT FIELDS OF THE IMU MESSAGE.
The following is an example of the IMU raw readings:
#IMU ax=ddddd ay=ddddd az=ddddd rx=bbbbb ry=bbbbb rz=bbbb ts=45376 md=1
4.2.2.3. #ALM – Alarm
Alarm messages start with the preamble #ALM and have the following content fields:
Name Type Values Description
t string SA|CA Alarm type. Supported types:
SA—safety zone violation alarm
CA
—collision avoidance alarm.
zal uint8 0-5 Alarm level. Note: Only for SA alarms.
Non-0 indicates there is an alarm state.
0 level means the alarm cleared and there
is no alarm state.
z_uid string 22 characters The UID of the zone associated with the alarm.
Note
: Only for SA alarms.
d uint16 Distance to monitor/announcer. Note: Only for
CA alarms.
a16 hex[4] 16-bit short address of the monitor/announcer.
Note
: Only for CA alarms.
op string A|V Comma-separated flags indicating various
options:
A—Alarm is triggered by T2T LLL
announcer with address a16.
V—Alarm is triggered by T2T LLL monitor
with address a16.
TABLE 11 ALARM MESSAGE CONTENT FIELDS
The following is an example of a safety zone violation alarm:
#ALM t=SA zal=5 z_uid=auEbCGexShi14TfSmGs1kw
The following is an example of a collision avoidance violation alarm:
#ALM t=CA d=1234 a16=A4BF op=A
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 15
Note: When the alarm message is sent, the nALM_o is also driven low if special purpose
nALM_o
is
configured using CFG command
.
4.2.2.4. #MSG – Server message
ASCII messages received from the server are issued from the module as #MSG messages.
This message type is indicated with the preamble #MSG, followed by the actual ASCII strings of
the message. The preamble and the body of the server message is separated by a space.
However, the message body may contain spaces and shall be preserved. Note that the format
of the content field is different from other outgoing messages.
The following is an example of the message received from the server and output to the
interface:
#MSG txt=”test message from the server”
The following is an example if binary data is sent from the server to the module:
#MSG hex=hex_string
4.2.2.5. #ERR – Hardware fault code
A message is printed when the module boots up if there is any hardware failure.
All faults are aggregated into one 32bit value. Every fault event is mapped to a particular bit.
Bit # Description
0 Application image is corrupted.
1 Radio chip not found (initialization failed).
2 IMU chip not found (initialization failed).
TABLE 12 VERSION MESSAGE CONTENT FIELDS
The following is an example of the message when the radio chip has failed:
#ERR hw=00000002
4.2.2.6. #VER – Hardware and Firmware versions
Version messages start with the preamble #VER and have the following content fields:
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 16
Name Type Description
sn string MAC address of the module.
hw string Hardware revision of the module.
cbid string Carrier board ID.
fw string Firmware version.
TABLE 13 VERSION MESSAGE CONTENT FIELDS
The following is an example of the #VER message:
#VER sn=E4956EAE01BB hw=7.0 cbid=3E61 fw=5.7.1
The module will print version messages at bootup automatically if the “Keep CMD on” flag is set.
4.2.3. Incoming Messages and Commands
Through the UART, commands and messages can be sent to the module. Similar to output
messages, the incoming messages are ASCII strings with a predefined 3-letter preamble.
Configuration
User Alarms
User Messages
External battery remaining capacity
Others
4.2.3.1. CFG – Configuration
Many functions and IOs of the RTLS module are configurable. The module is typically
configured by the server with over-the-air messages. Some configurations can also be set
locally via the UART. If the CFG command is sent without the value field, it is treated as a read
command and the module will output the current configuration value for the corresponding unit.
The following is the list of the configuration messages supported by the module:
CFG config_word – set/get configuration register value
CFG OUT – configure module output messages
CFG IMU – to configure IMU module
CFG UART – to configure UART mode
CFG OTA – to request OTA control by host
CFG CBD – to set/get CBID value
4.2.3.2. CFG config_word
The configuration word is set using the following command:
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 17
CFG config_word
where config_word is a 32bit hexadecimal value (reset value is 0xA0000000). The ‘0x’ prefix is
not required. If the command is sent without the value field, it is treated as a read command and
the module will output the configuration value.
Bits Field name Type Description
31:30 MODE R/O Tag operation mode, 00=navigation (DL-TDOA), 01=asset
(UL-TDOA), 11=debug (TW-TOA), 10=reserved (not
configured)
29 IMU_SLEEP_EN R/W 0=node does not switch to inactive mode when it stops
moving; 1= node switches to inactive mode when it stops
moving;
27:18 Reserved
17 ALM_OUT_EN R/W GPIO(3) is configured as Alarm output when this bit is set.
16:0 Reserved
TABLE 15 CFG MESSAGE CONTENT FIELDS
4.2.3.3. CFG OUT
The CFG OUT message is used to configure which outgoing messages will be output by the
module and has the following content fields:
Name Type Values Description
en string P,I,M,A,H Enabling output from following:
P – positioning #POS
I – enable #IMU output
M – enable #MSG
A – enable alarms #ALM
H – enable high frequency positioning output if
available
The following is an example of a CFG OUT message, enabling output for positions and alarms
only:
CFG OUT en=P,A
A CFG OUT message without any option will disable the output.
CFG OUT en=
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 18
Note: The local pos output at tag UART (CFG OUT en=P) may not be matched with the pos
updates sent to server when AF (Advance Filtering) is enabled on tag. Please refer to 3.2.4.4
CFG IMU for more details.
When AF is enabled, the pos update could be sent from AF with IMU data. The local pos output
(CFG OUT en=P) could be mismatched with the pos data sent to server. It is a requirement to
check both the pos and high frequency output (CFG OUT en=P,H) to match the pos data sent to
server.
4.2.3.4. CFG IMU
The CFG IMU message is used to configure the IMU’s mode of operation and has the following
fields:
Name Type Values Description
m string off
md
af
Configuring IMU mode:
off—turn IMU off
md—motion detection mode
af
—advance filtering
The following is an example of a CFG IMU message, turning IMU off:
CFG IMU m=off
4.2.3.5. CFG UART
The CFG UART message is used to set/erase command mode of the operation flag and has
the following fields:
Name Type Values Description
cmd string
off
on
Configuring UART mode:
off - turn UART off and clear “Keep CMD
on” flag
on – set UART to command mode and set
“Keep CMD on” flag
The following is an example of a CFG UART message, setting command mode and flag:
CFG UART cmd=on
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 19
4.2.3.6. CFG CBD
The CFG CBD message is used to check and set the CBID and has the following fields:
Name Type Values Description
id string null
<4 character string
value>
The ID can only be set once. Redpoint will
assign a CBID based on the carrier board with
which the RTLS module is embedded.
The following is an example of a CFG CBD message, enabling output for positions and alarms
only:
To see the current value:
CFG CBD id
To set a CBID value:
CFG CBD id=3E58
4.2.3.7. MSG – User Message
The MSG command allows the user to send data from the tag to the server. User data received
by the server are sent out via the WebSocket. The RTLS server does NOT store user
messages.
MSG hex=hex_string
The maximum payload size is 256 binary bytes. The payload is a string of hexadecimal digits
(ASCII string consists of only characters ‘0’–‘9’ and ‘A’-‘F’).
Note: The delivery of the user data is not guaranteed. Users shall implement QoS mechanism if
guaranteed delivery if required.
4.2.3.8. Hardware fault code
Upon receiving the following command, the module will print out the hardware fault code.
ERR
See 4.2.2.5 for details.
V7 EXTERNAL ANTENNA RTLS MODULE USER MANUAL
© 2020 Redpoint Positioning Corp. Restricted Distribution 20
4.2.3.9. Version
Upon receiving the following command, the module will print out the HW and SW versions.
VER
See 4.2.2.5 for details.
4.2.3.10. BAT - External battery remaining capacity
The BAT command provides an interface to set the value of the remaining external battery
capacity. It reports to the server as a battery level. If it is issued without arguments, the module
will print the current value. The default reset value is “-1”, meaning the battery is not attached or
undefined.
If the value of the ‘cap’ argument is outside of allowed range or cannot be parsed, module
returns the string ‘error’.
The command has the following field:
Name Type Values Description
cap uint8 0-100
-1
Remaining battery capacity in percent
To reset value to ‘UNDEFINED’/No battery
The following are examples of a BAT command, setting capacity to different level:
BAT cap=57 // 57%
#BAT cap=57
BAT // empty to read current value
#BAT cap=57
BAT cap=125 // wrong value
#BAT error
4.3. Firmware Update
The module is pre-loaded with an application image. After it is powered on, the module can
automatically start the application. The application firmware update can be carried out using the
Over-the-Air (OTA) method or via the Serial Wire Debug (SWD) interface.
4.3.1. Over the Air (OTA)
An OTA firmware upgrade is performed using Redpoint’s utility software. Please refer to
Redpoint SitePlan User Guide for more information.
4.3.1.1. CFG OTA
The CFG OTA message is used by host to request OTA control and has the following fields:
Table of contents
