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

Материал из HOMEd Wiki
(Новая страница: «{{DISPLAYTITLE:Modbus: База данных}} {{Breadcrumbs|Modbus > База данных}} == Файл базы данных == База данных это файл, в котором хранится описание устройств. По умолчанию это <code>/opt/homed-modbus/database.json</code>. Путь к файлу базы данных может быть изменен в конфигурации. Не...»)
 
Строка 13: Строка 13:
     {
     {
       "active": true,
       "active": true,
       "id": "myCustomDevice1",
       "baudRate": 115200,
      "name": "My Custom Device",
      "real": false,
       "cloud": true,
       "cloud": true,
       "discovery": true,
       "discovery": false,
       "exposes":
       "name": "Relay Controller",
       [
       "pollInterval": 1000,
        ...
      "portId": 1,
       ],
       "replyTimeout": 5,
       "options":
       "requestTimeout": 1000,
       {
       "slaveId": 11,
        ...
       "type": "homedRelayController"
       }
     },
     },
     {
     {
       "active": true,
       "active": true,
       "id": "myCustomDevice2",
       "baudRate": 115200,
      "name": "Other Custom Device",
       "cloud": false,
      "real": true,
       "cloud": true,
       "discovery": true,
       "discovery": true,
       "exposes":
       "name": "Custom Controller",
      "pollInterval": 1000,
      "portId": 2,
      "replyTimeout": 10,
      "requestTimeout": 1000,
      "slaveId": 25,
      "type": "customController",
      "items":
       [
       [
         ...
         ...
       ],
       ],
       "bindings":
       "options":
       {
       {
         ...
         ...
       },
       }
      "availabilityTopic": "myCustomDevice/isOnline",
      "availabilityPattern": "{{ online if value == true else offline }}"
     }
     }
   ]
   ]

Версия от 10:46, 24 марта 2025

HOMEd > Modbus > База данных

Файл базы данных

База данных это файл, в котором хранится описание устройств. По умолчанию это /opt/homed-modbus/database.json. Путь к файлу базы данных может быть изменен в конфигурации. Не обязательно редактировать базу данных автоматизаций вручную, намного проще настраивать устройства через веб-интерфейс.

Структура базы данных

База данных HOMEd Modbus это JSON-объект. Общая структура базы данных выглядит так:

{
  "devices":
  [
    {
      "active": true,
      "baudRate": 115200,
      "cloud": true,
      "discovery": false,
      "name": "Relay Controller",
      "pollInterval": 1000,
      "portId": 1,
      "replyTimeout": 5,
      "requestTimeout": 1000,
      "slaveId": 11,
      "type": "homedRelayController"
    },
    {
      "active": true,
      "baudRate": 115200,
      "cloud": false,
      "discovery": true,
      "name": "Custom Controller",
      "pollInterval": 1000,
      "portId": 2,
      "replyTimeout": 10,
      "requestTimeout": 1000,
      "slaveId": 25,
      "type": "customController",
      "items":
      [
        ...
      ],
      "options":
      {
        ...
      }
    }
  ]
}

Параметры устройств

active

Включение/выключение устройства.

id

Уникальный идентификатор устройства.

name

Уникальное читаемое имя устройства.

real

Если значение этого поля установлено как false, устройство будет считаться виртуальным и данные из топика homed/td/custom/... будут автоматически дублироваться в топик homed/fd/custom/..., в противном случае сервис будет ожидать данных от реального устройства или другого сервиса.

cloud

Включение/выключение проброса устройств в Умный дом Яндкса при помощи HOMEd Cloud.

discovery

Включение/выключение функуии Home Assistant MQTT Discovery для устройства.

exposes

Массив способностей устройства.

options

Объект с опциями устройства.

bindings

Объект с биндингами устройства. Актуально только для устройств с включенным параметром real.

availabilityTopic

MQTT-топик для определения доступности устройства. Если этот параметр отсутствует, устройство всегда будет считаться доступным. Актуально только для устройств с включенным параметром real.

availabilityPattern

Шаблон для определения доступности устройства. Шаблон должен возвращать строку "online" в случае, если устройство доступно, иначе устройство будет считаться недоступным. Подробнее о шаблонах можно почитать здесь. Актуально только для устройств с включенным параметром real.