Перейти к содержанию

Навигация

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

Wiren Board Firmware Update (просмотреть исходный код)

Версия 09:45, 10 августа 2022

7554 байта добавлено ,  1 год назад
→‎В консоли через apt
Метка: отменено
(не показано 46 промежуточных версий 6 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board 6}}
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}}
== Общая информация ==
== Общая информация ==
[[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера ]]
{{Anchor|info}}
=== Совместимость ===
{{Anchor|compatibility}}
Инструкции на этой странице подходят для контроллеров Wiren Board 5.x, 6.x, 7.x.


=== Для кого эта инструкция ===
Исключения:
Инструкции в этой статье работают на контроллерах '''Wiren Board 6''', если у вас другая ревизия контроллера, смотрите:
* Контроллеры Wiren Board 5.x с версией прошивки 0.46-20190613 — их можно обновить только через [[Wiren_Board_5:_Восстановление_прошивки |восстановление прошивки]].
* [[Wiren Board 7 Firmware Update | Обновление прошивки Wiren Board 7]].
* Контроллеры Wiren Board 7.2.1A, выпущенные в декабре 2021 г — перед обновлением или возвратом заводских настроек, [[Wiren_Board_v7.2.1A_Create_Restore_Folder | переключите их на релиз]], а потом используйте инструкции на этой странице.
* [[#Обновление прошивки контроллеров старых ревизий| Обновление прошивки контроллеров старых ревизий]].


=== Краткая информация о релизах ===
Для обновления контроллеров Wiren Board 4 и старее нужно [[Создание microSD-карты с образом | записать новый образ на карту microSD]].
ПО контроллера выпускается в формате релизов:
* '''Stable''' — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок.
* '''Testing''' — нестабильная ветка: свежие версии пакетов с новыми функциями, исправленными и новыми ошибками.  


Между релизами можно переключаться, так же можно заморозить контроллер на определённом релизе — это может быть полезно на ответственных инсталляциях. Подробнее читайте в разделе [[# Как переключаться | Как переключаться]].
=== Кратко о релизах ===
{{Anchor|releases}}
[[Image: WB SW Releases.png |300px|thumb|right| Релизный цикл ПО Wiren Board]]
Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы:
* '''Stable''' — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок. Рекомендуем для инсталляций, которые делает интегратор и которые работают сейчас.
* '''Testing''' — тестовый релиз: свежие версии пакетов с новыми функциями и исправлениями, но возможно и с новыми ошибками. Рекомендуем для активных пользователей (DIY), для инсталляций на стадии стройки и пусконаладки.


С завода на контроллерах Wiren Board установлен актуальный на момент производства stable-релиз. Однако, если у вас контроллер Wiren Board ревизий 6.3 – 6.7.2, выпущенный до апреля 2022 года — может потребоваться перейти на новый репозиторий.
Стабильные релизы имеют номер вида ''wb-YYMM'', где ''YY'' — год, а ''MM'' — месяц выпуска. Например, ''wb-2104'' — релиз, выпущенный в апреле 2021 года.


=== Как обновлять ===
Мы будем рады, если вы сможете присоединиться к использованию ''testing'', ведь кроме получения новых фич вы поможете уменьшить количество ошибок в ''stable''.
Мы рекомендуем обновлять прошивку контроллера через менеджер пакетов apt. Этот способ подходит для любого релиза, а так же сохраняет установленные программы, пользовательские данные и настройки.
 
{{Wbincludes:Release Log}}
 
=== Какой релиз на вашем контроллере ===
{{Anchor|what-release}}
[[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера<br>''WebUI'' → ''Devices'' → ''System'']]
С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз.
 
Узнать версию релиза можно в веб-интерфейсе контроллера в разделе ''Devices'' в карточке устройства ''System'' или в консоли командой <code>wb-release</code>. Если в веб-интерфейсе нет упоминания о testing или stable или команда ''wb-release'' не найдена — у вас старая версия ПО и нужно [[New repository April 2021 | сменить репозиторий]].
 
=== Переключение между релизами ===
{{Anchor|switching-release}}
Между релизами можно переключаться вручную. Сделайте резервную копию настроек и выполните одну из команд:
*  Переход со стабильного на тестовый:
*:<syntaxhighlight lang="bash">
wb-release -t testing
</syntaxhighlight>
* Переход с тестового на стабильный:
*:<syntaxhighlight lang="bash">
wb-release -t stable
</syntaxhighlight>
 
После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро, а также обновить страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия.
 
== Пользовательские настройки и файлы ==
{{Anchor|user-files}}
===Где хранятся настройки===
[[Image: Etc-wbconfigs.png |400px|thumb|right| Файлы настроек, которые сохраняются при обновлении через fit-файл]]
В контроллере Wiren Board есть отдельный раздел, который монтируется в каталог <code>/mnt/data</code>, в котором по адресу <code>/mnt/data/etc</code> находятся настройки:
* системные: сеть, часовой пояс, пароль к веб-интерфейсу, mosquitto, nginx;
* устройств, подключенных по RS-485 — <code>wb-mqtt-serial.conf</code>;
* модулей ввода-вывода и расширения — <code>wb-hardware.conf</code>;
* универсальных входов/выходов A1-A4 — <code>wb-mqtt-adc.conf</code>;
* выводов GPIO контроллера — <code>wb-mqtt-gpio.conf</code>;
* настройки архива данных — <code>wb-mqtt-db.conf</code>;
* шлюза OPC UA — <code>wb-mqtt-opcua.conf</code>;
* шлюза Modbus TCP/Slave — <code>wb-mqtt-mbgate.conf</code>.
 
Кроме этого, по адресу <code>/mnt/data/etc/</code> хранятся:
* <code>wb-rules</code> — пользовательские скрипты;
* <code>wb-rules-module</code> — модули, написанные на wb-rules;
* <code>wb-mqtt-serial.conf.d/templates/</code> — пользовательские шаблоны.
 
Где хранятся настройки установленного стороннего ПО, уточняйте в его документации.
 
===Резервное копирование===
{{Anchor|backup}}
Чтобы сделать резервную копию настроек контроллера, скопируйте содержимое <code>/mnt/data/etc</code> на [[Просмотр_файлов_контроллера_с_компьютера|компьютер]]. Программы, установленные в <code>/mnt/data</code> также нужно сохранить на компьютер.
 
Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки <code>/mnt/data</code> — их нужно сохранить отдельно.
 
== Проверка обновлений ==
{{Anchor|checking-updates}}
В контроллере нет механизма, который сообщит пользователю о доступном обновлении, поэтому о выходе новых версий вы можете узнать из новостей в [https://wirenboard.com/ru/pages/contacts/ наших социальных сетях] или в консоли контроллера:
# Подключитесь к контроллеру через [[SSH]].
# Выполните команду:
#:<syntaxhighlight lang="bash" >
apt update
</syntaxhighlight>
# Если есть пакеты для обновления, то можете посмотреть их список:
#:<syntaxhighlight lang="bash">
apt list --upgradable
</syntaxhighlight>
 
== Обновление ==
{{Anchor|update}}
===  В консоли через apt ===
{{Anchor|apt}}
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
{{note|note|Рекомендуемый способ. Если последний раз ПО контроллера обновлялось до апреля 2021 года, то сперва вам нужно перейти на релизы, для этого [[New_repository_April_2021 | смените репозиторий]].}}
Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо. Для работы нужен интернет или [https://wiki.debian.org/ru/CreateLocalRepo локальное зеркало] apt-репозитория Wiren Board.
 
Обновление контроллера через apt учитывает [[#Кратко о релизах | систему релизов]] — следуя инструкции, вы полностью перейдёте на новый релиз, а не только обновите отдельные пакеты.
 
При обновлении сохраняются установленные программы, пользовательские файлы и настройки.


Чтобы обновить прошивку контроллера:
Чтобы обновить прошивку контроллера:
Строка 27: Строка 105:
</syntaxhighlight>
</syntaxhighlight>


Кроме этого обновить прошивку можно через веб-интерфейс и с помощью USB-флешки. Подробные инструкции для каждого метода обновления читайте в разделе [[#Обновление|Обновление]].
В процессе обновления может появиться запрос на действие с файлами конфигурации. Если не знаете, что выбрать — оставьте значение по умолчанию '''keep the local version currently installed''', так вы сохраните свои настройки.
 
=== Скачать файлы прошивки ===
Для обновления через веб-интерфейс или с USB-флешки вам понадобится fit-файл прошивки, который можно скачать в нашем [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.9.x].
 
== Журнал изменений в релизах ==
{{Wbincludes:Release Log}}


== Проверка обновлений ==
Так же в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>.
{{Wbincludes:Wiren Board Check firmware update}}


== Обновление ==
=== Через веб-интерфейс ===
{{Anchor|web-ui}}
{{Wbincludes:Fit Files}}


=== В консоли через apt ===
{{Wbincludes:WebUI Change Access Level}}
{{Wbincludes:Wiren Board Apt firmware update}}


=== Через веб-интерфейс ===
{{Wbincludes:Firmware Update Fit Save Data}}
{{Wbincludes:WebUI Wiren Board Firmware Update}}


=== С помощью USB-флешки ===
Чтобы обновить прошивку контроллера:
{{Wbincludes:USB Wiren Board 6 Firmware Update}}
# Скачайте fit-файл прошивки на компьютер.
<gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли">
# Зайдите в [[Wiren Board Web Interface | веб-интерфейс]] контроллера и перейдите в раздел '''Settings''' → '''System'''. В старых версиях WebUI кнопка ''Select file'' находится в разделе '''Settings'''.
Image: 2 update.png | Момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления
# Нажмите кнопку '''Select File''' и выберите скачанный ранее fit-файл.
Image: 4 update.png | Обновление прошивки началось
# Файл с прошивкой загрузится на контроллер и начнётся обновление, которое длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения.
</gallery>
# После обновления контроллер перезагрузится и на странице появится надпись '''Firmware update complete''' — обновление завершено.
 
# Закройте страницу.
== Удаление данных и возврат заводских настроек ==
{{Wbincludes:USB Wiren Board 6 Firmware Update|ractory_reset=true}}


<gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли">
После завершения обновления перезагрузите контроллер на случай, если обновилось ядро, а также обновите страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия.
Image: 1 factory reset.png | Момент, когда нужно кратковременно нажать кнопку FW для удаления данных
<gallery mode="packed " heights="150px">
Image: 2 factory reset.png | Момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения удаления данных настройкам
Image: web-settings.png | Нажмите кнопку '''Select file''' и выберите fit-файл
Image: 3 factory reset.png | Началось удаление данных и возврат заводских настроек
Image: Web-settings-firmware-update-messages.png | Во время обновления на страницу выводятся системные сообщения
Image: Web-settings-firmware-update-completed.png | Оповещение об успешном обновлении
</gallery>
</gallery>


== Пользовательские настройки и файлы ==
== Удаление данных и другие способы обновления==
{{Wbincludes:Firmware Update Save Data}}
{{Anchor|factory-reset}}
 
Обновление через apt или веб-интерфейс полностью покрывает задачи по обслуживанию контроллера.
{{Wbincludes:WebUI Wiren Board Releases}}


== Обновление прошивки контроллеров старых ревизий ==
Однако если эти способы не подходят, или вам нужно удалить данные с возвратом к заводским настройкам, это тоже можно сделать. Смотрите инструкции для каждой версии контроллера по ссылкам [[Wiren_Board_5_Firmware_Update | Wiren Board 5.x]], [[Wiren_Board_6_Firmware_Update | Wiren Board 6.x]] и [[Wiren_Board_7_Firmware_Update | Wiren Board 7.x]].
* [[Wiren Board 5 Firmware Update | Обновление контроллеров Wiren Board 5]]
* Wiren Board 4 и старше прошиваются через карту Micro-SD, читайте инструкцию в статье [[Создание microSD-карты с образом]]
Источник — https://wirenboard.com/wiki/Служебная:Сравнение_версий/59949...66081