Обновление прошивки контроллера Wiren Board

From Wiren Board
Jump to navigation Jump to search

Общая информация

Здесь описывается обновление прошивки контроллера Wiren Board. Если вам нужно обновить прошивку устройств, читайте статью Обновление прошивки Modbus-устройств Wiren Board

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

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

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

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

Частичное обновление прошивки через 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-карты с образом.

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

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