Wiren Board Firmware Update

Частичное обновление прошивки через APT

В этом способе обновление прошивки производится по частям с помощью системного менеджера пакетов операционной системы Debian.

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

Недостаток способа - необходимость ответственно подходить к процессу и не делать необдуманных действий: неосторожное использование инструмента может привести к неполной установке или даже к удалению важных компонентов ПО контроллеров Wiren Board

Обновление списка пакетов

Перед началом работы нужно получить актуальный список пакетов из репозиториев Debian и Wiren Board.

Обновить все списки пакетов:

apt-get update

Обновить только пакеты из репозитория Wiren Board:

apt-get update -o Dir::Etc::sourcelist="sources.list.d/contactless.list" -o Dir::Etc::sourceparts="-" -o APT::Get::List-Cleanup="0"

Обновление прошивки целиком

Обновление прошивки через веб-интерфейс

ВНИМАНИЕ: для Wiren Board 5 этот способ НЕ рекомендуется при обновлении на версии с "stretch" в названии с версий без "stretch" в названии файла. Это касается, в частности, заводских прошивок WB5 старше середины 2018 года выпуска.

1. Обновление прошивки происходит путём перезаписи раздела накопителя контроллера с операционной системой и всеми установленными программами. При этом не затрагиваются файлы, находящиеся в папках (они находятся в другом разделе). Подробнее ознакомиться с файлами, удаляющимися при обновлении системы, можно в разделе Потеря файлов при обновлении ПО

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

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

2. Свежие версии прошивок (как для контроллеров Wiren Board, так и для периферийных устройств) хранятся на fw-releases. Файлы прошивок для WB хранятся в разделе fit-image и имеют расширение .fit. Выберите файл, максимально соответствующий версии вашего контроллера:
   • Для WB 5.8.x-5.9 - http://fw-releases.wirenboard.com/fit_image/stable/58/latest_stretch.fit
   • Для WB 6.X (до 6.7) - http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit
   • Для WB 6.7.X - http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit

Скачайте файл к себе на компьютер.

1. Зайдите в веб-интерфейс, на страницу Settings. Найдите раздел Firmware update, нажмите кнопку Select file, выберите ранее скачанный файл прошивки (на компьютере).
   

   Нажмите кнопку Select file для загрузки файла прошивки
2. Файл с новой прошивкой загрузится на контроллер, после этого начнётся процесс обновления. Не закрывайте страницу обновления и не производите никаких действий с контроллером, в том числе в веб-интерфейсе. Процесс обновления займёт до 10 минут.
   

   Во время обновления на странице появляются системные сообщения
3. После установки новой прошивки контроллер перезагрузится. После этого на странице обновления появится сообщение об успешном завершении обновления - Firmware update complete.
   

   Оповещение об успешном обновлении

Обновление прошивки с помощью USB-накопителя

ВНИМАНИЕ: в некоторых версиях контроллера есть аппаратные сложности с обновлением прошивки с использованием USB-накопителя. Если вы столкнулись с какой-либо проблемой, прочитайте WB 6: Errata.

В контроллерах Wiren Board 6 добавлена возможность обновления прошивки с использованием USB-накопителя (флешки).

На время обновления желательно подключиться к отладочной консоли контроллера, чтобы контролировать ход обновления.

1. USB-накопитель должен быть отформатирован в FAT32. Если в качестве накопителя используется внешний жёсткий диск, следует также убедиться, что USB-порт контроллера может выдать достаточный ток для запуска диска.
2. Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы https://github.com/contactless/wirenboard/releases.
3. Сохраните скачанный файл на USB-накопитель в корневой каталог. Переименуйте этот файл в wb6_update.fit.
4. Отключите контроллер.
5. На выключенном контроллере потренируйтесь нажимать кнопку FW - в процессе обновления вам нужно будет делать это быстро и аккуратно. Для этого удобно использовать маленькую отвёртку из комплекта поставки контроллера.
6. Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер.
7. Если USB-накопитель корректно распознан, и в корне найден файл wb6_update.fit, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.
8. Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе.
9. Дождитесь окончания процесса обновления, это займёт около 5 минут. В процессе обновления контроллер один раз перезагрузится. Обновление завершено, когда светодиод контроллера начинает мигать зелёным, как в штатном режиме работы. Можно извлечь USB-накопитель.

Сброс Wiren Board 6 к заводским настройкам

ВНИМАНИЕ: сбросить к заводским настройкам можно ТОЛЬКО через USB-накопитель с ОСОБЫМ именем файла прошивки.

ВНИМАНИЕ: при сбросе все пользовательские данные (конфигурация, правила, файлы в домашней директории) будут уничтожены!

1. Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы https://github.com/contactless/wirenboard/releases
   • Пример ссылки на файл для WB6 https://github.com/wirenboard/wirenboard/releases/download/0.47-20200217/202002171718_webupd_wb6x_stretch.fit
2. Проверьте USB накопитель, тип файловой системы должен быть fat32. Инструкция https://remontka.pro/format-usb-fat-32/
3. Скопируйте скачанный файл на USB-накопитель и перименуйте его в wb6_update_FACTORYRESET.fit Имя файла и расширение должно быть именно таким.
   • Убедитесь что размер файла не "0".
4. Отключите контроллер от питания.
5. Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер.
   • как только контроллер замигает оранжевым, отрывисто нажмите на кнопку FW первый раз;
   • после этого светодиод станет постоянно гореть зелёным, потом пару раз мигнёт красным, потом пару раз мигнёт зелёным. Потом контроллер начнёт издавать писк, а светодиод при этом будет часто мигать красным - это значит, что контроллер ожидает подтверждения полной очистки. Чтобы подтвердить удаление всех данных и сбросить контроллер в заводское состояние нужно зажать кнопку FW более, чем на 4 секунды. Писк станет прерывистым. Пока писк и мигание продолжаются, кнопку нужно держать нажатой. Когда писк и мигание прекратятся, кнопку можно отпустить.
6. Процесс сброса занимает несколько минут.

Перезапись прошивки Wiren Board 5

Для Wiren Board 5 см. Wiren Board 5: Восстановление прошивки.

Для других версий контроллера см. Создание microSD-карты с образом.

Информация для разработчиков

Информация о внутреннем устройстве системы обновлений находится на отдельной странице.