VCP Graphical Central

A graphical central app for interacting with the VCP volume control service and its included services (AICS and VOCS).

Note: If you haven't started a Zephyr project yet, first refer to the Zephyr Getting Started Guide and install all dependencies. It is recommended to follow the path that involves using a virtual Python environment.

Hardware requirement

To run this app, an ‘nRF5340 Audio DK’ board and an ‘adafruit_2_8_tft_touch_v2’ LCD display module are needed.

For development

For developers of the application, first do a fork of the repo. Then do the following:

Make a local workspace folder (to hold the repo, zephyr and west modules):

mkdir my-workspace
cd my-workspace

Clone the repo:

git clone [email protected]:<your handle>/vcp-graphical-central.git

Initialize west and update dependencies:

west init -l vcp-graphical-central
west update

For normal use (non-development)

This repo contains a stand alone Zephyr application that can be fetched and initialized like this:

west init -m https://github.com/astraeuslabs/vcp-graphical-central --mr main my-workspace

Then use west to fetch dependencies:

cd my-workspace
west update

Update BT Target Device Number and Name(s)

Connecting to One Target Device

Modify CONFIG_BT_TARGET_DEVICE_NUMBER to 1 and set CONFIG_BT_TARGET_DEVICE_NAME to your dedicated Bluetooth target device name in the prj.config file:

CONFIG_BT_TARGET_DEVICE_NUMBER=1

CONFIG_BT_TARGET_DEVICE_NAME="My_BT_Device"
# Replace "My_BT_Device" with your BT target device name

Connecting to two target devices

Modify CONFIG_BT_TARGET_DEVICE_NUMBER to 2, and set CONFIG_BT_TARGET_RSHI_DEVICE_NAME and CONFIG_BT_TARGET_LSHI_DEVICE_NAME to your dedicated Bluetooth target right-side and left-side stereo device names, respectively, in the prj.config file:

CONFIG_BT_TARGET_DEVICE_NUMBER=2

CONFIG_BT_TARGET_RSHI_DEVICE_NAME="My_BT_Right_Side_Device"
CONFIG_BT_TARGET_LSHI_DEVICE_NAME="My_BT_Left_Side_Device"
# Replace "My_BT_Right_Side_Device" and "My_BT_Left_Side_Device" with your
# BT target right-side and left-side stereo device names, respectively

Build and flash

Go to the repo folder:

cd vcp-graphical-central

Build

nRF5340 Audio DK board

The nRF5340 Audio DK has two cores - one for the application and one dedicated for the network (bluetooth controller). The bluetooth controller can be builded from zephyr/samples/bluetooth/hci_ipc:

west build -b nrf5340_audio_dk_nrf5340_cpunet -d build/hci_ipc ../zephyr/samples/bluetooth/hci_ipc --pristine -- -DCONF_FILE=nrf5340_cpunet_iso-bt_ll_sw_split.conf

Application

west build -b nrf5340_audio_dk_nrf5340_cpuapp -d build/app app --pristine -- -DSHIELD=adafruit_2_8_tft_touch_v2

Flash

nRF5340 Audio DK board

Clear all mem for the two cores with the recover command:

nrfjprog --recover --coprocessor CP_NETWORK
nrfjprog --recover

And flash with the west command:

west flash -d build/hci_ipc

Application

west flash -d build/app