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

Материал из Wiren Board
Метка: ручная отмена
Строка 1: Строка 1:
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board 6}}
{{DISPLAYTITLE: Обновление прошивки контроллера Wiren Board}}
== Общая информация ==
== Общая информация ==
Инструкции в этой статье работают на контроллерах '''Wiren Board 6''', если у вас другая ревизия контроллера, смотрите:
=== Кратко о релизах ===
* [[Wiren Board 7 Firmware Update | Обновление прошивки Wiren Board 7]].
[[Image: System Information.png |300px|thumb|right| Версия ПО в веб-интерфейсе контроллера<br>''WebUI'' → ''Devices'' ''System'']]
* [[#Обновление прошивки контроллеров старых ревизий| Обновление прошивки контроллеров старых ревизий]].
Программное обеспечение контроллеров Wiren Board состоит из множества пакетов, которые мы объединяем в релизы:
* '''Stable''' — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок.
* '''Testing''' — тестовый релиз: свежие версии пакетов с новыми функциями, а так же исправленными и новыми ошибками.  


ПО контроллера выпускается в формате [[#Релизы | релизов]]. Если у вас контроллер Wiren Board ревизий 6.3 – 6.7.2, то перед обновлением может потребоваться перейти на [[#Новый репозиторий ПО Wiren Board | новый репозиторий]].
Стабильные релизы имеют номер вида ''wb-YYMM'', где ''YY'' — год, а ''MM'' — месяц выпуска. Например, ''wb-2104'' — релиз, выпущенный в апреле 2021 года.


Прошивку контроллера Wiren Board можно обновить [[#Обновление с помощью apt через консоль | с помощью apt через консоль]], [[#Обновление через веб-интерфейс | через веб-интерфейс]] или [[#Обновление с USB-накопителя и сброс к заводским настройкам | с USB-флешки]].
{{Wbincludes:Release Log}}
Также контроллер можно [[#Обновление с USB-накопителя и сброс к заводским настройкам | сбросить к заводским настройкам]] и удалить пользовательские данные.
 
=== Какой релиз на вашем контроллере ===
С завода на контроллерах Wiren Board установлен актуальный на момент производства стабильный релиз.
 
Узнать версию релиза можно в веб-интерфейсе контроллера в разделе ''Devices'' в карточке устройства ''System'' или в консоли командой <code>wb-release</code>. Если в веб-интерфейсе нет упоминания о testing или stable или команда ''wb-release'' не найдена — у вас старая версия ПО и нужно сменить репозиторий.
 
=== Переключение между релизами ===
Между релизами можно переключаться, так же можно заморозить ПО контроллера на определённом релизе — это может быть полезно на ответственных инсталляциях.
 
Сделайте резервную копию настроек и выполните одну из команд:
*  Переход со стабильного на тестовый:
*:<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>


Для обновления через веб-интерфейс или с USB-флешки вам понадобится fit-файл прошивки, который можно скачать в нашем [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.9.x].


== Журнал изменений в релизах ==
== Пользовательские настройки и файлы ==
{{Wbincludes:Release Log}}
{{Wbincludes:Firmware Update Save Data}}


== Проверка обновлений ==
== Проверка обновлений ==
Строка 21: Строка 42:


== Обновление ==
== Обновление ==
===  В консоли через apt ===
[[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
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''', так вы сохраните свои настройки.


=== В консоли через apt ===
Так же в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>.
{{Wbincludes:Wiren Board Apt firmware update}}


=== Через веб-интерфейс ===
=== Через веб-интерфейс ===
{{Wbincludes:WebUI Wiren Board Firmware Update}}
{{Wbincludes:Fit Files}}


=== С помощью USB-флешки ===
{{Wbincludes:WebUI Change Access Level}}
{{Wbincludes:USB Wiren Board 6 Firmware Update}}
<gallery mode="packed" widths ="200px" heights="250px" caption="Сообщения в Debug-консоли при обновлении">
Image: 2 update.png | Момент, когда нужно нажать кнопку FW на 1 секунду для начала обновления
Image: 4 update.png | Обновление прошивки началось
</gallery>


== Удаление данных и возврат заводских настроек ==
{{Wbincludes:Firmware Update Fit Save Data}}
{{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 для удаления данных
# Скачайте fit-файл прошивки на компьютер.
Image: 2 factory reset.png | Момент, когда нужно на 4 секунды нажать кнопку FW для подтверждения удаления данных настройкам
# Зайдите в [[Wiren Board Web Interface | веб-интерфейс]] контроллера и перейдите в раздел '''Settings''' → '''System'''. В старых версиях WebUI кнопка ''Select file'' находится в разделе '''Settings'''.
Image: 3 factory reset.png | Начался сброс к заводским настройкам
# Нажмите кнопку '''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>
</gallery>


== Пользовательские настройки и файлы ==
== Удаление данных и другие способы обновления==
{{Wbincludes:Firmware Update Save Data}}
Обновление через 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]].


{{Wbincludes:WebUI Wiren Board Releases}}
== Инструкция для контроллеров Wiren Board 4 и старее ==


== Обновление прошивки контроллеров старых ревизий ==
Контроллеры Wiren Board 4 и старее прошиваются через карту Micro-SD, читайте инструкцию в статье [[Создание microSD-карты с образом]].
* [[Wiren Board 5 Firmware Update | Обновление контроллеров Wiren Board 5]]
* Wiren Board 4 и старше прошиваются через карту Micro-SD, читайте инструкцию в статье [[Создание microSD-карты с образом]]

Версия 19:33, 18 марта 2022

Общая информация

Кратко о релизах

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

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

  • Stable — стабильный релиз: обновление пакетов раз в три месяца и исправления критических ошибок.
  • Testing — тестовый релиз: свежие версии пакетов с новыми функциями, а так же исправленными и новыми ошибками.

Стабильные релизы имеют номер вида wb-YYMM, где YY — год, а MM — месяц выпуска. Например, wb-2104 — релиз, выпущенный в апреле 2021 года.

Журналы изменений в релизах
Ветка Имя
stable wb-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
    

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

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

Wbincludes:Firmware Update Save Data

Проверка обновлений

Wbincludes:Wiren Board Check firmware update

Обновление

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

Окно Modified configuration Files

Apt — это менеджер пакетов операционной системы Debian, который обновляет изменившиеся пакеты и устанавливает новые, если это необходимо.

Для работы нужен интернет или локальное зеркало apt-репозитория Wiren Board.

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

Чтобы обновить прошивку контроллера:

  1. Подключитесь к нему по SSH.
  2. Выполните команды:
    apt update && apt upgrade
    

В процессе обновления может появиться запрос на действие с файлами конфигурации. Если не знаете, что выбрать — оставьте значение по умолчанию keep the local version currently installed, так вы сохраните свои настройки.

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

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

Cсылка для скачивания FIT-файлов в веб-интерфейсе контроллера Wiren Board

Вам понадобится fit-файл прошивки для вашей версии контроллера. C помощью fit-файла можно обновить как stable, так и testing релизы. При этом учтите, что для обновления на stable контроллер должен быть переключен stable-релиз. Самые свежие stable-релизы находятся по ссылкам:

Образы testing и старые версии ПО вы найдёте в нашем репозитории.

Начиная с релиза wb-2304 ссылка для скачивания FIT-файлов доступна в веб-интерфейсе в разделе НастройкиСистема.

Уровень «Администратор»

Для изменения настроек контроллера вам нужен уровень доступа Администратор, который можно выставить в разделе НастройкиПрава доступа.

После завершения настроек рекомендуем поставить уровень доступа Пользователь или Оператор — это поможет не совершить случайных ошибок при ежедневной работе с веб-интерфейсом.

При обновлении сохраняются пользовательские файлы и настройки только в /mnt/data, но стороннее ПО будет удалено. Рекомендуем сделать резервную копию.

Чтобы обновить прошивку контроллера:

  1. Скачайте fit-файл прошивки на компьютер.
  2. Зайдите в веб-интерфейс контроллера и перейдите в раздел SettingsSystem. В старых версиях WebUI кнопка Select file находится в разделе Settings.
  3. Нажмите кнопку Select File и выберите скачанный ранее fit-файл.
  4. Файл с прошивкой загрузится на контроллер и начнётся обновление, которое длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения.
  5. После обновления контроллер перезагрузится и на странице появится надпись Firmware update complete — обновление завершено.
  6. Закройте страницу.

Удаление данных и другие способы обновления

Обновление через apt или веб-интерфейс полностью покрывают задачи по обслуживанию контроллера.

Однако, если они не подходят или вам нужно удалить данные с возвратом к заводским настройкам — это тоже можно, читайте в инструкции для каждой версии контроллера по ссылкам Wiren Board 5.x, Wiren Board 6.x и Wiren Board 7.x.

Инструкция для контроллеров Wiren Board 4 и старее

Контроллеры Wiren Board 4 и старее прошиваются через карту Micro-SD, читайте инструкцию в статье Создание microSD-карты с образом.