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 ====================================================================== 44 >dut_mode_configure 1 45 BT DUT MODE CONFIGURE 46 HAL REQUEST SUCCESS 47 > 48 49 Disabling Test Mode 50 =================== 51 >dut_mode_configure 0 52 BT DUT MODE CONFIGURE 53 HAL REQUEST SUCCESS 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. 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 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> 88 89