ОС on Sovol на mainline Klipper

Простая установка

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

Простая установка — для большинства#

Страница с чистого листа запекает всё в образ офлайн, руками. Тебе так не обязательно. Есть путь подружелюбнее: прошей базовый образ, дай ему подняться и ответь на короткий визард по SSH — тот же first-run опыт, что и на любой плате Armbian. Никакой правки ext4, никакого debugfs.

Две вещи делают это простым на Zero:

У платы есть слот microSD, и H616 грузит SD раньше eMMC. Так что можно гонять всё с microSD — без ридера, без снятия модуля, без риска для стоковой eMMC. Оставь eMMC в покое как заводской бэкап, или перенеси систему на неё позже.
Первый вход по SSH запускает дружелюбный setup-визард Armbian (armbian-firstlogin): он заставляет сменить пароль root, создаёт твоего пользователя и спрашивает locale + timezone — прямо в SSH-сессии.

Используй образ Sovobian для всего этого — это upstream Armbian CB1 с уже запечённым оверлеем eMMC 40 МГц, и он несёт ядро 6.12.68, где встроенный Ethernet работает из коробки. Обычный образ BTT CB1 гонит eMMC на 3× валидированного клока (смотри разницу CB1) — не используй его.

Ванильный Armbian

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

Ванильный Armbian на плате Sovol Zero#

Миграция Klipper оставляет стоковый образ ОС от Sovol нетронутым — Klipper живёт в /home/sovol, так что замена слоя Klipper никогда не переписывает rootfs или загрузчик. Для полностью вендор-фри машины последний слой — это ОС на eMMC. Это более трудный, деструктивный шаг (он переписывает всё загрузочное устройство).

Это проверенный от начала до конца рецепт ванильного Armbian на стоковом 8 ГБ eMMC-модуле — без кастомной сборки ОС, без замены модуля. Оригинальный разбор Armbian-на-Zero — asnajder/zero-config, на нём это и строится; где они расходятся (в первую очередь на 8 ГБ модуле), разница объяснена ниже.

С чистого листа (eMMC-ридер)

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

Установка с чистого листа с eMMC-ридером#

Самый чистый путь ОС: снять eMMC-модуль, прошить его офлайн в USB-ридере, запечь всё, что нужно первой загрузке, и включить настроенную машину. Это ровно та последовательность, которой (пере)собирали референсную машину — дважды — так что каждый шаг пережил контакт с реальностью.

Что нужно: eMMC-модуль в USB-ридере, Linux-машина или VM для офлайн-правок (macOS не может писать ext4 — см. заметку про офлайн-правки ниже), и MCU уже на mainline Katapult + Klipper (см. Миграцию MCU). Если MCU были на mainline раньше, они на нём и остаются — слой 2 переживает слой 3.

На месте, без eMMC-ридера

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

Переустановка ОС без eMMC-ридера#

Нет ридера, и не хочешь снимать модуль? Можно положить свежую ОС на eMMC прямо с работающей платы. Фокус в слоте microSD: H616 грузит SD раньше eMMC, так что ты загружаешь свежий образ с карты и оттуда клонируешь его на eMMC.

Обходного пути по USB нет — плата не выводит порт USB-C / OTG, так что обычный маршрут sunxi-fel + U-Boot ums, чтобы достать eMMC по USB, отпадает (смотри почему FEL отпадает). Загрузка с SD и клонирование — единственный путь без ридера.

Обновляемый Armbian

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

Как держать Armbian обновляемым#

Опасение, что апгрейд apt «потеряет dts» и сломает eMMC, в основном беспочвенно, а реальное ограничение уже, чем кажется. Эта страница разделяет два этих вопроса.

Экспериментально в одном месте. Всё про то, почему ядро на hold, подтверждено и задокументировано. Путь с hold (переход на более новое ядро с сохранением встроенного Ethernet) пока не проверен на Zero — он помечен ниже. Сделай полный бэкап перед тем, как это тестировать.

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

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

Восстановление и бэкапы#

Что делает каждый шаг в каждом пути обратимым и как вернуть машину, которая не грузится. Восстановление — это в основном история про бэкапы: сними правильные снапшоты, прежде чем что-то трогать, и мёртвый слой станет восстановлением вместо пересборки.

Сначала бэкап — чеклист#

Сними это, прежде чем что-то стирать. Именно они делают каждый последующий шаг обратимым.

Вендорский стек (на уровне файлов, возобновляемый rsync — не сырой dd по WiFi): вендорский ~/klipper как git bundle, ~/printer_data/config, ~/printer_data/build/*.bin, и сборочные конфиги под каждый чип ~/klipper/.config* (полезные затравки, даже несмотря на устаревшие flash-офсеты).