2025.3.4
首页 ▸ Integrations ▸

MQTT 标签扫描器

mqtt 标签扫描器平台使用 MQTT 消息有效载荷来生成标签扫描事件。

配置

MQTT 扫描器仅通过 MQTT 发现 支持，不支持通过 configuration.yaml 的手动设置。 发现主题需要为：<discovery_prefix>/tag/[<node_id>/]<object_id>/config。

Configuration Variables

Looking for your configuration file?
topic string Required

订阅以接收标签扫描事件的 MQTT 主题。

value_template template (Optional)

Defines a template that returns a tag ID.

device map Required

关于此设备触发器所属于的设备的信息，以便将其与 设备注册表 关联。必须至少存在一个标识符或连接以识别该设备。

configuration_url string (Optional)

可管理该设备配置的网页链接。可以是 http://、https:// 或内部 homeassistant:// URL。

connections list (Optional)

设备与外界的连接列表，作为元组的列表 [connection_type, connection_identifier]。例如网络接口的 MAC 地址："connections": [["mac", "02:5b:26:a8:dc:12"]]。

hw_version string (Optional)

设备的硬件版本。

identifiers list | string (Optional)

唯一识别设备的 ID 列表。例如序列号。

manufacturer string (Optional)

设备的制造商。

model string (Optional)

设备的型号。

model_id string (Optional)

设备的型号标识符。

name string (Optional)

设备的名称。

serial_number string (Optional)

设备的序列号。

suggested_area string (Optional)

如果设备尚未在某个区域中，请建议一个区域。

sw_version string (Optional)

设备的固件版本。

via_device string (Optional)

在该设备和 Home Assistant 之间路由消息的设备标识符。这类设备的示例包括集线器或子设备的主设备。这用于在 Home Assistant 中显示设备拓扑。

示例

在本节中，您将找到一些关于如何使用此传感器的真实例子。

使用从 JSON 数据中提取的标签 ID 的完整配置

这是一个配置示例，其中标签 ID 是从 JSON 格式的 MQTT 消息中提取的。 要进行测试，您可以使用与 mosquitto 一起提供的命令行工具 mosquitto_pub 或 mosquitto-clients 包来发送 MQTT 消息。

发现标签扫描器：

mosquitto_pub -h 127.0.0.1 -t homeassistant/tag/0AFFD2/config -m '{"topic": "0AFFD2/tag_scanned", "value_template": "{{ value_json.PN532.UID }}"}'

生成标签扫描事件：

mosquitto_pub -h 127.0.0.1 -t 0AFFD2/tag_scanned -m '{"Time":"2020-09-28T17:02:10","PN532":{"UID":"E9F35959", "DATA":"ILOVETASMOTA"}}'