UniSet  2.7.0
Реализация Modbus slave

Общее описание Modbus slave

Класс реализует базовые функции для протокола Modbus в slave режиме. Реализацию Modbus RTU - см. RTUExchange. Реализацию Modbus slave (TCP) - см. MBSlave. Список регистров с которыми работает процесс задаётся в конфигурационном файле в секции <sensors>. см. Конфигурирование ModbusTCP slave

В данной версии поддерживаются следующие функции:

Конфигурирование ModbusTCP slave

  Конфигурирование процесса осуществляется либо параметрами командной строки либо
  через настроечную секцию.

  \par Секция с настройками
  При своём старте, в конфигурационном файле ищётся секция с названием объекта,
  в которой указываются настроечные параметры по умолчанию.
  Пример:
<MBSlave1 name="MBSlave1" default_mbaddr="0x31"
afterSendPause="0"
reg_from_id="0"
replyTimeout="60"
askcount_id=""
respond_invert=""
respond_id=""
timeout=""
heartbeat_id=""
initPause=""
force=""
...
  \par Параметры запуска

При создании объекта в конструкторе передаётся префикс для определения параметров командной строки.
  По умолчанию \b xxx="mbs".
  Далее приведены основные параметры:

  \b --xxx-name ID - идентификатор процесса.

  \b --xxx-default-mbaddr addr1 - slave-адрес по умолчанию для данного устройства. Если указан адрес 255 - ответ будет на любые сообщения.

  \b --xxx-timeout или \b timeout msec  - таймаут на определение отсутсвия связи.

  \b --xxx-reply-timeout msec  - таймаут на формирование ответа.

  \b --xxx-initPause или \b initPause msec - пауза перед началом работы, после активации. По умолчанию 50 мсек.

  \b --xxx-force или \b force [1|0]
   - 1 - перечитывать/перезаписывать значения входов из SharedMemory на каждом цикле
   - 0 - обновлять значения только по изменению

  \b --xxx-reg-from-id или \b reg_from_id [1|0]
   - 1 - в качестве регистра использовать идентификатор датчика
   - 0 - регистр брать из поля tcp_mbreg

  \b --xxx-default-mbfunc или \b default_mbfunc [0...255] - Функция подставляемая по умолчанию, если не указан параметр mbfunc. Действует только если включён контроль функций (check-mbfunc).
  \b --xxx-check-mbfunc [0|1] -
   - 1 - включить контроль (обработку) свойства mbfunc. По умолчанию: отключёна. Если контроль включён то разрешено
   использовать один и тот же регистр но \b для \b разных \b функций.
   - 0 - игнорировать свойство mbfunc..

  \b --xxx-heartbeat-id или \b heartbeat_id ID - идентификатор датчика "сердцебиения" (см. \ref sec_SM_HeartBeat)

  \b --xxx-heartbeat-max или \b heartbeat_max val - сохраняемое значение счётчика "сердцебиения".

  \b --xxx-activate-timeout msec . По умолчанию 2000. - время ожидания готовности SharedMemory к работе.

  \b --xxx-allow-setdatetime 0,1 - Включить функцию 0x50. Выставление даты и времени.

  \par Настройки протокола RTU:

  \b --xxx-dev devname  - файл устройства

  \b --xxx-speed        - Скорость обмена (9600,19920,38400,57600,115200)

  \par Настройки протокола TCP:

  \b --xxx-inet-addr [xxx.xxx.xxx.xxx | hostname ]  - this modbus server address

  \b --xxx-inet-port num - this modbus server port. Default: 502.

Конфигурирование списка регистров для ModbusSlave

Конфигурационные параметры задаются в секции <sensors> конфигурационного файла. Список обрабатываемых регистров задаётся при помощи двух параметров командной строки

–xxx-filter-field - задаёт фильтрующее поле для датчиков

–xxx-filter-value - задаёт значение фильтрующего поля. Необязательный параметр.

Предупреждения
Если в результате список будет пустым, процесс завершает работу.

Пример конфигурационных параметров:

<sensors name="Sensors">
...
<item name="MySensor_S" textname="my sesnsor" iotype="DI"
mbs="1" mbs_mbaddr="0x02" mbs_mbreg="1"
/>
<item name="MySensor2_S" textname="my sesnsor 2" iotype="DI"
mbs="1" mbs_mbaddr="0x01" mbs_mbreg="1"
/>
...
</sensors>
Предупреждения
По умолчанию для свойств используется заданный в конструктроре префикс "mbs_".

К основным параметрам настройки датчиков относятся следующие (префикс mbs_ - для примера):

Помимо этого можно задавать следующие параметры:

Предупреждения
Регистр должен быть уникальным. И может повторятся только если указан параметр nbyte.

Настройка передачи файлов в ModbusSlave (0x66)

Данная реализация позволяет передавать по протоколу Modbus заранее заданные файлы. Настройка происходвится в конфигурационном файле.

<filelist>
<!-- Список файлов разрешённых для передачи по modbus
directory - каталог где лежит файл. Можно не задавать
'ConfDir' - берётся из настроек (см. начало этого файла)
'DataDir' - берётся из настроек (см. начало этого файла)
'xxx' - прямое указание каталога
-->
<item directory="ConfDir" id="1" name="configure.xml"/>
<item directory="ConfDir" id="2" name="VERSION"/>
<item directory="/tmp/" id="3" name="configure.xml.gz"/>
<item directory="ConfDir" id="4" name="SERIAL"/>
</filelist>

Поддержка "MODBUS Encapsulated Interface" (0x2B)[0x0E]

<MEI>
<!-- ВНИМАНИЕ: должен заполняться в соответсвии со стандартом. ObjectID и DeviceID не случайны.. -->
<device id="0x01">
<object id="0" comm="VendorName">
<string value="etersoft"/>
</object>
<object id="1" comm="ProductCode">
<string value="uniset"/>
</object>
<object id="2" comm="MajorMinorRevision">
<string value="1.6"/>
</object>
</device>
<device id="0x02">
<object id="3" comm="VendorURL">
<string value="http://www.etersoft.ru"/>
</object>
<object id="4" comm="ProductName">
<string value="uniset"/>
</object>
<object id="5" comm="ModelName">
<string value="uniset:MBSlave"/>
</object>
<object id="6" comm="UserApplicationName">
<string value="MBSlave1"/>
</object>
</device>
<device id="0x03">
<object id="128" comm="private objects">
<string id="129" value="etersoft"/>
<string id="130" value="uniset"/>
<string id="131" value="1.6"/>
<string id="132" value="http://www.etersoft.ru"/>
<string id="133" value="MBSlave1"/>
</object>
</device>
</MEI>

Диагностические функции (0x08)

Настройка TCPServer

<MBTCPPersistentSlave ....sesscount="">
<clients>
<item ip="" respond="" invert="1" askcount=""/>
<item ip="" respond="" invert="1" askcount=""/>
<item ip="" respond="" invert="1" askcount=""/>
</clients>
</MBTCPPersistentSlave>

По умолчанию если не удалось создать сокет процесс пытается повторять попытки каждые tcpRepeatCreateSocketPause и не вылетает. Но если задан параметр tcpBreakIfFailRun="1", то процессы завершает работу после первой неудачной попытки. Изменить эти параметры можно либо в конфигурационном файле:

<MBTCPPersistentSlave ... tcpBreakIfFailRun="1" tcpRepeatCreateSocket="xxx msec"/>

Либо аргументами командной строки:

MBSlave HTTP API

/help                            - Получение списка доступных команд
/                                - получение стандартной информации
/regs?regs=reg1,reg2,reg3,..&addr=addr1,addr2,addr3  - получение списка регистров
                             Не обязательные параметры:
                               regs - выдать информацию только по указанным регистрам
                               addr - выдать информацию только по указанным адресам устройств