Skip to main content

v2n-board-id-readout

Reads and prints the SoM's hardware-info manifest from the on-module 24C128 EEPROM, then asserts the firmware build is intended for the SKU on the module.

Source: examples/v2n/v2n-board-id-readout/.

What it does

  1. Calls alp_hw_info_read(&info) — internally opens E1M_I2C0, reads the 128-byte manifest at offset 0, validates magic + schema_version + CRC32, populates the struct.
  2. Prints every field (family, SKU, hw_rev, serial, mfg date).
  3. Asserts info.som_sku == "E1M-V2N101" via alp_hw_info_assert_matches_build().

board.yaml

schema_version: 2

som:
sku: E1M-V2N101

carrier:
name: E1M-X-EVK

cores:
m33_sm:
os: zephyr
app: ./src
peripherals: [i2c]

chips:
- eeprom_24c128

diagnostics:
log_level: info

Expected output (factory-programmed module)

[board-id] read SoM hardware-info manifest
[board-id] family = v2n
[board-id] sku = E1M-V2N101
[board-id] hw_rev = r1
[board-id] serial = ALP-V2N101-26W19-00042
[board-id] mfg date = 2026-05-09
[board-id] firmware build is for this SoM family
[board-id] done

Expected output (unprogrammed module)

[board-id] manifest CRC mismatch or magic byte wrong
[board-id] factory programming has not run on this module

See also

Questions about this page? Discuss in Community Forum