레지스터操作 API 是 LUA 读写데이터的전체家当：set/get 시리즈覆盖所有데이터유형，set_bit 处理位，set_array 批量写。核心机制先记住：get_xxx 전체从 HMI 本地缓存（内存镜像）读，不发시리얼 포트帧——零통신开销。
1. 읽기机制（重要）
get_xxx() 시리즈函数不会实时向 PLC 发시리얼 포트请求。HMI 后台任务按엔지니어링설정的轮询周期自动从 PLC 读통신변수（Modbus 的 3x/4x 等）并缓存，스크립트只读缓存。好处是避免스크립트逻辑造成통신风暴——你 get 一万次也不会把总线打爆。
2. API 总表
| 函数 | 范围/설명 | 주소跨度 |
|---|---|---|
set_bit(vtype,addr,value,count) | 批量位写，value 低 count 位对应 addr 起连续位（count 1~16）；get_bit 返回 0/1 | 1 |
set/get_uint16 | 0~65535，超范围截断 & 0xFFFF | 1 |
set/get_int16 | -32768~+32767 | 1 |
set/get_uint32 | 0~4294967295 | +2 |
set/get_int32 | -2^31~2^31-1 | +2 |
set/get_uint64 | 0~2^64-1 | +4 |
set/get_int64 | -2^63~2^63-1 | +4 |
set/get_float | IEEE 754 单精度 | +2 |
set/get_double | IEEE 754 双精度 | +4 |
set_string(vtype,addr,str) | 最大 2K 바이트，UTF-8/GBK；get_string 默认 128 바이트最大 2048， 截断 | 按길이 |
set_uint16_ex(vtype,addr,v1,...,vN) | 批量写，最多 120 个레지스터 | N |
set_array(vtype,addr,buff) | 수신 Lua table（word 数组），最多 120 字 | N |
3. vtype 取值（随프로토콜变化）
| 常量 | 含义 |
|---|---|
| VT_0x | 코일 |
| VT_1x | 입력 |
| VT_M | FX3U 内部릴레이 |
| VT_3x | 입력 레지스터 |
| VT_4x | 유지 레지스터 |
| VT_D | FX3U D 레지스터 |
| VT_LW | 内部변수（掉电不저장） |
| VT_RW | 掉电저장区 |
4. 데이터복사案例（12 组모드通用套路）
最常见的需求：外部给 LW 写데이터，스크립트搬到另一个주소或转换형식。套路是 on_update 里判断 vtype==VT_LW 和源주소，用 get 读、set 写目标：
function on_update(slave, vtype, addr)
if vtype == VT_LW then
if addr == 0x1000 then
set_uint16(VT_LW, 0x1001, get_uint16(VT_LW, 0x1000)) -- uint16 복사
elseif addr == 0x1004 then
set_uint32(VT_LW, 0x1006, get_uint32(VT_LW, 0x1004)) -- uint32（跨度+2）
elseif addr == 0x101C then
set_float(VT_LW, 0x101E, get_float(VT_LW, 0x101C)) -- float（跨度+2）
elseif addr == 0x1030 then
set_string(VT_LW, 0x1040, get_string(VT_LW, 0x1030, 16)) -- string（跨度16）
end
end
end
-- 批量写：addr==0x1050 且值为偶数时写 10 个레지스터
function on_update(slave, vtype, addr)
if vtype == VT_LW and addr == 0x1050 then
local v = get_uint16(VT_LW, 0x1050)
if v % 2 == 0 then
set_uint16_ex(VT_LW, 0x1060, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
-- 或
set_array(VT_LW, 0x1060, {10, 20, 30, 40, 50, 60, 70, 80, 90, 100})
end
end
end
三个坑：①32 位以上데이터유형有주소跨度——uint32/float 占 2 个레지스터、uint64/double 占 4 个，连续读写别把주소搞重叠；②set 超范围自动截断（& 0xFFFF 之类），不会报错也不会进位，数值错了你可能不知道；③get_string 默认读 128 바이트，要更长显式传 len（最大 2048），문자串在 处截断。
整理自 广州大彩科技 VisualHMI 개발문서（hmi-doc.gz-dc.com）LUA 튜토리얼「레지스터操作」，版权归大彩科技所有。
답글 작성