16 578
правок
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE: Wiren Board 7 | {{DISPLAYTITLE: Обновление прошивки контроллеров Wiren Board 7.2…7.3 }} | ||
== Общая информация == | == Общая информация == | ||
{{Anchor|info}} | |||
{{YouTube | |||
|link=https://youtu.be/2XhPWDzYSmY | |||
|text= Обновление ПО контроллера Wiren Board 7 | |||
}} | |||
=== Совместимость === | |||
{{Anchor|compatibility}} | |||
Инструкции на этой странице подходят для контроллеров Wiren Board 7.2…7.3. Инструкцию по обновлению Wiren Board 6.x и Wiren Board 7.4 смотрите на соответствующих страницах. | |||
=== Как всё устроено === | |||
{{Wbincludes:Firmware Update How Everything Works}} | |||
=== Релизы === | |||
Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы stable — стоит на новых контроллерах и testing — rolling-релиз с самыми свежими версиями пакетов. | |||
О переключении между релизами и другую информацию смотрите в статье [[Wiren_Board_Software|Программное обеспечение Wiren Board]]. | |||
== Прошивка через | == Пользовательские настройки и файлы == | ||
{{Anchor|user-files}} | |||
{{Wbincludes:Wiren Board User Settings And Files}} | |||
== Проверка обновлений == | |||
{{Wbincludes:Wiren Board Check Firmware Update}} | |||
== Обновление в консоли через apt== | |||
{{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 WebUI Firmware Update}} | |||
== Прошивка через Debug Network == | |||
{{Anchor|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-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:Wiren Board 7 Firmware Update Fit Save Data}} | ||
Вам понадобятся компьютер и кабель USB-C с возможностью передачи данных. | === Подготовка файла прошивки === | ||
{{Wbincludes:Fit Files Wiren Board 7}} | |||
{{Wbincludes:Fit File Rename Wiren Board 7}} | |||
=== Процесс === | |||
Вам понадобятся компьютер и кабель USB-C с возможностью передачи данных. Весь процесс займёт не больше пяти минут. | |||
Для наглядности можно подключиться к [[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> | |||
# Отпустите кнопку FW. | |||
# Через несколько секунд на компьютере обнаружится накопитель '''WB UPDATE''', откройте его. В Debug Console в это время будет сообщение: | |||
#:<syntaxhighlight lang="bash"> | |||
Waiting for USB gadget to connect to host PC | |||
Copy .fit file to virtual USB driver and unplug the cable | |||
</syntaxhighlight> | |||
# Скопируйте подготовленный .fit-файл на этот накопитель — контроллер каждую секунду будет следить за процессом. | |||
# Когда файл полностью скопируется, контроллер автоматически отключит накопитель, издаст два коротких звуковых сигнала и начнет прошивку. В 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> | |||
# Через пару минут контроллер перезагрузится и его индикатор станет равномерно мигать зелёным, а в Debug Console появится приглашение входа: <code>wirenboard-XXXXXXXX login:</code>. | |||
< | Если в имени файла есть <code>FACTORYRESET</code>, то контроллер издаст продолжительный звуковой сигнал — запрос подтверждения удаления всех данных. В Debug Console будет сообщение: <code>FACTORY RESET REQUESTED</code>. Нажмите и держите кнопку FW, пока контроллер не издаст по очереди четыре коротких звуковых сигнала. Кнопку можно отпустить. Если вы передумали удалять данные — просто выключите контроллер. | ||
== Прошивка с помощью USB-флешки или карты Micro-SD == | == Прошивка с помощью 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: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>. | |||
=== Массовая прошивка контроллеров === | === Массовая прошивка контроллеров === | ||
Строка 78: | Строка 171: | ||
== Удаление данных и возврат заводских настроек == | == Удаление данных и возврат заводских настроек == | ||
{{Anchor|factory-reset}} | {{Anchor|factory-reset}} | ||
[[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]] | |||
=== О способе === | |||
Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек, а также релиз ПО контроллера, который был в момент его выпуска — сделайте резервную копию ваших файлов и настроек. | Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек, а также релиз ПО контроллера, который был в момент его выпуска — сделайте резервную копию ваших файлов и настроек. | ||
=== Процесс === | |||
Если у вас установлены USB-флеш, карта MicroSD или воткнут провод в Debug Network — вытащите их. | Если у вас установлены USB-флеш, карта MicroSD или воткнут провод в Debug Network — вытащите их. | ||
Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать в подтверждение тех или иных действий и писать сообщения о ходе процесса. | |||
# | |||
# Зажмите и не отпускайте кнопку FW. | В инструкции мы просто зажмём кнопку FW и автоматом подтвердим все действия: | ||
# Включите контроллер и продолжайте удерживать кнопку 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:FactoryReset WebUI}} | {{Wbincludes:FactoryReset WebUI}} |