Wiren Board Firmware Update

Файлы прошивок

Файлы прошивок нужны для полного обновления прошивки через веб-интерфейс или с помощью USB-накопителя.

Прошивки для контроллеров 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 и 6.8) - http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit
• WB 6.7.X и WB 6.8.X - http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit

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

Окно Modified configuration Files

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

Пользовательские файлы и настройки

Будьте внимательны при работе с утилитой APT: читайте предупреждения и соглашайтесь на действия только если понимаете последствия. Неосторожность может привести к неполной установке или к удалению компонентов ПО контроллера Wiren Board.

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

В этом случае выберите, что делать с вашими файлами конфигурации:

• keep the local version currently installed — не изменять файлы и сохранить ваши настройки.
• install the packade maintainer`s version — заменить версиями из обновляемого пакета и потерять ваши настройки.

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

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

apt-get update

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

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

apt upgrade

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

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

Пример:

apt install wb-mqtt-serial=1.63.0

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

Обновление целиком — это при использовании fit-файла прошивки без сброса к заводским настройкам.

Содержимое директории /etc/

Пользовательские файлы и настройки

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

При обновлении сохраняются:

• системные настройки: сеть, часовой пояс, пароль к веб-интерфейсу.
• устройства, подключенные по RS-485, /etc/wb-mqtt-serial.conf;
• модули ввода-вывода и расширения /etc/wb-hardware.conf;
• настройки универсальных входов/выходов A1-A4 /etc/wb-homa-adc.conf;
• пользовательские скрипты /etc/wb-rules/;
• настройки выводов GPIO контроллера /etc/wb-homa-gpio.conf.

ВНИМАНИЕ: при обновлении не сохраняется файл настроек Modbus TCP/Slave шлюза: /etc/wb-mqtt-mbgate.conf — сохраните этот файл вручную. Сохранение будет автоматизировано в одной из следующих версий ПО.

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

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

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

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. Отформатируйте флеш-накопитель в FAT32. Инструкция по форматированию накопителя. Мы не рекомендуем использовать внешние жесткие диски.
2. Скачайте свежую версию прошивки с расширением .fit для вашего контроллера.
3. Сохраните скачанный .fit файл на флешку в корневой каталог и переименуйте его в wb6_update.fit. Убедитесь, что размер файла не равен 0 Кб.
4. Отключите контроллер.
5. Подключите USB-накопитель к первому USB-порту контроллера и включите контроллер.
6. Если USB-накопитель верно распознан, и в корне найден файл wb6_update.fit, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.
7. Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе. В случае ошибки обновления (ошибки в Debug вида FAT: Misaligned buffer address — смените накопитель на другой.
8. Обновление занимает около 5 минут, дождитесь окончания процесса. В процессе обновления контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Флешку можно извлечь.

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

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

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

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

Сбросить контроллер к заводским настройкам можно только через USB флеш-накопитель и файл прошивки с особым именем: wb6_update_FACTORYRESET.fit.

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

Пользовательские файлы и настройки

При сбросе контроллера настройки, правила и все пользовательские файлы будут удалены! Если вы хотите сохранить свои файлы и настройки — сделайте их резервную копию, подключив контроллер к ПК для просмотра файлов.

Создание флеш-накопителя копированием файла прошивки

1. Отформатируйте флеш-накопитель в FAT32. Инструкция по форматированию накопителя.
2. Скачайте свежую версию прошивки с расширением .fit для вашего контроллера.
3. Сохраните скачанный .fit файл на флеш-накопитель в корневой каталог и переименуйте его в wb6_update_FACTORYRESET.fit. Убедитесь, что размер файла не равен 0 Кб.

Флеш-накопитель для сброса контроллера готов.

Процедура сброса

Для сброса контроллера выполните ряд шагов:

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

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

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

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

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

Информация о внутреннем устройстве системы см. в статье Обновление прошивки, информация для разработчиков.