Wiren Board Firmware Update: различия между версиями
(Перенаправление на Wiren Board Software) Метка: новое перенаправление |
|||
(не показана 131 промежуточная версия 8 участников) | |||
Строка 1: | Строка 1: | ||
# | {{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}} | ||
== Общая информация == | |||
Эта статья описывает обновление прошивки контроллера 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-карты с образом]] |
Версия 14:46, 3 сентября 2021
Общая информация
Эта статья описывает обновление прошивки контроллера Wiren Board 6 и контроллера Wiren Board 5 с версией прошивки 0.38-20180710 и выше, если у вас другой контроллер — читайте раздел Обновление прошивки контроллеров старых версий.
Прошивку контроллера Wiren Board можно обновить через менеджер пакетов apt или через fit-файл: с помощью флешки или через веб-интерфейс.
Также контроллер можно сбросить к заводским настройкам и удалить пользовательские данные.
Новый репозиторий Wiren Board
С апреля 2021 года программное обеспечение контроллера Wiren Board выпускается в формате периодических релизов, также изменился путь к основному репозиторию. Старый репозиторий больше не поддерживается, новых обновлений не будет.
На старых контроллерах (до мая 2021 года) для перехода на работу с релизами надо сделать пару шагов:
Если на контроллере есть интернет, то выполните команды:
apt update && apt dist-upgrade
- в систему будет установлен пакет
wb-configs
, а сама система обновится.
После обновления выполните эти команды ещё раз:
apt update && apt dist-upgrade
- ПО контроллера переключится на текущий релиз stable и обновится, или на релиз testing, если ранее вы включали репозиторий unstable.
Если на контроллере нет интернета, то можете обновить контроллер через .fit-файл прошивки.
Ветки релизов
Testing
Testing — нестабильная ветка: свежие версии пакетов с новыми функциями, исправленными и новыми ошибками.
В течение двух месяцев пакеты с новыми функциями публикуются сразу после предварительного автоматического тестирования, которое позволяет исключить публикацию сломанных пакетов.
На третий месяц testing-ветка «замораживается» и ей присваивается имя будущего stable. Во время заморозки новые функции не добавляются, а только исправляются найденные ошибки. В конце месяца релиз сливается со stable, а testing «размораживается» и продолжается публикация пакетов с новыми функциями.
Будем рады помощи сообщества в тестировании пакетов — переключайтесь на testing-ветку на неответственных инсталляциях.
Stable
Stable — стабильная ветка: обновление пакетов раз в три месяца и исправления критических ошибок.
Публикуемые в ней пакеты прошли тестирование пользователями testing-ветки, поэтому мы рекомендуем использовать stable в ответственных инсталляциях.
Если в релизе будут обнаружены критические ошибки — мы опубликуем исправления сразу после их выхода, не дожидаясь очередной даты релиза.
Релизы имеют номер вида wb-YYMM
, где YY
— год, а MM
— месяц выпуска. Например, wb-2104 — релиз, выпущенный в апреле 2021 года. Узнать о выходе очередного stable-релиза можете в Журнале изменений релизах.
Переключение между релизами
Для переключения используйте утилиту wb-release
с флагом -t
:
На testing:
wb-release -t testing
На stable:
wb-release -t stable
Для заморозки на определенном релизе укажите версию stable-релиза:
wb-release -t wb-2104
Но мы не рекомендуем это делать — вы останетесь без обновлений. Для разморозки переключитесь на одну из веток.
После смены релиза мы рекомендуем перезагрузить контроллер на случай, если обновилось ядро.
Если в процессе работы утилиты произошел сбой, то она постарается вернуть настройки apt.
Как узнать версию установленного ПО
Посмотреть текущую версию ПО можно:
- В веб-интерфейсе. В разделке Devices, устройство System.
- В консоли. При подключении к консоли контроллера выводится баннер, в котором указана используемая ветка и номер релиза.
- В консоли командой wb-release:
# wb-release
Wirenboard release wb-2104 (as stable), target wb6/stretch
You can get this info in scripts from /usr/lib/wb-release.
Проверка обновлений
Wbincludes:Wiren Board Check firmware update
Обновление через apt
Wbincludes:Wiren Board Apt firmware update
Обновление через fit-файл
Fit-файл — это образ прошивки контроллера Wiren Board, который можно скачать в нашем репозитории
Загрузить текущий stable-релиз можно по прямым ссылкам:
Пользовательские файлы и настройки
Wbincludes:WebUI Wiren Board Firmware Update Fit Save Data
Обновление через веб-интерфейс
Wbincludes:WebUI Wiren Board Firmware Update
Обновление с USB-накопителя и сброс к заводским настройкам
Некоторые ревизии контроллера не видят USB-накопитель (флешку) при определённых условиях, если вы столкнулись с такой ситуацией — смотрите инструкции в WB_6:_Errata.
Мы не рекомендуем для обновления прошивки использовать внешние жесткие диски — может не хватить мощности USB-порта.
Подготовьте флеш-накопитель:
- Отформатируйте флешку в FAT32.
- Скачайте fit-файл прошивки на компьютер.
- Скопируйте скачанный .fit-файл в корень флешки и убедитесь, что размер файла не равен нулю.
- Переименуйте файл на флешке:
- для обновления прошивки контроллера в
wb6_update.fit
, - для сброса контроллера к заводским настройкам и удаления всех данных в
wb6_update_FACTORYRESET.fit
.
- для обновления прошивки контроллера в
Чтобы обновить прошивку или сбросить контроллер к заводским настройкам:
- Выключите контроллер.
- Подключите флешку с файлом прошивки к порту USB 1 и включите контроллер.
- Если в корне флешки найден файл прошивки, то индикатор контроллера начнёт часто мигать оранжевым.
- В этот момент зажмите на одну секунду кнопку FW, которая находится на плате контроллера.
- Дальнейшие шаги зависят от того, какой файл лежит на флешке:
wb6_update.fit
— индикатор загорится зелёным, потом мигнёт красным и замигает зелёным — это началась процедура обновления прошивки.wb6_update_FACTORYRESET.fit
:- Индикатор загорится зелёным, потом два раза мигнёт красным и ещё два раза зелёным.
- Контроллер начнёт пищать, а индикатор замигает красным — контроллер ждёт подтверждения.
- Подтвердите очистку контроллера, для этого нажмите кнопку FW и держите, пока контроллер не пискнет четыре раза, а индикатор не загорится зелёным — это началась процедура сброса настроек.
- Кнопку можно отпустить. В процессе индикатор будет мигать зелёным.
- Процедура продлится 5–10 минут, в конце контроллер перезагрузится в рабочий режим, а индикатор на нём замигает зелёным — флешку можно извлечь.
Если обновление или сброс завершаются с ошибкой, подключитесь к Debug-консоли контроллера и повторите шаги. Если увидите ошибку FAT: Misaligned buffer address
— смените накопитель на другой.
Журнал изменений в релизах
Ветка | Имя |
---|---|
stable | wb-2108 • wb-2104 |
testing | rolling release |
Обновление прошивки контроллеров старых версий
- Wiren Board 5 с версией прошивки старше 0.38-20180710 обновить можно (первый раз) только через восстановление прошивки, смотрите инструкцию в статье Wiren Board 5: Восстановление прошивки.
- Wiren Board 4 и старше прошиваются через карту Micro-SD, читайте инструкцию в статье Создание microSD-карты с образом