1Intro
2#####
3
4This is the embedded side of the BLE conformance tests which are part of the
5EDTT (Embedded Device Test Tool).
6
7Much more info about the tool can be found in https://github.com/EDTTool/EDTT
8and in its `doc/` folder.
9
10In very short, there is 2 applications in this folder:
111.) A controller only build of the BLE stack, where the HCI, and a few extra
12    interfaces are exposed to the EDTT.
132.) An application which implements the test GATT services specified by BT SIG
14    in GATT_Test_Databases.xlsm, with an EDTT interface which allows the EDTT
15    tests to switch between theses.
16
17The first application is used for LL and HCI conformance tests of the
18controller.
19The second application for GATT tests.
20
21These 2 particular applications are meant to be used in a simulated environment,
22for regression, either as part of a CI system, or in workstation during
23development.
24This is due to this particular application only containing an EDTT transport
25driver for simulated targets, meant to connect to the `bsim` EDTT transport
26driver thru the EDTT bridge.
27
28How to use it
29#############
30
31Assuming you have already
32`installed BabbleSim <https://babblesim.github.io/fetching.html>`_.
33
34Add to your environment the variable EDTT_PATH pointing to the
35EDTT folder. You can do this by adding it to your `~/.bashrc`, `~/.zephyrrc`,
36or similar something like:
37```
38export EDTT_PATH=${ZEPHYR_BASE}/../tools/edtt/
39```
40(if you add it to your .bashrc you probably won't be able to refer to
41ZEPHYR_BASE)
42
43To run these sets of tests you need to compile both of these applications as any
44other Zephyr app, targeting the nrf52_bsim.
45To compile both in an automated way you can just use the `compile.sh` (see
46below).
47
48To run the tests you can either run one of the provided scripts, or run by
49hand the BabbleSim 2G4 Phy, EDTT bridge, EDTT and needed simulated devices.
50The shortest path is to use the provided scripts.
51
52In short the whole process being:
53```
54cd ${ZEPHYR_BASE} && source zephyr-env.sh
55#Compile all apps:
56WORK_DIR=${ZEPHYR_BASE}/bsim_out tests/bsim/bluetooth/ll/compile.sh
57
58#run all tests
59RESULTS_FILE=${ZEPHYR_BASE}/banana.xml SEARCH_PATH=tests/bsim/bluetooth/ll/edtt/ tests/bsim/run_parallel.sh
60
61#or just run one set:
62tests/bsim/bluetooth/ll/edtt/tests_scripts/hci.sh
63```
64