SWUpdate состоит из нескольких ключевых компонентов:

• Демон обновлений (swupdate) - работает на устройстве и применяет обновления
• Обработчики обновлений - определяют, что обновлять (rootfs, файлы, скрипты и т.д.)
• Клиентские интерфейсы - веб-интерфейс, REST API или локальный CLI
• sw-description файл - определяет структуру и логику пакета обновлений

1. Создайте пакет обновления (.swu), который содержит:
   • Новый образ корневой файловой системы
   • файл sw-description файл
   • Дополнительные скрипты (для настройки или проверки)
     2.swupdate Записывает обновление на указанные устройства.
2. Сценарий после обновления подтверждает успех или запускает откат, если это необходимо.

В этом примере мы разделили официальное Raspberry Pi OS образ Trixie на два файла:

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

На эти файлы есть ссылки в файле sw-description для создания пакета .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"
        }
    ),
}

Следующий скрипт Lua корректирует UUID разделов в cmdline.txt и fstab после прошивки:

#!/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.")

Используйте swugenerator чтобы связать обновление:(https://github.com/sbabic/swugenerator).

Применить обновление

Чтобы проверить сгенерированный .swu-файл:

1. Загрузите CM5 в аварийную систему.
2. Создайте точку монтирования, например:

sudo mkdir -p /mnt/update

3. Смонтируйте общий ресурс NFS, содержащий файл обновления:

sudo mount -t nfs :/path/to/share /mnt/update

4. Примените обновление:

sudo swupdate -i /mnt/update/update.swu

Запускайте обновления из локального пользовательского интерфейса или внутреннего API.

• Подписывайте и проверяйте обновления для повышения безопасности
• Используйте SWUpdate’s веб-интерфейс для тестирования или отладки
• Объединитесь со службами systemd для автоматизации восстановления и отката.

Вместе с rpi-image-gen и rpi-sb-provisioner, SWUpdate завершает картину:

• Построение → rpi-image-gen (создание образа)
• Развертывание → rpi-sb-provisioner (Предоставление устройства)
• Поддерживать → SWUpdate (OTA-обновления и управление жизненным циклом)

В результате Вы получаете гибкую, открытую и удобную для обслуживания встраиваемую Linux платформа, которая развивается вместе с Вашим продуктом, без лишних затрат на Yocto.

• Building a Production-Ready Linux for Raspberry Pi Compute Module 5
• От стоковой ОС к производственной платформе
• Customizing Raspberry Pi OS with rpi-image-gen
• Устойчивость системы - Проектирование корневой файловой системы A/B.
• Provisioning — Automating First Boot with rpi-sb-provisioner
• OTA и жизненный цикл - Обновление программного обеспечения с SWUpdate

• rpi-image-gen: https://github.com/raspberrypi/rpi-image-gen
• rpi-sb-provisioner: https://github.com/raspberrypi/rpi-sb-provisioner
• SWUpdate: https://github.com/sbabic/swupdate
• swugenerator: https://github.com/sbabic/swugenerator