"# FreeModbus\u5e93\u4ecb\u7ecd\u53caModbus\u53d8\u91cf\u5730\u5740\u89e3\u91ca\n\n> 2023-10-27 | 2023-10-27\n> https:\/\/www.modbus.cn\/en\/25674.html\n\n**Modbus\u7f16\u7a0b\u5f00\u53d1**\n\n---\n\n**FreeModbus\u5e93\u4ecb\u7ecd**\n\nFreeModbus\u662f\u4e00\u4e2a\u7b80\u5355\u6613\u7528\u7684Modbus RTU\u5e93\uff0c\u5b83\u5141\u8bb8\u540c\u65f6\u8fd0\u884c\u591a\u4e2a\u72ec\u7acb\u7684Modbus RTU\u4ece\u673a\u3002\u8fd9\u4e2a\u5e93\u7684\u7279\u70b9\u5728\u4e8e\u5b83\u76f4\u63a5\u4f7f\u75280xxxx-4xxxx\u5bc4\u5b58\u5668\u7a7a\u95f4\uff0c\u65e0\u9700\u624b\u52a8\u5904\u7406\u5bc4\u5b58\u5668\u6620\u5c04\u7b49\u7e41\u7410\u95ee\u9898\uff0c\u5e76\u4e14\u53ef\u4ee5\u9650\u5236\u4f7f\u7528\u7684\u6700\u5927\u5bc4\u5b58\u5668\u6570\u91cf\u3002\u5b83\u63d0\u4f9b\u4e86\u5b9a\u65f6\u5668\u63a5\u53e3\u548c\u4e32\u53e3\u6536\u53d1\u63a5\u53e3\uff0c\u53ef\u4ee5\u6839\u636e\u786c\u4ef6\u9700\u6c42\u8fdb\u884c\u914d\u7f6e\uff0c\u975e\u5e38\u7b26\u5408\u5e38\u89c4\u4f7f\u7528Modbus\u901a\u4fe1\u7684\u601d\u8def\u3002\n\n![](https:\/\/image.modbus.cn\/wp-content\/uploads\/2023\/10\/20231027135417124.png)\n\n**\u4f7f\u7528\u8bf4\u660e**\n\n\u4ee5\u4e0b\u662f\u4f7f\u7528FreeModbus\u5e93\u7684\u57fa\u672c\u6b65\u9aa4\uff1a\n\n- **\u642d\u5efa\u4ece\u673a** 1.1 \u5f15\u5165\u5e93\uff1a\u5c06FreeModbus\u5e93\u6dfb\u52a0\u5230\u4f60\u7684\u5de5\u7a0b\u4e2d\uff0c\u5e76\u5f15\u5165\u5934\u6587\u4ef6#include \"mdrtuslave.h\"\u3002 1.2 \u521b\u5efaModbus RTU\u4ece\u673a\uff1a\n\n```\n   #include "mdrtuslave.h"\n\n   #define SLAVE_ID 5\n   #define BUAD_RATE 9600\n   static ModbusRTUSlaveHandler mdhandler;\n\n   static mdVOID popchar(ModbusRTUSlaveHandler handler, mdU8 c)\n   {\n      \/\/ \u6b64\u5904\u6dfb\u52a0\u4e32\u53e3\u53d1\u9001\u4ee3\u7801\n   }\n\n   static void ModbusInit()\n   {\n      struct ModbusRTUSlaveRegisterInfo info;\n      info.slaveId = SLAVE_ID;\n      info.usartBaudRate = BUAD_RATE;\n      info.mdRTUPopChar = popchar;\n      mdCreateModbusRTUSlave(&mdhandler, info);\n   }\n\n   ModbusInit();\n```\n\n1.3 \u8c03\u7528\u5fc3\u8df3\u51fd\u6570\uff1a\n\n```\n   #define TIMER_UTIME  100  \/\/\u5b9a\u65f6\u5668\u5468\u671f\u4e3a100us\n\n   static void timer_handler(void)  \/\/100us\u5b9a\u65f6\u5668\u56de\u8c03\u51fd\u6570\n   {\n      mdhandler->portRTUTimerTick(mdhandler, TIMER_UTIME);\n   }\n```\n\n1.4 \u4ece\u4e32\u53e3\u63a5\u6536\u6570\u636e\uff1a\n\n```\n   static void usart_rec_handler(char *buf, size_t len)   \/\/\u4e32\u53e3\u63a5\u6536\u4e2d\u65ad\u51fd\u6570\n   {\n      for (size_t i = 0; i < len; i++)\n      {\n         mdhandler->portRTUPushChar(mdhandler, buf[i]);\n      }\n   }\n```\n\n- **\u5199\u5165\u548c\u8bfb\u53d6\u4ece\u673a\u5bc4\u5b58\u5668** 2.1 \u8bfb\u53d6\u8f93\u5165\u7ebf\u5708\uff1a\n\n```\n   mdBit bit;\n   mdU32 addr = 0;\n   mdSTATUS ret;\n   ret = mdhandler->registerPool->mdReadInputCoil(mdhandler->registerPool, addr, &bit);   \/\/\u8bfb\u53d6\u8f93\u5165\u7ebf\u5708\uff0c\u8bbe\u5907\u5730\u5740\u4e3a10001\n   if (ret == mdFALSE)\n   {\n      printf("\u8bfb\u53d6\u5931\u8d25\\n");\n   }\n```\n\n2.2 \u8bfb\u53d6\u4fdd\u6301\u5bc4\u5b58\u5668\uff1a\n\n```\n   mdU16 data;\n   mdU32 addr = 0;\n   mdSTATUS ret;\n   ret = mdhandler->registerPool->mdReadHoldRegister(mdhandler->registerPool, addr, &data);    \/\/\u8bfb\u53d6\u4fdd\u6301\u5bc4\u5b58\u5668\uff0c\u5730\u5740\u4e3a40001\n   if (ret == mdFALSE)\n   {\n      printf("\u8bfb\u53d6\u5931\u8d25\\n");\n   }\n```\n\n2.3 \u5199\u5165\u8f93\u5165\u7ebf\u5708\uff1a\n\n```\n   mdBit bit = mdHigh;\n   mdU32 addr = 0;\n   mdSTATUS ret;\n   ret = mdhandler->registerPool->mdWriteInputCoil(mdhandler->registerPool, addr, bit);   \/\/\u5199\u5165\u8f93\u5165\u7ebf\u5708\uff0c\u5730\u5740\u4e3a10001\uff0c\u9ad8\u7535\u5e73\n   if (ret == mdFALSE)\n   {\n      printf("\u5199\u5165\u5931\u8d25\\n");\n   }\n```\n\n2.4 \u5199\u5165\u4fdd\u6301\u5bc4\u5b58\u5668\uff1a\n\n```\n   mdU16 data = 0x1234;\n   mdU32 addr = 0;\n   mdSTATUS ret;\n   ret = mdhandler->registerPool->mdWriteHoldRegister(mdhandler->registerPool, addr, data);  \/\/\u5199\u5165\u4fdd\u6301\u5bc4\u5b58\u5668\uff0c\u5730\u5740\u4e3a40001\uff0c\u5927\u5c0f\u4e3a0x1234\n   if (ret == mdFALSE)\n   {\n      printf("\u5199\u5165\u5931\u8d25\\n");\n   }\n```\n\n2.5 \u5176\u4ed6\u5bc4\u5b58\u5668\u64cd\u4f5cAPI\uff08\u63a8\u8350\u65b9\u5f0f\uff09\uff1a\n\n```\n   \/*\u4e0d\u63a8\u8350*\/\n    mdSTATUS (*mdReadBit)(RegisterPoolHandle handler,mdU32 addr,mdBit *bit);\n    mdSTATUS (*mdWriteBit)(RegisterPoolHandle handler,mdU32 addr,mdBit bit);\n    mdSTATUS (*mdReadBits)(RegisterPoolHandle handler,mdU32 addr,mdU32 len,mdBit *bits);\n    mdSTATUS (*mdWriteBits)(RegisterPoolHandle handler,mdU32 addr,mdU32 len,mdBit *bits);\n    mdSTATUS (*mdReadU16)(RegisterPoolHandle handler,mdU32 addr,mdU16 *data);\n    mdSTATUS (*mdWriteU16)(RegisterPoolHandle handler,mdU32 addr,mdU16 data);\n    mdSTATUS (*mdReadU16s)(RegisterPoolHandle handler,mdU32 addr,mdU32 len,mdU16 *data);\n    mdSTATUS (*mdWriteU16s)(RegisterPoolHandle handler,mdU32 addr,mdU32 len,mdU16 *data);\n\n   \/*\u63a8\u8350*\/\n    mdSTATUS (*mdReadCoil)(RegisterPoolHandle handler, mdU32 addr, mdBit* bit);  \/\/\u8bbe\u5907\u5730\u57401\uff5e10000\uff0caddr=0 -> \u8bbe\u59071\n    mdSTATUS (*mdReadCoils)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdBit* bits);\n    mdSTATUS (*mdWriteCoil)(RegisterPoolHandle handler, mdU32 addr, mdBit bit);\n    mdSTATUS (*mdWriteCoils)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdBit* bits);\n    mdSTATUS (*mdReadInputCoil)(RegisterPoolHandle handler, mdU32 addr, mdBit* bit);   \/\/\u8bbe\u5907\u5730\u574010001\uff5e20000\uff0caddr=0 -> \u8bbe\u590710001\n    mdSTATUS (*mdReadInputCoils)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdBit* bits);\n    mdSTATUS (*mdWriteInputCoil)(RegisterPoolHandle handler, mdU32 addr, mdBit bit);\n    mdSTATUS (*mdWriteInputCoils)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdBit* bits);\n    mdSTATUS (*mdReadInputRegister)(RegisterPoolHandle handler, mdU32 addr, mdU16* data);\/\/\u8bbe\u5907\u5730\u574030001\uff5e40000\uff0caddr=0 -> \u8bbe\u590730001\n    mdSTATUS (*mdReadInputRegisters)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdU16* data);\n    mdSTATUS (*mdWriteInputRegister)(RegisterPoolHandle handler, mdU32 addr, mdU16 data);\n    mdSTATUS (*mdWriteInputRegisters)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdU16* data);\n    mdSTATUS (*mdReadHoldRegister)(RegisterPoolHandle handler, mdU32 addr, mdU16* data);\/\/\u8bbe\u5907\u5730\u574040001\uff5e50000\uff0caddr=0 -> \u8bbe\u590740001\n    mdSTATUS (*mdReadHoldRegisters)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdU16* data);\n    mdSTATUS (*mdWriteHoldRegister)(RegisterPoolHandle handler, mdU32 addr, mdU16 data);\n    mdSTATUS (*mdWriteHoldRegisters)(RegisterPoolHandle handler, mdU32 addr, mdU32 len, mdU16* data);\n```\n\n\u8fd8\u6709\u5176\u4ed6\u5bc4\u5b58\u5668\u64cd\u4f5cAPI\uff0c\u6bd4\u5982mdReadCoil\u3001mdReadInputCoil\u3001mdReadInputRegister\u7b49\uff0c\u5b83\u4eec\u66f4\u7b26\u5408Modbus\u53d8\u91cf\u5730\u5740\u7684\u89c4\u8303\uff0c\u53ef\u4ee5\u66f4\u65b9\u4fbf\u5730\u8bfb\u53d6\u548c\u5199\u5165\u5bc4\u5b58\u5668\u503c\u3002\n\n**Modbus\u53d8\u91cf\u5730\u5740**\n\nModbus\u53d8\u91cf\u5730\u5740\u8868\u793a\u4e86Modbus\u901a\u4fe1\u4e2d\u4e0d\u540c\u5bc4\u5b58\u5668\u7684\u4f4d\u7f6e\u548c\u7c7b\u578b\u3002\u8fd9\u4e9b\u5730\u5740\u662fModbus\u534f\u8bae\u7684\u4e00\u90e8\u5206\uff0c\u7528\u4e8e\u6307\u5b9a\u8981\u8bfb\u53d6\u6216\u5199\u5165\u7684\u5bc4\u5b58\u5668\u3002\u4ee5\u4e0b\u662f\u5e38\u89c1\u7684Modbus\u53d8\u91cf\u5730\u5740\u53ca\u5176\u542b\u4e49\uff1a\n\n- 0xxxx\uff1a\u8fd9\u662f\u7ebf\u5708\u5bc4\u5b58\u5668\u5730\u5740\uff0c\u5bf9\u5e94Function Code 01\uff08\u8bfb\u53d6\u7ebf\u5708\uff09\u548cFunction Code 05\uff08\u5199\u5355\u4e2a\u7ebf\u5708\uff09\u3002\u5b83\u4eec\u7528\u4e8e\u63a7\u5236\u5f00\u5173\u8bbe\u5907\u7b49\uff0c\u662f\u53ef\u8bfb\u5199\u7684\u3002\n\n- 1xxxx\uff1a\u8fd9\u662f\u8f93\u5165\u7ebf\u5708\u5bc4\u5b58\u5668\u5730\u5740\uff0c\u5bf9\u5e94Function Code 02\uff08\u8bfb\u53d6\u8f93\u5165\u7ebf\u5708\uff09\u3002\u5b83\u4eec\u7528\u4e8e\u8868\u793a\u8f93\u5165\u4fe1\u53f7\uff0c\u901a\u5e38\u662f\u53ea\u8bfb\u7684\u3002\n\n- 3xxxx\uff1a\u8fd9\u662f\u8f93\u5165\u5bc4\u5b58\u5668\u5730\u5740\uff0c\u5bf9\u5e94Function Code 04\uff08\u8bfb\u53d6\u8f93\u5165\u5bc4\u5b58\u5668\uff09\u3002\u6bcf\u4e2a\u5bc4\u5b58\u5668\u8868\u793a\u4e00\u4e2a16\u4f4d\u65e0\u7b26\u53f7\u6574\u6570\uff0c\u901a\u5e38\u662f\u53ea\u8bfb\u7684\u3002\n\n- 4xxxx\uff1a\u8fd9\u662f\u4fdd\u6301\u5bc4\u5b58\u5668\u5730\u5740\uff0c\u5bf9\u5e94Function Code 03\uff08\u8bfb\u53d6\u4fdd\u6301\u5bc4\u5b58\u5668\uff09\u3001Function Code 06\uff08\u5199\u5355\u4e2a\u4fdd\u6301\u5bc4\u5b58\u5668\uff09\u548cFunction Code 16\uff08\u5199\u591a\u4e2a\u4fdd\u6301\u5bc4\u5b58\u5668\uff09\u3002\u5b83\u4eec\u7528\u4e8e\u5b58\u50a8\u8bbe\u5907\u53c2\u6570\u3001\u72b6\u6001\u7b49\u4fe1\u606f\uff0c\u662f\u53ef\u8bfb\u5199\u7684\u3002\n\n\u8fd9\u4e9b\u5730\u5740\u7c7b\u578b\u548c\u529f\u80fd\u7801\u662fModbus\u901a\u4fe1\u7684\u6838\u5fc3\u90e8\u5206\uff0c\u901a\u8fc7\u5b83\u4eec\uff0c\u4f60\u53ef\u4ee5\u8bfb\u53d6\u548c\u5199\u5165\u8bbe\u5907\u7684\u4e0d\u540c\u5bc4\u5b58\u5668\uff0c\u5b9e\u73b0\u5bf9\u8bbe\u5907\u7684\u76d1\u63a7\u548c\u63a7\u5236\u3002\n\n\u603b\u4e4b\uff0cFreeModbus\u5e93\u63d0\u4f9b\u4e86\u65b9\u4fbf\u7684\u65b9\u5f0f\u6765\u521b\u5efaModbus RTU\u4ece\u673a\uff0c\u5e76\u8fdb\u884c\u5bc4\u5b58\u5668\u7684\u8bfb\u53d6\u548c\u5199\u5165\u64cd\u4f5c\uff0c\u800cModbus\u53d8\u91cf\u5730\u5740\u5219\u5b9a\u4e49\u4e86\u4e0d\u540c\u5bc4\u5b58\u5668\u7684\u7c7b\u578b\u548c\u529f\u80fd\uff0c\u5e2e\u52a9\n\n---\n*modbus.cn*\n"