Home Assistant Velbusset_memo_text动作实战在总线模块显示屏上推送自定义文本【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文聚焦 Home Assistant 中 Velbus 集成的velbus.set_memo_text服务动作即 UI 中的 Velbus: Set memo text。读完本文你将掌握如何通过可视化界面和 YAML 两种方式向带显示屏的 Velbus 模块VMBGPO、VMBGPOD、VMBELO发送备注文本理解全部三个参数Config entry、Address、Memo text的取值与必填规则并了解它与velbus.sync_clock、velbus.scan、velbus.clear_cache等相关动作的配合关系。动作用途把文字推到 Velbus 模块屏幕上velbus.set_memo_text的作用是在 Velbus 模块的显示屏上显示备注文本memo text。适用对象是总线中具备显示能力的模块官方文档明确列出了三类典型硬件VMBGPO带显示屏的通用输入/继电器模块VMBGPOD在 GPO 基础上支持 DALI 控制的版本VMBELO带显示屏的入口模块。一个关键前提这些模块的页面page必须在 VelbusLink 软件中配置为显示 memo text否则即便动作执行成功屏幕也不会有对应输出。这一点在原始文档 velbus.set_memo_text 开头即有说明Make sure the module pages are configured to display the memo text.该动作不支持 targets目标在 UI 中执行时系统不会提示你选择区域area、设备device、实体entity或标签label因为它面向的是某个连接上的某个总线地址而不是某个 Home Assistant 实体。通过可视化界面配置动作完整的 UI 操作步骤继承自原文档进入SettingsAutomations scenes自动化与场景页面。打开一个已有的自动化或脚本或者选择Create automationCreate new automation。如果是新建自动化需要在When部分添加触发条件脚本则不需要触发器它由其他调用方触发执行。在Then do部分选择Add action。搜索并选择Velbus: Set memo text。选择Config entry要使用的 Velbus 连接输入模块Address地址和要显示的Memo text备注文本。点击Save保存。选择多个 Velbus 连接时通过 Config entry 区分目标总线这与下面 YAML 方式中的config_entry字段一一对应。参数详解原始文档同时给出了 UI 与 YAML 两套参数说明二者含义一致。完整参数表如下其中type列来自 YAML 参数定义参数类型必填说明config_entrystring是要发送命令的 Velbus 连接config entry ID。addressinteger是模块地址使用十进制格式。十进制地址显示在集成页面所列每个模块的前面。memo_textstring否要显示的文本长度上限 64 个字符。留空时会清除当前显示的 memo text。几个实操要点address必须是十进制整数integer这与同域的velbus.clear_cache动作的 Address 参数保持同一约定。十进制地址可以在 Velbus 集成页面查看——模块列表中每个模块名称前显示的数字即是。memo_text的双向语义填入文本即上屏置空即清屏。这意味着同一个动作既能推消息也能撤消息例如用一次自动化推垃圾日提示再用一次定时任务把它清空。64 字符的限制是文档明确的硬上限写长文本时应自行截断或改用多屏轮播思路分多次调用。YAML 完整示例在 YAML 中该动作的引用名为velbus.set_memo_text。原文档给出的标准示例action: action: velbus.set_memo_text data: config_entry: 01JGE8XB3MNPZFA836TTZ3KZ46 address: 65 memo_text: Its trash day执行后地址为 65 的模块显示屏上会呈现 Its trash day。将其放进一个完整自动化中的写法触发方式可按需替换alias: Trash day reminder on Velbus display triggers: - trigger: time at: 07:00:00 actions: - action: velbus.set_memo_text data: config_entry: 01JGE8XB3MNPZFA836TTZ3KZ46 address: 65 memo_text: Its trash day其中config_entry的取值是 config entry IDULID 字符串可在 Home Assistant 的集成页面或对应连接的诊断信息中获取示例中的address: 65必须替换为你设备上目标模块的十进制地址。相关动作同域命令的组合使用velbus.set_memo_text的 front matter 中声明了三个相关动作它们共同构成 Velbus 域的维护命令族值得在排障或运维自动化中一起了解动作作用关键参数velbus.sync_clock将总线中各 Velbus 模块的时钟同步到 Home Assistant 的系统时钟等效于 VelbusLink 软件中的Sync clock按钮。仅config_entryvelbus.scan扫描总线上的 Velbus 模块。在日志出现未知模块告警、或新增模块后运行等效于 VelbusLink 软件中的Scan按钮。仅config_entryvelbus.clear_cache清除 Velbus 缓存并启动一次新扫描。当你用 VelbusLink 软件修改过配置时建议执行可传address只清单个模块留空则清全部。config_entry 可选address例如一个合理的运维序列是用 VelbusLink 调整完模块配置 → 执行velbus.clear_cache让 Home Assistant 重新加载配置 → 执行velbus.scan确认总线拓扑 → 再执行velbus.set_memo_text向带屏模块推送新提示。这四个动作都不支持 targets参数面都极小非常适合直接编排进脚本。前置条件Velbus 集成本身set_memo_text依赖 Velbus 集成hub 类型已成功建立连接。根据 Velbus 集成文档该集成自 Home Assistant 0.50 起可用支持三种物理连接方式Velbus USBUSB 接口直接插在 Home Assistant 主机上配置流程中接口会被自动检测并列出Velbus 串口serialVelbus TCP/IP 网关需要填写host、port以及按需启用tls、提供password。文档给出了三类典型网关的参数示例signumTLS端口 27015、velser无 TLS端口 6000、Home Assistant 附加组件端口默认 27015。连接成功后集成会执行一次连接测试随后进入模块发现环节可以选择导入从 VelbusLink 导出的 VLP 配置文件vlp参数指定路径直接生成全部设备与实体或者跳过导入让集成执行总线扫描——文档明确提示扫描方式不如使用 VLP 文件可靠。另外两点与本文动作直接相关的背景事实来自集成文档集成是事件驱动的模块状态变化会被主动推送到 Home Assistant因此把set_memo_text挂到传感器/状态触发器上可以做到事件即上屏。集成的已知限制是不会重刷reprogramVelbus 模块协议未实现的所有修改必须通过 VelbusLink 软件完成——这正呼应了模块页面需预先配置为显示 memo text这一前提。排障提示结合 集成文档的 Troubleshooting 章节当set_memo_text执行后屏幕无反应时可以按以下顺序排查地址是否正确确认address是该模块的十进制地址且该模块属于所选config_entry对应的连接多总线部署时选错连接是常见错误。页面配置确认模块的显示页面已配置为输出 memo text需通过 VelbusLink 软件设置。模块是否被集成识别若新增模块后未被识别运行 velbus.scan若曾通过 VelbusLink 修改过配置先运行 velbus.clear_cache 让缓存失效再重建。连接层问题若报 Unable to setup Velbus按文档建议检查 USB 接口是否被其他程序如 VelbusLink占用、TCP/IP 网关的 IP/端口与防火墙设置。开启调试日志更多细节可通过 Home Assistant 的调试日志功能获取集成文档指向了通用的调试日志说明。小结velbus.set_memo_text是一个参数面很小、语义却很实用的 Velbus 域服务一次调用即可把最多 64 字符的文本推送到 VMBGPO/VMBGPOD/VMBELO 等带屏模块的显示页置空则清屏。UI 与 YAML 两条路径的参数完全对齐config_entry、address必填memo_text可选配合同域的scan、sync_clock、clear_cache可以覆盖发现—同步—展示—维护的完整操作闭环。原始文档位于 source/_actions/velbus.set_memo_text.markdown配套的三个相关动作文档与 Velbus 集成页面 可作为延伸阅读。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant Velbus `set_memo_text` 动作实战：在总线模块显示屏上推送自定义文本
Home Assistant Velbusset_memo_text动作实战在总线模块显示屏上推送自定义文本【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文聚焦 Home Assistant 中 Velbus 集成的velbus.set_memo_text服务动作即 UI 中的 Velbus: Set memo text。读完本文你将掌握如何通过可视化界面和 YAML 两种方式向带显示屏的 Velbus 模块VMBGPO、VMBGPOD、VMBELO发送备注文本理解全部三个参数Config entry、Address、Memo text的取值与必填规则并了解它与velbus.sync_clock、velbus.scan、velbus.clear_cache等相关动作的配合关系。动作用途把文字推到 Velbus 模块屏幕上velbus.set_memo_text的作用是在 Velbus 模块的显示屏上显示备注文本memo text。适用对象是总线中具备显示能力的模块官方文档明确列出了三类典型硬件VMBGPO带显示屏的通用输入/继电器模块VMBGPOD在 GPO 基础上支持 DALI 控制的版本VMBELO带显示屏的入口模块。一个关键前提这些模块的页面page必须在 VelbusLink 软件中配置为显示 memo text否则即便动作执行成功屏幕也不会有对应输出。这一点在原始文档 velbus.set_memo_text 开头即有说明Make sure the module pages are configured to display the memo text.该动作不支持 targets目标在 UI 中执行时系统不会提示你选择区域area、设备device、实体entity或标签label因为它面向的是某个连接上的某个总线地址而不是某个 Home Assistant 实体。通过可视化界面配置动作完整的 UI 操作步骤继承自原文档进入SettingsAutomations scenes自动化与场景页面。打开一个已有的自动化或脚本或者选择Create automationCreate new automation。如果是新建自动化需要在When部分添加触发条件脚本则不需要触发器它由其他调用方触发执行。在Then do部分选择Add action。搜索并选择Velbus: Set memo text。选择Config entry要使用的 Velbus 连接输入模块Address地址和要显示的Memo text备注文本。点击Save保存。选择多个 Velbus 连接时通过 Config entry 区分目标总线这与下面 YAML 方式中的config_entry字段一一对应。参数详解原始文档同时给出了 UI 与 YAML 两套参数说明二者含义一致。完整参数表如下其中type列来自 YAML 参数定义参数类型必填说明config_entrystring是要发送命令的 Velbus 连接config entry ID。addressinteger是模块地址使用十进制格式。十进制地址显示在集成页面所列每个模块的前面。memo_textstring否要显示的文本长度上限 64 个字符。留空时会清除当前显示的 memo text。几个实操要点address必须是十进制整数integer这与同域的velbus.clear_cache动作的 Address 参数保持同一约定。十进制地址可以在 Velbus 集成页面查看——模块列表中每个模块名称前显示的数字即是。memo_text的双向语义填入文本即上屏置空即清屏。这意味着同一个动作既能推消息也能撤消息例如用一次自动化推垃圾日提示再用一次定时任务把它清空。64 字符的限制是文档明确的硬上限写长文本时应自行截断或改用多屏轮播思路分多次调用。YAML 完整示例在 YAML 中该动作的引用名为velbus.set_memo_text。原文档给出的标准示例action: action: velbus.set_memo_text data: config_entry: 01JGE8XB3MNPZFA836TTZ3KZ46 address: 65 memo_text: Its trash day执行后地址为 65 的模块显示屏上会呈现 Its trash day。将其放进一个完整自动化中的写法触发方式可按需替换alias: Trash day reminder on Velbus display triggers: - trigger: time at: 07:00:00 actions: - action: velbus.set_memo_text data: config_entry: 01JGE8XB3MNPZFA836TTZ3KZ46 address: 65 memo_text: Its trash day其中config_entry的取值是 config entry IDULID 字符串可在 Home Assistant 的集成页面或对应连接的诊断信息中获取示例中的address: 65必须替换为你设备上目标模块的十进制地址。相关动作同域命令的组合使用velbus.set_memo_text的 front matter 中声明了三个相关动作它们共同构成 Velbus 域的维护命令族值得在排障或运维自动化中一起了解动作作用关键参数velbus.sync_clock将总线中各 Velbus 模块的时钟同步到 Home Assistant 的系统时钟等效于 VelbusLink 软件中的Sync clock按钮。仅config_entryvelbus.scan扫描总线上的 Velbus 模块。在日志出现未知模块告警、或新增模块后运行等效于 VelbusLink 软件中的Scan按钮。仅config_entryvelbus.clear_cache清除 Velbus 缓存并启动一次新扫描。当你用 VelbusLink 软件修改过配置时建议执行可传address只清单个模块留空则清全部。config_entry 可选address例如一个合理的运维序列是用 VelbusLink 调整完模块配置 → 执行velbus.clear_cache让 Home Assistant 重新加载配置 → 执行velbus.scan确认总线拓扑 → 再执行velbus.set_memo_text向带屏模块推送新提示。这四个动作都不支持 targets参数面都极小非常适合直接编排进脚本。前置条件Velbus 集成本身set_memo_text依赖 Velbus 集成hub 类型已成功建立连接。根据 Velbus 集成文档该集成自 Home Assistant 0.50 起可用支持三种物理连接方式Velbus USBUSB 接口直接插在 Home Assistant 主机上配置流程中接口会被自动检测并列出Velbus 串口serialVelbus TCP/IP 网关需要填写host、port以及按需启用tls、提供password。文档给出了三类典型网关的参数示例signumTLS端口 27015、velser无 TLS端口 6000、Home Assistant 附加组件端口默认 27015。连接成功后集成会执行一次连接测试随后进入模块发现环节可以选择导入从 VelbusLink 导出的 VLP 配置文件vlp参数指定路径直接生成全部设备与实体或者跳过导入让集成执行总线扫描——文档明确提示扫描方式不如使用 VLP 文件可靠。另外两点与本文动作直接相关的背景事实来自集成文档集成是事件驱动的模块状态变化会被主动推送到 Home Assistant因此把set_memo_text挂到传感器/状态触发器上可以做到事件即上屏。集成的已知限制是不会重刷reprogramVelbus 模块协议未实现的所有修改必须通过 VelbusLink 软件完成——这正呼应了模块页面需预先配置为显示 memo text这一前提。排障提示结合 集成文档的 Troubleshooting 章节当set_memo_text执行后屏幕无反应时可以按以下顺序排查地址是否正确确认address是该模块的十进制地址且该模块属于所选config_entry对应的连接多总线部署时选错连接是常见错误。页面配置确认模块的显示页面已配置为输出 memo text需通过 VelbusLink 软件设置。模块是否被集成识别若新增模块后未被识别运行 velbus.scan若曾通过 VelbusLink 修改过配置先运行 velbus.clear_cache 让缓存失效再重建。连接层问题若报 Unable to setup Velbus按文档建议检查 USB 接口是否被其他程序如 VelbusLink占用、TCP/IP 网关的 IP/端口与防火墙设置。开启调试日志更多细节可通过 Home Assistant 的调试日志功能获取集成文档指向了通用的调试日志说明。小结velbus.set_memo_text是一个参数面很小、语义却很实用的 Velbus 域服务一次调用即可把最多 64 字符的文本推送到 VMBGPO/VMBGPOD/VMBELO 等带屏模块的显示页置空则清屏。UI 与 YAML 两条路径的参数完全对齐config_entry、address必填memo_text可选配合同域的scan、sync_clock、clear_cache可以覆盖发现—同步—展示—维护的完整操作闭环。原始文档位于 source/_actions/velbus.set_memo_text.markdown配套的三个相关动作文档与 Velbus 集成页面 可作为延伸阅读。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考