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

Текущая версия от 16:22, 16 октября 2024

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

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

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

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

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

{
  "devices":
  [
    {
      "active": true,
      "id": "myCustomDevice1",
      "name": "My Custom Device",
      "real": false,
      "cloud": true,
      "discovery": true,
      "exposes":
      [
        ...
      ],
      "options":
      {
        ...
      }
    },
    {
      "active": true,
      "id": "myCustomDevice2",
      "name": "Other Custom Device",
      "real": true,
      "cloud": true,
      "discovery": true,
      "exposes":
      [
        ...
      ]
    }
  ]
}

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

`active`

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

`id`

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

`name`

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

`real`

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

`cloud`

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

`discovery`

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

`exposes`

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

`options`

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

@@ Строка 55: / Строка 55: @@
 === <code>real</code> ===
+Если значение этого поля установлено как <code class="value">false</code>, устройство будет считаться виртуальным и данные из топика <code class="value">homed/td/custom/...</code> будут автоматически дублироваться в топик <code class="value">homed/fd/custom/...</code>, в противном случае сервис будет ожидать данных от реального устройства или другого сервиса. Подробнее о топиках можно почитать [[Custom/Topics|здесь]].
 === <code>cloud</code> ===
+Включение/выключение проброса устройств в [https://alice.yandex.ru/smart-home Умный Дом Яндкса] при помощи [[Cloud|HOMEd Cloud]].
 === <code>discovery</code> ===
+Включение/выключение функуии [https://www.home-assistant.io/integrations/mqtt/#mqtt-discovery Home Assistant MQTT Discovery] для устройства.
 === <code>exposes</code> ===
+Массив [[Common/Exposes|способностей]] устройства.
 === <code>options</code> ===
+Объект с [[Common/Options|опциями]] устройства.
 [[Category:Custom]]