ZBook Board (Zephyr module)

Out-of-tree board support for the ZBook (Raspberry Pi RP2350B, Cortex-M33), packaged as a Zephyr module.

Contents

boards/zbook/                 # board definition
  zbook_rp2350b_m33.dts       #   standalone variant + partitions
  zbook_rp2350b_m33_mcuboot.dts  # MCUboot variant + partitions
  zbook_rp2350b_m33-common.dtsi  # shared hardware (both variants) + LittleFS fstab
  *_defconfig / *.yaml / board.yml / board.cmake / Kconfig* / zbook-pinctrl.dtsi
boards/shields/zbook_wifi/    # attachable ESP8266 Wi-Fi shield
snippets/                     # board-provided snippets (zbook-wifi-credentials-littlefs)
zephyr/module.yml             # registers boards/ (board_root) and snippets/ (snippet_root)

Usage

Add this repo to your west manifest. zephyr/module.yml sets board_root and snippet_root, so both the board target and the board-provided snippets are discovered automatically — no BOARD_ROOT needed in your app's CMake:

# west.yml (excerpt)
projects:
  - name: zbook
    remote: zephyr-book
    revision: main

Then build for the board target:

west build -b zbook/rp2350b/m33                       # standalone
west build -b zbook/rp2350b/m33 --shield zbook_wifi   # + Wi-Fi
west build -b zbook/rp2350b/m33 --shield zbook_wifi -S zbook-wifi-credentials-littlefs  # + LittleFS creds
west build -b zbook/rp2350b/m33/mcuboot --sysbuild    # MCUboot layout

Board targets

Target	Layout
zbook/rp2350b/m33	Standalone (boots directly), storage partition
zbook/rp2350b/m33/mcuboot	MCUboot layout, app in slot-0

Snippets

zephyr/module.yml sets snippet_root: ., so snippets under snippets/ are auto-discovered by any app that uses this board — apply one with -S <name>.

Snippet	Effect
zbook-wifi-credentials-littlefs	Persist Wi-Fi credentials via the settings FILE backend on LittleFS (mounted at /lfs on the storage partition), instead of the NVS backend used by the upstream -S wifi-credentials snippet.

west build -b zbook/rp2350b/m33 --shield zbook_wifi -S zbook-wifi-credentials-littlefs

Notes:

• The LittleFS mount is the zephyr,fstab node in zbook_rp2350b_m33-common.dtsi; it is inert unless CONFIG_FILE_SYSTEM_LITTLEFS=y, so it does not affect builds that don't use this snippet.
• The application must still pull the littlefs module into its own west manifest (a module cannot extend the app's manifest), e.g. add littlefs to the Zephyr import name-allowlist.