test/README.md

   1 # Fluoride Bluetooth Tests
   2
   3 This document refers to the tests in the system/bt/test directory.
   4
   5 The tests are designed to be run when the Android runtime is not running.  From a terminal, run:
   6
   7 ## Before you run tests
   8 ```sh
   9 adb shell stop
  10 ```
  11
  12 ## After you're done
  13 ```sh
  14 adb shell start
  15 ```
  16
  17 ## Running tests
  18 Then see what options the test script provides:
  19
  20 ```sh
  21 ./run_unit_tests.sh --help
  22 ```
  23
  24 But for the impatient, run specific groups of tests like this:
  25
  26 ```sh
  27 ./run_unit_tests.sh net_test_bluetooth
  28 ```
  29
  30 a single test:
  31
  32 ```sh
  33 ./run_unit_tests.sh net_test_bluetooth.BluetoothTest.AdapterRepeatedEnableDisable
  34 ```
  35
  36 ## Sample Output
  37
  38 system/bt/test$ ./run_unit_tests.sh net_test_bluetooth
  39 --- net_test_bluetooth ---
  40 pushing...
  41 /tbd/aosp-master/out/target/product/bullhead/data/nativetest/n...st_bluetooth: 1 file pushed. 9.2 MB/s (211832 bytes in 0.022s)
  42 running...
  43
  44 Running main() from gtest_main.cc
  45 [==========] Running 11 tests from 2 test cases.
  46 [----------] Global test environment set-up.
  47 [----------] 6 tests from BluetoothTest
  48 [ RUN      ] BluetoothTest.AdapterEnableDisable
  49 [       OK ] BluetoothTest.AdapterEnableDisable (2538 ms)
  50 [ RUN      ] BluetoothTest.AdapterRepeatedEnableDisable
  51 [       OK ] BluetoothTest.AdapterRepeatedEnableDisable (11384 ms)
  52 [ RUN      ] BluetoothTest.AdapterSetGetName
  53 [       OK ] BluetoothTest.AdapterSetGetName (2378 ms)
  54 [ RUN      ] BluetoothTest.AdapterStartDiscovery
  55 [       OK ] BluetoothTest.AdapterStartDiscovery (2397 ms)
  56 [ RUN      ] BluetoothTest.AdapterCancelDiscovery
  57 [       OK ] BluetoothTest.AdapterCancelDiscovery (2401 ms)
  58 [ RUN      ] BluetoothTest.AdapterDisableDuringBonding
  59 [       OK ] BluetoothTest.AdapterDisableDuringBonding (11689 ms)
  60 [----------] 6 tests from BluetoothTest (32789 ms total)
  61
  62 [----------] 5 tests from GattTest
  63 [ RUN      ] GattTest.GattClientRegister
  64 [       OK ] GattTest.GattClientRegister (2370 ms)
  65 [ RUN      ] GattTest.GattClientScanRemoteDevice
  66 [       OK ] GattTest.GattClientScanRemoteDevice (2273 ms)
  67 [ RUN      ] GattTest.GattClientAdvertise
  68 [       OK ] GattTest.GattClientAdvertise (2236 ms)
  69 [ RUN      ] GattTest.GattServerRegister
  70 [       OK ] GattTest.GattServerRegister (2391 ms)
  71 [ RUN      ] GattTest.GattServerBuild
  72 [       OK ] GattTest.GattServerBuild (2435 ms)
  73 [----------] 5 tests from GattTest (11706 ms total)
  74
  75 [----------] Global test environment tear-down
  76 [==========] 11 tests from 2 test cases ran. (44495 ms total)
  77 [  PASSED  ] 11 tests.
  78
  79 ## Troubleshooting: Your phone is bricked!
  80 Probably not.  See [After you're done](#After-you're-done)
  81