v11.0 · 151 Fases
Arquitetura & Embedded Fases 10–80 Implementado · ~4 min (748 palavras) RAUCA/BGRUB2OTA
📄 docs/10-ota-rauc-ab-rollback.md ↗

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.

Zenith AutoOS: 11.0.0 Fases: 151 Guias: 33 Idioma: PT-BR

Categoria: Arquitetura & Embedded Fases: 10–80 Status: Implementado RAUC: stack A/B: stack GRUB2: stack OTA: stack

🏠 README · 📚 Documentação · ⬅️ 09 · DVR · 11 · Multi-screen ➡️

📑 Neste guia — 5 seções · ~3 min de leitura

Atualização OTA atômica do Zenith AutoOS
OTA atômica: slot inativo, assinatura, watchdog e rollback automático.


🗺️ Visão geral em diagrama

Diagrama Mermaid
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ático

Como 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)

  1. Estado Normal (Slot A ativo): grubenv contém ORDER="A B", A_OK=1, B_OK=1, A_TRY=0, B_TRY=0.
  2. 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, marca B_OK=1, B_TRY=0 e altera ORDER="B A" no /boot/efi/EFI/BOOT/grubenv.
  3. Tentativa de Boot no Slot Novo (B):
    • No próximo boot, o grub.cfg seleciona o Slot B, grava B_TRY=1 no grubenv antes de carregar o kernel e inicia o Linux com panic=3.
  4. Dois Cenários Possíveis:
    • Boot Saudável: O sistema atinge graphical.target + zenith-hmi.service; o serviço rauc-mark-good.service executa rauc status mark-good, resetando B_TRY=0 e consolidando o Slot B.
    • Falha / Kernel Panic: O kernel reinicia automaticamente após 3s (panic=3). Como B_TRY permanece 1, o grub.cfg ignora o Slot B defeituoso e faz rollback automático para o Slot A, mantendo o veículo 100% operacional.

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/grubenv e o keyring público /etc/rauc/ca.cert.pem.
  • Chaves de Assinatura: Geradas fora do RootFS com generate-rauc-keys.sh (salva ca.key.pem em board/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.py

4. 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:B e executa CMD: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.json para a nuvem via /run/zenith/mqtt_alert.sock.
  • Assinatura & Integridade: O bundle é validado com o certificado público antes da gravação; o rauc status confirma o slot ativo e o rauc-mark-good.service consolida 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