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"

Обновление системы

Полное обновление:

apt-get upgrade -y

Установить один пакет с указанной версией:

apt-get install [имя_пакета]=[версия_пакета]

Пример:

apt-get install wb-mqtt-serial=1.63.0

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

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

ВНИМАНИЕ. Способ не подходит для обновления на версии со «stretch» в названии файла с версий без «stretch». Например, с заводских прошивок WB5 старше середины 2018 года выпуска.

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

Если вы устанавливали собственное ПО или храните свои файлы на контроллере — они будут удалены. Перед обновлением рекомендуем загрузить эти файлы себе на компьютер. Подробнее читайте в инструкции «Просмотр файлов контроллера с компьютера».

Прошивки для контроллеров Wiren Board и периферийных устройств доступны в нашем репозитории.

Прямые ссылки на свежие версии прошивок контроллера:

• 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-накопителя

Момент когда нужно нажать кнопку fw на 1 секунду для продолжения обновления

Сообщение о том что обновление началось

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

Контроллеры Wiren Board 6 могут обновлять прошивку напрямую с USB-накопителя. На время обновления прошивки желательно подключиться к отладочной консоли контроллера — так вы сможете контролировать процесс.

Выполните ряд шагов:

1. USB-накопитель должен быть отформатирован в FAT32. Если в качестве накопителя используется внешний жёсткий диск — убедитесь, что USB-порт контроллера может выдать достаточный ток для запуска диска.
2. Скачайте свежую версию прошивки с расширением .fit для вашего контроллера из нашего репозитория.
3. Сохраните скачанный файл на USB-накопитель в корневой каталог. Переименуйте этот файл в wb6_update.fit.
4. Отключите контроллер.
5. На выключенном контроллере потренируйтесь нажимать кнопку FW — в процессе обновления вам нужно будет делать это быстро и аккуратно. Для этого удобно использовать маленькую отвёртку из комплекта поставки контроллера.
6. Подключите USB-накопитель к первому USB-порту контроллера и включите контроллер.
7. Если USB-накопитель верно распознан, и в корне найден файл wb6_update.fit, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.
8. Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе. В случае ошибки обновления (ошибки в Debag вида FAT: Misaligned buffer address — смените накопитель на другой.
9. Обновление занимает около 5 минут, дождитесь окончания процесса. В процессе обновления контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Можно извлечь USB-накопитель.

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

Момент когда нужно кратковременно нажать кнопку «fw» для сброса к заводским настройкам

Момент когда нужно на 4 секунды нажать кнопку «fw» для подтверждения сброса к заводским настройкам

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

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

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

1. Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ Или скачайте «disk.img» по ссылкам ниже, скопируйте на флешку и переходите к прошивке.
   • Пример ссылки на файл для WB6 http://fw-releases.wirenboard.com/fit_image/stable/6x/2020-08-31_13%3A15%3A20.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. Процесс сброса занимает несколько минут. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Можно извлечь USB-накопитель.

Образ флешки для 6.6 disk.img

Образ флешки для 6.7 disk.img

Скачанный файл disk.img можно скопировать на флешку с помощью:

• Linux — dd if=disk.img of=[Путь_к_блочному_устройству]
• Windows — c помощью свободно распространяемой программы win32diskimager

ВНИМАНИЕ: Все содержимое флеш-накопителя будет безвозвратно потеряно!

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

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

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

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

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