Alp SDK · v0.16.0 · released 2026-08-23
One declarative file. Heterogeneous build.
Same C/C++ API across Alif, Renesas, DeepX. Set the module SKU; the SDK produces a dual-image build for every heterogeneous SoM — Yocto on the A-cluster, Zephyr on the M-class companion, IPC stitched in. It runs on every E1M edge AI module and implements the open E1M standard.
§ One file, every module
The same board.yaml drives every E1M build.
One declarative config. Swap the module SKU and the build target re-routes — same C/C++ API on the other side. No per-module forks, no parallel BSP trees.
- → Single schema across Alif, Renesas, DeepX
- → Per-core cores.<id> scoping — apps + peripherals inline
- → Silicon facts live in the SoM preset, not your project
- → Pin routing in SoM + carrier preset YAML — apps use E1M_<NAME> aliases
- → Build, flash, debug — three commands
Click the card to pause.
$ tan build # som.sku: E1M-V2N101
→ resolving E1M-X V2N preset · ok
→ building a55_cluster (yocto) · 4m 12 s
→ building m33_sm (zephyr) · 8 s
$ tan flash
→ device: E1M-X V2N (s/n a3-12)
→ rootfs + m33 image · 100% (38 s)
$ tan monitor --port /dev/ttyUSB0
→ a55_cluster boot banner · console live# One declarative file. Heterogeneous build.
som:
sku: E1M-V2N101
hw_rev: r1
preset: e1m-x-evk
cores:
a55_cluster:
app: ./linux
image: alp-image-edge
peripherals: [ethernet, usb, emmc]
libraries: [mbedtls, nlohmann_json]
iot: { wifi: true, mqtt: true }
m33_sm:
app: ./m33
peripherals: [adc, pwm, i2c, gpio]
libraries: [cmsis_dsp]
ipc:
- kind: rpmsg
endpoints: [a55_cluster, m33_sm]
carve_out_kb: 512
diagnostics:
log_level: info
# run via the tan CLI front door:
build: tan build # som.sku: E1M-V2N101
flash: tan flash
reflash: tan flash # core: a55_cluster§ The Alp SDK stack
Write once, run on any E1M module.
Alp SDK is the unification software layer for Alp Lab edge AI modules. A single C/C++ API works across every E1M SoM — present and future — wrapping each vendor's SDK on top of the chosen OS (Zephyr / Yocto / bare-metal). Single-OS or heterogeneous, the application surface stays identical.
AI Framework
On-device inference
On-device runtimes
Model families
Offline training only
Dev Tooling
Build, orchestrate, flash
v0.16.0Alp SDK
One unified <alp/*.h> API
Peripherals
Audio
Camera
Inference
IoT / BLE
Security
Display / GUI
HW Info
DSP / Power
Heterogeneous IPC (v0.6 NEW)
80 Tier-1 chip drivers + Tier-2 community
User libraries (board.yaml libraries:)
Operating System
Per-core slice (cores: in board.yaml) · heterogeneous = peers on same SoM
Zephyr · M-class cores

Yocto · A-class cores

Bare-metal · no-RTOS
Vendor SDK
We wrap each one
Hardware + HAL
E1M open-standard form factor
Standalone firmware against <alp/...> headers, or alp-studio codegen — same API surface either way.
§ Release notes
What just shipped.
Alp SDK ships in monthly cuts. Each release is signed, tagged on GitHub, and documented with a migration note if anything moves.
- v1.0after first pilotPlanned
Silicon-verified release · ABI freeze
- HiL bring-up sweep across AEN + V2N101 + V2M101
- ABI snapshot frozen — backwards-compat guarantee
- Concurrent multi-NPU (DRP-AI3 + DEEPX) proven on V2M101
- Mender OTA E2E on V2N101 fleet of N ≥ 3 boards
- 4 vertical reference apps end-to-end verified
- v0.16.02026-08-23 · releasedShipped
Renode retired — hardware or native_sim, nothing in between · CC3501E firmware v0.3.0 · non-Debian Linux hosts get a runnable install command
- Renode is retired outright (#1502, ADR 0022 Amendment 2): the tan renode verb, the four pr-renode-* CI workflows, the Alif E8 and RZ/V2N platform models and fixtures, and the aen-sim-vision example are all deleted, along with every live doc claim. What to do instead: build and flash to real hardware (tan build + tan flash), or run a single image headless under native_sim with tan run when it has no cross-core dependency. There is no simulated substitute for the cross-core RPMsg handshake — that must be verified on silicon. The cost is stated plainly in the SDK’s own changelog: alp-sdk loses its pre-silicon simulator coverage with no replacement planned, and no CI job now boots any alp-sdk image on any core. board.yaml’s diagnostics.sim_console is retained everywhere — it serves alp-studio’s hardware simulator, which never was a Renode concern
- CC3501E companion firmware v0.3.0 on wire protocol 4 is the first published prebuilt blob to carry OTA_PROMOTE (#1609), shipped signed (detached ECDSA-P256/SHA-256) with its .sha256, and all six AEN SoM presets now point at it. It lands with the bench-found fixes it needed: GET_DIAG_INFO reports the real Wi-Fi role and heap instead of two fields that lied, the soft-AP no longer runs with the NWP left in ELP (#1562), WIFI_AP_STOP moved its blocking radio teardown off the SPI ISR context (#1563), wifi connect / wifi ap refuse wpa3 with an empty passphrase rather than silently downgrading to WPA2-PSK (#1480, #1552), and cc3501e_wifi_connect() stopped debiting a phantom 100 ms on every healthy poll, which had been collapsing timeout_ms to roughly a third of what was asked (#1481)
- A Fedora, Rocky or Arch host was handed sudo apt-get install -y … verbatim in the machine-readable field the VS Code extension consumes — a command it cannot run (#1464). metadata/bootstrap.json’s prerequisites.install.linux is now keyed by package manager: apt stays required-and-complete, dnf is new and proven, and pacman ships no entry at all rather than an unattended pacman -S against a stale sync database. Every shipped entry was proven by running it in a real container (fedora:42, rockylinux:9, debian:12 control) and confirming the binary landed on PATH; a new workflow re-runs that proof on every relevant PR. dnf deliberately carries no ninja: the RHEL-derivative default repos carry it under no name, so nothing was guessed
- A CPU inference floor for the Cortex-A55 lands via ONNX Runtime (src/yocto/inference_ort.cpp), default-off behind ALP_SDK_USE_ORT_CPU and ordered strictly last in backend auto-resolution. The Yocto recipe builds — bitbake onnxruntime completes against E1M-V2N101, 997 tasks, producing libonnxruntime.so.1.28.0 for cortexa55 — but a green build is not a working inference and no SKU has run ORT on silicon yet. It is 🟡 code-complete / bench-unverified in docs/verification-status.md, which now parses 84 ledger rows (11 ✅ verified, 35 🟡 partial, 39 ⏳ untested, 1 ❌ failing)
- New public accessor alp_inference_last_invoke_latency_us() (#1541): alp_inference_invoke() now brackets the backend’s synchronous executor in both dispatchers and stores the last successful invoke’s duration in microseconds, replacing the hand-rolled k_cycle_get_32() timing the two in-tree camera-vision harnesses each carried. A failed invoke never updates the value; on Zephyr the reading saturates at UINT32_MAX - 1 µs rather than wrapping, so ALP_ERR_NOT_READY means only “no successful invoke yet”, never “too slow to report”
- AEN flash-path corrections. E1M-AEN401 / AEN601 m55_hp board trees still carried the pre-#1445 symmetric slot0, so the planner published a slot0_load_address of 0x802b0000 for an image linked at 0x80010000 (#1482). Three AEN bench flash scripts wrote MRAM, never read their own verifybin result, and exited 0 on a failed flash (#1488, #1478). A storage[].flash_device: naming an AEN MRAM sub-region resolved and decorated a Devicetree label the board tree never defines (#1484), and orchestrate now refuses status: ok on an unverified dt_label (#1556). On real E8 silicon the on-SoM DP83825 answers at MDIO address 0, not the 1 the devicetree declared (#1244)
- Supply-chain and CI hardening across the workflow tree: three workflows spliced externally-chosen GitHub Actions context into unguarded run: blocks — a template injection reachable from a fork PR (#1475) — and the gate that now blocks it was widened to cover actions/github-script’s with: script: sink too (#1529). Every Action uses: is pinned to a commit SHA with a gate and a bump path (#1479), every actions/checkout stopped persisting the run’s GITHUB_TOKEN into local git config, every workflow job carries a runtime cap (#1477), apt-get’s total time is bounded after a trickling mirror hung CI for roughly 11 hours (#1575), and shellcheck widened from scripts/bench/** to every shipped .sh file (#1550)
- The model & edge-AI lifecycle design record lands ahead of the code it plans (#933): two specs and eight implementation plans for check / envelope / zoo / prep / measure / tflite-convert plus their tan and VS Code counterparts, published under docs/superpowers/. Design only — no code, no metadata, no schema, no public header changes — landed on its own so ~3,800 lines of design reasoning stop being reachable only through a 77-file conflicting integration PR
- Alongside it, tan-cli cut v0.6.0 (2026-08-24) — the release a default install actually produces, since v0.6.0-rc1 shipped as a GitHub pre-release that install.sh / install.ps1 never resolved. It requires alp-sdk v0.16.0 or newer, and its planner mirror and vendored fixtures are pinned to that release tag rather than to a dev commit for the first time
- v0.15.02026-08-07 · releasedShipped
AEN801 dual-core flash release-blocker fixed · DRP-AI3 reachable from <alp/inference.h> · four real Yocto backends
- Release-blocker: on E1M-AEN801 the M55-HP and M55-HE images both linked to slot0 0x80010000, so flashing both cores silently overwrote one image (#1069). Alongside it, alp_mproc_boot_core()’s image-residency precondition and a direction-specific M55-HP TCM-invalidation erratum are documented from E8 bench evidence (#1070), and a new aen-dualcore-he-master example (HE-master → HP-peer) is silicon-proven as of 2026-08-01
- CONFIG_DCACHE=n is fixed across eight AEN dual-core / SRAM0-beacon examples that were silently exposed to cross-core cache incoherence, and five AEN examples stopped mis-reporting ALP_ERR_NOSUPPORT as an unreachable-in-practice SKIP (#1071)
- The RZ/V2N on-die DRP-AI3 NPU is reachable from <alp/inference.h> as an opt-in backend (#1145), and libalp_sdk’s own link now refuses undefined symbols instead of deferring the failure to the consuming app
- Real Yocto/Linux backends land for <alp/display.h> and <alp/i3c.h> (#1143, #1147) and for <alp/storage.h> and <alp/usb.h> (#1140, #1141) — the Linux leg of four portable classes that previously had a Zephyr backend only
- Security and concurrency hardening: two path-traversal bugs in tan model build and in untrusted template catalogs (#1125, #1126); flash-backend path traversal plus script command injection (#1112, #1113); the CC3501E Wi-Fi/BLE/GPIO/OTA backends had shared one unlocked transport (#1116); five memory-safety defects in the AEN Zephyr drivers (#1119–#1122, #1124); signed-left-shift UB in SHA-256 word assembly (#1117); and an alp_handle_begin_close() busy-spin that could deadlock under priority scheduling (#1114)
- ALP_CAP_HW_ETHERNET read false on V2N/V2M despite two 1 GbE ports (#1240). Two ADRs pin the surrounding stance: ADR 0023 keeps Ethernet out of <alp/*> (the portable contract is ALP_SOC_ETHERNET_COUNT plus the port identity and the rtl8211fdi PHY driver, not a new <alp/net.h>), and ADR 0024 keeps ADC, PWM, DAC, counter and qenc on V2N/V2M served exclusively by the GD32 IO-MCU bridge
- Gate and tooling integrity: an hw_rev that exists but is status: reserved / tbd / status-less is now refused (#1025, the status half); scripts/gen_rzv2n_cm33_svd.py projects a cross-validated CMSIS-SVD register view for the RZ/V2N CM33 that Renesas ships no SVD for (#1029); test-all.sh had been running 1 of 34 required gate scripts on Windows (#1109); and the macOS and Windows CI legs can now actually fail the PR
- v0.14.02026-07-29 · releasedShipped
Portable I3C controller class · bootstrap facts as data · the hw_rev / SDK-version gate finally exists
- New portable <alp/i3c.h> MIPI I3C Basic controller surface ([ABI-EXPERIMENTAL]): alp_i3c_open / write / read / write_read / close / capabilities, with a Zephyr backend over upstream i3c_dw.c on the Alif Ensemble E8 (lpi3c0). Controller init is bench-proven on E1M-AEN801 (Flow C RAM-run, 2026-07-25); a live transfer is still unproven. I3C joins the portable-API conformance suite
- metadata/bootstrap.json and metadata/toolchains.json single-source the cross-platform bootstrap facts and the Zephyr-SDK toolchain pin as data, with prerequisites.install as the one place host-tool install commands are written (#949) — replacing the same facts hardcoded across several bootstrap scripts
- The hw_rev / SDK-version compatibility gate now exists (#1019). The docs had been advertising a gate that had never been implemented; that claim was first removed, then made true — an out-of-range revision now raises SdkRevisionUnsupported and validate_board_yaml.py exits 3, and an hw_rev absent from the resolved table raises SdkRevisionUnknown (exit 4) instead of silently building against the wrong hardware
- One first command: README.md and docs/getting-started.md now lead with tan bootstrap, matching tan’s own quickstart
- Alif E8 silicon work: gpio11..gpio14 added to the peripherals dtsi so the RGB LED’s green and blue channels are reachable; a DesignWare GPIO functional-clock enable driver (gpio_clk_alif.c) and an OSPI0 clock-enable fix in flash_ospi_alif.c that had reproduced a bus fault on E8 (both ADR 0017 Tier-1.5); and E8 builds now default to the real SoC capability profile rather than the permissive one
- Zephyr v4.4.0 → v4.4.1 patch bump; E8 SoC peripheral coverage extended to I3C, OSPI/HexSPI and managed-MDIO (build-only); Alif Ensemble peripheral counts re-ingested from the DFP with provenance recorded for counts that are inherited rather than audited (#936); and debug-probe identity (jlink_device, jlink_flash_device, pyocd_target) added to the Alif Ensemble SoC specs (#987)
- Four V2N/V2M SoM manifests had promised a gd32_bridge firmware path that exists in no clone (#852) — the build now refuses cleanly when a GD32 bridge image is absent instead of failing later and further away
Earlier releases (12)
- v0.13.02026-07-24 · releasedCC3501E BLE GATT on real AEN silicon · Yocto power backend · Kconfig LSP feed
- v0.12.02026-07-22 · releasedADR-0020 — the SDK is plans-only, tan is the sole build executor
- v0.11.02026-07-16 · releasedCorrectness release — the Yocto image bakes end to end
- v0.10.12026-07-14 · releasedBootstrap fix — west alp-build resolves after setup
- v0.10.02026-07-14 · releasedPortable display path · GD32 OTA hardening · reproducible releases
- v0.9.02026-07-06 · releasedPortable-surface consistency · the alp CLI single front door
- v0.8.12026-06-24 · releasedSilicon-accuracy doc sweep — two SoM families now carry evidence
- v0.8.02026-06-24 · releasedE1M-AEN801 (Alif Ensemble E8) silicon bring-up · second verified SoM family
- v0.7.02026-06-12 · releasedProduction Yocto image · per-core OS topology contract
- v0.6.02026-06-06 · releasedHeterogeneous-OS orchestration · first silicon evidence on V2N
- v0.5.02026-04Wave-2 DSP / power / 2D-accelerator surfaces
- v0.4.02026-03 · prep mergedYocto first-class · secure boot + OTA prep
Full notes for these cuts live in the repo's CHANGELOG.md — see “Full changelog on GitHub” above.
§ Two ways to consume
Hand-written firmware, or generated from a GUI.
Both first-class.
The standalone path isn't a studio escape hatch — anything alp-studio can emit, you can write by hand against the same <alp/...> headers.
Standalone firmware
Hand-written C against <alp/...>
Write a Zephyr, Yocto, or bare-metal app directly. Pick instance IDs by hand from <alp/e1m_pinout.h> — ALP_E1M_I2C0, ALP_E1M_PWM3, and so on. Your app stays portable across every E1M-conformant SoM. Capability validation runs at runtime in*_open; alp_last_error() tells you why an open failed.
alp-studio codegen
GUI configurator that emits the same C
Studio reads block manifests, runs the pin allocator over the active SoM's manifest, and emits C that calls the same <alp/...> API the hand-written path uses. Pin-allocation correctness for free, with drop-in dropdowns for every MPN and board.
§ Get started
git clone https://github.com/alplabai/alp-sdk
cd alp-sdk
bash scripts/bootstrap.sh # west + Python + apt
export ZEPHYR_BASE="$PWD/../zephyrproject/zephyr"
bash scripts/test-all.sh # ctest + twister + formatFull docs at docs.alplab.ai ↗
§ Develop in VS Code
Alp IDE brings a real language server for board.yaml, the full tan build surface, flash + debug, an SDK manager, and a project wizard into your editor — no terminal jumping.
- · Inline diagnostics, completion, hover, and quick-fixes on
board.yaml— an in-process language server, evaluated per keystroke rather than by shelling out - · New Project wizard — pick the SoM and SDK release, scaffold against the active SDK or a pinned release
- · SDK Manager: link and activate SDK checkouts per project — active version in the status bar
- · Build, image, flash, clean, and run under native_sim all delegate to the external
tanCLI (ADR-0020); the extension resolves and manages its own pinned copy of the binary. Plainwest flashandwest updatestay as direct west calls — they have no tan equivalent yet - · Zephyr
alp.conf, device tree overlays, CMake args, and Yocto config generated from the project’sboard.yaml - · Debug orchestration: project-state inspection, doctor + preflight checks, debug profiles, and exportable support bundles
Current build: v0.5.2, published to the VS Code Marketplace and Open VSX. The 0.5 line is an odd-minor pre-release channel — you need pre-release updates enabled to receive it. It pins tan 0.5.1 and requires an alp-sdk checkout at v0.10.0 or newer.
§ Examples
Real applications. Clone, build, run.
AI / Edge ML
Robotics
IoT
Display / HMI (LVGL)
Audio
Production & multi-processor
Peripherals (cross-family)
Low-level peripheral examples — build on both EVKs via the <alp/board.h> BOARD_* aliases.
NXP i.MX 93
DEEPX DX-M1