README.txt
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