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

Материал из Wiren Board
(не показано 26 промежуточных версий 3 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллеров Wiren Board 6.x }}
{{Draft}}
== Общая информация ==
== Введение ==
{{Anchor|info}}
{{note|note|Инструкции на этой странице работают только на контроллерах [[Wiren Board 6]], инструкцию по обновлению других версий ищите на страницах контроллеров в разделе «Программное обеспечение».}}
{{YouTube
[[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера<br>''WebUI'' → ''Devices'' → ''System'']]
|link=https://youtu.be/2XhPWDzYSmY
ПО контроллера состоит из множества пакетов, которые мы объединяем в релизы:
|text= Обновление ПО контроллера Wiren Board 7
* '''Stable''' — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок.
}}
* '''Testing''' — нестабильный релиз: свежие версии пакетов с новыми функциями, а так же исправленными и новыми ошибками.
=== Совместимость ===
{{Anchor|compatibility}}
{{Wbincludes:Update Compatibility
|model= Wiren Board 6
|link= Wiren Board 6
}}
=== Как всё устроено ===
{{Wbincludes:Firmware Update How Everything Works}}


=== Релизы ===
{{Wbincludes:Release Log}}
{{Wbincludes:Wiren Board Software Releases}}


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


== Проверка обновлений ==
Узнать версию релиза можно в веб-интерфейсе контроллера в разделе ''Devices'' в карточке устройства ''System'' или в консоли командой <code>wb-release</code>. Если в веб-интерфейсе нет упоминания о testing или stable или команда ''wb-release'' не найдена — у вас старая версия ПО и нужно сменить репозиторий.
{{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_6:_Errata#ERRWB600022 |Wiren Board 6: ERRWB600022]].
Сделайте резервную копию настроек и выполните одну из команд:
 
*  Переход со стабильного на нестабильный:
Важно! В релизе wb-2304 сменилась версия Debian, поэтому при переходе со старых релизов wb-21**/wb-22** надо ввести дополнительную команду ([[wb-2304|подробнее]]):
*:<syntaxhighlight lang="bash">
:<syntaxhighlight lang="bash">
wb-release -t testing
wb-release --update-debian-release
</syntaxhighlight>
* Переход с нестабильного на стабильный:
*:<syntaxhighlight lang="bash">
wb-release -t stable
</syntaxhighlight>
* Чтобы заморозить релиз и отказаться от новых функций, укажите версию релиза, например:
*: <syntaxhighlight lang="bash">
wb-release -t wb-2104
</syntaxhighlight>
</syntaxhighlight>


{{Wbincludes:Wiren Board Apt Firmware Update}}
После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро.


=== Решение проблем при обновлении со Stretch на Bullseye ===
== Обновление стабильного релиза ==
{{Wbincludes:Bullseye Errata}}


== Обновление через веб-интерфейс==
===  В консоли через apt ===
{{Anchor|web-ui}}
{{Wbincludes:Wiren Board Apt firmware update}}
{{note|note|Этим способом можно обновить текущий релиз более новым, или перейти со stable на testing. Для перехода на старый релиз используйте процедуру удаления данных, описанную в конце этой страницы.}}


=== Скачивание прошивки ===
=== Через веб-интерфейс ===
{{Wbincludes:Fit Files Wiren Board 6}}
{{Wbincludes:WebUI Wiren Board Firmware Update}}


=== Процесс ===
=== С помощью USB-флешки ===
{{note|info|Если у вас на контроллере релиз wb-2307 и новее, а на самом контроллере корневой раздел 1 Гбайт, то его [[Enlarging_the_rootfs_partition|можно увеличить]].}}
{{Wbincludes:USB Wiren Board 6 Firmware Update}}
{{Wbincludes:Wiren Board WebUI Firmware Update}}
<gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли">
 
== Прошивка с помощью USB-флешки ==
Для обновления прошивки или удаления данных и настроек можно воспользоваться USB-флешкой или картой памяти Micro SD.
 
Способ удобен, если на компьютере нет интернета и вы используете только встроенное в контроллер ПО.
 
{{Wbincludes:Wiren Board 7 Firmware Update Fit Save Data}}
 
=== Подготовка файла прошивки ===
{{Wbincludes:Fit Files Wiren Board 6}}
 
'''Подготовьте флеш-накопитель''':
# [[Formatting Flash Drive | Отформатируйте флешку в FAT32]].
# Скачайте fit-файл прошивки на компьютер.
# Скопируйте скачанный ''.fit''-файл в корень флешки и убедитесь, что размер файла не равен нулю.
# Переименуйте файл на флешке в <code>wb6_update.fit</code> — для обновления, или в <code>wb6_update_FACTORYRESET.fit</code> — для удаления данных и сброса к заводским настройкам.
 
=== Процесс ===
[[Image: WB6.7 USB1 + FW.png |400px|thumb|right| Порт '''USB 1''' и кнопка '''FW''' на контроллере Wiren Board 6.7]]
В процессе контроллер будет несколько раз запрашивать в [[WB Debug Console | Debug-консоли]] подтверждение тех или иных действий, но чтобы не подключаться к ней, мы будем ориентироваться по светодиоду и звуковым сигналам. Действия подтверждаются нажатием на кнопку '''FW'''.
 
Чтобы обновить прошивку:
# Подключите к контроллеру внешнее питание.
# Выключите контроллер кнопкой.
# Подключите флешку с файлом прошивки к порту '''USB 1'''.
# Включите кнопкой контроллер.
# В течение первых 5 секунд зажмите кнопку FW, которая находится возле антенны Wi-Fi.
# Дождитесь, пока контроллер не пикнет один раз и отпустите кнопку.
# Следующий шаг зависит от того, с каким именем файл вы положили на флешку:
#* <code>wb6_update.fit</code>, контроллер два раза пикнет и начнёт прошивку.
#* <code>wb6_update_FACTORYRESET.fit</code>,
#*# Контроллер два раза пикнет и потом издаст продолжительный писк, а индикатор загорится красным.
#*# Зажмите кнопку FW и держите, пока контроллер не пикнет коротко четыре раза. После кнопку можно отпустить.
#* Если никакой файл не будет найден — контроллер загрузит текущую операционную систему.
# В процессе индикатор будет несколько раз менять свой цвет.
 
Процедура продлится 5–10 минут, в конце контроллер перезагрузится в рабочий режим, а индикатор на нём замигает зелёным — флешку можно извлечь.
 
<gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли при обновлении прошивки">
Image: 2 update.png | Момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления
Image: 2 update.png | Момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления
Image: 4 update.png | Обновление прошивки началось
Image: 4 update.png | Обновление прошивки началось
</gallery>
</gallery>


<gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли при удалении настроек">
== Обновление нестабильного релиза ==
=== В консоли через apt ===
{{Wbincludes:Wiren Board Apt firmware update}}
 
== Удаление данных и возврат заводских настроек ==
{{Wbincludes:USB Wiren Board 6 Firmware Update|ractory_reset=true}}
 
<gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли">
Image: 1 factory reset.png | Момент, когда нужно кратковременно нажать кнопку FW для удаления данных
Image: 1 factory reset.png | Момент, когда нужно кратковременно нажать кнопку FW для удаления данных
Image: 2 factory reset.png | Момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения удаления данных настройкам
Image: 2 factory reset.png | Момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения удаления данных настройкам
Строка 101: Строка 59:
</gallery>
</gallery>


=== Решение проблем ===
== Пользовательские настройки и файлы ==
Если возникнут проблемы с обновлением, подключитесь к [[WB_Debug_Console | Debug Console]] контроллера и повторите обновление. Если увидите ошибку <code>FAT: Misaligned buffer address</code> — возможно следует попробовать другой накопитель. Для контроллеров если происходит перезагрузка в процессе обновления  6.7-6.9 может потребоваться обновление загрузчика командой <code>u-boot-install-wb</code> Так же можно посмотреть в [[WB_6:_Errata]], так как в некоторых ревизиях контроллера была проблема с определением флешки.
{{Wbincludes:Firmware Update Save Data}}
 
Также обратите внимание, что .fit в имени файла прошивки — это расширение. Если файл не находится, то проверьте, что у вас он верно назван.
 
=== Массовая прошивка контроллеров ===
{{Wbincludes:Mass flashing from flash}}
 
== Удаление данных и возврат заводских настроек с обновлением ПО ==
{{SupportedSinceRelease
| release = wb-2401
|content=
 
<h3> О способе </h3>
{{note|warn|Процедура удаляет все данные и установленное ПО! Убедитесь, что у вас останется доступ к контроллеру.}}
Процедура удаляет на контроллере все данные: установленное ПО, настройки, пользовательские файлы и восстанавливает заводскую конфигурацию настроек — сделайте резервную копию ваших файлов и настроек.
 
<h3> Подготовка файла прошивки </h3>
{{note|info| Функция пока доступна только для fit-образов с testing-релизом.}}
[[Image: fit-link.png|250px|thumb|right| Cсылка для скачивания FIT-файлов в веб-интерфейсе контроллера 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];
 
Образы testing и старые версии ПО вы найдёте в [https://fw-releases.wirenboard.com/?prefix=fit_image/ нашем репозитории].
 
Начиная с релиза wb-2304 ссылка для скачивания FIT-файлов доступна в веб-интерфейсе в разделе '''Настройки''' → '''Система'''.
 
<h3> Процесс </h3>
[[Image: FactoryReset WebUI.png|thumb|right|Страница системных настроек в веб-интерфейсе контроллера]]
Чтобы удалить все данные, сбросить настройки и обновить версии ПО на контроллере:
# Скачайте fit-файл по инструкции выше.
# Откройте веб-интерфейс контроллера.
# Перейдите '''Настройки''' → '''Система'''.
# Загрузите fit-файл с прошивкой в разделе '''Удаление данных и сброс настроек (Factory reset)''' и дождитесь окончания процедуры.
# Перезагрузите контроллер.
}}

Версия 16:10, 16 марта 2022

Это черновик страницы. Последняя правка сделана 16.03.2022 пользователем A.Degtyarev.

Введение

Инструкции на этой странице работают только на контроллерах Wiren Board 6, инструкцию по обновлению других версий ищите на страницах контроллеров в разделе «Программное обеспечение».

Версия ПО в веб-интерфейсе контроллера
WebUIDevicesSystem

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

  • Stable — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок.
  • Testing — нестабильный релиз: свежие версии пакетов с новыми функциями, а так же исправленными и новыми ошибками.
Журналы изменений в релизах
Ветка Имя
stable wb-2404wb-2401wb-2310wb-2307wb-2304wb-2207wb-2204wb-2201wb-2110wb-2108 • wb-2104
testing скользящий релиз, изменения

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

Узнать версию релиза можно в веб-интерфейсе контроллера в разделе Devices в карточке устройства System или в консоли командой wb-release. Если в веб-интерфейсе нет упоминания о testing или stable или команда wb-release не найдена — у вас старая версия ПО и нужно сменить репозиторий.

Между релизами можно переключаться, так же можно заморозить ПО контроллера на определённом релизе — это может быть полезно на ответственных инсталляциях.

Сделайте резервную копию настроек и выполните одну из команд:

  • Переход со стабильного на нестабильный:
    wb-release -t testing
    
  • Переход с нестабильного на стабильный:
    wb-release -t stable
    
  • Чтобы заморозить релиз и отказаться от новых функций, укажите версию релиза, например:
    wb-release -t wb-2104
    

После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро.

Обновление стабильного релиза

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

Wbincludes:Wiren Board Apt firmware update

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

Wbincludes:WebUI Wiren Board Firmware Update

С помощью USB-флешки

Wbincludes:USB Wiren Board 6 Firmware Update

Обновление нестабильного релиза

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

Wbincludes:Wiren Board Apt firmware update

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

Wbincludes:USB Wiren Board 6 Firmware Update

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

Wbincludes:Firmware Update Save Data