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

Материал из Wiren Board
Метка: отменено
(не показано 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-карты с образом]]

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

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

Совместимость

Инструкции на этой странице подходят для контроллеров Wiren Board 5.x, 6.x, 7.x.

Исключения:

  • Контроллеры Wiren Board 5.x с версией прошивки 0.46-20190613 — их можно обновить только через восстановление прошивки.
  • Контроллеры Wiren Board 7.2.1A, выпущенные в декабре 2021 г — перед обновлением или возвратом заводских настроек, переключите их на релиз, а потом используйте инструкции на этой странице.

Для обновления контроллеров Wiren Board 4 и старее нужно записать новый образ на карту microSD.

Кратко о релизах

Релизный цикл ПО Wiren Board

Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы:

  • Stable — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок. Рекомендуем для инсталляций, которые делает интегратор и которые работают сейчас.
  • Testing — тестовый релиз: свежие версии пакетов с новыми функциями и исправлениями, но возможно и с новыми ошибками. Рекомендуем для активных пользователей (DIY), для инсталляций на стадии стройки и пусконаладки.

Стабильные релизы имеют номер вида wb-YYMM, где YY — год, а MM — месяц выпуска. Например, wb-2104 — релиз, выпущенный в апреле 2021 года.

Мы будем рады, если вы сможете присоединиться к использованию testing, ведь кроме получения новых фич вы поможете уменьшить количество ошибок в stable.

Журналы изменений в релизах
Ветка Имя
stable wb-2401wb-2310wb-2307wb-2304wb-2207wb-2204wb-2201wb-2110wb-2108 • wb-2104
testing скользящий релиз, изменения

Какой релиз на вашем контроллере

Версия ПО в веб-интерфейсе контроллера
WebUIDevicesSystem

С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз.

Узнать версию релиза можно в веб-интерфейсе контроллера в разделе Devices в карточке устройства System или в консоли командой wb-release. Если в веб-интерфейсе нет упоминания о testing или stable или команда wb-release не найдена — у вас старая версия ПО и нужно сменить репозиторий.

Переключение между релизами

Между релизами можно переключаться вручную. Сделайте резервную копию настроек и выполните одну из команд:

  • Переход со стабильного на тестовый:
    wb-release -t testing
    
  • Переход с тестового на стабильный:
    wb-release -t stable
    

После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро, а также обновить страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия.

Пользовательские настройки и файлы

Где хранятся настройки

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

В контроллере Wiren Board есть отдельный раздел, который монтируется в каталог /mnt/data, в котором по адресу /mnt/data/etc находятся настройки:

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

Кроме этого, по адресу /mnt/data/etc/ хранятся:

  • wb-rules — пользовательские скрипты;
  • wb-rules-module — модули, написанные на wb-rules;
  • wb-mqtt-serial.conf.d/templates/ — пользовательские шаблоны.

Где хранятся настройки установленного стороннего ПО, уточняйте в его документации.

Резервное копирование

Чтобы сделать резервную копию настроек контроллера, скопируйте содержимое /mnt/data/etc на компьютер. Программы, установленные в /mnt/data также нужно сохранить на компьютер.

Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки /mnt/data — их нужно сохранить отдельно.

Проверка обновлений

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

  1. Подключитесь к контроллеру через SSH.
  2. Выполните команду:
    apt update
    
  3. Если есть пакеты для обновления, то можете посмотреть их список:
    apt list --upgradable
    

Обновление

В консоли через apt

Окно Modified configuration Files

Рекомендуемый способ. Если последний раз ПО контроллера обновлялось до апреля 2021 года, то сперва вам нужно перейти на релизы, для этого смените репозиторий. Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо. Для работы нужен интернет или локальное зеркало apt-репозитория Wiren Board.

Обновление контроллера через apt учитывает систему релизов — следуя инструкции, вы полностью перейдёте на новый релиз, а не только обновите отдельные пакеты.

При обновлении сохраняются установленные программы, пользовательские файлы и настройки.

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

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

В процессе обновления может появиться запрос на действие с файлами конфигурации. Если не знаете, что выбрать — оставьте значение по умолчанию keep the local version currently installed, так вы сохраните свои настройки.

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

Через веб-интерфейс

Cсылка для скачивания FIT-файлов в веб-интерфейсе контроллера Wiren Board

Вам понадобится fit-файл прошивки для вашей версии контроллера. C помощью fit-файла можно обновить как stable, так и testing релизы. При этом учтите, что для обновления на stable контроллер должен быть переключен stable-релиз. Самые свежие stable-релизы находятся по ссылкам:

Образы testing и старые версии ПО вы найдёте в нашем репозитории.

Начиная с релиза wb-2304 ссылка для скачивания FIT-файлов доступна в веб-интерфейсе в разделе НастройкиСистема.

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

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

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

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

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

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

После завершения обновления перезагрузите контроллер на случай, если обновилось ядро, а также обновите страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия.

Удаление данных и другие способы обновления

Обновление через apt или веб-интерфейс полностью покрывает задачи по обслуживанию контроллера.

Однако если эти способы не подходят, или вам нужно удалить данные с возвратом к заводским настройкам, это тоже можно сделать. Смотрите инструкции для каждой версии контроллера по ссылкам Wiren Board 5.x, Wiren Board 6.x и Wiren Board 7.x.