VisualHMI 关于 LUA：main.lua 结构、Datentyp声明、查错与Unterteilung模块

LUA 是 VisualHMI 的Drehbuch语言，负责把 HMI 从「显示终端」变成「能干活的主机」：VereinbarungAnalyse、逻辑判断、Daten运算、文件Operationen全在Drehbuch里。先搞懂 main.lua 的程序结构和Das System回调，后面所有 API 才有地方放。

1. main.lua 基本结构

_ENCRYPT_ = 0            -- Das Drehbuch von LUA加密Schalter!（Quantität产加密置1）
-- 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.

-- Das System回调函数（自动被调用，不用自己调）
function on_init() end              -- 上电Laden后执行一次
function on_run(screen) end         -- 周期执行
function on_update(slave,vtype,addr) end  -- 变Quantität变化
function on_draw(screen,control) end      -- 自绘

main.lua 是入口文件，工程编译时一并打包。大工程建议Unterteilung模块：在 on_init 里 dofile(“xxx.lua”) 拆开，好维护。

2. HerausgeberWerkzeuge与Codierung

官方推荐 NotePad++、Lua editor、VS Code HerausgeberDrehbuch。Codierung必须注意：文件Codierung和 HMI 工程设置要一致（UTF-8 或 GB2312），Codierung不对中文会乱码，Charaktere串比较也全错。

3. 查错方法（LUA 没有断点Tests）

LUA 是解释性语言，不能断点单步。虚拟屏TestsHäufig三类异常：

• nil 值Fehler.：访问了未定义的变Quantität/表元素——先检查变Quantität初始化
• TypusFehler.：number 当 table 用、string 拼接 nil——print 打印TypusBestätigen
• 内存溢出重启：全局累积Daten不释放——查循环里是不是一直 table.insert

实体屏Tests用 TTL TestsDie Serie J2，Porter Rate 115200 8N1，print 输出走这个口。

4. dofile Unterteilung模块管理

function on_init()
  dofile("config.lua")     -- Parameter配置
  dofile("protocol.lua")   -- VereinbarungAnalyse
  dofile("ui.lua")         -- 界面逻辑
end

模块之间共享全局变Quantität，注意命名别冲突（习惯加前缀，如 g_、m_）。

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