Wiren Board Firmware Update: различия между версиями
(Перенаправление на Wiren Board Software) Метка: новое перенаправление |
|||
(не показано 206 промежуточных версий 10 участников) | |||
Строка 1: | Строка 1: | ||
# | {{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}} | ||
== Файлы прошивок == | |||
Файлы прошивок нужны для полного обновления прошивки через веб-интерфейс или с помощью USB-накопителя. | |||
Прошивки для контроллеров Wiren Board и периферийных устройств доступны в нашем [http://fw-releases.wirenboard.com/ репозитории]. | |||
Прямые ссылки на свежие версии прошивок контроллера: | |||
* 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] | |||
* 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] | |||
== Частичное обновление прошивки через APT == | |||
[[Image: Dialog.png |350px|thumb|right| Окно 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: | |||
<syntaxhighlight lang="bash"> | |||
apt-get update | |||
</syntaxhighlight> | |||
=== Обновление системы === | |||
Полное обновление: | |||
<syntaxhighlight lang="bash"> | |||
apt upgrade | |||
</syntaxhighlight> | |||
Установить один пакет с указанной версией: | |||
<syntaxhighlight lang="bash"> | |||
apt install [имя_пакета]=[версия_пакета] | |||
</syntaxhighlight> | |||
''Пример:'' | |||
<syntaxhighlight lang="bash"> | |||
apt install wb-mqtt-serial=1.63.0 | |||
</syntaxhighlight> | |||
== Обновление прошивки целиком == | |||
Обновление целиком — это при использовании fit-файла прошивки без сброса к заводским настройкам. | |||
[[Image: Etc-wbconfigs.png |350px|thumb|right| Содержимое директории <code>/etc/</code> ]] | |||
=== Пользовательские файлы и настройки === | |||
Если вы хранили свои файлы на контроллере, то при обновлении они будут удалены, поэтому рекомендуем сделать их резервную копию, подключив контроллер к ПК для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]]. | |||
При обновлении сохраняются: | |||
* системные настройки: сеть, часовой пояс, пароль к веб-интерфейсу. | |||
* устройства, подключенные по 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> — сохраните этот файл вручную. Сохранение будет автоматизировано в одной из следующих версий ПО. | |||
=== Обновление прошивки через веб-интерфейс === | |||
'''ВНИМАНИЕ:''' способ не подходит для обновления на версии со «stretch» в названии файла с версий без «stretch». Например, с заводских прошивок WB5 старше середины 2018 года выпуска. | |||
При обновлении прошивки происходит перезапись раздела накопителя контроллера с операционной системой и установленными программами. Настройки, сделанные из веб-интерфейса, а также подключенные устройства и виджеты находятся на другом разделе и не затрагиваются обновлением. | |||
# Скачайте [[#Файлы прошивок | файл прошивки]] к себе на компьютер, зайдите в [[Веб-интерфейс Wiren Board|веб-интерфейс]]: страница '''Settings''' → раздел '''Firmware update'''. Нажмите кнопку '''Select file''' и выберите ранее скаченный файл прошивки. [[File:web-settings.png|400px|thumb|center|Нажмите кнопку '''Select file''' для загрузки файла прошивки]] | |||
# Файл с прошивкой загрузится на контроллер и начнется процесс обновления. Во время обновления не закрывайте страницу, не переключайтесь между разделами и не выключайте контроллер. Обновление завершится в течение 10 минут. [[File:Web-settings-firmware-update-messages.png|400px|center|thumb|Во время обновления на странице появляются системные сообщения]] | |||
# После обновления контроллер перезагрузится и на странице появится сообщение об успешном обновлении — '''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]]. | |||
Контроллеры Wiren Board 6 могут обновлять прошивку напрямую с USB-флешки. На время обновления прошивки желательно подключиться к [[WB_Debug_Console|отладочной консоли]] контроллера — так вы сможете контролировать процесс. | |||
Для обновления прошивки выполните ряд шагов: | |||
# Отформатируйте флеш-накопитель в FAT32. [https://remontka.pro/format-usb-fat-32/ Инструкция по форматированию накопителя]. Мы не рекомендуем использовать внешние жесткие диски. | |||
# Скачайте [[#Файлы прошивок | свежую версию прошивки]] с расширением ''.fit'' для вашего контроллера. | |||
# Сохраните скачанный ''.fit'' файл на флешку в корневой каталог и переименуйте его в <code>wb6_update.fit</code>. Убедитесь, что размер файла не равен 0 Кб. | |||
# Отключите контроллер. | |||
# Подключите USB-накопитель к первому USB-порту контроллера и включите контроллер. | |||
# Если USB-накопитель верно распознан, и в корне найден файл <code>wb6_update.fit</code>, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды. | |||
# Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе. В случае ошибки обновления (ошибки в Debug вида <code>FAT: Misaligned buffer address</code> — смените накопитель на другой. | |||
# Обновление занимает около 5 минут, дождитесь окончания процесса. В процессе обновления контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Флешку можно извлечь. | |||
== Сброс 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|отладочной консоли]] контроллера — так вы сможете контролировать процесс. | |||
=== Пользовательские файлы и настройки === | |||
При сбросе контроллера настройки, правила и все пользовательские файлы будут удалены! Если вы хотите сохранить свои файлы и настройки — сделайте их резервную копию, подключив контроллер к ПК для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]]. | |||
=== Создание флеш-накопителя копированием файла прошивки === | |||
# Отформатируйте флеш-накопитель в FAT32. [https://remontka.pro/format-usb-fat-32/ Инструкция по форматированию накопителя]. | |||
# Скачайте [[#Файлы прошивок | свежую версию прошивки]] с расширением ''.fit'' для вашего контроллера. | |||
# Сохраните скачанный ''.fit'' файл на флеш-накопитель в корневой каталог и переименуйте его в <code>wb6_update_FACTORYRESET.fit</code>. Убедитесь, что размер файла не равен 0 Кб. | |||
Флеш-накопитель для сброса контроллера готов. | |||
=== Процедура сброса === | |||
Для сброса контроллера выполните ряд шагов: | |||
# Отключите контроллер. | |||
# Подключите флеш-накопитель к первому USB-порту контроллера и включите контроллер. | |||
# Если флеш-накопитель верно распознан, и в корне найден файл <code>wb6_update_FACTORYRESET.fit</code> — светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно отрывисто нажать на кнопку FW на плате контроллера. | |||
# Индикатор контроллера сперва загорится зеленым, потом пару раз мигнет красным и еще пару раз мигнет зеленым. | |||
# Контроллер начнет пищать, а индикатор будет мигать красным — это значит, что контроллер ждет подтверждение полной очистки. | |||
# Чтобы сбросить контроллер и удалить все данные — зажмите кнопку FW более четырех секунд. Писк станет прерывистым, а индикатор продолжит мигать красным — не отпускайте кнопку. | |||
# Когда писк и мигание прекратятся — кнопку можно отпустить. Начнется процедура сброса контроллера. | |||
# Процедура сброса занимает 5–10 минут, дождитесь окончания процесса. В процессе сброса контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Флеш-накопитель можно извлечь. | |||
== Перезапись прошивки Wiren Board 5 == | |||
Для Wiren Board 5 см. [[Wiren Board 5: Восстановление прошивки|Wiren Board 5: Восстановление прошивки]]. | |||
Для других версий контроллера см. [[Создание microSD-карты с образом|Создание microSD-карты с образом]]. | |||
== Информация для разработчиков == | |||
Информация о внутреннем устройстве системы см. в статье [[WB Firmware Update Details|Обновление прошивки, информация для разработчиков]]. |
Версия 02:29, 9 мая 2021
Файлы прошивок
Файлы прошивок нужны для полного обновления прошивки через веб-интерфейс или с помощью 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
Обновление прошивки производится по частям с помощью системного менеджера пакетов операционной системы 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-файла прошивки без сброса к заводским настройкам.
Пользовательские файлы и настройки
Если вы хранили свои файлы на контроллере, то при обновлении они будут удалены, поэтому рекомендуем сделать их резервную копию, подключив контроллер к ПК для просмотра файлов.
При обновлении сохраняются:
- системные настройки: сеть, часовой пояс, пароль к веб-интерфейсу.
- устройства, подключенные по 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 года выпуска.
При обновлении прошивки происходит перезапись раздела накопителя контроллера с операционной системой и установленными программами. Настройки, сделанные из веб-интерфейса, а также подключенные устройства и виджеты находятся на другом разделе и не затрагиваются обновлением.
- Скачайте файл прошивки к себе на компьютер, зайдите в веб-интерфейс: страница Settings → раздел Firmware update. Нажмите кнопку Select file и выберите ранее скаченный файл прошивки.
- Файл с прошивкой загрузится на контроллер и начнется процесс обновления. Во время обновления не закрывайте страницу, не переключайтесь между разделами и не выключайте контроллер. Обновление завершится в течение 10 минут.
- После обновления контроллер перезагрузится и на странице появится сообщение об успешном обновлении — Firmware update complete.
Обновление прошивки с помощью USB-накопителя
ВНИМАНИЕ: в некоторых версиях контроллера есть аппаратные сложности с обновлением прошивки с USB-накопителя. Если вы столкнулись с этой проблемой, прочитайте WB 6: Errata.
Контроллеры Wiren Board 6 могут обновлять прошивку напрямую с USB-флешки. На время обновления прошивки желательно подключиться к отладочной консоли контроллера — так вы сможете контролировать процесс.
Для обновления прошивки выполните ряд шагов:
- Отформатируйте флеш-накопитель в FAT32. Инструкция по форматированию накопителя. Мы не рекомендуем использовать внешние жесткие диски.
- Скачайте свежую версию прошивки с расширением .fit для вашего контроллера.
- Сохраните скачанный .fit файл на флешку в корневой каталог и переименуйте его в
wb6_update.fit
. Убедитесь, что размер файла не равен 0 Кб. - Отключите контроллер.
- Подключите USB-накопитель к первому USB-порту контроллера и включите контроллер.
- Если USB-накопитель верно распознан, и в корне найден файл
wb6_update.fit
, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды. - Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе. В случае ошибки обновления (ошибки в Debug вида
FAT: Misaligned buffer address
— смените накопитель на другой. - Обновление занимает около 5 минут, дождитесь окончания процесса. В процессе обновления контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Флешку можно извлечь.
Сброс Wiren Board 6 к заводским настройкам
Сбросить контроллер к заводским настройкам можно только через USB флеш-накопитель с особым именем файла прошивки — wb6_update_FACTORYRESET.fit
.
На время сброса контроллера желательно подключиться к отладочной консоли контроллера — так вы сможете контролировать процесс.
Пользовательские файлы и настройки
При сбросе контроллера настройки, правила и все пользовательские файлы будут удалены! Если вы хотите сохранить свои файлы и настройки — сделайте их резервную копию, подключив контроллер к ПК для просмотра файлов.
Создание флеш-накопителя копированием файла прошивки
- Отформатируйте флеш-накопитель в FAT32. Инструкция по форматированию накопителя.
- Скачайте свежую версию прошивки с расширением .fit для вашего контроллера.
- Сохраните скачанный .fit файл на флеш-накопитель в корневой каталог и переименуйте его в
wb6_update_FACTORYRESET.fit
. Убедитесь, что размер файла не равен 0 Кб.
Флеш-накопитель для сброса контроллера готов.
Процедура сброса
Для сброса контроллера выполните ряд шагов:
- Отключите контроллер.
- Подключите флеш-накопитель к первому USB-порту контроллера и включите контроллер.
- Если флеш-накопитель верно распознан, и в корне найден файл
wb6_update_FACTORYRESET.fit
— светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно отрывисто нажать на кнопку FW на плате контроллера. - Индикатор контроллера сперва загорится зеленым, потом пару раз мигнет красным и еще пару раз мигнет зеленым.
- Контроллер начнет пищать, а индикатор будет мигать красным — это значит, что контроллер ждет подтверждение полной очистки.
- Чтобы сбросить контроллер и удалить все данные — зажмите кнопку FW более четырех секунд. Писк станет прерывистым, а индикатор продолжит мигать красным — не отпускайте кнопку.
- Когда писк и мигание прекратятся — кнопку можно отпустить. Начнется процедура сброса контроллера.
- Процедура сброса занимает 5–10 минут, дождитесь окончания процесса. В процессе сброса контроллер один раз перезагрузится. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Флеш-накопитель можно извлечь.
Перезапись прошивки Wiren Board 5
Для Wiren Board 5 см. Wiren Board 5: Восстановление прошивки.
Для других версий контроллера см. Создание microSD-карты с образом.
Информация для разработчиков
Информация о внутреннем устройстве системы см. в статье Обновление прошивки, информация для разработчиков.