Wiren Board Firmware Update: различия между версиями
(Перенаправление на Wiren Board Software) Метка: новое перенаправление |
|||
(не показано 245 промежуточных версий 10 участников) | |||
Строка 1: | Строка 1: | ||
# | == Частичное обновление прошивки через APT == | ||
Обновление прошивки производится по частям с помощью системного менеджера пакетов операционной системы Debian. | |||
Вы обновляете только нужные пакеты, поэтому обновление происходит быстро, а настройки других пакетов и пользовательские файлы не затрагиваются. | |||
Недостаток способа — неосторожное использование инструмента может привести к неполной установке или к удалению компонентов ПО контроллера Wiren Board. | |||
=== Обновление списка пакетов === | |||
Перед началом работы нужно получить актуальный список пакетов из репозиториев Debian и Wiren Board. | |||
Обновить все списки пакетов: | |||
<syntaxhighlight lang="bash"> | |||
apt-get update | |||
</syntaxhighlight> | |||
Обновить только пакеты из репозитория Wiren Board: | |||
<syntaxhighlight lang="bash"> | |||
apt-get update -o Dir::Etc::sourcelist="sources.list.d/contactless.list" -o Dir::Etc::sourceparts="-" -o APT::Get::List-Cleanup="0" | |||
</syntaxhighlight> | |||
=== Обновление системы === | |||
Полное обновление: | |||
<syntaxhighlight lang="bash"> | |||
apt-get upgrade -y | |||
</syntaxhighlight> | |||
Установить один пакет с указанной версией: | |||
<syntaxhighlight lang="bash"> | |||
apt-get install [имя_пакета]=[версия_пакета] | |||
</syntaxhighlight> | |||
''Пример:'' | |||
<syntaxhighlight lang="bash"> | |||
apt-get install wb-mqtt-serial=1.63.0 | |||
</syntaxhighlight> | |||
== Обновление прошивки целиком == | |||
=== Обновление прошивки через веб-интерфейс === | |||
'''ВНИМАНИЕ''': для Wiren Board 5 этот способ НЕ рекомендуется при обновлении на версии с «stretch» в названии с версий без «stretch» в названии файла. Это касается, в частности, заводских прошивок WB5 старше середины 2018 года выпуска. | |||
#Обновление прошивки происходит путём перезаписи раздела накопителя контроллера с операционной системой и всеми установленными программами. При этом не затрагиваются файлы, находящиеся в папках (они находятся в другом разделе). Подробнее ознакомиться с файлами, удаляющимися при обновлении системы, можно в разделе [[Потеря файлов при обновлении ПО]] | |||
#:В этих папках хранятся все изменения, которые можно сделать через веб-интерфейс, включая настройки со страницы '''Configs''', все подключённые устройства и виджеты — все эти данные сохранятся. | |||
#:Если вы хранили данные на контроллере самостоятельно в других папках, или устанавливали собственное ПО, оно '''будет потеряно'''. Вы можете загрузить нужные файлы себе на компьютер перед обновлением по инструкции [[Просмотр файлов контроллера с компьютера|Просмотр файлов контроллера с компьютера]]. | |||
#Свежие версии прошивок (как для контроллеров Wiren Board, так и для периферийных устройств) хранятся на [https://fw-releases.wirenboard.com fw-releases]. Файлы прошивок для WB хранятся в разделе '''fit-image''' и имеют расширение ''.fit''. Выберите файл, соответствующий версии вашего контроллера: | |||
#* Для WB 5.8.x-5.9 - [http://fw-releases.wirenboard.com/fit_image/stable/58/latest_stretch.fit http://fw-releases.wirenboard.com/fit_image/stable/58/latest_stretch.fit] | |||
#* Для WB 6.X ('''до 6.7''') - [http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit] | |||
#* Для WB 6.7.X - [http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit] | |||
Скачайте файл к себе на компьютер. | |||
#Зайдите в [[Веб-интерфейс Wiren Board|веб-интерфейс]], на страницу '''Settings'''. Найдите раздел '''Firmware update''', нажмите кнопку '''Select file''', выберите ранее скачанный файл прошивки на компьютере.[[File:web-settings.png|400px|thumb|center|Нажмите кнопку '''Select file''' для загрузки файла прошивки]] | |||
#Файл с новой прошивкой загрузится на контроллер, после этого начнётся процесс обновления. Не закрывайте страницу обновления и не производите никаких действий с контроллером, в том числе в веб-интерфейсе. Процесс обновления займёт до 10 минут.[[File:Web-settings-firmware-update-messages.png|400px|center|thumb|Во время обновления на странице появляются системные сообщения]] | |||
#После установки новой прошивки контроллер перезагрузится. После этого на странице обновления появится сообщение об успешном завершении обновления — '''Firmware update complete'''.[[File:Web-settings-firmware-update-completed.png|400px|center|thumb|Оповещение об успешном обновлении]] | |||
=== Обновление прошивки с помощью USB-накопителя === | |||
[[File:2 update.png|200px|thumb|right|Момент когда нужно нажать кнопку '''fw''' на 1 секунду для продолжения обновления]] | |||
[[File:4 update.png|200px|thumb|right|Сообщение о том что обновление началось]] | |||
'''ВНИМАНИЕ:''' в некоторых версиях контроллера есть аппаратные сложности с обновлением прошивки с использованием USB-накопителя. Если вы столкнулись с какой-либо проблемой, прочитайте [[WB 6: Errata]]. | |||
В контроллерах Wiren Board 6 добавлена возможность обновления прошивки с использованием USB-накопителя (флешки). | |||
На время обновления желательно подключиться к отладочной консоли контроллера, чтобы контролировать ход обновления. | |||
# USB-накопитель должен быть отформатирован в FAT32. Если в качестве накопителя используется внешний жёсткий диск, следует также убедиться, что USB-порт контроллера может выдать достаточный ток для запуска диска. | |||
# Скачайте свежую версию прошивки с расширением ''.fit'' для Вашего контроллера со страницы [http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ http://fw-releases.wirenboard.com/?prefix=fit_image/stable/]. | |||
# Сохраните скачанный файл на USB-накопитель в корневой каталог. Переименуйте этот файл в <code>wb6_update.fit</code>. | |||
# Отключите контроллер. | |||
# На выключенном контроллере потренируйтесь нажимать кнопку FW — в процессе обновления вам нужно будет делать это быстро и аккуратно. Для этого удобно использовать маленькую отвёртку из комплекта поставки контроллера. | |||
# Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер. | |||
# Если USB-накопитель корректно распознан, и в корне найден файл <code>wb6_update.fit</code>, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды. | |||
# Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе. В случае ошибки обновления (ошибки в Debag вида «''FAT: Misaligned buffer address''» — смените флешку на другую. | |||
# Дождитесь окончания процесса обновления, это займёт около 5 минут. В процессе обновления контроллер один раз перезагрузится. Обновление завершено, когда светодиод контроллера начинает мигать зелёным, как в штатном режиме работы. Можно извлечь USB-накопитель. | |||
== Сброс Wiren Board 6 к заводским настройкам == | |||
[[File:1 factory reset.png|200px|thumb|right|Момент когда нужно кратковременно нажать кнопку «fw» для сброса к заводским настройкам]] | |||
[[File:2 factory reset.png|200px|thumb|right|Момент когда нужно на 4 секунды нажать кнопку «fw» для подтверждения сброса к заводским настройкам]] | |||
[[File:3 factory reset.png|200px|thumb|right|Сообщение о том что сброс к заводским настройкам начался]] | |||
'''ВНИМАНИЕ''': сбросить к заводским настройкам можно ТОЛЬКО через USB-накопитель с ОСОБЫМ именем файла прошивки. | |||
'''ВНИМАНИЕ''': при сбросе все пользовательские данные (конфигурация, правила, файлы в домашней директории) будут уничтожены! | |||
# Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ Или скачайте «disk.img» по ссылкам ниже, скопируйте на флешку и переходите к прошивке. | |||
#* Пример ссылки на файл для WB6 http://fw-releases.wirenboard.com/fit_image/stable/6x/2020-08-31_13%3A15%3A20.fit | |||
# Проверьте USB накопитель, тип файловой системы должен быть fat32. Инструкция https://remontka.pro/format-usb-fat-32/ | |||
# Скопируйте скачанный файл на USB-накопитель и переименуйте его в <code>wb6_update_FACTORYRESET.fit</code> Имя файла и расширение должно быть именно таким. | |||
#* Убедитесь что размер файла не 0 кБ. | |||
# Отключите контроллер от питания. | |||
# Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер. | |||
#* как только контроллер замигает оранжевым, отрывисто нажмите на кнопку FW первый раз; | |||
#* после этого светодиод станет постоянно гореть зелёным, потом пару раз мигнёт красным, потом пару раз мигнёт зелёным. Потом контроллер начнёт '''издавать писк''', а светодиод при этом будет часто мигать красным — это значит, что контроллер ожидает подтверждения полной очистки. Чтобы подтвердить удаление всех данных и сбросить контроллер в заводское состояние нужно зажать кнопку FW более, чем на 4 секунды. Писк станет прерывистым. Пока писк и мигание продолжаются, кнопку '''нужно держать нажатой'''. Когда писк и мигание прекратятся, кнопку можно отпустить. | |||
# Процесс сброса занимает несколько минут. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Можно извлечь USB-накопитель. | |||
Образ флешки для 6.6 | |||
[https://drive.google.com/file/d/1-tSIeGWdwd82D715tl11yQrwkWOM-k2l/view?usp=sharing disk.img] | |||
Образ флешки для 6.7 | |||
[https://drive.google.com/file/d/1SpBgSOsVibGWedG5VGdNl915KIS0nSsf/view?usp=sharing disk.img] | |||
Скачанный файл ''disk.img'' можно скопировать на флешку с помощью: | |||
* Linux — dd if=disk.img of=[Путь_к_блочному_устройству] | |||
* Windows — c помощью свободно распространяемой программы [https://sourceforge.net/projects/win32diskimager/ win32diskimager] | |||
'''ВНИМАНИЕ''': Все содержимое флеш-накопителя будет безвозвратно потеряно! | |||
== Перезапись прошивки Wiren Board 5 == | |||
Для Wiren Board 5 см. [[Wiren Board 5: Восстановление прошивки|Wiren Board 5: Восстановление прошивки]]. | |||
Для других версий контроллера см. [[Создание microSD-карты с образом|Создание microSD-карты с образом]]. | |||
== Информация для разработчиков == | |||
Информация о внутреннем устройстве системы обновлений находится на [[WB Firmware Update Details|отдельной странице]]. |
Версия 09:25, 25 ноября 2020
Частичное обновление прошивки через APT
Обновление прошивки производится по частям с помощью системного менеджера пакетов операционной системы Debian.
Вы обновляете только нужные пакеты, поэтому обновление происходит быстро, а настройки других пакетов и пользовательские файлы не затрагиваются.
Недостаток способа — неосторожное использование инструмента может привести к неполной установке или к удалению компонентов ПО контроллера Wiren Board.
Обновление списка пакетов
Перед началом работы нужно получить актуальный список пакетов из репозиториев Debian и Wiren Board.
Обновить все списки пакетов:
apt-get update
Обновить только пакеты из репозитория Wiren Board:
apt-get update -o Dir::Etc::sourcelist="sources.list.d/contactless.list" -o Dir::Etc::sourceparts="-" -o APT::Get::List-Cleanup="0"
Обновление системы
Полное обновление:
apt-get upgrade -y
Установить один пакет с указанной версией:
apt-get install [имя_пакета]=[версия_пакета]
Пример:
apt-get install wb-mqtt-serial=1.63.0
Обновление прошивки целиком
Обновление прошивки через веб-интерфейс
ВНИМАНИЕ: для Wiren Board 5 этот способ НЕ рекомендуется при обновлении на версии с «stretch» в названии с версий без «stretch» в названии файла. Это касается, в частности, заводских прошивок WB5 старше середины 2018 года выпуска.
- Обновление прошивки происходит путём перезаписи раздела накопителя контроллера с операционной системой и всеми установленными программами. При этом не затрагиваются файлы, находящиеся в папках (они находятся в другом разделе). Подробнее ознакомиться с файлами, удаляющимися при обновлении системы, можно в разделе Потеря файлов при обновлении ПО
- В этих папках хранятся все изменения, которые можно сделать через веб-интерфейс, включая настройки со страницы Configs, все подключённые устройства и виджеты — все эти данные сохранятся.
- Если вы хранили данные на контроллере самостоятельно в других папках, или устанавливали собственное ПО, оно будет потеряно. Вы можете загрузить нужные файлы себе на компьютер перед обновлением по инструкции Просмотр файлов контроллера с компьютера.
- Свежие версии прошивок (как для контроллеров Wiren Board, так и для периферийных устройств) хранятся на fw-releases. Файлы прошивок для WB хранятся в разделе fit-image и имеют расширение .fit. Выберите файл, соответствующий версии вашего контроллера:
- Для WB 5.8.x-5.9 - http://fw-releases.wirenboard.com/fit_image/stable/58/latest_stretch.fit
- Для WB 6.X (до 6.7) - http://fw-releases.wirenboard.com/fit_image/stable/6x/latest_stretch.fit
- Для WB 6.7.X - http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit
Скачайте файл к себе на компьютер.
- Зайдите в веб-интерфейс, на страницу Settings. Найдите раздел Firmware update, нажмите кнопку Select file, выберите ранее скачанный файл прошивки на компьютере.
- Файл с новой прошивкой загрузится на контроллер, после этого начнётся процесс обновления. Не закрывайте страницу обновления и не производите никаких действий с контроллером, в том числе в веб-интерфейсе. Процесс обновления займёт до 10 минут.
- После установки новой прошивки контроллер перезагрузится. После этого на странице обновления появится сообщение об успешном завершении обновления — Firmware update complete.
Обновление прошивки с помощью USB-накопителя
ВНИМАНИЕ: в некоторых версиях контроллера есть аппаратные сложности с обновлением прошивки с использованием USB-накопителя. Если вы столкнулись с какой-либо проблемой, прочитайте WB 6: Errata.
В контроллерах Wiren Board 6 добавлена возможность обновления прошивки с использованием USB-накопителя (флешки).
На время обновления желательно подключиться к отладочной консоли контроллера, чтобы контролировать ход обновления.
- USB-накопитель должен быть отформатирован в FAT32. Если в качестве накопителя используется внешний жёсткий диск, следует также убедиться, что USB-порт контроллера может выдать достаточный ток для запуска диска.
- Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы http://fw-releases.wirenboard.com/?prefix=fit_image/stable/.
- Сохраните скачанный файл на USB-накопитель в корневой каталог. Переименуйте этот файл в
wb6_update.fit
. - Отключите контроллер.
- На выключенном контроллере потренируйтесь нажимать кнопку FW — в процессе обновления вам нужно будет делать это быстро и аккуратно. Для этого удобно использовать маленькую отвёртку из комплекта поставки контроллера.
- Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер.
- Если USB-накопитель корректно распознан, и в корне найден файл
wb6_update.fit
, светодиод контроллера начнёт часто мигать оранжевым. В этот момент нужно нажать на кнопку FW на плате контроллера и держать её около секунды. - Светодиод контроллера должен начать мигать красным, затем зелёным чаще, чем при штатной работе. В случае ошибки обновления (ошибки в Debag вида «FAT: Misaligned buffer address» — смените флешку на другую.
- Дождитесь окончания процесса обновления, это займёт около 5 минут. В процессе обновления контроллер один раз перезагрузится. Обновление завершено, когда светодиод контроллера начинает мигать зелёным, как в штатном режиме работы. Можно извлечь USB-накопитель.
Сброс Wiren Board 6 к заводским настройкам
ВНИМАНИЕ: сбросить к заводским настройкам можно ТОЛЬКО через USB-накопитель с ОСОБЫМ именем файла прошивки.
ВНИМАНИЕ: при сбросе все пользовательские данные (конфигурация, правила, файлы в домашней директории) будут уничтожены!
- Скачайте свежую версию прошивки с расширением .fit для Вашего контроллера со страницы http://fw-releases.wirenboard.com/?prefix=fit_image/stable/ Или скачайте «disk.img» по ссылкам ниже, скопируйте на флешку и переходите к прошивке.
- Пример ссылки на файл для WB6 http://fw-releases.wirenboard.com/fit_image/stable/6x/2020-08-31_13%3A15%3A20.fit
- Проверьте USB накопитель, тип файловой системы должен быть fat32. Инструкция https://remontka.pro/format-usb-fat-32/
- Скопируйте скачанный файл на USB-накопитель и переименуйте его в
wb6_update_FACTORYRESET.fit
Имя файла и расширение должно быть именно таким.- Убедитесь что размер файла не 0 кБ.
- Отключите контроллер от питания.
- Подключите USB-накопитель к первому USB-порту контроллера (ближнему к разъёмам Ethernet) и включите контроллер.
- как только контроллер замигает оранжевым, отрывисто нажмите на кнопку FW первый раз;
- после этого светодиод станет постоянно гореть зелёным, потом пару раз мигнёт красным, потом пару раз мигнёт зелёным. Потом контроллер начнёт издавать писк, а светодиод при этом будет часто мигать красным — это значит, что контроллер ожидает подтверждения полной очистки. Чтобы подтвердить удаление всех данных и сбросить контроллер в заводское состояние нужно зажать кнопку FW более, чем на 4 секунды. Писк станет прерывистым. Пока писк и мигание продолжаются, кнопку нужно держать нажатой. Когда писк и мигание прекратятся, кнопку можно отпустить.
- Процесс сброса занимает несколько минут. После завершения процедуры контроллер загрузится в штатном режиме, а светодиод на нем замигает зеленым. Можно извлечь USB-накопитель.
Образ флешки для 6.6 disk.img
Образ флешки для 6.7 disk.img
Скачанный файл disk.img можно скопировать на флешку с помощью:
- Linux — dd if=disk.img of=[Путь_к_блочному_устройству]
- Windows — c помощью свободно распространяемой программы win32diskimager
ВНИМАНИЕ: Все содержимое флеш-накопителя будет безвозвратно потеряно!
Перезапись прошивки Wiren Board 5
Для Wiren Board 5 см. Wiren Board 5: Восстановление прошивки.
Для других версий контроллера см. Создание microSD-карты с образом.
Информация для разработчиков
Информация о внутреннем устройстве системы обновлений находится на отдельной странице.