HOMEABOUT USPRODUCT INFORMATION IN-DEPTH ANALYSIS OF THE UWB650 MODULE (PART 5): C...

In-Depth Analysis of the UWB650 Module (Part 5): Configuration Commands

12

Sep . 2025

By sdga:

This chapter provides a summary of all known configuration and operation commands for the UWB650 module, intended to serve as a comprehensive and quick reference for software development engineers. The UWB650 module uses configuration commands to modify some of its runtime parameters.

UWB650 Module Mechanical Dimensions Diagram

Definitions

  • : Carriage Return character, i.e., 0x0D.

  • : Line Feed character, i.e., 0x0A.

  • <...>: Parameter name. The angle brackets do not appear in the actual command.

Configuration Command Format

When a user inputs data through the serial port, the module detects whether the data is a configuration command and processes and responds accordingly. The format of configuration commands is fixed: it starts with UWBRFAT and ends with. The command's response and result codes always begin and end withand.

Example of command input and its hexadecimal representation

Throughout this document,andwill be intentionally omitted when describing configuration commands and their responses. Users who do not need to configure parameters should try to avoid sending data packets that start with UWBRFAT and end withand.

Serial Port Reception Handling Mechanism

The UWB650 module uses a timeout detection method to determine the number of bytes received from the serial port. When the module receives the first byte, it starts a timer of about 5ms. If it continues to receive other bytes, the timer is reset. Reception stops and data processing begins either when the receive buffer is full or when the timer triggers a timeout.

1) Check if the module is working properly

Command

Response

UWBRFAT

OK

 

2) Get module firmware version

Command

Response

UWBRFAT+VERSION?

V1.2

Note: Since the module firmware may be updated later, the response content in this document is for reference only.

 3) Restore all module parameters to default values

Command

Response

UWBRFAT+DEFAULT

OK

Note: This command will cause the module to restart. The module responds with OK before executing the restart operation.
After the module starts up, the serial port will output the following string:

Finished Startup

4) Reboot the module

Command

Response

UWBRFAT+RESET

OK

Note: This command will cause the module to restart. The module responds with OK before executing the restart operation.

After the module starts up, the serial port will output the following string:

Finished Startup

5) Save configurable parameters to internal Flash

Command

Response

UWBRFAT+FLASH

OK

Note: In the subsequent configuration command descriptions, commands marked with * indicate that their related parameters can be saved to Flash using this command. These parameters will be applied directly upon subsequent module restarts.

6) Configure the module's serial port baud rate

Command

Response

Query

UWBRFAT+BAUDRATE?

+BAUDRATE=

Set

*UWBRFAT+BAUDRATE=

OK

Description

: Integer type. Each value represents the corresponding serial
port baud rate:

0:230400bps

1:115200bps(Default

2:57600bps

3.38400bps

4.19200bps

5.9600bps

Note: Other configurations of the module's serial port are fixed: 8 data bits, 1 stop bit, no parity bit, no flow control.

Example

Query the current serial port baud rate of the module:

SendUWBRFAT+BAUDRATE?

Response:+BAUDRATE=0

Set the module's serial port baud rate to 9600:
SendUWBRFAT+BAUDRATE=5

Response:OK

Error Example

SendUWBRFAT+BAUDRATE=6

Response:Error

 

7) Configure the UWB chip's air data rate

Command

Response

Query

UWBRFAT+DATARATE?

+DATARATE=

Set

*UWBRFAT+DATARATE=

OK

Description

: Integer type. Different values represent different air data rates.

0:850Kbps

1:6.8Mbps(Default

Example

Query the air data rate:
SendUWBRFAT+DATARATE?

Response:+DATARATE=1

Set the air data rate:
SendUWBRFAT+DATARATE=0

Response:OK

Error Example

SendUWBRFAT+DATARATE=2

Response:Error


8) Configure the UWB chip's PAN ID and Address

Command

Response

Query

UWBRFAT+DEVICEID?

+DEVICEID=,

Set

*UWBRFAT+DEVICEID=,

OK

Description

: 4-byte hex character type. Range: 0000-FFFE (Default: 0000)

: 4-byte hex character type. Range: 0000-FFFE (Default: 0000)

Example

QueryPAN ID and Address:

SendUWBRFAT+DEVICEID?

Response:+DEVICEID=1234,5678

SetPAN ID and Address:

SendUWBRFAT+DEVICEID=ABCD,1234

Response:OK

Error Example

SendUWBRFAT+DEVICEID=FFFF,FFFF

Response:Error

 

9) Configure the module's transmit power

Command

Response

Query

UWBRFAT+POWER?

+POWER=

Set

*UWBRFAT+POWER=

OK

Description

: Integer type. Range: 0-10. Different values represent different powerLevels:

Level

Output Power (dBm)

0

-5

1

-2

2

2.14

3

7.5

4

8.8

5

11

6

14

7

17

8

20.2

9

23.7

10(Default

27.7

 

Example

Query the module's transmit power:
SendUWBRFAT+POWER?

Response:+POWER=0

Set the transmit power:
SendUWBRFAT+POWER=10

Response:OK

Error Example

SendUWBRFAT+POWER=11

Response:Error

 

10) Configure the UWB chip's preamble code parameter

Command

Response

Query

UWBRFAT+PREAMBLECODE?

+PREAMBLECODE=

Set

*UWBRFAT+PREAMBLECODE=

OK

Description

: Integer type. Range: 9-24 (Default: 9). UWB650 modules with different preamble code parameters cannot communicate.

Example

Query the preamble code parameter:
SendUWBRFAT+ PREAMBLECODE?

Response:+PREAMBLECODE=9

Set the preamble code parameter:
SendUWBRFAT+PREAMBLECODE=12

Response:OK

Error Example

SendUWBRFAT+PREAMBLECODE=3

Response:Error

 

11) Configure CCA (Clear Channel Assessment) function

Command

Response

Query

UWBRFAT+CCAENABLE?

+CCAENABLE=

Set

*UWBRFAT+CCAENABLE=

OK

Description

: Integer type.

0: Disable CCA function (Default)

1: Enable CCA function

This function is only used in data transmission mode. After enabling CCA, if the module detects ongoing data transmission in the air before sending normal data, it will stop sending. The serial port will reply with the following:

CCA FAILURE

Example

Query if CCA function is enabled:

SendUWBRFAT+ CCAENABLE?

Response:+CCAENABLE=0

Enable CCA function:

SendUWBRFAT+CCAENABLE=1

Response:OK

Error Example

SendUWBRFAT+CCAENABLE=2

Response:Error

 

12) Configure ACK (Automatic Response Request) function

Command

Response

Query

UWBRFAT+ACKENABLE?

+ACKENABLE=

Set

*UWBRFAT+ACKENABLE=

OK

Description

: Integer type.
0: Disable ACK send request (Default)

1: Enable ACK send request
After enabling the ACK send request, all data sent by the module in data transmission mode will include an ACK request. If no ACK reply is received, the serial port will reply with the following:

ACK WAIT TIMEOUT

If an ACK reply is received, the serial port will reply with the following:

ACK DETECTED

Example

Query if ACK function is enabled:

SendUWBRFAT+ACKENABLE?

Response:+ACKENABLE=0

Enable ACK function:
SendUWBRFAT+ACKENABLE=1

Response:OK

Error Example

SendUWBRFAT+ACKENABLE=2

Response:Error

 

13) Configure the module's AES-128 key

Command

Response

Query

UWBRFAT+SECURITY?

+SECURITY=,

Set

*UWBRFAT+SECURITY=,

OK

Description

: Integer type.

0: Disable AES encryption (Default)

1: Enable AES encryption
After enabling AES encryption, the Frame Payload content sent by the module in data transmission mode will be encrypted for more reliable data transmission.

: Hex character type. Length is 32 bytes.

Default000102030405060708090A0B0C0D0E0F

Example

Query the status of the AES encryption function and the key:

SendUWBRFAT+SECURITY?

Response:+SECURITY=0,00112233445566778899AABBCCDDEEFF

Enable AES encryption and set the key:

SendUWBRFAT+SECURITY=1,112233445566778899AABBCCDDEEFF00

Response:OK

Error Example

SendUWBRFAT+SECURITY=112233445566778899AABBCCDDEEFF00

Response:Error

 

14) Set the data transmission target address

Command

Response

Query

UWBRFAT+TXTARGET?

+TXTARGET=

Set

*UWBRFAT+TXTARGET=

OK

Description

: 4-byte hex character type. Range: 0000-FFFF (Default: 0000)
When set to FFFF, data sent by the module's data transmission function will be treated as a broadcast.

Example

Query the current transmission target:

SendUWBRFAT+TXTARGET?

Response:+TXTARGET=AB12

Modify the current transmission target:

SendUWBRFAT+TXTARGET=1234

Response:OK

Error Example

SendUWBRFAT+TXTARGET=123

Response:Error

 

15) Set the module's Mesh networking function

Command

Response

Query

UWBRFAT+MESHENABLE?

+MESHENABLE=

Set

*UWBRFAT+MESHENABLE=

OK

Description

: Integer type.
0: Disable Mesh function (Default)

1: Enable Mesh function, module acts only as a relay
2: Enable Mesh function, module acts only as a node

3: Enable Mesh function, module can act as both a relay and a node
Note: In Mesh mode, the maximum single packet size is 1004 bytes. Modules with Mesh enabled cannot send/receive ordinary data with modules that do not have Mesh enabled (ranging/location functions are excluded).

Example

Query the Mesh function status:
SendUWBRFAT+MESHENABLE?

Response:+MESHENABLE=0

Enable Mesh function, module acts as a node:
SendUWBRFAT+MESHENABLE=2

Response:OK

Error ExampleUWBRFAT+MESHENABLE=4

Response:Error

 

16) Set the module to display source address information when receiving data

Command

Response

Query

UWBRFAT+RXSHOWSRC?

+RXSHOWSRC=

Set

*UWBRFAT+RXSHOWSRC=

OK

Description

: Integer type.

0: Do not display source address information
1: Display source address information (Default)

Note: After enabling, when the module receives normal data, it will display the source address and signal strength.

For example, receiving data (123456789) from another module (address 1234) with a signal strength of -45.60dBm:

SrcAddr:1234;Rssi:-45.60dBm;Data:123456789

If the module has Mesh enabled and is set as a node, it will receive data in the following format:

Mesh SrcAddr:1234;Data:123456789

Example

Query whether to display source address information:

SendUWBRFAT+RXSHOWSRC?

Response:+RXSHOWSRC=0

Enable displaying source address information:

SendUWBRFAT+RXSHOWSRC=1

Response:OK

Error Example

SendUWBRFAT+RXSHOWSRC=2

Response:Error

 

17) Set the status of the module's onboard LED:

Command

Response

Query

UWBRFAT+LEDSTATUS?

+LEDSTATUS=

Set

*UWBRFAT+LEDSTATUS=

OK

Description

: Integer type.

0: Disable LED status indicator

1: Enable LED status indicator (Default)

Note: During operation, a flashing red light indicates the module is transmitting data; a flashing blue light indicates the module is in receiving state, but does not necessarily mean data is being received.

Example

Query if the LED status indicator is enabled:

SendUWBRFAT+LEDSTATUS?

Response:+LEDSTATUS=1

Disable the LED status indicator:
SendUWBRFAT+LEDSTATUS=0

Response:OK

Error Example

SendUWBRFAT+LEDSTATUS=2

Response:Error

 

18) Set the module's receive state

Command

Response

Query

UWBRFAT+RXENABLE?

+RXENABLE=

Set

*UWBRFAT+RXENABLE=

OK

Description

: Integer type.

0: Disable receive state
1: Enable receive state (Default)

After disabling reception, the module enters IDLE state. It can still send data in data transmission mode but cannot receive data. Power consumption will be reduced in this state.

Example

Query if the receive state is enabled:

SendUWBRFAT+RXENABLE?

Response:+RXENABLE=1

Disable reception:
SendUWBRFAT+RXENABLE=0

Response:OK

Error Example

SendUWBRFAT+RXENABLE=2

Response:Error

 

19) Set the module's SNIFF (Sniff Receive) state

Command

Response

Query

UWBRFAT+SNIFFEN?

+SNIFFEN=

Set

*UWBRFAT+SNIFFEN=

OK

Description

: Integer type.

0: Disable Sniff Receive (Default)

1: Enable Sniff Receive

After the user enables Sniff Receive, the module will temporarily disable it when starting ranging/location functions. It will re-enable Sniff Receive after the function is closed.

Example

Query if Sniff Receive is enabled:

SendUWBRFAT+SNIFFEN?

Response:+SNIFFEN=0

Disable reception:

SendUWBRFAT+SNIFFEN=1

Response:OK

Error Example

SendUWBRFAT+SNIFFEN=2

Response:Error

 

20) Set the module's antenna delay

Command

Response

Query

UWBRFAT+ANTDELAY?

+ANTDELAY=

Set

*UWBRFAT+ANTDELAY=

OK

Description

: Integer type. Range: 0-65535. Default: 16400. The module's antenna delay parameter.
The antenna delay parameter directly affects the error of ranging results in ranging and positioning functions. Calibrating the antenna delay makes the ranging result as close as possible to the actual distance.
When using our company's UWB antennas, the corresponding antenna delay parameters can be used for different models:

Antenna Model

Recommended Antenna Delay Value

UWB-PCB-X


UWB-PCB-D


UWB-ZT50


UWB-ZT50


Please consult our company for specific parameters of each antenna model.
If you are not using our company's UWB antennas, you need to manually calibrate the antenna delay. Please refer to "How to Calibrate Antenna Delay for UWB650 Module.pdf" for how to calibrate.

Example

Query the antenna delay parameter:
SendUWBRFAT+ANTDELAY?

Response:+ANTDELAY=16400

Set the antenna delay parameter:
SendUWBRFAT+ANTDELAY=12345

Response:OK

Error Example

SendUWBRFAT+LEDSTATUS=123456

Response:Error

 

21) Module's Ranging Function

Command

Response

Set

UWBRFAT+RANGING=,

+RANGING=(),()

Description

: 4-byte hex type. The target address for ranging when the module acts as initiator. Range: 0000-FFFE. Multiple addresses can be entered, separated by commas. The number of addresses must match the value of theparameter.
The module will perform the ranging process with the target modules in the order of the addresses in the command and output the ranging information together upon completion.
: Floating-point string type. Distance information output after ranging completes. Up to 2 decimal places. If ranging fails, this value will be -1.

: Floating-point string type. Signal strength information of the other end output after ranging completes. Up to 2 decimal places.
Note: After receiving the ranging signal from the host, the other end will output the ranging information once the ranging is completed.

Example

Get the distance to the module with address 0001:
SendUWBRFAT+RANGING=1,0001

Response:+RANGING=(12.34),(-56.78)

Ranging information output by the module with address 0001:
Simultaneously get distances to modules with addresses 0002 and 0003:

SendUWBRFAT+RANGING=2,0002,0003

Response:+RANGING=(34.12,26.17),(-53.23,-49.15)

Get the distance to the module with address 0004, but ranging fails:

SendUWBRFAT+RANGING=1,0004

Response:+RANGING=(-1),(0.00)

Error Example

SendUWBRFAT+RANGING=123,456

Response:Error


22) Module's Positioning Function

Command

Response

Set

UWBRFAT+LOCATION=

+LOCATION=(,,),(),()

Description

: 4-byte hex type. The target anchor addresses for positioning when the module acts as a Tag. Range: 0000-FFFE. At least 3 addresses are required, up to 8 can be entered (separated by commas).
The module will initiate the positioning process with the target anchors and output the positioning result after the process ends.

: The calculated current x-coordinate of itself after positioning completes. Up to 2 decimal places, unit is meters (m).

: The calculated current y-coordinate of itself after positioning completes. Up to 2 decimal places, unit is meters (m).

: The calculated current z-coordinate of itself after positioning completes. Up to 2 decimal places, unit is meters (m).

: Floating-point string type. Distance information output after positioning completes. Up to 2 decimal places. If acquisition fails, this value will be -1.

: Floating-point string type. Signal strength information of the other end output after ranging completes. Up to 2 decimal places. If distance acquisition fails, this value will be 0.

Example

With 3 anchors nearby (0001, 0002, 0003), get the relative position to these anchors:
SendUWBRFAT+LOCATION=0001,0002,0003

Response:+LOCATION=(12.34,34.56,56.78),(11.22,33.44,55.66),(-45.45,-56.56,-67.67)

Error Example (Insufficient number of anchor addresses entered):
SendUWBRFAT+RANGING=0001,0002

Response:Error

23) Set Anchor Coordinates

Command

Response

Query

UWBRFAT+COORDINATE?

+COORDINATE=,,

Set

*UWBRFAT+COORDINATE=,,

OK

Description

: Integer type. The anchor's x-coordinate, unit is cm. Range: 0-100000 (Default: 0)
: Integer type. The anchor's y-coordinate, unit is cm. Range: 0-100000 (Default: 0)
: Integer type. The anchor's z-coordinate, unit is cm. Range: 0-100000 (Default: 0)

Example

Query the module's own coordinates when acting as an anchor:
SendUWBRFAT+COORDINATE?

Response:+COORDINATE=12345,0,54321

Set the module's own coordinates:
SendUWBRFAT+COORDINATE=12345,54321,100

Response:OK

 

24) Set Ranging Offset

Command

Response

Query

UWBRFAT+DISTOFFSET?

+DISTOFFSET=

Set

*UWBRFAT+DISTOFFSET=

OK

Description

: Integer type. Range: -500~500. Default: 0. Sets the offset value for ranging results when using ranging or positioning functions. Unit is cm.
When the set offset value is positive, the module will add this offset to the ranging result; when the value is negative, it will subtract the offset.

Example

Query the ranging offset value:
SendUWBRFAT+DISTOFFSET?

Response:+DISTOFFSET=34

Set the ranging offset value:
SendUWBRFAT+DISTOFFSET=100

Response:OK



In-Depth Analysis of the UWB650 Module Series


Contact Us

 +86-755-23080616

 sales@nicerf.com

Website: https://www.nicerf.com/

Address: 309-315, 3/F, Bldg A, Hongdu business building, Zone 43, Baoan Dist, Shenzhen, China

Contact us
Privacy Policy

Privacy Policy

· Privacy Policy

There is currently no content available


           

Email:sales@nicerf.com

Tel:+86-755-23080616

Address:309-315, 3/F, Bldg A, Hongdu business building, Zone 43, Baoan Dist, Shenzhen, China


×