Kenapa? SWUpdate?

Pembaruan lapangan tidak dapat dihindari. SWUpdate menyediakan solusi modular yang tangguh untuk memperbarui firmware, sistem berkas root, dan lapisan aplikasi - semuanya dengan kemampuan rollback bawaan.
Ini adalah sumber terbuka, terdokumentasi dengan baik, dan terintegrasi secara mulus dengan tata letak partisi A/B.

GUI browser web untuk SWUpdate

Gambaran umum arsitektur

SWUpdate terdiri dari beberapa komponen utama:

  • Daemon pembaruan (swupdate) - berjalan pada perangkat dan menerapkan pembaruan
  • Penangan pembaruan - menentukan apa yang akan diperbarui (rootf, file, skrip, dll.)
  • Antarmuka klien - antarmuka web, REST API, atau CLI lokal
  • sw-description file - mendefinisikan struktur dan logika paket pembaruan

Contoh alur pembaruan

  1. Buat paket pembaruan (.swu) yang berisi:
    • Gambar sistem berkas root yang baru
    • File sw-description file
    • Skrip opsional (untuk kustomisasi atau verifikasi)
      2.swupdate menulis pembaruan ke perangkat yang ditentukan.
  2. Skrip pasca-pembaruan mengonfirmasi keberhasilan atau memicu kembalinya pembaruan jika perlu.

Contoh

Dalam contoh ini, kami membagi gambar resmi Raspberry Pi OS Trixie resmi menjadi dua file:

  • 2025-10-01-raspios-trixie-arm64.boot.vfat
  • 2025-10-01-raspios-trixie-arm64.root.ext4

Berkas-berkas ini direferensikan dalam berkas sw-description untuk membuat paket .swu:

software =
{
    version = "0.1.0";
    description = "Firmware update for XXXXX Project";

    hardware-compatibility: [ "1.0", "1.2", "1.3"];

    images: (
        {
            filename = "2025-10-01-raspios-trixie-arm64.boot.vfat";
            device = "/dev/mmcblk0p1";
            compressed = "zlib";
            installed-directly = true;
        },
        {
            filename = "2025-10-01-raspios-trixie-arm64.root.ext4";
            device = "/dev/mmcblk0p2";
            compressed = "zlib";
            installed-directly = true;
        }
    );

    scripts: (
        {
          type: "lua",
          filename: "repair-disk-uuid.lua"
        }
    ),
}

Skrip Lua berikut ini menyesuaikan UUID partisi di cmdline.txt dan fstab setelah melakukan flashing:

#!/usr/bin/lua

-- helper: run shell command and capture output
function run(cmd)
  local f = io.popen(cmd)
  local out = f:read("*a")
  f:close()
  return (out:gsub("%s+$", ""))
end

-- detect PARTUUIDs
local root_part = "/dev/mmcblk0p2"
local boot_part = "/dev/mmcblk0p1"
local root_uuid = run("blkid -s PARTUUID -o value " .. root_part)
local boot_uuid = run("blkid -s PARTUUID -o value " .. boot_part)

print("Rootfs PARTUUID: " .. root_uuid)
print("Boot   PARTUUID: " .. boot_uuid)

-- mount points
os.execute("mkdir -p /mnt/root /mnt/boot")
os.execute("mount " .. root_part .. " /mnt/root")
os.execute("mount " .. boot_part .. " /mnt/boot")

-- update cmdline.txt
local cmdline_path = "/mnt/boot/cmdline.txt"
local file = io.open(cmdline_path, "r")
local text = file:read("*a")
file:close()

text = text:gsub("root=PARTUUID=[^ ]+", "root=PARTUUID=" .. root_uuid)

file = io.open(cmdline_path, "w")
file:write(text)
file:close()

-- update /etc/fstab
local fstab_path = "/mnt/root/etc/fstab"
local fstab = io.open(fstab_path, "r")
local content = fstab:read("*a")
fstab:close()

-- replace root line
content = content:gsub("PARTUUID=[^%s]+%s+/%s", "PARTUUID=" .. root_uuid .. " /")
-- replace boot line (/boot or /boot/firmware)
content = content:gsub("PARTUUID=[^%s]+%s+/boot", "PARTUUID=" .. boot_uuid .. " /boot")

fstab = io.open(fstab_path, "w")
fstab:write(content)
fstab:close()

os.execute("sync")
os.execute("umount /mnt/boot")
os.execute("umount /mnt/root")

print("All PARTUUIDs updated successfully.")

Gunakan swugenerator untuk membundel pembaruan:(https://github.com/sbabic/swugenerator).

Menerapkan pembaruan

Untuk menguji file .swu yang dihasilkan:

  1. Boot CM5 ke dalam sistem penyelamatan.
  2. Buat titik pemasangan, misalnya:
sudo mkdir -p /mnt/update
  1. Pasang berkas NFS yang berisi berkas pembaruan:
sudo mount -t nfs :/path/to/share /mnt/update
  1. Terapkan pembaruan:
sudo swupdate -i /mnt/update/update.swu

Kemungkinan integrasi

Memicu pembaruan dari UI lokal atau API backend

  • Menandatangani dan memverifikasi pembaruan untuk meningkatkan keamanan
  • Gunakan SWUpdate’s antarmuka web untuk pengujian atau debugging
  • Kombinasikan dengan layanan systemd untuk mengotomatiskan pemulihan dan rollback

Mengapa cocok dengan tumpukan ini

Bersama dengan rpi-image-gen dan rpi-sb-provisioner, SWUpdate melengkapi gambar:

  • Membangun → rpi-image-gen (Pembuatan gambar)
  • Menyebarkan → (Menyebarkan) rpi-sb-provisioner (Penyediaan perangkat)
  • Memelihara → (Pemeliharaan) SWUpdate (Pembaruan OTA dan manajemen siklus hidup)

Hasilnya adalah platform tertanam yang fleksibel, terbuka, dan dapat dipelihara Linux yang fleksibel, terbuka, dan dapat dipelihara - platform yang berkembang bersama produk Anda, tanpa biaya tambahan Yocto.

Artikel dalam seri ini

Sumber