Skip to main content

Installation

The ALP SDK is supported equally on Linux, macOS, and Windows (native PowerShell or WSL2). Tooling versions are identical across hosts; only the install commands differ.

Prerequisites​

ToolVersionNotes
Zephyrv4.4.0Pinned by the SDK's west.yml. See the version policy.
Python3.10+For west, the board.yaml orchestrator (alp_orchestrate.py), validators.
Python depspyyaml, jsonschema, imgtoolInstalled by scripts/bootstrap.sh. Manual install: pip install pyyaml jsonschema imgtool.
CMake3.20+find_package(Zephyr) minimum.
C compilerGCC 11+ / Clang 14+native_sim builds; cross-toolchain for real silicon.
west1.2+pip install west if your distro doesn't ship it.

Install the toolchain​

Linux (Debian / Ubuntu)​

sudo apt update
sudo apt install -y cmake ninja-build python3 python3-pip git
pip3 install west

macOS (Homebrew)​

brew install cmake ninja python git
pip3 install west

Windows (native, PowerShell)​

winget install -e --id Kitware.CMake
winget install -e --id Ninja-build.Ninja
winget install -e --id Python.Python.3.12
winget install -e --id Git.Git
pip install west

Windows (WSL2)​

wsl --install -d Ubuntu

Then use the Linux instructions inside the Ubuntu shell.

Zephyr SDK (for real silicon)​

For builds against actual hardware you also need the Zephyr SDK toolchain (zephyr-sdk-0.17.0 or newer is the v0.5 SDK matrix's pin). native_sim builds use only the host compiler and don't require the Zephyr SDK.

Clone and bootstrap​

The simplest path uses the SDK's bootstrap script:

git clone https://github.com/alplabai/alp-sdk
cd alp-sdk
bash scripts/bootstrap.sh
export ZEPHYR_BASE="$PWD/../zephyrproject/zephyr"

scripts/bootstrap.sh creates a Zephyr workspace one level up from alp-sdk/, runs west update --narrow, installs the Zephyr Python deps and the SDK's extras (jsonschema, imgtool), and prints OS-specific apt / brew commands for the optional native libraries the Yocto backends need.

Manual west init (alternative)​

If you'd rather drive west directly:

mkdir alp-workspace && cd alp-workspace
west init -m https://github.com/alplabai/alp-sdk
west update --narrow -o=--depth=1
west zephyr-export

After this the workspace contains:

alp-workspace/
├── zephyr/         # Zephyr v4.4.0 (pinned)
├── modules/        # standard Zephyr modules
└── alp-sdk/        # this repo, mounted as a Zephyr module

west update --narrow -o=--depth=1 keeps the clone shallow — saves ~30 GB of unrelated git history.

Importing alp-sdk via west init -m also surfaces the west alp-build extension command that the Quick Start uses.

Verify​

cd alp-workspace
west alp-build --version
west alp-build -b native_sim/native/64 alp-sdk/examples/gpio-button-led
west build -d build -t run

A successful run prints *** Booting Zephyr OS build v4.4.0 *** followed by the example's output. See the Quick Start for the full walk-through.

Install the alplabai.alp-sdk extension for:

  • Schema-aware board.yaml editing (autocomplete on SKUs, carriers, libraries)
  • Inline validator diagnostics in the Problems panel
  • GUI configurator panel with dropdowns for every released MPN + carrier
  • One-keypress Alp: Generate all command for the loader's emit modes
  • west wrappers (build / flash / run native_sim)
  • Per-OS dependency bootstrap

See the VS Code page.

SDK directory layout​

alp-sdk/
├── include/alp/     # PUBLIC headers (the consumer surface)
├── src/             # common/ + zephyr/ + baremetal/ + yocto/ backends
├── chips/           # 70+ opt-in chip drivers (Tier 0 stable + v0.5 §D ecosystem)
├── vendors/         # per-SoM HAL bindings (alif, renesas-rzv2n, nxp-imx93, deepx-dxm1)
├── metadata/        # schemas (v2), templates, e1m_modules/<MPN>.yaml, carriers/, socs/
├── scripts/         # board.yaml v2 orchestrator, validators, soc_caps + ABI generators
├── examples/        # reference apps (gpio-button-led, rpmsg-v2n, edgeai-vision-aen, ...)
├── docs/            # architecture, board-config, ADRs, test-plan, ...
├── tests/           # Python script tests + ztest suites
├── meta-alp-sdk/    # Yocto layer + per-cluster MACHINE confs (v0.6 layout)
└── west.yml         # Zephyr manifest

Next steps​

Questions about this page? Discuss in Community Forum