Runbook-и on Sovol на mainline Klipper

Поверх стоковой прошивки

Mon, 01 Jan 0001 00:00:00 +0000

Runbook — миграция на месте поверх стоковой прошивки#

Принтер работает, и ты мигрируешь поверх него. Вендорская ОС остаётся, приклад и прошивка MCU переезжают на upstream, а ОС — опциональный последний шаг. Это путь инкрементального де-вендоринга.

Каждый шаг ниже — ссылка в компонент, который делает работу; эта страница только про порядок.

1. Сначала забэкапь всё#

Rsync вендорского стека, SWD-дамп тулхеда и, желательно, полный образ eMMC. Бэкапы — это то, что делает любой последующий шаг обратимым. → Восстановление: сначала бэкап

Есть eMMC-ридер

Mon, 01 Jan 0001 00:00:00 +0000

Runbook — сборка с чистого листа с eMMC-ридером#

Путь, которым реально идёт восстановление или свежая сборка: сначала ОС, приклад сверху, MCU обычно последними — и часто их вообще не трогают, потому что слой 2 пережил то, что убило слой 3. Это порядок, проверенный от начала до конца на референсной машине.

1. Проинвентаризируй бэкапы#

Минимум: набор конфигов (git-репозиторий или любая копия) и состояние MCU. Уже-mainline MCU тут не нужны; вендорские MCU требуют шагов прошивки ниже. Полный образ eMMC превращает это в восстановление вместо пересборки. → Восстановление

Восстановление

Mon, 01 Jan 0001 00:00:00 +0000

Runbook — восстановление машины, которая не поднимается#

Маршрутизируй по тому, что реально отвалилось. Поскольку слой 2 переживает слой 3, большинство восстановлений уже́, чем кажется — мёртвая ОС не трогает MCU, а неудачная прошивка приложения не трогает ОС.

Чеклист бэкапов и подробные откаты живут на странице восстановления; здесь — маршрутизация.

ОС не грузится#

MCU в порядке. Пересобери только ОС, потом переподключись.

Есть полный образ eMMC → восстанови его: один dd обратно, и ты там же, где был.
Образа нет → пересобери с чистого листа: с eMMC-ридером, или на месте, если ридера нет.
Затем восстанови конфиг и подтверди klippy ready с обоими CAN-UUID — это и доказывает, что MCU выжили.

Если умерла сразу после апгрейда ядра / apt — это регрессия onboard-ethernet, а не мёртвое железо.