VisualHMI 告警参数（Lua）：on_parse_warning 拼接 p0~p3 动态文本

告警参数回调 on_get_warning_param(warning_id) 解决一个问题：告警内容里要带实时数值。比如「温度过高：当前 85.5℃」——告警文本是模板，数字是运行时的。回调返回最多 4 个参数（data0~data3），填入告警设置里的 {#N:num1.num2} 占位符。

1. 占位符格式 {#data:num1.num2}

在告警设置里，告警内容可以写成：

温度过高：{#0:2.2} ℃

例：{#0:2.2} 表示 data0 显示 2 位整数（不足前补空格）+ 2 位小数（不足补零）。

2. 回调实现

function on_get_warning_param(warning_id)
  -- 返回最多 4 个参数
  local data0 = get_uint16(VT_LW, 0x1001) / 100   -- 缩小100倍：85.5 存的是 8550
  local data1 = get_uint16(VT_LW, 0x1002)
  local data2 = get_uint16(VT_LW, 0x1003)
  local data3 = get_uint16(VT_LW, 0x1004)
  return data0, data1, data2, data3
end

温度 85.5℃ 在寄存器里存 8550（放大 100 倍），回调里 /100 还原，再按 {#0:2.2} 格式化成「85.50」显示。

3. 与 on_parse_warning 的区别

on_get_warning_param 只负责返回数值参数，文本模板在告警设置里配；而 on_parse_warning(id, text, screen_id, control_id, p0, p1, p2, p3) 是完全接管告警文本生成——返回 (字符串, 编码)，编码 1=GBK（中文屏推荐）/0=UTF-8。两者互斥，用参数填充就别用全接管。

整理自 广州大彩科技 VisualHMI 开发文档（hmi-doc.gz-dc.com）LUA 教程「告警参数」，版权归大彩科技所有。