tan-cli 0.7.0__py3-none-any.whl

tan/templates/vendored/diagnostics/E1M-V2N101/board.yaml

@@ -0,0 +1,38 @@
+# board.yaml -- per-app project configuration for the
+# board-selftest example.
+#
+# A board bring-up / self-test app: reads the SoM + SoC identity,
+# reads the RUN operating-point profile (core rail + clock), and
+# scans the on-module I2C management bus, then prints a pass/fail
+# report.  Portable <alp/*> APIs only -- no chip driver, so the
+# SAME source runs on every E1M family; the checks degrade
+# gracefully (ALP_ERR_NOSUPPORT) on a backend that lacks a probe.
+#
+# Customer workflow: `tan init --from-example bringup/board-selftest`, 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-V2N101
+
+preset: e1m-x-evk
+supported_boards:
+  - e1m-evk
+  - e1m-x-evk
+
+# E1M pads this app uses (subset of the EVK preset's `e1m_routes:`).
+# The self-test scans this bus for ACKing devices; it is also the
+# bus the SoM EEPROM identity manifest lives on.
+pins:
+  - { e1m: E1M_X_I2C0, macro: XEVK_I2C_BUS_SENSORS, doc: "On-board sensor + IO-expander + INA236 bus (ICM-42670, BMI323, BMP581, TCAL9538, INA236)." }
+cores:
+  m33_sm:
+    app: ./src
+    # Zephyr peripheral subsystem exercised by this example.  The
+    # loader translates the entry to CONFIG_I2C=y in alp.conf.
+    peripherals:
+      - i2c
+
+diagnostics:
+  log_level: info

tan/templates/vendored/diagnostics/E1M-V2N101/boards/native_sim_native_64.conf

@@ -0,0 +1,11 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# native_sim has no real I2C controller; pull in the emul I2C
+# driver so the management bus enumerates at boot and the address
+# scan can probe every 7-bit address (each NACKs because no target
+# is registered -- so the scan reports 0 devices, which is still a
+# PASS of the scan machinery).  Auto-loaded by Zephyr when building
+# for native_sim/native/64.
+
+CONFIG_EMUL=y
+CONFIG_I2C_EMUL=y

tan/templates/vendored/diagnostics/E1M-V2N101/boards/native_sim_native_64.overlay

@@ -0,0 +1,29 @@
+/*
+ * 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 every address in the scan NACKs -- but
+ * the open / probe-loop / close path runs end-to-end and the
+ * harness latches on the `[selftest] done` marker.  The identity
+ * and power checks have no native_sim backend and report SKIP.
+ */
+
+#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_STANDARD>;
+        };
+    };
+};

tan/templates/vendored/diagnostics/E1M-V2N101/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/diagnostics/E1M-V2N101/src/main.c

@@ -0,0 +1,266 @@
+/*
+ * Copyright 2026 Alp Lab AB
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * board-selftest -- power-on board bring-up / self-test.
+ *
+ * The app a customer runs FIRST on a freshly-assembled board,
+ * before chasing a peripheral that "doesn't work".  It answers the
+ * four questions every bring-up starts with:
+ *
+ *   1. Is this the SoM I think it is?   (on-module EEPROM identity)
+ *   2. Is the silicon alive + answering? (SoC secure-firmware ping)
+ *   3. Is the core rail/clock sane?      (RUN operating-point profile)
+ *   4. What's actually on the I2C bus?   (7-bit address scan)
+ *
+ * ...and prints a single pass/fail line so a field tech can read
+ * "3 PASS, 1 SKIP, 0 FAIL" off a serial console without a debugger.
+ *
+ * Portability: this uses ONLY portable <alp/...> APIs -- no chip
+ * driver, no vendor header -- so the SAME source builds and runs on
+ * every E1M family (Ring 1).  Each check that a given backend can't
+ * service returns @ref ALP_ERR_NOSUPPORT, which the self-test
+ * reports as SKIP (not FAIL): "this backend has no probe for this",
+ * not "the hardware is broken".  That distinction is the whole point
+ * of a self-test -- a missing capability and a fault must not look
+ * alike.
+ *
+ * What success looks like (real hardware, E1M-V2N101):
+ *
+ *   [selftest] === board self-test ===
+ *   [selftest] SoM identity: E1M-V2N101 rev r1 sn <factory-serial> -> PASS
+ *   [selftest] SoC identity: renesas:rzv2n:n44 (secure-fw OK) -> PASS
+ *   [selftest] power profile: RUN core 800 mV @ 400 MHz -> PASS
+ *   [selftest] i2c scan BOARD_I2C_SENSORS: probing 0x08..0x77
+ *   [selftest]   found device @ 0x48
+ *   [selftest] i2c scan BOARD_I2C_SENSORS: 1 device(s) -> PASS
+ *   [selftest] result: 4 PASS, 0 SKIP, 0 FAIL
+ *   [selftest] done
+ *
+ * On native_sim (CI lane): the SoC and power controllers have no
+ * backend, so checks 2-3 return ALP_ERR_NOSUPPORT and report SKIP.
+ * The emul I2C bus IS up (so check 1 talks to it) but no EEPROM
+ * target is registered, so alp_hw_info_read returns
+ * ALP_ERR_NOT_READY -- a genuine "identity manifest unreadable"
+ * fault, reported as FAIL (the check can't tell "no EEPROM here"
+ * from "broken EEPROM"; on real silicon a NAKing manifest IS a
+ * fault).  The scan then walks the empty bus and PASSes with 0
+ * devices.  The `[selftest] done` marker latches the harness
+ * regardless of the verdict.
+ */
+
+#include <stdint.h>
+#include <stdio.h>
+
+#include "alp/hw_info.h"
+#include "alp/peripheral.h"
+#include "alp/power.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"
+
+/* 7-bit I2C address scan window.  0x00..0x07 and 0x78..0x7F are
+ * reserved by the I2C spec (general-call, 10-bit prefixes, etc.);
+ * probing them is meaningless, so a scan walks 0x08..0x77 -- the
+ * same window i2cdetect uses by default. */
+#define I2C_SCAN_FIRST_ADDR 0x08u
+#define I2C_SCAN_LAST_ADDR  0x77u
+
+/* Per-check verdict.  SKIP is deliberately distinct from FAIL: a
+ * backend that has no probe for a capability (ALP_ERR_NOSUPPORT)
+ * has not FAILED the board -- it simply cannot answer.  A field
+ * tech reading the report must not confuse the two. */
+typedef enum {
+	CHECK_PASS = 0,
+	CHECK_SKIP = 1,
+	CHECK_FAIL = 2,
+} check_result_t;
+
+/* Running tally, printed as the last report line. */
+typedef struct {
+	unsigned pass;
+	unsigned skip;
+	unsigned fail;
+} tally_t;
+
+/* Fold one check's verdict into the tally. */
+static void tally_add(tally_t *t, check_result_t r)
+{
+	switch (r) {
+	case CHECK_PASS:
+		t->pass++;
+		break;
+	case CHECK_SKIP:
+		t->skip++;
+		break;
+	default:
+		t->fail++;
+		break;
+	}
+}
+
+/* Map a status the identity/power checks return onto a verdict.
+ * NOSUPPORT means "no probe on this backend" -> SKIP; any other
+ * non-OK means the probe existed but the read went wrong -> FAIL. */
+static check_result_t verdict_from_status(alp_status_t s)
+{
+	if (s == ALP_OK) {
+		return CHECK_PASS;
+	}
+	if (s == ALP_ERR_NOSUPPORT) {
+		return CHECK_SKIP;
+	}
+	return CHECK_FAIL;
+}
+
+/* Check 1 -- SoM identity from the on-module EEPROM manifest.
+ * A blank EEPROM (NOT_PROVISIONED), a NAKing/absent one (NOT_READY),
+ * or a corrupt one (IO) is a real fault on hardware, reported as
+ * FAIL.  Only NOSUPPORT -- no EEPROM bus configured on this build at
+ * all -- is a SKIP.  On native_sim the emul bus is up but carries no
+ * EEPROM target, so this returns NOT_READY and FAILs; that is
+ * honest (native_sim genuinely has no identity manifest), and the
+ * done-marker still latches. */
+static check_result_t check_som_identity(void)
+{
+	alp_hw_info_t info;
+	alp_status_t  s = alp_hw_info_read(&info);
+	if (s == ALP_OK) {
+		printf("[selftest] SoM identity: %s rev %s sn %s -> PASS\n",
+		       info.som_sku,
+		       info.som_hw_rev,
+		       info.som_serial);
+		return CHECK_PASS;
+	}
+	/* NOT_PROVISIONED / IO / NOT_READY are genuine board faults;
+	 * NOSUPPORT is "no EEPROM bus on this build" (e.g. native_sim). */
+	printf("[selftest] SoM identity: unreadable (%s) -> %s\n",
+	       alp_status_name(s),
+	       s == ALP_ERR_NOSUPPORT ? "SKIP" : "FAIL");
+	return verdict_from_status(s);
+}
+
+/* Check 2 -- SoC liveness + identity.  The ping proves the secure /
+ * system-controller firmware answers before we trust any identity
+ * read; soc_ref is always populated (it's a build-time constant), so
+ * we print it even when the runtime query can't reach the
+ * controller. */
+static check_result_t check_soc_identity(void)
+{
+	alp_status_t ping = alp_soc_secure_fw_ping();
+
+	alp_soc_info_t soc;
+	alp_status_t   s = alp_soc_info_read(&soc);
+	if (s == ALP_OK) {
+		printf("[selftest] SoC identity: %s (secure-fw %s) -> PASS\n",
+		       soc.soc_ref,
+		       soc.secure_fw_version);
+		return CHECK_PASS;
+	}
+	/* soc_ref is filled even on NOSUPPORT, so name the silicon
+	 * regardless -- it's the single most useful line for "did I
+	 * flash the firmware for the right chip?". */
+	printf("[selftest] SoC identity: %s (ping %s, read %s) -> %s\n",
+	       soc.soc_ref,
+	       alp_status_name(ping),
+	       alp_status_name(s),
+	       s == ALP_ERR_NOSUPPORT ? "SKIP" : "FAIL");
+	return verdict_from_status(s);
+}
+
+/* Check 3 -- read the RUN operating-point profile.  This is a
+ * read-only mailbox round-trip on SoCs whose power tree lives behind
+ * a controller; it never changes the live operating point (that's
+ * alp_power_profile_set, which we deliberately do NOT call in a
+ * self-test).  A zero field means "not reported", which is fine. */
+static check_result_t check_power_profile(void)
+{
+	alp_power_profile_t prof;
+	alp_status_t        s = alp_power_profile_get(ALP_POWER_PROFILE_RUN, &prof);
+	if (s == ALP_OK) {
+		/* cpu_clk_hz is Hz; print MHz for readability.  Integer
+		 * division is fine -- a self-test wants "roughly 400 MHz",
+		 * not sub-Hz precision. */
+		printf("[selftest] power profile: RUN core %u mV @ %u MHz -> PASS\n",
+		       prof.rail_mv,
+		       prof.cpu_clk_hz / 1000000u);
+		return CHECK_PASS;
+	}
+	printf("[selftest] power profile: unavailable (%s) -> %s\n",
+	       alp_status_name(s),
+	       s == ALP_ERR_NOSUPPORT ? "SKIP" : "FAIL");
+	return verdict_from_status(s);
+}
+
+/* Check 4 -- scan the management I2C bus for ACKing devices.
+ * A 1-byte read is the least-intrusive probe: a present device
+ * ACKs its address (ALP_OK), an empty address NACKs (ALP_ERR_IO).
+ * We don't interpret the byte -- only the ACK matters for presence.
+ *
+ * Verdict policy: the SCAN itself passing/failing is about whether
+ * the BUS works, not about how many devices answered.  Zero devices
+ * on native_sim (no emul targets attached) is still a PASS of the
+ * scan machinery; a NULL bus handle (alias unset / no controller)
+ * is the SKIP/FAIL case. */
+static check_result_t check_i2c_bus(void)
+{
+	alp_i2c_t *bus = alp_i2c_open(&(alp_i2c_config_t){
+	    .bus_id     = BOARD_I2C_SENSORS,
+	    .bitrate_hz = 100000, /* 100 kHz -- the safe baseline for a bus
+	                             whose device mix we don't yet know. */
+	});
+	if (bus == NULL) {
+		/* No alp-i2c0 alias / no controller on this build. */
+		alp_status_t s = alp_last_error();
+		printf("[selftest] i2c scan BOARD_I2C_SENSORS: open failed (%s) -> %s\n",
+		       alp_status_name(s),
+		       s == ALP_ERR_NOSUPPORT ? "SKIP" : "FAIL");
+		return s == ALP_ERR_NOSUPPORT ? CHECK_SKIP : CHECK_FAIL;
+	}
+
+	unsigned found = 0;
+	printf("[selftest] i2c scan BOARD_I2C_SENSORS: probing 0x%02x..0x%02x\n",
+	       I2C_SCAN_FIRST_ADDR,
+	       I2C_SCAN_LAST_ADDR);
+	for (uint8_t addr = I2C_SCAN_FIRST_ADDR; addr <= I2C_SCAN_LAST_ADDR; addr++) {
+		uint8_t      byte = 0;
+		alp_status_t s    = alp_i2c_read(bus, addr, &byte, sizeof(byte));
+		if (s == ALP_OK) {
+			printf("[selftest]   found device @ 0x%02x\n", addr);
+			found++;
+		}
+	}
+
+	alp_i2c_close(bus);
+	printf("[selftest] i2c scan BOARD_I2C_SENSORS: %u device(s) -> PASS\n", found);
+	return CHECK_PASS;
+}
+
+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("[selftest] === board self-test ===\n");
+
+	tally_t t = { 0 };
+	tally_add(&t, check_som_identity());
+	tally_add(&t, check_soc_identity());
+	tally_add(&t, check_power_profile());
+	tally_add(&t, check_i2c_bus());
+
+	/* One machine-readable summary line.  A test harness or a field
+	 * script greps this; a human reads the per-check lines above. */
+	printf("[selftest] result: %u PASS, %u SKIP, %u FAIL\n", t.pass, t.skip, t.fail);
+
+	/* The `done` marker latches the twister console harness
+	 * regardless of the verdict -- a self-test that FAILS is still a
+	 * successful RUN of the self-test.  Real firmware might instead
+	 * pull a GPIO or refuse to continue booting on a FAIL. */
+	printf("[selftest] done\n");
+	return 0;
+}

tan/templates/vendored/diagnostics/E1M-V2N101/testcase.yaml

@@ -0,0 +1,53 @@
+# SPDX-License-Identifier: Apache-2.0
+
+sample:
+  name: board-selftest
+  description: |
+    Board bring-up / self-test.  Reads the SoM + SoC identity, reads
+    the RUN operating-point profile, and scans the on-module I2C
+    management bus, then prints a pass/fail report.  Portable
+    <alp/*> APIs only -- no chip driver -- so the same source runs
+    on every E1M family.  On native_sim the identity/power checks
+    have no backend and report SKIP; the emul I2C bus scans clean.
+
+tests:
+  alp_sdk.example.board_selftest.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
+      - bringup
+      - selftest
+      - v2n
+    harness: console
+    harness_config:
+        type: one_line
+        regex:
+          - "\\[selftest\\] done"
+  alp_sdk.example.board_selftest.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
+      - bringup
+      - selftest
+      - aen
+    harness: console
+    harness_config:
+        type: one_line
+        regex:
+          - "\\[selftest\\] done"

tan/templates/vendored/edge-ai/E1M-AEN801/CMakeLists.txt

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

tan/templates/vendored/edge-ai/E1M-AEN801/README.md

@@ -0,0 +1,75 @@
+# cold-chain-monitor
+
+> **`[UNTESTED]` on hardware -- v0.9 paper-correct.** The `cold_chain` core
+> is host-unit-tested on `native_sim/native/64`; the full app runs end-to-end on
+> native_sim with synthetic environment data covering the states. HiL with a
+> real BME280 + a trained model is bench-gated.
+
+A pharma/food **cold-chain integrity monitor**: sample a BME280 T/RH/P sensor on
+a slow logging cadence, compute the standards-backed metrics (temperature
+excursion time, Mean Kinetic Temperature, dewpoint), classify the integrity
+state, and emit an AI anomaly score. The *environmental* edge-AI vertical.
+
+## Honest scope
+
+A reference cold-chain logger. MKT, dewpoint, and excursion-time are the real,
+recognized metrics; thresholds are configurable per product. **NOT** a certified
+GxP / 21-CFR-Part-11 data logger -- no validated audit trail, no calibration
+traceability, no tamper-proof storage.
+
+## Standards-backed metrics
+
+- **MKT** (Mean Kinetic Temperature, ICH Q1A / USP <1079>): the single
+  temperature delivering the same cumulative thermal stress as the fluctuating
+  profile. `MKT >= arithmetic mean`, so a brief hot spike counts for more than
+  its duration -- which is the whole point.
+- **Dewpoint** (Magnus): condensation / mould risk when ambient T nears it.
+
+## Pipeline
+
+```
+BME280 (I2C) --window--> cold_chain (mean/min/max, MKT, dewpoint, excursion)
+  -> cc_classify (OK / TEMP_EXCURSION / MKT_EXCEEDED / CONDENSATION_RISK)
+  -> <alp/inference.h> anomaly score (deterministic fallback) -> CC record
+```
+
+## Output
+
+```
+# CC,t_s,state,temp_c,rh_pct,dewpoint_c,mkt_c,excursion_min
+CC,256.0,OK,5.0,50.0,-4.6,5.0,0.0
+CC,768.0,CONDENSATION_RISK,5.0,95.0,4.3,5.0,0.0
+```
+
+## Build
+
+```
+# 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 alp_e1m_aen801_m55_hp/ae822fa0e5597ls0/rtss_hp . -- -DEXTRA_CONF_FILE=generated/alp.conf
+west flash
+```
+
+For the DEEPX DX-M1 path, re-scaffold rather than edit: `tan init --template
+edge-ai-starter --som E1M-V2M101`. Flipping `som.sku` alone leaves `preset:`,
+`cores:` and `pins:` pinned to this module (`e1m-evk`, which does not host
+the `renesas-rzv2n-deepx` family) and `tan validate` refuses it.
+
+## Model
+
+<!-- The ../cold-chain-monitor/ detour is deliberate: the scaffold
+     rewriter's _RELATIVE_LINK_RE only matches `../`-prefixed links, and
+     models/ is a child of this dir, not a sibling -- don't "fix" this. -->
+
+No model is shipped (stub + deterministic classifier/fallback). See
+[`models/README.md`](https://github.com/alplabai/alp-sdk/blob/v0.17.0/examples/ai/cold-chain-monitor/models/README.md) for the
+autoencoder training recipe.
+
+## Tests
+
+In the alp-sdk tree, unit tests live in
+[`tests/unit/cold_chain`](https://github.com/alplabai/alp-sdk/tree/v0.17.0/tests/unit/cold_chain) and run with:
+
+```
+twister -p native_sim/native/64 -T tests/unit/cold_chain
+```

tan/templates/vendored/edge-ai/E1M-AEN801/board.yaml

@@ -0,0 +1,38 @@
+# board.yaml -- cold-chain integrity monitor.
+#
+# A low-power M55 node reads the on-board BME280 temperature/humidity/pressure
+# sensor on a slow logging cadence, computes the cold-chain metrics (MKT,
+# dewpoint, excursion time), and classifies the integrity state.  The V2N
+# DEEPX path is a separate scaffold (--som E1M-V2M101), not a som.sku flip
+# here -- see this project's README.
+
+libraries:
+  - name: tflite-micro
+    cores: [m55_hp]
+
+som:
+  sku: E1M-AEN801
+
+preset: e1m-evk
+supported_boards:
+  - e1m-evk
+  - e1m-x-evk
+
+pins:
+  - { e1m: E1M_I2C0, macro: EVK_I2C_BUS_SENSORS, doc: "BME280 environment sensor bus" }
+
+cores:
+  a32_cluster:
+    os: "off"
+  m55_hp:
+    app: ./src
+    inference:
+      default_arena_kib: 64
+    peripherals:
+      - i2c                   # BME280 link.
+
+chips:
+  - bme280                    # temperature / humidity / pressure.
+
+diagnostics:
+  log_level: info

tan/templates/vendored/edge-ai/E1M-AEN801/prj.conf

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+CONFIG_MAIN_STACK_SIZE=16384
+
+CONFIG_LOG=y
+CONFIG_LOG_PRINTK=y
+CONFIG_CBPRINTF_FP_SUPPORT=y
+
+CONFIG_ALP_SDK_INFERENCE_BACKEND_TFLM=y