|
Метка: новое перенаправление |
(не показано 148 промежуточных версий 9 участников) |
Строка 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 года.
| |
| | |
| == Переключение между релизами ==
| |
| Для переключения используйте утилиту <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>
| |
| | |
| == Проверка обновлений ==
| |
| В контроллере нет механизма, который сообщит пользователю о доступном обновлении, поэтому о выходе новых версий вы можете узнать:
| |
| * из новостей в [https://wirenboard.com/ru/pages/contacts/ наших социальных сетях],
| |
| * [[#Журнал изменений в stable-релизе | Журнала изменений в stable-релизе]]
| |
| * или в консоли контроллера.
| |
| | |
| Чтобы узнать о наличии обновлений из консоли контроллера, выполните команду <code>apt update</code>:
| |
| # Подключитесь к контроллеру через [[SSH]].
| |
| # Выполните команду <code>apt update</code>:
| |
| #:<syntaxhighlight lang="console" highlight="14">
| |
| # apt update
| |
| Ign:1 http://deb.debian.org/debian stretch InRelease
| |
| Get:2 http://security.debian.org stretch/updates InRelease [53.0 kB]
| |
| Hit:3 http://deb.debian.org/debian stretch-updates InRelease
| |
| Hit:4 http://deb.debian.org/debian stretch Release
| |
| Get:5 http://deb.wirenboard.com/wb6/stretch testing InRelease [3960 B]
| |
| Get:6 http://cdn-fastly.deb.debian.org/debian stretch-backports InRelease [91.8 kB]
| |
| Get:7 http://security.debian.org stretch/updates/main armhf Packages [687 kB]
| |
| Get:9 http://deb.wirenboard.com/wb6/stretch testing/main armhf Packages [59.5 kB]
| |
| Fetched 895 kB in 10s (82.9 kB/s)
| |
| Reading package lists... Done
| |
| Building dependency tree
| |
| Reading state information... Done
| |
| 2 packages can be upgraded. Run 'apt list --upgradable' to see them.
| |
| </syntaxhighlight>
| |
| #: в конце вывода будет показано, какие пакеты нуждаются в обновлении.
| |
| # Если есть пакеты для обновления, то можете посмотреть их список с помощью команды <code>apt list --upgradable</code>:
| |
| #:<syntaxhighlight lang="console" highlight="3-4">
| |
| # apt list --upgradable
| |
| Listing... Done
| |
| wb-hwconf-manager/testing 1.40.1 all [upgradable from: 1.40.0]
| |
| wb-release-info/testing 1.0-testing~wb6+stretch~20210831210334 all [upgradable from: 1.0-testing~wb6+stretch~20210830090128]
| |
| </syntaxhighlight>
| |
| #: в примере доступны обновления пакетов <code>wb-hwconf-manager</code> и <code>wb-release-info</code>.
| |
| | |
| == Обновление через apt ==
| |
| Apt — это менеджер пакетов операционной системы Debian, который обновляет только изменившиеся пакеты.
| |
| | |
| === Пользовательские файлы и настройки ===
| |
| [[Image: Dialog.png |400px|thumb|right| Окно ''Modified configuration Files'']]
| |
| Apt сохраняет пользовательские файлы и установленные программы, но может запросить перезапись файлов конфигурации с помощью окна '''Modified configuration Files''', в котором нужно выбрать один из пунктов:
| |
| * install the packade maintainer`s version — заменить версией из обновляемого пакета и потерять ваши настройки.
| |
| * keep the local version currently installed — не заменять файл и сохранить ваши настройки.
| |
| * show the differences between the versions — посмотреть различия между версиями.
| |
| * show a side-by-side difference between the versions — посмотреть различия между версиями и оба варианта файла настроек.
| |
| * start a new shell to examine the situation — открыть командную строку, чтобы разобраться в ситуации.
| |
| | |
| === Обновление ===
| |
| Чтобы обновить прошивку контроллера:
| |
| # Подключитесь к нему по [[SSH]].
| |
| # Выполните команды:
| |
| #:<syntaxhighlight lang="bash">
| |
| apt update && apt upgrade
| |
| </syntaxhighlight>
| |
| | |
| В процессе обновления в консоль будут выводиться служебные сообщения и запросы на действия, которые могут повредить систему или удалить пользовательские настройки — внимательно читайте вопросы перед тем, как ввести <code>Y</code>.
| |
| | |
| == Обновление через fit-файл ==
| |
| Fit-файл — это образ прошивки контроллера Wiren Board, который можно скачать в [http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ нашем репозитории]
| |
| | |
| Загрузить текущий stable-релиз можно по прямым ссылкам:
| |
| * [http://fw-releases.wirenboard.com/fit_image/stable/58/latest_stretch.fit Wiren Board 5.8.x-5.9] (только для обновления прошивок версий 0.38-20180710 и выше).
| |
| * [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]
| |
| | |
| === Пользовательские файлы и настройки ===
| |
| [[Image: Etc-wbconfigs.png |400px|thumb|right| Файлы настроек, которые сохраняются при обновлении через fit-файл]]
| |
| При обновлении сохраняется раздел <code>/mnt/data</code>, в котором по адресу <code>/mnt/data/etc</code> находятся настройки:
| |
| * системные: сеть, часовой пояс, пароль к веб-интерфейсу;
| |
| * устройств, подключенных по RS-485 <code>wb-mqtt-serial.conf</code>;
| |
| * модулей ввода-вывода и расширения <code>wb-hardware.conf</code>;
| |
| * универсальных входов/выходов A1-A4 <code>wb-homa-adc.conf</code>;
| |
| * выводов GPIO контроллера <code>wb-homa-gpio.conf</code>;
| |
| * Modbus TCP/Slave шлюза <code>wb-mqtt-mbgate.conf</code>.
| |
| | |
| Также будут сохранены пользовательские скрипты в папке <code>/etc/wb-rules/</code> и модули в папке <code>/etc/wb-rules-modules</code>.
| |
| | |
| Если вы устанавливали на контроллер сторонние программы, или хранили файлы вне папки <code>/mnt/data</code> — они будут удалены. Подключите контроллер к компьютеру для [[Просмотр_файлов_контроллера_с_компьютера|просмотра файлов]] и скопируйте свои файлы на компьютер. Если вы хотите сохранить установленные программы, то используйте [[#Обновление через apt | обновление через apt]].
| |
| | |
| === Обновление через веб-интерфейс ===
| |
| {{Wbincludes:WebUI Change Access Level}}
| |
| | |
| Чтобы обновить прошивку контроллера:
| |
| # Скачайте [[#Обновление через fit-файл | fit-файл прошивки]] на компьютер.
| |
| # Зайдите в [[Wiren Board Web Interface | веб-интерфейс]] контроллера и перейдите в раздел '''Settings''' → '''System'''.
| |
| # Нажмите кнопку '''Select File''' и выберите скачанный ранее fit-файл.
| |
| # Файл с прошивкой загрузится на контроллер и начнётся процесс обновления, который длится 5-10 минут. Не закрывайте страницу и не выключайте контроллер до завершения обновления.
| |
| # После обновления контроллер перезагрузится и на странице появится надпись '''Firmware update complete''' — обновление завершено.
| |
| # Закройте страницу.
| |
| | |
| <gallery mode="traditional " widths ="350px" heights="210px">
| |
| Image: web-settings.png | Нажмите кнопку '''Select file''' и выберите fit-файл
| |
| Image: Web-settings-firmware-update-messages.png | Во время обновления на страницу выводятся системные сообщения
| |
| Image: Web-settings-firmware-update-completed.png | Оповещение об успешном обновлении
| |
| </gallery>
| |
| | |
| === Обновление с 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>.
| |
| | |
| Если у вас контроллер Wiren Board 5, то замените в этой и других инструкциях имена файлов на <code>wb5_update.fit</code> и <code>wb5_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>
| |
| | |
| == Обновление прошивки контроллеров старых версий ==
| |
| * Wiren Board 5 с версией прошивки старше 0.38-20180710 обновить можно только через восстановление прошивки, смотрите инструкцию в статье [[Wiren Board 5: Восстановление прошивки]].
| |
| * Wiren Board 4 и старше прошиваются через карту Micro-SD, читайте инструкцию в статье [[Создание microSD-карты с образом]]
| |
| | |
| == Журнал изменений в stable-релизе ==
| |
| {| border="1" class="wikitable"
| |
| |+ Релизы ПО
| |
| ! Ветка || Имя
| |
| |-
| |
| | stable || [https://wirenboard.com/statics/release-changelogs/wb-2108/changelog.html wb-2108] • wb-2104
| |
| |-
| |
| | testing || rolling release
| |
| |-
| |
| |}
| |