The Android Open Source Project | 5738f83 | 2012-12-12 16:00:35 -0800 | [diff] [blame] | 1 | Bluedroid Test Application |
| 2 | ========================== |
| 3 | The test application provides a small console shell interface that allows |
| 4 | access to the Bluetooth HAL API library though ASCII commands. This is similar |
| 5 | to how the real JNI service would operate. The primary objective of this |
| 6 | application is to allow Bluetooth to be put in DUT Mode for RF/BB BQB test purposes. |
| 7 | |
| 8 | This application is mutually exclusive with the Java based Bluetooth.apk. Hence |
| 9 | before launching the application, it should be ensured that the Settings->Bluetooth is OFF. |
| 10 | |
| 11 | This application is built as 'bdt' and shall be available in '/system/bin/bdt' |
| 12 | |
| 13 | Limitations |
| 14 | =========== |
| 15 | 1.) Settings->Bluetooth must be OFF for this application to work |
| 16 | 2.) Currently, only the SIG 'HCI Test Mode' commands are supported. The vendor |
| 17 | specific HCI test mode commands to be added. |
| 18 | |
| 19 | Usage instructions |
| 20 | ================== |
| 21 | The following section describes the various commands and their usage |
| 22 | |
| 23 | Launching the test application |
| 24 | ============================== |
| 25 | $ adb shell |
| 26 | root@android:/ # /system/bin/bdt |
| 27 | set_aid_and_cap : pid 1183, uid 0 gid 0 |
| 28 | ::::::::::::::::::::::::::::::::::::::::::::::::::: |
| 29 | :: Bluedroid test app starting |
| 30 | Loading HAL lib + extensions |
| 31 | HAL library loaded (Success) |
| 32 | INIT BT |
| 33 | HAL REQUEST SUCCESS |
| 34 | |
| 35 | Enabling Bluetooth |
| 36 | ================== |
| 37 | >enable |
| 38 | ENABLE BT |
| 39 | HAL REQUEST SUCCESS |
| 40 | >ADAPTER STATE UPDATED : ON |
| 41 | |
| 42 | Enabling Test Mode (Bluetooth must be enabled for this command to work) |
| 43 | ====================================================================== |
Ganesh Ganapathi Batta | ead3cde | 2013-02-05 15:22:31 -0800 | [diff] [blame] | 44 | >dut_mode_configure 1 |
| 45 | BT DUT MODE CONFIGURE |
The Android Open Source Project | 5738f83 | 2012-12-12 16:00:35 -0800 | [diff] [blame] | 46 | HAL REQUEST SUCCESS |
| 47 | > |
| 48 | |
| 49 | Disabling Test Mode |
| 50 | =================== |
Ganesh Ganapathi Batta | ead3cde | 2013-02-05 15:22:31 -0800 | [diff] [blame] | 51 | >dut_mode_configure 0 |
| 52 | BT DUT MODE CONFIGURE |
The Android Open Source Project | 5738f83 | 2012-12-12 16:00:35 -0800 | [diff] [blame] | 53 | HAL REQUEST SUCCESS |
Ganesh Ganapathi Batta | ead3cde | 2013-02-05 15:22:31 -0800 | [diff] [blame] | 54 | > |
| 55 | |
| 56 | Running BLE Test commands (Bluetooth must be enabled) |
| 57 | ===================================================== |
| 58 | NOTE: Unlike BR/EDR, there is no explicit DUT mode to run these BLE tests. |
| 59 | |
| 60 | > le_test_mode 1 <rx_freq> |
| 61 | |
| 62 | > le_test_mode 2 <tx_freq> <test_data_len> <payload_pattern> |
| 63 | |
| 64 | > le_test_mode 3 <no_args> |
| 65 | Please refer to the BT Core spec pages-1099 to 1102 for possible values for |
| 66 | the above parameters. These values need to be provided in Decimal format. |
The Android Open Source Project | 5738f83 | 2012-12-12 16:00:35 -0800 | [diff] [blame] | 67 | |
| 68 | Exit the test application |
| 69 | ========================= |
| 70 | >quit |
| 71 | shutdown bdroid test app |
| 72 | Unloading HAL lib |
| 73 | HAL library unloaded (Success) |
| 74 | :: Bluedroid test app terminating |
| 75 | |
| 76 | Help (Lists the available commands) |
| 77 | =================================== |
| 78 | >help |
| 79 | help lists all available console commands |
| 80 | |
| 81 | quit |
| 82 | enable :: enables bluetooth |
| 83 | disable :: disables bluetooth |
Ganesh Ganapathi Batta | ead3cde | 2013-02-05 15:22:31 -0800 | [diff] [blame] | 84 | dut_mode_configure :: DUT mode - 1 to enter,0 to exit |
| 85 | le_test_mode :: LE Test Mode - RxTest - 1 <rx_freq>, |
| 86 | TxTest - 2 <tx_freq> <test_data_len> <payload_pattern>, |
| 87 | End Test - 3 <no_args> |
The Android Open Source Project | 5738f83 | 2012-12-12 16:00:35 -0800 | [diff] [blame] | 88 | |