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

Материал из Wiren Board
(не показано 60 промежуточных версий 2 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллеров Wiren Board 7.2…7.3 }}
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board 7}}
== Общая информация ==
== Общая информация ==
{{Anchor|info}}
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW, которая переводит контроллер в режим обновления прошивки. Понадобится в некоторых инструкциях ]]
{{YouTube
{{note|note| Если у вас контроллер из партии v7.2.1A, выпущенной в декабре 2021 г. и в консоли написано «This is a development release» — перед обновлением или возвратом заводских настроек, [[Wiren_Board_v7.2.1A_Create_Restore_Folder | переключите его на релиз]].}}
|link=https://youtu.be/2XhPWDzYSmY
Инструкции в этой статье работают на контроллере '''[[Wiren Board 7 | Wiren Board 7]]'''.
|text= Обновление ПО контроллера Wiren Board 7
|list= PL-yKQAXd5Un_fQfrVVgMt1Em5Qb1f-v6l
}}
=== Совместимость ===
{{Anchor|compatibility}}
{{Wbincludes:Update Compatibility
|model= Wiren Board 7.2…7.3
|link= Wiren_Board_7.3
}}


=== Как всё устроено ===
ПО контроллера выпускается в формате релизов ''stable'' — новые функции каждые три месяца, и ''testing'' — новые функции каждый день. Между релизами можно переключаться, с завода на контроллере установлен ''stable''. О том, как узнать установленный у вас релиз и как между ними переключаться, читайте в статье [[#Релизы ПО | Релизы ПО]].
{{Wbincludes:Firmware Update How Everything Works}}


=== Релизы ===
Прошивку контроллера Wiren Board можно обновить в консоли с помощью apt, через веб-интерфейс, с компьютера, USB-флешки и карты памяти. В зависимости от выбранного типа обновления вы можете сохранить настройки и установленное ПО.
{{Wbincludes:Wiren Board Software Releases}}


== Пользовательские настройки и файлы ==
Также контроллер можно сбросить к заводским настройкам или обновить с удалением пользовательских данных.
{{Anchor|user-files}}
{{Wbincludes:Wiren Board User Settings And Files}}
 
== Проверка обновлений ==
{{Wbincludes:Wiren Board Check Firmware Update}}


== Обновление в консоли через apt==
Если у вас в процессе обновления или сброса возникли проблемы, подключитесь к [[WB Debug Console | Debug-консоли]] и посмотрите выводимые там сообщения — это поможет понять, что именно идёт не так.
{{Anchor|apt}}
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
{{note|note|Рекомендуемый способ. Если последний раз ПО контроллера обновлялось до апреля 2021 года, то сперва вам нужно перейти на релизы, для этого [[New_repository_April_2021 | смените репозиторий]].}}


Если вы обновляетесь с релиза wb-2207 и более раннего через apt, то прочитайте сперва описание известных проблем, с которыми вы столкнётесь: [[WB_7:_Errata#ERRWB73011 | Wiren Board 7: ERRWB73011]].
Для обновления через веб-интерфейс или с USB-флешки вам понадобится fit-файл прошивки, который можно скачать в нашем [http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ репозитории] или по прямой ссылке на stable-релиз: [http://fw-releases.wirenboard.com/fit_image/stable/7x/latest_stretch.fit Wiren Board 7.x].


Важно! В релизе wb-2304 сменилась версия Debian, поэтому при переходе со старых релизов wb-21**/wb-22** надо ввести дополнительную команду ([[wb-2304|подробнее]]):
== Журнал изменений в релизах ==
:<syntaxhighlight lang="bash">
{{Wbincludes:Release Log}}
wb-release --update-debian-release
</syntaxhighlight>


{{Wbincludes:Wiren Board Apt Firmware Update}}
== Проверка обновлений ==
 
{{Wbincludes:Wiren Board Check firmware update}}
=== Решение проблем при обновлении со Stretch на Bullseye ===
{{Wbincludes:Bullseye Errata}}
 
== Прошивка через веб-интерфейс ==
{{Anchor|web-ui}}
 
=== О способе ===
Прошивку через веб-интерфейс удобно использовать, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО. Способ подходит для обновления внутри веток stable или testing, а также для перехода со stable на testing.


{{Wbincludes:Firmware Update Fit Save Data}}
== Обновление ==
=== В консоли через apt ===
{{Wbincludes:Wiren Board Apt firmware update}}


=== Скачивание прошивки ===
=== Через веб-интерфейс ===
{{Wbincludes:Fit Files Wiren Board 7}}
{{Wbincludes:WebUI Wiren Board Firmware Update}}
 
=== Процесс ===
{{note|info|Если у вас на контроллере релиз wb-2307 и новее, а на самом контроллере корневой раздел 1 Гбайт, то его [[Enlarging_the_rootfs_partition|можно увеличить]].}}
{{Wbincludes:Wiren Board WebUI Firmware Update}}
 
== Прошивка через Debug Network ==
{{Anchor|debug-network}}


=== Через разъём Debug Network ===
[[Image: wb7-debug-network-pc.png |300px|thumb|right| Файл обновления прошивки на съёмном накопителе ]]
[[Image: wb7-debug-network-pc.png |300px|thumb|right| Файл обновления прошивки на съёмном накопителе ]]
[[Image: wb7-debug-network.png |300px|thumb|right| Разъём Debug Network, USB-C ]]
[[Image: wb7-debug-network.png |300px|thumb|right| Разъём Debug Network, USB-C ]]
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
В контроллере есть разъём ''Debug Network'', который можно использовать для обновления прошивки или сброса настроек.
=== О способе ===
В контроллере есть разъём [[Debug Network]], который можно использовать для обновления прошивки или удаления всех данных и настроек.


{{Wbincludes:Wiren Board 7 Firmware Update Fit Save Data}}
{{Wbincludes:Firmware Update Fit Save Data}}


=== Подготовка файла прошивки ===
Вам понадобятся компьютер и кабель USB-C с возможностью передачи данных.
{{Wbincludes:Fit Files Wiren Board 7}}


{{Wbincludes:Fit File Rename Wiren Board 7}}
В процессе контроллер будет несколько раз запрашивать в [[WB Debug Console | Debug-консоли]] подтверждение тех или иных действий, мы будем ориентироваться на звуковые сигналы и подтверждать все запросы:
{{Wbincludes:Wiren Board 7 Fit Prepare}}
# Выключите контроллер кнопкой на корпусе.
# Подключите контроллер к компьютеру через разъём ''Debug Network''.
# Зажмите кнопку ''FW'' и удерживайте её.
# Включите контроллер и после короткого звукового сигнала отпустите кнопку ''FW''.
# Индикатор контроллера медленно замигает красным, а ещё через 10 секунд компьютер определит съёмный накопитель.
# Скопируйте подготовленный в шаге 1 файл на определившийся накопитель.
# Извлеките (отмонтируйте) флешку программно и отключите кабель от контроллера физически.
# В зависимости от того, какой файл вы скопировали, возможно два варианта:
## Контроллер два раза коротко пикнет — началось обновление прошивки.
## Контроллер пикнет сперва коротко два раза, затем издаст продолжительный звуковой сигнал, а индикатор быстро замигает красным — это запрос на сброс к заводским настройкам:
##* Чтобы подтвердить сброс настроек и удалить все пользовательские данные, зажмите и держите кнопку ''FW''.
##* Контроллер пикнет четыре раза и перейдёт к сбросу настроек. Кнопку можно отпустить.
# По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.


=== Процесс ===
Вся процедура занимает около 2 минут.
Вам понадобятся компьютер и кабель USB-C с возможностью передачи данных. Весь процесс займёт не больше пяти минут.


Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать в подтверждение тех или иных действий и писать сообщения о ходе процесса.
<gallery mode="packed" heights="250px" caption="Сообщения в Debug-консоли">
Image: wb7-pc-reset-1.png  | Сообщение о том, что мы перевели контроллер в режим обновления
Image: wb7-pc-reset-2.png  | Контроллер подключён к компьютеру и на него записан файл wb_update_FACTORYRESET.fit
Image: wb7-pc-reset-3.png  | Если вы сбрасываете настройки, то в консоли будет виден запрос на подтверждение очистки
</gallery>


В инструкции мы будем ориентироваться на звуковые сигналы и подтверждать все запросы:
=== С помощью USB-флешки или карты Micro-SD ===
# Начало зависит от аппаратной ревизии контроллера:
[[Image: wb7-usb-flash-fit.png |300px|thumb|right| Файл сброса к заводским настройкам на USB-флешке]]
#* Для ревизии 7.3:
[[Image: wb-7-sd+usb.png |300px|thumb|right| Разъём USB 1 и слот Micro-SD]]
#*# Переведите выключатель в положение OFF и вытащите кабели из разъёмов Debug Console и Debug Network. Это выключит контроллер.
В контроллере есть ''разъём USB 1'' и ''слот Micro-SD'', которые можно использовать для обновления прошивки или удаления данных с восстановлением заводских настроек. С некоторыми картами Micro-SD могут быть проблемы, используйте USB-флешку или промышленную карту [https://wirenboard.com/ru/product/microsd-industrial-64gb/ Transcend 64GB].
#*# Зажмите и не отпускайте кнопку FW.
#*# Переведите переключатель в положение ON и тут же вставьте кабель в разъём Debug Network. Если вам нужны логи из дебага, сразу подключите кабель Debug Console.
#*# Подключите к контроллеру внешнее питание — это нужно для того, чтобы при отключении кабеля контроллер корректно прошился.
#*Для ревизии 7.2:
#*# Вставьте кабель в разъём Debug Network. Если нужно, подключите кабель к Debug Console.
#*# Переведите выключатель в положение OFF.
#*# Подключите к контроллеру внешнее питание.
#*# Зажмите и не отпускайте кнопку FW.
#*# Включите контроллер переключателем и продолжайте удерживать кнопку FW.
#Держите кнопку FW до короткого звукового сигнала. В Debug Console в этот момент будут строки:
#:<syntaxhighlight lang="bash">
Press FW button to enter firmware update mode
# <здесь вы нажали кнопку>
Entering firmware update mode.
</syntaxhighlight>
# Отпустите кнопку FW.
# Через несколько секунд на компьютере обнаружится накопитель '''WB UPDATE''', откройте его. В Debug Console в это время будет сообщение:
#:<syntaxhighlight lang="bash">
Copy .fit file to virtual USB driver and unplug the cable
</syntaxhighlight>
# Скопируйте подготовленный .fit-файл на этот накопитель. В Debug Console в это время будут сообщения:
#:<syntaxhighlight lang="bash">
# приглашение скопировать файл на накопитель
Copy .fit file to virtual USB driver and unplug the cable
# <много сообщений с процессом копирования файла>
</syntaxhighlight>
# По окончании копирования, отключите накопитель средствами ОС и вытащите кабель Debug Network, начнётся прошивка контроллера. В Debug Console при этом будет сообщение вида:
#:<syntaxhighlight lang="bash">
Volume was not properly unmounted. Some data may be corrupt. Please run fsck.
Will look for update in USB gadget ramdisk


Will use wb_update.fit from USB gadget (/usb)
{{Wbincludes:Firmware Update Fit Save Data}}
# или, если вы выбрали удаление данных
Will use wb_update_FACTORYRESET.fit from USB gadget (/usb)
</syntaxhighlight>
# Через пару минут контроллер перезагрузится и его индикатор станет равномерно мигать зелёным, а в Debug Console появится приглашение входа: <code>wirenboard-XXXXXXXX login:</code>.


Если в имени файла есть <code>FACTORYRESET</code>, то контроллер издаст продолжительный звуковой сигнал — запрос подтверждения удаления всех данных. В Debug Console будет сообщение: <code>FACTORY RESET REQUESTED</code>. Нажмите и держите кнопку FW, пока контроллер не издаст по очереди четыре коротких звуковых сигнала. Кнопку можно отпустить. Если вы передумали удалять данные — просто выключите контроллер.
В процессе контроллер будет несколько раз запрашивать в [[WB Debug Console | Debug-консоли]] подтверждение тех или иных действий, но чтобы упростить процедуру — мы просто зажмём кнопку FW в самом начале и автоматом со всем согласимся:
 
# Загрузите на компьютер [[#Общая информация | fit-файл прошивки]] и переименуйте его в: <code>wb_update.fit</code> для обновления или <code>wb_update_FACTORYRESET.fit</code> для обновления с удалением данных, установленного ПО и возвратом заводских настроек.
== Прошивка с помощью USB-флешки или карты Micro-SD ==
# [[Formatting Flash Drive| Отформатируйте флешку или карту памяти в FAT32]].
{{Anchor|usb-flash}}
# Скопируйте подготовленный в шаге 1 файл на флешку или карту памяти.
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
# Выключите контроллер кнопкой на корпусе.
=== О способе ===
# Вставьте флешку в ''разъём USB 1'' или карту памяти в ''слот Micro-SD''.
Для обновления прошивки или удаления данных и настроек можно воспользоваться USB-флешкой или картой памяти Micro SD.
# Зажмите и не отпускайте кнопку ''FW''.
 
# Включите контроллер и продолжайте удерживать кнопку.
Способ удобен, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО.
# После включения контроллер пикнет один раз — это он перешёл в режим обновления прошивки, не отпускайте кнопку.
 
# В зависимости от того, какой файл вы положили, возможно два варианта:
{{Wbincludes:Wiren Board 7 Firmware Update Fit Save Data}}
## Контроллер два раза коротко пикнет — началось обновление прошивки, кнопку можно отпустить.
 
## Контроллер пикнет сперва коротко два раза, а затем ещё четыре, но реже — началось удаление данных и восстановление заводских настроек, кнопку можно отпустить.
=== Подготовка файла прошивки ===
# По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.
{{Wbincludes:Fit Files Wiren Board 7}}
 
{{Wbincludes:Fit File Rename Wiren Board 7}}
 
=== Процесс ===
Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать подтверждение тех или иных действий и писать сообщения о ходе процесса.


В инструкции мы будем ориентироваться на звуковые сигналы и подтверждать все запросы:
Вся процедура занимает около 2 минут.
# Скопируйте подготовленный файл прошивки на флешку или карту памяти и вставьте её в контроллер.
# Следующие шаги зависят от аппаратной ревизии контроллера:
#* Для ревизии 7.3:
#*# Переведите выключатель в положение OFF и вытащите кабели из разъёмов Debug Console и Debug Network.
#*# Зажмите и не отпускайте кнопку FW.
#*# Подключите к контроллеру внешнее питание.
#*# Включите контроллер кнопкой и продолжайте удерживать кнопку FW. Если вам нужны логи из дебага, быстро подключите кабель Debug Console.
#*Для ревизии 7.2:
#*# Если нужно, подключите кабель к Debug Console.
#*# Переведите выключатель в положение OFF.
#*# Подключите к контроллеру внешнее питание.
#*# Зажмите и не отпускайте кнопку FW.
#*# Включите контроллер кнопкой и продолжайте удерживать кнопку FW.
# Держите кнопку FW до короткого звукового сигнала. Кнопку можно отпустить. В Debug Console в этот момент будут строки:
#:<syntaxhighlight lang="bash">
Press FW button to enter firmware update mode
# <здесь вы нажали кнопку>
Entering firmware update mode.
</syntaxhighlight>
# Контроллер попробует найти на подключённой флешке или карте памяти fit-файлы с прошивкой. В Debug Console при этом будут выводится строки:
#:<syntaxhighlight lang="bash">
Looking for update .fit on /dev/sda...
Looking for update .fit on /dev/sda1...
</syntaxhighlight>
# Если файл будет найден — контроллер издаст два коротких сигнала и перейдёт в режим прошивки. В Debug Console при этом будет сообщение вида:
#:<syntaxhighlight lang="bash">
Will use wb_update.fit from virtual USB drive
# или, если вы выбрали удаление данных
Will use wb_update_FACTORYRESET.fit from virtual USB drive
</syntaxhighlight>
#: Если в имени файла есть <code>FACTORYRESET</code>, то контроллер издаст продолжительный звуковой сигнал — запрос подтверждения удаления всех данных. В Debug Console будет сообщение: <code>FACTORY RESET REQUESTED</code>. Нажмите и держите кнопку FW, пока контроллер не издаст по очереди четыре коротких звуковых сигнала. Кнопку можно отпустить. Если вы передумали удалять данные, то просто выключите контроллер.
# Через пару минут контроллер перезагрузится и его индикатор станет равномерно мигать зелёным, а в Debug Console появится приглашение входа: <code>wirenboard-XXXXXXXX login:</code>.


=== Массовая прошивка контроллеров ===
<gallery mode="packed" heights="250px" caption="Сообщения в Debug-консоли">
{{Wbincludes:Mass flashing from flash}}
Image: wb7-usbflash-reset-1.png  | Сообщение о том, что мы перевели контроллер в режим обновления
Image: wb7-usbflash-reset-1.1.png  | Обнаружена флешка с файлом wb_update_FACTORYRESET.fit
Image: wb7-usbflash-reset-2.png  | Если вы сбрасываете настройки, то в консоли будет виден запрос на подтверждение очистки, а чуть ниже информация о fit-файле
</gallery>


== Удаление данных и возврат заводских настроек ==
== Удаление данных и возврат заводских настроек ==
{{Anchor|factory-reset}}
Если у вас контроллер из партии v7.2.1A, выпущенной в декабре 2021 года, подготовьте контроллер по [[Wiren Board v7.2.1A Create Restore Folder | инструкции]].
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
=== О способе ===
Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек, а также релиз ПО контроллера, который был в момент его выпуска — сделайте резервную копию ваших файлов и настроек.


=== Процесс ===
Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек. Делается это с помощью сервисного образа, который зашит в контроллер при производстве и не обновляется в процессе эксплуатации. Поэтому после процедуры ПО контроллера нужно обновить.
Если у вас установлены USB-флеш, карта MicroSD или воткнут провод в Debug Network — вытащите их.


Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать в подтверждение тех или иных действий и писать сообщения о ходе процесса.
Перед началом рекомендуем [[#Пользовательские настройки и файлы | сделать резервную копию]] файлов конфигурации и пользовательских файлов — они будут удалены.


В инструкции мы просто зажмём кнопку FW и автоматом подтвердим все действия:
В процессе контроллер будет несколько раз запрашивать в [[WB Debug Console | Debug-консоли]] подтверждение тех или иных действий, но чтобы упростить процедуру — мы просто зажмём кнопку FW в самом начале и автоматом со всем согласимся:
# Начало зависит от аппаратной ревизии контроллера:
# Выключите контроллер кнопкой на корпусе.
#* Для ревизии 7.3:
# Зажмите и не отпускайте кнопку FW.
#*# Переведите выключатель в положение OFF и вытащите кабели из разъёмов Debug Console и Debug Network.
# Включите контроллер и продолжайте удерживать кнопку.
#*# Зажмите и не отпускайте кнопку FW.
# После включения контроллер:
#*# Подключите к контроллеру внешнее питание. Если вам нужны логи из дебага, вместо внешнего питания можно подключить кабель Debug Console, контроллер включится автоматически.
#* пикнет один раз — это он перешёл в режим обновления прошивки, не отпускайте кнопку;
#*# Включите контроллер кнопкой и продолжайте удерживать кнопку FW.
#* подождите 10-20 секунд, затем он пикнет сперва коротко два раза, а потом ещё четыре, но реже — началось удаление данных и откат версии прошивки к заводской, кнопку можно отпустить.
#*Для ревизии 7.2:
# По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.  
#*# Если нужно, подключите кабель к Debug Console.
#*# Переведите выключатель в положение OFF.
#*# Подключите к контроллеру внешнее питание.
#*# Зажмите и не отпускайте кнопку FW.
#*# Включите контроллер кнопкой и продолжайте удерживать кнопку FW.
# Контроллер издаст короткий звуковой сигнал — это он перешёл в режим обновления прошивки, не отпускайте кнопку FW.
#:В Debug Console при этом будет сообщение вида:
#:<syntaxhighlight lang="bash">
Press FW button to enter firmware update mode
Entering firmware update mode.
</syntaxhighlight>
# Подождите 20-30 секунд, пока контроллер перебирает все накопители в поисках прошивки. В финале прозвучит один двойной звуковой сигнал — контроллер перешёл к процедуре сброса с помощью зашитого на заводе образа прошивки.
#:В Debug Console при этом будет сообщение вида:
#:<syntaxhighlight lang="bash">
Load modules for USB to work
Waiting for USB to settle (10/10)
Waiting for microSD to settle (3/3)
Wait for eMMC to become available...


Will use /mnt/data/.wb-restore/factoryreset.fit
Вся процедура занимает чуть больше 2 минут. Рекомендуем обновить прошивку до актуального релиза.
</syntaxhighlight>
# Через несколько секунд контроллер спросит подтверждение на удаление всех данных, но так как кнопка у нас уже зажата, то просто прозвучат по очереди четыре коротких звуковых сигнала. После этого сразу начнётся удаление данных, откат версии прошивки к заводской и восстановление заводских настроек.
#:В Debug Console при этом будет сообщение вида:
#:<syntaxhighlight lang="bash">
##############################################################################


                          FACTORY RESET REQUESTED
<gallery mode="packed" heights="250px" caption="Сообщения в Debug-консоли">
Image: wb7-int-reset-1.png  | Сообщение о том, что мы перевели контроллер в режим обновления
Image: wb7-int-reset-2.png  | Подтверждение сброса контроллера с внутреннего образа
</gallery>


          This WILL destroy ALL YOUR DATA: configuration, scripts,
== Пользовательские настройки и файлы ==
                          files in home directory!
{{Wbincludes:Firmware Update Save Data}}{{Wbincludes:WebUI Wiren Board Releases
 
|new=true}}
        If you are ABSOLUTELY SURE that you want to reset Wiren Board
            to factory condition, hold the FW button for 4 seconds.
 
        If you will not do it in 10 seconds, the controller will reboot
                        without firmware update.
 
 
          If you want to perform a regular firmware update, rename
        FIT file to "wbX_update.fit" without "factory-reset" suffix.
 
##############################################################################
.... #< здесь звучали четыре коротких звуковых сигнала >
 
Factory reset is confirmed!
</syntaxhighlight>
# Отпустите кнопку FW.
# По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.
 
Вся процедура занимает чуть больше 2 минут. После сброса у вас будет версия прошивки, зашитая в контроллер при производстве — обновите ПО до актуального релиза.
 
== Удаление данных и возврат заводских настроек с обновлением ПО ==
{{Wbincludes:FactoryReset WebUI}}

Версия 19:21, 15 марта 2022

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

Кнопка FW, которая переводит контроллер в режим обновления прошивки. Понадобится в некоторых инструкциях

Если у вас контроллер из партии v7.2.1A, выпущенной в декабре 2021 г. и в консоли написано «This is a development release» — перед обновлением или возвратом заводских настроек, переключите его на релиз. Инструкции в этой статье работают на контроллере Wiren Board 7.

ПО контроллера выпускается в формате релизов stable — новые функции каждые три месяца, и testing — новые функции каждый день. Между релизами можно переключаться, с завода на контроллере установлен stable. О том, как узнать установленный у вас релиз и как между ними переключаться, читайте в статье Релизы ПО.

Прошивку контроллера Wiren Board можно обновить в консоли с помощью apt, через веб-интерфейс, с компьютера, USB-флешки и карты памяти. В зависимости от выбранного типа обновления вы можете сохранить настройки и установленное ПО.

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

Если у вас в процессе обновления или сброса возникли проблемы, подключитесь к Debug-консоли и посмотрите выводимые там сообщения — это поможет понять, что именно идёт не так.

Для обновления через веб-интерфейс или с USB-флешки вам понадобится fit-файл прошивки, который можно скачать в нашем репозитории или по прямой ссылке на stable-релиз: Wiren Board 7.x.

Журнал изменений в релизах

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

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

Wbincludes:Wiren Board Check firmware update

Обновление

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

Wbincludes:Wiren Board Apt firmware update

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

Wbincludes:WebUI Wiren Board Firmware Update

Через разъём Debug Network

Файл обновления прошивки на съёмном накопителе
Разъём Debug Network, USB-C

В контроллере есть разъём Debug Network, который можно использовать для обновления прошивки или сброса настроек.

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

Вам понадобятся компьютер и кабель USB-C с возможностью передачи данных.

В процессе контроллер будет несколько раз запрашивать в Debug-консоли подтверждение тех или иных действий, мы будем ориентироваться на звуковые сигналы и подтверждать все запросы: Wbincludes:Wiren Board 7 Fit Prepare

  1. Выключите контроллер кнопкой на корпусе.
  2. Подключите контроллер к компьютеру через разъём Debug Network.
  3. Зажмите кнопку FW и удерживайте её.
  4. Включите контроллер и после короткого звукового сигнала отпустите кнопку FW.
  5. Индикатор контроллера медленно замигает красным, а ещё через 10 секунд компьютер определит съёмный накопитель.
  6. Скопируйте подготовленный в шаге 1 файл на определившийся накопитель.
  7. Извлеките (отмонтируйте) флешку программно и отключите кабель от контроллера физически.
  8. В зависимости от того, какой файл вы скопировали, возможно два варианта:
    1. Контроллер два раза коротко пикнет — началось обновление прошивки.
    2. Контроллер пикнет сперва коротко два раза, затем издаст продолжительный звуковой сигнал, а индикатор быстро замигает красным — это запрос на сброс к заводским настройкам:
      • Чтобы подтвердить сброс настроек и удалить все пользовательские данные, зажмите и держите кнопку FW.
      • Контроллер пикнет четыре раза и перейдёт к сбросу настроек. Кнопку можно отпустить.
  9. По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.

Вся процедура занимает около 2 минут.

  • Сообщения в Debug-консоли

  • Сообщение о том, что мы перевели контроллер в режим обновления

  • Контроллер подключён к компьютеру и на него записан файл wb_update_FACTORYRESET.fit

  • Если вы сбрасываете настройки, то в консоли будет виден запрос на подтверждение очистки

С помощью USB-флешки или карты Micro-SD

Файл сброса к заводским настройкам на USB-флешке
Разъём USB 1 и слот Micro-SD

В контроллере есть разъём USB 1 и слот Micro-SD, которые можно использовать для обновления прошивки или удаления данных с восстановлением заводских настроек. С некоторыми картами Micro-SD могут быть проблемы, используйте USB-флешку или промышленную карту Transcend 64GB.

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

В процессе контроллер будет несколько раз запрашивать в Debug-консоли подтверждение тех или иных действий, но чтобы упростить процедуру — мы просто зажмём кнопку FW в самом начале и автоматом со всем согласимся:

  1. Загрузите на компьютер fit-файл прошивки и переименуйте его в: wb_update.fit для обновления или wb_update_FACTORYRESET.fit для обновления с удалением данных, установленного ПО и возвратом заводских настроек.
  2. Отформатируйте флешку или карту памяти в FAT32.
  3. Скопируйте подготовленный в шаге 1 файл на флешку или карту памяти.
  4. Выключите контроллер кнопкой на корпусе.
  5. Вставьте флешку в разъём USB 1 или карту памяти в слот Micro-SD.
  6. Зажмите и не отпускайте кнопку FW.
  7. Включите контроллер и продолжайте удерживать кнопку.
  8. После включения контроллер пикнет один раз — это он перешёл в режим обновления прошивки, не отпускайте кнопку.
  9. В зависимости от того, какой файл вы положили, возможно два варианта:
    1. Контроллер два раза коротко пикнет — началось обновление прошивки, кнопку можно отпустить.
    2. Контроллер пикнет сперва коротко два раза, а затем ещё четыре, но реже — началось удаление данных и восстановление заводских настроек, кнопку можно отпустить.
  10. По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.

Вся процедура занимает около 2 минут.

  • Сообщения в Debug-консоли

  • Сообщение о том, что мы перевели контроллер в режим обновления

  • Обнаружена флешка с файлом wb_update_FACTORYRESET.fit

  • Если вы сбрасываете настройки, то в консоли будет виден запрос на подтверждение очистки, а чуть ниже информация о fit-файле

Удаление данных и возврат заводских настроек

Если у вас контроллер из партии v7.2.1A, выпущенной в декабре 2021 года, подготовьте контроллер по инструкции.

Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек. Делается это с помощью сервисного образа, который зашит в контроллер при производстве и не обновляется в процессе эксплуатации. Поэтому после процедуры ПО контроллера нужно обновить.

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

В процессе контроллер будет несколько раз запрашивать в Debug-консоли подтверждение тех или иных действий, но чтобы упростить процедуру — мы просто зажмём кнопку FW в самом начале и автоматом со всем согласимся:

  1. Выключите контроллер кнопкой на корпусе.
  2. Зажмите и не отпускайте кнопку FW.
  3. Включите контроллер и продолжайте удерживать кнопку.
  4. После включения контроллер:
    • пикнет один раз — это он перешёл в режим обновления прошивки, не отпускайте кнопку;
    • подождите 10-20 секунд, затем он пикнет сперва коротко два раза, а потом ещё четыре, но реже — началось удаление данных и откат версии прошивки к заводской, кнопку можно отпустить.
  5. По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.

Вся процедура занимает чуть больше 2 минут. Рекомендуем обновить прошивку до актуального релиза.

  • Сообщения в Debug-консоли

  • Сообщение о том, что мы перевели контроллер в режим обновления

  • Подтверждение сброса контроллера с внутреннего образа

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

Wbincludes:Firmware Update Save DataВнимание: Отображаемое название «Программное обеспечение контроллеров Wiren Board» переопределяет ранее заданное отображаемое название «Обновление прошивки контроллера Wiren Board 7».

Как устроено ПО Wiren Board

Структура ПО контроллера. В центре очередь сообщений MQTT, которая используется для обмена информацией между разными частями ПО

Wiren Board работает под управлением Debian Linux. Для архитектуры используемого процессора есть официальный порт, поэтому любое стандартное Linux-приложение можно установить из репозитория одной командой apt install имя_пакета.

Все сервисы контроллера общаются между собой по общей «шине», в роли которой выступает Очередь сообщений MQTT.

По умолчанию установлены Веб-интерфейс Wiren Board, Движок правил wb-rules, а также драйвера и вспомогательные утилиты.

Опционально можно установить шлюзы для интеграции со SCADA-системами и сторонний софт. Полный список смотрите в Таблице поддерживаемых устройств, протоколов и программ.

Разработка своих решений

Вы можете разрабатывать своё ПО для контроллеров Wiren Board или собрать собственный образ прошивки с нужными вам настройками, лицензиями и пакетами. Свой образ прошивки можно установить в контроллеры самостоятельно штатными средствами, или мы можем делать это сразу на производстве при заказе отдельной партии.

Исходный код программного обеспечения контроллера доступен на GitHub. Там можно почерпнуть примеры для разработки собственного ПО.

Статьи:

Обновление прошивки и релизный цикл

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

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

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

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

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

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

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

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

Версия ПО в веб-интерфейсе контроллера
WebUI → Devices → System

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

Узнать версию релиза можно в веб-интерфейсе контроллера в разделе Устройства в карточке устройства System или в консоли командой wb-release.

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

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

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

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

Кроме этого, сменить релиз можно с помощью прошивки контроллера fit-файлом, способы и ограничения смотрите в инструкции по обновлению ПО для вашего контроллера.

Обновление прошивки контроллера и откат к заводским настройкам

Прошивку контроллера можно обновить или вернуть его к заводскому состоянию с удалением всех данных.

Все ревизии контроллера можно обновить через менеджер пакетов apt или веб-интерфейс, а в относительно свежих добавилась возможность обновления с флеш-накопителя и через Debug Network.

Инструкции:

  • Как узнать ревизию контроллера

  • Ревизия контроллера в веб-интерфейсе. Устройства → System

  • Ревизия контроллера в консоли, при подключении по SSH. Сразу под баннером, зелёными цифрами 6.7.2

  • Ревизия контроллера на наклейке

Список сервисов и их назначение

Список сервисов, запущенных на контроллере, их статус и описание можно получить командой: 

systemctl list-units --type=service

Про управление сервисами читайте в статье Диагностика ошибок в работе контроллера.

Имя сервиса Описание
avahi-daemon.service Avahi mDNS/DNS-SD Stack
bluetooth.service Bluetooth service
cgmanager.service Cgroup management daemon
cron.service Regular background program processing daemon
dbus.service D-Bus System Message Bus
dnsmasq.service dnsmasq - A lightweight DHCP and caching DNS server
getty@tty1.service Getty on tty1
hostapd.service LSB: Advanced IEEE 802.11 management daemon
kmod-static-nodes.service Create list of required static device nodes for the current kernel
knxd.service KNX Daemon
mosquitto.service Mosquitto MQTT v3.1/v3.1.1 Broker
netplug.service LSB: Brings up/down network automatically
networking.service Raise network interfaces
nginx.service A high performance web server and a reverse proxy server
ntp.service LSB: Start NTP daemon
rsyslog.service System Logging Service
serial-getty@ttymxc0.service Serial Getty on ttymxc0
ssh.service OpenBSD Secure Shell server
systemd-fsck-root.service File System Check on Root Device
systemd-fsck@dev-mmcblk0p6.service File System Check on /dev/mmcblk0p6
systemd-journal-flush.service Flush Journal to Persistent Storage
systemd-journald.service Journal Service
systemd-logind.service Login Service
systemd-modules-load.service Load Kernel Modules
systemd-random-seed.service Load/Save Random Seed
systemd-modules-load.service Load Kernel Modules
systemd-random-seed.service Load/Save Random Seed
systemd-remount-fs.service Remount Root and Kernel File Systems
systemd-sysctl.service Apply Kernel Variables
systemd-tmpfiles-setup-dev.service Create Static Device Nodes in /dev
systemd-tmpfiles-setup.service Create Volatile Files and Directories
systemd-udev-trigger.service udev Coldplug all Devices
systemd-udevd.service udev Kernel Device Manager
systemd-update-utmp.service Update UTMP about System Boot/Shutdown
systemd-user-sessions.service Permit User Sessions
user@0.service User Manager for UID 0
watchdog.service watchdog daemon
wb-configs-early.service prepare mounts and symlinks to config files
wb-configs.service watch config files
wb-gsm-rtc.service LSB: initscript to use GSM modem integrated RTC
wb-homa-ism-radio.service LSB: MQTT driver for WB HomA for RFM69 ISM radio
wb-hwconf-manager.service LSB: Hardware configuration with Device Tree overlays
wb-init.service LSB: board-specific initscript
wb-mqtt-adc.service MQTT Driver for ADC
wb-mqtt-confed.service LSB: Configuration Editor Backend
wb-mqtt-db.service Wiren Board database logger
wb-mqtt-gpio.service MQTT Driver for GPIO-controlled switches
wb-mqtt-knx.service LSB: : Wiren Board MQTT KNX bridge
wb-mqtt-logs.service Wiren Board journald to MQTT gateway
wb-mqtt-mbgate.service Wiren Board MQTT to Modbus TCP gateway
wb-mqtt-opcua.service Wiren Board MQTT to OPC UA gateway
wb-mqtt-serial.service MQTT Driver for serial devices
wb-mqtt-w1.service Kernel 1-Wire MQTT driver for WB-HomA
wb-prepare.service initialize filesystems at first boot
wb-repart.service prepare partitions at first boot
wb-rules.service MQTT Rule engine for Wiren Board
wb-systime-adjust.service Compensation of systime in PPM from value, stored in device-tree (with opposite sign)
wb-watch-update.service LSB: Firmware update monitor
Источник — https://wirenboard.com/wiki/index.php?title=Wiren_Board_7_Firmware_Update&oldid=59884