Overview

Conceptual documentation for the Pantavisor runtime and the meta-pantavisor layer. Start here before reading the build or install guides.

Topics

1. Pantavisor — what Pantavisor is: container model, atomic updates, cloud control, and the trail/revision system
2. meta-pantavisor — directory layout, key recipes, BitBake classes, KAS fragments, and layer conventions
3. Build System — KAS configuration hierarchy, multiconfig architecture, and the relationship between build targets
4. Starter Image — what pantavisor-starter is, how the initial trail is composed from core containers + the BSP, and how to customize the mix
5. Boot Flow — how boot.cmd.pvgeneric boots Pantavisor: FIT/trail loading, try-boot, MMC vs NAND/UBIFS, and PV_BOOT_OEMARGS
6. CI — how CI machines, workflows, and build matrix relate to the layer structure
7. pv-flash-bundle — the UUU factory-flash archive recipe: design, PV_FLASH_* variables, and how to wire up a new machine