VisualHMI Lua API 大全：回调/Communication/レジスタ読み書き函数クイックチェック·テーブル

这是 VisualHMI プラットフォーム Lua 脚本的complete API 手册：10 个系统回调 + 32 个読み取り/書き込みレジスタ函数 + 10 个绘图函数，共 52 个接口。写脚本前先翻这篇，比逐个翻チュートリアル快。プラットフォーム基于 Lua 5.3。

0. 基础：自動生成される的 main.lua

菜单 工程→スクリプトプログラミング デフォルト生成 main.lua，自动带协议对应的データ型定义：

ENCRYPT_ = 0        -- LUAスクリプト加密开关
-- データ型定义（随协议变化，以下为 Modbus）
VT_LW = 1           -- 内部变量
VT_RW = 2           -- FLASH掉电存储
VT_0x = 10          -- コイル
VT_1x = 11          -- 入力点（ショップ型入力）
VT_3x = 12          -- 入力レジスタ。
VT_4x = 13          -- レジスタを保持する。

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 协议下还会有 VT_M（内部继电器）、VT_D（Dregister）等タイプ。on_update 里的 vtype、get/set 函数第一个参数都用这些常量。

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

2. 読み取り/書き込みレジスタ函数（32 个）

2.0 先说2つ关键机制（すべての set/get 通用）

机制一：get_xxx() 是零通信开销的。get 系列すべて从 HMI 本地缓存（内存镜像）读，不产生シリアルポートフレーム。HMI 后台任务按工程設定的ポーリング周期自动从 PLC 读通信变量（如 Modbus 的 VT_3x/VT_4x）并缓存。画面控件绑定了某アドレス，该アドレス就自动进ポーリングリスト；脚本要读没被工程引用的アドレス，用 start_read 显式リクエスト同步。

机制二：set_xxx() 不一定发シリアルポートフレーム。只有2つ条件同时满足才主动发报文：①HMI 是マスターモード（Modbus Master/DCBUS/XGUS）；②シリアルポート通知没被 set_notify(0) 禁止。スレーブモード下 set 只更新本地镜像。

2.1 通信控制

2.2 ビット操作。

2.3 数值読み書き（16/32/64 位）

すべての get 系列读本地缓存；set 系列通信触发看「机制二」。

2.4 ストリング·ストリング与批量

3. 绘图函数（10 个）

All draw_xxx 必须在 on_draw(screen_id,control_id) 回调里调用才生效，control ID 必须 ≠ 0。图层按控件 Z 轴（編集器叠放顺序）管理，靠判断 control_id 分层绘制。主动リフレッシュ调 redraw()。

4. 绘图实例：switch 表驱动

源文すべての绘图サンプル都是一个套路：on_update 读按钮键值 → 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)  -- 字設定按钮键值
    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 开发ドキュメント（hmi-doc.gz-dc.com）LUA Tutorial「Lua ScriptAPI函数接口」，著作権は大彩科技すべての。