Wiren Board Firmware Update: различия между версиями
(Перенаправление на Wiren Board Software) Метка: новое перенаправление |
|||
(не показаны 193 промежуточные версии 9 участников) | |||
Строка 1: | Строка 1: | ||
# | {{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}} | ||
== Общая информация == | |||
Эта статья описывает обновление прошивки контроллера Wiren Board 6, процедуру обновления Wiren Board 5, смотрите в статье [[#Wiren Board 5 Firmware Update | Обновление прошивки контроллера Wiren Board 5]]. | |||
Прошивку контроллера Wiren Board 6 можно обновить через менеджер пакетов <code>apt</code> или через 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'''. В этом случае выберите, что делать: | |||
* keep the local version currently installed — не изменять файлы и сохранить ваши настройки. | |||
* install the packade maintainer`s version — заменить версиями из обновляемого пакета и потерять ваши настройки. | |||
=== Обновление === | |||
Чтобы автоматически обновить систему: | |||
# Подключитесь к контроллеру по [[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/ Все прошивки контроллера с группировкой по ревизиям ] | |||
* [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-релиз. | |||
=== Сохранение пользовательских файлов и настроек === | |||
[[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>. | |||
Также будут сохранены пользовательские скрипты в папке <code>/etc/wb-rules/</code> и модули в папке <code>/etc/wb-rules-modules</code>. | |||
Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки <code>/mnt/data</code> — они будут удалены. Подключите контроллер к компьютеру для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]] и скопируйте свои файлы на компьютер. Если вы хотите сохранить установленные программы, то используйте [[#Обновление через apt | обновление через apt]]. | |||
=== Обновление через веб-интерфейс === | |||
{{Wbincludes:WebUI Change Access Level}} | |||
Обновите контроллер: | |||
# Скачайте [[#Обновление через fit-файл | fit-файл прошивки]] к себе на компьютер. | |||
# Зайдите в веб-интерфейс и перейдите '''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> | |||
=== Обновление с USB-накопителя и сброс к заводским настройкам === | |||
Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в [[WB_6:_Errata]]. | |||
Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски. | |||
Подготовьте флеш-накопитель: | |||
# [[Formatting Flash Drive | Отформатируйте флешку FAT32]]. | |||
# Скачайте [[#Обновление через fit-файл | fit-файл прошивки]] к себе на компьютер. | |||
# Сохраните скачанный ''.fit''-файл в корень флешки, убедитесь, что размер файла не равен нулю. | |||
# Переименуйте файл на флешке: | |||
#* '''для обновления прошивки''' контроллера в <code>wb6_update.fit</code>, | |||
#* '''для сброса контроллера''' к заводским настройкам в <code>wb6_update_FACTORYRESET.fit</code>. | |||
'''Чтобы обновить прошивку''': | |||
# Отключите контроллер. | |||
# Подключите флешку к первому слева USB-порту контроллера и включите его. | |||
# Если флешка верно распознана, и в корне найден файл <code>wb6_update.fit</code> — индикатор контроллера начнёт часто мигать оранжевым. | |||
# В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды. | |||
# Индикатор контроллера начнет мигать красным, затем часто зелёным. | |||
# Дождитесь окончания процесса, который длится 5–10 минут. В процессе контроллер один раз перезагрузится, а в конце загрузится в штатном режиме и индикатор на нём замигает зелёным — флешку можно извлечь. | |||
'''Чтобы сбросить контроллер''' и удалить все данные: | |||
# Отключите контроллер. | |||
# Подключите флешку к первому слева USB-порту контроллера и включите его. | |||
# Если флешка верно распознана, и в корне найден файл <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> |
Версия 14:13, 1 сентября 2021
Общая информация
Эта статья описывает обновление прошивки контроллера Wiren Board 6, процедуру обновления Wiren Board 5, смотрите в статье Обновление прошивки контроллера Wiren Board 5.
Прошивку контроллера Wiren Board 6 можно обновить через менеджер пакетов apt
или через fit-файл: с помощью флешки или через веб-интерфейс. Также контроллер можно сбросить к заводским настройкам с удалением всех пользовательских данных.
Проверка обновлений
В контроллере нет механизма, который сообщит об обновлении, поэтому о выходе новых версий вы можете узнать из новостей в наших социальных сетях, или в консоли контроллера:
- Подключитесь к контроллеру через SSH.
- Выполните команду
apt update
:# 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.
- в конце вывода будет показано, сколько пакетов можно обновить.
- Если есть пакеты для обновления, то мы можем посмотреть их список с помощью команды
apt list --upgradable
:# 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, который обновляет только изменившееся пакеты. Мы рекомендуем этот способ обновления.
Сохранение пользовательских файлов и настроек
Apt по умолчанию сохраняет пользовательские файлы и установленные программы, но может запросить перезапись файлов конфигурации с помощью окна Modified configuration Files. В этом случае выберите, что делать:
- keep the local version currently installed — не изменять файлы и сохранить ваши настройки.
- install the packade maintainer`s version — заменить версиями из обновляемого пакета и потерять ваши настройки.
Обновление
Чтобы автоматически обновить систему:
- Подключитесь к контроллеру по SSH.
- Выполните команды:
apt update && apt upgrade
В процессе обновления в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести Y
.
Обновление через fit-файл
fit-файл — это образ прошивки контроллера Wiren Board, скачать его можно по ссылкам:
Скачать можно только stable-релиз.
Сохранение пользовательских файлов и настроек
При обновлении сохраняется раздел /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.
Обновление через веб-интерфейс
Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.
После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.
Обновите контроллер:
- Скачайте fit-файл прошивки к себе на компьютер.
- Зайдите в веб-интерфейс и перейдите Settings → System.
- Нажмите кнопку Select File и выберите скачанный ранее fit-файл.
- Файл с прошивкой загрузится на контроллер и начнётся процесс обновления, который длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения обновления.
- После обновления контроллер перезагрузится и на странице появится надпись Firmware update complete — обновление завершено.
- Закройте страницу.
Обновление с USB-накопителя и сброс к заводским настройкам
Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в WB_6:_Errata.
Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски.
Подготовьте флеш-накопитель:
- Отформатируйте флешку FAT32.
- Скачайте fit-файл прошивки к себе на компьютер.
- Сохраните скачанный .fit-файл в корень флешки, убедитесь, что размер файла не равен нулю.
- Переименуйте файл на флешке:
- для обновления прошивки контроллера в
wb6_update.fit
, - для сброса контроллера к заводским настройкам в
wb6_update_FACTORYRESET.fit
.
- для обновления прошивки контроллера в
Чтобы обновить прошивку:
- Отключите контроллер.
- Подключите флешку к первому слева USB-порту контроллера и включите его.
- Если флешка верно распознана, и в корне найден файл
wb6_update.fit
— индикатор контроллера начнёт часто мигать оранжевым. - В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.
- Индикатор контроллера начнет мигать красным, затем часто зелёным.
- Дождитесь окончания процесса, который длится 5–10 минут. В процессе контроллер один раз перезагрузится, а в конце загрузится в штатном режиме и индикатор на нём замигает зелёным — флешку можно извлечь.
Чтобы сбросить контроллер и удалить все данные:
- Отключите контроллер.
- Подключите флешку к первому слева USB-порту контроллера и включите его.
- Если флешка верно распознана, и в корне найден файл
wb6_update_FACTORYRESET.fit
— индикатор контроллера начнёт часто мигать оранжевым. - В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды.
- Сперва индикатор загорится зелёным, потом пару раз мигнет красным и ещё пару раз мигнет зелёным.
- После этого контроллер начнёт пищать, а индикатор будет мигать красным — это значит, что контроллер ждет подтверждение полной очистки.
- Подтвердите удаление всех данных, для этого зажмите кнопку FW более четырех секунд.
- Писк станет прерывистым, а индикатор продолжит мигать красным — не отпускайте кнопку.
- Когда писк и мигание прекратятся — кнопку можно отпустить. Начнется процедура сброса контроллера.
- Дождитесь окончания процесса, который длится 5–10 минут. В процессе контроллер один раз перезагрузится, а в конце загрузится в штатном режиме и индикатор на нём замигает зелёным — флешку можно извлечь.
Если обновление или сброс завершаются с ошибкой, подключитесь к Debug-консоли контроллера и повторите шаги. Если увидите ошибку FAT: Misaligned buffer address
— смените накопитель на другой.