"# VisualHMI \u7b80\u6613\u6570\u636e\u5e93\uff1aeasydb_* \u4e0e\u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\u81ea\u5b9a\u4e49\u6a21\u5f0f\n\n> 2026-08-04 | 2026-08-05\n> http:\/\/www.modbus.cn\/en\/51515.html\n\n**LUA \u811a\u672c, \u4e32\u53e3\u5c4f\/HMI \u5f00\u53d1**\n\n---\n\n\u7b80\u6613\u6570\u636e\u5e93\uff08\u5b9a\u5236\u56fa\u4ef6\u4e13\u5c5e\uff09\u662f\u4e00\u4e2a**\u8f7b\u91cf\u7ea7\u3001\u65e0\u6587\u4ef6\u7cfb\u7edf\u7684\u5d4c\u5165\u5f0f\u6570\u636e\u5e93**\uff1a\u5728 Flash \u91cc\u5212\u4e00\u5757\u8fde\u7eed\u533a\u57df\uff0c\u6309\u56fa\u5b9a\u957f\u5ea6\u8bb0\u5f55\u5b58\u7ed3\u6784\u5316\u6570\u636e\uff08\u53c2\u6570\u914d\u7f6e\u3001\u4e8b\u4ef6\u65e5\u5fd7\u3001\u8fd0\u884c\u8bb0\u5f55\uff09\uff0c\u6389\u7535\u4e0d\u4e22\uff0c\u652f\u6301\u8fd0\u884c\u65f6\u6309\u9700\u521d\u59cb\u5316\u3002\u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\u7528\u300c\u81ea\u5b9a\u4e49\u300d\u6570\u636e\u6e90\u6a21\u5f0f\u5bf9\u63a5\uff0c\u5b9e\u73b0\u589e\u5220\u6539\u67e5\u5168\u6d41\u7a0b\u3002\n\n## 1. \u26a0\ufe0f Flash \u5730\u5740\u89c4\u5212\uff08\u4e0d\u770b\u4f1a\u53d8\u7816\uff09\n\n\u7b80\u6613\u6570\u636e\u5e93\u76f4\u63a5\u64cd\u4f5c Flash\uff0c**\u6ca1\u6709\u6587\u4ef6\u7cfb\u7edf\u9694\u79bb\u673a\u5236**\uff0cflashaddr \u8d77\u59cb\u5730\u5740\u5fc5\u987b\u4e25\u683c\u907f\u5f00\u56db\u7c7b\u9ad8\u98ce\u9669\u533a\u57df\uff1a\n\n- \u5de5\u7a0b\u8d44\u6e90\u5b58\u50a8\u533a- \u8d44\u6599\u91c7\u6837\u5757\u5b58\u50a8\u533a- \u64cd\u4f5c\u8bb0\u5f55\u5757\u5b58\u50a8\u533a- OTA \u5347\u7ea7\u5907\u4efd\u533a\u57df\n\n\u603b\u5360\u7528\u7a7a\u95f4 = dataRowSize \u00d7 maxCount\uff0c\u89c4\u5212\u5730\u5740\u65f6\u628a\u8fd9\u6bb5\u7a7a\u95f4\u7b97\u8fdb\u53bb\uff0c\u522b\u548c\u522b\u7684\u529f\u80fd\u6253\u67b6\u3002\n\n## 2. API \u603b\u8868\n\n\u51fd\u6570\u53c2\u6570\u8bf4\u660e`easydb_open(flashaddr, createIfNotExist, dataRowSize, maxCount)`flashaddr Flash \u8d77\u59cb\u5730\u5740\uff1bcreateIfNotExist 0=\u4ec5\u6253\u5f00\/1=\u4e0d\u5b58\u5728\u5219\u521b\u5efa\uff1bdataRowSize \u22651\uff1bmaxCount \u6700\u5927\u6761\u6570\u6253\u5f00\u6216\u521b\u5efa\u6570\u636e\u5e93\uff0c\u8fd4\u56de\u53e5\u67c4\uff08\u975e 0 \u6210\u529f\uff0c0 \u5931\u8d25\uff09`easydb_close(db)`\u53e5\u67c4\u5173\u95ed\u6570\u636e\u5e93\uff0c\u91ca\u653e\u8d44\u6e90`easydb_get_count(db)`\u53e5\u67c4\u5f53\u524d\u6709\u6548\u8bb0\u5f55\u6570`easydb_get(db, idx)`idx \u4ece 0 \u5f00\u59cb\u8bfb\u6307\u5b9a\u7d22\u5f15\u8bb0\u5f55\uff0c\u6210\u529f\u8fd4\u56de\u5b57\u7b26\u4e32\uff0c\u5931\u8d25 nil`easydb_add(db, dataset)`\u5b57\u7b26\u4e32\u6570\u636e\u672b\u5c3e\u8ffd\u52a0\u4e00\u6761\u8bb0\u5f55`easydb_update(db, idx, dataset)`idx + \u65b0\u5185\u5bb9\u66f4\u65b0\u6307\u5b9a\u8bb0\u5f55\uff0c**dataset \u957f\u5ea6\u5fc5\u987b\u4e25\u683c\u7b49\u4e8e dataRowSize**`easydb_del(db, idx)`idx\u5220\u9664\u6307\u5b9a\u8bb0\u5f55`easydb_clear(db)`\u53e5\u67c4\u6e05\u7a7a\u6240\u6709\u8bb0\u5f55\n\n## 3. \u6570\u636e\u8bb0\u5f55\u63a7\u4ef6\u300c\u81ea\u5b9a\u4e49\u300d\u6a21\u5f0f\n\n\u6570\u636e\u6765\u6e90\u8bbe\u4e3a**\u81ea\u5b9a\u4e49**\u65f6\uff0c\u7cfb\u7edf\u4e0d\u77e5\u9053\u6709\u591a\u5c11\u884c\u6570\u636e\uff0c\u5fc5\u987b\u7531\u4e24\u4e2a\u56de\u8c03\u63d0\u4f9b\uff1a\n\n- **\u8bb0\u5f55\u6570\u91cf\u56de\u8c03** `on_get_record_count(screen_id, control_id)`\uff1a\u8fd4\u56de\u603b\u884c\u6570\uff0c\u5185\u90e8\u8c03 easydb_get_count(g_db_handle)- **\u8bb0\u5f55\u5185\u5bb9\u56de\u8c03** `on_get_record_row(screen_id, control_id, row)`\uff1a\u8fd4\u56de\u7b2c row \u884c\u7684\u5b57\u7b26\u4e32\u5185\u5bb9\n```\nfunction on_get_record_count(screen_id, control_id)\n  if screen_id == 0 and control_id == 1 then\n    return db.getCnt(g_db_handle)\n  end\nend\n\nfunction on_get_record_row(screen_id, control_id, row)\n  local ret, msg = db.get(g_db_handle, row)\n  if ret == 0 then\n    return msg\n  end\nend\n```\n\n\u63a7\u4ef6\u914d\u7f6e\uff1a\u6570\u636e\u6765\u6e90=\u81ea\u5b9a\u4e49\u3001\u5b57\u7b26\u7f16\u7801=UTF8\u3001\u7ffb\u9875\u63a7\u5236\u221a\u3001\u63a7\u5236\u5730\u5740 LW4000\u3001\u9009\u4e2d\u884c\u901a\u77e5\u221a\uff08LW4004\uff0cUINT32\uff09\u2014\u2014\u9009\u4e2d\u67d0\u884c\u65f6\u7d22\u5f15\u5199\u8fdb LW4004\uff0c\u589e\u5220\u6539\u90fd\u9760\u5b83\u5b9a\u4f4d\u3002\n\n## 4. \u5e94\u7528\uff1adb.lua \u53e5\u67c4\u5c01\u88c5 + \u589e\u5220\u6539\u67e5\n\n### 4.1 \u521d\u59cb\u5316\uff08on_init\uff09\n\n```\nfunction on_init()\n  dofile(\"db.lua\")\n  _EN_ON_UPDATA_API_ = 0\n  -- 10MB \u8d77\u59cb\u3001\u4e0d\u5b58\u5728\u5219\u521b\u5efa\u3001\u5355\u67611000\u5b57\u8282\u3001\u6700\u591a1000\u6761\n  g_db_handle = db.open(10*1024*1024, 1, 1000, 1000)\n  if g_db_handle == 0 then\n    print(\"ERROR: \u65e0\u6cd5\u6253\u5f00\u6570\u636e\u5e93\uff01\")\n    return\n  end\n  db.clear(g_db_handle)               -- \u6e05\u7a7a\u65e7\u6570\u636e\uff08\u53ef\u9009\uff09\n  db.add(g_db_handle, \"Alice;Engineer;30\")\n  db.add(g_db_handle, \"Bob;Technician;25\")\n  db.add(g_db_handle, \"Charlie;Manager;40\")\n  db.add(g_db_handle, \"Harden;Basketball players;36\")\n  _EN_ON_UPDATA_API_ = 1\nend\n```\n\n\u8bb0\u5f55\u683c\u5f0f\u300c\u59d3\u540d;\u804c\u4e1a;\u5e74\u9f84\u300d\uff0c\u82f1\u6587\u5206\u53f7\u5206\u9694\uff0c\u548c\u8868\u683c\u63a7\u4ef6\u89e3\u6790\u89c4\u5219\u4e00\u81f4\uff0c\u76f4\u63a5\u6620\u5c04\u591a\u5217\u3002\n\n### 4.2 \u589e\u5220\u6539\uff08LW5000 \u6309\u952e\u5206\u53d1\uff09\n\n```\nfunction on_update(slave, vtype, addr)\n  if addr == 0x4004 then              -- \u9009\u4e2d\u884c\u901a\u77e5\n    local idx = get_uint32(VT_LW, addr)\n    local ret, msg = db.get(g_db_handle, idx)\n    if ret == 0 then\n      local parts = my_split(msg, \";\")\n      if parts ~= nil then\n        set_uint16(VT_LW, 0x4530, idx)   -- \u8bb0\u5f55\u5f53\u524d\u9009\u4e2d\u7d22\u5f15\n        set_string(VT_LW, 0x4500, (parts[1] == nil) and \"--\" or parts[1])\n        set_string(VT_LW, 0x4510, (parts[2] == nil) and \"--\" or parts[2])\n        set_string(VT_LW, 0x4520, (parts[3] == nil) and \"--\" or parts[3])\n      end\n      show_dialog(1, 232, 33, 50)        -- \u5f39\u7a97\u663e\u793a\u8be6\u60c5\n    end\n  elseif addr == 0x5000 then\n    local key = get_uint16(VT_LW, addr)\n    if key == 0 then                    -- \u6dfb\u52a0\n      local name = get_string(VT_LW, 0x5010)\n      local position = get_string(VT_LW, 0x5020)\n      local age = get_string(VT_LW, 0x5030)\n      db.add(g_db_handle, name..\";\"..position..\";\"..age..\";\")\n    elseif key == 1 then                -- \u4fee\u6539\uff08\u6539\u9009\u4e2d\u884c\uff09\n      local name = get_string(VT_LW, 0x4500)\n      local position = get_string(VT_LW, 0x4510)\n      local age = get_string(VT_LW, 0x4520)\n      local idx = get_uint16(VT_LW, 0x4530)\n      db.modify(g_db_handle, idx, name..\";\"..position..\";\"..age..\";\")\n    elseif key == 2 then                -- \u5220\u9664\uff08\u5220\u9009\u4e2d\u884c\uff09\n      local idx = get_uint16(VT_LW, 0x4530)\n      db.del(g_db_handle, idx)\n    end\n  end\nend\n```\n\ndb.lua \u5c01\u88c5\u5c42\u6bcf\u4e2a\u51fd\u6570\u90fd\u505a**\u53e5\u67c4\u6821\u9a8c + \u7d22\u5f15\u8d8a\u754c\u68c0\u67e5**\uff08idx = count \u8fd4\u56de -2\uff09\uff0c\u8fd9\u662f\u53e5\u67c4\u9a71\u52a8\u8bbe\u8ba1\u7684\u6807\u51c6\u59ff\u52bf\uff1a\u4e0d\u5408\u6cd5\u5c31\u76f4\u63a5\u8fd4\u56de\u9519\u8bef\u7801\uff0c\u7edd\u4e0d\u5f80\u4e0b\u4f20\u3002\n\n\u56db\u4e2a\u5751\uff1a**\u2460flashaddr \u5fc5\u987b\u907f\u5f00\u5de5\u7a0b\u8d44\u6e90\/\u8d44\u6599\u91c7\u6837\/\u64cd\u4f5c\u8bb0\u5f55\/OTA \u5907\u4efd\u56db\u533a**\uff0c\u76f4\u63a5\u64cd\u4f5c Flash \u65e0\u9694\u79bb\uff0c\u9009\u9519\u5730\u5740\u6570\u636e\u4e92\u76f8\u8986\u76d6\u751a\u81f3\u53d8\u7816\uff1b**\u2461easydb_update \u7684 dataset \u957f\u5ea6\u5fc5\u987b\u4e25\u683c\u7b49\u4e8e\u521b\u5efa\u65f6\u7684 dataRowSize**\uff0c\u957f\u4e86\u77ed\u4e86\u90fd\u4f1a\u5931\u8d25\uff1b**\u2462\u8bb0\u5f55\u7528\u82f1\u6587\u5206\u53f7 ; \u5206\u9694**\uff0c\u548c\u8868\u683c\u63a7\u4ef6\u89e3\u6790\u89c4\u5219\u5bf9\u9f50\uff0c\u522b\u7528\u4e2d\u6587\u5206\u53f7\uff1b**\u2463\u53e5\u67c4\u662f\u5168\u5c40\u751f\u547d\u5468\u671f\u8d44\u6e90**\uff0con_init \u91cc\u5f00\u4e00\u6b21\u5168\u7a0b\u6301\u6709\uff0c\u64cd\u4f5c\u524d\u5148\u6821\u9a8c\u53e5\u67c4\u975e 0\u3001\u7d22\u5f15\u5728\u8303\u56f4\u5185\u3002\u5b9a\u5236\u56fa\u4ef6\u624d\u6709\u8fd9\u5957 API\uff0c\u666e\u901a\u56fa\u4ef6\u6ca1\u6709\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\u7b80\u6613\u6570\u636e\u5e93\u300d\uff0c\u7248\u6743\u5f52\u5927\u5f69\u79d1\u6280\u6240\u6709\u3002\n\n---\n*modbus.cn*\n"