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

Материал из Wiren Board
м
(Перенаправление на Wiren Board Software)
Метка: новое перенаправление
 
(не показана 161 промежуточная версия 9 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}}
#REDIRECT [[Wiren_Board_Software]]
== Общая информация ==
Эта статья описывает обновление прошивки контроллера Wiren Board 6 и контроллера Wiren Board 5 с версией прошивки 0.38-20180710 и выше, если у вас другой контроллер — читайте раздел [[#Обновление прошивки контроллеров старых версий | Обновление прошивки контроллеров старых версий]].
 
Прошивку контроллера Wiren Board можно обновить через менеджер пакетов '''apt''' или через '''fit-файл''': с помощью флешки или через веб-интерфейс.
 
Также контроллер можно сбросить к заводским настройкам и удалить пользовательские данные.
 
== Проверка обновлений ==
В контроллере нет механизма, который сообщит пользователю о доступном обновлении, поэтому о выходе новых версий вы можете узнать из новостей в наших социальных сетях, или в консоли контроллера:
# Подключитесь к контроллеру через [[SSH]].
# Выполните команду <code>apt update</code>:
#:<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>
#: в конце вывода будет показано, какие пакеты нуждаются в обновлении.
# Если есть пакеты для обновления, то можете посмотреть их список с помощью команды <code>apt list --upgradable</code>:
#:<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 — это менеджер пакетов операционной системы Debian, который обновляет только те пакеты, которые изменились.
 
=== Сохранение пользовательских файлов и настроек ===
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
Apt сохраняет пользовательские файлы и установленные программы, но может запросить перезапись файлов конфигурации с помощью окна '''Modified configuration Files''', в котором нужно выбрать один из пунктов:
* install the packade maintainer`s version — заменить версией из обновляемого пакета и потерять ваши настройки.
* keep the local version currently installed — не заменять файл и сохранить ваши настройки.
* show the differences between the versions — посмотреть различия между версиями.
* show a side-by-side difference between the versions — посмотреть различия между версиями и оба варианта файла настроек.
* start a new shell to examine the situation — открыть командную строку, чтобы разобраться в ситуации.
 
=== Обновление ===
Чтобы обновить прошивку контроллера:
# Подключитесь к нему по [[SSH]].
# Выполните команды:
#:<syntaxhighlight lang="bash">
apt update && apt upgrade
</syntaxhighlight>
 
В процессе обновления в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>.
 
== Обновление через fit-файл ==
Fit-файл — это образ прошивки контроллера Wiren Board, который можно скачать в [http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ нашем репозитории]
 
Загрузить текущий stable-релиз можно по прямым ссылкам:
* [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]
 
=== Сохранение пользовательских файлов и настроек ===
[[Image: Etc-wbconfigs.png |400px|thumb|right| Файлы настроек, которые сохраняются при обновлении через fit-файл]]
При обновлении сохраняется раздел <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>.
 
Также будут сохранены пользовательские скрипты в папке <code>/etc/wb-rules/</code> и модули в папке <code>/etc/wb-rules-modules</code>.
 
Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки <code>/mnt/data</code> — они будут удалены. Подключите контроллер к компьютеру для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]] и скопируйте свои файлы на компьютер. Если вы хотите сохранить установленные программы, то используйте [[#Обновление через apt | обновление через apt]].
 
=== Обновление через веб-интерфейс ===
{{Wbincludes:WebUI Change Access Level}}
 
Чтобы обновить прошивку контроллера:
# Скачайте [[#Обновление через fit-файл  | fit-файл прошивки]] на компьютер.
# Зайдите в [[Wiren Board Web Interface | веб-интерфейс]] контроллера и перейдите в раздел '''Settings''' → '''System'''.
# Нажмите кнопку '''Select File''' и выберите скачанный ранее fit-файл.
# Файл с прошивкой загрузится на контроллер и начнётся процесс обновления, который длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения обновления.
# После обновления контроллер перезагрузится и на странице появится надпись '''Firmware update complete''' — обновление завершено.
# Закройте страницу.
 
<gallery mode="traditional " widths ="350px" heights="210px">
Image: web-settings.png | Нажмите кнопку '''Select file''' и выберите fit-файл
Image: Web-settings-firmware-update-messages.png | Во время обновления на страницу выводятся системные сообщения
Image: Web-settings-firmware-update-completed.png | Оповещение об успешном обновлении
</gallery>
 
=== Обновление с USB-накопителя и сброс к заводским настройкам ===
[[Image: WB6.7 USB1 + FW.png |400px|thumb|right| Порт '''USB 1''' и кнопка '''FW''' на контроллере Wiren Board 6.7]]
 
Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в [[WB_6:_Errata]].
 
Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски — может не хватить мощности USB-порта.
 
'''Подготовьте флеш-накопитель''':
# [[Formatting Flash Drive | Отформатируйте флешку в FAT32]].
# Скачайте [[#Обновление через fit-файл  | fit-файл прошивки]] на компьютер.
# Скопируйте скачанный ''.fit''-файл в корень флешки и убедитесь, что размер файла не равен нулю.
# Переименуйте файл на флешке:
#* для обновления прошивки контроллера в <code>wb6_update.fit</code>,
#* для сброса контроллера к заводским настройкам в <code>wb6_update_FACTORYRESET.fit</code>.
 
'''Чтобы обновить прошивку''':
# Выключите контроллер.
# Подключите флешку к порту '''USB 1''' и включите контроллер.
# Если в корне флешки найден файл <code>wb6_update.fit</code>, индикатор контроллера начнёт часто мигать оранжевым.
# В этот момент зажмите на одну секунду кнопку '''FW''' на плате контроллера.
# Индикатор загорится зелёным, потом мигнёт красным и замигает зелёным, который периодически будет переключаться на красный.
# Обновление продлится 5-10 минут. В конце контроллер перезагрузится в рабочий режим, а индикатор на нём замигает зелёным — флешку можно извлечь.
 
'''Чтобы сбросить контроллер к заводским настройкам''' и удалить все данные:
# Выключите контроллер.
# Подключите флешку к порту '''USB 1''' и включите контроллер.
# Если в корне флешки найден файл <code>wb6_update_FACTORYRESET.fit</code>, индикатор контроллера начнёт часто мигать оранжевым.
# В этот момент зажмите на одну секунду кнопку '''FW''' на плате контроллера.
# Индикатор загорится зелёным, потом два раза мигнёт красным и ещё два раза зелёным.
# Контроллер начнёт пищать, а индикатор замигает красным — контроллер ждёт подтверждения.
# Подтвердите очистку контроллера, для этого нажмите кнопку '''FW''' и держите, пока контроллер не пискнет четыре раза, а индикатор не загорится зелёным.
# Кнопку можно отпустить. В процессе индикатор будет мигать зелёным и периодически переключаться на красный.
# Сброс контроллера продлится 5–10 минут. В конце контроллер перезагрузится в рабочий режим, а индикатор на нём замигает зелёным — флешку можно извлечь.
 
Если обновление или сброс завершаются с ошибкой, подключитесь к [[WB_Debug_Console | Debug-консоли]] контроллера и повторите шаги. Если увидите ошибку <code>FAT: Misaligned buffer address</code> — смените накопитель на другой.
 
<gallery mode="traditional " widths ="450px" heights="250px">
Image: 2 update.png | Debug-консоль: момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления
Image: 4 update.png | Debug-консоль: обновление прошивки началось
</gallery>
<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>
 
== Обновление прошивки контроллеров старых версий ==
* Контроллер Wiren Board 5 с версией прошивки старше 0.38-20180710 можно только через восстановление прошивки, смотрите инструкцию в статье [[Wiren Board 5: Восстановление прошивки]].
* Контроллеры Wiren Board 4 и старше прошиваются через карту Micro-SD, читайте инструкцию в статье [[Создание microSD-карты с образом]]

Текущая версия на 17:28, 20 декабря 2023

Перенаправление на: