tan-cli 0.7.0__py3-none-any.whl

tan/templates/vendored/multicore-mailbox/E1M-AEN801/src/main.c

@@ -0,0 +1,185 @@
+/*
+ * Copyright 2026 Alp Lab AB
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * mproc-mailbox -- M55-HP <-> M55-HE shared-memory mailbox
+ * roundtrip on AEN (Alif Ensemble dual-Cortex-M55 silicon).
+ *
+ * The pattern this example shows
+ * ==============================
+ *
+ * Two Cortex-M55 cores share a small region of non-cached
+ * SRAM + a hardware mailbox + a hardware semaphore.  An app on
+ * the M55-HP (the "application" core) sends a payload to the
+ * M55-HE (the "high-efficiency" peer) and waits for a reply.
+ *
+ *   1. HP owns the application: Wi-Fi, MQTT, UI.
+ *   2. HE owns offloadable work: PDM/audio DSP, slow sensor
+ *      polling, inference pre/post-processing.
+ *   3. Mailbox + shared memory are how HP hands work to HE and
+ *      collects results.
+ *
+ * The SDK exposes this through <alp/mproc.h>.  Same API on AEN
+ * (HP<->HE) and on V2N (Cortex-A55 <-> Cortex-M33); the
+ * backend dispatches to the silicon's hardware mailbox.
+ *
+ * What you'll see in this example
+ * ===============================
+ *
+ *   [mproc] init mbox + shmem
+ *   [mproc] sending payload  "hello-from-HP" (13 bytes)
+ *   [mproc] HE replied via mbox callback
+ *   [mproc] HE replied       "echo: hello-from-HP" (19 bytes)
+ *   [mproc] done
+ *
+ * Under native_sim there's no peer core; the example exercises
+ * just the HP-side init + the framing-encode path + `done`.
+ * Real-silicon runs both halves.
+ *
+ * Peer firmware
+ * =============
+ *
+ * The HE-side application lives at
+ * `https://github.com/alplabai/alp-sdk/blob/v0.17.0/examples/multicore/mproc-mailbox/peer/main.c`.  Both halves build
+ * standalone via `west build`, and `board.yaml` declaring both
+ * `m55_hp` and `m55_he` as real project cores means one `tan build`
+ * already produces both images through the orchestrator's existing
+ * multi-slice path -- no sysbuild involved.
+ */
+
+#include <stdio.h>
+#include <string.h>
+
+#include "alp/mproc.h"
+#include "alp/peripheral.h"
+
+/* Region name resolved against the alp-shmemN DT aliases in the
+ * board overlay -- here, alp-shmem0 in boards/<board>.overlay or
+ * the orchestrator-emitted carve-out for AEN dual-core builds. */
+#define SHMEM_REGION_NAME "alp_shmem0"
+#define SHMEM_REGION_SIZE 512u
+#define MBOX_CHANNEL      0u
+#define REQUEST_OFFSET    0u
+#define RESPONSE_OFFSET   256u /* gap from request so the two never overlap */
+#define MAX_PAYLOAD       128u
+
+static const char *PAYLOAD = "hello-from-HP";
+
+static struct {
+	volatile bool   got_reply;
+	volatile size_t reply_offset;
+	volatile size_t reply_len;
+} g_state;
+
+/* Mailbox inbound-message callback.  Fires when the HE peer
+ * signals back with the (offset, length) tuple naming the
+ * staged echo response.  Runs on the SDK's mbox thread; we
+ * just stash the values so main() can drain them. */
+static void mbox_inbound(uint32_t channel, const void *data, size_t len, void *user)
+{
+	(void)channel;
+	(void)user;
+	if (len < 8u) return;
+	const uint8_t *b = data;
+	g_state.reply_offset =
+	    (size_t)b[0] | ((size_t)b[1] << 8) | ((size_t)b[2] << 16) | ((size_t)b[3] << 24);
+	g_state.reply_len =
+	    (size_t)b[4] | ((size_t)b[5] << 8) | ((size_t)b[6] << 16) | ((size_t)b[7] << 24);
+	g_state.got_reply = true;
+}
+
+int main(void)
+{
+	printf("[mproc] init mbox + shmem\n");
+
+	const alp_shmem_config_t shmem_cfg = {
+		.name = SHMEM_REGION_NAME,
+		.size = SHMEM_REGION_SIZE,
+	};
+	alp_shmem_t *shmem = alp_shmem_open(&shmem_cfg);
+
+	const alp_mbox_config_t mbox_cfg = {
+		.channel = MBOX_CHANNEL,
+		.peer    = ALP_CORE_M55_HE,
+	};
+	alp_mbox_t *mbox = alp_mbox_open(&mbox_cfg);
+
+	if (shmem == NULL || mbox == NULL) {
+		printf("[mproc]   open failed: last_err=%d\n", (int)alp_last_error());
+		goto done;
+	}
+
+	/* Get a pointer view of the shared region.  Both cores see
+     * the same physical bytes; the region is non-cacheable,
+     * so no cache flush is needed. */
+	void  *shmem_base = NULL;
+	size_t shmem_size = 0u;
+	if (alp_shmem_view(shmem, &shmem_base, &shmem_size) != ALP_OK) {
+		printf("[mproc]   shmem view failed\n");
+		goto teardown;
+	}
+	if (shmem_size < RESPONSE_OFFSET + MAX_PAYLOAD) {
+		printf("[mproc]   shmem too small (%zu)\n", shmem_size);
+		goto teardown;
+	}
+
+	/* Stage the payload at REQUEST_OFFSET in the shared region.
+     * memcpy is the right primitive here -- the SDK's shmem
+     * surface gives back a raw pointer + size and trusts the
+     * caller to write through it. */
+	const size_t payload_len = strlen(PAYLOAD);
+	memcpy((uint8_t *)shmem_base + REQUEST_OFFSET, PAYLOAD, payload_len);
+
+	/* Send the mailbox notification.  Payload here is the
+     * `(offset, length)` tuple that points at the staged bytes
+     * in shmem; the peer reads the actual data through its own
+     * shmem view. */
+	uint8_t mbox_msg[8] = {
+		(uint8_t)REQUEST_OFFSET, 0, 0, 0, /* offset (LE u32) */
+		(uint8_t)payload_len,    0, 0, 0, /* length (LE u32) */
+	};
+	if (alp_mbox_send(mbox, mbox_msg, sizeof(mbox_msg), 100u) != ALP_OK) {
+		printf("[mproc]   mbox send failed\n");
+		goto teardown;
+	}
+	printf("[mproc] sending payload  \"%s\" (%u bytes)\n", PAYLOAD, (unsigned)payload_len);
+
+	/* Register the receive callback before waiting.  On real
+     * silicon the peer sends back via the same mbox; the
+     * callback drains the (offset, length) tuple naming the
+     * echo response. */
+	if (alp_mbox_set_callback(mbox, mbox_inbound, NULL) != ALP_OK) {
+		printf("[mproc]   set_callback failed\n");
+		goto teardown;
+	}
+
+#ifdef CONFIG_BOARD_NATIVE_SIM
+	printf("[mproc]   native_sim: no peer core; skipping reply wait\n");
+#else
+	/* Poll for the reply.  On HiL the mailbox-ISR-driven
+     * callback flips g_state.got_reply within ~1 ms of the
+     * peer's send. */
+	for (int i = 0; i < 100 && !g_state.got_reply; ++i) {
+		alp_delay_ms(10);
+	}
+	if (!g_state.got_reply) {
+		printf("[mproc]   reply timeout (peer not running?)\n");
+		goto teardown;
+	}
+	printf("[mproc] HE replied via mbox callback\n");
+
+	if (g_state.reply_len > MAX_PAYLOAD) g_state.reply_len = MAX_PAYLOAD;
+	char reply_buf[MAX_PAYLOAD + 1];
+	memcpy(reply_buf, (uint8_t *)shmem_base + g_state.reply_offset, g_state.reply_len);
+	reply_buf[g_state.reply_len] = '\0';
+	printf("[mproc] HE replied       \"%s\" (%u bytes)\n", reply_buf, (unsigned)g_state.reply_len);
+#endif
+
+teardown:
+	alp_mbox_close(mbox);
+	alp_shmem_close(shmem);
+
+done:
+	printf("[mproc] done\n");
+	return 0;
+}

tan/templates/vendored/multicore-mailbox/E1M-AEN801/testcase.yaml

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: Apache-2.0
+
+sample:
+  name: mproc-mailbox
+  description: |
+    AEN M55-HP side of a Cortex-M55 mailbox + shared-memory
+    roundtrip via <alp/mproc.h>.  Under native_sim the example
+    exercises the HP-side init + alp_mbox_send framing path and
+    exits cleanly (no peer core to talk to).  Real silicon
+    waits for the peer firmware to echo the payload back.
+common:
+  tags: mproc shmem
+  harness: console
+  harness_config:
+    type: one_line
+    regex:
+      - "\\[mproc\\] done"
+tests:
+  alp_sdk.examples.mproc_mailbox.native_sim:
+    platform_allow: native_sim/native/64
+    extra_args: EXTRA_CONF_FILE=generated/alp.conf CONFIG_ALP_SDK_MPROC=y   # mproc surface is opt-in; the .aen sibling sets it too.
+  alp_sdk.examples.mproc_mailbox.aen:
+    platform_allow:
+      - ensemble_e8_dk/ae822fa0e5597ls0/rtss_he
+    extra_args: EXTRA_CONF_FILE=generated/alp.conf CONFIG_ALP_SDK_MPROC=y
+    build_only: true   # real run needs the peer firmware (v0.4+).

tan/templates/vendored/sensor/E1M-AEN801/CMakeLists.txt

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(i2c_master LANGUAGES C)
+
+target_sources(app PRIVATE src/main.c)

tan/templates/vendored/sensor/E1M-AEN801/README.md

@@ -0,0 +1,112 @@
+# i2c-master
+
+Discrete I2C master that reads a known device at a known
+address.  Pattern: open the bus, init the chip driver, loop
+reading the sensor every second, close cleanly.
+
+Contrasts with [`examples/peripheral-io/i2c-scanner`](https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner) -- the
+scanner *probes* every 7-bit address for ACKs without knowing
+what's behind them; this example *reads* a known sensor.
+
+## What this shows
+
+* `alp_i2c_open()` -- open `BOARD_I2C_SENSORS` at 400 kHz Fast-mode.
+  The `<alp/board.h>` alias resolves to `ALP_E1M_I2C0` on the E1M
+  EVK and `ALP_E1M_X_I2C0` on the E1M-X EVK.
+* `bmp581_init()` -- chip-driver probe (CHIP_ID check).
+* `bmp581_set_sampling()` -- configure oversampling, ODR, and power mode.
+* `bmp581_read_raw()` + `bmp581_compensate()` -- one pressure+temperature read per second.
+* Error handling: NACK on probe -> graceful exit with diagnostic.
+* `bmp581_deinit()` + `alp_i2c_close()` -- clean shutdown.
+
+## Hardware
+
+The BMP581 barometer is the on-board sensor on `BOARD_I2C_SENSORS`
+on both the E1M EVK (U14) and the E1M-X EVK, per
+[`metadata/boards/e1m-evk.yaml`](https://github.com/alplabai/alp-sdk/blob/v0.17.0/metadata/boards/e1m-evk.yaml) and
+[`metadata/boards/e1m-x-evk.yaml`](https://github.com/alplabai/alp-sdk/blob/v0.17.0/metadata/boards/e1m-x-evk.yaml)
+`i2c_devices:`.
+
+7-bit address depends on the SDO strap:
+
+| SDO strap | Address | On this bus                          |
+|-----------|---------|---------------------------------------|
+| VDDIO     | 0x47    | E1M EVK U14 + E1M-X EVK (this default) |
+| GND       | 0x46    | (not populated on these EVKs)          |
+
+Both supported EVKs strap SDO to VDDIO, so `BMP581_ADDR_7BIT`
+works unchanged across them (see
+[`metadata/boards/e1m-evk.yaml`](https://github.com/alplabai/alp-sdk/blob/v0.17.0/metadata/boards/e1m-evk.yaml),
+BMP581 datasheet BST-BMP581-DS004 s5.6, or
+[`include/alp/chips/bmp581.h`](https://github.com/alplabai/alp-sdk/blob/v0.17.0/include/alp/chips/bmp581.h)).
+
+> **#1269:** this example used to target the TMP112 temperature sensor,
+> but TMP112 lives on **BRD_I2C**, not on `BOARD_I2C_SENSORS` -- opening
+> `BOARD_I2C_SENSORS` and probing for TMP112 NACKs on real hardware.
+> BRD_I2C is a separate controller instance regardless (on the E1M-AEN
+> family it is SoC I2C0, function C -- #1848), so simply repointing the bus_id
+> would still not reach a TMP112 there. See
+> [`examples/v2n/v2n-temp-sensor`](https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/v2n/v2n-temp-sensor) for the
+> V2N-only BRD_I2C/TMP112 pattern instead.
+
+## Build
+
+```bash
+# Standalone, native_sim (emul I2C; bmp581_init NACKs cleanly):
+# writes ./generated/alp.conf, which west reads below (#866)
+tan generate --target zephyr-conf --core m55_hp --sdk-root "$ALP_SDK_ROOT" --output generated/alp.conf
+west build -b native_sim/native/64 . \
+    -- -DEXTRA_CONF_FILE=generated/alp.conf -DEXTRA_ZEPHYR_MODULES=$ALP_SDK_ROOT
+west build -t run
+
+# On real silicon, point -b at the SoM's Zephyr board target.
+# Example for E1M-AEN801:
+west build -b alp_e1m_aen801_m55_hp/ae822fa0e5597ls0/rtss_hp . -- -DEXTRA_CONF_FILE=generated/alp.conf
+west flash
+```
+
+## Expected output
+
+Real hardware (BMP581 populated, room temperature, sea-level-ish pressure):
+
+```
+[i2c-master] open BOARD_I2C_SENSORS @ 400 kHz
+[i2c-master] bmp581_init @ 0x47 -> 0 (OK)
+[i2c-master] sample 0: 96234 Pa, 23.625 degC
+[i2c-master] sample 1: 96231 Pa, 23.687 degC
+[i2c-master] sample 2: 96233 Pa, 23.625 degC
+[i2c-master] sample 3: 96230 Pa, 23.687 degC
+[i2c-master] sample 4: 96232 Pa, 23.750 degC
+[i2c-master] done
+```
+
+native_sim (emul I2C, no BMP581 registered):
+
+```
+[i2c-master] open BOARD_I2C_SENSORS @ 400 kHz
+[i2c-master] bmp581_init @ 0x47 -> -5 (populated? right address?)
+[i2c-master] done
+```
+
+## Troubleshooting
+
+* **`bmp581_init -> -5`** (ALP_ERR_IO / NACK).  Either the chip
+  isn't populated on your board, the address is wrong (see
+  table above), or the bus is held low (missing pull-ups, stuck
+  slave).  Run [`examples/peripheral-io/i2c-scanner`](https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner) to confirm what
+  ACKs.
+* **`alp_i2c_open failed`** (NULL return).  The `alp-i2c0` DT
+  alias isn't set -- check your board overlay or, for
+  native_sim, that `CONFIG_EMUL=y CONFIG_I2C_EMUL=y` and the
+  overlay we ship are picked up.
+* **Garbled readings.**  Wrong baud (bitrate) for the bus
+  capacitance.  Drop from 400 kHz to 100 kHz to confirm.
+
+## Reference
+
+- [`<alp/peripheral.h>`](https://github.com/alplabai/alp-sdk/blob/v0.17.0/include/alp/peripheral.h) I2C surface.
+- [`<alp/chips/bmp581.h>`](https://github.com/alplabai/alp-sdk/blob/v0.17.0/include/alp/chips/bmp581.h) -- driver API.
+- [`examples/peripheral-io/i2c-scanner/`](https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner) -- discovery companion.
+- [`examples/peripheral-io/i2c-slave/`](https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-slave) -- slave-mode companion, built on the `alp_i2c_target_*` surface.
+- [`examples/v2n/v2n-temp-sensor/`](https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/v2n/v2n-temp-sensor) -- TMP112-on-BRD_I2C companion, V2N-only.
+- BMP581 datasheet (BST-BMP581-DS004, rev 1.13).

tan/templates/vendored/sensor/E1M-AEN801/board.yaml

@@ -0,0 +1,57 @@
+# board.yaml -- per-app project configuration for the
+# i2c-master example.
+#
+# Reads the BMP581 barometer on BOARD_I2C_SENSORS via the chip-
+# driver header.  Discrete master that talks to a known device at
+# a known address -- contrasts with https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner which
+# probes every 7-bit address for ACKs.
+#
+# Customer workflow: `tan init --from-example peripheral-io/i2c-master`, change `som.sku` to
+# your MPN, edit the `preset:` (or use an inline board) if you're on a non-EVK board,
+# and `tan build`, which plans alp.conf from this file; twister and a bare
+# west build read the pre-generated generated/alp.conf instead
+# (`tan generate --target zephyr-conf`, see README.md).
+som:
+  sku: E1M-AEN801
+
+preset: e1m-evk
+supported_boards:
+  - e1m-evk
+  - e1m-x-evk
+
+# E1M pads this app uses (subset of the EVK preset's `e1m_routes:`).
+pins:
+  - { e1m: E1M_I2C0, macro: EVK_I2C_BUS_SENSORS, doc: "Shared sensor + IO-expander + INA236 bus" }
+cores:
+  m55_hp:
+    app: ./src
+    # Zephyr peripheral subsystem exercised by this example.  The
+    # loader translates the entry to CONFIG_I2C=y in alp.conf.
+    peripherals:
+      - i2c
+
+# BMP581 is populated on every member of the AEN, V2N, V2N-M1
+# families per alp-sdk's metadata/chips/bmp581.yaml (not part of
+# this scaffolded project) -- so this example is Ring 2
+# (chip-bound, multi-family) per
+# alp-sdk's scripts/check_example_portability.py classification
+# (also not part of this scaffolded project).
+#
+# NOTE (#1269): TMP112 was here previously, but TMP112 lives on
+# BRD_I2C, not on BOARD_I2C_SENSORS -- see alp-sdk's
+# metadata/boards/e1m-evk.yaml i2c_devices: and
+# metadata/boards/e1m-x-evk.yaml i2c_devices: (not part of this
+# scaffolded project), neither of which lists a TMP112 on the sensor
+# bus this example opens. BRD_I2C
+# is a SEPARATE controller instance from BOARD_I2C_SENSORS regardless
+# (on the E1M-AEN family, BRD_I2C is SoC I2C0, function C -- #1848), so
+# repointing the bus_id would still not reach a TMP112 there. BMP581 is
+# the part that is actually on BOARD_I2C_SENSORS on both supported
+# boards, at the same address (0x47) on each -- see
+# https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/v2n/v2n-temp-sensor for the V2N-only BRD_I2C/TMP112 pattern
+# instead.
+chips:
+  - bmp581
+
+diagnostics:
+  log_level: info

tan/templates/vendored/sensor/E1M-AEN801/boards/native_sim_native_64.conf

@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# native_sim has no real I2C controller; pull in the emul I2C
+# driver so the bus enumerates at boot and bmp581_init can probe
+# (which returns NACK because no BMP581 is registered -- exactly
+# the path the example's error-handling branch exercises).
+# Auto-loaded by Zephyr when building for native_sim/native/64.
+
+CONFIG_EMUL=y
+CONFIG_I2C_EMUL=y

tan/templates/vendored/sensor/E1M-AEN801/boards/native_sim_native_64.overlay

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2026 Alp Lab AB
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * One emulated I2C bus exposed via the alp-i2c0 alias.  No emul
+ * targets are attached so bmp581_init returns NACK -- but the
+ * open / probe / close path runs end-to-end and the harness
+ * latches on the `[i2c-master] done` marker.
+ */
+
+#include <zephyr/dt-bindings/i2c/i2c.h>
+
+/ {
+    aliases {
+        alp-i2c0 = &i2c0_emul;
+    };
+
+    soc {
+        i2c0_emul: i2c@100 {
+            compatible = "zephyr,i2c-emul-controller";
+            status = "okay";
+            reg = <0 0x100 4>;
+            #address-cells = <1>;
+            #size-cells = <0>;
+            clock-frequency = <I2C_BITRATE_FAST>;
+        };
+    };
+};

tan/templates/vendored/sensor/E1M-AEN801/prj.conf

@@ -0,0 +1,5 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# Intentionally empty.  Every CONFIG_* this app needs is derived
+# from board.yaml by `tan build` and layered in via
+# EXTRA_CONF_FILE (see README.md: `tan generate --target zephyr-conf`).

tan/templates/vendored/sensor/E1M-AEN801/src/main.c

@@ -0,0 +1,186 @@
+/*
+ * Copyright 2026 Alp Lab AB
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * i2c-master -- discrete I2C master that reads a known device at
+ * a known address.
+ *
+ * Pattern: open the bus, init the chip driver, loop reading the
+ * register every second, close cleanly.  Contrasts with
+ * https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner which probes every 7-bit address for ACKs
+ * without knowing what's behind them.
+ *
+ * Hardware: the BMP581 barometer sits on BOARD_I2C_SENSORS on every
+ * E1M and E1M-X EVK, strapped to 7-bit address 0x47 (SDO -> VDDIO)
+ * on both -- see alp-sdk's metadata/boards/e1m-evk.yaml and
+ * metadata/boards/e1m-x-evk.yaml (not part of this scaffolded
+ * project) `i2c_devices:`.  On a brand-new
+ * bring-up you may want to build and run the alp-sdk repo's
+ * https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner example first to confirm which
+ * address ACKs -- it isn't part of this scaffolded project.
+ *
+ * (#1269: this example used to target the TMP112 temperature
+ * sensor, but TMP112 lives on BRD_I2C, not on BOARD_I2C_SENSORS --
+ * opening BOARD_I2C_SENSORS and probing for TMP112 NACKs on real
+ * hardware.  BRD_I2C is a separate controller instance regardless
+ * (on the E1M-AEN family it is SoC I2C0, function C -- #1848), so
+ * simply repointing the bus_id would still not reach a TMP112 there; see
+ * https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/v2n/v2n-temp-sensor for the V2N-only BRD_I2C/TMP112
+ * pattern.)
+ *
+ * What success looks like (real hardware):
+ *
+ *   [i2c-master] open BOARD_I2C_SENSORS @ 400 kHz
+ *   [i2c-master] bmp581_init @ 0x47 -> 0 (OK)
+ *   [i2c-master] sample 0: 96234 Pa, 23.625 degC
+ *   [i2c-master] sample 1: 96231 Pa, 23.687 degC
+ *   ...
+ *   [i2c-master] done
+ *
+ * On native_sim (CI lane) the alp-i2c0 alias maps to the emul I2C
+ * driver -- no BMP581 is registered as a target, so bmp581_init
+ * gets NACKed and the example exits with the diagnostic.  Either
+ * way the [i2c-master] done marker latches the harness.
+ */
+
+#include <stdio.h>
+
+#include "alp/peripheral.h"
+#include "alp/chips/bmp581.h"
+
+/* BOARD_I2C_SENSORS is a portable cross-EVK alias from <alp/board.h>:
+ *   E1M EVK  -> EVK_I2C_BUS_SENSORS  -> ALP_E1M_I2C0
+ *   E1M-X EVK -> XEVK_I2C_BUS_SENSORS -> ALP_E1M_X_I2C0
+ * Rebind it in board.yaml `pins:` to port to another board. */
+#include "alp/board.h"
+
+/* BMP581 7-bit I2C address with SDO -> VDDIO -- the on-board strap
+ * on both the E1M EVK (U14) and E1M-X EVK (see alp-sdk's
+ * metadata/boards/e1m-evk.yaml / e1m-x-evk.yaml, not part of
+ * this scaffolded project, `i2c_devices:`).
+ * SDO -> GND gives 0x46 instead; see the BMP581 datasheet
+ * BST-BMP581-DS004 s5.6 or alp-sdk's include/alp/chips/bmp581.h
+ * (not part of this scaffolded project) if your board straps
+ * differently. */
+#define BMP581_ADDR_7BIT BMP581_I2C_ADDR_HIGH /* 0x47 */
+
+/* Number of samples to take before exiting.  Capped so the
+ * native_sim build doesn't stall the twister harness; real
+ * firmware would loop forever. */
+#define SAMPLE_COUNT 5u
+
+/* Wait between samples.  50 Hz ODR (below) means a fresh reading
+ * every 20 ms; waiting a full second gives a comfortable margin
+ * and prints once per watch-tick which is easy on the eyes. */
+#define SAMPLE_PERIOD_MS 1000u
+
+int main(void)
+{
+	/* Bring up the SDK runtime before anything else -- thin today,
+	 * but future backends rely on it (see <alp/peripheral.h>). */
+	(void)alp_init();
+
+	printf("[i2c-master] open BOARD_I2C_SENSORS @ 400 kHz\n");
+
+	/* Open the bus at 400 kHz (I2C Fast-mode).  BMP581 supports up
+     * to 1 MHz (Fast-mode Plus) per its datasheet, so 400 kHz is
+     * comfortably inside spec; the SDK rounds DOWN to the
+     * controller's closest achievable rate.  100 kHz is the safe
+     * baseline for unknown devices. */
+	alp_i2c_t *bus = alp_i2c_open(&(alp_i2c_config_t){
+	    .bus_id     = BOARD_I2C_SENSORS, /* E1M EVK: ALP_E1M_I2C0; E1M-X EVK: ALP_E1M_X_I2C0 */
+	    .bitrate_hz = 400000,
+	});
+	if (bus == NULL) {
+		/* No alp-i2c0 alias on this build -> NULL handle.
+         *
+         * Common causes:
+         *   * Board overlay forgot to set the alias.
+         *   * SoM has no I2C0 routed (rare -- it's part of the
+         *     portable E1M baseline).
+         *   * On native_sim without the emul overlay we ship,
+         *     the alias is unset. */
+		printf("[i2c-master] open failed: alp_last_error=%d\n", (int)alp_last_error());
+		printf("[i2c-master] done\n");
+		return 0;
+	}
+
+	/* Initialise the BMP581 driver.  This reads CHIP_ID and verifies
+     * it matches BMP581_CHIP_ID -- catches the "wrong address" case
+     * (NACK on probe) up-front.  If init fails the example exits
+     * cleanly -- maybe the chip isn't populated, maybe the address
+     * is wrong, maybe the bus is held low by another device.
+     * https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner can confirm which devices ACK. */
+	bmp581_t     sensor;
+	alp_status_t s = bmp581_init(&sensor, bus, BMP581_ADDR_7BIT);
+	if (s != ALP_OK) {
+		/* Most-frequent failure modes:
+         *   * ALP_ERR_IO   -- bus error or NACK.  No BMP581 here,
+         *                     wrong address, or pull-ups missing
+         *                     (the bus floats high without them).
+         *   * ALP_ERR_INVAL -- bad argument (NULL ctx or NULL bus).
+         *
+         * Use the alp-sdk repo's https://github.com/alplabai/alp-sdk/tree/v0.17.0/examples/peripheral-io/i2c-scanner
+         * example to enumerate what IS on this bus before chasing a
+         * BMP581 that may not be populated. */
+		printf("[i2c-master] bmp581_init @ 0x%02x -> %d "
+		       "(populated? right address?)\n",
+		       BMP581_ADDR_7BIT,
+		       (int)s);
+		alp_i2c_close(bus);
+		printf("[i2c-master] done\n");
+		return 0;
+	}
+	printf("[i2c-master] bmp581_init @ 0x%02x -> %d (OK)\n", BMP581_ADDR_7BIT, (int)s);
+
+	/* Configure oversampling + ODR + power mode in one call.  x8
+     * oversampling at 50 Hz normal mode is a reasonable general-
+     * purpose default; reach for higher OSR when you want lower
+     * noise at the cost of more power/latency. */
+	s = bmp581_set_sampling(
+	    &sensor, BMP581_OSR_X8, BMP581_OSR_X8, BMP581_ODR_50_HZ, BMP581_MODE_NORMAL);
+	if (s != ALP_OK) {
+		printf("[i2c-master] bmp581_set_sampling -> %d\n", (int)s);
+		/* Non-fatal: the chip stays at whatever mode init left it in. */
+	}
+
+	/* Sample loop: read SAMPLE_COUNT pressure+temperature pairs, one
+     * per second.  Real-life firmware would publish each reading
+     * over MQTT, push to a ring buffer for trend analysis, or
+     * compare against an alert threshold and pull a GPIO. */
+	for (uint32_t i = 0; i < SAMPLE_COUNT; i++) {
+		bmp581_raw_t         raw  = { 0 };
+		bmp581_compensated_t comp = { 0 };
+		s                         = bmp581_read_raw(&sensor, &raw);
+		if (s == ALP_OK) {
+			s = bmp581_compensate(&raw, &comp);
+		}
+		if (s == ALP_OK) {
+			/* Format integer + fractional parts so we avoid float
+             * printf on M-class targets.  temperature_c1000 is
+             * signed -- the fractional part takes the absolute
+             * value so e.g. -1750 milli-C prints as "-1.750 degC"
+             * (not "-1.-750 degC"). */
+			int whole = comp.temperature_c1000 / 1000;
+			int frac =
+			    (comp.temperature_c1000 < 0 ? -comp.temperature_c1000 : comp.temperature_c1000) %
+			    1000;
+			printf(
+			    "[i2c-master] sample %u: %d Pa, %d.%03d degC\n", i, comp.pressure_pa, whole, frac);
+		} else {
+			/* Read/compensate errors during steady-state are rare --
+             * usually a transient bus glitch (EMI, ground bounce).
+             * Log and continue rather than aborting; the next
+             * sample will likely succeed. */
+			printf("[i2c-master] sample %u: read -> %d\n", i, (int)s);
+		}
+		alp_delay_ms(SAMPLE_PERIOD_MS);
+	}
+
+	/* Clean shutdown -- deinit the chip driver, then close the bus
+     * handle (which releases the slot back to the pool). */
+	bmp581_deinit(&sensor);
+	alp_i2c_close(bus);
+	printf("[i2c-master] done\n");
+	return 0;
+}

tan/templates/vendored/sensor/E1M-AEN801/testcase.yaml

@@ -0,0 +1,52 @@
+# SPDX-License-Identifier: Apache-2.0
+
+sample:
+  name: i2c-master
+  description: |
+    Per-peripheral example for I2C master.  Reads the on-board
+    BMP581 barometer at a known 7-bit address via
+    BOARD_I2C_SENSORS.  Builds on both EVKs: E1M EVK uses E1M_I2C0;
+    E1M-X EVK uses E1M_X_I2C0.  Contrasts with
+    examples/peripheral-io/i2c-scanner (discovery vs known-address read).
+
+tests:
+  alp_sdk.example.i2c_master.e1m_x_evk:
+    extra_args: EXTRA_CONF_FILE=generated/alp.conf
+    platform_allow:
+      - native_sim
+      - native_sim/native/64
+    integration_platforms:
+      - native_sim/native/64
+    extra_configs:
+      - 'CONFIG_COMPILER_OPT="-DALP_BOARD_E1M_X_EVK"'
+    tags:
+      - alp-sdk
+      - example
+      - i2c
+      - sensors
+      - v2n
+    harness: console
+    harness_config:
+        type: one_line
+        regex:
+          - "\\[i2c-master\\] done"
+  alp_sdk.example.i2c_master.e1m_evk:
+    extra_args: EXTRA_CONF_FILE=generated/alp.conf
+    platform_allow:
+      - native_sim
+      - native_sim/native/64
+    integration_platforms:
+      - native_sim/native/64
+    extra_configs:
+      - 'CONFIG_COMPILER_OPT="-DALP_BOARD_E1M_EVK"'
+    tags:
+      - alp-sdk
+      - example
+      - i2c
+      - sensors
+      - aen
+    harness: console
+    harness_config:
+        type: one_line
+        regex:
+          - "\\[i2c-master\\] done"