VictronBLE/samples/README.md

Zephyr samples

Zephyr applications live here; examples/ holds the Arduino/PlatformIO ones.

Sample	What it does
scan/	Lists every Victron device advertising nearby. No keys needed. Start here.
observer/	Monitors known devices and decodes their records.

Both need CONFIG_VICTRONBLE=y, which depends on CONFIG_BT_OBSERVER=y. See the Zephyr section of the top-level README for how to add this library to a west workspace.

Building

The library is a Zephyr module. If it is already in your west.yml, the samples build with no extra flags:

west build -p -b nrf52840dk/nrf52840 samples/observer

For local development against a checkout that is not in the manifest, point Zephyr at it directly:

west build -p -b nrf52840dk/nrf52840 -d /tmp/vb_obs \
    /path/to/VictronBLE/samples/observer \
    -- -DZEPHYR_EXTRA_MODULES=/path/to/VictronBLE

Then west flash, and watch the console at 115200 baud.

Tested on nrf52840dk/nrf52840 and rak4631/nrf52840 with Zephyr v4.4.0. Any board with a Bluetooth controller and the observer role should work — nothing in the library is nRF-specific.

Build-test both samples without hardware. For a checkout outside the manifest, twister needs the same module hint via the environment:

ZEPHYR_EXTRA_MODULES=$PWD \
    west twister -T samples -p nrf52840dk/nrf52840 -p rak4631/nrf52840