通信嵌入式物聯(lián)網(wǎng)【免費下載鏈接】libmodbusA Modbus library for Linux, Mac OS, FreeBSD and Windows項目地址https://gitcode.com/gh_mirrors/li/libmodbus點擊查看免費下載導讀本文以 libmodbus 官方文檔 docs/modbus_read_input_registers.md 為主線系統(tǒng)講解modbus_read_input_registers()這一核心 API如何通過 Modbus 功能碼 0x04 一次批量讀取從站Slave/Server的輸入寄存器涵蓋函數(shù)簽名、參數(shù)約束、返回值與錯誤碼、RTU/TCP 兩種后端下的請求幀構(gòu)造、底層源碼實現(xiàn)以及配套測試用例。讀完本文你將能在 Linux、macOS、FreeBSD 或 Windows 上編寫出可靠的輸入寄存器采集程序并理解其與保持寄存器holding registers讀取在協(xié)議語義上的差異。函數(shù)簽名與頭文件modbus_read_input_registers()聲明在公共頭文件 src/modbus.h 中屬于 libmodbus 公開 API 的一員int modbus_read_input_registers(modbus_t *ctx, int addr, int nb, uint16_t *dest);使用前需#include modbus.h并通過 modbus_new_rtu() 或 modbus_new_tcp() / modbus_new_tcp_pi() 創(chuàng)建modbus_t *ctx上下文再調(diào)用 modbus_connect() 建立連接。函數(shù)在 src/modbus.c 中實現(xiàn)。功能概述一次讀取多個輸入寄存器該函數(shù)讀取遠程設(shè)備中起始地址為addr、數(shù)量為nb的輸入寄存器并將讀取結(jié)果以 16 位字word的形式存入dest數(shù)組。它使用 Modbus 功能碼0x04Read Input Registers與讀取保持寄存器的 0x03 相對。在 Modbus 協(xié)議的歷史語義中輸入寄存器Input Registers只讀通常承載設(shè)備的測量值、狀態(tài)量如溫度、電壓、傳感器采樣由設(shè)備本身維護客戶端只能讀不能寫保持寄存器Holding Registers可讀寫用于存放可配置參數(shù)或可更新的數(shù)據(jù)區(qū)。官方文檔也明確指出隨著工業(yè)實踐演進如今更常見的是只使用保持寄存器。因此modbus_read_input_registers()主要用于對接那些仍然遵循輸入寄存器只讀傳統(tǒng)布局的老式設(shè)備或特定儀表。參數(shù)說明參數(shù)含義約束ctxlibmodbus 上下文指針不能為 NULL否則返回 -1 并置errno EINVALaddr起始寄存器地址0 起始需在設(shè)備地址范圍內(nèi)越界由從站返回異常響應(yīng)nb要讀取的寄存器數(shù)量必須 ≥ 1 且 ≤MODBUS_MAX_READ_REGISTERS125dest存放讀取結(jié)果的uint16_t數(shù)組必須分配至少nb * sizeof(uint16_t)字節(jié)緩沖區(qū)責任在調(diào)用方dest數(shù)組必須由調(diào)用者預先分配且容量足夠容納全部寄存器這是文檔強調(diào)的硬性前提Thedestarray must be allocated with at leastnb * sizeof(uint16_t)bytes. It is the callers responsibility to ensure the buffer is large enough to hold all the registers to be read.即uint16_t dest[nb];或malloc(nb * sizeof(uint16_t))均可但絕不能分配不足。返回值成功返回實際讀取到的寄存器個數(shù)即nb失敗返回 -1并通過errno報告具體錯誤可用 modbus_strerror() 獲取可讀的錯誤描述。錯誤碼詳解官方文檔列出了兩種明確的錯誤場景此外還有網(wǎng)絡(luò)層面的錯誤會透傳自底層send_msg/_modbus_receive_msgEINVALctx或dest為 NULL或nb小于 1。見 src/modbus.c 中的顯式校驗EMBXILVAL請求的寄存器數(shù)量超出上限nb MODBUS_MAX_READ_REGISTERS。EMBXILVAL在 src/modbus.h 中定義為MODBUS_ENOBASE MODBUS_EXCEPTION_ILLEGAL_DATA_VALUE即非法數(shù)據(jù)值協(xié)議異常對應(yīng)的本地錯誤碼。另外需注意函數(shù)內(nèi)部雖會對nb做本地校驗但addr是否越界屬于從站側(cè)裁決的范疇——若地址非法從站會回送MODBUS_EXCEPTION_ILLEGAL_DATA_ADDRESS0x02異常幀此時函數(shù)同樣返回 -1errno被置為EMBXILADD見 src/modbus.h這一點在單元測試中也有覆蓋下文詳述。源碼級原理剖析1. 參數(shù)校驗與功能碼分發(fā)入口函數(shù)在 src/modbus.c 中的邏輯非常清晰先校驗ctx、dest非空且nb在[1, MODBUS_MAX_READ_REGISTERS]范圍內(nèi)隨后把實際工作委托給靜態(tài)函數(shù)read_registers()并傳入功能碼MODBUS_FC_READ_INPUT_REGISTERS值為 0x04定義于 src/modbus.hint modbus_read_input_registers(modbus_t *ctx, int addr, int nb, uint16_t *dest) { int status; if (ctx NULL || dest NULL) { errno EINVAL; return -1; } if (nb 1 || nb MODBUS_MAX_READ_REGISTERS) { if (ctx-debug) { fprintf(stderr, ERROR Too many input registers requested (%d %d)\n, nb, MODBUS_MAX_READ_REGISTERS); } errno EMBXILVAL; return -1; } status read_registers(ctx, MODBUS_FC_READ_INPUT_REGISTERS, addr, nb, dest); return status; }可見啟用調(diào)試模式modbus_set_debug()時越界請求會在 stderr 打印詳細提示方便排障。2. 底層 read_registers建幀、發(fā)送、收幀、解析核心的read_registers()位于 src/modbus.c是 0x03 與 0x04 兩個功能碼共用的實現(xiàn)這正是兩個 API 行為對稱的原因static int read_registers(modbus_t *ctx, int function, int addr, int nb, uint16_t *dest) { int rc; int req_length; uint8_t req[_MIN_REQ_LENGTH]; uint8_t rsp[MAX_MESSAGE_LENGTH]; if (nb MODBUS_MAX_READ_REGISTERS) { ... errno EMBXILVAL; return -1; } req_length ctx-backend-build_request_basis(ctx, function, addr, nb, req); rc send_msg(ctx, req, req_length); if (rc 0) { unsigned int offset; int i; rc _modbus_receive_msg(ctx, rsp, MSG_CONFIRMATION); if (rc -1) return -1; rc check_confirmation(ctx, req, rsp, rc); if (rc -1) return -1; offset ctx-backend-header_length; for (i 0; i rc; i) { /* shift reg hi_byte to temp OR with lo_byte */ dest[i] (rsp[offset 2 (i 1)] 8) | rsp[offset 3 (i 1)]; } } return rc; }關(guān)鍵點有三個請求幀由后端backend構(gòu)造ctx-backend-build_request_basis是抽象接口RTU 與 TCP 各有實現(xiàn)響應(yīng)校驗check_confirmation()負責比對功能碼、地址與字節(jié)數(shù)是否一致任何異常含從站回送的協(xié)議異常幀都會在此轉(zhuǎn)化為 -1 與對應(yīng)errno字節(jié)序轉(zhuǎn)換Modbus 線上傳輸為大端序高位字節(jié)在前解析時通過(高字節(jié) 8) | 低字節(jié)還原為處理器本機字節(jié)序存入dest。這一點非常重要dest中的值已經(jīng)是主機序的 16 位整數(shù)可直接參與運算無需再手工翻轉(zhuǎn)。3. 兩種后端的請求幀構(gòu)造RTU 后端串口 / RS-485在 src/modbus-rtu.c 中構(gòu)造的 PDU 為[從站地址(1)][功能碼(1)][起始地址高(1)][起始地址低(1)][數(shù)量高(1)][數(shù)量低(1)]之后由_modbus_rtu_send追加 CRC16 校驗static int _modbus_rtu_build_request_basis( modbus_t *ctx, int function, int addr, int nb, uint8_t *req) { assert(ctx-slave ! -1); req[0] ctx-slave; /* 從站地址 */ req[1] function; /* 0x04 */ req[2] addr 8; /* 起始地址高字節(jié) */ req[3] addr 0x00ff; /* 起始地址低字節(jié) */ req[4] nb 8; /* 數(shù)量高字節(jié) */ req[5] nb 0x00ff; /* 數(shù)量低字節(jié) */ return _MODBUS_RTU_PRESET_REQ_LENGTH; }注意 RTU 后端要求先通過 modbus_set_slave() 設(shè)置從站地址assert(ctx-slave ! -1)即此約束。TCP 后端在 src/modbus-tcp.c 中會在 PDU 前追加 MBAP 頭事務(wù) ID、協(xié)議 ID、長度、單元 ID并自動遞增事務(wù) IDt_idmodbus_new_tcp_pi()創(chuàng)建的 PI 后端src/modbus-tcp.c復用同一套建幀邏輯只是地址解析方式不同。兩種 TCP 后端的 ADU 上限均為 260 字節(jié)src/modbus.h。4. 服務(wù)端從站側(cè)如何應(yīng)答 0x04在服務(wù)端程序中modbus_reply()對MODBUS_FC_READ_HOLDING_REGISTERS與MODBUS_FC_READ_INPUT_REGISTERS走同一分支src/modbus.c通過is_input區(qū)分取數(shù)來源case MODBUS_FC_READ_HOLDING_REGISTERS: case MODBUS_FC_READ_INPUT_REGISTERS: { unsigned int is_input (function MODBUS_FC_READ_INPUT_REGISTERS); int start_registers is_input ? mb_mapping-start_input_registers : mb_mapping-start_registers; int nb_registers is_input ? mb_mapping-nb_input_registers : mb_mapping-nb_registers; uint16_t *tab_registers is_input ? mb_mapping-tab_input_registers : mb_mapping-tab_registers; ... int mapping_address address - start_registers; if (nb 1 || MODBUS_MAX_READ_REGISTERS nb) { /* 回送 ILLEGAL_DATA_VALUE 異常 */ } else if (mapping_address 0 || (mapping_address nb) nb_registers) { /* 回送 ILLEGAL_DATA_ADDRESS 異常 */ } else { rsp_length ctx-backend-build_response_basis(sft, rsp); rsp[rsp_length] nb 1; /* 數(shù)據(jù)字節(jié)數(shù) 寄存器數(shù) × 2 */ for (i mapping_address; i mapping_address nb; i) { rsp[rsp_length] tab_registers[i] 8; /* 高字節(jié) */ rsp[rsp_length] tab_registers[i]; /* 低字節(jié) */ } } } break;這段代碼印證了兩點協(xié)議行為輸入寄存器數(shù)據(jù)存放在映射結(jié)構(gòu)modbus_mapping_t的tab_input_registers數(shù)組中src/modbus.h服務(wù)端用 modbus_mapping_new() 或 modbus_mapping_new_start_address() 創(chuàng)建映射時需為其分配空間響應(yīng)中每個寄存器占 2 字節(jié)、大端序發(fā)送與客戶端解析邏輯高字節(jié) 8 | 低字節(jié)正好一一對應(yīng)。5. 上限約束的來源MODBUS_MAX_READ_REGISTERS定義為 125src/modbus.h其依據(jù)是 Modbus 應(yīng)用協(xié)議規(guī)范Modbus_Application_Protocol_V1_1b.pdf第 6 章第 3 節(jié)單次讀寄存器請求的數(shù)量上限為 1125。這一限制源自串行鏈路 256 字節(jié) ADU 的約束253 字節(jié) PDU見 src/modbus.h。因此無論 RTU 還是 TCP一次modbus_read_input_registers()最多只能取 125 個寄存器超過即觸發(fā)EMBXILVAL讀取更多數(shù)據(jù)需分段多次調(diào)用。完整可運行示例下面是一個 RTU 客戶端完整采集輸入寄存器的示例可直接作為工程模板#include stdio.h #include stdlib.h #include stdint.h #include modbus.h #define NB_REGISTERS 10 int main(void) { modbus_t *ctx; uint16_t dest[NB_REGISTERS]; int rc, i; /* 1. 創(chuàng)建 RTU 上下文設(shè)備、波特率、校驗、數(shù)據(jù)位、停止位 */ ctx modbus_new_rtu(/dev/ttyUSB0, 9600, N, 8, 1); if (ctx NULL) { fprintf(stderr, Unable to create the libmodbus context\n); return -1; } /* 2. 指定從站地址RTU 必需 */ modbus_set_slave(ctx, 1); /* 3. 建立連接打開串口 */ if (modbus_connect(ctx) -1) { fprintf(stderr, Connection failed: %s\n, modbus_strerror(errno)); modbus_free(ctx); return -1; } /* 4. 讀取從地址 0 開始的 10 個輸入寄存器 */ rc modbus_read_input_registers(ctx, 0, NB_REGISTERS, dest); if (rc -1) { fprintf(stderr, modbus_read_input_registers failed: %s\n, modbus_strerror(errno)); } else { printf(Read %d input registers:\n, rc); for (i 0; i rc; i) { printf(reg[%d] 0x%04X (%u)\n, i, dest[i], dest[i]); } } /* 5. 清理 */ modbus_close(ctx); modbus_free(ctx); return 0; }要點回顧nb取值 1125dest容量nb * sizeof(uint16_t)TCP 場景只需將創(chuàng)建上下文換成modbus_new_tcp(192.168.1.100, 502)并去掉modbus_set_slave()的強制要求TCP 下從站地址經(jīng) MBAP 單元 ID 傳遞默認 255見 modbus_set_slave()返回值是實際讀取的寄存器數(shù)判斷成功請與nb比較或檢查是否-1。服務(wù)端配套如何提供輸入寄存器數(shù)據(jù)若需模擬從站供上述客戶端讀取服務(wù)端需在映射中初始化tab_input_registers對應(yīng)功能碼 0x04 的數(shù)據(jù)源。倉庫測試 tests/unit-test-server.c 展示了這一模式mb_mapping modbus_mapping_new(UT_BITS_ADDRESS, UT_BITS_NB, UT_INPUT_BITS_ADDRESS, UT_INPUT_BITS_NB, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB_MAX, UT_INPUT_REGISTERS_ADDRESS, UT_INPUT_REGISTERS_NB); ... /* Initialize values of INPUT REGISTERS */ for (i 0; i UT_INPUT_REGISTERS_NB; i) { mb_mapping-tab_input_registers[i] UT_INPUT_REGISTERS_TAB[i]; }隨后在modbus_receive()/modbus_reply()循環(huán)中即可響應(yīng)客戶端的 0x04 請求。測試用例驗證libmodbus 自帶完整的單元測試可直接驗證本文所述行為運行tests/unit-tests.sh或參考 tests/Makefile.am正常讀取客戶端 tests/unit-test-client.c 從地址0x108讀取UT_INPUT_REGISTERS_NB1 個輸入寄存器斷言返回值等于nb并逐元素比對期望值{0x000A}定義于 tests/unit-test.h.inrc modbus_read_input_registers( ctx, UT_INPUT_REGISTERS_ADDRESS, UT_INPUT_REGISTERS_NB, tab_rp_registers); printf(1/1 modbus_read_input_registers: ); ASSERT_TRUE(rc UT_INPUT_REGISTERS_NB, FAILED (nb points %d)\n, rc);越界地址tests/unit-test-client.c 驗證讀取地址 0 及UT_INPUT_REGISTERS_ADDRESS nb超出映射范圍時返回 -1 且errno EMBXILADD從站回送非法數(shù)據(jù)地址異常超量請求tests/unit-test-client.c 驗證請求MODBUS_MAX_READ_REGISTERS 1即 126個寄存器時返回 -1 且errno EMBXILVAL與文檔 Errors 一節(jié)完全對應(yīng)代理proxy鏈路tests/proxy-test-client.c 通過modbus_proxy()轉(zhuǎn)發(fā)后讀取輸入寄存器驗證經(jīng)網(wǎng)關(guān)代理后功能碼 0x04 的數(shù)據(jù)路徑依然正確。常見問題與注意事項為什么返回 -1 但 errno 是EMBXILADD這表示請求已到達從站但從站認為地址越界并回送了異常幀屬于協(xié)議級錯誤而非本地參數(shù)錯誤可通過 modbus_strerror() 打印 Illegal data address 類描述。如何讀取超過 125 個輸入寄存器分段調(diào)用例如讀取 300 個寄存器可拆成 3 次125 125 50每次用不同的addr與nb組合注意dest的偏移。dest中的值是大端還是小端已由 libmodbus 統(tǒng)一轉(zhuǎn)換為處理器本機字節(jié)序直接使用即可只有當你自行構(gòu)造原始幀modbus_send_raw_request()時才需要關(guān)心線上大端序。串口上的從站地址RTU 后端建幀時assert(ctx-slave ! -1)忘記調(diào)用 modbus_set_slave() 會在調(diào)試構(gòu)建中直接斷言失敗。輸入寄存器與保持寄存器如何選擇優(yōu)先使用 modbus_read_registers()0x03僅當設(shè)備手冊明確將數(shù)據(jù)放在輸入寄存器區(qū)域只讀測量區(qū)時才使用本文的 0x04 讀取。參見modbus_read_input_bits() 讀取輸入位功能碼 0x02modbus_read_registers() 讀取保持寄存器功能碼 0x03modbus_write_register() 寫單個保持寄存器modbus_write_registers() 寫多個保持寄存器公共 API 聲明與常量定義src/modbus.h核心實現(xiàn)src/modbus.c單元測試tests/unit-test-client.c、tests/unit-test-server.c、tests/unit-test.h.in贊分享通信嵌入式物聯(lián)網(wǎng)【免費下載鏈接】libmodbusA Modbus library for Linux, Mac OS, FreeBSD and Windows項目地址https://gitcode.com/gh_mirrors/li/libmodbus點擊查看免費下載相關(guān)推薦libmodbus源碼架構(gòu)分析深入理解Modbus協(xié)議實現(xiàn)原理libmodbus源碼架構(gòu)分析深入理解Modbus協(xié)議實現(xiàn)原理 libmodbus是一個功能強大的開源Modbus協(xié)議庫它提供了完整的Modbus協(xié)議棧實現(xiàn)通信嵌入式物聯(lián)網(wǎng)NetworkX 地理空間網(wǎng)絡(luò)分析實戰(zhàn)指南GeoPandas、PySAL、momepy 與 OSMnx 生態(tài)協(xié)同NetworkX 地理空間網(wǎng)絡(luò)分析實戰(zhàn)指南GeoPandas、PySAL、momepy 與 OSMnx 生態(tài)協(xié)同 地理空間數(shù)據(jù)點、線、面的網(wǎng)絡(luò)化建模是 N通信嵌入式物聯(lián)網(wǎng)TiXL 上下文變量讀取算子 GetVec3Var 完全指南原理、用法與源碼剖析TiXL 上下文變量讀取算子 GetVec3Var 完全指南原理、用法與源碼剖析 本篇技術(shù)指南圍繞 TiXL開源實時動態(tài)圖形創(chuàng)作軟件算子庫 Lib.flo音視頻圖形學桌面應(yīng)用上一篇ClaudeComputerCommander 計算機健康檢查Linux 只讀診斷命令集與解讀指南下一篇Obsidian CSS自定義實戰(zhàn)指南3個階段實現(xiàn)界面優(yōu)化與效率飛躍創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考