Wiren Board Firmware Update: различия между версиями
(Перенаправление на Wiren Board Software) Метка: новое перенаправление |
|||
(не показано 66 промежуточных версий 8 участников) | |||
Строка 1: | Строка 1: | ||
# | {{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}} | ||
== Общая информация == | |||
=== Совместимость === | |||
Инструкции на этой странице подходят для контроллеров Wiren Board 5.x, 6.x, 7.x. | |||
Исключения: | |||
* Контроллеры Wiren Board 5.x с версией прошивки 0.46-20190613 — их можно обновить только через [[Wiren_Board_5:_Восстановление_прошивки |восстановление прошивки]]. | |||
* Контроллеры Wiren Board 7.2.1A, выпущенные в декабре 2021 г — перед обновлением или возвратом заводских настроек, [[Wiren_Board_v7.2.1A_Create_Restore_Folder | переключите их на релиз]], а потом используйте инструкции на этой странице. | |||
Контроллеры Wiren Board 4 и старее [[Создание microSD-карты с образом | прошиваются через карту Micro-SD]]. | |||
=== Кратко о релизах === | |||
[[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера<br>''WebUI'' → ''Devices'' → ''System'']] | |||
Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы: | |||
* '''Stable''' — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок. | |||
* '''Testing''' — тестовый релиз: свежие версии пакетов с новыми функциями, а так же исправленными и новыми ошибками. | |||
Стабильные релизы имеют номер вида ''wb-YYMM'', где ''YY'' — год, а ''MM'' — месяц выпуска. Например, ''wb-2104'' — релиз, выпущенный в апреле 2021 года. | |||
{{Wbincludes:Release Log}} | |||
=== Какой релиз на вашем контроллере === | |||
С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз. | |||
Узнать версию релиза можно в веб-интерфейсе контроллера в разделе ''Devices'' в карточке устройства ''System'' или в консоли командой <code>wb-release</code>. Если в веб-интерфейсе нет упоминания о testing или stable или команда ''wb-release'' не найдена — у вас старая версия ПО и нужно [[New repository April 2021 | сменить репозиторий]]. | |||
=== Переключение между релизами === | |||
Между релизами можно переключаться, так же можно заморозить ПО контроллера на определённом релизе — это может быть полезно на ответственных инсталляциях. | |||
Сделайте резервную копию настроек и выполните одну из команд: | |||
* Переход со стабильного на тестовый: | |||
*:<syntaxhighlight lang="bash"> | |||
wb-release -t testing | |||
</syntaxhighlight> | |||
* Переход с тестового на стабильный: | |||
*:<syntaxhighlight lang="bash"> | |||
wb-release -t stable | |||
</syntaxhighlight> | |||
* Чтобы заморозить релиз и отказаться от новых функций, укажите версию релиза, например: | |||
*: <syntaxhighlight lang="bash"> | |||
wb-release -t wb-2104 | |||
</syntaxhighlight> | |||
После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро. | |||
== Пользовательские настройки и файлы == | |||
{{Wbincludes:Firmware Update Save Data}} | |||
== Проверка обновлений == | |||
В контроллере нет механизма, который сообщит пользователю о доступном обновлении, поэтому о выходе новых версий вы можете узнать из новостей в [https://wirenboard.com/ru/pages/contacts/ наших социальных сетях] или в консоли контроллера: | |||
# Подключитесь к контроллеру через [[SSH]]. | |||
# Выполните команду: | |||
#:<syntaxhighlight lang="bash" > | |||
apt update | |||
</syntaxhighlight> | |||
# Если есть пакеты для обновления, то можете посмотреть их список: | |||
#:<syntaxhighlight lang="bash"> | |||
apt list --upgradable | |||
</syntaxhighlight> | |||
== Обновление == | |||
=== В консоли через apt === | |||
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']] | |||
{{note|note|Рекомендуем обновлять прошивку контроллера через apt: будут сохранены настройки, ваши файлы и установленное ПО.}} | |||
Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо. | |||
Для работы нужен интернет или [https://wiki.debian.org/ru/CreateLocalRepo локальное зеркало] apt-репозитория Wiren Board. | |||
При обновлении сохраняются установленные программы, пользовательские файлы и настройки. | |||
Чтобы обновить прошивку контроллера: | |||
# Подключитесь к нему по [[SSH]]. | |||
# Выполните команды: | |||
#:<syntaxhighlight lang="bash"> | |||
apt update && apt upgrade | |||
</syntaxhighlight> | |||
В процессе обновления может появиться запрос на действие с файлами конфигурации. Если не знаете, что выбрать — оставьте значение по умолчанию '''keep the local version currently installed''', так вы сохраните свои настройки. | |||
Так же в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>. | |||
=== Через веб-интерфейс === | |||
{{Wbincludes:Fit Files}} | |||
{{Wbincludes:WebUI Change Access Level}} | |||
{{Wbincludes:Firmware Update Fit Save Data}} | |||
Чтобы обновить прошивку контроллера: | |||
# Скачайте fit-файл прошивки на компьютер. | |||
# Зайдите в [[Wiren Board Web Interface | веб-интерфейс]] контроллера и перейдите в раздел '''Settings''' → '''System'''. В старых версиях WebUI кнопка ''Select file'' находится в разделе '''Settings'''. | |||
# Нажмите кнопку '''Select File''' и выберите скачанный ранее fit-файл. | |||
# Файл с прошивкой загрузится на контроллер и начнётся обновление, которое длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения. | |||
# После обновления контроллер перезагрузится и на странице появится надпись '''Firmware update complete''' — обновление завершено. | |||
# Закройте страницу. | |||
<gallery mode="packed " heights="150px"> | |||
Image: web-settings.png | Нажмите кнопку '''Select file''' и выберите fit-файл | |||
Image: Web-settings-firmware-update-messages.png | Во время обновления на страницу выводятся системные сообщения | |||
Image: Web-settings-firmware-update-completed.png | Оповещение об успешном обновлении | |||
</gallery> | |||
== Удаление данных и другие способы обновления== | |||
Обновление через apt или веб-интерфейс полностью покрывают задачи по обслуживанию контроллера. | |||
Однако, если они не подходят или вам нужно удалить данные с возвратом к заводским настройкам — это тоже можно, читайте в инструкции для каждой версии контроллера по ссылкам [[Wiren_Board_5_Firmware_Update | Wiren Board 5.x]], [[Wiren_Board_6_Firmware_Update | Wiren Board 6.x]] и [[Wiren_Board_7_Firmware_Update | Wiren Board 7.x]]. |
Версия 13:55, 25 марта 2022
Общая информация
Совместимость
Инструкции на этой странице подходят для контроллеров Wiren Board 5.x, 6.x, 7.x.
Исключения:
- Контроллеры Wiren Board 5.x с версией прошивки 0.46-20190613 — их можно обновить только через восстановление прошивки.
- Контроллеры Wiren Board 7.2.1A, выпущенные в декабре 2021 г — перед обновлением или возвратом заводских настроек, переключите их на релиз, а потом используйте инструкции на этой странице.
Контроллеры Wiren Board 4 и старее прошиваются через карту Micro-SD.
Кратко о релизах
Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы:
- Stable — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок.
- Testing — тестовый релиз: свежие версии пакетов с новыми функциями, а так же исправленными и новыми ошибками.
Стабильные релизы имеют номер вида wb-YYMM, где YY — год, а MM — месяц выпуска. Например, wb-2104 — релиз, выпущенный в апреле 2021 года.
Ветка | Имя |
---|---|
stable | wb-2407 • wb-2404 • wb-2401 • wb-2310 • wb-2307 • wb-2304 • wb-2207 • wb-2204 • wb-2201 • wb-2110 • wb-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
После смены релиза рекомендуем перезагрузить контроллер на случай, если обновилось ядро.
Пользовательские настройки и файлы
Wbincludes:Firmware Update Save Data
Проверка обновлений
В контроллере нет механизма, который сообщит пользователю о доступном обновлении, поэтому о выходе новых версий вы можете узнать из новостей в наших социальных сетях или в консоли контроллера:
- Подключитесь к контроллеру через SSH.
- Выполните команду:
apt update
- Если есть пакеты для обновления, то можете посмотреть их список:
apt list --upgradable
Обновление
В консоли через apt
Рекомендуем обновлять прошивку контроллера через apt: будут сохранены настройки, ваши файлы и установленное ПО. Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо.
Для работы нужен интернет или локальное зеркало apt-репозитория Wiren Board.
При обновлении сохраняются установленные программы, пользовательские файлы и настройки.
Чтобы обновить прошивку контроллера:
- Подключитесь к нему по SSH.
- Выполните команды:
apt update && apt upgrade
В процессе обновления может появиться запрос на действие с файлами конфигурации. Если не знаете, что выбрать — оставьте значение по умолчанию keep the local version currently installed, так вы сохраните свои настройки.
Так же в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести Y
.
Через веб-интерфейс
Вам понадобится fit-файл прошивки для вашей версии контроллера. C помощью fit-файла можно обновить как stable, так и testing релизы. При этом учтите, что для обновления на stable контроллер должен быть переключен stable-релиз. Самые свежие stable-релизы находятся по ссылкам:
Образы testing и старые версии ПО вы найдёте в нашем репозитории.
Начиная с релиза wb-2304 ссылка для скачивания FIT-файлов доступна в веб-интерфейсе в разделе Настройки → Система.
Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе Настройки → Права доступа.
После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.
При обновлении сохраняются пользовательские файлы и настройки только в /mnt/data
, но стороннее ПО будет удалено. Рекомендуем сделать резервную копию.
Чтобы обновить прошивку контроллера:
- Скачайте fit-файл прошивки на компьютер.
- Зайдите в веб-интерфейс контроллера и перейдите в раздел Settings → System. В старых версиях WebUI кнопка Select file находится в разделе Settings.
- Нажмите кнопку Select File и выберите скачанный ранее fit-файл.
- Файл с прошивкой загрузится на контроллер и начнётся обновление, которое длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения.
- После обновления контроллер перезагрузится и на странице появится надпись Firmware update complete — обновление завершено.
- Закройте страницу.
Удаление данных и другие способы обновления
Обновление через apt или веб-интерфейс полностью покрывают задачи по обслуживанию контроллера.
Однако, если они не подходят или вам нужно удалить данные с возвратом к заводским настройкам — это тоже можно, читайте в инструкции для каждой версии контроллера по ссылкам Wiren Board 5.x, Wiren Board 6.x и Wiren Board 7.x.