Alp SDK · v0.15.0 · released 2026-08-07
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.15.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.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
- v0.13.02026-07-24 · releasedShipped
CC3501E BLE GATT on real AEN silicon · Yocto power backend · Kconfig LSP feed
- The CC3501E BLE GATT server is proven on physical E1M-AEN801 silicon (SW-DP 0x4C013477, persistent across a cold power-on reset): the aen-cc3501e-ble-gatt example drives bridge PING, alp_ble_open, a dynamic GATT service register, and advertise_start through the portable <alp/ble.h>. It is server-only — there is no BLE central on the bench, so end-to-end read/write against a peer stays HIL-deferred
- Dynamic CC3501E GATT service registration replaces the fixed-demo stub — a new BLE_GATT_REGISTER (0x38) wire message carries a variable-length service/characteristic descriptor the firmware bounds-validates and registers at runtime, returning the attribute handles to the host
- Runtime GATT server plus client read/write on the Zephyr BLE backend, proven host-side under native_sim (new ble_gatt_server test); the client read/write path is bench-deferred since native_sim ships no reachable BLE controller. Fixes a read-completion bug that timed out every successful client read
- New Yocto/Linux power backend — request_sleep via /sys/power/state (freeze/standby/mem) plus an RTC wakealarm for a timed wake, registered beside the Zephyr / Alif-SE / GD32-supervisor backends. Real-board confirmation is a later bench step
- The 31-byte legacy BLE advertising budget is now enforced centrally before backend dispatch, so an over-budget adv_config is rejected identically on Zephyr and CC3501E (found on AEN silicon, where a 15-char name plus one 128-bit UUID failed only on CC3501E)
- New --emit kconfig projects a board-scoped Kconfig symbol menu for the VS Code prj.conf LSP, anchored to a cross-repo golden fixture with a conformance gate so tan-cli and the extension can’t drift; callback self-close deadlocks fixed across MQTT, Yocto CAN/GPIO, and CC3501E BLE
Earlier releases (11)
- 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, run under native_sim, and Renode 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