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

Материал из Wiren Board
(Перенаправление на Wiren Board Software)
Метка: новое перенаправление
 
(не показана 131 промежуточная версия 8 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}}
#REDIRECT [[Wiren_Board_Software]]
== Общая информация ==
Эта статья описывает обновление прошивки контроллера Wiren Board 6 и контроллера Wiren Board 5 с версией прошивки 0.38-20180710 и выше, если у вас другой контроллер — читайте раздел [[#Обновление прошивки контроллеров старых версий | Обновление прошивки контроллеров старых версий]].
 
Прошивку контроллера Wiren Board можно обновить через менеджер пакетов '''apt''' или через '''fit-файл''': с помощью флешки или через веб-интерфейс.
 
Также контроллер можно сбросить к заводским настройкам и удалить пользовательские данные.
 
== Новый репозиторий Wiren Board ==
 
С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате [[Software Releases |периодических релизов]], также изменился путь к [http://deb.wirenboard.com/ основному репозиторию]. [http://releases.contactless.ru/ Старый репозиторий] больше не поддерживается, новых обновлений не будет.
 
На старых контроллерах (до мая 2021 года) для перехода на работу с релизами надо сделать пару шагов:
Если на контроллере есть интернет, то выполните команды:
:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
: в систему будет установлен пакет <code>wb-configs</code>, а сама система обновится.
После обновления выполните эти команды ещё раз:
:<syntaxhighlight lang="bash">
apt update && apt dist-upgrade
</syntaxhighlight>
: ПО контроллера переключится на текущий релиз '''stable''' и обновится, или на релиз '''testing''', если ранее вы включали репозиторий '''unstable'''.
 
Если на контроллере нет интернета, то можете обновить контроллер через [[#Обновление через fit-файл |.fit-файл прошивки]].
 
== Ветки релизов ==
=== Testing ===
Testing — нестабильная ветка: свежие версии пакетов с новыми функциями, исправленными и новыми ошибками.
 
В течение двух месяцев пакеты с новыми функциями публикуются сразу после предварительного автоматического тестирования, которое позволяет исключить публикацию сломанных пакетов.
 
На третий месяц '''testing'''-ветка «замораживается» и ей присваивается имя будущего stable. Во время заморозки новые функции не добавляются, а только исправляются найденные ошибки. В конце месяца релиз сливается со '''stable''', а '''testing ''' «размораживается» и продолжается публикация пакетов с новыми функциями.
 
Будем рады помощи сообщества в тестировании пакетов — переключайтесь на '''testing'''-ветку на неответственных инсталляциях.
 
=== Stable ===
Stable — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок.
 
Публикуемые в ней пакеты прошли тестирование пользователями '''testing'''-ветки, поэтому мы рекомендуем использовать '''stable''' в ответственных инсталляциях.
 
Если в релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода, не дожидаясь очередной даты релиза.
 
Релизы имеют номер вида <code>wb-YYMM</code>, где <code>YY</code> — год, а <code>MM</code> — месяц выпуска. Например, '''wb-2104''' — релиз, выпущенный в апреле 2021 года. Узнать о выходе очередного stable-релиза можете в [[#Журнал изменений в релизах | Журнале изменений релизах]].
 
== Переключение между релизами ==
Для переключения используйте утилиту <code>wb-release</code> с флагом <code>-t</code>:
 
На '''testing''':
<syntaxhighlight lang="bash">
wb-release -t testing
</syntaxhighlight>
 
На '''stable''':
<syntaxhighlight lang="bash">
wb-release -t stable
</syntaxhighlight>
 
Для заморозки на определенном релизе укажите версию stable-релиза:
<syntaxhighlight lang="bash">
wb-release -t wb-2104
</syntaxhighlight>
 
Но мы не рекомендуем это делать — вы останетесь без обновлений. Для разморозки переключитесь на одну из веток.
 
После смены релиза мы рекомендуем перезагрузить контроллер на случай, если обновилось ядро.
 
Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.
 
=== Как узнать версию установленного ПО ===
[[Image: System Information Testing.png|300px|thumb|right| Версия ПО в веб-интерфейсе для '''testing''']]
Посмотреть текущую версию ПО можно:
*В '''веб-интерфейсе'''. В разделке '''Devices''', устройство '''System'''.
*В '''консоли'''. При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза.
*В консоли командой '''wb-release''':
 
<syntaxhighlight lang="console">
# wb-release
Wirenboard release wb-2104 (as stable), target wb6/stretch
 
You can get this info in scripts from /usr/lib/wb-release.
</syntaxhighlight>
 
== Проверка обновлений ==
{{Wbincludes:Wiren Board Check firmware update}}
 
== Обновление через apt ==
{{Wbincludes:Wiren Board Apt firmware update}}
 
== Обновление через fit-файл ==
Fit-файл — это образ прошивки контроллера Wiren Board, который можно скачать в [http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ нашем репозитории]
 
Загрузить текущий stable-релиз можно по прямым ссылкам:
* [http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit Wiren Board 6.3­-6.6.0]
* [http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit Wiren Board 6.7.x-6.8.x]
 
=== Пользовательские файлы и настройки ===
{{Wbincludes:WebUI Wiren Board Firmware Update Fit Save Data}}
 
=== Обновление через веб-интерфейс ===
{{Wbincludes:WebUI Wiren Board Firmware Update}}
 
=== Обновление с USB-накопителя и сброс к заводским настройкам ===
[[Image: WB6.7 USB1 + FW.png |400px|thumb|right| Порт '''USB 1''' и кнопка '''FW''' на контроллере Wiren Board 6.7]]
 
Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в [[WB_6:_Errata]].
 
Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски — может не хватить мощности USB-порта.
 
'''Подготовьте флеш-накопитель''':
# [[Formatting Flash Drive | Отформатируйте флешку в FAT32]].
# Скачайте [[#Обновление через fit-файл  | fit-файл прошивки]] на компьютер.
# Скопируйте скачанный ''.fit''-файл в корень флешки и убедитесь, что размер файла не равен нулю.
# Переименуйте файл на флешке:
#* '''для обновления прошивки''' контроллера в <code>wb6_update.fit</code>,
#* '''для сброса контроллера к заводским настройкам''' и удаления всех данных в <code>wb6_update_FACTORYRESET.fit</code>.
 
'''Чтобы обновить прошивку или сбросить контроллер к заводским настройкам''':
# Выключите контроллер.
# Подключите флешку с файлом прошивки к порту '''USB 1''' и включите контроллер.
# Если в корне флешки найден файл прошивки, то индикатор контроллера начнёт часто мигать оранжевым.
# В этот момент зажмите на одну секунду кнопку '''FW''', которая находится на плате контроллера.
# Дальнейшие шаги зависят от того, какой файл лежит на флешке:
#* <code>wb6_update.fit</code> — индикатор загорится зелёным, потом мигнёт красным и замигает зелёным — это началась процедура обновления прошивки.
#* <code>wb6_update_FACTORYRESET.fit</code>:
#*# Индикатор загорится зелёным, потом два раза мигнёт красным и ещё два раза зелёным.
#*# Контроллер начнёт пищать, а индикатор замигает красным — контроллер ждёт подтверждения.
#*# Подтвердите очистку контроллера, для этого нажмите кнопку '''FW''' и держите, пока контроллер не пискнет четыре раза, а индикатор не загорится зелёным — это началась процедура сброса настроек.
#*# Кнопку можно отпустить. В процессе индикатор будет мигать зелёным.
# Процедура продлится 5–10 минут, в конце контроллер перезагрузится в рабочий режим, а индикатор на нём замигает зелёным — флешку можно извлечь.
 
Если обновление или сброс завершаются с ошибкой, подключитесь к [[WB_Debug_Console | Debug-консоли]] контроллера и повторите шаги. Если увидите ошибку <code>FAT: Misaligned buffer address</code> — смените накопитель на другой.
 
<gallery mode="traditional " widths ="290px" heights="250px">
Image: 2 update.png | Обновление: момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления
Image: 4 update.png | Обновление: обновление прошивки началось
Image: 1 factory reset.png | Сброс: момент, когда нужно кратковременно нажать кнопку FW для сброса к заводским настройкам
Image: 2 factory reset.png | Сброс: момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения сброса к заводским настройкам
Image: 3 factory reset.png | Сброс: начался сброс к заводским настройкам
</gallery>
 
== Журнал изменений в релизах ==
{|  border="1" class="wikitable"
|+ Релизы ПО
! Ветка || Имя
|-
| stable || [https://wirenboard.com/statics/release-changelogs/wb-2108/changelog.html wb-2108] • wb-2104
|-
| testing || rolling release
|-
|}
 
== Обновление прошивки контроллеров старых версий ==
* Wiren Board 5 с версией прошивки старше 0.38-20180710 обновить можно (первый раз) только через восстановление прошивки, смотрите инструкцию в статье [[Wiren Board 5: Восстановление прошивки]].
* Wiren Board 4 и старше прошиваются через карту Micro-SD, читайте инструкцию в статье [[Создание microSD-карты с образом]]

Текущая версия на 17:28, 20 декабря 2023

Перенаправление на: