xref: /btstack/test/le_audio/README.md (revision 98bdbfb66b8861860930c2322560fd384dfd357b)
1*98bdbfb6SDirk HelbigThese samples are meant to be used with the [PTS Dongel](https://bluekitchen-gmbh.com/bluetooth-pts-with-nordic-nrf52840-usb-dongle/) or an equivalent setup like
2*98bdbfb6SDirk Helbigthe one described in here using a nrf5340dk.
3*98bdbfb6SDirk Helbig
4*98bdbfb6SDirk Helbig# nrf5340dk as HCI dongle
5*98bdbfb6SDirk Helbigfor this a working [Zephyr](https://www.zephyrproject.org/) build environment is required, where the setup of Zephyr is beyond the scope of this document.
6*98bdbfb6SDirk Helbig
7*98bdbfb6SDirk HelbigThe nrf5340 is a dual core SOC for which the network core handles the low level radio control and the application core handles the actual application.
8*98bdbfb6SDirk HelbigSo to make a working dongle the network core and the application core need to be programmed.
9*98bdbfb6SDirk Helbig
10*98bdbfb6SDirk Helbig### network core / Packetcraft LL
11*98bdbfb6SDirk Helbigfor nrf5340 the latest netcore firmware is located at [sdk-nrf](https://github.com/nrfconnect/sdk-nrf/tree/main/lib/bin/bt_ll_acs_nrf53/bin)
12*98bdbfb6SDirk Helbigto program it:
13*98bdbfb6SDirk Helbig```sh
14*98bdbfb6SDirk Helbignrfjprog --program ble5-ctr-rpmsg_<version number>.hex --chiperase --coprocessor CP_NETWORK -r
15*98bdbfb6SDirk Helbig```
16*98bdbfb6SDirk Helbig
17*98bdbfb6SDirk Helbig### application core
18*98bdbfb6SDirk Helbigthe `hci_uart` sample is used here over USB CDC
19*98bdbfb6SDirk Helbigbuild using:
20*98bdbfb6SDirk Helbig```sh
21*98bdbfb6SDirk Helbigwest build -b nrf5340dk_nrf5340_cpuapp -- -DDTC_OVERLAY_FILE=usb.overlay -DOVERLAY_CONFIG=overlay-usb.conf
22*98bdbfb6SDirk Helbig```
23*98bdbfb6SDirk Helbigwith `usb.overlay` specifying to use USB CDC instead of a physical UART
24*98bdbfb6SDirk Helbig```c
25*98bdbfb6SDirk Helbig/*
26*98bdbfb6SDirk Helbig * Copyright (c) 2021 Nordic Semiconductor ASA
27*98bdbfb6SDirk Helbig *
28*98bdbfb6SDirk Helbig * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
29*98bdbfb6SDirk Helbig */
30*98bdbfb6SDirk Helbig
31*98bdbfb6SDirk Helbig/ {
32*98bdbfb6SDirk Helbig	chosen {
33*98bdbfb6SDirk Helbig		zephyr,bt-c2h-uart = &cdc_acm_uart0;
34*98bdbfb6SDirk Helbig	};
35*98bdbfb6SDirk Helbig};
36*98bdbfb6SDirk Helbig
37*98bdbfb6SDirk Helbig&zephyr_udc0 {
38*98bdbfb6SDirk Helbig	cdc_acm_uart0: cdc_acm_uart0 {
39*98bdbfb6SDirk Helbig		compatible = "zephyr,cdc-acm-uart";
40*98bdbfb6SDirk Helbig	};
41*98bdbfb6SDirk Helbig};
42*98bdbfb6SDirk Helbig```
43*98bdbfb6SDirk Helbigand `overlay-usb.conf` to enable USB
44*98bdbfb6SDirk Helbig```make
45*98bdbfb6SDirk HelbigCONFIG_USB_DEVICE_STACK=y
46*98bdbfb6SDirk HelbigCONFIG_USB_DEVICE_PRODUCT="Zephyr HCI UART sample"
47*98bdbfb6SDirk HelbigCONFIG_USB_CDC_ACM=y
48*98bdbfb6SDirk HelbigCONFIG_USB_DEVICE_INITIALIZE_AT_BOOT=n
49*98bdbfb6SDirk Helbig```
50