"# VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c\n\n> 2026-08-04 | 2026-08-04\n> http:\/\/www.modbus.cn\/en\/51501.html\n\n**LUA \u811a\u672c, \u4e32\u53e3\u5c4f\/HMI \u5f00\u53d1**\n\n---\n\nrecord_* \u7cfb\u5217 API \u64cd\u4f5c\u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\u7684\u5386\u53f2\u6570\u636e\uff1a\u6dfb\u52a0\u3001\u4fee\u6539\u3001\u8bfb\u53d6\u3001\u6e05\u9664\u3001\u67e5\u6761\u6570\u3002\u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\u6709\"\u6570\u503c\u8868\u683c\"\u548c\"\u5b57\u7b26\u4e32\u8868\u683c\"\u4e24\u79cd\u5f62\u6001\uff0c\u56de\u8c03\u64cd\u4f5c\u65b9\u5f0f\u4e0d\u540c\u3002\n\n## 1. API \u603b\u89c8\n\n\u51fd\u6570\u8bf4\u660erecord_get_count(sn)\u83b7\u53d6\u901a\u9053 sn \u5df2\u5b58\u50a8\u8bb0\u5f55\u603b\u6761\u6570record_write_data(sn, data)\u5411\u901a\u9053\u8ffd\u52a0\u4e00\u6761\u8bb0\u5f55\uff0cdata \u4e3a\u5b57\u6570\u7ec4\uff08\u7d22\u5f15\u4ece 1 \u5f00\u59cb\uff09record_read_data(sn, index)\u8bfb\u7b2c index \u6761\u8bb0\u5f55\uff0c\u8fd4\u56de data \u6570\u7ec4 + 32\u4f4d\u65f6\u95f4\u6233record_modify_data(sn, index, data)\u4fee\u6539\u7b2c index \u6761\u8bb0\u5f55\u5185\u5bb9record_write_string(sn, strings)\u5b57\u7b26\u4e32\u901a\u9053\u8ffd\u52a0\u8bb0\u5f55\uff0c\u5206\u53f7 ; \u5206\u9694\u5b57\u6bb5record_read_string(sn, index)\u8bfb\u5b57\u7b26\u4e32\u8bb0\u5f55\uff0c\u8fd4\u56de strings + \u65f6\u95f4\u6233record_modify_string(sn, index, strings)\u4fee\u6539\u5b57\u7b26\u4e32\u8bb0\u5f55record_clear(sn)\u6e05\u7a7a\u901a\u9053\u6240\u6709\u8bb0\u5f55\n\nsn \u662f\u8d44\u6599\u91c7\u6837\u901a\u9053\u7d22\u5f15\uff080~19\uff0c\u5171 20 \u901a\u9053\uff09\u3002\u26a0\ufe0f **\u82e5\u91c7\u6837\u542f\u7528\u4e86\u5757\u5730\u5740\u5b58\u50a8\u6a21\u5f0f\uff0c\u6570\u636e\u4e0d\u53ef\u7be1\u6539**\uff08record_modify_data \u65e0\u6548\uff09\u3002\n\n![\u6570\u636e\u8bb0\u5f55\u63a7\u4ef6](https:\/\/www.modbus.cn\/wp-content\/uploads\/2026\/08\/visualhmi\/lu005_1.png)\n\n## 2. \u6570\u503c\u8868\u683c\u6848\u4f8b\n\n**\u8d44\u6599\u91c7\u96c6\u914d\u7f6e**\uff1a\u89e6\u53d1\u91c7\u6837\u3001\u8bb0\u5f55\u6761\u6570 100\u3001\u6570\u636e\u5730\u5740 LW2000\u3001UINT16\u3001\u6570\u636e\u4e2a\u6570 10\u3001\u63a7\u5236\u5730\u5740 LW1001\u3001\u91c7\u6837\u63a7\u5236\u5730\u5740 LW1002\u3001\u542f\u52a8\u6a21\u5f0f OFF\u2192ON\u3002\n\n**\u63a7\u4ef6\u914d\u7f6e**\uff1a\u6570\u636e\u6765\u6e90\"\u8d44\u6599\u91c7\u96c6[0]\u6570\u503c\u6570\u7ec4\"\u3001\u65f6\u95f4\u9006\u5e8f\u3001\u663e\u793a\u65f6\u95f4\u3001\u901a\u9053\u6570 10\u3001\u56fa\u5b9a\u5217\u6570 2\uff08\u5e8f\u53f7+\u65f6\u95f4\uff09\u3001\u6bcf\u9875\u884c\u6570 5\u3001\u7ffb\u9875\u63a7\u5236 LW1004\u3001\u5141\u8bb8\u7ffb\u9875 LW1005\uff08\u53ea\u8bfb\uff09\u3001\u65f6\u95f4\u6233\u5b9a\u4f4d LW1006\uff08UINT32\uff09\u3001\u9009\u4e2d\u884c\u901a\u77e5 LW1008\uff08UINT32\uff09\u3002\n\n**5 \u4e2a\u6309\u94ae**\uff1a\u5199\u5165\u5730\u5740 LW1000\uff0c\u5e38\u91cf 1\/2\/3\/4\/5 = \u6dfb\u52a0\/\u4fee\u6539\/\u8bfb\u53d6\/\u6e05\u9664\/\u8bfb\u53d6\u8bb0\u5f55\u6570\u3002\n\n```\naddByteRatio = 1\nfunction on_update(slave, vtype, addr)\n  if vtype ~= VT_LW then return end\n  if addr == 0x1100 then  -- \u64cd\u4f5c\u5730\u5740\n    local key = get_uint16(vtype, 0x1100)\n    local cnt = record_get_count(0)\n    -- \u9006\u5e8f\u8868\u683c: \u9009\u4e2d\u884c\u53f7\u8981\u53cd\u8f6c\n    local number_select_line = cnt - get_uint32(vtype, 0x1105) - 1\n    if key == 1 then\n      local dataTb = {}\n      for i=1,10 do dataTb[i] = i*addByteRatio end\n      addByteRatio = addByteRatio + 1\n      record_write_data(0, dataTb)\n    elseif key == 2 then\n      local dataTb = {}\n      for i=1,10 do dataTb[i] = 12345 end\n      record_modify_data(0, number_select_line, dataTb)\n    elseif key == 3 then\n      local dataTb, timeUnix = record_read_data(0, number_select_line)\n      local dataMsg = \"\"\n      for i=1,#dataTb do dataMsg = dataMsg..dataTb[i]..\";\" end\n      set_string(VT_LW, 0x1160, timeUnix..dataMsg)\n    elseif key == 4 then\n      record_clear(0)\n    elseif key == 5 then\n      set_string(VT_LW, 0x1160, record_get_count(0))\n    end\n  end\nend\n```\n\n![\u6570\u503c\u8868\u683c\u8fd0\u884c](https:\/\/www.modbus.cn\/wp-content\/uploads\/2026\/08\/visualhmi\/lu005_2.png)\n\n## 3. \u5b57\u7b26\u4e32\u8868\u683c\u6848\u4f8b\n\n**\u8d44\u6599\u91c7\u96c6**\uff1a\u89e6\u53d1\u91c7\u6837\u3001\u8bb0\u5f55\u6761\u6570 100\u3001\u6570\u636e\u5730\u5740 LW3000\u3001STRING\u3001\u6570\u636e\u4e2a\u6570 50\u3001\u63a7\u5236\u5730\u5740 LW1501\u3001\u91c7\u6837\u63a7\u5236\u5730\u5740 LW1502\u3002\n\n**\u63a7\u4ef6**\uff1a\u8d44\u6599\u91c7\u96c6\u7d22\u5f15\"[1]\u5b57\u7b26\u4e32\"\u3001\u5b57\u7b26\u4e32\u8868\u683c\u221a\u3001\u5b57\u7b26\u7f16\u7801 GB CODE\u3001\u65f6\u95f4\u987a\u5e8f\u3001\u663e\u793a\u65e5\u671f\u548c\u65f6\u95f4\u3001\u901a\u9053\u6570 10\u3001\u56fa\u5b9a\u5217\u6570 2\u3001\u6bcf\u9875\u884c\u6570 5\u3001\u7ffb\u9875\u63a7\u5236 LW1201\u3001\u5141\u8bb8\u7ffb\u9875 LW1202\u3001\u65f6\u95f4\u6233\u5b9a\u4f4d LW1203\u3001\u9009\u4e2d\u884c\u901a\u77e5 LW1205\u3002\n\n```\naddStr = 1\nfunction on_update(slave, vtype, addr)\n  if vtype ~= VT_LW then return end\n  if addr == 0x1200 then\n    local key = get_uint16(vtype, 0x1200)\n    local cnt = record_get_count(1)\n    -- \u987a\u5e8f\u8868\u683c: \u9009\u4e2d\u884c\u53f7\u4e0d\u9700\u8981\u53cd\u8f6c\n    local string_select_line = get_uint32(vtype, 0x1205)\n    if key == 1 then\n      if cnt < string_select_line - 1 then return end\n      local dataStr = \"\"\n      for i=1,10 do dataStr = dataStr..\"\u7b2c\"..(i+addStr*10-10)..\"\u4e2a;\" end\n      addStr = addStr + 1\n      record_write_string(1, dataStr)\n    elseif key == 2 then\n      record_modify_string(1, string_select_line, \"change;change;change;change;change;change;change;change;change;change;\")\n    elseif key == 3 then\n      local dataStr, timeUnix = record_read_string(1, string_select_line)\n      set_string(VT_LW, 0x1260, timeUnix..dataStr)\n    elseif key == 4 then\n      record_clear(1)\n    elseif key == 5 then\n      set_string(VT_LW, 0x1260, record_get_count(1))\n    end\n  end\nend\n```\n\n![\u5b57\u7b26\u4e32\u8868\u683c\u8fd0\u884c](https:\/\/www.modbus.cn\/wp-content\/uploads\/2026\/08\/visualhmi\/lu005_3.png)\n\n\u4e24\u4e2a\u6613\u9519\u70b9\uff1a**\u2460\u9006\u5e8f\u8868\u683c\u7684\u9009\u4e2d\u884c\u53f7\u5fc5\u987b\u53cd\u8f6c\uff08number_select_line = cnt - \u9009\u4e2d\u901a\u77e5 - 1\uff09\uff0c\u987a\u5e8f\u8868\u683c\u4e0d\u7528\uff1b\u2461record_modify \u5728\u5757\u5730\u5740\u5b58\u50a8\u6a21\u5f0f\u4e0b\u65e0\u6548\u2014\u2014\u5757\u5b58\u50a8\u662f\u8ffd\u52a0\u5f0f\u7684\uff0c\u5386\u53f2\u6570\u636e\u4e0d\u53ef\u6539**\u3002\n\n\u6574\u7406\u81ea \u5e7f\u5dde\u5927\u5f69\u79d1\u6280 VisualHMI \u5f00\u53d1\u6587\u6863\uff08hmi-doc.gz-dc.com\uff09LUA \u6559\u7a0b\u300c\u6570\u636e\u8bb0\u5f55\u300d\uff0c\u7248\u6743\u5f52\u5927\u5f69\u79d1\u6280\u6240\u6709\u3002\n\n---\n*modbus.cn*\n"