xref: /btstack/chipset/zephyr/nrf5340_dongle/README.md (revision 07cf6ebd8ea7f2d1f24b1f8da7bd8b9b8e0f5c8c)
1421ee5a8SDirk Helbig# nRF5340 (Audio) DK Board as USB HCI Dongle Guide
2421ee5a8SDirk Helbig
3*07cf6ebdSMatthias RingwaldThis will turn the Nordic nRF5340 DK and Audio DK boards into an USB CDC HCI dongle that uses Nordic's SoftDevice Controller.
4421ee5a8SDirk Helbig
5421ee5a8SDirk Helbig## Preconditions
6*07cf6ebdSMatthias Ringwald- [Install Nordic's nRF Connect SDK, v2.6 or higher](https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/nrf/installation.html)
7*07cf6ebdSMatthias Ringwald- Copy the included files and folders to '${ZEPHYR_ROOT}/zephyr/examples/bluetooth/hci_uart/'
8*07cf6ebdSMatthias Ringwald    - `child_image/hci_ipc.con`
9*07cf6ebdSMatthias Ringwald    - `overlay-usb.conf`
10*07cf6ebdSMatthias Ringwald    - `usb.overlay`
11421ee5a8SDirk Helbig
12421ee5a8SDirk Helbig## Build/Flash HCI Bridge on AppCore
13421ee5a8SDirk Helbig
14421ee5a8SDirk HelbigYou need to specify the board with the '-b' param in the west call.
15421ee5a8SDirk Helbig
16421ee5a8SDirk HelbigFor nRF5340 DK:
17421ee5a8SDirk Helbig
18421ee5a8SDirk Helbig```sh
19421ee5a8SDirk Helbigcd  ${ZEPHYR_ROOT}/zephyr/samples/bluetooth/hci_uart/
20421ee5a8SDirk Helbigwest build --pristine -b nrf5340dk_nrf5340_cpuapp -- -DDTC_OVERLAY_FILE=usb.overlay -DOVERLAY_CONFIG=overlay-usb.conf
21421ee5a8SDirk Helbigwest flash
22421ee5a8SDirk Helbig```
23421ee5a8SDirk Helbig
24421ee5a8SDirk HelbigFor nRF5340 Audio DK (ADK)
25421ee5a8SDirk Helbig
26421ee5a8SDirk Helbig```sh
27421ee5a8SDirk Helbigcd  ${ZEPHYR_ROOT}/zephyr/samples/bluetooth/hci_uart/
28421ee5a8SDirk Helbigwest build --pristine -b nrf5340_audio_dk_nrf5340_cpuapp -- -DDTC_OVERLAY_FILE=usb.overlay -DOVERLAY_CONFIG=overlay-usb.conf
29421ee5a8SDirk Helbigwest flash
30421ee5a8SDirk Helbig```
31421ee5a8SDirk Helbig
32421ee5a8SDirk Helbig## Usage / Find Serial Port
33421ee5a8SDirk Helbig
34*07cf6ebdSMatthias RingwaldOn macOS, the nRF5340 ADK with the HCI bridge show up as 5 /dev/tty. To find the HCI one, list all /dev/tty.* devices,
35421ee5a8SDirk Helbigthen press and hold the RESET button and list all devices again. The missing one is the one provided by the HCI bridge.
36421ee5a8SDirk Helbig
37*07cf6ebdSMatthias RingwaldOn the nRF5340 DK, you can directly plug into the `nRF5340 USB` port and get only a single /dev/tty.
38*07cf6ebdSMatthias Ringwald
39421ee5a8SDirk Helbig## HCI log
40421ee5a8SDirk Helbig
41421ee5a8SDirk Helbig```sh
42421ee5a8SDirk Helbigbtmon -J nrf5340_xxaa_app -w <logfile>
43421ee5a8SDirk Helbig```
44