Просмотр кода страницы Ensystec-modbus-address-change

__NOTOC__
= Смена Modbus адреса Ensystec через консоль Wiren Board =

Эта инструкция описывает смену Modbus-адреса системы защиты от протечек '''Ensystec Leak Protect''' через SSH-консоль контроллера '''Wiren Board'''.

Способ применяется, когда Ensystec уже подключён к одному из портов RS-485 контроллера и нужно назначить ему уникальный адрес на шине Modbus RTU.

== 📌 Исходные параметры Ensystec ==

Для штатного подключения используются параметры:

{| class="wikitable"
! Параметр !! Значение
|-
| Интерфейс || RS-485, Modbus RTU
|-
| Скорость || 9600 бод
|-
| Формат || 8N2: 8 бит данных, без чётности, 2 стоп-бита
|-
| Заводской Modbus-адрес || 247
|-
| Регистр адреса || holding-регистр <code>0x0F</code>
|-
| Функция записи || <code>0x06</code>, Write Single Register
|}

В регистре <code>0x0F</code> адрес находится в младшем байте. На практике заводской адрес читается как <code>0xFFF7</code>, где <code>F7</code> — это 247. Для адреса 11 записывается значение <code>0xFF0B</code>, где <code>0B</code> — это 11.

== ⚠ Перед началом ==

* Убедитесь, что на линии RS-485 нет другого устройства с адресом, который вы собираетесь назначить.
* Убедитесь, что обращаетесь к правильному порту: например, <code>/dev/ttyRS485-1</code>, <code>/dev/ttyRS485-2</code> или <code>/dev/ttyMOD1</code>.
* На время ручных команд нужно остановить сервис <code>wb-mqtt-serial</code>, иначе он будет занимать порт.
* В примерах ниже Ensystec подключён к <code>/dev/ttyRS485-2</code>, текущий адрес — <code>247</code>, новый адрес — <code>11</code>.

== 1. Подключиться к Wiren Board по SSH ==

На компьютере откройте терминал и подключитесь к контроллеру:

<pre>
ssh root@192.168.88.27
</pre>

Вместо <code>192.168.88.27</code> укажите IP-адрес своего контроллера.

== 2. Проверить, на каком порту добавлен Ensystec ==

Посмотреть конфигурацию <code>wb-mqtt-serial</code> можно командой:

<pre>
grep -n 'Ensystec\|ttyRS485\|ttyMOD' /etc/wb-mqtt-serial.conf
</pre>

В веб-интерфейсе Wiren Board этот же порт виден в разделе устройства, например как <code>RS485-2</code>.

== 3. Остановить wb-mqtt-serial ==

<pre>
systemctl stop wb-mqtt-serial
</pre>

После остановки сервис перестаёт опрашивать Modbus-устройства, и порт можно использовать вручную через <code>modbus_client</code>.

== 4. Проверить текущий адрес 247 ==

Прочитайте регистр адреса <code>0x0F</code> по заводскому адресу <code>247</code>:

<pre>
modbus_client --debug -mrtu -a247 -t0x03 -r0x0F -c1 -b9600 -d8 -pnone -s2 /dev/ttyRS485-2
</pre>

Ожидаемый результат для заводского адреса:

<pre>
SUCCESS: read 1 of elements:
	Data: 0xfff7
</pre>

Если ответа нет, проверьте порт, A/B линии RS-485, питание Ensystec и текущий адрес устройства.

== 5. Записать новый адрес 11 ==

Запишите в регистр <code>0x0F</code> значение <code>0xFF0B</code>:

<pre>
modbus_client --debug -mrtu -a247 -t0x06 -r0x0F -b9600 -d8 -pnone -s2 /dev/ttyRS485-2 0xFF0B
</pre>

Ожидаемый результат:

<pre>
SUCCESS: written 1 elements!
</pre>

После этой команды Ensystec должен перестать отвечать на адресе <code>247</code> и начать отвечать на адресе <code>11</code>.

== 6. Проверить новый адрес ==

Прочитайте тот же регистр уже по адресу <code>11</code>:

<pre>
modbus_client --debug -mrtu -a11 -t0x03 -r0x0F -c1 -b9600 -d8 -pnone -s2 /dev/ttyRS485-2
</pre>

Ожидаемый результат:

<pre>
SUCCESS: read 1 of elements:
	Data: 0xff0b
</pre>

Дополнительно можно проверить, что старый адрес больше не отвечает:

<pre>
modbus_client --debug -mrtu -a247 -t0x03 -r0x0F -c1 -o300 -b9600 -d8 -pnone -s2 /dev/ttyRS485-2
</pre>

Ожидаемый результат для старого адреса:

<pre>
ERROR Connection timed out: select
</pre>

== 7. Обновить адрес в конфигурации Wiren Board ==

Сначала сделайте резервную копию конфигурации:

<pre>
cp /etc/wb-mqtt-serial.conf /etc/wb-mqtt-serial.conf.bak-$(date +%Y%m%d-%H%M%S)
</pre>

Затем замените адрес Ensystec в конфигурации на <code>11</code>:

<pre>
jq '(.ports[] | select(.path == "/dev/ttyRS485-2").devices[] | select(.device_type == "Ensystec-Leak-Protect").slave_id) = "11"' /etc/wb-mqtt-serial.conf > /tmp/wb-mqtt-serial.conf && mv /tmp/wb-mqtt-serial.conf /etc/wb-mqtt-serial.conf
</pre>

Если Ensystec подключён к другому порту, замените <code>/dev/ttyRS485-2</code> в команде на нужный порт.

== 8. Запустить wb-mqtt-serial и проверить подключение ==

Запустите сервис обратно:

<pre>
systemctl start wb-mqtt-serial
</pre>

Проверьте, что сервис активен:

<pre>
systemctl is-active wb-mqtt-serial
</pre>

Проверьте журнал на подключение устройства с новым адресом:

<pre>
journalctl -u wb-mqtt-serial -n 80 --no-pager | grep -E 'Ensystec|modbus:11|failed.*11'
</pre>

Нормальный признак успешной настройки:

<pre>
device modbus:11 is connected
</pre>

== Быстрый пример для адреса 11 ==

Если Ensystec подключён к <code>RS485-2</code>, текущий адрес <code>247</code>, новый адрес <code>11</code>, последовательность команд будет такой:

<pre>
systemctl stop wb-mqtt-serial

modbus_client --debug -mrtu -a247 -t0x03 -r0x0F -c1 -b9600 -d8 -pnone -s2 /dev/ttyRS485-2
modbus_client --debug -mrtu -a247 -t0x06 -r0x0F -b9600 -d8 -pnone -s2 /dev/ttyRS485-2 0xFF0B
modbus_client --debug -mrtu -a11 -t0x03 -r0x0F -c1 -b9600 -d8 -pnone -s2 /dev/ttyRS485-2

cp /etc/wb-mqtt-serial.conf /etc/wb-mqtt-serial.conf.bak-$(date +%Y%m%d-%H%M%S)
jq '(.ports[] | select(.path == "/dev/ttyRS485-2").devices[] | select(.device_type == "Ensystec-Leak-Protect").slave_id) = "11"' /etc/wb-mqtt-serial.conf > /tmp/wb-mqtt-serial.conf && mv /tmp/wb-mqtt-serial.conf /etc/wb-mqtt-serial.conf

systemctl start wb-mqtt-serial
journalctl -u wb-mqtt-serial -n 80 --no-pager | grep -E 'Ensystec|modbus:11|failed.*11'
</pre>

== См. также ==

* [[Описание и схема подключения блока защиты от протечек воды Ensystec]]
* [[Смена Modbus адреса у устройств Wiren Board через консоль]]
* [https://wiki.wirenboard.com/wiki/images/4/44/Ensystec_Leak_Protect_MODBUS_RTU.pdf Таблица регистров Ensystec Leak Protect Modbus RTU]