xref: /btstack/chipset/zephyr/nrf5340_dongle/README.md (revision 4899c98fd91454e533b9dd11dbef73470fb42aea)
1421ee5a8SDirk Helbig# nRF5340 (Audio) DK Board as USB HCI Dongle Guide
2421ee5a8SDirk Helbig
307cf6ebdSMatthias 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*4899c98fSMatthias Ringwald- [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*4899c98fSMatthias Ringwald- Copy the included files and folders to '${NCS_ROOT}/zephyr/samples/bluetooth/hci_uart/'
8*4899c98fSMatthias Ringwald    - `child_image/hci_ipc.conf`
907cf6ebdSMatthias Ringwald    - `overlay-usb.conf`
1007cf6ebdSMatthias 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
19*4899c98fSMatthias Ringwaldcd  ${NCS_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
27*4899c98fSMatthias Ringwaldcd  ${NCS_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
3407cf6ebdSMatthias 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
3707cf6ebdSMatthias RingwaldOn the nRF5340 DK, you can directly plug into the `nRF5340 USB` port and get only a single /dev/tty.
3807cf6ebdSMatthias Ringwald
39421ee5a8SDirk Helbig## HCI log
40421ee5a8SDirk Helbig
41421ee5a8SDirk Helbig```sh
42421ee5a8SDirk Helbigbtmon -J nrf5340_xxaa_app -w <logfile>
43421ee5a8SDirk Helbig```
44