7809
правок
(Отметить эту версию для перевода) |
Fizikdaos (обсуждение | вклад) |
||
(не показано 65 промежуточных версий 7 участников) | |||
Строка 9: | Строка 9: | ||
<!--T:2--> | <!--T:2--> | ||
В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU. | В новых версиях наших устройств реализован механизм загрузчика прошивок (bootloader). Он позволяет обновлять микропрограммы устройств/модулей Wiren Board по RS-485/Modbus RTU. | ||
<!--T:3--> | <!--T:3--> | ||
В режиме загрузчика основной функционал устройства отключается. '''Коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.''' | В режиме загрузчика основной функционал устройства отключается. '''Коммуникационные параметры в режиме загрузчика фиксированы и не зависят от значений в памяти устройства: 9600 8N2.''' | ||
== Переход в режим загрузчика == <!--T:4--> | == Переход в режим загрузчика == <!--T:4--> | ||
<!--T:5--> | <!--T:5--> | ||
[[ | [[File:Bootloader.gif||right||Индикация режима загрузчика]] | ||
* на устройстве имеется корректная прошивка | * Если на устройстве имеется корректная прошивка, то первые 2 секунды после включения питания устройство работает в режиме загрузчика; | ||
* на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки) | * Если на устройстве нет корректной прошивки (например, был сбой при обновлении прошивки), то режим загрузчика активен постоянно; | ||
* | * При записи 1 в holding-регистр 129 (0x81) при работе основной программы — в этом случае устройство перезагружается и остается в режиме загрузчика 120 секунд. Это может сделать утилита wb-mcu-fw-flasher если использовать ключ -j. | ||
<!--T:6--> | <!--T:6--> | ||
Индикация режима загрузчика: индикатор Status устройства редко мигает. При заливке | Индикация режима загрузчика: индикатор Status устройства редко мигает с периодом 1 секунда. При заливке прошивки индикатор часто мигает при приеме блока данных. | ||
== Автоматическое обновление прошивки с контроллера Wiren Board == | |||
Прошивку устройств, подключенных к контроллеру Wiren Board можно обновить с помощью утилиты [[wb-mcu-fw-updater]]. Утилита проверяет наличие новой версии прошивки для всех подключенных устройств и, при необходимости, обновляет их. | |||
Для установки выполните в консоли: | |||
<pre> | |||
dpkg -s wb-mcu-fw-updater || (apt update && apt install wb-mcu-fw-updater) | |||
</pre> | |||
< | Для обновления прошивки всех устройств, описанных в разделе Serial Devices Configuration (файл /etc/wb-mqtt-serial.conf), выполните: | ||
<pre> | |||
wb-mcu-fw-updater update-all | |||
</pre> | |||
Для обновления прошивки конкретного устройства, укажите порт и его адрес Modbus: | |||
<pre> | |||
wb-mcu-fw-updater update-fw /dev/ttyRS485-2 -a70 | |||
</pre> | |||
Подробную информацию смотрите в выводе | |||
<pre> | |||
wb-mcu-fw-updater --help | |||
</pre> | |||
== | <gallery mode="packed" heights="200px"> | ||
File:Wb-fw-mcu-updater example 1.png|Пример работы wb-fw-mcu-updater | |||
</gallery> | |||
== Ручная прошивка устройств == | |||
=== Выбор прошивки === | |||
Прошивки публикуются на сайте [http://fw-releases.wirenboard.com/?prefix=fw/ '''fw-releases.wirenboard.com'''] в виде файлов с расширением '''.wbfw'''. | |||
Прошивки сгруппированы по версиям и сигнатурам (типам) устройств. | |||
Каждое Modbus устройство Wirenboard имеет сигнатуру — наименование аппаратного типа устройства. Перезапись прошивки возможна только при совпадении сигнатур устройства и прошивки. | |||
Сигнатура устройства хранится в формате строки из 12 ASCII символов, по одному символу в регистре, и доступна по адресу 290. | |||
Получить можно командой: | |||
< | <code> | ||
echo -e $(modbus_client -mrtu -pnone -s2 '''/dev/ttyRS485-1''' -a '''A''' -t3 -r 290 -c 12 | grep Data | sed -e 's/.*Data://' -e 's/ 0x00/\\x/g') | |||
</code> | |||
замените значения '''/dev/ttyRS485-1''' на имя устройства шины и '''A''' на адрес устройства. | |||
В результате будет выведена строка с сигнатурой, например '''mr6c''' | |||
Прошивку вы можете скачать например с помощью команды wget , для mr6c это будет выглядеть следующим образом: | |||
<pre> | |||
wget http://fw-releases.wirenboard.com/fw/by-signature/mr6c/stable/latest.wbfw | |||
</pre> | |||
<!--T: | === Подключение устройства === <!--T:11--> | ||
Прошивать устройство лучше по стандартному адресу (на который устройство отвечает из основной программы). | |||
Так же можно прошивать по широковещательному адресу 0, если у вас одно устройство на шине в режиме загрузчика. | |||
Поэтому для прошивки нескольких устройств на шине можно: | |||
#переводить в режим загрузчика (перезагрузкой по питанию или записью в регистр) и прошивать по отдельности с указанием нешироковещательного Modbus-адреса. | |||
#переводить '''по очереди''' в режим загрузчика (перезагрузкой по питанию) и прошивать по адресу 0. | |||
* '''Одновременная прошивка''' устройств невозможна; имеющаяся прошивка на устройствах будет испорчена. | |||
* Перевести устройство в бутлоадер по широковещательному адресу 0 - '''нельзя'''! | |||
*'''При прошивке с контроллера остановите wb-mqtt-serial:'''<pre>service wb-mqtt-serial stop</pre> | |||
=== Утилита wb-mcu-fw-flasher для прошивки устройств === <!--T:15--> | |||
<!--T:17--> | <!--T:17--> | ||
Строка 71: | Строка 102: | ||
<!--T:18--> | <!--T:18--> | ||
Версия утилиты для '''MS Windows''': [[Media: Wb-mcu-fw-flasher_1.0.3.zip | Wb-mcu-fw-flasher_1.0.3.zip]] | |||
<!--T:19--> | <!--T:19--> | ||
Для установки на '''компьютер с Debian''' скачайте пакет | Для установки на '''компьютер с Debian''' скачайте пакет - [[Media: Wb-mcu-fw-flasher_1.0.3_amd64-all.deb | Wb-mcu-fw-flasher_1.0.3_amd64-all.deb]] | ||
и выполните команды в директории, | и выполните команды в директории, куда загрузился пакет: | ||
<pre> | <pre> | ||
apt-get update | apt-get update | ||
apt-get install libmodbus5 | apt-get install libmodbus5 | ||
dpkg -i Wb-mcu-fw-flasher_1.0. | dpkg -i Wb-mcu-fw-flasher_1.0.3_amd64-all.deb | ||
</pre> | </pre> | ||
Для контроллеров других производителей с процессорами ARM Cortex можно воспользоваться Debian-пакетом для Wiren Board: http://releases.contactless.ru/?prefix=stable/stretch/pool/main/w/wb-mcu-fw-flasher/ | |||
<!--T: | <!--T:20--> | ||
Опции запуска утилиты wb-mcu-fw-flasher: | Опции запуска утилиты wb-mcu-fw-flasher: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Параметр !! Описание !! Значение по умолчанию | ! Параметр !! Описание !! Значение по умолчанию | ||
|- | |- | ||
| -d || Устройство последовательного порта || | | -d || Устройство последовательного порта ('''обязательно''') || | ||
|- | |- | ||
| -f || Файл прошивки || | | -f || Файл прошивки || | ||
Строка 96: | Строка 126: | ||
| -a || Адрес Modbus || 1 | | -a || Адрес Modbus || 1 | ||
|- | |- | ||
| -j || Отправить на устройство команду перехода в режим загрузчика || | | -j || Отправить на устройство команду перехода в режим загрузчика || | ||
|- | |||
| -b || Скорость порта (baudrate) || 9600 | |||
|- | |||
| -p || Чётность (parity) || N | |||
|- | |||
| -s || Количество стопбитов || 2 | |||
|- | |- | ||
| -r || Адрес holding-регистра для перехода в режим загрузчика || 129 | | -r || Адрес holding-регистра для перехода в режим загрузчика || 129 | ||
|- | |- | ||
| -D || Включить режим отладки || | | -D || Включить режим отладки || | ||
|- | |||
| -u || Восстановление заводских настроек UART и Modbus адреса || | |||
|- | |||
| -e || Сброс всех настроек до заводских || | |||
|} | |} | ||
<!--T: | <!--T:21--> | ||
Пример: | Пример (устройство в рабочем режиме): | ||
<pre> | <pre> | ||
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw | wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw | ||
</pre> | </pre> | ||
<!--T: | <!--T:22--> | ||
Пример для Windows: | Пример для Windows (устройство в рабочем режиме): | ||
<pre> | <pre> | ||
wb-mcu-fw-flasher.exe -j -d COM10 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw | wb-mcu-fw-flasher.exe -j -d COM10 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw | ||
</pre> | </pre> | ||
<!--T: | <!--T:23--> | ||
Здесь COM10 — имя виртуального последовательного порта, которое присвоено адаптеру USB RS-485. | Здесь COM10 — имя виртуального последовательного порта, которое присвоено адаптеру USB RS-485. | ||
<!--T:24--> | |||
Пример для устройства с нестандартными настройками UART (со скоростью порта 115200): | |||
<!--T: | |||
<pre> | <pre> | ||
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f WB-MR-MR6C_MCU3_3_1.9.4.wbfw -b 115200 | |||
</pre> | </pre> | ||
<!--T: | === Прошивка устройств === <!--T:25--> | ||
<!--T: | <!--T:26--> | ||
Итого, порядок действий: | |||
<pre> | #При прошивке с контроллера остановите wb-mqtt-serial. | ||
#Подключите устройство к RS-485. | |||
</pre> | #Скачайте файл прошивки, например, mr6c__1.14.1_master_19c9ca5.wbfw | ||
#Прошейте устройство утилитой wb-mcu-fw-flasher:<pre>wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 25 -f mr6c__1.14.1_master_19c9ca5.wbfw</pre> | |||
#После успешной прошивки устройство само выйдет из режима загрузчика и перезапустится в основной программе. | |||
Успешный процесс прошивки выглядит так: | |||
Успешный процесс прошивки выглядит | |||
<pre> | <pre> | ||
wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 1 -f | wb-mcu-fw-flasher -j -d /dev/ttyRS485-1 -a 1 -f mr6c__1.14.1_master_19c9ca5.wbfw | ||
/dev/ttyRS485-1 opened successfully. | /dev/ttyRS485-1 opened successfully. | ||
Send jump to bootloader command and wait 2 seconds... | Send jump to bootloader command and wait 2 seconds... | ||
Error: Connection timed out. | Error: Connection timed out. | ||
May be device already in bootloader, try to send firmware... | May be device already in bootloader, try to send firmware... | ||
mr6c__1.14.1_master_19c9ca5.wbfw opened successfully, size 12136 bytes | |||
Sending info block... OK | Sending info block... OK | ||
Sending data block 89 of 89... OK. | Sending data block 89 of 89... OK. | ||
All done! | All done! | ||
</pre> | </pre> | ||
<!--T:33--> | <!--T:33--> | ||
Пример ошибки при несовпадении сигнатуры: | Пример ошибки при несовпадении сигнатуры: | ||
<pre> | <pre> | ||
Sending info block... | Sending info block... | ||
Error while sending info block: Slave device or server failure | Error while sending info block: Slave device or server failure | ||
Data format is invalid or firmware signature doesn't match the device | Data format is invalid or firmware signature doesn't match the device | ||
</pre> | </pre> | ||
</translate> | </translate> |