xref: /btstack/chipset/zephyr/nrf5340_dongle/README.md (revision 6897da5c53aac5b1f90f41b5b15d0bd43d61dfff)
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.6 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    - `child_image/hci_ipc.conf`
9    - `overlay-usb.conf`
10    - `usb.overlay`
11
12## Build/Flash HCI Bridge on AppCore
13
14You need to specify the board with the '-b' param in the west call.
15
16For nRF5340 DK:
17
18```sh
19cd  ${NCS_ROOT}/zephyr/samples/bluetooth/hci_uart/
20west build --pristine -b nrf5340dk_nrf5340_cpuapp -- -DDTC_OVERLAY_FILE=usb.overlay -DOVERLAY_CONFIG=overlay-usb.conf
21west flash
22```
23
24For nRF5340 Audio DK (ADK)
25
26```sh
27cd  ${NCS_ROOT}/zephyr/samples/bluetooth/hci_uart/
28west build --pristine -b nrf5340dk_nrf5340_cpuapp -- -DDTC_OVERLAY_FILE=usb.overlay -DOVERLAY_CONFIG=overlay-usb.conf
29west flash
30```
31
32## Usage / Find Serial Port
33
34On macOS, the nRF5340 ADK with the HCI bridge show up as 5 /dev/tty. To find the HCI one, list all /dev/tty.* devices,
35then press and hold the RESET button and list all devices again. The missing one is the one provided by the HCI bridge.
36
37On the nRF5340 DK, you can directly plug into the `nRF5340 USB` port and get only a single /dev/tty.
38
39## HCI log
40
41```sh
42btmon -J nrf5340_xxaa_app -w <logfile>
43```
44