mqtt statestream


mqtt_stateTreamIntegration发布了单个MQTT主题的家庭助理的状态变化。必威是什么MQTT集成是MQTT Statestream工作的先决条件。

配置

要在家庭助理中启用MQTT Statestream,请在您的必威是什么configuration.yaml文件:

#示例Configuration.yaml条目mqtt_stateTreambase_topic乡亲publish_attributes真的Publish_timestamps真的

配置变量

base_topic 细绳 必需的

基本主题用于生成用于发布的实际主题。

publish_attributes 布尔 ((选修的,默认:false

发布实体和国家的属性。

Publish_timestamps 布尔 ((选修的,默认:false

为实体发布last_changed和last_upded时间戳。

排除 列表 ((选修的

配置应排除哪些集成。((配置过滤器

实体 列表 ((选修的

从录音中排除的实体ID列表。

entity_globs 列表 ((选修的

排除所有与录音中列出的模式匹配的实体(例如,传感器。天气_*)。

列表 ((选修的

从录音中排除的域列表。

包括 列表 ((选修的

配置录音中应包含哪些集成。如果设置,将不会记录所有其他实体。((配置过滤器

实体 列表 ((选修的

从录音中包含的实体ID列表。

entity_globs 列表 ((选修的

在录音中包括所有与列出模式匹配的实体(例如,传感器。天气_*)。

列表 ((选修的

从录音中包含的域列表。

配置过滤器

默认情况下,不会排除任何实体。限制哪些实体被暴露于mqtt statestream,您可以使用包括排除参数。

#示例过滤器要包括指定域并排除指定的实体mqtt_stateTreambase_topic乡亲包括-alarm_control_panel-entity_globs-binary_sensor。*_占用排除实体-light.kitchen_light

过滤器的应用如下:

  1. 否包括或排除 - 通过所有实体
  2. 包括,不排除 - 仅包括指定实体
  3. 排除,否包括 - 仅排除指定实体
  4. 两者都包括和排除:
    • 包括指定的域和/或球形图案
      • 如果包括域,并且不排除或匹配实体,则通过
      • 如果实体匹配包括球形模式,并且实体与任何排除条件(域,全球模式或列出)不匹配,则通过
      • 如果不包括域,则全球模式不匹配,并且不包括实体,则失败
    • 排除指定的域和/或全球模式,包括不列出域或球模式
      • 如果排除域并且不包括实体,则失败
      • 如果实体匹配不包括球模式和未包括的实体,则失败
      • 如果实体与任何排除条件不匹配(域,全球模式或列出),请通过
    • 不包括或排除指定域或球模式
      • 如果包括实体,请通过(如上#2)
      • 如果实体包括和排除实体,则将忽略实体排除

常见的过滤示例

#排除实体的示例mqtt_stateTreambase_topic乡亲排除-转变实体-传感器

在上面的示例中,除了switch.x传感器将出版给MQTT。

#排除实体的示例mqtt_stateTreambase_topic乡亲包括-传感器实体-锁。重要

在此示例中,只有传感器锁。重要将出版。

#排除实体的示例mqtt_stateTreambase_topic乡亲包括-传感器排除实体-传感器

在此示例中,除了传感器将出版。

手术

当任何家庭助理实体必威是什么更改时,此集成将发布到MQTT。

每个实体的主题都是不同的,因此您可以轻松地将其他系统订阅到您感兴趣的实体。该主题将以形式base_topic/域/实体/状态

例如,在上面的示例配置中,如果已打开一个称为“ light.master_bedroom_dimmer”的实体,则此集成将发布乡亲/灯/灯/master_bedroom_dimmer/state

如果该实体也具有称为的属性亮度,集成还将将该属性的值发布到乡亲/光/master_bedroom_dimmer/亮度

在发布之前,所有状态和属性都通过JSON序列化传递。请注意这导致引用字符串(例如,“ ON”字符串将以“ on”为“ on”)。您可以通过使用value_json代替价值

实体的最后一个_updated和last_changed值将发布到homeassistant/light/master_bedroom_dimmer/last_updatedhomeassistant/light/master_bedroom_dimmer/last_changed, 分别。时间戳为ISO 8601格式 - 例如,2017-10-01T23:20:30.920969+00:00

Baidu