10 — Atualizações OTA Seguras (RAUC + Particionamento A/B + GRUB2 Rollback)
Este documento detalha o mecanismo de Atualização Over-the-Air (OTA) Atômica e Imune a Falhas (Fase 11), baseado em RAUC, particionamento GPT A/B e rollback automático no GRUB2 EFI.
🏠 README · 📚 Documentação · ⬅️ 09 · DVR · 11 · Multi-screen ➡️
📑 Neste guia — 5 seções · ~3 min de leitura
OTA atômica: slot inativo, assinatura, watchdog e rollback automático.
🗺️ Visão geral em diagrama
stateDiagram-v2
[*] --> SlotA
SlotA --> Download: bundle .raucb
Download --> Verify: assinatura + SHA-256
Verify --> SlotB: grava slot inativo
SlotB --> Reboot: ESP32 OTA_REBOOT_PC
Reboot --> Health: boot + watchdog 3 s
Health --> SlotB: OK · mark-good
Health --> SlotA: falha · rollback GRUB2
SlotA --> [*]
SlotB --> [*]
note right of SlotB: Slot A permanece intacto
note right of SlotA: rollback automáticoComo ler: o diagrama resume o fluxo principal deste guia; os detalhes, pinagens, endpoints e trechos de código aparecem nas seções abaixo.
1. Layout de Particionamento GPT (board/zenith/genimage.cfg)
| Partição | Rótulo / Slot | Tipo / Sistema de Arquivos | PARTUUID |
Ponto de Montagem |
|---|---|---|---|---|
gpt1 |
Boot (ZENITH_EFI) |
ESP (VFAT 64 MB) |
5a656e69-7468-4175-746f-426f6f744546 |
/boot/efi (rw,sync,flush) |
gpt2 |
RootFS A (slot.rootfs.0) |
SquashFS LZ4 (1024 MB RO) |
5a656e69-7468-4175-746f-526f6f744130 |
/ (quando rauc.slot=A) |
gpt3 |
RootFS B (slot.rootfs.1) |
SquashFS LZ4 (1024 MB RO) |
5a656e69-7468-4175-746f-526f6f744230 |
/ (quando rauc.slot=B) |
gpt4 |
Data (ZENITH_DATA) |
ext4 (persistente) |
5a656e69-7468-4175-746f-446174615031 |
/data (DVR, Músicas, BT, Perfis) |
2. Lógica de Fallback & Rollback Automático (board/zenith/grub.cfg)
- Estado Normal (Slot A ativo):
grubenvcontémORDER="A B",A_OK=1,B_OK=1,A_TRY=0,B_TRY=0. - Instalação OTA (
rauc install zenith-update.raucb):- Enquanto o carro opera no Slot A, o RAUC grava a nova imagem SquashFS (com novo Kernel
/boot/bzImage+ RootFS) no Slot B inativo (gpt3) de forma atômica, marcaB_OK=1,B_TRY=0e alteraORDER="B A"no/boot/efi/EFI/BOOT/grubenv.
- Enquanto o carro opera no Slot A, o RAUC grava a nova imagem SquashFS (com novo Kernel
- Tentativa de Boot no Slot Novo (
B):- No próximo boot, o
grub.cfgseleciona o SlotB, gravaB_TRY=1nogrubenvantes de carregar o kernel e inicia o Linux companic=3.
- No próximo boot, o
- Dois Cenários Possíveis:
- Boot Saudável: O sistema atinge
graphical.target+zenith-hmi.service; o serviço rauc-mark-good.service executarauc status mark-good, resetandoB_TRY=0e consolidando o Slot B. - Falha / Kernel Panic: O kernel reinicia automaticamente após
3s(panic=3). ComoB_TRYpermanece1, ogrub.cfgignora o Slot B defeituoso e faz rollback automático para o Slot A, mantendo o veículo 100% operacional.
- Boot Saudável: O sistema atinge
3. Configuração RAUC, Chaves e Geração de Bundles OTA
- Configuração no Alvo: system.conf define
bootloader=grub,grubenv=/boot/efi/EFI/BOOT/grubenve o keyring público/etc/rauc/ca.cert.pem. - Chaves de Assinatura: Geradas fora do RootFS com generate-rauc-keys.sh (salva
ca.key.pememboard/zenith/rauc-keys/e copia apenas o certificado público para o overlay). - Criar e Instalar um Bundle
.raucb:
bash
# No host Linux após compilar nova versão do rootfs.squashfs:
mkdir -p bundle_staging
cp board/zenith/rauc-bundle.conf bundle_staging/manifest.raucm
cp output-zenith/images/rootfs.squashfs bundle_staging/rootfs.squashfs
output-zenith/host/bin/rauc bundle \
--cert=board/zenith/rootfs_overlay/etc/rauc/ca.cert.pem \
--key=board/zenith/rauc-keys/ca.key.pem \
bundle_staging/ zenith-autoos-1.0.1.raucb
# No veículo (via USB ou rede):
rauc status
rauc install /data/rauc/zenith-autoos-1.0.1.raucb
reboot- Ativação do Delta (Fase 80):
bash
# Instalação delta por chunks + reboot assistido pelo ESP32:
python3 /opt/zenith/ota/zenith_ota_delta.py4. OTA Deltas por Chunks, Troca de Slot via ESP32 & Crash Reporter (Fase 80)
- Agente: zenith_ota_delta.py (zenith-ota.service) +
casync(zenith_autoos_defconfig). - Transferência Delta: Apenas os blocos SHA-256 modificados são baixados via Wi-Fi ou LTE (
compute_chunked_delta/apply_chunked_delta) e gravados atomicamente na partição inativa (Slot B). - Watchdog 3s & Rollback Reportado: O ESP32 é armado com
CMD:OTA_ARM_SLOT:Be executaCMD:OTA_REBOOT_PC. Em caso de Kernel Panic (panic=3,RuntimeWatchdogSec=3s), o boot reverte para a partição íntegra e o agente reporta/data/ota/last_crash_report.jsonpara a nuvem via/run/zenith/mqtt_alert.sock. - Assinatura & Integridade: O bundle é validado com o certificado público antes da gravação; o
rauc statusconfirma o slot ativo e orauc-mark-good.serviceconsolida a atualização somente após o HMI subir.
⬅️ 09 · DVR · ⬆️ Topo · 📚 Índice · 11 · Multi-screen ➡️
Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal