BT RF Test Commands for Linux
:::info 文档信息
页数：11 · 语言：英文
原始文档：BT RF Test Commands for Linux-v05.pdf
:::
在线预览
若预览无法显示，请直接下载 PDF 后用本地阅读器打开。
BT RF Test Commands for
Linux
Revision History
| Date | Version | Description | Author |
|---|
| 2013/01/22 | 0.1 | Initial revision | Terence Hsieh |
| 2013/01/22 | 0.2 | Fix BT Test Mode command | Terence Hsieh |
| 2013/04/02 | 0.3 | Update driver to fix bcm20710a1 initial issue | Terence Hsieh |
| 2013/05/31 | 0.4 | Add BLE command | Jay Wu |
| 2013/06/14 | 0.5 | Add BT Rx Test command _ | Terence Hsieh |
1. Prerequisites:
- hciconfig, hcitool (Compiled out from BlueZ) 2) brcm_patchram_plus2 (Provided by Ampak) 3) bcmdhd.hcd (Provided by Ampak)
2. Enable BT Tx/Rx function
- echo 0 > /sys/class/rfkill/rfkill0/state // Bluetooth power OFF (depend on platform) 2) echo 1 > /sys/class/rfkill/rfkill0/state // Bluetooth power ON (depend on platform)
| 3) brcm patchram plus2 --enable hci --no2bytes --tosleep 200000 --baudrate 115200 --patchra _ _ _ /system/etc/firmware/bcmdhd.hcd /dev/ttyS0 // download BT firmware (depend on platform) 4) hciconfig hci0 up . BT Test Mode Command (Enable Device Under Test Mode): _ _ _ _ 1) hcitool cmd 0x03 0x0003 2) hcitool cmd 0x03 0x1a 0x03 3) hcitool cmd 0x03 0x05 0x02 0x00 0x02 4) hcitool cmd 0x06 0x03 . BT Continuous Tx command (Tx Test) _ 1) hcitool cmd 0x03 0x0003 2) hcitool cmd 0x3f 0x0051 55 44 3 22 11 00 00 00 04 01 04 10 27 09 00 00 ( A B C D E F G H I J ) C: Local Device BD ADDR Hex value _ _ _ 00:11:22:33:44:55 55 44 33 22 11 00 D: Hopping Mode Hex value _ 79 Channel 00 Single Frequency 01 Fixed pattern 02 E: Frequency Hex value 0 - 78 (2402 - 2480) 00 - 4E F: Modulation Type Hex value _ 00000000 bit pattern 01 11111111 bit pattern 02 01010101 bit pattern 03 11110000 bit pattern 09 PRBS9 pattern 04 | | | |
|---|
| F: Modulation Type _ | | Hex value |
| 00000000 bit pattern | | 01 | |
| 11111111 bit pattern | | 02 | |
| 01010101 bit pattern | | 03 | |
| 11110000 bit pattern | | 09 | |
| PRBS9 pattern | | 04 | |
| C: Local Device BD ADDR _ _ _ | | Hex value |
|---|
| 00:11:22:33:44:55 | | 55 44 33 22 11 00 | |
| D: Hopping Mode _ | | Hex value |
|---|
| 79 Channel | | 00 | |
| Single Frequency | | 01 | |
| Fixed pattern | | 02 | |
| E: Frequency | | Hex value |
|---|
| 0 - 78 (2402 - 2480) | | 00 - 4E | |
| G: Logical Channel _ | | Hex value |
|---|
| ACL EDR | | 00 | |
| ACL Basic | | 01 | |
| eSCO EDR | | 02 | |
| eSCO Basic | | 03 | |
SCO Basic
| H: BB Packet Type _ _ | | Hex value |
|---|
| NULL | | 00 | |
| POLL | | 01 | |
| FHS | | 02 | |
| DM1 | | 03 | |
| DH1/2-DH1 | | 04 | |
| HV1 | | 05 | |
| HV2/2-EV2 | | 06 | |
| HV3/EV3/3-EV3 | | 07 | |
| DV/3-DH1 | | 08 | |
| AUX1/PS | | 09 | |
| DM3/2-DH3 | | 0A | |
| DH3/3-DH3 | | 0B | |
| EV4/2-EV5 | | 0C | |
| EV5/3-EV5 | | 0D | |
| DM5/2-DH5 | | 0E | |
| DH5/3-DH5 | | 0F | |
| I: BB Packet Length _ _ | | Hex value |
|---|
| (The length of the payload in the Tx packets) | | |
| 10000 | | 10 27 (0x2710) | |
| 20000 | | 20 4E (0x4E20) | |
| 65535 | | FF FF (0xFFFF) | |
- Packet Type :DH1, MAC:112233445566, Hopping ON,PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 01 04 10 27 09 00 00 2) Packet Type :2-DH1, MAC:112233445566, Hopping ON,PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 00 04 10 27 09 00 00 3) Packet Type :3-DH1, MAC:112233445566, Hopping ON,PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 00 08 10 27 09 00 00 4) Packet Type :DH3, MAC:112233445566, Hopping ON, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 01 0B 10 27 09 00 00 5) Packet Type :2-DH3, MAC:112233445566, Hopping ON, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 00 0A 10 27 09 00 00 6) Packet Type :3-DH3, MAC:112233445566, Hopping ON, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 00 0B 10 27 09 00 00 7) Packet Type :DH5, MAC:112233445566, Hopping ON, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 01 0F 10 27 09 00 00 8) Packet Type :2-DH5, MAC:112233445566, Hopping ON, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 00 0E 10 27 09 00 00 9) Packet Type :3-DH5, MAC:112233445566, Hopping ON, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 00 00 04 00 0F 10 27 09 00 00 10) Packet Type :DH1, MAC:112233445566,CH0,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 01 04 10 27 09 00 00 11) Packet Type :2-DH1, MAC:112233445566,CH0,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 00 04 10 27 09 00 00 12) Packet Type :3-DH1, MAC:112233445566,CH0,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 00 08 10 27 09 00 00 13) Packet Type :DH3, MAC:112233445566,CH0,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 01 0B 10 27 09 00 00 14) Packet Type :2-DH3, MAC:112233445566,CH0,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 00 0A 10 27 09 00 00 15) Packet Type :3-DH3, MAC:112233445566,CH0,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 00 0B 10 27 09 00 00 16) Packet Type :DH5, MAC:112233445566,CH0,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 01 0F 10 27 09 00 00 17) Packet Type :2-DH5, MAC:112233445566,CH0,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 00 0E 10 27 09 00 00 18) Packet Type :3-DH5, MAC:112233445566,CH0,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 00 04 00 0F 10 27 09 00 00 19) Packet Type :DH1, MAC:112233445566,CH39,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 01 04 10 27 09 00 00 20) Packet Type :2-DH1, MAC:112233445566,CH39,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 00 04 10 27 09 00 00 21) Packet Type :3-DH1, MAC:112233445566,CH39,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 00 08 10 27 09 00 00 22) Packet Type :DH3, MAC:112233445566,CH39,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 01 0B 10 27 09 00 00 23) Packet Type :2-DH3, MAC:112233445566,CH39,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 00 0A 10 27 09 00 00 24) Packet Type :3-DH3, MAC:112233445566,CH39,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 00 0B 10 27 09 00 00 25) Packet Type :DH5, MAC:112233445566,CH39,Hopping OFF, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 01 0F 10 27 09 00 00 26) Packet Type :2-DH5, MAC:112233445566,CH39, PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 00 0E 10 27 09 00 00 27) Packet Type :3-DH5, MAC:112233445566,CH39,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 27 04 00 0F 10 27 09 00 00 28) Packet Type :DH1, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 01 04 10 27 09 00 00 29) Packet Type :2-DH1, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 00 04 10 27 09 00 00 30) Packet Type :3-DH1, MAC:112233445566,CH78 , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 00 08 10 27 09 00 00 31) Packet Type :DH3, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 01 0B 10 27 09 00 00 32) Packet Type :2-DH3, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 00 0A 10 27 09 00 00 33) Packet Type :3-DH3, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 00 0B 10 27 09 00 00 34) Packet Type :DH5, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 01 0F 10 27 09 00 00 35) Packet Type :2-DH5, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 00 0E 10 27 09 00 00 36) Packet Type :3-DH5, MAC:112233445566,CH78,Hopping OFF , PRBS9 mode, Packet length: 10000 = 0x2710,Power : Max hcitool cmd 0x3f 0x0051 66 55 44 33 22 11 01 4E 04 00 0F 10 27 09 00 00
2-3. BT Continuous Tx command (Set_Tx_Carrier_Frequency_2045):
- hcitool cmd 0x03 0x0003 2) hcitool cmd 0x3f 0x0014 00 0200 00 09 00 00 ( A B C D E F G H I )
| D: Carrier Frequency Encoded (Frequency) _ _ | | Hex value |
|---|
| 0 - 78 (2402 - 2480) | | 02 - 50 | |
| E: Mode | | Hex value |
|---|
| Unmodulated | | 00 | |
| PRBS9 | | 01 | |
| PRBS15 | | 02 | |
| All Zeroes | | 03 | |
| All Ones | | 04 | |
| Incrementing Symbols | | 05 | |
| F: Modulation Type _ | | Hex value |
|---|
| GFSK | | 00 | |
| QPSK | | 01 | |
| 8PSK | | 02 | |
- channel 0, PRBS9 mode, GFSK modulation hcitool cmd 0x3f 0x0014 00 0201 00 09 00 00 2) channel 0, PRBS9 mode, QPSK modulation hcitool cmd 0x3f 0x0014 00 0201 01 09 00 00 3) channel 0, PRBS9 mode, 8PSK modulation hcitool cmd 0x3f 0x0014 00 0201 02 09 00 00 4) channel 39, PRBS9 mode, GFSK modulation hcitool cmd 0x3f 0x0014 00 2901 00 09 00 00 5) channel 39, PRBS9 mode, QPSK modulation hcitool cmd 0x3f 0x0014 00 2901 01 09 00 00 6) channel 39, PRBS9 mode, 8PSK modulation hcitool cmd 0x3f 0x0014 00 2901 02 09 00 00 7) channel 78, PRBS9 mode, GFSK modulation hcitool cmd 0x3f 0x0014 00 5001 00 09 00 00 8) channel 78, PRBS9 mode, QPSK modulation hcitool cmd 0x3f 0x0014 00 5001 01 09 00 00 9) channel 78, PRBS9 mode, 8PSK modulation hcitool cmd 0x3f 0x0014 00 5001 02 09 00 00 10) channel 0, Unmodulated hcitool cmd 0x3f 0x0014 00 0200 00 09 00 00 11) channel 39, Unmodulated hcitool cmd 0x3f 0x0014 00 2900 00 09 00 00 12) channel 78, Unmodulated hcitool cmd 0x3f 0x0014 00 5000 00 09 00 00
2-4. BT Rx Command (Rx_Test):
- Select “Continuous Tx” from your equipment and start to transmit 2) hcitool cmd 0x03 0x0003 3) hcitool cmd 0x3f 0x0052 EE FF C0 88 00 00 E8 03260400 04 FF FF ( A B C D E F G H I ) 4) hcidump -x 5) You can find the HCI event from hcidump every “Report_Period” millisecond and the event format as below:
| 1’st event: > HCI Event: Vendor (0xff) plen 33 07 96 00 00 00 46 00 00 00 55 B6 00 00 F8 B5 00 00 00 00 00 00 30 C6 38 01 D7 BF 38 01 59 06 00 00 X1 Y1 2’nd event: > HCI Event: Vendor (0xff) plen 33 07 98 00 00 00 46 00 00 00 64 BC 00 00 07 BC 00 00 00 00 00 00 C0 E8 3D 01 67 E2 3D 01 59 06 00 00 X2 Y2 6) Calculate the BER BER = ( (X2-X1) - (Y2-Y1) ) / (X2 - X1) = (20834496-20497968)–(20832871-20496343)/(20834496-20497968) = (336528-336528)/336528 = 0 7) The BER of BDR(1M) should be less than 0.001 and 0.0001 for EDR 8) If you want to stop testing, you should have to stop “Continuous Tx” from your equipment at or Rx Test will be in wrong state at next time. _ C: Local Device BD ADDR Hex value _ _ _ 00:00:88:C0:FF:EE EE FF C0 88 00 00 D: Report Period Hex value _ 250 FA 00 (0x00FA) 1000 E8 03 (0x03E8) 2000 D0 07 (0x07D0) E: Frequency Hex value 0 - 78 (2402 - 2480) 00 - 4E F: Modulation Type Hex value _ 00000000 bit pattern 01 11111111 bit pattern 02 01010101 bit pattern 03 11110000 bit pattern 09 PRBS9 pattern 04 | | | |
|---|
| F: Modulation Type _ | | Hex value |
| 00000000 bit pattern | | 01 | |
| 11111111 bit pattern | | 02 | |
| 01010101 bit pattern | | 03 | |
| 11110000 bit pattern | | 09 | |
| PRBS9 pattern | | 04 | |
| C: Local Device BD ADDR _ _ _ | | Hex value |
|---|
| 00:00:88:C0:FF:EE | | EE FF C0 88 00 00 | |
| D: Report Period _ | | Hex value |
|---|
| 250 | | FA 00 (0x00FA) | |
| 1000 | | E8 03 (0x03E8) | |
| 2000 | | D0 07 (0x07D0) | |
| E: Frequency | | Hex value |
|---|
| 0 - 78 (2402 - 2480) | | 00 - 4E | |
| G: Logical Channel _ | | Hex value |
|---|
| ACL EDR | | 00 | |
| ACL Basic | | 01 | |
| eSCO EDR | | 02 | |
| eSCO Basic | | 03 | |
| SCO Basic | | 04 | |
| H: BB Packet Type _ _ | | Hex value |
|---|
| NULL | | 00 | |
| POLL | | 01 | |
| FHS | | 02 | |
| DM1 | | 03 | |
| DH1/2-DH1 | | 04 | |
| HV1 | | 05 | |
| HV2/2-EV2 | | 06 | |
| HV3/EV3/3-EV3 | | 07 | |
| DV/3-DH1 | | 08 | |
| AUX1/PS | | 09 | |
| DM3/2-DH3 | | 0A | |
| DH3/3-DH3 | | 0B | |
| EV4/2-EV5 | | 0C | |
| EV5/3-EV5 | | 0D | |
| DM5/2-DH5 | | 0E | |
| DH5/3-DH5 | | 0F | |
| I: BB Packet Length _ _ | | Hex value |
|---|
| (The length of the payload in the Tx packets) | | |
| 10000 | | 10 27 (0x2710) | |
| 20000 | | 20 4E (0x4E20) | |
| 65535 | | FF FF (0xFFFF) | |
2-5. BT Rx Command (Write_Receive_Only):
- hcitool cmd 0x03 0x0003 2) hcitool cmd 0x3f 0x002b 00 ( A B C )
| C: Receive Frequency Encoded (Frequency) _ _ | | Hex value |
|---|
| 0 - 78 (2402 - 2480) | | 02 - 50 | |
- Channel 0 hcitool cmd 0x3f 0x002b 02 2) Channel 39 hcitool cmd 0x3f 0x002b 29 3) Channel 78 hcitool cmd 0x3f 0x002b 50
2-6. BLE Tx Command (LE_Transmitter_Test):
- hcitool cmd 0x03 0x0003 2) hcitool cmd 0x08 0x001e 00 25 00 ( A B C D E )
| C: Tx channel _ | | Hex value |
|---|
| 0 - 39 (2402 - 2480) | | 00 - 27 | |
| D: Length of Test Data _ _ _ | | Hex value |
|---|
| 0 - 37 | | 00 - 25 | |
| E: Packet payload _ | | Hex value |
|---|
| Pseudo-Random bit sequence 9 | | 00 | |
| Pattern of alternating bit ‘11110000’ | | 01 | |
| Pattern of alternating bit ‘10101010’ | | 02 | |
| Pseudo-Random bit sequence 15 – Optional | | 03 | |
| Pattern of All ‘1’ bits – Optional | | 04 | |
| Pattern of All ‘0’ bits – Optional | | 06 | |
| Pattern of alternating bits ‘00001111’ | | 07 | |
| Pattern of alternating bits ‘01010101’ | | 08 | |
5-1) channel 10, data length 37, payload type Pseudo-Random bit sequence 9 hcitool cmd 0x08 0x001e 0A 25 00 5-2) channel 25, data length 37, packet payload type Pattern of All ‘1’ bits hcitool cmd 0x08 0x001e 19 25 04
2-7. BLE Rx Command (LE_ Receiver _Test):
- hcitool cmd 0x03 0x0003 2) hcitool cmd 0x08 0x001d 01 ( A B C ) 3) Transmit 1000 packets from equipment 4) hcitool cmd 0x08 0x001f > HCI Event 0x0e plen 6 01 1F 20 00 C0 03 5) Calculate PER (1000 - 960) / 1000 = 40/1000 = 4% where 0x03C0 is 960 in decimal.
| C: Tx channel _ | | Hex value |
|---|
| 0 - 39 (2402 - 2480) | | 00 - 27 | |
- Channel 1 hcitool cmd 0x08 0x001d 01 2) Channel 39 hcitool cmd 0x08 0x001d 27