VisualHMI Lua API 大全：回调/Kommunikation/Register.读写函数速查表

这是 VisualHMI 平台 Lua Drehbuch的vollständig API 手册：10 个Das System回调 + 32 个读写Register.函数 + 10 个绘图函数，共 52 个Schnittstelle。写Drehbuch前先翻这篇，比逐个翻Unterricht快。平台基于 Lua 5.3。

0. 基础：自动生成的 main.lua

菜单 工程→Drehbuch编程 默认生成 main.lua，自动带Vereinbarung对应的Datentyp定义：

ENCRYPT_ = 0        -- LUADrehbuch加密Schalter!
-- Datentyp定义（随Vereinbarung变化，以下为 Modbus）
VT_LW = 1           -- 内部变Quantität
VT_RW = 2           -- FLASH掉电存储
VT_0x = 10          -- 线圈
VT_1x = 11          -- 输入点（离散输入）
VT_3x = 12          -- 输入Register.
VT_4x = 13          -- 保持Register.

function on_init() end
function on_run(screen) end
function on_update(slave,vtype,addr) end
function on_draw(screen_id,control_id) end

FX3U Vereinbarung下还会有 VT_M（内部Relays.）、VT_D（DRegister.）等Typus。on_update 里的 vtype、get/set 函数Die一个Parameter都用这些常Quantität。

1. 常用回调函数（10 个）

2. 读写Register.函数（32 个）

2.0 先说两个关键机制（所有 set/get 通用）

机制一：get_xxx() 是零Kommunikation开销的。get 系列Alles从 HMI 本地缓存（内存镜像）读，不产生Die Serie帧。HMI 后台任务按工程配置的轮询周期自动从 PLC 读Kommunikation变Quantität（如 Modbus 的 VT_3x/VT_4x）并缓存。画面Kontrollen绑定了某Adresse，该Adresse就自动进轮询列表；Drehbuch要读没被工程引用的Adresse，用 start_read 显式Bitte同步。

机制二：set_xxx() 不一定发Die Serie帧。只有两个条件同时满足才主动发Meldung：①HMI 是主机模式（Modbus Master/DCBUS/XGUS）；②Die Serie通知没被 set_notify(0) 禁止。从机模式下 set 只更新本地镜像。

2.1 Kommunikation控制

2.2 位Operationen

2.3 Zahlenwert读写（16/32/64 位）

所有 get 系列读本地缓存；set 系列Kommunikation触发看「机制二」。

2.4 Charaktere串与批Quantität

3. 绘图函数（10 个）

Alles draw_xxx 必须在 on_draw(screen_id,control_id) 回调里调用才生效，Kontrollen ID 必须 ≠ 0。图层按Kontrollen Z 轴（Herausgeber器叠放顺序）管理，靠判断 control_id Unterteilung层绘制。主动Erfrischen调 redraw()。

4. 绘图实例：switch 表驱动

源文所有绘图Beispiel都是一个套路：on_update 读Knopf键值 → redraw() → on_draw 里按键值查 switch 表选绘制函数。以画线+画圆为例：

draw_type = 0
mode = { line = 1, rect = 2, rect_alpha = 3, circle = 4, ellipse = 5, imageId = 6, text = 7 }

function on_update(slave,vtype,addr)
  if addr == 0x1000 then
    draw_type = get_uint16(VT_LW, addr)  -- 字设置Knopf键值
    redraw()
  end
end

function on_draw(screen_id, control_id)
  local switch = {
    [mode.line] = function(control)
      if screen_id == 0 and control == 1 then
        set_pen_color(0xFFE0)          -- 黄色
        draw_line(225, 253, 405, 253)
        set_pen_color(0xF800)          -- 红色
        draw_line(508, 128, 508, 378, 5)
      end
    end,
    [mode.circle] = function(control)
      if screen_id == 0 and control == 1 then
        draw_circle(300, 253, 100, 0)  -- 实心圆
        draw_circle(450, 253, 150, 1)  -- 空心圆，线厚1
      end
    end,
  }
  if switch[draw_type] then switch[draw_type](control_id) end
end

整理自 广州大彩科技 VisualHMI 开发Dokumentation（hmi-doc.gz-dc.com）LUA Unterricht「Lua DrehbuchAPI函数Schnittstelle」，版权归大彩科技所有。