mqtt statestream
这mqtt_stateTream
Integration发布了单个MQTT主题的家庭助理的状态变化。必威是什么MQTT集成是MQTT Statestream工作的先决条件。
配置
要在家庭助理中启用MQTT Statestream,请在您的必威是什么configuration.yaml
文件:
#示例Configuration.yaml条目mqtt_stateTream:base_topic:乡亲publish_attributes:真的Publish_timestamps:真的
配置过滤器
默认情况下,不会排除任何实体。限制哪些实体被暴露于mqtt statestream
,您可以使用包括
和排除
参数。
#示例过滤器要包括指定域并排除指定的实体mqtt_stateTream:base_topic:乡亲包括:域:-alarm_control_panel-光entity_globs:-binary_sensor。*_占用排除:实体:-light.kitchen_light
过滤器的应用如下:
- 否包括或排除 - 通过所有实体
- 包括,不排除 - 仅包括指定实体
- 排除,否包括 - 仅排除指定实体
- 两者都包括和排除:
- 包括指定的域和/或球形图案
- 如果包括域,并且不排除或匹配实体,则通过
- 如果实体匹配包括球形模式,并且实体与任何排除条件(域,全球模式或列出)不匹配,则通过
- 如果不包括域,则全球模式不匹配,并且不包括实体,则失败
- 排除指定的域和/或全球模式,包括不列出域或球模式
- 如果排除域并且不包括实体,则失败
- 如果实体匹配不包括球模式和未包括的实体,则失败
- 如果实体与任何排除条件不匹配(域,全球模式或列出),请通过
- 不包括或排除指定域或球模式
- 如果包括实体,请通过(如上#2)
- 如果实体包括和排除实体,则将忽略实体排除
- 包括指定的域和/或球形图案
常见的过滤示例
#排除实体的示例mqtt_stateTream:base_topic:乡亲排除:域:-转变实体:-传感器
在上面的示例中,除了switch.x和传感器将出版给MQTT。
#排除实体的示例mqtt_stateTream:base_topic:乡亲包括:域:-传感器实体:-锁。重要
在此示例中,只有传感器和锁。重要将出版。
#排除实体的示例mqtt_stateTream:base_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_updated
和homeassistant/light/master_bedroom_dimmer/last_changed
, 分别。时间戳为ISO 8601格式 - 例如,2017-10-01T23:20:30.920969+00:00
。