{"id":51501,"date":"2026-08-04T20:18:26","date_gmt":"2026-08-04T12:18:26","guid":{"rendered":"https:\/\/www.modbus.cn\/51501.html"},"modified":"2026-08-04T20:18:26","modified_gmt":"2026-08-04T12:18:26","slug":"visualhmi-%e6%95%b0%e6%8d%ae%e8%ae%b0%e5%bd%95%e6%8e%a7%e4%bb%b6%ef%bc%9arecord_-api-%e6%95%b0%e5%80%bc-%e5%ad%97%e7%ac%a6%e4%b8%b2%e8%a1%a8%e6%a0%bc%e6%93%8d%e4%bd%9c","status":"publish","type":"post","link":"http:\/\/www.modbus.cn\/en\/51501.html","title":{"rendered":"VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c"},"content":{"rendered":"<p>record_* \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&#8221;\u6570\u503c\u8868\u683c&#8221;\u548c&#8221;\u5b57\u7b26\u4e32\u8868\u683c&#8221;\u4e24\u79cd\u5f62\u6001\uff0c\u56de\u8c03\u64cd\u4f5c\u65b9\u5f0f\u4e0d\u540c\u3002<\/p>\n<h2>1. API \u603b\u89c8<\/h2>\n<table border=\"1\" cellpadding=\"6\" style=\"border-collapse:collapse;font-size:14px\">\n<tr>\n<th>\u51fd\u6570<\/th>\n<th>\u8bf4\u660e<\/th>\n<\/tr>\n<tr>\n<td>record_get_count(sn)<\/td>\n<td>\u83b7\u53d6\u901a\u9053 sn \u5df2\u5b58\u50a8\u8bb0\u5f55\u603b\u6761\u6570<\/td>\n<\/tr>\n<tr>\n<td>record_write_data(sn, data)<\/td>\n<td>\u5411\u901a\u9053\u8ffd\u52a0\u4e00\u6761\u8bb0\u5f55\uff0cdata \u4e3a\u5b57\u6570\u7ec4\uff08\u7d22\u5f15\u4ece 1 \u5f00\u59cb\uff09<\/td>\n<\/tr>\n<tr>\n<td>record_read_data(sn, index)<\/td>\n<td>\u8bfb\u7b2c index \u6761\u8bb0\u5f55\uff0c\u8fd4\u56de data \u6570\u7ec4 + 32\u4f4d\u65f6\u95f4\u6233<\/td>\n<\/tr>\n<tr>\n<td>record_modify_data(sn, index, data)<\/td>\n<td>\u4fee\u6539\u7b2c index \u6761\u8bb0\u5f55\u5185\u5bb9<\/td>\n<\/tr>\n<tr>\n<td>record_write_string(sn, strings)<\/td>\n<td>\u5b57\u7b26\u4e32\u901a\u9053\u8ffd\u52a0\u8bb0\u5f55\uff0c\u5206\u53f7 ; \u5206\u9694\u5b57\u6bb5<\/td>\n<\/tr>\n<tr>\n<td>record_read_string(sn, index)<\/td>\n<td>\u8bfb\u5b57\u7b26\u4e32\u8bb0\u5f55\uff0c\u8fd4\u56de strings + \u65f6\u95f4\u6233<\/td>\n<\/tr>\n<tr>\n<td>record_modify_string(sn, index, strings)<\/td>\n<td>\u4fee\u6539\u5b57\u7b26\u4e32\u8bb0\u5f55<\/td>\n<\/tr>\n<tr>\n<td>record_clear(sn)<\/td>\n<td>\u6e05\u7a7a\u901a\u9053\u6240\u6709\u8bb0\u5f55<\/td>\n<\/tr>\n<\/table>\n<p>sn \u662f\u8d44\u6599\u91c7\u6837\u901a\u9053\u7d22\u5f15\uff080~19\uff0c\u5171 20 \u901a\u9053\uff09\u3002\u26a0\ufe0f <strong>\u82e5\u91c7\u6837\u542f\u7528\u4e86\u5757\u5730\u5740\u5b58\u50a8\u6a21\u5f0f\uff0c\u6570\u636e\u4e0d\u53ef\u7be1\u6539<\/strong>\uff08record_modify_data \u65e0\u6548\uff09\u3002<\/p>\n<p style=\"text-align:center\"><img decoding=\"async\" src=\"https:\/\/www.modbus.cn\/wp-content\/uploads\/2026\/08\/visualhmi\/lu005_1.png\" style=\"max-width:100%;border:1px solid #eee;margin:8px 0\" loading=\"lazy\" title=\"VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c\u63d2\u56fe\" alt=\"VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c\u63d2\u56fe\" \/><\/p>\n<h2>2. \u6570\u503c\u8868\u683c\u6848\u4f8b<\/h2>\n<p><strong>\u8d44\u6599\u91c7\u96c6\u914d\u7f6e<\/strong>\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<\/p>\n<p><strong>\u63a7\u4ef6\u914d\u7f6e<\/strong>\uff1a\u6570\u636e\u6765\u6e90&#8221;\u8d44\u6599\u91c7\u96c6[0]\u6570\u503c\u6570\u7ec4&#8221;\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<\/p>\n<p><strong>5 \u4e2a\u6309\u94ae<\/strong>\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<\/p>\n<pre style=\"background:#f5f5f5;padding:10px;border-radius:4px\">addByteRatio = 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<\/pre>\n<p style=\"text-align:center\"><img decoding=\"async\" src=\"https:\/\/www.modbus.cn\/wp-content\/uploads\/2026\/08\/visualhmi\/lu005_2.png\" style=\"max-width:100%;border:1px solid #eee;margin:8px 0\" loading=\"lazy\" title=\"VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c\u63d2\u56fe1\" alt=\"VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c\u63d2\u56fe1\" \/><\/p>\n<h2>3. \u5b57\u7b26\u4e32\u8868\u683c\u6848\u4f8b<\/h2>\n<p><strong>\u8d44\u6599\u91c7\u96c6<\/strong>\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<\/p>\n<p><strong>\u63a7\u4ef6<\/strong>\uff1a\u8d44\u6599\u91c7\u96c6\u7d22\u5f15&#8221;[1]\u5b57\u7b26\u4e32&#8221;\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<\/p>\n<pre style=\"background:#f5f5f5;padding:10px;border-radius:4px\">addStr = 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 &lt; 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<\/pre>\n<p style=\"text-align:center\"><img decoding=\"async\" src=\"https:\/\/www.modbus.cn\/wp-content\/uploads\/2026\/08\/visualhmi\/lu005_3.png\" style=\"max-width:100%;border:1px solid #eee;margin:8px 0\" loading=\"lazy\" title=\"VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c\u63d2\u56fe2\" alt=\"VisualHMI \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\uff1arecord_* API \u6570\u503c\/\u5b57\u7b26\u4e32\u8868\u683c\u64cd\u4f5c\u63d2\u56fe2\" \/><\/p>\n<div class=\"tip\" style=\"border-left:4px solid #f7941e;padding:10px 14px;background:#fff8ef;margin:14px 0\">\u4e24\u4e2a\u6613\u9519\u70b9\uff1a<strong>\u2460\u9006\u5e8f\u8868\u683c\u7684\u9009\u4e2d\u884c\u53f7\u5fc5\u987b\u53cd\u8f6c\uff08number_select_line = cnt &#8211; \u9009\u4e2d\u901a\u77e5 &#8211; 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<\/strong>\u3002<\/div>\n<p style=\"color:#888;font-size:13px\">\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<\/p>\n<span id=\"magicpostMarker\"><\/span>","protected":false},"excerpt":{"rendered":"<p>record_* \u7cfb\u5217 API \u64cd\u4f5c\u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\u7684\u5386\u53f2\u6570\u636e\uff1a&#8230;<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[3131,3126],"tags":[3330,3329,3134,3296,3293,3285],"class_list":["post-51501","post","type-post","status-publish","format-standard","hentry","category-hmi-lua","category-hmi-dev","tag-record_read_data","tag-record_write_data","tag-visualhmi","tag-3296","tag-3293","tag-3285"],"_links":{"self":[{"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/posts\/51501","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/comments?post=51501"}],"version-history":[{"count":0,"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/posts\/51501\/revisions"}],"wp:attachment":[{"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/media?parent=51501"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/categories?post=51501"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.modbus.cn\/en\/wp-json\/wp\/v2\/tags?post=51501"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}