Build EmberLite
EmberLite uses CMake (≥ 3.16 recommended) and optionally the same Kconfig → build/.config → build/config.cmake pipeline as OpenEmber.
Requirements
- Linux (POSIX)
- CMake ≥ 3.16
- GCC or Clang with C11
Recommended: ember one-shot
From the EmberLite repository root:
chmod +x ./scripts/ember # once
./scripts/ember build
Behavior:
- Creates a default non-interactive
.configifbuild/.configis missing. - Generates
build/config.cmake, then runscmake -S . -B buildandcmake --build. - First
menuconfigmay download kconfig-frontends-nox to.kconfig-frontends/(needscurl,dpkg-deb, etc.; directory is gitignored).
Common commands:
| Command | Purpose |
|---|---|
./scripts/ember menuconfig [build_dir] | Interactive Kconfig → .config + config.cmake |
./scripts/ember genconfig [build_dir] | Regenerate config.cmake only |
./scripts/ember update [build_dir] | cmake -S . -B <dir> |
./scripts/ember clean [build_dir] | Remove build directory |
Plain CMake (no Kconfig)
mkdir -p build
cmake -S . -B build
cmake --build build -j
Artifacts: binaries in build/bin/, libraries in build/lib/.
Example: UART terminal
./build/bin/hal_uart_term -d /dev/ttyUSB0 -b 115200
If serial access fails, add your user to the dialout group and re-login.
More: upstream build instructions.