Wiren Board Firmware Update

Материал из Wiren Board


Частичное обновление прошивки через 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. Скачайте свежую версию прошивки со страницы https://github.com/contactless/wirenboard/releases. Файлы прошивок имеют расширение .fit.
    Файл прошивки с расширением .fit на Github
  3. Зайдите в веб-интерфейс на страницу Settings. Найдите раздел Firmware update, нажмите кнопку Select file, выберите ранее скачанный файл прошивки.
    Нажмите кнопку Select file для загрузки файла прошивки
  4. Файл с новой прошивкой загрузится на контроллер, после этого начнётся процесс обновления. Не закрывайте страницу обновления и не производите никаких действий с контроллером, в том числе в веб-интерфейсе. Процесс обновления займёт до 10 минут.
    Во время обновления на странице появляются системные сообщения
  5. После установки новой прошивки контроллер перезагрузится. После этого на странице обновления появится сообщение об успешном завершении обновления - Firmware update complete.
    Оповещение об успешном обновлении

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

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

Алгоритм обновления похож на тот, что используется при обновлении через Web-интерфейс. Для обновления используется образ прошивки с расширением .fit.

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

  1. USB-накопитель должен быть отформатирован в FAT32. Если в качестве накопителя используется внешний жёсткий диск, следует также убедиться, что USB-порт контроллера может выдать достаточный ток для запуска диска.
  2. Скачайте свежую версию прошивки для Вашего контроллера со страницы [1].
  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. Файл на USB-накопителе нужно назвать wb6_update_FACTORYRESET.fit.
  2. После нажатия на кнопку FW через некоторое время контроллер начнёт издавать писк, а светодиод начнёт часто мигать красным. В этот момент требуется зажать кнопку FW более чем на 4 секунды. Писк станет прерывистым. Пока писк и мигание продолжаются, кнопку нужно держать нажатой. Когда писк и мигание прекратятся, кнопку можно отпустить. Это нажатие требуется для подтверждения сброса настроек.
  3. В остальном выполняйте те же действия, как при обычном обновлении c USB-накопителя.

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

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

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

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

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