Zigbee RF Performance Test

Introduction

The Zigbee RF Test CLI application provides command-line interface commands for testing RF performance of Zigbee devices according to the Zigbee Alliance RF Performance (TRP/TIS) Test Plan & Specification. This application implements the standardized test commands required for Total Radiated Power (TRP) and Total Isotropic Sensitivity (TIS) testing.

Using the CLI Test Tool

1. Build and flash the Zigbee RF Test application using elcap.
2. Connect to the chip with a terminal program using UART configuration 115200,N,8,1
3. Type help for a list of commands
4. All RF test commands are prefixed with "custom"

Command Overview

The CLI implements the Zigbee Alliance RF Performance test specification commands for both local device control and remote device under test (DUT) communication. Commands are categorized as:

• Local commands (l-prefix): Control the local test device
• Remote commands (r-prefix): Send commands to the remote device under test
• General commands: Coordinate testing between local and remote devices

CLI Command Reference

All below commands are in the "custom" command table.

Command	Parameters	Description
test	None	Starts or stops a 1-second repeating test print event
rping	None	Send a ping command to a remote device and wait for acknowledgment
lpingtimeout	2 byte timeout - [Timeout MSB] [Timeout LSB]	Configure how long to wait for ping responses from the remote device
setchannel	4 byte channel mask - [mask3] [mask2] [mask1] [mask0]	Set the channel on both local and remote devices
lsetchannel	4 byte channel mask - [mask3] [mask2] [mask1] [mask0]	Set the channel on on the local device only
rsetchannel	4 byte channel mask - [mask3] [mask2] [mask1] [mask0]	Set the channel on on the remote device only
lgetchannel	None	Print the local channel configuration
lchan	Zigbee channel number (11-26)	Set local device channel using channel number
lsetpower	2 byte mode and 1 byte power in dBm - [mode MSB] [mode LSB] [dBm]	Set the transmit power on the local device
rsetpower	2 byte mode and 1 byte power in dBm - [mode MSB] [mode LSB] [dBm]	Set the transmit power on a remote device
lgetpower	None	Print local device transmit power
rgetpower	None	Request and print remote device transmit power
rawpower	1 byte power index value for specific chip	Set raw power index directly
rstream	2 byte timeout - [Timeout MSB] [Timeout LSB]	Command remote device to transmit modulated RF stream for specified timeout
lstream	1 byte enable - 1 to start, 0 to stop	Start or stop modulated transmission stream on local device
rtone	2 byte timeout - [Timeout MSB] [Timeout LSB]	Command remote device to transmit unmodulated carrier tone for specified timeout
ltone	1 byte enable - 1 to start, 0 to stop	Start or stop unmodulated carrier tone on local device
tx	Number of packets to transmit	Transmit specified number of test packets to remote device
rstart	None	Start receive test mode on remote device
rend	None	End receive test mode and request statistics from remote device
find	None	Locate remote device across all Zigbee channels and establish communication
lreboot	None	Perform software reset of local device
rreboot	None	Send reboot command to remote device
rhardwareversion	None	Request hardware version information from remote device
rsoftwareversion	None	Request software/firmware version information from remote device

Test Procedure Examples

TRP (Total Radiated Power) Test Procedure

1. Initialize Communication:

   > custom find
   > custom rping

2. Set Test Channel:

   > custom setchannel 0x00 0x00 0x08 0x00  // Channel 11 (2405 MHz)

3. Configure Power:

   > custom rsetpower 0x00 0x00 10  // Set to 10 dBm

4. Start Transmission Stream:

   > custom rstream 0x27 0x10  // 10 second stream (10000ms)

5. Measure with Spectrum Analyzer (external equipment)
6. Repeat for Other Channels as required by test specification

TIS (Total Isotropic Sensitivity) Test Procedure

1. Initialize Communication:

   > custom find  
   > custom rping

2. Set Test Channel:

   > custom setchannel 0x00 0x00 0x08 0x00  // Channel 11

3. Start Receive Test:

   > custom rstart

4. Generate Test Signal (using external signal generator)
5. End Test and Get Results:

   > custom rend

Technical Implementation Notes

Channel Mapping

Channel numbers are converted to IEEE 802.15.4 channel masks:

Channel	Frequency (MHz)	Bitmask
11	2405	0x00000800
12	2410	0x00001000
13	2415	0x00002000
14	2420	0x00004000
15	2425	0x00008000
16	2430	0x00010000
17	2435	0x00020000
18	2440	0x00040000
19	2445	0x00080000
20	2450	0x00100000
21	2455	0x00200000
22	2460	0x00400000
23	2465	0x00800000
24	2470	0x01000000
25	2475	0x02000000
26	2480	0x04000000