16 885
правок
(не показана 91 промежуточная версия 2 участников) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Обновление прошивки | {{DISPLAYTITLE: Обновление прошивки контроллеров Wiren Board 7.2…7.3 }} | ||
== Общая информация == | == Общая информация == | ||
{{ | {{Anchor|info}} | ||
{{YouTube | |||
|link=https://youtu.be/2XhPWDzYSmY | |||
|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 | |||
}} | |||
=== Как всё устроено === | |||
{{Wbincludes:Firmware Update How Everything Works}} | |||
=== Релизы === | |||
{{Wbincludes:Wiren Board Software Releases}} | |||
== Пользовательские настройки и файлы == | |||
{{Anchor|user-files}} | |||
{{Wbincludes:Wiren Board User Settings And Files}} | |||
== | == Проверка обновлений == | ||
{{Wbincludes: | {{Wbincludes:Wiren Board Check Firmware Update}} | ||
== | == Обновление в консоли через apt== | ||
{{Wbincludes:Wiren Board | {{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]]. | |||
Важно! В релизе wb-2304 сменилась версия Debian, поэтому при переходе со старых релизов wb-21**/wb-22** надо ввести дополнительную команду ([[wb-2304|подробнее]]): | |||
:<syntaxhighlight lang="bash"> | |||
wb-release --update-debian-release | |||
</syntaxhighlight> | |||
{{Wbincludes:Wiren Board Apt Firmware Update}} | |||
=== Решение проблем при обновлении со Stretch на Bullseye === | |||
{{Wbincludes:Bullseye Errata}} | |||
== Прошивка через веб-интерфейс == | |||
{{Anchor|web-ui}} | |||
=== О способе === | |||
Прошивку через веб-интерфейс удобно использовать, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО. Способ подходит для обновления внутри веток stable или testing, а также для перехода со stable на testing. | |||
{{Wbincludes:Firmware Update Fit Save Data}} | |||
=== Скачивание прошивки === | |||
{{Wbincludes:Fit Files Wiren Board 7}} | |||
== | === Процесс === | ||
{{note|info|Если у вас на контроллере релиз wb-2307 и новее, а на самом контроллере корневой раздел 1 Гбайт, то его [[Enlarging_the_rootfs_partition|можно увеличить]].}} | |||
{{Wbincludes:Wiren Board | {{Wbincludes:Wiren Board WebUI Firmware Update}} | ||
== | == Прошивка через Debug Network == | ||
{{ | {{Anchor|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-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 File Rename Wiren Board 7}} | |||
=== Процесс === | |||
Вам понадобятся компьютер и кабель USB-C с возможностью передачи данных. Весь процесс займёт не больше пяти минут. | |||
{{Wbincludes:Firmware Update Fit Save Data}} | Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать в подтверждение тех или иных действий и писать сообщения о ходе процесса. | ||
В инструкции мы будем ориентироваться на звуковые сигналы и подтверждать все запросы: | |||
# Начало зависит от аппаратной ревизии контроллера: | |||
#* Для ревизии 7.3: | |||
#*# Переведите выключатель в положение OFF и вытащите кабели из разъёмов Debug Console и Debug Network. Это выключит контроллер. | |||
#*# Зажмите и не отпускайте кнопку 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) | |||
# или, если вы выбрали удаление данных | |||
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, пока контроллер не издаст по очереди четыре коротких звуковых сигнала. Кнопку можно отпустить. Если вы передумали удалять данные — просто выключите контроллер. | |||
== Прошивка с помощью USB-флешки или карты Micro-SD == | |||
{{Anchor|usb-flash}} | |||
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]] | |||
=== О способе === | |||
Для обновления прошивки или удаления данных и настроек можно воспользоваться USB-флешкой или картой памяти Micro SD. | |||
Способ удобен, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО. | |||
{{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]], где контроллер будет несколько раз запрашивать подтверждение тех или иных действий и писать сообщения о ходе процесса. | |||
В инструкции мы будем ориентироваться на звуковые сигналы и подтверждать все запросы: | |||
# Скопируйте подготовленный файл прошивки на флешку или карту памяти и вставьте её в контроллер. | |||
# Следующие шаги зависят от аппаратной ревизии контроллера: | |||
#* Для ревизии 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>. | |||
=== Массовая прошивка контроллеров === | |||
{{Wbincludes:Mass flashing from flash}} | |||
== Удаление данных и возврат заводских настроек == | |||
{{Anchor|factory-reset}} | |||
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]] | |||
=== О способе === | |||
Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек, а также релиз ПО контроллера, который был в момент его выпуска — сделайте резервную копию ваших файлов и настроек. | |||
=== Процесс === | |||
Если у вас установлены USB-флеш, карта MicroSD или воткнут провод в Debug Network — вытащите их. | |||
Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать в подтверждение тех или иных действий и писать сообщения о ходе процесса. | |||
В инструкции мы просто зажмём кнопку FW и автоматом подтвердим все действия: | |||
# Начало зависит от аппаратной ревизии контроллера: | |||
# | #* Для ревизии 7.3: | ||
# | #*# Переведите выключатель в положение OFF и вытащите кабели из разъёмов Debug Console и Debug Network. | ||
# Зажмите кнопку | #*# Зажмите и не отпускайте кнопку FW. | ||
# Включите контроллер и | #*# Подключите к контроллеру внешнее питание. Если вам нужны логи из дебага, вместо внешнего питания можно подключить кабель Debug Console, контроллер включится автоматически. | ||
# | #*# Включите контроллер кнопкой и продолжайте удерживать кнопку FW. | ||
# | #*Для ревизии 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 | ||
</syntaxhighlight> | |||
# Через несколько секунд контроллер спросит подтверждение на удаление всех данных, но так как кнопка у нас уже зажата, то просто прозвучат по очереди четыре коротких звуковых сигнала. После этого сразу начнётся удаление данных, откат версии прошивки к заводской и восстановление заводских настроек. | |||
#:В Debug Console при этом будет сообщение вида: | |||
< | #:<syntaxhighlight lang="bash"> | ||
############################################################################## | |||
FACTORY RESET REQUESTED | |||
This WILL destroy ALL YOUR DATA: configuration, scripts, | |||
files in home directory! | |||
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: | {{Wbincludes:FactoryReset WebUI}} | ||