xref: /btstack/chipset/zephyr/nrf5340_dongle/README.md (revision ceed67ffe68ea5103bbc5647a2e000ed0e08b747)
1# nRF5340 (Audio) DK Board as USB HCI Dongle Guide
2
3This will turn the Nordic nRF5340 DK and Audio DK boards into an USB CDC HCI dongle that uses Nordic's SoftDevice Controller.
4
5## Preconditions
6- [Install Nordic's nRF Connect SDK, v2.8 or higher](https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/nrf/installation.html) into ${NCS_ROOT}
7- Copy the included files and folders to '${NCS_ROOT}/zephyr/samples/bluetooth/hci_uart/'
8    - `sysbuild`
9    - `Kconfig.sysbuild`
10    - `overlay-usb.conf`
11    - `usb.overlay`
12
13## Build/Flash HCI Bridge on AppCore
14
15You need to specify the board with the '-b' param in the west call.
16
17For nRF5340 DK:
18
19```sh
20cd  ${NCS_ROOT}/zephyr/samples/bluetooth/hci_uart/
21west build --pristine -b nrf5340dk/nrf5340/cpuapp -- -DDTC_OVERLAY_FILE=usb.overlay -DOVERLAY_CONFIG=overlay-usb.conf
22west flash
23```
24
25For nRF5340 Audio DK (ADK)
26
27```sh
28cd  ${NCS_ROOT}/zephyr/samples/bluetooth/hci_uart/
29west build --pristine -b nrf5340dk/nrf5340/cpuapp -- -DDTC_OVERLAY_FILE=usb.overlay -DOVERLAY_CONFIG=overlay-usb.conf
30west flash
31```
32
33## Usage / Find Serial Port
34
35On macOS, the nRF5340 ADK with the HCI bridge show up as 5 /dev/tty. To find the HCI one, list all /dev/tty.* devices,
36then press and hold the RESET button and list all devices again. The missing one is the one provided by the HCI bridge.
37
38On the nRF5340 DK, you can directly plug into the `nRF5340 USB` port and get only a single /dev/tty.
39
40## HCI log
41
42```sh
43btmon -J nrf5340_xxaa_app -w <logfile>
44```
45