Skip to content
Merged

2.3.0 #367

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
100 commits
Select commit Hold shift + click to select a range
984a2d8
Bump version to 2.2.9
TobiasRoeddiger Sep 21, 2026
047b1f2
Improve high-rate PPG acquisition
Sep 7, 2026
3c1d85a
fix(ppg): preserve partial samples across FIFO reads
o-bagge Sep 18, 2026
6391de4
feat: integrate Bosch BMX160 FIFO driver
Jul 26, 2026
2da1ab2
fix(bmx160): resolve old driver deletion conflict
Jul 26, 2026
027e258
Remove unrelated application formatting change
Sep 7, 2026
87bae32
fix: remove unused variable
o-bagge Sep 8, 2026
1400101
ci: retry Zephyr toolchain setup in advisory analysis
Copilot Sep 8, 2026
45a7fd8
Improve BMA580 FIFO handling
Jul 26, 2026
9498693
fix(ppg): leave P0.6 disconnected
TobiasRoeddiger Sep 25, 2026
e320584
Move the sensor release to version 2.2.10
TobiasRoeddiger Sep 28, 2026
1d7881f
fix(version): report the release selected in VERSION
TobiasRoeddiger Sep 28, 2026
fc17e63
fix(ble): omit the firmware string terminator
TobiasRoeddiger Sep 28, 2026
5e9141b
sensors: guard stopped work and defer the first poll
TobiasRoeddiger Sep 28, 2026
d5e95b5
fix(sensors): avoid overflowing the packet sample interval
TobiasRoeddiger Sep 28, 2026
a8ce363
bmi160: skip calculations after a failed calibration read
TobiasRoeddiger Sep 28, 2026
09e3d57
fix(bmi160): preserve FIFO length on a failed read
TobiasRoeddiger Sep 28, 2026
253bbd4
fix(sensors): drain pending configuration requests
TobiasRoeddiger Sep 28, 2026
88b343d
perf(battery): sample sleeping gauge every 60 seconds
TobiasRoeddiger Sep 26, 2026
b701bf2
fix(audio): receive the complete encoder queue item
TobiasRoeddiger Sep 28, 2026
c5f427b
Merge main into 2.2.10 to include the LE Audio memory fix
TobiasRoeddiger Sep 29, 2026
db71350
fix(audio): fit the LC3 heap reserve on 2.2.10
TobiasRoeddiger Sep 29, 2026
6b159a9
perf(ble): batch consecutive sensor samples into MTU-sized packets
TobiasRoeddiger Sep 29, 2026
b8d1da9
fix(ble): preserve the audio heap reserve with sensor batches
TobiasRoeddiger Sep 29, 2026
6bb51ef
fix(ble): keep queued sensor readings fresh under load
TobiasRoeddiger Sep 30, 2026
4d08edd
fix(audio): mute cold-start PCM until synchronization settles
TobiasRoeddiger Oct 1, 2026
e21089e
fix(sensors): let audio preempt sensor configuration
TobiasRoeddiger Oct 1, 2026
2551185
perf(ble): reserve a 2.5 ms connection event
TobiasRoeddiger Sep 29, 2026
e853d02
fix(ble): leave CIS headroom in the ACL event reservation
TobiasRoeddiger Sep 30, 2026
cbfaed2
upgrade to sdk 3.4.1
Sep 26, 2026
09112cd
adjust number of buffers
Sep 30, 2026
3108b3e
fix(sdk): preserve 2.3.0 audio lifecycle and boot layout
TobiasRoeddiger Oct 1, 2026
9aa024b
fix(sdk): restore SD logger boot and pair identity
TobiasRoeddiger Oct 1, 2026
a8034c3
fix(sdk): route right earphone audio to its physical DAC slot
TobiasRoeddiger Oct 1, 2026
b8ae424
docs(tests): link the current SDK test documentation
TobiasRoeddiger Oct 1, 2026
b7f41e6
fix(audio): preserve startup settling time with shorter I2S blocks
TobiasRoeddiger Oct 1, 2026
a9fa84f
fix(audio): reserve playback margin for late startup frames
TobiasRoeddiger Oct 1, 2026
3474a53
fix(audio): wait for stable codec clocks before unmuting
TobiasRoeddiger Oct 1, 2026
56032a3
fix(audio): reconstruct missing unicast ISO timestamps
TobiasRoeddiger Oct 1, 2026
337226b
test(audio): remove timestamp unit tests from minimal patch
TobiasRoeddiger Oct 1, 2026
95c2e50
fix(audio): recheck playback alignment after timing slips
TobiasRoeddiger Oct 1, 2026
264f897
fix(fota): retain the SMP service in FOTA builds
TobiasRoeddiger Oct 1, 2026
e5ebf63
feat(audio): skip to the next track on a double click
TobiasRoeddiger Oct 1, 2026
b792726
fix(button): allow 400 ms for a double click
TobiasRoeddiger Oct 1, 2026
43abd79
fix(bluetooth): preserve phone bonds during ordinary startup
TobiasRoeddiger Oct 1, 2026
8003dc6
fix(ble): restore link negotiation and data buffers after SDK upgrade
TobiasRoeddiger Oct 1, 2026
d2b7b8b
fix(storage): preserve non-FOTA settings and flash boundary
TobiasRoeddiger Oct 1, 2026
2290e55
fix(power): preserve explicit runtime PM opt-in across SDK upgrade
TobiasRoeddiger Oct 1, 2026
250e4df
fix(bluetooth): restore controller liveness watchdog
TobiasRoeddiger Oct 1, 2026
8704565
fix(bluetooth): restore connection interval strategy callbacks
TobiasRoeddiger Oct 1, 2026
a389070
fix(tools): flash the SDK 3.4.1 sysbuild images
TobiasRoeddiger Oct 1, 2026
80d7699
Revert "fix(tools): flash the SDK 3.4.1 sysbuild images"
TobiasRoeddiger Oct 1, 2026
4f39ee1
fix flash tool
Oct 1, 2026
2261227
fix(tools): use SDK merged images for standard builds
TobiasRoeddiger Oct 1, 2026
a4ce69e
fix(fota): configure fuel gauge before charging checks
TobiasRoeddiger Oct 2, 2026
156c48d
fix(audio): clear retained timer endpoints on firmware handoff
TobiasRoeddiger Oct 2, 2026
eba4aab
fix(sensors): skip failed queue reads after restart
TobiasRoeddiger Oct 2, 2026
f0874b5
fix(sensors): describe pressure and bone data with correct units
TobiasRoeddiger Oct 2, 2026
b1ecbcc
fix(pressure): acquire ready samples in continuous mode
TobiasRoeddiger Oct 2, 2026
a99d057
fix(pressure): offer sampling rates from 1.5 Hz upward
TobiasRoeddiger Oct 2, 2026
94f4b5f
fix(pressure): advertise only rates from 25 Hz
TobiasRoeddiger Oct 2, 2026
a7932f5
fix(sensors): remove half-hertz sampling options
TobiasRoeddiger Oct 2, 2026
e6bb998
fix(bluetooth): preserve bonds across firmware downgrades
TobiasRoeddiger Oct 2, 2026
a0ef09a
fix(audio): retain decimation phase between blocks
TobiasRoeddiger Oct 2, 2026
facb12f
fix(sd): serialize buffer drains when stopping recordings
TobiasRoeddiger Oct 2, 2026
550d71a
fix(sensors): preserve FIFO sample timing across reads
TobiasRoeddiger Oct 2, 2026
e68e36e
fix(power): keep active LE Audio awake
TobiasRoeddiger Oct 3, 2026
a1102ae
fix(tools): stop standard flashing after any failed step
TobiasRoeddiger Oct 3, 2026
5791275
fix(ci): package complete dual-core firmware for wired flashing
TobiasRoeddiger Oct 3, 2026
b75bd7f
fix(temp): halt conversions during measurement EEPROM updates
TobiasRoeddiger Oct 3, 2026
839fe53
fix(imu): preserve timestamps across FIFO batches
TobiasRoeddiger Oct 3, 2026
a1d1acc
fix(recording): keep configuration when SD startup fails
TobiasRoeddiger Oct 4, 2026
cde4946
fix(bluetooth): retain 2M PHY preference across reconnects
TobiasRoeddiger Oct 4, 2026
c0a00eb
fix(sd): checkpoint active recordings without stopping acquisition
TobiasRoeddiger Oct 3, 2026
ba80b99
Use 32 MHz for SD block writes
TobiasRoeddiger Oct 4, 2026
cde3c38
Drain complete bone-conduction FIFO frames
TobiasRoeddiger Oct 4, 2026
e059743
Validate bone FIFO frame layout before decoding
TobiasRoeddiger Oct 4, 2026
9444ec8
Buffer pressure conversions in the BMP388 FIFO
TobiasRoeddiger Oct 4, 2026
93219b6
Reduce temperature acquisition overhead
TobiasRoeddiger Oct 4, 2026
2ba1cda
Reduce SD busy-poll and partial-sector write overhead
TobiasRoeddiger Oct 4, 2026
b106fe0
Batch more FIFO samples per internal sensor record
TobiasRoeddiger Oct 4, 2026
3990f25
Reserve another SD buffer block within the audio heap budget
TobiasRoeddiger Oct 4, 2026
8c62336
Drain PPG on its own bus worker at batch intervals
TobiasRoeddiger Oct 4, 2026
452a479
Allow bounded timestamp jitter in BLE sensor batches
TobiasRoeddiger Oct 4, 2026
2a4e00f
Rate-limit BLE sensor overflow warnings
TobiasRoeddiger Oct 4, 2026
312806d
chore: prepare firmware 2.3.0
TobiasRoeddiger Oct 4, 2026
d39025e
chore: keep 2.3.0 version bump with compact PPG format
TobiasRoeddiger Oct 4, 2026
7d1ce27
feat(ppg): pack BLE samples into ten bytes in firmware 2.3.0
TobiasRoeddiger Oct 4, 2026
ca8ef79
test: fetch protocol codecs for native sensor transport tests
TobiasRoeddiger Oct 4, 2026
b4d09ca
Reduce IMU BLE samples while preserving float and SD values
TobiasRoeddiger Oct 4, 2026
62bd60a
feat(led): read and notify the configured RGB color and mode
TobiasRoeddiger Oct 4, 2026
1d8bf04
Drain queued sensor data before closing SD recordings
TobiasRoeddiger Oct 5, 2026
6aea0bc
Increase LE Audio receive buffer headroom
TobiasRoeddiger Oct 5, 2026
03ba9d1
Restore nRF53 radio slot state hook for FOTA recovery
TobiasRoeddiger Oct 5, 2026
9cca044
Keep sensor acquisition running when only BLE routing changes
TobiasRoeddiger Oct 5, 2026
4c09754
Fix SD recording headers and group profile changes
o-bagge Oct 5, 2026
56cb1ea
Validate encoder channel overlap and select the correct input channel
TobiasRoeddiger Oct 6, 2026
63db225
Resolve remaining audio analysis findings without changing fatal hand…
TobiasRoeddiger Oct 6, 2026
b0066d6
Align beta publisher with main to resolve release merge conflict
TobiasRoeddiger Oct 6, 2026
425bb57
Configure Bluetooth headers for the host encoder regression suite
TobiasRoeddiger Oct 6, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 16 additions & 7 deletions .github/workflows/build_firmware.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,9 @@ jobs:

- name: Install Zephyr SDK
run: |
wget -q https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.17.0/zephyr-sdk-0.17.0_linux-x86_64_minimal.tar.xz
tar xf zephyr-sdk-0.17.0_linux-x86_64_minimal.tar.xz -C ~/
~/zephyr-sdk-0.17.0/setup.sh -c -t arm-zephyr-eabi
wget -q https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v1.0.1/zephyr-sdk-1.0.1_linux-x86_64_minimal.tar.xz
tar xf zephyr-sdk-1.0.1_linux-x86_64_minimal.tar.xz -C ~/
~/zephyr-sdk-1.0.1/setup.sh -c -t arm-zephyr-eabi

- name: Initialize Zephyr Workspace
# Set up the Zephyr workspace and install the Python dependencies
Expand Down Expand Up @@ -102,16 +102,25 @@ jobs:
- name: Check And Prepare Build Output
run: |
mkdir -p $(pwd)/workflow-board-temp/build-output
cp $(pwd)/zephyr-workspace/build/ipc_radio/zephyr/zephyr.elf $(pwd)/workflow-board-temp/build-output/openearable_v2_firmware.elf
firmware_dir="$(pwd)/workflow-board-temp/build-output/openearable_v2_firmware"
mkdir -p "$firmware_dir/build_fota" "$firmware_dir/tools/flash"
cp zephyr-workspace/build/merged_openearable_v2_nrf5340_cpuapp.hex "$firmware_dir/build_fota/"
cp zephyr-workspace/build/merged_openearable_v2_nrf5340_cpunet.hex "$firmware_dir/build_fota/"
cp zephyr-workspace/build/open-earable-v2/zephyr/zephyr.elf "$firmware_dir/openearable_v2_cpuapp.elf"
cp zephyr-workspace/build/ipc_radio/zephyr/zephyr.elf "$firmware_dir/openearable_v2_cpunet.elf"
cp zephyr-workspace/open-earable-v2/tools/flash/flash_fota.sh "$firmware_dir/tools/flash/"
printf '%s\n' 'From this directory, run: bash tools/flash/flash_fota.sh --snr <J-Link serial>' \
'The build_fota images include both cores and their bootloaders. The ELFs are for debugging.' \
> "$firmware_dir/FLASH.txt"
cp $(pwd)/zephyr-workspace/build/dfu_application.zip $(pwd)/workflow-board-temp/build-output/openearable_v2_fota.zip
(cd $(pwd)/workflow-board-temp/build-output && unzip openearable_v2_fota.zip -d openearable_v2_fota && rm openearable_v2_fota.zip)

- name: Upload Build Artifact (Firmware)
uses: actions/upload-artifact@v4
id: artifact-upload-step-1
with:
name: openearable_v2_firmware.elf
path: workflow-board-temp/build-output/openearable_v2_firmware.elf
name: openearable_v2_firmware.zip
path: workflow-board-temp/build-output/openearable_v2_firmware/

- name: Upload Build Artifact (FOTA build)
uses: actions/upload-artifact@v4
Expand All @@ -126,5 +135,5 @@ jobs:
with:
message: |
Build output available:
[openearable_v2_firmware.elf.zip](${{ steps.artifact-upload-step-1.outputs.artifact-url }})
[openearable_v2_firmware.zip](${{ steps.artifact-upload-step-1.outputs.artifact-url }})
[openearable_v2_fota.zip](${{ steps.artifact-upload-step-2.outputs.artifact-url }})
13 changes: 11 additions & 2 deletions .github/workflows/codechecker.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ concurrency:

env:
CODECHECKER_VERSION: "6.28.2"
ZEPHYR_SDK_VERSION: "0.17.0"
ZEPHYR_SDK_VERSION: "1.0.1"

jobs:
codechecker:
Expand Down Expand Up @@ -62,7 +62,16 @@ jobs:
wget --quiet \
"https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v${ZEPHYR_SDK_VERSION}/zephyr-sdk-${ZEPHYR_SDK_VERSION}_linux-x86_64_minimal.tar.xz"
tar xf "zephyr-sdk-${ZEPHYR_SDK_VERSION}_linux-x86_64_minimal.tar.xz"
"${PWD}/zephyr-sdk-${ZEPHYR_SDK_VERSION}/setup.sh" -c -t arm-zephyr-eabi
for attempt in 1 2 3; do
"${PWD}/zephyr-sdk-${ZEPHYR_SDK_VERSION}/setup.sh" -c -t arm-zephyr-eabi && break
if [ "${attempt}" -eq 3 ]; then
echo "::error::Failed to install arm-zephyr-eabi toolchain after ${attempt} attempts."
exit 20
fi
echo "Retrying Zephyr toolchain installation (attempt $((attempt + 1))/3)..."
rm -rf "${PWD}/zephyr-sdk-${ZEPHYR_SDK_VERSION}/gnu/arm-zephyr-eabi"
sleep 5
done

- name: Initialize Zephyr workspace
working-directory: zephyr-workspace
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/compiler_warnings.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,9 @@ jobs:
- name: Set up Zephyr workspace
run: |
pip3 install west
wget -q https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.17.0/zephyr-sdk-0.17.0_linux-x86_64_minimal.tar.xz
tar xf zephyr-sdk-0.17.0_linux-x86_64_minimal.tar.xz -C ~/
~/zephyr-sdk-0.17.0/setup.sh -c -t arm-zephyr-eabi
wget -q https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v1.0.1/zephyr-sdk-1.0.1_linux-x86_64_minimal.tar.xz
tar xf zephyr-sdk-1.0.1_linux-x86_64_minimal.tar.xz -C ~/
~/zephyr-sdk-1.0.1/setup.sh -c -t arm-zephyr-eabi
cd zephyr-workspace
west init -l open-earable-v2
west update --narrow -o=--depth=1
Expand Down
14 changes: 9 additions & 5 deletions .github/workflows/prerelease_open_pr_builds.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ jobs:
num=$(echo "$pr" | jq -r .number)
sha=$(echo "$pr" | jq -r .headRefOid)
title=$(echo "$pr" | jq -r .title)
safe_title=$(echo "$title" | sed 's/[^a-zA-Z0-9_-]/_/g' | cut -c1-50)
safe_title=$(echo "$title" | sed 's/[^a-zA-Z0-9_.-]/_/g' | cut -c1-50)
run_id=$(gh run list \
--repo "${{ github.repository }}" \
--workflow "$BUILD_WORKFLOW_NAME" \
Expand All @@ -73,8 +73,13 @@ jobs:
fi
out="collected/pr-$num"
rm -rf "$out" && mkdir -p "$out"
if ! gh run download "$run_id" --repo "${{ github.repository }}" -n "openearable_v2_firmware.elf" -D "$out/elf" 2>&1; then
echo "PR #$num: failed to download firmware.elf artifact (may be expired)"
if gh run download "$run_id" --repo "${{ github.repository }}" -n "openearable_v2_firmware.zip" -D "$out/firmware" 2>&1; then
(cd "$out/firmware" && zip -r "../openearable_v2_firmware.zip" .)
elif gh run download "$run_id" --repo "${{ github.repository }}" -n "openearable_v2_firmware.elf" -D "$out/elf" 2>&1; then
# Older PRs still publish a single ELF rather than the flash bundle.
mv "$out/elf/openearable_v2_firmware.elf" "$out/openearable_v2_firmware.elf"
else
echo "PR #$num: failed to download firmware artifact (may be expired)"
rm -rf "$out"
continue
fi
Expand All @@ -84,8 +89,7 @@ jobs:
continue
fi
(cd "$out/fota" && zip -r "../openearable_v2_fota.zip" .)
mv "$out/elf/openearable_v2_firmware.elf" "$out/openearable_v2_firmware.elf"
rm -rf "$out/elf" "$out/fota"
rm -rf "$out/firmware" "$out/elf" "$out/fota"

echo "$safe_title" > "$out/title.txt"

Expand Down
10 changes: 7 additions & 3 deletions .github/workflows/release_firmware.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,11 @@ jobs:
- name: Download Firmware Artifact (Firmware)
uses: actions/download-artifact@v4
with:
name: openearable_v2_firmware.elf
name: openearable_v2_firmware.zip
path: ./openearable_v2_firmware

- name: Zip complete firmware package
run: (cd openearable_v2_firmware && zip -r ../openearable_v2_firmware.zip .)

- name: Create Directory for FOTA
run: mkdir -p openearable_v2_fota
Expand All @@ -52,10 +56,10 @@ jobs:

# v2.2.8 -> 2.2.8
version="${RELEASE_TAG#v}"
firmware_name="openearable_v2_firmware_${version}.elf"
firmware_name="openearable_v2_firmware_${version}.zip"
fota_name="openearable_v2_fota_${version}.zip"

mv openearable_v2_firmware.elf "$firmware_name"
mv openearable_v2_firmware.zip "$firmware_name"
mv openearable_v2_fota.zip "$fota_name"

echo "firmware=$firmware_name" >> "$GITHUB_OUTPUT"
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/unit_tests.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ jobs:
with:
# Keep the application below the west workspace root.
path: zephyr-workspace/open-earable-v2
submodules: recursive

- name: Install host dependencies
uses: awalsh128/cache-apt-pkgs-action@latest
Expand Down
15 changes: 12 additions & 3 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,21 @@ add_compile_definitions(GATEWAY=2)

find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})

project(openearable_v2_1)
project(openearable_v2)

include(cmake/sd_spi_fast_write.cmake)

# NCS 3.4.1 gates this bootutil hook on a bootloader-only Kconfig symbol.
# SMP must use its nRF53 hook too: the radio primary slot is not readable here.
if(CONFIG_MCUMGR_GRP_IMG_NRF5340_BOOTUTIL_HOOK)
target_compile_definitions(mcuboot_util PRIVATE CONFIG_NRF53_MULTI_IMAGE_UPDATE=1)
endif()

#set(OVERLAY_CONFIG
# ${CMAKE_CURRENT_SOURCE_DIR}/unicast_server/overlay-unicast_server.conf
#)

string(TIMESTAMP NRF5340_AUDIO_CORE_APP_COMP_DATE "%a %b %d %H:%M:%S %Y")
string(TIMESTAMP NRF_AUDIO_CORE_APP_COMP_DATE "%a %b %d %H:%M:%S %Y")

# Generate fw_info_app.c
configure_file("${CMAKE_CURRENT_SOURCE_DIR}/src/utils/fw_info_app.c.in"
Expand All @@ -45,6 +53,7 @@ zephyr_library_include_directories(
include
src/audio
src/Battery
src/buttons
src/Wire
src/bluetooth
src/drivers
Expand All @@ -59,7 +68,7 @@ zephyr_library_include_directories(
)

zephyr_library_include_directories(app PRIVATE
${ZEPHYR_NRF_MODULE_DIR}/boards/teco/openearable_v2_nrf5340)
${CMAKE_CURRENT_SOURCE_DIR}/boards/teco/openearable_v2)

# Application sources
add_subdirectory(src/audio)
Expand Down
11 changes: 5 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,11 +33,11 @@ Use the same toolchain versions the repository expects.
1. Install Visual Studio Code and the nRF Connect for VS Code extension.
2. Install the J-Link Software and Documentation Package.
3. Install `nrfutil` and ensure it is available on your `PATH`.
4. Install nRF Connect SDK `v3.0.1`.
5. Install toolchain `v3.0.1`.
4. Install nRF Connect SDK `v3.4.1`.
5. Install toolchain `v3.4.1`.
6. Open this repository as an application in the nRF Connect extension.

The manifest in [west.yml](west.yml) pins the workspace to `sdk-nrf` `v3.0.1`. Keep documentation and local validation aligned with that version unless the repository is explicitly upgraded.
The manifest in [west.yml](west.yml) pins the workspace to `sdk-nrf` `v3.4.1`. Keep documentation and local validation aligned with that version unless the repository is explicitly upgraded.

## Build And Flash

Expand Down Expand Up @@ -156,7 +156,7 @@ without sysbuild using Clang Static Analyzer and Cppcheck. Style findings,
Clang-Tidy, formatting, and automatic fixes are not enabled. The analyzer
configuration is in [.codechecker.json](.codechecker.json).

Local execution is optional. In an nRF Connect SDK `v3.0.1` Linux or WSL
Local execution is optional. In an nRF Connect SDK `v3.4.1` Linux or WSL
workspace, install CodeChecker `6.28.2`, Clang, and Cppcheck, then run:

```bash
Expand All @@ -171,8 +171,7 @@ west build --no-sysbuild --board openearable_v2/nrf5340/cpuapp \
```

Reports are written to `<build-directory>/sca/codechecker/`. See Nordic's
[CodeChecker documentation for nRF Connect SDK 3.0.1](https://nrfconnectdocs.nordicsemi.com/ncs/3.0.1/zephyr/develop/sca/codechecker.html)
or the corresponding [upstream Zephyr 4.0 documentation](https://docs.zephyrproject.org/4.0.0/develop/sca/codechecker.html)
[CodeChecker documentation for nRF Connect SDK 3.4.1](https://nrfconnectdocs.nordicsemi.com/ncs/3.4.1/zephyr/develop/sca/codechecker.html)
for the available options.

## Validation Before Opening A Pull Request
Expand Down
10 changes: 3 additions & 7 deletions Kconfig
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,9 @@
# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
#

menuconfig NRF5340_AUDIO
bool "nRF5340 Audio [EXPERIMENTAL]"
menuconfig APP_NRF_AUDIO
bool "nRF Audio [EXPERIMENTAL]"
select EXPERIMENTAL

if NRF5340_AUDIO

config CUSTOM_BROADCASTER
bool "Allow custom broadcasters"
Expand All @@ -25,7 +23,7 @@ config AUDIO_DEV
as a HEADSET device.
Setting to 2 will compile as a GATEWAY.

choice NRF5340_AUDIO_TRANSPORT_MODE
choice NRF_AUDIO_TRANSPORT_MODE
prompt "Choose BIS or CIS for ISO transport"
default TRANSPORT_CIS if WALKIE_TALKIE_DEMO
default TRANSPORT_CIS
Expand Down Expand Up @@ -79,6 +77,4 @@ config PRINT_STACK_USAGE_MS
endmenu # Log levels

#----------------------------------------------------------------------------#
endif # NRF5340_AUDIO

source "Kconfig.zephyr"
26 changes: 6 additions & 20 deletions Kconfig.defaults
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,11 @@ config MAIN_THREAD_PRIORITY
default 10

config MAIN_STACK_SIZE
default 1800 if SD_CARD_PLAYBACK
default 1600
default 2500 if SD_CARD_PLAYBACK
default 2000

config SYSTEM_WORKQUEUE_STACK_SIZE
default 1200
default 2000

# As long as thread names are used, config must be set to "y"
config THREAD_NAME
Expand Down Expand Up @@ -48,7 +48,7 @@ config REGULATOR
config CONTIN_ARRAY
default y

config NRFX_I2S0
config NRFX_I2S
default y

config PCM_MIX
Expand All @@ -57,22 +57,13 @@ config PCM_MIX
config PSCM
default y

config DATA_FIFO
default y

# Enable NRFX_CLOCK for ACLK control
config NRFX_CLOCK
default y

config I2C
default y

choice LIBC_IMPLEMENTATION
# NOTE: Since we are not using minimal libc, error codes from
# minimal libc are not used
default NEWLIB_LIBC
endchoice

# Audio codec LC3 related defines
# FPU_SHARING enables preservation of the hardware floating point registers
# across context switches to allow multiple threads to perform concurrent
Expand Down Expand Up @@ -110,9 +101,6 @@ config FILE_SYSTEM
config FAT_FILESYSTEM_ELM
default y

config FS_FATFS_HAS_RTC
default y

config FS_FATFS_LFN
default y
choice FS_FATFS_LFN_MODE
Expand All @@ -124,8 +112,6 @@ endchoice
config FS_FATFS_EXFAT
default y

config WATCHDOG
default y

config TASK_WDT
# The SD logger owns a 32768-byte ring; Zephyr now defaults to a 32767-byte limit.
config RING_BUFFER_LARGE
default y
5 changes: 4 additions & 1 deletion Kconfig.sysbuild
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,7 @@
config NRF_DEFAULT_IPC_RADIO
default y

source "${ZEPHYR_BASE}/share/sysbuild/Kconfig"
config PARTITION_MANAGER
default n

source "share/sysbuild/Kconfig"
10 changes: 7 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,11 +39,11 @@
5. **Install the Toolchain via nRF Connect**
- Open the **nRF Connect** tab in VS Code.
- Click **"Install Toolchain"**.
- Select and install **version 3.0.1**.
- Select and install **version 3.4.1**.

6. **Install the nRF Connect SDK**
- In the **nRF Connect** tab, select **"Manage SDK"**.
- Install **SDK version 3.0.1**.
- Install **SDK version 3.4.1**.

7. **Clone or Update the Firmware Repository and Open It in VS Code**
- For a new checkout, clone the repository together with its submodules:
Expand All @@ -65,14 +65,17 @@
- In the **APPLICATIONS** section of the nRF Connect extension tab:
- Select the `open-earable-2` application.
- Click **"+ Add build configuration"** to set up a new build.
- Select the SDK version 3.0.1, toolchain version 3.0.1, and `open-earable-2/nrf5340/cpuapp` as board target.
- Select the SDK version 3.4.1, toolchain version 3.4.1, and `openearable_v2/nrf5340/cpuapp` as board target.
- After switching SDK versions, use a new build directory or a pristine build.
- The firmware manifest pins nRF Connect SDK **v3.4.1** (Nordic Zephyr **4.4.2**). Use the matching **v3.4.1 Nordic toolchain**; CI uses **Zephyr SDK 1.0.1**.
- To build **with FOTA** (firmware over-the-air update functionality):
- Leave the `Base configuration files (Kconfig fragments)` dropdown empty.
- as `Extra CMAKE arguments` set `-DFILE_SUFFIX="fota"`.
- as `Build directory` name set `build_fota`.
- To build **without FOTA**:
- Select `prj.conf` as the `Base configuration files (Kconfig fragments)`.
- Do not set any of the FOTA flags described above.
- **Migrating from SDK 3.0.1:** use a full wired sysbuild flash, including MCUboot, the network-core bootloader, and both core images. SDK 3.4.1 replaces Partition Manager with fixed devicetree partitions at the same addresses. Its FOTA configuration uses overwrite-only updates, so it does not provide automatic rollback. An OTA-only migration using the older bootloader has not been validated.

9. **J-Link Setup**
- Wire your J-Link to the debugging breakout PCB as shown below.
Expand All @@ -84,6 +87,7 @@

11. **Build and Flash**
- Click on `Generate and Build` and wait for the application to build (this will take some time)
- Rebuild existing configurations to generate the per-core `merged_openearable_v2_nrf5340_cpuapp.hex` and `merged_openearable_v2_nrf5340_cpunet.hex` files used by the flash scripts. Both scripts also accept the previous `merged.hex` / `merged_CPUNET.hex` layout.
- Make sure your device is charged or powered via USB. If the battery is fully discharged, the charging management IC will no longer supply power to the MCU from the battery, so you won’t be able to flash the MCU unless the battery is charged or the device is directly powered via USB.
- Open a new terminal in VS Code and run the following command from the root of the `open-earable-v2` directory to flash the FOTA build. Make sure to set the serial number of your J-Link (right click your J-Link in the `CONNECTED DEVICES` tab of the nRF connect extension and copy the serial number).
```bash
Expand Down
4 changes: 2 additions & 2 deletions VERSION
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
VERSION_MAJOR = 2
VERSION_MINOR = 2
PATCHLEVEL = 9
VERSION_MINOR = 3
PATCHLEVEL = 0
VERSION_TWEAK = 0
EXTRAVERSION =
6 changes: 3 additions & 3 deletions boards/nrf5340_audio_dk_nrf5340_cpuapp.conf
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,6 @@
# SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
#

CONFIG_NRF5340_AUDIO_CS47L63_DRIVER=y
CONFIG_NRF5340_AUDIO_POWER_MEASUREMENT=y
CONFIG_NRF5340_AUDIO_SD_CARD_MODULE=y
CONFIG_NRF_AUDIO_CS47L63_DRIVER=y
CONFIG_NRF_AUDIO_SD_CARD_MODULE=y
CONFIG_UDC_DRIVER_HIGH_SPEED_SUPPORT_ENABLED=n
Loading
Loading