|
|
Строка 1: |
Строка 1: |
| {{DISPLAYTITLE: Обновление прошивки контроллеров Wiren Board 7.2…7.3 }} | | {{DISPLAYTITLE: Обновление прошивки контроллеров Wiren Board 6.x }} |
| == Общая информация == | | == Общая информация == |
| {{Anchor|info}} | | {{Anchor|info}} |
Строка 8: |
Строка 8: |
| === Совместимость === | | === Совместимость === |
| {{Anchor|compatibility}} | | {{Anchor|compatibility}} |
| Инструкции на этой странице подходят для контроллеров Wiren Board 7.2…7.3. Инструкцию по обновлению Wiren Board 6.x и Wiren Board 7.4 смотрите на соответствующих страницах. | | Инструкции на этой странице подходят для контроллеров Wiren Board 6.x. Инструкцию по обновлению Wiren Board 7.2…7.3 и Wiren Board 7.4 смотрите на соответствующих страницах. |
|
| |
|
| === Как всё устроено === | | === Как всё устроено === |
Строка 33: |
Строка 33: |
| {{note|note|Рекомендуемый способ. Если последний раз ПО контроллера обновлялось до апреля 2021 года, то сперва вам нужно перейти на релизы, для этого [[New_repository_April_2021 | смените репозиторий]].}} | | {{note|note|Рекомендуемый способ. Если последний раз ПО контроллера обновлялось до апреля 2021 года, то сперва вам нужно перейти на релизы, для этого [[New_repository_April_2021 | смените репозиторий]].}} |
|
| |
|
| Если вы обновляетесь с релиза wb-2207 и более раннего через apt, то прочитайте сперва описание известных проблем, с которыми вы столкнётесь: [[WB_7:_Errata#ERRWB73011 | Wiren Board 7: ERRWB73011]]. | | Если вы обновляетесь с релиза wb-2207 и более раннего через apt, то прочитайте сперва описание известных проблем, с которыми вы столкнётесь: [[WB_6:_Errata#ERRWB600022 |Wiren Board 6: ERRWB600022]]. |
|
| |
|
| Важно! В релизе wb-2304 сменилась версия Debian, поэтому при переходе со старых релизов wb-21**/wb-22** надо ввести дополнительную команду ([[wb-2304|подробнее]]): | | Важно! В релизе wb-2304 сменилась версия Debian, поэтому при переходе со старых релизов wb-21**/wb-22** надо ввести дополнительную команду ([[wb-2304|подробнее]]): |
Строка 45: |
Строка 45: |
| {{Wbincludes:Bullseye Errata}} | | {{Wbincludes:Bullseye Errata}} |
|
| |
|
| == Прошивка через веб-интерфейс == | | == Обновление через веб-интерфейс== |
| {{Anchor|web-ui}} | | {{Anchor|web-ui}} |
| | | {{note|note|Этим способом можно обновить текущий релиз более новым, или перейти со stable на testing. Для перехода на старый релиз используйте процедуру удаления данных, описанную в конце этой страницы.}} |
| === О способе ===
| |
| Прошивку через веб-интерфейс удобно использовать, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО. Способ подходит для обновления внутри веток stable или testing, а также для перехода со stable на testing.
| |
| | |
| {{Wbincludes:Firmware Update Fit Save Data}}
| |
|
| |
|
| === Скачивание прошивки === | | === Скачивание прошивки === |
| {{Wbincludes:Fit Files Wiren Board 7}} | | {{Wbincludes:Fit Files Wiren Board 6}} |
|
| |
|
| === Процесс === | | === Процесс === |
Строка 60: |
Строка 56: |
| {{Wbincludes:Wiren Board WebUI Firmware Update}} | | {{Wbincludes:Wiren Board WebUI Firmware Update}} |
|
| |
|
| == Прошивка через Debug Network == | | == Прошивка с помощью USB-флешки == |
| {{Anchor|debug-network}}
| | Для обновления прошивки или удаления данных и настроек можно воспользоваться USB-флешкой или картой памяти Micro SD. |
|
| |
|
| [[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:Wiren Board 7 Firmware Update Fit Save Data}} |
|
| |
|
| === Подготовка файла прошивки === | | === Подготовка файла прошивки === |
| {{Wbincludes:Fit Files Wiren Board 7}} | | {{Wbincludes:Fit Files Wiren Board 6}} |
|
| |
|
| {{Wbincludes:Fit File Rename Wiren Board 7}}
| | Переименуйте загруженный файл в <code>wb6_update.fit</code> — для обновления, или в <code>wb6_update_FACTORYRESET.fit</code> — для удаления данных и сброса к заводским настройкам. Обратите внимание, что .fit — расширение файла, если у вас Windows и отключен показ расширений, то скаченный файл будет без него — не надо его добавлять, просто замените имя до точки. |
|
| |
|
| === Процесс ===
| | [[Formatting Flash Drive | Отформатируйте флешку в FAT32]] и скопируйте на неё файл. |
| Вам понадобятся компьютер и кабель USB-C с возможностью передачи данных. Весь процесс займёт не больше пяти минут.
| |
|
| |
|
| Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать в подтверждение тех или иных действий и писать сообщения о ходе процесса.
| | Если возникнут проблемы с обновлением, подключитесь к [[WB_Debug_Console | Debug-консоли]] контроллера и повторите обновление. Если увидите ошибку <code>FAT: Misaligned buffer address</code> — возможно следует попробовать другой накопитель. Для контроллеров если происходит перезагрузка в процессе обновления 6.7-6.9 может потребоваться обновление загрузчика командой <code>u-boot-install-wb</code> Так же можно посмотреть в [[WB_6:_Errata]], так как в некоторых ревизиях контроллера была проблема с определением флешки. |
|
| |
|
| В инструкции мы будем ориентироваться на звуковые сигналы и подтверждать все запросы:
| | === Процесс === |
| # Начало зависит от аппаратной ревизии контроллера:
| | [[Image: WB6.7 USB1 + FW.png |400px|thumb|right| Порт '''USB 1''' и кнопка '''FW''' на контроллере Wiren Board 6.7]] |
| #* Для ревизии 7.3:
| | В процессе контроллер будет несколько раз запрашивать в [[WB Debug Console | Debug-консоли]] подтверждение тех или иных действий, но чтобы не подключаться к ней, мы будем ориентироваться по светодиоду и звуковым сигналам. Действия подтверждаются нажатием на кнопку '''FW'''. |
| #*# Переведите выключатель в положение 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 ==
| |
| {{Anchor|usb-flash}}
| |
| [[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
| |
| === О способе ===
| |
| Для обновления прошивки или удаления данных и настроек можно воспользоваться USB-флешкой или картой памяти Micro SD.
| |
| | |
| Способ удобен, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО.
| |
| | |
| {{Wbincludes:Wiren Board 7 Firmware Update Fit Save Data}}
| |
|
| |
|
| === Подготовка файла прошивки ===
| | '''{{#if:{{{ractory_reset|}}}|Чтобы удалить все данные и восстановить заводские настройки|Чтобы обновить прошивку}}''': |
| {{Wbincludes:Fit Files Wiren Board 7}} | | # Выключите контроллер. |
| | # Подключите флешку с файлом прошивки к порту '''USB 1''' и включите контроллер. |
| | # Если в корне флешки найден файл прошивки, то индикатор контроллера начнёт часто мигать оранжевым. |
| | # В этот момент зажмите на одну секунду кнопку '''FW''', которая находится рядом с разъёмом Wi-Fi. |
| | #{{#if:{{{ractory_reset|}}} |
| | |# Индикатор несколько раз сменит цвет и через несколько секунд контроллер начнёт пищать, а индикатор замигает красным — контроллер ждёт подтверждения. |
| | # Подтвердите удаление данных, установленного ПО и возврат к заводским настройкам, для этого нажмите кнопку '''FW''' и держите, пока контроллер не пискнет четыре раза, а индикатор не загорится зелёным — контроллер начал удалять данные. Кнопку можно отпустить. |
| | # В процессе индикатор будет мигать зелёным. |
| | |Индикатор загорится зелёным, потом мигнёт красным и замигает зелёным — это началась процедура обновления прошивки.}} |
|
| |
|
| {{Wbincludes:Fit File Rename Wiren Board 7}}
| | Процедура продлится 5–10 минут, в конце контроллер перезагрузится в рабочий режим, а индикатор на нём замигает зелёным — флешку можно извлечь. |
|
| |
|
| === Процесс === | | <gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли"> |
| Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать подтверждение тех или иных действий и писать сообщения о ходе процесса.
| | Image: 2 update.png | Момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления |
| | | Image: 4 update.png | Обновление прошивки началось |
| В инструкции мы будем ориентироваться на звуковые сигналы и подтверждать все запросы:
| | </gallery> |
| # Скопируйте подготовленный файл прошивки на флешку или карту памяти и вставьте её в контроллер.
| |
| # Следующие шаги зависят от аппаратной ревизии контроллера:
| |
| #* Для ревизии 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}} | | {{Wbincludes:Mass flashing from flash}} |
| | |
|
| |
|
| == Удаление данных и возврат заводских настроек == | | == Удаление данных и возврат заводских настроек == |
| {{Anchor|factory-reset}}
| |
| [[Image: wb7-FW.png |300px|thumb|right| Кнопка FW — переводит контроллер в режим прошивки и подтверждает запросы действий в процессе прошивки]]
| |
| === О способе ===
| |
| Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек, а также релиз ПО контроллера, который был в момент его выпуска — сделайте резервную копию ваших файлов и настроек.
| |
|
| |
|
| === Процесс === | | {{Wbincludes:USB Wiren Board 6 Firmware Update|ractory_reset=true}} |
| Если у вас установлены USB-флеш, карта MicroSD или воткнут провод в Debug Network — вытащите их.
| |
|
| |
|
| Для наглядности можно подключиться к [[WB Debug Console | Debug Console]], где контроллер будет несколько раз запрашивать в подтверждение тех или иных действий и писать сообщения о ходе процесса.
| | <gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли"> |
| | Image: 1 factory reset.png | Момент, когда нужно кратковременно нажать кнопку FW для удаления данных |
| | Image: 2 factory reset.png | Момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения удаления данных настройкам |
| | Image: 3 factory reset.png | Началось удаление данных и возврат заводских настроек |
| | </gallery> |
|
| |
|
| В инструкции мы просто зажмём кнопку FW и автоматом подтвердим все действия:
| | == Удаление данных и возврат заводских настроек с обновлением ПО == |
| # Начало зависит от аппаратной ревизии контроллера:
| | {{SupportedSinceRelease |
| #* Для ревизии 7.3:
| | | release = wb-2401 |
| #*# Переведите выключатель в положение OFF и вытащите кабели из разъёмов Debug Console и Debug Network.
| | |content= |
| #*# Зажмите и не отпускайте кнопку 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
| | <h3> О способе </h3> |
| </syntaxhighlight> | |
| # Через несколько секунд контроллер спросит подтверждение на удаление всех данных, но так как кнопка у нас уже зажата, то просто прозвучат по очереди четыре коротких звуковых сигнала. После этого сразу начнётся удаление данных, откат версии прошивки к заводской и восстановление заводских настроек.
| |
| #:В Debug Console при этом будет сообщение вида:
| |
| #:<syntaxhighlight lang="bash">
| |
| ##############################################################################
| |
|
| |
|
| FACTORY RESET REQUESTED
| | Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек — сделайте резервную копию ваших файлов и настроек. В отличие от аналогичного способа с кнопкой FW, происходит обновление ПО контроллера до версии, которая используется в выбранном вами fit-файле. |
|
| |
|
| This WILL destroy ALL YOUR DATA: configuration, scripts,
| | <h3> Подготовка файла прошивки </h3> |
| files in home directory!
| | {{note|info| Функция пока доступна только для fit-образов с testing-релизом.}} |
| | [[Image: fit-link.png|250px|thumb|right| Cсылка для скачивания FIT-файлов в веб-интерфейсе контроллера Wiren Board]] |
|
| |
|
| If you are ABSOLUTELY SURE that you want to reset Wiren Board
| | Вам понадобится fit-файл прошивки для вашей версии контроллера, свежие образы stable-релиза находятся по ссылкам: [https://fw-releases.wirenboard.com/fit_image/stable/6x/latest.fit Wiren Board 6.3–6.6.0], [https://fw-releases.wirenboard.com/fit_image/stable/67/latest.fit Wiren Board 6.7.x–6.9.x]; |
| to factory condition, hold the FW button for 4 seconds.
| |
|
| |
|
| If you will not do it in 10 seconds, the controller will reboot
| | Образы testing и старые версии ПО вы найдёте в [https://fw-releases.wirenboard.com/?prefix=fit_image/ нашем репозитории]. |
| without firmware update.
| |
|
| |
|
| | Начиная с релиза wb-2304 ссылка для скачивания FIT-файлов доступна в веб-интерфейсе в разделе '''Настройки''' → '''Система'''. |
|
| |
|
| If you want to perform a regular firmware update, rename
| | <h3> Процесс </h3> |
| FIT file to "wbX_update.fit" without "factory-reset" suffix.
| | [[Image: FactoryReset WebUI.png|thumb|right|Страница системных настроек в веб-интерфейсе контроллера]] |
| | Чтобы удалить все данные, сбросить настройки и обновить версии ПО на контроллере: |
| | # Скачайте fit-файл по инструкции выше. |
| | # Откройте веб-интерфейс контроллера. |
| | # Перейдите '''Настройки''' → '''Система'''. |
| | # Загрузите fit-файл с прошивкой в разделе '''Удаление данных и сброс настроек (Factory reset)''' и дождитесь окончания процедуры. |
| | # Перезагрузите контроллер. |
|
| |
|
| ##############################################################################
| | Заметим, что процедура не заменяет встроенный образ заводского ПО, поэтому вы всегда можете откатиться к нему с помощью кнопки FW. Это позволит вам вернуть заводскую прошивку контроллера, на которой он проходил тесты на стенде и точно стабильно работал. |
| .... #< здесь звучали четыре коротких звуковых сигнала >
| | }} |
| | |
| Factory reset is confirmed!
| |
| </syntaxhighlight>
| |
| # Отпустите кнопку FW.
| |
| # По окончании процедуры контроллер перезагрузится в рабочем режиме, а его индикатор замигает зелёным.
| |
| | |
| Вся процедура занимает чуть больше 2 минут. После сброса у вас будет версия прошивки, зашитая в контроллер при производстве — обновите ПО до актуального релиза.
| |
| | |
| == Удаление данных и возврат заводских настроек с обновлением ПО ==
| |
| {{Wbincludes:FactoryReset WebUI}}
| |