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