Skip to content

Commit 7a8cc02

Browse files
committed
Cordio Documentation: Explain how to tests and what tools are available.
1 parent f12afde commit 7a8cc02

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

features/FEATURE_BLE/targets/TARGET_CORDIO/doc/PortingGuide.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -489,6 +489,26 @@ ble::vendor::cordio::CordioHCIDriver& ble_cordio_get_hci_driver() {
489489
}
490490
```
491491

492+
### Tests
493+
494+
Greentea tests are bundled with the cordio port of BLE API to ensure that the transport driver works as expected as well as validate the cordio stack initialization. You can run them with the following command:
495+
496+
```
497+
mbed test -t <toolchain> -m <target> -n mbed-os-features-feature_ble-targets-target_cordio-tests-cordio_hci-driver,mbed-os-features-feature_ble-targets-target_cordio-tests-cordio_hci-transport
498+
```
499+
500+
* mbed-os-features-feature_ble-targets-target_cordio-tests-cordio_hci-transport: Ensure that the transport is able to send an HCI reset command and receive the corresponding HCI status event.
501+
* mbed-os-features-feature_ble-targets-target_cordio-tests-cordio_hci-driver: Runs the whole initialization process then ensure the cordio stack has been properly initialized by the HCI driver.
502+
503+
504+
### Tools
505+
506+
The application [mbed-os-cordio-hci-passthrough](https://github.com/ARMmbed/mbed-os-cordio-hci-passthrough) can be used to _proxify_ a Bluetooth controller connected to an mbed board.
507+
508+
Bytes sent by the host over the board serial are forwarded to the controller with the help of the `HCITransportDriver` while bytes sent by the controller are sent back to the host through the board serial.
509+
510+
This application can be used to validate the transport driver and debug the initialization process on a PC host.
511+
492512

493513

494514

0 commit comments

Comments
 (0)