How balena-os/meta-balena works
This repository is a set of Yocto layers used to build balenaOS across device types and Yocto releases. The main workflow is a device booting through bootloader logic that selects a root filesystem and launches Linux; the OS then provides connectivity, time synchronization, and device services. The graph also captures documented image configuration, updates, and support features. Edges rely on README statements or the shown U-Boot environment excerpt; other recipe-level wiring was not sampled, so it is not inferred.
Main entry points: env_resin.h Bootloader · images OS image · meta-balena-common Common recipes · meta-balena-scarthgap Yocto-version layers
Components 17
Yocto layers
- Common recipes
meta-balena-common - Yocto-version layers
meta-balena-scarthgap - OS image
meta-balena-common/recipes-core/images
Boot and updates
- Bootloader
meta-balena-common/recipes-bsp/u-boot/patches/env_resin.h - Boot environment
meta-balena-common/recipes-bsp/u-boot/patches/env_resin.h - Kernel CRC check
meta-balena-common/recipes-bsp/u-boot/files/balena_check_crc32.c - Linux kernel
meta-balena-common/recipes-kernel/linux - Host OS update
meta-balena-common/recipes-containers/hostapp-update
Connectivity and time
- Network manager
meta-balena-common/recipes-connectivity/networkmanager - HTTPS time sync
meta-balena-common/recipes-core/systemd/timeinit - NTP time service
meta-balena-common/recipes-core/chrony
Device services
- SSH service
meta-balena-common/recipes-connectivity/openssh - Avahi discovery
meta-balena-common/recipes-connectivity/avahi
OS support
- Device registration
meta-balena-common/recipes-support/resin-device-register - State reset
meta-balena-common/recipes-support/resin-state-reset - Persistent logs
meta-balena-common/recipes-support/balena-persistent-logs
Other components
- OS integrator
Connections 11
- OS integrator → Common recipes: configures
- OS integrator → Yocto-version layers: selects
- Common recipes → OS image: provides recipes
- Yocto-version layers → OS image: provides recipes
- OS image → Bootloader: boots through
- Bootloader → Boot environment: uses environment
meta-balena-common/recipes-bsp/u-boot/patches/env_resin.h - Bootloader → Linux kernel: loads and launches
- Boot environment → Linux kernel: selects root for
meta-balena-common/recipes-bsp/u-boot/patches/env_resin.h - Network manager → HTTPS time sync: connectivity gates
- HTTPS time sync → NTP time service: precedes
- SSH service → Avahi discovery: hostname advertised via