Home Assistant Elk-M1 键盘显示消息 actionelkm1.alarm_display_message完整使用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读elkm1.alarm_display_message是 Home Assistant 中Elk-M1 Control集成提供的 action服务它可以把最多两行文本显示在 Elk-M1 分区area的所有键盘屏幕上并允许你控制消息停留时长、键盘是否鸣响以及消息的清除方式。本文基于 source/_actions/elkm1.alarm_display_message.markdown 编写完整覆盖 UI 图形化操作与 YAML 两种使用方式、全部可选参数的含义与默认值并结合 Elk-M1 Control 集成文档 说明其底层机制与使用前提。读完本文你将能在自动化或脚本中熟练地向 Elk-M1 键盘推送提醒、状态提示或欢迎回家问候语。这个 action 能做什么Alarm display messageaction 会在一个 Elk-M1 分区area的所有键盘上显示最多两行文本。你可以精确控制显示时长消息在屏幕上停留多久甚至永久显示。是否鸣响消息显示时键盘是否发出提示音。清除方式消息到达超时后如何消失、是否允许用户用*键手动清除。典型的使用场景是让自动化在键盘上留下一条便签例如提醒事项如记得倒垃圾系统或安防状态消息回家欢迎问候语理解 action 的目标Targets该 action 需要一个目标target。目标指向的对象可以是单个实体、设备、区域area、楼层floor或标签labelHome Assistant 会对目标背后匹配的alarm_control_panel实体全部执行该 action实体某个具体的alarm_control_panel实体如alarm_control_panel.home。设备属于某设备的所有alarm_control_panel实体。区域某个房间或区域内的所有alarm_control_panel实体。楼层某个楼层上的所有alarm_control_panel实体。标签共享某个标签的所有alarm_control_panel实体。同一 action 内还可以混合多种目标类型例如同时添加一个具体实体和一个区域作为目标让两者一起收到消息。需要说明的是在 Elk-M1 集成中分区areas即传统安防术语中的 partitions被映射为alarm_control_panel实体见 source/_integrations/elkm1.markdown 的 Supported functionality 一节因此该 action 的目标正是这些分区实体。从用户界面UI使用如果你习惯用可视化方式构建自动化和脚本Home Assistant 会逐步引导你完成配置无需编写 YAML进入设置 自动化与场景。打开一个已有的自动化或脚本或者选择创建自动化 创建新自动化。如果是新建自动化先在When当...时部分添加一个触发器脚本不需要触发器脚本在被其他东西调用时运行。在Then do则执行部分选择添加动作。在搜索框中搜索并选择Elk-M1 Control: Alarm display message。选择 Elk-M1 分区然后输入消息文本和所需的选项。点击保存。UI 中的选项选项说明是否必填Line 1第一行文本最多 16 个字符超长部分会被截断。否Line 2第二行文本最多 16 个字符超长部分会被截断。否Clear消息的清除方式0直接清除消息1用*键清除消息2一直显示到超时。否Beep消息显示时键盘是否鸣响。否Timeout消息显示时长秒。使用0表示永久显示最大值为 65535。否在 YAML 中使用如果你直接编写 YAML或者想确切知道 Home Assistant 底层做了什么可以参考本节的字段名、类型与必填信息。在 YAML 中该 action 的名称为elkm1.alarm_display_message。基本示例如下action: elkm1.alarm_display_message target: entity_id: alarm_control_panel.home data: line1: Welcome home line2: Have a great day这段配置会在目标分区的键盘上显示两行消息并保持到超时结束。YAML 选项参考字段类型默认值必填说明line1string否第一行文本最多 16 个字符超长部分会被截断。line2string否第二行文本最多 16 个字符超长部分会被截断。clearinteger2否消息清除方式0直接清除1用*键清除2显示到超时。beepbooleanfalse否消息显示时键盘是否鸣响。timeoutinteger0否显示时长秒0表示永久显示最大 65535。参数要点16 字符上限Elk-M1 键盘屏幕的每行显示能力受 ASCII 协议限制超过 16 个字符的文本会被截断规划消息文案时应控制长度。timeout的0含义0表示永久显示而不是立即消失这一点容易混淆最大可设为 65535 秒约 18.2 小时。clear与timeout的配合当clear为2时消息按timeout设置的时长显示若将clear设为0或1则可在超时前主动清除或允许用户按键清除。底层原理与使用前提协议与实现Elk-M1 集成遵循 Elk Products 的 ElkM1 ASCII Protocol Interface Specification, Revision 1.84 文档实现见 source/_integrations/elkm1.markdown。键盘显示消息功能正是通过该 ASCII 协议下发到面板再由面板分发到各键盘显示。因此集成可同时支持Elk-M1 Gold和EZ8型号面板。分区area以alarm_control_panel实体呈现这也是该 action 的目标实体类型。面板上的键盘变更状态由Global Setting 40 Transmit Keypad Changes控制启用它才能跟踪键盘变化和报警状态而system_trouble_status状态列表中本身就包含 Display Message In Keypad Line 1 和 Display Message In Keypad Line 2 两项说明键盘消息也是面板可上报的系统事件之一。目标实体从哪来要让alarm_control_panel.home这样的目标存在你需要先通过设置 设备与服务完成 Elk-M1 集成配置支持配置流或在configuration.yaml中手动配置例如elkm1: - host: elks://IP_ADDRESS username: USERNAME password: PASSWORD连接方式支持elk://非加密、elks://TLS 1.0 加密、elksv1_2://TLS 1.2 加密以及serial://串口等。配置完成后分区会自动或按 include/exclude 规则生成alarm_control_panel实体。相关 action 组合使用键盘显示消息可以与 Elk-M1 的语音播报 action 搭配形成看得见 听得到的提醒组合相关定义见 source/_actions/elkm1.alarm_display_message.markdown 的related_actions字段elkm1.speak_phrase通过面板语音输出播放一条预置短语Phrase number 范围 0~999。elkm1.speak_word播报自定义词语。例如一个回家欢迎自动化可以同时调用elkm1.alarm_display_message显示问候语、调用elkm1.speak_phrase发出语音问候。快速试运行想立即验证效果打开设置 工具 操作Actions搜索该 action填写字段并点击执行操作无需编写一行 YAML 即可在真实的alarm_control_panel实体上看到效果。注意该操作会把消息真正推送到实体键盘请选择合适的分区进行测试。遇到问题怎么办确认 Elk-M1 集成已正确配置且面板在线参考 source/_integrations/elkm1.markdown 的配置章节与system_trouble_status排查面板问题。确认目标alarm_control_panel实体存在且归属于你要显示消息的分区。若消息没有出现或行为异常可开启集成调试日志定位问题在configuration.yaml中添加logger: logs: elkm1_lib: debug homeassistant.components.elkm1: debug然后重启 Home Assistant在homeassistant.log位于 Home Assistantconfig目录中查看调试输出。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant Elk-M1 键盘显示消息 action（elkm1.alarm_display_message）完整使用指南
Home Assistant Elk-M1 键盘显示消息 actionelkm1.alarm_display_message完整使用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读elkm1.alarm_display_message是 Home Assistant 中Elk-M1 Control集成提供的 action服务它可以把最多两行文本显示在 Elk-M1 分区area的所有键盘屏幕上并允许你控制消息停留时长、键盘是否鸣响以及消息的清除方式。本文基于 source/_actions/elkm1.alarm_display_message.markdown 编写完整覆盖 UI 图形化操作与 YAML 两种使用方式、全部可选参数的含义与默认值并结合 Elk-M1 Control 集成文档 说明其底层机制与使用前提。读完本文你将能在自动化或脚本中熟练地向 Elk-M1 键盘推送提醒、状态提示或欢迎回家问候语。这个 action 能做什么Alarm display messageaction 会在一个 Elk-M1 分区area的所有键盘上显示最多两行文本。你可以精确控制显示时长消息在屏幕上停留多久甚至永久显示。是否鸣响消息显示时键盘是否发出提示音。清除方式消息到达超时后如何消失、是否允许用户用*键手动清除。典型的使用场景是让自动化在键盘上留下一条便签例如提醒事项如记得倒垃圾系统或安防状态消息回家欢迎问候语理解 action 的目标Targets该 action 需要一个目标target。目标指向的对象可以是单个实体、设备、区域area、楼层floor或标签labelHome Assistant 会对目标背后匹配的alarm_control_panel实体全部执行该 action实体某个具体的alarm_control_panel实体如alarm_control_panel.home。设备属于某设备的所有alarm_control_panel实体。区域某个房间或区域内的所有alarm_control_panel实体。楼层某个楼层上的所有alarm_control_panel实体。标签共享某个标签的所有alarm_control_panel实体。同一 action 内还可以混合多种目标类型例如同时添加一个具体实体和一个区域作为目标让两者一起收到消息。需要说明的是在 Elk-M1 集成中分区areas即传统安防术语中的 partitions被映射为alarm_control_panel实体见 source/_integrations/elkm1.markdown 的 Supported functionality 一节因此该 action 的目标正是这些分区实体。从用户界面UI使用如果你习惯用可视化方式构建自动化和脚本Home Assistant 会逐步引导你完成配置无需编写 YAML进入设置 自动化与场景。打开一个已有的自动化或脚本或者选择创建自动化 创建新自动化。如果是新建自动化先在When当...时部分添加一个触发器脚本不需要触发器脚本在被其他东西调用时运行。在Then do则执行部分选择添加动作。在搜索框中搜索并选择Elk-M1 Control: Alarm display message。选择 Elk-M1 分区然后输入消息文本和所需的选项。点击保存。UI 中的选项选项说明是否必填Line 1第一行文本最多 16 个字符超长部分会被截断。否Line 2第二行文本最多 16 个字符超长部分会被截断。否Clear消息的清除方式0直接清除消息1用*键清除消息2一直显示到超时。否Beep消息显示时键盘是否鸣响。否Timeout消息显示时长秒。使用0表示永久显示最大值为 65535。否在 YAML 中使用如果你直接编写 YAML或者想确切知道 Home Assistant 底层做了什么可以参考本节的字段名、类型与必填信息。在 YAML 中该 action 的名称为elkm1.alarm_display_message。基本示例如下action: elkm1.alarm_display_message target: entity_id: alarm_control_panel.home data: line1: Welcome home line2: Have a great day这段配置会在目标分区的键盘上显示两行消息并保持到超时结束。YAML 选项参考字段类型默认值必填说明line1string否第一行文本最多 16 个字符超长部分会被截断。line2string否第二行文本最多 16 个字符超长部分会被截断。clearinteger2否消息清除方式0直接清除1用*键清除2显示到超时。beepbooleanfalse否消息显示时键盘是否鸣响。timeoutinteger0否显示时长秒0表示永久显示最大 65535。参数要点16 字符上限Elk-M1 键盘屏幕的每行显示能力受 ASCII 协议限制超过 16 个字符的文本会被截断规划消息文案时应控制长度。timeout的0含义0表示永久显示而不是立即消失这一点容易混淆最大可设为 65535 秒约 18.2 小时。clear与timeout的配合当clear为2时消息按timeout设置的时长显示若将clear设为0或1则可在超时前主动清除或允许用户按键清除。底层原理与使用前提协议与实现Elk-M1 集成遵循 Elk Products 的 ElkM1 ASCII Protocol Interface Specification, Revision 1.84 文档实现见 source/_integrations/elkm1.markdown。键盘显示消息功能正是通过该 ASCII 协议下发到面板再由面板分发到各键盘显示。因此集成可同时支持Elk-M1 Gold和EZ8型号面板。分区area以alarm_control_panel实体呈现这也是该 action 的目标实体类型。面板上的键盘变更状态由Global Setting 40 Transmit Keypad Changes控制启用它才能跟踪键盘变化和报警状态而system_trouble_status状态列表中本身就包含 Display Message In Keypad Line 1 和 Display Message In Keypad Line 2 两项说明键盘消息也是面板可上报的系统事件之一。目标实体从哪来要让alarm_control_panel.home这样的目标存在你需要先通过设置 设备与服务完成 Elk-M1 集成配置支持配置流或在configuration.yaml中手动配置例如elkm1: - host: elks://IP_ADDRESS username: USERNAME password: PASSWORD连接方式支持elk://非加密、elks://TLS 1.0 加密、elksv1_2://TLS 1.2 加密以及serial://串口等。配置完成后分区会自动或按 include/exclude 规则生成alarm_control_panel实体。相关 action 组合使用键盘显示消息可以与 Elk-M1 的语音播报 action 搭配形成看得见 听得到的提醒组合相关定义见 source/_actions/elkm1.alarm_display_message.markdown 的related_actions字段elkm1.speak_phrase通过面板语音输出播放一条预置短语Phrase number 范围 0~999。elkm1.speak_word播报自定义词语。例如一个回家欢迎自动化可以同时调用elkm1.alarm_display_message显示问候语、调用elkm1.speak_phrase发出语音问候。快速试运行想立即验证效果打开设置 工具 操作Actions搜索该 action填写字段并点击执行操作无需编写一行 YAML 即可在真实的alarm_control_panel实体上看到效果。注意该操作会把消息真正推送到实体键盘请选择合适的分区进行测试。遇到问题怎么办确认 Elk-M1 集成已正确配置且面板在线参考 source/_integrations/elkm1.markdown 的配置章节与system_trouble_status排查面板问题。确认目标alarm_control_panel实体存在且归属于你要显示消息的分区。若消息没有出现或行为异常可开启集成调试日志定位问题在configuration.yaml中添加logger: logs: elkm1_lib: debug homeassistant.components.elkm1: debug然后重启 Home Assistant在homeassistant.log位于 Home Assistantconfig目录中查看调试输出。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考