Дополнения к документации

[glebsterx]

В чате искать неудобно, надо тут оформить все предложения по добавлению в оф. документацию.
Я начну:

1. Удаление режима реализуется так

      modes:
        program: 
          low: [x]

2. кейс с двумя ХА (в разных сетях, дом и дача например) и одним акком -- в чате раз в неделю всплывает.
   Описать варианты решения

• прямое + облако
• прямое + прямое
• Remote home assistant

3. Новшества в ХА -- действия которые раньше были сервисами -- надо или апдейт полный или примечание сделать

[glebsterx]

Коллеги пишут:
Для продвинутых - Пользовательские умения - custom_ranges
во всех примерах даётся вот такой вид конфига, где entity_id стоит в одном ряду с service и data

 set_value:
   service: xiaomi_miio_airpurifier.fan_set_favorite_speed
   entity_id: fan.xiaomi_airfresh_a1
   data:
     speed: '{{ value }}'

но это не работает. Потом в рецептах посмотрел в конце, и там нужно писать target:

 set_value:
   service: xiaomi_miio_airpurifier.fan_set_favorite_speed
   target:
     entity_id: fan.xiaomi_airfresh_a1
   data:
     speed: '{{ value }}'

и вот это уже работает.

Я думаю насчет этого -- на самом деле раньше (не помню до какой версии) никакого target не было в вызовах служб(нынче действия или как там они)
ХА постоянное меняется конечно, но для обратной совместимости вроде как работали оба варианта -- возможно для каких-то обновленных интеграций или особых фич нужно писать именно с таргетом...

[Enzokot]

Небольшое дополнение. Начиная с версии НА 2024.10 ключевое слово service заменено на action, обратную совместимость оставили, но новички в НА, изучая документацию будут видеть именно action во всех примерах. Предлагаю привести к единому виду с НА.

[dext0r]

начиная с версии НА 2024.10

Начиная с 2024.8 :)

Предлагаю привести к единому виду с НА.

Проблема в том, что компонент поддерживает версии HA до 2024.8. Для 0.6.х оставим всё как есть, а для 1.0 (которая я надеюсь когда нибудь выйдет :)) уже будет action

[Enzokot]

Начиная с 2024.8 :)

да, ошибся, главное мысль донес

Для 0.6.х оставим всё как есть

по аналогии с обратной совместимостью НА будет сложно в реализации?

[dext0r]

по аналогии с обратной совместимостью НА будет сложно в реализации?

Не совсем понял вопрос. Сейчас можно использовать и service и action, так как используются встроенные в HA схемы для работы с YAML конфигураций, и они уже сами всё учитывают и преобразовывают как надо. Другими словами - можно использовать service пока его HA окончательно незадеприкейтит.

[Enzokot]

можно использовать и service и action

видимо мой прошлый подход к конфигу УДЯ был неудачный, автозамена сломала вызовы некоторых скриптов с параметрами (в имени параметров присутствует слово service), поэтому у меня отложилось, что сам компонент ожидает наличие ключевого слова service. сейчас более внимательно внес изменения, все работает.

[glebsterx]

на всякий случай в качестве уточнения надо бы дописать в раздел траблшутинга "устройство не появляется в удя":

состояние устройства unavailable (и прочие недоступные) приводит к игнорированию устройства в списке

устройство нужно подключить к питанию / сделать доступным в ХА (на момент обновления списка), чтобы оно "прокинулось" в удя - дальше можно отключить -- удя уже будет знать о нем по entity_id и понимать его недоступное состояние

[dext0r]

8d03737

[dext0r]

В чате искать неудобно, надо тут оформить все предложения по добавлению в оф. документацию. Я начну:

1. Удаление режима реализуется так

Будет переделано #557 и описано в доке

2. кейс с двумя ХА (в разных сетях, дом и дача например) и одним акком -- в чате раз в неделю всплывает.
   Описать варианты решения

• прямое + облако
• прямое + прямое
• Remote home assistant

Будет не актуально в версии 1.0 (#427 #479)

[dext0r]

Эту дискуссию закрою, если есть что добавить - #504