BLE Webble¶

Minimal BLE peripheral example for NSX BLE targets.

Status: Experimental. The BLE modules and this example have been hardware-smoke-tested on AP3, AP4, and AP510B. nsx-freertos, nsx-cordio, and nsx-ble are resolved through the packaged NSX registry; the experimental label reflects the example's maturity, not a local-module requirement.

The app demonstrates the optional nsx-cordio + nsx-ble modules with all application policy kept in the app: board power/cache bring-up, FreeRTOS task sizes, WSF buffer pool sizing, LED heartbeat, advertised service contents, and TX-power selection.

BLE in this example¶

Bluetooth LE peripherals advertise a small amount of data so a central device (phone, laptop, or test script) can find them. After a central connects, it uses GATT services and characteristics to read values, write values, or subscribe to notifications.

ble_webble keeps that model intentionally small:

• one primary custom service;
• one read-only heartbeat characteristic;
• one notify characteristic that increments while subscribed;
• one read/write RGB value;
• standard GAP name and Device Information Service fields.

The example is meant to show the NSX/Cordio wiring and a clean app-owned policy boundary, not to be a full BLE framework. Pairing/bonding policy, multiple services, production advertising strategy, and application-specific protocol design should stay in the application.

Targets¶

• Default board: apollo4p_blue_kxr_evb
• Supported boards:
• apollo3p_evb
• apollo4p_blue_kxr_evb
• apollo510b_evb
• Toolchains build-validated:
• gcc

Build¶

nsx build
nsx build --board apollo3p_evb
nsx build --board apollo510b_evb

Host demo¶

A small Python smoke tool is available at:

• tools/ble_webble_host.py

Examples:

python -m py_compile tools/ble_webble_host.py
python tools/ble_webble_host.py --list
python tools/ble_webble_host.py --name NSX-AP5 --notify-seconds 3 --rgb 102030

When multiple matching boards are advertising, re-run with --address to target the intended device explicitly.

Flash¶

When multiple probes are attached, always specify the intended J-Link serial. For the local Linux tower used during bring-up:

nsx flash --board apollo4p_blue_kxr_evb --probe-serial 1160001350

Named-target flash probe¶

This project also defines ble_webble_flash_probe, a small secondary executable that is excluded from normal builds. It exists to exercise named target flashing without changing the primary BLE firmware:

nsx flash --board apollo3p_evb \
  --target ble_webble_flash_probe \
  --probe-serial <serial>

NSX builds only that executable, checks its generated binary and J-Link recipe, then requires J-Link programming confirmation. With an SWO viewer attached, the secondary image prints ble_webble_flash_probe: named-target image running once per second.

BLE service¶

Advertised names:

Primary service UUID:

19b10000-0000-537e-4f6c-d104768a1214

Characteristics:

The app also populates the standard Device Information Service with Ambiq and board-specific values, requests a larger MTU/data length where supported, and registers an event callback for connect/disconnect, MTU, data-length, CCC, and hardware-error diagnostics.

Liveness¶

The heartbeat task toggles board LEDs every 500 ms, prints webble: heartbeat N over SWO, and mirrors the low byte of N into the readable 2001 characteristic.

Hardware smoke coverage¶

Validated manually: