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

 
(не показано 67 промежуточных версий этого же участника)
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board 7.4}}
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board 7.4}}
{{Draft}}
== Общая информация ==
== Общая информация ==
{{Anchor|info}}
{{Anchor|info}}
=== Как всё устроено ===
{{YouTube
Контроллер работает под управлением Debian Linux, поэтому вы можете обновлять ПО с помощью штатного пакетного менеджера apt — нужен интернет на контроллере, зато сохраняются системные настройки, а также установленное пользователем стороннее ПО и его файлы конфигурации.
|link=https://youtu.be/2XhPWDzYSmY
 
|text= Обновление ПО контроллера Wiren Board 7
Кроме этого, для контроллеров Wiren Board выпускаются прошивки в виде fit-файлов — это образ корневого раздела rootfs, который можно прошить с USB-флешки, карты памяти, через Debug Network или из веб-интерфейса контроллера. Интернет на контроллере не нужен, но сохранятся только настройки, сделанные из веб-интерфейса контроллера — установленное стороннее ПО будет удалено вместе с файлами конфигурации.
|list= PL-yKQAXd5Un_fQfrVVgMt1Em5Qb1f-v6l
 
}}
Подробные инструкции для выбранного способа обновления читайте ниже.


=== Совместимость ===
=== Совместимость ===
{{Anchor|compatibility}}
{{Anchor|compatibility}}
Инструкции на этой странице подходят для контроллеров Wiren Board 7.4.
{{Wbincludes:Update Compatibility
|model= Wiren Board 7.4
|link= Wiren Board 7.4
}}


=== Кратко о релизах ===
=== Как всё устроено ===
{{Anchor|releases}}
{{Wbincludes:Firmware Update How Everything Works}}
{{Wbincludes:Releases}}
 
{{Wbincludes:Release Log}}
 
=== Какой релиз на вашем контроллере ===
{{Anchor|what-release}}
[[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера<br>''WebUI'' → ''Devices'' → ''System'']]
С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз.


Узнать версию релиза можно в веб-интерфейсе контроллера в разделе '''Устройства''' в карточке устройства '''System''' или в консоли командой <code>wb-release</code>.
=== Релизы ===
 
{{Wbincludes:Wiren Board Software Releases}}
=== Переключение между релизами ===
{{Anchor|switching-release}}
Между релизами можно переключаться вручную. Сделайте резервную копию настроек, подключитесь к контроллеру через [[SSH]] и выполните одну из команд:
*  Переход со стабильного на тестовый:
*:<syntaxhighlight lang="bash">
wb-release -t testing
</syntaxhighlight>
* Переход с тестового на стабильный:
*:<syntaxhighlight lang="bash">
wb-release -t stable
</syntaxhighlight>
 
После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро, а также обновить страницу веб-интерфейса в браузере со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия.
 
Кроме этого, сменить релиз можно с помощью прошивки контроллера fit-файлом, способы и ограничения смотрите ниже в этой инструкции.


== Пользовательские настройки и файлы ==
== Пользовательские настройки и файлы ==
{{Anchor|user-files}}
{{Anchor|user-files}}
===Где хранятся настройки===
{{Wbincludes:Wiren Board User Settings And Files}}
[[Image: Wiren Board eMMC Structure and Update.png|300px|thumb|right|Структура eMMC и способы обновления]]
[[Image: Etc-wbconfigs.png |400px|thumb|right| Файлы настроек, которые сохраняются при обновлении через fit-файл]]
 
eMMC контроллера Wiren Board разбита на несколько разделов, пользователю важно знать два из них, которые монтируются в папки:
# / или rootfs — корневой раздел 2 Гбайта с файлами операционной системы, ссылками на системные настройки, установленным сторонним ПО и его файлами конфигурациями.
# /mnt/data — большой раздел в несколько Гбайт с системными настройками и любыми пользовательскими файлами.
 
На большом разделе, по адресу <code>/mnt/data/etc</code> находятся настройки:
* системные: сеть, часовой пояс, пароль к веб-интерфейсу, mosquitto, nginx;
* устройств, подключенных по RS-485 — ''wb-mqtt-serial.conf''
* дашборды, виджеты и настройки веб-интерфейса — ''wb-webui.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''.
 
Кроме этого, по адресу <code>/mnt/data/etc/</code> хранятся:
* ''wb-rules'' — пользовательские скрипты;
* ''wb-rules-module''— модули, написанные на wb-rules;
* ''wb-mqtt-serial.conf.d/templates/'' — пользовательские шаблоны.
 
Где хранятся настройки установленного стороннего ПО, уточняйте в его документации.
 
===Резервное копирование===
{{Anchor|backup}}
Чтобы сделать резервную копию настроек контроллера, скопируйте содержимое <code>/mnt/data/etc</code> на [[Просмотр_файлов_контроллера_с_компьютера|компьютер]]. Программы, установленные в <code>/mnt/data</code> также нужно сохранить на компьютер.
 
Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки <code>/mnt/data</code> — их нужно сохранить отдельно.
 
Кроме этого вы можете скачать образ корневой файловой системы — так вы сохраните настройки сторонних программ, которых хранят файлы в <code>/etc</code>. Сделать это можно кнопкой в веб-интерфейсе '''Настройки''' → '''Система''' → '''Скачать архив с rootfs'''.


== Проверка обновлений ==
== Проверка обновлений ==
{{Anchor|checking-updates}}
{{Wbincludes:Wiren Board Check Firmware Update}}
В контроллере нет механизма, который сообщит пользователю о доступном обновлении, поэтому о выходе новых версий вы можете узнать из новостей в [https://wirenboard.com/ru/pages/contacts/ наших социальных сетях] или в консоли контроллера:
# Подключитесь к контроллеру через [[SSH]].
# Выполните команду:
#:<syntaxhighlight lang="bash" >
apt update
</syntaxhighlight>
# Если есть пакеты для обновления, то можете посмотреть их список:
#:<syntaxhighlight lang="bash">
apt list --upgradable
</syntaxhighlight>


== Обновление в консоли через apt==
== Обновление в консоли через apt==
{{Anchor|apt}}
{{Anchor|apt}}
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо. Для работы нужен интернет или [https://wiki.debian.org/ru/CreateLocalRepo локальное зеркало] apt-репозиториев.
{{Wbincludes:Wiren Board Apt Firmware Update}}


Обновление контроллера через apt учитывает [[#Кратко о релизах | систему релизов]] — следуя инструкции, вы полностью перейдёте на новый релиз, а не только обновите отдельные пакеты.
== Прошивка через веб-интерфейс==
{{Anchor|web-ui}}
=== О способе ===
Прошивку через веб-интерфейс удобно использовать, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО. Способ подходит для обновления внутри веток stable или testing, а также для перехода со stable на testing.


При обновлении сохраняются установленные программы, пользовательские файлы и настройки.
{{Wbincludes:Firmware Update Fit Save Data}}


Чтобы обновить прошивку контроллера:
=== Скачивание прошивки ===
# Подключитесь к нему по [[SSH]].
{{Wbincludes:Fit Files Wiren Board 7}}
# Выполните команды:
При загрузке прошивки через веб-интерфейс имя файла не имеет значения.
#:<syntaxhighlight lang="bash">
apt update; apt upgrade
</syntaxhighlight>


В процессе обновления может появиться запрос на действие с файлами конфигурации. Если не знаете, что выбрать — оставьте значение по умолчанию '''keep the local version currently installed''', так вы сохраните свои настройки.
=== Процесс ===
{{note|info|Если у вас на контроллере релиз wb-2307 и новее, а на самом контроллере корневой раздел 1 Гбайт, то его [[Enlarging_the_rootfs_partition|можно увеличить]].}}
{{Wbincludes:Wiren Board WebUI Firmware Update}}


Так же в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>.
== Прошивка через Debug Network ==
{{Anchor|debug-network}}


== Прошивка через веб-интерфейс==
[[Image: wb7-debug-network-pc.png |300px|thumb|right| Файл обновления прошивки на съёмном накопителе ]]
{{Anchor|web-ui}}
[[Image: wb7-debug-network.png |300px|thumb|right| Разъём Debug Network, USB-C ]]
{{note|note|Этим способом можно обновить текущий релиз более новым, или перейти со stable на testing. Для перехода на старый релиз используйте процедуру удаления данных, описанную в разделах ниже.}}
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
=== О способе ===
В контроллере есть разъём [[Debug Network]], который можно использовать для обновления прошивки или удаления всех данных и настроек.
 
{{Wbincludes:Wiren Board 7 Firmware Update Fit Save Data}}


=== Скачивание прошивки ===
=== Подготовка файла прошивки ===
{{Wbincludes:Fit Files Wiren Board 7}}
{{Wbincludes:Fit Files Wiren Board 7}}
{{Wbincludes:Fit File Rename Wiren Board 7}}


=== Процесс ===
=== Процесс ===
{{Wbincludes:WebUI Change Access Level}}
{{Wbincludes:Wiren Board 7.4 Debug Network Firmware Update}}
 
== Прошивка с помощью USB-флешки или карты Micro-SD ==
{{Anchor|usb-flash}}
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
=== О способе ===
Для обновления прошивки или удаления данных и настроек можно воспользоваться USB-флешкой или картой памяти Micro SD.


{{Wbincludes:Firmware Update Fit Save Data}}
Способ удобен, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО.
 
{{Wbincludes:Wiren Board 7 Firmware Update Fit Save Data}}


Чтобы обновить прошивку контроллера:
=== Подготовка файла прошивки ===
# Скачайте fit-файл прошивки на компьютер.
{{Wbincludes:Fit Files Wiren Board 7}}
# Зайдите в [[Wiren Board Web Interface | веб-интерфейс]] контроллера и перейдите в раздел '''Настройки''' → '''Система'''.
# Нажмите кнопку '''Выбрать файл''' и выберите скачанный ранее fit-файл.
# Файл с прошивкой загрузится на контроллер и начнётся обновление, которое длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения.
# После обновления контроллер перезагрузится.


После завершения обновления подключитесь к контроллеру заново и обновите в браузере страницу веб-интерфейса со сбросом кэша (Ctrl+F5 для Chrome), чтобы загрузилась обновленная версия. Проверьте версию прошивки на странице '''Устройства''' → '''System'''.
{{Wbincludes:Fit File Rename Wiren Board 7}}
<gallery mode="packed " heights="150px">
Image: Web-Configs-2.0 system.png | Нажмите кнопку '''Select file''' и выберите fit-файл
Image: Web-settings-firmware-update-messages.png | Во время обновления на страницу выводятся системные сообщения
Image: sw-release.png | Текущая версия прошивки контроллера
</gallery>


== Прошивка через Debug Network ==
=== Процесс ===
{{Wbincludes:Wiren Board 7 USB Firmware Update}}


== Прошивка с помощью USB-флешки или карты Micro-SD ==
=== Массовая прошивка контроллеров ===
{{Wbincludes:Mass flashing from flash}}


== Удаление данных и возврат заводских настроек ==
== Удаление данных и возврат заводских настроек ==
{{Anchor|factory-reset}}
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
{{Wbincludes: Wiren Board 7.4 Factory Reset}}
== Удаление данных и возврат заводских настроек с обновлением ПО ==
{{Wbincludes:FactoryReset WebUI}}