Modbus/Database/Items: различия между версиями

Версия от 11:22, 24 марта 2025

HOMEd > Modbus > База данных > Карта регистров

Общие сведения

Карта регистров позволяет описывать схему данных для любых устройств, не выходящих за рамки стандарта Modbus. Карта регистров описывается как массив JSON-объектов, каждый элемент которого добавляет соответствующую способность. Структура описания биндингов выглядит так:

{
  ...
  "type": "customController",
  "items":
  [
    {
      "address": 110,
      "registerType": "holding",
      "dataType": "u16",
      "byteOrder": "be",
      "divider": 0.01,
      "expose": "myMumber",
      "type": "value",
      "read": true
    },
    {
      "address": 2,
      "registerType": "status",
      "expose": "myBinarySensor",
      "type": "enum",
      "read": true
    }
  ]
  ...
}

Карта регистров работает только для устройств типа "customController". Карта регистров поддерживает только типовые способности устройств. Специальные способности не поддерживаются.

Параметры регистров

`address`

Адрес регистра в десятичном формате.

`registerType`

Тип регистра. Возможные значения:

coil (функции 1 и 5)
status (функция 2)
holding (функции 3, 6 и 16)
input (функция 4)

`outTopic`

MQTT-топик, который необходимо опубликовать для изменения состояния описываемого свойства. Является обязательным в случае, если отсутствует параметр inTopic.

`outPattern`

Шаблон для передечи состояния описываемого свойства в топик outTopic. В случае отсутствия этого параметра данные будут опубликованы без изменений. Подробнее в разделе шаблоны.

@@ Строка 38: / Строка 38: @@
 Адрес регистра в десятичном формате.
-=== <code>inPattern</code> ===
+=== <code>registerType</code> ===
-Шаблон для получения состояния описываемого свойства из топика <code>inTopic</code>. В случае отсутствия этого параметра, данные будут использованы без изменений. Подробнее в разделе [[Custom/Database/Bindings#Шаблоны|шаблоны]].
+Тип регистра. Возможные значения:
+* <code class="value">coil</code> (функции 1 и 5)
+* <code class="value">status</code> (функция 2)
+* <code class="value">holding</code> (функции 3, 6 и 16)
+* <code class="value">input</code> (функция 4)
 === <code>outTopic</code> ===