CI230X RF Test Instructions and Methods¶
Test Environment Setup¶
◆ Device Under Test (DUT): Module or development board based on CI230X main chip
◆ Test Control: PC sends ATE test commands via UART to configure test modes
◆ Test Equipment: IQ analyzer, Test Convergence Meter, CMW500, or equivalent RF test equipment
Test Preparation¶
Before beginning testing, please review the CI-E05GT02S_MB Evaluation Kit Documentation. All RF testing is performed using the CI-E05GT02S_MB development board platform.
Hardware Requirements¶
◆ CI-E05GT02S_MB evaluation kit (1 unit)
◆ CI-E0XGT02S module (1 unit)
◆ USB Type-C data cable (1 unit)
◆ USB-to-UART programming tools
◆ DuPont jumper wires (multiple)
Software Requirements¶
◆ Flashing test firmware: basic RF test flashing 《CI230X Fixed Frequency Test Firmware》.
◆ USB-to-UART driver Installation: ensure that the USB-to-UART driver has been correctly installed. If the UART cannot be identified, it is recommended to install the appropriate driver manually based on the chip model used in the USB-to-TTL Tool.
Description of Conduction Test Hardware¶
◆ Cut the wire to disconnect the antenna from the matching circuit. After connecting the cable to the matching circuit, ensure that the cable is well grounded.
◆ If the conduction test is based on CI-E05GT02S_MB evaluation kit and the USB-to-UART circuit has been loaded on the board, short circuit the jumper caps at PE2 and PE3, switch the UART to “Wi-Fi”, and connect the development board to the computer through the USB Type-C data cable.
◆ If conducting test is conducted separately based on CI-E0XGT02S module, connect USB-to-UART tool to PE2 and PE3 pins of the module, and connect 3.3V power supply and GND to the module.
◆ It is recommended to open the UART tool with SSCOM. Set the baud rate to 115200, select the corresponding COM port, and then configure the test command according to the subsequent commands in this article to test each mode.
CI230X AT Command Set for Production Testing¶
Command Format¶
Commands and parameters are separated by spaces or”,”. Each command ends with \r n.
Mandatory parameters are identified with<>, and optional parameters are identified with [], such as:
Command A
Wi-Fi RF TX/RX Control Commands¶
Example：
AT+PVTCMD=EVM,TX,N,7,1,1000\r\n
or
AT+PVTCMD=EVM TX N 7 1 1000\r\n
Wi-Fi RF TX/RX control command¶
Command function¶
By sending such commands, RF transmission and reception control are carried out.
Change the channel command¶
Command：AT+PVTCMD=set_rf_channel <Chan>\r\n
note：
Chan is a required parameter. The value range is1~14 .
Return success：+set_rf_channel OK ch:6
Return failure：+set_rf_channel FAIL
Set TX related parameters¶
Command：AT+PVTCMD=EVM,TX,Mode,Rate,Channel,PackageLength\r\n
◆ Mode: BL/BS/G/N
◆ Rate：
11B 1,2,5.5,11
11G 6,9,12,18,24,36,48,54
11N 0,1,2,3,4,5,6,7
◆ Channel:1~14
◆ PackageLength:1000,1024
Return success：+evm OK
Return failure：+evm FAIL
Example：
11B 1M CH1: AT+PVTCMD=EVM,TX,B,1,1,1000\r\n
Set RX (continuous mode) related parameters¶
Command：AT+PVTCMD=EVM,RX,Channel\r\n
Return success：+evm OK
Return failure：+evm FAIL
Single RX test¶
◆ Step1：start-up RX test
Command：AT+PVTCMD=EVM,RXS,1,CH\r\n
Return success：+evm OK
Return failure：+evm FAIL
◆ Step2: Stop test
Command：AT+PVTCMD=EVM,RXS,0,CH\r\n
Return success：+evm OK
Return failure：+evm FAIL
◆ Step3：Read data
Command：AT+PVTCMD=EVM,RXS,INFO\r\n
Return success：+evm OK and display the number of packages received and PER
Return failure：+evm FAIL
Set EVM TX transmission interval¶
Command：AT+PVTCMD=evm_tx_interval <interval>\r\n
Parameter: interval value of 100 is used for evm tx test when the duty cycle is close to full packet (>% 95) to analyze the emission current; The interval value of 10000 (program default) is the normal EVM index test.
Note: Restore the default value of 10,000 after each startup.
AT+PVTCMD=evm_tx_interval <interval\> must be used first to set the tx transmission interval, and then uses the EVM command to test.
Bluetooth RF TX/RX Control Command¶
Receive Test Instructions¶
–CMD(H_CMD_LE_RX_TEST),The last byte of the instruction represents Rx Frequency = 0x00 ,Examples are as follows
<UART>TX:[01 1D 20 01 00]
Note: The first four bytes are fixed, and the last byte represents the test frequency point（0x00~0x27）.
The corresponding relationship is as follows:
0x00=ch37, 0x01=ch0, 0x02=ch1.....
Receive the response of the test command. Note: pay attention to the last byte of the response, and the correct return must be 0.
<UART>RX:[04:0E:04:05:1D:20:00]
Parameter interpretation:
CMD_COMPLETE_EVT(H_CMD_LE_RX_TEST) :
Length = 0x04
Nb Hci Command Packets = 0x05
Command Opcode = 0x201D (cmd_le_rx_test)
Status = 0x00 (success)
Send Test Instructions¶
–CMD(H_CMD_LE_TX_TEST)：It includes the following three parameters
Tx Frequency = 0x00 （0x00~0x27）（Here, the channel needs to be converted to hexadecimal, that is, 00 corresponds to CH0, 13 corresponds to CH19, and 27 corresponds to CH39）
Data Length = 0x25
Packet Payload = 0x00 (0:PRBS9)(0x01:11110000 Packet )(0x02:10101010 Packet Payload)
Examples are as follows
<UART>TX:[01 1E 20 03 00 25 00]
Note: The first four bytes are fixed, and the last three bytes represent the test frequency, packet length, and packet content
Send the response to the test command. Note: Pay attention to the last byte of the response, and the correct return must be 0.
<UART>RX:[04:0E:04:05:1E:20:00]
CMD_COMPLETE_EVT(H_CMD_LE_TX_TEST)：
Parameter explanation:
Length = 0x04
Nb Hci Command Packets = 0x05
Command Opcode = 0x201E (cmd_le_tx_test)
Status = 0x00 (success)
Test End Instruction¶
–CMD(H_CMD_LE_TEST_END) Note: Fixed command, no parameter
<UART>TX:[01 1F 20 00]
Response to test end command
<UART>RX:[04:0E:06:05:1F:20:00:00:00]
Parameter explanation:
CMD_COMPLETE_EVT(H_CMD_LE_TEST_END)
Length = 0x06
Nb Hci Command Packets = 0x05
Command Opcode = 0x201F (cmd_le_test_end)
Status = 0x00 (success)
Nb Packets = 0x0000 (d0)
Note: If TX_TEST_CMD was sent, the last two bytes of the response content are all 0; If RX_TEST_CMD was sent, the last two bytes of the response content represent the number of packets actually received.
Enhanced Receive Test Instruction¶
–CMD(H_CMD_LE_ENH_RX_TEST) ：includes the following three parameters
Rx Channel = 0x00 （0x00~0x27）
Phy = 0x01 (0x01：1 Mbps PHY)【0x02：2M、0x03：coded】
Modulation mode Modulation Index = 0x00 (0：Standard Modulation, 1：Stable Modulation)
Examples are as follows:
<UART>TX:[01 33 20 03 00 01 00]
Enhanced response to receive test instructions
<UART>RX:[04:0E:04:05:33:20:00]
CMD_COMPLETE_EVT(H_CMD_LE_ENH_RX_TEST) :
Length = 0x04
Nb Hci Command Packets = 0x05
Command Opcode = 0x2033 (cmd_le_enh_rx_test)
Status = 0x00 (success)
Enhanced Send Test Instruction¶
–CMD(H_CMD_LE_ENH_TX_TEST) ：include the following 4 parameters
Tx Channel = 0x00
Length = 0xFB
Payload = 0x00 (0x00:PRBS9)(0x01:11110000 Packet )(0x02:10101010 Packet Payload)
Phy = 0x01 (0x01:1Mbps PHY)【0x02：2M、0x03：coded】
Examples are as follows:
<UART>TX:[01 34 20 04 00 FB 00 01]
Enhanced test command sending response
<UART>RX:[04:0E:04:05:34:20:00]
CMD_COMPLETE_EVT(H_CMD_LE_ENH_TX_TEST)：
Length = 0x04
Nb Hci Command Packets = 0x05
Command Opcode = 0x2034 (cmd_le_enh_tx_test)
Status = 0x00 (success)
System Reset Command¶
<UART>TX:[01 03 0C 00]
Test Command Sequence¶
First send the reset command, then send the test command
When the sending/receiving test ends, you need to send the test end command
Namely:
Reset command -> Send/receive test commands -> Test end command
Common Commands¶
| Command | Effect |
|---|---|
| BLE_Receive | 01 1D 20 01 00 |
| BLE_Send | 01 1E 20 03 00 25 00 |
| BLE_End test | 01 1F 20 00 |
| BLE_Prepare to enter the sideband test | 01 1E 20 03 40 00 00 |
| BLE_Exit sideband test | 01 1E 20 03 50 00 00 |
Crystal Compensation Capacitor¶
Command Function¶
Offset value setting of crystal compensation capacitance of module production line, including positive and negative values. The offset value ranges from -20 to +20.
After the command parameters are set, the module frequency offset compensation will take effect immediately, but will not be saved to flash. The frequency offset change can be observed on the test instrument.
Command Demonstration¶
AT+PVTCMD=XTAL_CAP,3\r\n
AT+PVTCMD=XTAL_CAP,-5\r\n
Return success：+xtal_cap OK offset:3
Return failure：+xtal_cap FAIL
note：+1 = -1ppm
The setting here is crystal offset, not difference
Wi-Fi Transmit Power Compensation¶
Command Function¶
The module production line RF transmission power fine-tuning offset value setting has positive and negative values. The offset value ranges from -24 to +24.
After the command parameters are set, the TX power compensation of the module takes effect immediately, but is not saved to flash. The power change can be observed on the test instrument.
Command Demonstration¶
AT+PVTCMD=TX_POWER,7\r\n
AT+PVTCMD=TX_POWER,-4\r\n
Return success：+tx_power OK offset:7
Return failure：+tx_power FAIL
note：+4=0.5db
The setting here is crystal offset, not difference
Wi-Fi Production Line Test Results¶
Command Function¶
After the module production line test is completed, write the test results to the module, 1=success, 0=failure. The module calls relevant interfaces to write the test results (all test success/failure, crystal compensation, transmission power) to flash
Note: This command is the last command of the production line test. The return of the command “OK r n” indicates that the results have been written to flash. After receiving this command, the instrument should power down the module to enter the next station to ensure successful flash writing
Command Demonstration¶
AT+ATE_OK=1\r\n
AT+ATE_OK=0\r\n
Return success：OK\r\n