Bootloader: различия между версиями
| Строка 6: | Строка 6: | ||
== Обновление == | == Обновление == | ||
{{Anchor|update}} | {{Anchor|update}} | ||
[[Bootloader_Changelog| Список изменений в | Есть несколько способов обновления загрузчика: | ||
==== Рекомендуемый способ: утилита <code>wb-mcu-fw-updater</code> ==== | |||
Для использования этого способа нужен контроллер Wiren Board, подключенный к интернету. | |||
Рекомендуется обновить пакеты для получения актуальной версии wb-mcu-fw-updater: <code>apt update; apt upgrade</code> | |||
Для запуска обновления загрузчика одного устройства нужно ввести команду (подставить нужный порт и адрес): | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-bl /dev/ttyRS485-1 -a1 | |||
</syntaxhighlight> | |||
В результате будет выполнена проверка наличия обновления загрузчика, скачивание нужного файла обновления, обновление загрузчика и установка актуальной версии прошивки в соответствии с [[ Wiren_Board_Software#Кратко_о_релизах | релизом ПО контроллера ]]. | |||
Также в утилите <code>wb-mcu-fw-updater</code> есть автоматический режим обновления прошивок всех устройств. | |||
Начиная с версии 1.10.8 в этом режиме перед началом процесса обновления прошивки утилита проверяет необходимость обновления загрузчика и выводит на экран предложение обновить загрузчик, на которое можно ответить <code>y</code> для обновления загрузчика. | |||
Пример: | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-updater update-all | |||
2024-04-03 07:17:24,061 Will probe all devices on enabled serial ports of /etc/wb-mqtt-serial.conf: | |||
2024-04-03 07:17:24,063 Probing WB-MAP6S fw2 (port: /dev/ttyRS485-1, slaveid: 26, uart_params: 9600N2, response_timeout: 0.50)... | |||
2024-04-03 07:17:26,460 Update: 2.8.0-rc1 -> 2.8.1 (WB-MAP6S fw2 (26, /dev/ttyRS485-1)) | |||
2024-04-03 07:17:27,128 Flashing firmware to WB-MAP6S fw2 (26, /dev/ttyRS485-1) | |||
2024-04-03 07:17:28,073 | |||
2024-04-03 07:17:28,073 Bootloader update (v1.3.0 -> v1.4.1) for map6semG16 /dev/ttyRS485-1:26 is available! (bootloader updates are highly recommended to install) Do a bootloader update? [Y/N] | |||
</syntaxhighlight> | |||
==== Ручное обновление: утилита <code>wb-mcu-fw-flasher</code> ==== | |||
Утилита позволяет обновлять прошивки и загрузчики Modbus-устройств в ручном режиме. При этом обновление может быть запущено как с контроллера Wiren Board, так и с ПК. Для работы утилиты не требуется доступ в интернет, однако нужно скачать файл обновления прошивки или загрузчика любым удобным способом. | |||
Чтобы выбрать подходящие файлы для обновления загрузчика и прошивки, нужно считать сигнатуру устройства (подставьте верный адрес устройства и порт): | |||
<syntaxhighlight lang="bash"> | |||
echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a1 -t0x03 -r290 -c12 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g') | |||
</syntaxhighlight> | |||
В результате на экран будет выведена строка вида <code>mwac0</code> | |||
Для скачивания файла обновления загрузчика нужно перейти по ссылке https://fw-releases.wirenboard.com/?prefix=bootloader/by-signature/. Далее выбрать соответствующую сигнатуру, раздел <code>main</code> и скачать файл <code>latest.wbfw</code>. | |||
Файлы прошивок находятся по адресу https://fw-releases.wirenboard.com/?prefix=fw/by-signature/. Нужный файл прошивки выбирается аналогично: <code>сигнатура/main/latest.wbfw</code>. Если вам необходима конкретная версия прошивки, можно скачать именно её. | |||
Теперь, когда файлы обновления загрузчика и прошивки скачаны, можно приступить к процессу обновления. | |||
Сначала нужно запустить обновление загрузчика: | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f wb-bootloader-updater_mwac0__1.4.1_master_e676613.wbfw -j | |||
</syntaxhighlight> | |||
После завершения процесса обновления загрузчика прошивка из устройства будет удалена и устройство будет постоянно находиться в загрузчике. Теперь нужно вернуть прошивку: | |||
<syntaxhighlight lang="bash"> | |||
wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f mwac0__1.21.1_main_ac00010.wbfw | |||
</syntaxhighlight> | |||
Обратите внимание, что ключа <code>-j</code> (переход в загрузчик) нет, т.к. устройство уже в загрузчике. Описание параметров утилиты <code>wb-mcu-fw-flasher</code> можно увидеть, запустив её без параметров. | |||
== Список изменений в загрузчике == | |||
[[Bootloader_Changelog| Список изменений в загрузчике]] | |||
== Известные ошибки == | == Известные ошибки == | ||
[[Bootloader: Errata | Список известных неисправностей]] | [[Bootloader: Errata | Список известных неисправностей]] | ||
Версия 10:19, 3 апреля 2024
Описание
Bootloader — загрузчик устройств Wiren Board.
Режим загрузчика Modbus-устройств Wiren Board
Обновление
Есть несколько способов обновления загрузчика:
Рекомендуемый способ: утилита wb-mcu-fw-updater
Для использования этого способа нужен контроллер Wiren Board, подключенный к интернету.
Рекомендуется обновить пакеты для получения актуальной версии wb-mcu-fw-updater: apt update; apt upgrade
Для запуска обновления загрузчика одного устройства нужно ввести команду (подставить нужный порт и адрес):
wb-mcu-fw-updater update-bl /dev/ttyRS485-1 -a1
В результате будет выполнена проверка наличия обновления загрузчика, скачивание нужного файла обновления, обновление загрузчика и установка актуальной версии прошивки в соответствии с релизом ПО контроллера .
Также в утилите wb-mcu-fw-updater есть автоматический режим обновления прошивок всех устройств.
Начиная с версии 1.10.8 в этом режиме перед началом процесса обновления прошивки утилита проверяет необходимость обновления загрузчика и выводит на экран предложение обновить загрузчик, на которое можно ответить y для обновления загрузчика.
Пример:
wb-mcu-fw-updater update-all
2024-04-03 07:17:24,061 Will probe all devices on enabled serial ports of /etc/wb-mqtt-serial.conf:
2024-04-03 07:17:24,063 Probing WB-MAP6S fw2 (port: /dev/ttyRS485-1, slaveid: 26, uart_params: 9600N2, response_timeout: 0.50)...
2024-04-03 07:17:26,460 Update: 2.8.0-rc1 -> 2.8.1 (WB-MAP6S fw2 (26, /dev/ttyRS485-1))
2024-04-03 07:17:27,128 Flashing firmware to WB-MAP6S fw2 (26, /dev/ttyRS485-1)
2024-04-03 07:17:28,073
2024-04-03 07:17:28,073 Bootloader update (v1.3.0 -> v1.4.1) for map6semG16 /dev/ttyRS485-1:26 is available! (bootloader updates are highly recommended to install) Do a bootloader update? [Y/N]
Ручное обновление: утилита wb-mcu-fw-flasher
Утилита позволяет обновлять прошивки и загрузчики Modbus-устройств в ручном режиме. При этом обновление может быть запущено как с контроллера Wiren Board, так и с ПК. Для работы утилиты не требуется доступ в интернет, однако нужно скачать файл обновления прошивки или загрузчика любым удобным способом.
Чтобы выбрать подходящие файлы для обновления загрузчика и прошивки, нужно считать сигнатуру устройства (подставьте верный адрес устройства и порт):
echo -e $(modbus_client -mrtu -pnone -s2 /dev/ttyRS485-1 -a1 -t0x03 -r290 -c12 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g')
В результате на экран будет выведена строка вида mwac0
Для скачивания файла обновления загрузчика нужно перейти по ссылке https://fw-releases.wirenboard.com/?prefix=bootloader/by-signature/. Далее выбрать соответствующую сигнатуру, раздел main и скачать файл latest.wbfw.
Файлы прошивок находятся по адресу https://fw-releases.wirenboard.com/?prefix=fw/by-signature/. Нужный файл прошивки выбирается аналогично: сигнатура/main/latest.wbfw. Если вам необходима конкретная версия прошивки, можно скачать именно её.
Теперь, когда файлы обновления загрузчика и прошивки скачаны, можно приступить к процессу обновления.
Сначала нужно запустить обновление загрузчика:
wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f wb-bootloader-updater_mwac0__1.4.1_master_e676613.wbfw -j
После завершения процесса обновления загрузчика прошивка из устройства будет удалена и устройство будет постоянно находиться в загрузчике. Теперь нужно вернуть прошивку:
wb-mcu-fw-flasher -d /dev/ttyRS485-1 -b9600 -a1 -f mwac0__1.21.1_main_ac00010.wbfw
Обратите внимание, что ключа -j (переход в загрузчик) нет, т.к. устройство уже в загрузчике. Описание параметров утилиты wb-mcu-fw-flasher можно увидеть, запустив её без параметров.