Wiren Board Firmware Update

Общая информация

Эта статья описывает обновление прошивки контроллера Wiren Board 6 и контроллера Wiren Board 5 с версией прошивки 0.38-20180710 и выше, если у вас другой контроллер — читайте раздел Обновление прошивки контроллеров старых версий.

Прошивку контроллера Wiren Board можно обновить через менеджер пакетов apt или через fit-файл: с помощью флешки или через веб-интерфейс.

Также контроллер можно сбросить к заводским настройкам и удалить пользовательские данные.

Новый репозиторий Wiren Board

С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате периодических релизов, также изменился путь к основному репозиторию. Старый репозиторий больше не поддерживается, новых обновлений не будет.

На старых контроллерах (до мая 2021 года) для перехода на работу с релизами надо сделать пару шагов:

Если на контроллере есть интернет, то выполните команды:

apt update && apt dist-upgrade

в систему будет установлен пакет wb-configs, а сама система обновится.

После обновления выполните эти команды ещё раз:

apt update && apt dist-upgrade

ПО контроллера переключится на текущий релиз stable и обновится, или на релиз testing, если ранее вы включали репозиторий unstable.

Если на контроллере нет интернета, то можете обновить контроллер через .fit-файл прошивки.

Ветки релизов

Testing

Testing — нестабильная ветка: свежие версии пакетов с новыми функциями, исправленными и новыми ошибками.

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

На третий месяц testing-ветка «замораживается» и ей присваивается имя будущего stable. Во время заморозки новые функции не добавляются, а только исправляются найденные ошибки. В конце месяца релиз сливается со stable, а testing «размораживается» и продолжается публикация пакетов с новыми функциями.

Будем рады помощи сообщества в тестировании пакетов — переключайтесь на testing-ветку на неответственных инсталляциях.

Stable

Stable — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок.

Публикуемые в ней пакеты прошли тестирование пользователями testing-ветки, поэтому мы рекомендуем использовать stable в ответственных инсталляциях.

Если в релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода, не дожидаясь очередной даты релиза.

Релизы имеют номер вида wb-YYMM, где YY — год, а MM — месяц выпуска. Например, wb-2104 — релиз, выпущенный в апреле 2021 года. Узнать о выходе очередного stable-релиза можете в Журнале изменений релизах.

Переключение между релизами

Для переключения используйте утилиту wb-release с флагом -t:

На testing:

wb-release -t testing

На stable:

wb-release -t stable

Для заморозки на определенном релизе укажите версию stable-релиза:

wb-release -t wb-2104

Но мы не рекомендуем это делать — вы останетесь без обновлений. Для разморозки переключитесь на одну из веток.

После смены релиза мы рекомендуем перезагрузить контроллер на случай, если обновилось ядро.

Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.

Как узнать версию установленного ПО

Версия ПО в веб-интерфейсе для testing

Посмотреть текущую версию ПО можно:

• В веб-интерфейсе. В разделке Devices, устройство System.
• В консоли. При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза.
• В консоли командой wb-release:

# wb-release
Wirenboard release wb-2104 (as stable), target wb6/stretch

You can get this info in scripts from /usr/lib/wb-release.

Обновление через fit-файл

Fit-файл — это образ прошивки контроллера Wiren Board, который можно скачать в нашем репозитории

Загрузить текущий stable-релиз можно по прямым ссылкам:

• Wiren Board 6.3­-6.6.0
• Wiren Board 6.7.x-6.8.x

Обновление с USB-накопителя и сброс к заводским настройкам

Порт USB 1 и кнопка FW на контроллере Wiren Board 6.7

Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в WB_6:_Errata.

Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски — может не хватить мощности USB-порта.

Подготовьте флеш-накопитель:

1. Отформатируйте флешку в FAT32.
2. Скачайте fit-файл прошивки на компьютер.
3. Скопируйте скачанный .fit-файл в корень флешки и убедитесь, что размер файла не равен нулю.
4. Переименуйте файл на флешке:
   • для обновления прошивки контроллера в wb6_update.fit,
   • для сброса контроллера к заводским настройкам и удаления всех данных в wb6_update_FACTORYRESET.fit.

Чтобы обновить прошивку или сбросить контроллер к заводским настройкам:

1. Выключите контроллер.
2. Подключите флешку с файлом прошивки к порту USB 1 и включите контроллер.
3. Если в корне флешки найден файл прошивки, то индикатор контроллера начнёт часто мигать оранжевым.
4. В этот момент зажмите на одну секунду кнопку FW, которая находится на плате контроллера.
5. Дальнейшие шаги зависят от того, какой файл лежит на флешке:
   • wb6_update.fit — индикатор загорится зелёным, потом мигнёт красным и замигает зелёным — это началась процедура обновления прошивки.
   • wb6_update_FACTORYRESET.fit:
     1. Индикатор загорится зелёным, потом два раза мигнёт красным и ещё два раза зелёным.
     2. Контроллер начнёт пищать, а индикатор замигает красным — контроллер ждёт подтверждения.
     3. Подтвердите очистку контроллера, для этого нажмите кнопку FW и держите, пока контроллер не пискнет четыре раза, а индикатор не загорится зелёным — это началась процедура сброса настроек.
     4. Кнопку можно отпустить. В процессе индикатор будет мигать зелёным.
6. Процедура продлится 5–10 минут, в конце контроллер перезагрузится в рабочий режим, а индикатор на нём замигает зелёным — флешку можно извлечь.

Если обновление или сброс завершаются с ошибкой, подключитесь к Debug-консоли контроллера и повторите шаги. Если увидите ошибку FAT: Misaligned buffer address — смените накопитель на другой.

• 

  Обновление: момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления

• 

  Обновление: обновление прошивки началось

• 

  Сброс: момент, когда нужно кратковременно нажать кнопку FW для сброса к заводским настройкам

• 

  Сброс: момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения сброса к заводским настройкам

• 

  Сброс: начался сброс к заводским настройкам

Журнал изменений в релизах

Релизы ПО

Ветка	Имя
stable	wb-2108 • wb-2104
testing	rolling release

Обновление прошивки контроллеров старых версий

• Wiren Board 5 с версией прошивки старше 0.38-20180710 обновить можно (первый раз) только через восстановление прошивки, смотрите инструкцию в статье Wiren Board 5: Восстановление прошивки.
• Wiren Board 4 и старше прошиваются через карту Micro-SD, читайте инструкцию в статье Создание microSD-карты с образом