Wiren Board Firmware Update: различия между версиями

Материал из Wiren Board
м (→‎Обновление прошивки целиком: Исправили баг — убрал предупреждение.)
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}}
== Общая информация ==
== Общая информация ==
Здесь описывается обновление прошивки контроллера Wiren Board. Если вам нужно обновить прошивку устройств, читайте статью [[WB Modbus Devices Firmware Update | Обновление прошивки Modbus-устройств Wiren Board
Эта статья описывает обновление прошивки контроллера Wiren Board 6, процедуру обновления Wiren Board 5, смотрите в статье [[#Wiren Board 5 Firmware Update | Обновление прошивки контроллера Wiren Board 5]].
]]
== Файлы прошивок ==
Файлы прошивок нужны для полного обновления прошивки через веб-интерфейс или с помощью USB-накопителя.


Прошивки для контроллеров Wiren Board и периферийных устройств доступны в нашем [http://fw-releases.wirenboard.com/ репозитории].
Прошивку контроллера Wiren Board 6 можно обновить через менеджер пакетов <code>apt</code> или через fit-файл: с помощью флешки или через веб-интерфейс. Также контроллер можно сбросить к заводским настройкам с удалением всех пользовательских данных.


Прямые ссылки на свежие версии прошивок контроллера:
== Как узнать, что нужно обновиться ==
* WB 5.8.x-5.9 - [http://fw-releases.wirenboard.com/fit_image/stable/58/latest_stretch.fit 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 http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit]
# Подключитесь к контроллеру через [[SSH]].
* WB 6.7.X и WB 6.8.X - [http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit]
# Выполните команду:
#:<syntaxhighlight lang="console" highlight="14">
# apt update
Ign:1 http://deb.debian.org/debian stretch InRelease
Get:2 http://security.debian.org stretch/updates InRelease [53.0 kB]
Hit:3 http://deb.debian.org/debian stretch-updates InRelease
Hit:4 http://deb.debian.org/debian stretch Release
Get:5 http://deb.wirenboard.com/wb6/stretch testing InRelease [3960 B]
Get:6 http://cdn-fastly.deb.debian.org/debian stretch-backports InRelease [91.8 kB]
Get:7 http://security.debian.org stretch/updates/main armhf Packages [687 kB]
Get:9 http://deb.wirenboard.com/wb6/stretch testing/main armhf Packages [59.5 kB]
Fetched 895 kB in 10s (82.9 kB/s)
Reading package lists... Done
Building dependency tree
Reading state information... Done
2 packages can be upgraded. Run 'apt list --upgradable' to see them.
</syntaxhighlight>
#: в конце вывода будет показано, сколько пакетов можно обновить.
# Если есть пакеты для обновления, то мы можем посмотреть их список:
#:<syntaxhighlight lang="console" highlight="3-4">
# apt list --upgradable
Listing... Done
wb-hwconf-manager/testing 1.40.1 all [upgradable from: 1.40.0]
wb-release-info/testing 1.0-testing~wb6+stretch~20210831210334 all [upgradable from: 1.0-testing~wb6+stretch~20210830090128]
</syntaxhighlight>
#: в примере доступны обновления пакетов <code>wb-hwconf-manager</code> и <code>wb-release-info</code>.


== Частичное обновление прошивки через APT ==
== Обновление через apt ==
[[Image: Dialog.png |350px|thumb|right| Окно Modified configuration Files ]]
Apt — это менеджер пакетов операционной системы Debian, который обновляет только изменившееся пакеты. Мы рекомендуем этот способ обновления.
Обновление прошивки производится по частям с помощью системного менеджера пакетов операционной системы Debian.


=== Пользовательские файлы и настройки ===
=== Сохранение пользовательских файлов и настроек ===
Будьте внимательны при работе с утилитой APT: читайте предупреждения и соглашайтесь на действия только если понимаете последствия. Неосторожность может привести к неполной установке или к удалению компонентов ПО контроллера Wiren Board.
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
Apt по умолчанию сохраняет пользовательские файлы и установленные программы, но может запросить перезапись файлов конфигурации с помощью окна '''Modified configuration Files'''. В этом случае выберите, что делать:
* keep the local version currently installed — не изменять файлы и сохранить ваши настройки.
* install the packade maintainer`s version — заменить версиями из обновляемого пакета и потерять ваши настройки.


При обновлении пакетов, пользовательские данные остаются без изменений, но может появиться запрос на перезапись файлов конфигурации '''Modified configuration Files'''.
=== Обновление ===
 
Чтобы автоматически обновить систему:
В этом случае выберите, что делать с вашими файлами конфигурации:
# Подключитесь к контроллеру через [[SSH]].
* ''keep the local version currently installed'' — не изменять файлы и сохранить ваши настройки.
# Выполните команды:
* ''install the packade maintainer`s version'' — заменить версиями из обновляемого пакета и потерять ваши настройки.
#:<syntaxhighlight lang="bash">
 
apt update && apt upgrade
=== Обновление списка пакетов ===
Перед началом работы нужно получить актуальный список пакетов из репозиториев Debian и Wiren Board:
<syntaxhighlight lang="bash">
apt-get update
</syntaxhighlight>
</syntaxhighlight>


=== Обновление системы ===
В процессе обновления в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>.


Полное обновление:
== Обновление через fit-файл ==
<syntaxhighlight lang="bash">
fit-файл — это зашифрованный образ прошивки контроллера Wiren Board, скачать его можно по ссылкам:
apt upgrade
* [http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ Все прошивки контроллера с группировкой по ревизиям ]
</syntaxhighlight>
* [http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit Wiren Board 6.3­-6.6.0]
* [http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit Wiren Board 6.7.x-6.8.x]


Установить один пакет с указанной версией:
Скачать можно только stable-релиз.
<syntaxhighlight lang="bash">
apt install [имя_пакета]=[версия_пакета]
</syntaxhighlight>
''Пример:''
<syntaxhighlight lang="bash">
apt install wb-mqtt-serial=1.63.0
</syntaxhighlight>
 
== Обновление прошивки целиком ==


Обновление целиком — это при использовании fit-файла прошивки без сброса к заводским настройкам.
=== Сохранение пользовательских файлов и настроек ===
[[Image: Etc-wbconfigs.png |400px|thumb|right| Файлы настроек, которые сохраняются при обновлении через fit-файл<code>/mnt/data/etc</code> ]]
При обновлении сохраняется раздел <code>/mnt/data</code>, в котором по адресу <code>/mnt/data/etc</code> находятся настройки:
* системные: сеть, часовой пояс, пароль к веб-интерфейсу;
* устройств, подключенных по RS-485 <code>wb-mqtt-serial.conf</code>;
* модулей ввода-вывода и расширения <code>wb-hardware.conf</code>;
* универсальных входов/выходов A1-A4 <code>wb-homa-adc.conf</code>;
* выводов GPIO контроллера <code>wb-homa-gpio.conf</code>;
* Modbus TCP/Slave шлюза <code>wb-mqtt-mbgate.conf</code>.


[[Image: Etc-wbconfigs.png |350px|thumb|right| Содержимое директории <code>/etc/</code> ]]
Также будут сохранены пользовательские скрипты в папке <code>/etc/wb-rules/</code> и модули в папке <code>/etc/wb-rules-modules</code>.


=== Пользовательские файлы и настройки ===
Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки <code>/mnt/data</code> — они будут удалены. Подключите контроллер к компьютеру для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]] и скопируйте свои файлы на компьютер. Если вы хотите сохранить установленные программы, то используйте [[#Обновление через apt | обновление через apt]].
Если вы хранили свои файлы на контроллере, то при обновлении они будут удалены, поэтому рекомендуем сделать их резервную копию, подключив контроллер к ПК для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]].


При обновлении сохраняются:
=== Обновление через веб-интерфейс ===
* системные настройки: сеть, часовой пояс, пароль к веб-интерфейсу.
{{Wbincludes:WebUI Change Access Level}}
* устройства, подключенные по RS-485, <code>/etc/wb-mqtt-serial.conf</code>;
* модули ввода-вывода и расширения <code>/etc/wb-hardware.conf</code>;
* настройки универсальных входов/выходов A1-A4 <code>/etc/wb-homa-adc.conf</code>;
* пользовательские скрипты <code>/etc/wb-rules/</code>;
* настройки выводов GPIO контроллера <code>/etc/wb-homa-gpio.conf</code>;
* настройки Modbus TCP/Slave шлюза <code>/etc/wb-mqtt-mbgate.conf</code>.


=== Обновление прошивки через веб-интерфейс ===
Обновите контроллер:
# Скачайте [[#Обновление через fit-файл  | fit-файл прошивки]] к себе на компьютер.
{{note|note|Этот способ не подходит для обновления на версии со «stretch» в названии файла с версий без «stretch». Например, с заводских прошивок WB5 старше середины 2018 года выпуска.}}
# Зайдите в веб-интерфейс и перейдите '''Settings''' → '''System'''.
# Нажмите кнопку '''Select File''' и выберите скачанный ранее fit-файл.
# Файл с прошивкой загрузится на контроллер и начнётся процесс обновления, который длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения обновления.
# После обновления контроллер перезагрузится и на странице появится надпись '''Firmware update complete''' — обновление завершено.
# Закройте страницу.


При обновлении прошивки происходит перезапись раздела накопителя контроллера с операционной системой и установленными программами. Настройки, сделанные из веб-интерфейса, а также подключенные устройства и виджеты находятся на другом разделе и не затрагиваются обновлением.
<gallery mode="traditional " widths ="350px" heights="250px">
Image: web-settings.png | Нажмите кнопку '''Select file''' и выберите fit-файл
Image: Web-settings-firmware-update-messages.png | Во время обновления на страницу выводятся системные сообщения
Image: Web-settings-firmware-update-completed.png | Оповещение об успешном обновлении
</gallery>


# Скачайте [[#Файлы прошивок | файл прошивки]] к себе на компьютер, зайдите в [[Веб-интерфейс Wiren Board|веб-интерфейс]]: страница '''Settings''' → раздел '''Firmware update'''. Нажмите кнопку '''Select file''' и выберите ранее скаченный файл прошивки. [[File:web-settings.png|400px|thumb|center|Нажмите кнопку '''Select file''' для загрузки файла прошивки]]
=== Обновление с USB-накопителя и сброс к заводским настройкам ===
# Файл с прошивкой загрузится на контроллер и начнется процесс обновления. Во время обновления не закрывайте страницу, не переключайтесь между разделами и не выключайте контроллер. Обновление завершится в течение 10 минут. [[File:Web-settings-firmware-update-messages.png|400px|center|thumb|Во время обновления на странице появляются системные сообщения]]
Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в [[WB_6:_Errata]].
# После обновления контроллер перезагрузится и на странице появится сообщение об успешном обновлении — '''Firmware update complete'''. [[File:Web-settings-firmware-update-completed.png|400px|center|thumb|Оповещение об успешном обновлении]]


=== Обновление прошивки с помощью USB-накопителя ===
Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски.
[[File:2 update.png|200px|thumb|right|Момент, когда нужно нажать кнопку FW на 1 секунду для продолжения обновления]]
[[File:4 update.png|200px|thumb|right|Сообщение о том, что обновление началось]]


'''ВНИМАНИЕ:''' в некоторых версиях контроллера есть аппаратные сложности с обновлением прошивки с USB-накопителя. Если вы столкнулись с этой проблемой, прочитайте [[WB 6: Errata]].
Подготовьте флеш-накопитель:
# [[Formatting Flash Drive | Отформатируйте флешку FAT32]].
# Скачайте [[#Обновление через fit-файл  | fit-файл прошивки]] к себе на компьютер.
# Сохраните скачанный ''.fit''-файл в корень флешки, убедитесь, что размер файла не равен нулю.
# Переименуйте файл на флешке:
#* '''для обновления прошивки''' контроллера в <code>wb6_update.fit</code>,
#* '''для сброса контроллера''' к заводским настройкам в <code>wb6_update_FACTORYRESET.fit</code>.


Контроллеры Wiren Board 6 могут обновлять прошивку напрямую с USB-флешки. На время обновления прошивки желательно подключиться к [[WB_Debug_Console|отладочной консоли]] контроллера — так вы сможете контролировать процесс.
'''Чтобы обновить прошивку''':
 
Для обновления прошивки выполните ряд шагов:
# [[Formatting Flash Drive | Отформатируйте флеш-накопитель в FAT32]]. Мы не рекомендуем использовать внешние жесткие диски.
# Скачайте [[#Файлы прошивок  | свежую версию прошивки]]  с расширением ''.fit'' для вашего контроллера.
# Сохраните скачанный ''.fit'' файл на флешку в корневой каталог и переименуйте его в <code>wb6_update.fit</code>. Убедитесь, что размер файла не равен 0 Кб.
# Отключите контроллер.
# Отключите контроллер.
# Подключите USB-накопитель к первому слева USB-порту контроллера и включите контроллер.
# Подключите флешку к первому слева USB-порту контроллера и включите его.
# Если USB-накопитель верно распознан, и в корне найден файл <code>wb6_update.fit</code>, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.  
# Если флешка верно распознана, и в корне найден файл <code>wb6_update.fit</code> — индикатор контроллера начнёт часто мигать оранжевым.
# Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе. В случае ошибки обновления (ошибки в Debug вида <code>FAT: Misaligned buffer address</code> — смените накопитель на другой.
# В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.
# Обновление занимает около 5 минут, дождитесь окончания процесса. В процессе обновления контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Флешку можно извлечь.
# Индикатор контроллера начнет мигать красным, затем часто зелёным.
# Дождитесь окончания процесса, который длится 5–10 минут. В процессе контроллер один раз перезагрузится, а в конце загрузится в штатном режиме и индикатор на нём замигает зелёным — флешку можно извлечь.


== Сброс Wiren Board 6 к заводским настройкам ==
'''Чтобы сбросить контроллер''' и удалить все данные:
[[File:1 factory reset.png|200px|thumb|right|Момент, когда нужно кратковременно нажать кнопку FW для сброса к заводским настройкам]]
[[File:2 factory reset.png|200px|thumb|right|Момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения сброса к заводским настройкам]]
[[File:3 factory reset.png|200px|thumb|right|Сообщение о том, что сброс к заводским настройкам начался]]
Сбросить контроллер к заводским настройкам можно только через USB флеш-накопитель и файл прошивки с особым именем:  <code>wb6_update_FACTORYRESET.fit</code>.
 
На время сброса контроллера желательно подключиться к [[WB_Debug_Console|отладочной консоли]] контроллера — так вы сможете контролировать процесс.
 
=== Пользовательские файлы и настройки ===
При сбросе контроллера настройки, правила и все пользовательские файлы будут удалены! Если вы хотите сохранить свои файлы и настройки — сделайте их резервную копию, подключив контроллер к ПК для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]].
 
=== Создание флеш-накопителя копированием файла прошивки ===
 
# [[Formatting Flash Drive | Отформатируйте флеш-накопитель в FAT32]].
# Скачайте [[#Файлы прошивок  | свежую версию прошивки]]  с расширением ''.fit'' для вашего контроллера.
# Сохраните скачанный ''.fit'' файл на флеш-накопитель в корневой каталог и переименуйте его в <code>wb6_update_FACTORYRESET.fit</code>. Убедитесь, что размер файла не равен 0 Кб.
 
Флеш-накопитель для сброса контроллера готов.
 
=== Процедура сброса ===
 
Для сброса контроллера выполните ряд шагов:
# Отключите контроллер.
# Отключите контроллер.
# Подключите флеш-накопитель к первому USB-порту контроллера и включите контроллер.
# Подключите флешку к первому слева USB-порту контроллера и включите его.
# Если флеш-накопитель верно распознан, и в корне найден файл <code>wb6_update_FACTORYRESET.fit</code> — светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно отрывисто нажать на кнопку FW на плате контроллера.  
# Если флешка верно распознана, и в корне найден файл <code>wb6_update_FACTORYRESET.fit</code> — индикатор контроллера начнёт часто мигать оранжевым.
# Индикатор контроллера сперва загорится зеленым, потом пару раз мигнет красным и еще пару раз мигнет зеленым.
# В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.
# Контроллер начнет пищать, а индикатор будет мигать красным — это значит, что контроллер ждет подтверждение полной очистки.
# Сперва индикатор загорится зелёным, потом пару раз мигнет красным и ещё пару раз мигнет зелёным.
# Чтобы сбросить контроллер и удалить все данные — зажмите кнопку FW более четырех секунд. Писк станет прерывистым, а индикатор продолжит мигать красным — не отпускайте кнопку.
# После этого контроллер начнёт пищать, а индикатор будет мигать красным — это значит, что контроллер ждет подтверждение полной очистки.
# Подтвердите удаление всех данных, для этого зажмите кнопку FW более четырех секунд.
# Писк станет прерывистым, а индикатор продолжит мигать красным — не отпускайте кнопку.
# Когда писк и мигание прекратятся — кнопку можно отпустить. Начнется процедура сброса контроллера.
# Когда писк и мигание прекратятся — кнопку можно отпустить. Начнется процедура сброса контроллера.
# Процедура сброса занимает 5–10 минут, дождитесь окончания процесса. В процессе сброса контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Флеш-накопитель можно извлечь.
# Дождитесь окончания процесса, который длится 5–10 минут. В процессе контроллер один раз перезагрузится, а в конце загрузится в штатном режиме и индикатор на нём замигает зелёным — флешку можно извлечь.
 
== Перезапись прошивки Wiren Board 5 ==


Для Wiren Board 5 см. [[Wiren Board 5: Восстановление прошивки|Wiren Board 5: Восстановление прошивки]].
Если обновление или сброс завершаются с ошибкой, подключитесь к [[WB_Debug_Console | Debug-консоли]] контроллера и повторите шаги. Если увидите ошибку <code>FAT: Misaligned buffer address</code> — смените накопитель на другой.


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


== Информация для разработчиков ==
<gallery mode="traditional " widths ="450px" heights="250px">
Image: 2 update.png | Debug-консоль: момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления
Image: 4 update.png | Debug-консоль: обновление прошивки началось
</gallery>


Информация о внутреннем устройстве системы см. в статье [[WB Firmware Update Details|Обновление прошивки, информация для разработчиков]].
<gallery mode="traditional " widths ="300px" heights="250px">
Image: 1 factory reset.png | Debug-консоль: момент, когда нужно кратковременно нажать кнопку FW для сброса к заводским настройкам
Image: 2 factory reset.png | Debug-консоль: момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения сброса к заводским настройкам
Image: 3 factory reset.png | Debug-консоль: начался ′сброс к заводским настройкам
</gallery>

Версия 14:01, 1 сентября 2021

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

Эта статья описывает обновление прошивки контроллера Wiren Board 6, процедуру обновления Wiren Board 5, смотрите в статье Обновление прошивки контроллера Wiren Board 5.

Прошивку контроллера Wiren Board 6 можно обновить через менеджер пакетов apt или через fit-файл: с помощью флешки или через веб-интерфейс. Также контроллер можно сбросить к заводским настройкам с удалением всех пользовательских данных.

Как узнать, что нужно обновиться

В контроллере нет механизма, который сообщит об обновлении, поэтому о выходе новых версий вы можете узнать из новостей в наших социальных сетях, или в консоли контроллера:

  1. Подключитесь к контроллеру через SSH.
  2. Выполните команду: 
    # apt update
Ign:1 http://deb.debian.org/debian stretch InRelease
Get:2 http://security.debian.org stretch/updates InRelease [53.0 kB]
Hit:3 http://deb.debian.org/debian stretch-updates InRelease
Hit:4 http://deb.debian.org/debian stretch Release
Get:5 http://deb.wirenboard.com/wb6/stretch testing InRelease [3960 B]
Get:6 http://cdn-fastly.deb.debian.org/debian stretch-backports InRelease [91.8 kB]
Get:7 http://security.debian.org stretch/updates/main armhf Packages [687 kB]
Get:9 http://deb.wirenboard.com/wb6/stretch testing/main armhf Packages [59.5 kB]
Fetched 895 kB in 10s (82.9 kB/s)
Reading package lists... Done
Building dependency tree
Reading state information... Done
2 packages can be upgraded. Run 'apt list --upgradable' to see them.
    в конце вывода будет показано, сколько пакетов можно обновить.
  3. Если есть пакеты для обновления, то мы можем посмотреть их список: 
    # apt list --upgradable
Listing... Done
wb-hwconf-manager/testing 1.40.1 all [upgradable from: 1.40.0]
wb-release-info/testing 1.0-testing~wb6+stretch~20210831210334 all [upgradable from: 1.0-testing~wb6+stretch~20210830090128]
    в примере доступны обновления пакетов wb-hwconf-manager и wb-release-info.

Обновление через apt

Apt — это менеджер пакетов операционной системы Debian, который обновляет только изменившееся пакеты. Мы рекомендуем этот способ обновления.

Сохранение пользовательских файлов и настроек

Окно Modified configuration Files

Apt по умолчанию сохраняет пользовательские файлы и установленные программы, но может запросить перезапись файлов конфигурации с помощью окна Modified configuration Files. В этом случае выберите, что делать:

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

Обновление

Чтобы автоматически обновить систему:

  1. Подключитесь к контроллеру через SSH.
  2. Выполните команды: 
    apt update && apt upgrade

В процессе обновления в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести Y.

Обновление через fit-файл

fit-файл — это зашифрованный образ прошивки контроллера Wiren Board, скачать его можно по ссылкам:

Скачать можно только stable-релиз.

Сохранение пользовательских файлов и настроек

Файлы настроек, которые сохраняются при обновлении через fit-файл/mnt/data/etc

При обновлении сохраняется раздел /mnt/data, в котором по адресу /mnt/data/etc находятся настройки:

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

Также будут сохранены пользовательские скрипты в папке /etc/wb-rules/ и модули в папке /etc/wb-rules-modules.

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

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

Уровень «Администратор»

Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.

После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.

Обновите контроллер:

  1. Скачайте fit-файл прошивки к себе на компьютер.
  2. Зайдите в веб-интерфейс и перейдите Settings → System.
  3. Нажмите кнопку Select File и выберите скачанный ранее fit-файл.
  4. Файл с прошивкой загрузится на контроллер и начнётся процесс обновления, который длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения обновления.
  5. После обновления контроллер перезагрузится и на странице появится надпись Firmware update complete — обновление завершено.
  6. Закройте страницу.

  • Нажмите кнопку Select file и выберите fit-файл

  • Во время обновления на страницу выводятся системные сообщения

  • Оповещение об успешном обновлении

Обновление с USB-накопителя и сброс к заводским настройкам

Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в WB_6:_Errata.

Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски.

Подготовьте флеш-накопитель:

  1. Отформатируйте флешку FAT32.
  2. Скачайте fit-файл прошивки к себе на компьютер.
  3. Сохраните скачанный .fit-файл в корень флешки, убедитесь, что размер файла не равен нулю.
  4. Переименуйте файл на флешке:
    • для обновления прошивки контроллера в wb6_update.fit,
    • для сброса контроллера к заводским настройкам в wb6_update_FACTORYRESET.fit.

Чтобы обновить прошивку:

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

Чтобы сбросить контроллер и удалить все данные:

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

Если обновление или сброс завершаются с ошибкой, подключитесь к Debug-консоли контроллера и повторите шаги. Если увидите ошибку FAT: Misaligned buffer address — смените накопитель на другой.


  • Debug-консоль: момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления

  • Debug-консоль: обновление прошивки началось

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

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

  • Debug-консоль: начался ′сброс к заводским настройкам

Источник — https://wirenboard.com/wiki/index.php?title=Wiren_Board_Firmware_Update&oldid=54221