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 года выпуска.
- Обновление прошивки происходит путём перезаписи раздела накопителя контроллера с операционной системой и всеми установленными программами. При этом не затрагиваются файлы, находящиеся в папках (они находятся в другом разделе). Подробнее ознакомиться с файлами, удаляющимися при обновлении системы, можно в разделе Потеря файлов при обновлении ПО
- В этих папках хранятся все изменения, которые можно сделать через веб-интерфейс, включая настройки со страницы Configs, все подключённые устройства и виджеты - все эти данные сохранятся.
- Если вы хранили данные на контроллере самостоятельно в других папках, или устанавливали собственное ПО, оно будет потеряно. Вы можете загрузить нужные файлы себе на компьютер перед обновлением по инструкции Просмотр файлов контроллера с компьютера.
- Свежие версии прошивок (как для контроллеров 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
- Зайдите в веб-интерфейс, на страницу Settings. Найдите раздел Firmware update, нажмите кнопку Select file, выберите ранее скачанный файл прошивки.
- Файл с новой прошивкой загрузится на контроллер, после этого начнётся процесс обновления. Не закрывайте страницу обновления и не производите никаких действий с контроллером, в том числе в веб-интерфейсе. Процесс обновления займёт до 10 минут.
- После установки новой прошивки контроллер перезагрузится. После этого на странице обновления появится сообщение об успешном завершении обновления - Firmware update complete.
Обновление прошивки с помощью USB-накопителя
ВНИМАНИЕ: в некоторых версиях контроллера есть аппаратные сложности с обновлением прошивки с использованием USB-накопителя. Если вы столкнулись с какой-либо проблемой, прочитайте WB 6: Errata.
В контроллерах Wiren Board 6 добавлена возможность обновления прошивки с использованием USB-накопителя (флешки).
На время обновления желательно подключиться к отладочной консоли контроллера, чтобы контролировать ход обновления.
- USB-накопитель должен быть отформатирован в FAT32. Если в качестве накопителя используется внешний жёсткий диск, следует также убедиться, что USB-порт контроллера может выдать достаточный ток для запуска диска.
- Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы https://github.com/contactless/wirenboard/releases.
- Сохраните скачанный файл на USB-накопитель в корневой каталог. Переименуйте этот файл в
wb6_update.fit
. - Отключите контроллер.
- На выключенном контроллере потренируйтесь нажимать кнопку FW - в процессе обновления вам нужно будет делать это быстро и аккуратно. Для этого удобно использовать маленькую отвёртку из комплекта поставки контроллера.
- Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер.
- Если USB-накопитель корректно распознан, и в корне найден файл
wb6_update.fit
, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды. - Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе.
- Дождитесь окончания процесса обновления, это займёт около 5 минут. В процессе обновления контроллер один раз перезагрузится. Обновление завершено, когда светодиод контроллера начинает мигать зелёным, как в штатном режиме работы. Можно извлечь USB-накопитель.
Сброс Wiren Board 6 к заводским настройкам
ВНИМАНИЕ: сбросить к заводским настройкам можно ТОЛЬКО через USB-накопитель с ОСОБЫМ именем файла прошивки.
ВНИМАНИЕ: при сбросе все пользовательские данные (конфигурация, правила, файлы в домашней директории) будут уничтожены!
- Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы https://github.com/contactless/wirenboard/releases
- Пример ссылки на файл для WB6 https://github.com/wirenboard/wirenboard/releases/download/0.47-20200217/202002171718_webupd_wb6x_stretch.fit
- Проверьте USB накопитель, тип файловой системы должен быть fat32. Инструкция https://remontka.pro/format-usb-fat-32/
- Скопируйте скачанный файл на USB-накопитель и перименуйте его в
wb6_update_FACTORYRESET.fit
Имя файла и расширение должно быть именно таким.- Убедитесь что размер файла не "0".
- Отключите контроллер от питания.
- Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер.
- как только контроллер замигает оранжевым, отрывисто нажмите на кнопку FW первый раз;
- после этого светодиод станет постоянно гореть зелёным, потом пару раз мигнёт красным, потом пару раз мигнёт зелёным. Потом контроллер начнёт издавать писк, а светодиод при этом будет часто мигать красным - это значит, что контроллер ожидает подтверждения полной очистки. Чтобы подтвердить удаление всех данных и сбросить контроллер в заводское состояние нужно зажать кнопку FW более, чем на 4 секунды. Писк станет прерывистым. Пока писк и мигание продолжаются, кнопку нужно держать нажатой. Когда писк и мигание прекратятся, кнопку можно отпустить.
- Процесс сброса занимает несколько минут.
Перезапись прошивки Wiren Board 5
Для Wiren Board 5 см. Wiren Board 5: Восстановление прошивки.
Для других версий контроллера см. Создание microSD-карты с образом.
Информация для разработчиков
Информация о внутреннем устройстве системы обновлений находится на отдельной странице.