試實(shí)戰(zhàn)：幀格式、寄存器映射與物理層排查指南)
RS-485的A/B線明明焊對(duì)了示波器上也有波形設(shè)備就是不回?cái)?shù)據(jù)。這是我調(diào)MODBUS從站時(shí)卡得最久的一次后來(lái)發(fā)現(xiàn)是終端電阻沒焊信號(hào)反射把從站芯片的接收引腳電平直接拉死在不確定區(qū)。這種問題在文檔里永遠(yuǎn)查不到只有拿串口抓報(bào)文再對(duì)著協(xié)議一條條比對(duì)才能定位。所以這篇筆記我不打算寫成MODBUS協(xié)議手冊(cè)的翻譯版而是從幀格式的字節(jié)級(jí)細(xì)節(jié)、地址模型的存儲(chǔ)區(qū)映射、調(diào)試工具鏈的搭建到完整排查方法論把整個(gè)調(diào)通過(guò)程里有價(jià)值的東西一次性梳理清楚。先說(shuō)適用范圍如果你在用STM32、ESP32這類MCU做設(shè)備聯(lián)網(wǎng)或者維護(hù)PLC、變頻器、智能儀表這類工業(yè)設(shè)備需要和上位機(jī)組態(tài)軟件、觸摸屏、網(wǎng)關(guān)通信這篇文章能幫你省掉大量在協(xié)議細(xì)節(jié)上浪費(fèi)的時(shí)間。如果你是剛接觸MODBUS的初學(xué)者建議先動(dòng)手把0x03讀保持寄存器這個(gè)功能碼完整調(diào)通一次再回頭看地址映射的章節(jié)。1. 幀格式的字節(jié)級(jí)拆解從協(xié)議棧底層看MODBUS RTU的消息邊界MODBUS RTU的消息幀沒有像TCP那樣的長(zhǎng)度字段也沒有像UART幀那樣自帶起始位和停止位它完全依靠幀間靜默時(shí)間來(lái)劃分消息邊界。這就要求同一個(gè)幀里相鄰兩個(gè)字符的間隔不能超過(guò)1.5個(gè)字符時(shí)間而幀與幀之間的間隔必須大于等于3.5個(gè)字符時(shí)間。這個(gè)定義看著簡(jiǎn)單實(shí)際用MCU實(shí)現(xiàn)時(shí)卻是第一個(gè)坑。1.1 為什么字符間隔決定了整個(gè)協(xié)議棧的可靠性假設(shè)波特率是9600一個(gè)字符包含1個(gè)起始位、8個(gè)數(shù)據(jù)位、1個(gè)停止位無(wú)校驗(yàn)總共10位那么1個(gè)字符時(shí)間約為1.04ms3.5個(gè)字符時(shí)間約為3.65ms。如果你的從站程序在接收完一個(gè)字節(jié)之后進(jìn)入了某個(gè)耗時(shí)比較長(zhǎng)的中斷處理函數(shù)恰好這個(gè)中斷占用了超過(guò)1.5個(gè)字符時(shí)間約1.56ms主站發(fā)來(lái)的后續(xù)字節(jié)就會(huì)被判定為另一個(gè)幀的起始整個(gè)報(bào)文直接被丟棄。我遇到過(guò)一種情況從站代碼里把接收放在串口中斷中但中斷服務(wù)函數(shù)里有一個(gè)用于打印調(diào)試信息的printf這個(gè)printf走的是阻塞式的UART發(fā)送波特率只有9600發(fā)送一個(gè)字符就要1ms左右如果打印十幾個(gè)字符整個(gè)中斷就被卡死了。結(jié)果就是主站輪詢寄存器時(shí)從站偶發(fā)無(wú)響應(yīng)但又不是每次都失敗用串口助手抓報(bào)文又看不出規(guī)律。后來(lái)把printf從接收中斷里挪到空閑時(shí)間處理占用率立刻恢復(fù)正常。這個(gè)問題的真實(shí)原因不是MODBUS協(xié)議本身的邏輯復(fù)雜度而是中斷響應(yīng)時(shí)間破壞了幀的連續(xù)性。所以后來(lái)我在做MODBUS從站框架時(shí)接收部分一律采用環(huán)形緩沖區(qū)加DMA空閑中斷的方案絕對(duì)不在中斷里做任何阻塞操作。1.2 CRC校驗(yàn)的位移寄存器運(yùn)算細(xì)節(jié)MODBUS RTU的CRC-16算法使用多項(xiàng)式0xA001反轉(zhuǎn)多項(xiàng)式對(duì)應(yīng)標(biāo)準(zhǔn)CRC-16/IBM初始值為0xFFFF。它的運(yùn)算過(guò)程是每個(gè)字節(jié)先與CRC低字節(jié)異或然后右移8次每次右移后如果最低位LSB為1就與0xA001異或。很多剛接觸的人不理解為什么多項(xiàng)式是0xA001而不是常見的0x8005因?yàn)檫@兩種寫法是同一條多項(xiàng)式的正序和反序表示。標(biāo)準(zhǔn)CRC-16/IBM的多項(xiàng)式是0x8005即x^16 x^15 x^2 1但MODBUS規(guī)范要求LSB-first也就是從最低位開始處理數(shù)據(jù)所以要把多項(xiàng)式按位反轉(zhuǎn)才得到0xA001。如果你用查表法實(shí)現(xiàn)CRC務(wù)必確認(rèn)表是由0xA001生成的。我曾經(jīng)在某個(gè)項(xiàng)目里直接拷貝了一個(gè)0x8005的查表法CRC函數(shù)結(jié)果模擬器測(cè)試時(shí)CRC校驗(yàn)全部錯(cuò)誤排查了很久才發(fā)現(xiàn)是表用錯(cuò)了。驗(yàn)證CRC是否正確的簡(jiǎn)單方法是用01 03 00 00 00 01這組數(shù)據(jù)計(jì)算CRC正確結(jié)果是84 0A低字節(jié)在前。如果結(jié)果不對(duì)你的CRC實(shí)現(xiàn)肯定有問題。2. 地址模型與存儲(chǔ)區(qū)映射為什么MODBUS寄存器編號(hào)從0開始卻要從1訪問MODBUS的地址模型是理解整個(gè)協(xié)議最核心的部分也是現(xiàn)場(chǎng)調(diào)試時(shí)最容易混淆的地方。這里有一個(gè)關(guān)鍵區(qū)分協(xié)議層的數(shù)據(jù)地址和應(yīng)用層的寄存器編號(hào)不是一回事。MODBUS協(xié)議規(guī)定數(shù)據(jù)地址從0開始編號(hào)比如0x03功能碼讀取保持寄存器的起始地址是0x0000。但是很多設(shè)備廠商在文檔里給出的寄存器地址卻是從40001開始的MODBUS協(xié)議傳統(tǒng)的寄存器編號(hào)方式即40001對(duì)應(yīng)數(shù)據(jù)地址0x000040002對(duì)應(yīng)數(shù)據(jù)地址0x0001。2.1 四個(gè)數(shù)據(jù)塊與功能碼的對(duì)應(yīng)關(guān)系MODBUS定義了四種數(shù)據(jù)塊線圈Coil、離散輸入Discrete Input、輸入寄存器Input Register、保持寄存器Holding Register。它們的區(qū)別在于讀寫權(quán)限和數(shù)據(jù)類型數(shù)據(jù)塊位/字讀寫權(quán)限對(duì)應(yīng)功能碼讀/寫線圈Coil位可讀寫0x01 / 0x05, 0x0F離散輸入Discrete Input位只讀0x02 / 無(wú)輸入寄存器Input Register16位字只讀0x04 / 無(wú)保持寄存器Holding Register16位字可讀寫0x03 / 0x06, 0x10現(xiàn)場(chǎng)調(diào)試時(shí)我習(xí)慣先畫一張地址映射表明確每個(gè)數(shù)據(jù)點(diǎn)在哪個(gè)數(shù)據(jù)塊、偏移量是多少。比如一個(gè)溫控器設(shè)備保持寄存器的0x0000是當(dāng)前溫度只讀0x0001是目標(biāo)溫度可讀寫。那上位機(jī)想讀當(dāng)前溫度就要用0x03功能碼、起始地址0x0000、寄存器數(shù)量0x0001。很多組態(tài)軟件或觸摸屏在變量配置界面里填地址時(shí)會(huì)直接讓你填40001這種形式它內(nèi)部會(huì)自動(dòng)換算成數(shù)據(jù)地址0x0000。如果你在代碼里把寄存器編號(hào)40001當(dāng)成數(shù)據(jù)地址0x0000來(lái)用就完全正確但如果你直接在協(xié)議幀里填40001的十六進(jìn)制0x9C41那就會(huì)發(fā)瘋。2.2 偏移1的坑廠商文檔與協(xié)議標(biāo)準(zhǔn)的錯(cuò)位這個(gè)問題在MODBUS協(xié)議里非常常見就是Offset by One問題。不同廠商的文檔風(fēng)格截然不同有些設(shè)備手冊(cè)直接給數(shù)據(jù)地址有些給PLC風(fēng)格的寄存器編號(hào)如40001還有些給的是地址偏移加1的表示法。讀設(shè)備寄存器的時(shí)候一定要先用串口助手發(fā)一幀已知的報(bào)文確認(rèn)返回?cái)?shù)據(jù)在預(yù)期范圍內(nèi)再開始映射變量。我之前調(diào)試一個(gè)電表時(shí)設(shè)備的文檔寫溫度寄存器地址為0x0101我按這個(gè)地址去讀返回的數(shù)據(jù)完全沒規(guī)律后來(lái)發(fā)現(xiàn)文檔里的地址是協(xié)議地址加1的表示實(shí)際協(xié)議地址應(yīng)該是0x0100。這種錯(cuò)位屬于設(shè)備廠商的文檔定義習(xí)慣和MODBUS規(guī)范不一致讓人浪費(fèi)了一整天。2.3 32位數(shù)據(jù)的字節(jié)序陷阱16位寄存器只能表達(dá)0到65535但很多設(shè)備參數(shù)比如累計(jì)電量、頻率值×100、浮點(diǎn)數(shù)需要32位。這就要用兩個(gè)連續(xù)的16位寄存器來(lái)拼。問題來(lái)了兩個(gè)寄存器之間誰(shuí)高誰(shuí)低以及每個(gè)寄存器內(nèi)部的字節(jié)序大端/小端不同廠商定義不同。最常見的兩種組合是大端模式Big-EndianMotorola格式先存高16位寄存器再存低16位寄存器寄存器內(nèi)部也是高字節(jié)在前。比如32位值0x12345678第一個(gè)寄存器是0x1234第二個(gè)寄存器是0x5678。小端模式Little-EndianIntel格式先存低16位寄存器再存高16位寄存器。第一個(gè)寄存器是0x5678第二個(gè)寄存器是0x1234。這還沒完有些設(shè)備還會(huì)把寄存器內(nèi)部的字節(jié)序也調(diào)轉(zhuǎn)比如低字節(jié)在前組合方式就更多了。遇到32位參數(shù)讀數(shù)異常時(shí)建議先用相同的數(shù)據(jù)地址和功能碼分別用兩種字節(jié)序來(lái)解析至少能快速確定是不是字節(jié)序的問題。3. 從零開始寫一個(gè)從站/主站幀解析的狀態(tài)機(jī)設(shè)計(jì)說(shuō)到實(shí)現(xiàn)MODBUS RTU的從站核心其實(shí)就是一個(gè)字節(jié)狀態(tài)機(jī)。它需要處理兩種情況空閑幀間隔檢測(cè)和幀內(nèi)字符間隔超時(shí)。狀態(tài)機(jī)的設(shè)計(jì)直接決定了協(xié)議的健壯性。3.1 空閑檢測(cè)的兩種實(shí)現(xiàn)路徑第一種是定時(shí)器計(jì)數(shù)法。在串口接收中斷里每收到一個(gè)字節(jié)就復(fù)位一個(gè)定時(shí)器定時(shí)長(zhǎng)度設(shè)為3.5個(gè)字符時(shí)間定時(shí)器超時(shí)后觸發(fā)幀接收完成標(biāo)志。主循環(huán)檢測(cè)到標(biāo)志后對(duì)緩沖區(qū)里的數(shù)據(jù)做CRC校驗(yàn)并處理。這里的重點(diǎn)是定時(shí)器超時(shí)時(shí)間必須相對(duì)準(zhǔn)確太短會(huì)導(dǎo)致正常幀被拆斷太長(zhǎng)會(huì)導(dǎo)致兩個(gè)相鄰的幀被誤并成一個(gè)幀。第二種是DMA空閑中斷法。利用MCU的UART空閑中斷IDLE來(lái)檢測(cè)一幀結(jié)束。這種方案在STM32等MCU上比較省CPU接收數(shù)據(jù)直接進(jìn)DMA緩沖區(qū)空閑中斷觸發(fā)后從緩沖區(qū)里取數(shù)據(jù)。這種方式配合環(huán)形緩沖區(qū)效率高比較適合需要處理大量數(shù)據(jù)的場(chǎng)景。但需要注意STM32的IDLE中斷在一幀數(shù)據(jù)的最后一個(gè)字節(jié)之后觸發(fā)如果DMA緩沖區(qū)正好填滿會(huì)同時(shí)觸發(fā)傳輸完成中斷和空閑中斷代碼里要處理這種情況防止數(shù)據(jù)被覆蓋。3.2 功能碼的分發(fā)與異常響應(yīng)從站收到合法幀后需要按功能碼分發(fā)到不同的處理函數(shù)。MODBUS協(xié)議規(guī)定了異常響應(yīng)的標(biāo)準(zhǔn)格式從站地址 功能碼最高位置1 異常碼 CRC。常見異常碼包括異常碼含義常見場(chǎng)景0x01非法功能碼從站不支持該功能碼0x02非法數(shù)據(jù)地址讀取地址超范圍0x03非法數(shù)據(jù)值寫入的值超范圍0x04從站設(shè)備故障內(nèi)部錯(cuò)誤無(wú)法處理異常響應(yīng)在設(shè)計(jì)時(shí)必須認(rèn)真地實(shí)現(xiàn)因?yàn)橹髡究梢酝ㄟ^(guò)異常響應(yīng)判斷通訊狀態(tài)。如果主站發(fā)了一個(gè)不存在的功能碼從站什么都不回主站可能會(huì)一直等待到超時(shí)。而如果從站能迅速返回異常幀主站就能立刻知道功能碼不支持方便定位問題。我之前調(diào)試一個(gè)網(wǎng)關(guān)設(shè)備從站把異常響應(yīng)全部屏蔽掉了結(jié)果上位機(jī)那邊輪詢時(shí)報(bào)超時(shí)隔了很久才排查到從站的異常幀邏輯有缺陷把異常碼打印出來(lái)問題一下就清晰了。3.3 01功能碼離散輸出DO的讀寫模型與02功能碼的對(duì)應(yīng)關(guān)系01功能碼讀線圈和02功能碼讀離散輸入都是按位操作的。它們的數(shù)據(jù)組織方式是按位打包假設(shè)你讀起始地址0x0000的線圈數(shù)量8個(gè)返回的數(shù)據(jù)量是1個(gè)字節(jié)這個(gè)字節(jié)的每一位對(duì)應(yīng)一個(gè)線圈狀態(tài)最低位對(duì)應(yīng)起始地址0x0000的線圈狀態(tài)。超過(guò)8個(gè)線圈時(shí)一個(gè)字節(jié)不夠就需要多個(gè)字節(jié)響應(yīng)幀里數(shù)據(jù)量字節(jié)數(shù)由寄存器數(shù)量除以8向上取整決定。實(shí)現(xiàn)時(shí)要注意位打包的位序是低位在前。很多人在這里栽跟頭比如要讀取線圈地址0x0000到0x0007實(shí)際返回字節(jié)的第0位對(duì)應(yīng)地址0x0000第1位對(duì)應(yīng)0x0001以此類推。如果你把它們當(dāng)成高位在前解析結(jié)果就是完全不一樣的位序?qū)е翽LC和觸摸屏上顯示的狀態(tài)錯(cuò)亂。4. 調(diào)試工具的選型與實(shí)戰(zhàn)串口助手的正確打開方式工具是調(diào)試效率的根本。這里我把實(shí)際調(diào)MODBUS用到的工具鏈做一個(gè)橫向?qū)Ρ劝ù谥?、MODBUS調(diào)試助手、邏輯分析儀、總線分析儀再看看在嵌入式Linux環(huán)境下的調(diào)試思路。先提醒一點(diǎn)調(diào)試前去網(wǎng)上搜工具一定會(huì)看到類似推薦XX個(gè)MODBUS調(diào)試軟件的文章但真正好用的工具就那么幾個(gè)不要在選工具上浪費(fèi)太多時(shí)間。4.1 通用串口助手的使用邊界通用串口助手比如SSCOM適用于最底層的報(bào)文級(jí)調(diào)試。它能看到原始收發(fā)的十六進(jìn)制幀但需要你手動(dòng)計(jì)算CRC、手動(dòng)解析響應(yīng)效率不高。不過(guò)它有一個(gè)不可替代的優(yōu)勢(shì)完全沒有協(xié)議層過(guò)濾能捕捉到任何錯(cuò)誤幀和異常幀。如果設(shè)備一點(diǎn)反應(yīng)都不給我最先干的事就是用SSCOM直接發(fā)一幀看看有沒有任何返回?cái)?shù)據(jù)來(lái)判斷是物理層問題還是協(xié)議層問題。用SSCOM調(diào)MODBUS RTU操作流程是打開串口、設(shè)置波特率9600/8/N/1為例、勾選十六進(jìn)制顯示、在發(fā)送欄填入01 03 00 00 00 01 84 0A點(diǎn)發(fā)送如果能收到01 03 02 XX XX CRC_LO CRC_HI這種格式的響應(yīng)就說(shuō)明鏈路通了。如果提示發(fā)送超時(shí)或者完全沒有接收數(shù)據(jù)那就回到物理層排查。4.2 專業(yè)的MODBUS調(diào)試助手調(diào)試助手軟件比如Modbus Poll、Modbus Slave適合從寄存器語(yǔ)義層面驗(yàn)證設(shè)備邏輯而不是看裸協(xié)議幀。主站模擬器可以配置輪詢間隔、超時(shí)時(shí)間、數(shù)據(jù)解析格式16位/32位、大小端從站模擬器可以模擬一組寄存器數(shù)據(jù)用來(lái)測(cè)試主機(jī)邏輯。兩者的區(qū)別是用Modbus Poll當(dāng)主站可以直接以表格形式看到寄存器數(shù)據(jù)變化用Modbus Slave當(dāng)從站能快速驗(yàn)證上位機(jī)是否正確地讀寫寄存器地址。我在開發(fā)從站設(shè)備時(shí)通常會(huì)用Modbus Poll把每個(gè)功能碼、每個(gè)地址范圍都完整測(cè)試一遍重點(diǎn)看異常響應(yīng)是否準(zhǔn)確。4.3 幀級(jí)分析與物理層驗(yàn)證邏輯分析儀如果協(xié)議看起來(lái)正常但數(shù)據(jù)偶爾錯(cuò)亂就需要上升到物理層和時(shí)序?qū)?。普通USB轉(zhuǎn)串口工具抓不到RS-485的電平波形這時(shí)可以用邏輯分析儀比如Saleae邏輯分析儀或者幾十塊錢的國(guó)產(chǎn)8通道邏輯分析儀直接測(cè)量RS-485收發(fā)器比如MAX3485或SP3485的RO接收輸出和DI發(fā)送輸入引腳也可以直接測(cè)量A/B差分信號(hào)經(jīng)過(guò)電平轉(zhuǎn)換后的UART信號(hào)。常見問題如幀間時(shí)序不合格字符間隔不足1.5個(gè)字符時(shí)間、靜默時(shí)間不足3.5個(gè)字符時(shí)間通過(guò)邏輯分析儀一看便知。有時(shí)候主站發(fā)送間隔太快從站來(lái)不及處理表現(xiàn)為某幾條指令丟了這種隱性時(shí)序問題只有靠邏輯分析儀抓波形才能發(fā)現(xiàn)。4.4 嵌入式LinuxARM上的MODBUS調(diào)試思路嵌入式Linux設(shè)備調(diào)試MODBUS有兩種思路在開發(fā)板側(cè)直接調(diào)用串口終端工具比如用echo -ne \x01\x03\x00\x00\x00\x01\x84\x0A /dev/ttyS0發(fā)送報(bào)文再用cat /dev/ttyS0 接收或者用專業(yè)的命令行工具比如modbus-cli、modpoll。這類命令在命令行里直接指定從站地址、功能碼、起始地址和數(shù)據(jù)數(shù)量比較適合腳本化測(cè)試。在生產(chǎn)環(huán)境里我更喜歡用modpoll做批量回歸測(cè)試配合shell腳本把讀出的數(shù)據(jù)與預(yù)期值對(duì)比。不過(guò)需要注意開發(fā)板的串口節(jié)點(diǎn)可能有權(quán)限限制先確認(rèn)當(dāng)前用戶是否在dialout組或?qū)?yīng)的串口權(quán)限組否則打開設(shè)備文件會(huì)報(bào)Permission denied。5. 實(shí)戰(zhàn)排查從設(shè)備無(wú)響應(yīng)到定位到具體寄存器的完整鏈路現(xiàn)在我們把這個(gè)過(guò)程搬到一個(gè)完整的排查實(shí)例里。假設(shè)現(xiàn)場(chǎng)環(huán)境是一塊自研的溫控器主板MCU是STM32F103外掛SP3485作為RS-485收發(fā)器用USB轉(zhuǎn)RS-485的調(diào)試線連接到電腦軟件工具使用串口助手。設(shè)備地址設(shè)為1要讀取保持寄存器0x0000的當(dāng)前溫度值預(yù)期數(shù)據(jù)應(yīng)該在2500左右表示25.00℃。5.1 第一步確認(rèn)物理層信號(hào)先把示波器或邏輯分析儀接到A/B差分線和MCU的UART RX/TX引腳上。如果整個(gè)板子只有一個(gè)RS-485接口手邊又沒有差分探頭可以觀察SP3485的RO引腳MCU的RX輸入端有沒有正常的TTL電平波形。這時(shí)候有一個(gè)典型的坑USB轉(zhuǎn)RS-485調(diào)試線通常默認(rèn)是自動(dòng)收發(fā)切換的它在發(fā)送完畢之后會(huì)把方向引腳拉低但有部分廉價(jià)轉(zhuǎn)換器在切換時(shí)會(huì)產(chǎn)生毛刺導(dǎo)致從站收到的幀第一位就出錯(cuò)。用示波器一看如果RS-485總線空閑時(shí)A/B之間沒有電壓差應(yīng)該A比B高200mV以上基本可以判斷收發(fā)器供電或偏置電阻有問題。另外確認(rèn)一下調(diào)試適配器的接地RS-485是差分信號(hào)理論上可以不共地但實(shí)際應(yīng)用中如果A/B線兩端參考地電位差太大容易損壞收發(fā)器或造成誤碼。穩(wěn)妥做法是兩端共地或者選擇帶隔離的USB轉(zhuǎn)RS-485模塊。5.2 第二步用最小報(bào)文驗(yàn)證協(xié)議通路物理層正常后用串口助手發(fā)01 03 00 00 00 01 84 0A。如果返回的是01 83 02 CRC說(shuō)明從站返回了非法數(shù)據(jù)地址這是一個(gè)很有價(jià)值的故障模式說(shuō)明鏈路完全正常而是寄存器的起始地址超出了范圍——快去核對(duì)設(shè)備的寄存器映射表。如果從站完全無(wú)響應(yīng)優(yōu)先考慮這幾個(gè)方向按順序檢查檢查串口助手發(fā)送的HEX數(shù)據(jù)是否包含多余的空格或換行符甚至有的串口助手默認(rèn)會(huì)加回車換行某些從站在\r或\n到達(dá)時(shí)直接判定幀結(jié)束或出錯(cuò)丟棄。檢查從站的地址是否與報(bào)文中的從站地址一致。從站地址0x00是廣播地址有些從站實(shí)現(xiàn)中廣播不響應(yīng)這是正常現(xiàn)象。檢查CRC對(duì)不對(duì)用串口助手的CRC計(jì)算功能或在線CRC計(jì)算確認(rèn)不要手算容易犯低級(jí)錯(cuò)誤。5.3 第三步功能碼校驗(yàn)與數(shù)據(jù)解析如果返回了正常幀01 03 02 09 C4 8D xx之類從站的MODBUS功能碼和CRC驗(yàn)證都通過(guò)了接下來(lái)把第一個(gè)數(shù)據(jù)字節(jié)和第二個(gè)數(shù)據(jù)字節(jié)解析成溫度值。需要注意的是字節(jié)序問題如果設(shè)備是高字節(jié)在前那么0x09C4算出來(lái)是2500完全符合預(yù)期如果設(shè)備是低字節(jié)在前那么0xC409算出來(lái)是50185這就不對(duì)。所以每次解析時(shí)必須確認(rèn)設(shè)備定義的字節(jié)序。如果數(shù)據(jù)看起來(lái)不對(duì)但也差不太多比如變成了09 C4和相鄰寄存器交換了位置那可以考慮是不是寄存器映射偏移的問題而不是字節(jié)序問題。比如設(shè)備文檔上標(biāo)的是0x0001是溫度而你讀了0x0000恰好0x0000是設(shè)備型號(hào)或狀態(tài)字?jǐn)?shù)據(jù)自然不對(duì)。這時(shí)候把讀的范圍擴(kuò)大到連續(xù)幾個(gè)寄存器比如0x0000到0x0005再把原始數(shù)據(jù)表打出來(lái)跟設(shè)備文檔里的寄存器映射逐項(xiàng)比對(duì)很快就能定位出偏差。5.4 第四步異常響應(yīng)的進(jìn)一步診斷假設(shè)從站返回了01 83 02 C0 F1這就是標(biāo)準(zhǔn)的異常響應(yīng)。根據(jù)前面的異常碼表02代表非法數(shù)據(jù)地址。這時(shí)不要懷疑硬件而是肯定軟件在地址范圍判斷上有問題。打開從站的代碼檢查寄存器地址范圍判斷是否寫死了比如正確處理0x0000-0x0007的保持寄存器但請(qǐng)求0x0008時(shí)返回了地址非法那就對(duì)。反過(guò)來(lái)如果請(qǐng)求0x0008也沒返回異常而是返回了正常數(shù)據(jù)那就要考慮是不是從站代碼沒有做地址范圍檢查。這比較常見于自己練手寫的小從站。雖然MODBUS規(guī)范沒規(guī)定從站必須對(duì)超范圍地址返回異常但從站設(shè)計(jì)上建議做嚴(yán)格的范圍檢查這也是現(xiàn)場(chǎng)工程質(zhì)量高低的體現(xiàn)。5.5 第五步多條指令輪詢時(shí)序的調(diào)優(yōu)當(dāng)單條指令測(cè)通之后下一步就是驗(yàn)證多寄存器的批量讀寫和輪詢時(shí)序。假設(shè)主站每100ms輪詢一次總線上的3個(gè)從站每個(gè)從站依次響應(yīng)整體總線周期就必須在100ms內(nèi)完成。實(shí)測(cè)時(shí)如果發(fā)現(xiàn)偶爾有從站響應(yīng)超時(shí)先用邏輯分析儀抓UART波形看主站連續(xù)發(fā)送兩幀之間的間隔是否不足3.5個(gè)字符時(shí)間。不足的話主站側(cè)要增加幀間隔延時(shí)或者從站側(cè)要優(yōu)化接收中斷的處理時(shí)間來(lái)縮短響應(yīng)延遲。還要注意RS-485是半雙工總線。從站不能在接收到幀尾后立即開始發(fā)送響應(yīng)必須留出足夠的方向切換時(shí)間。這個(gè)時(shí)間通常由收發(fā)器的DE/RE引腳控制邏輯決定最少也要留出幾十微秒。如果從站在收到幀后立刻把485方向改為發(fā)送而此時(shí)總線還在被主站驅(qū)動(dòng)就會(huì)造成總線沖突。這也是很多自研從站偶發(fā)響異常的原因之一。6. 現(xiàn)場(chǎng)經(jīng)驗(yàn)補(bǔ)遺終端電阻、偏置電阻和地電位差最后補(bǔ)充幾個(gè)從站硬件設(shè)計(jì)上的常見問題因?yàn)镸ODBUS調(diào)試到后來(lái)問題往往不在協(xié)議棧而在RS-485總線的物理信號(hào)質(zhì)量上。終端電阻的作用是消除信號(hào)在總線末端的反射。按RS-485規(guī)范總線兩端各需一個(gè)120Ω的終端電阻阻值等于雙絞線的特性阻抗。但很多小系統(tǒng)比如一個(gè)主站帶一兩個(gè)從站線纜很短不接終端電阻也能正常工作這就容易讓人忽視它的重要性。當(dāng)總線距離超過(guò)幾十米或節(jié)點(diǎn)數(shù)多、波特率上到115200以上時(shí)反射現(xiàn)象會(huì)變得明顯表現(xiàn)為隨機(jī)誤碼和偶發(fā)丟幀。調(diào)試時(shí)如果出現(xiàn)近距離沒毛病接上長(zhǎng)線就亂碼大概率就是終端電阻缺失或阻值不匹配。偏置電阻也叫失效保護(hù)電阻的作用是保證總線空閑時(shí)A-B差分電壓高于200mV。有些RS-485收發(fā)器比如SP3485內(nèi)部沒有集成失效保護(hù)如果總線上所有節(jié)點(diǎn)都處于接收狀態(tài)且沒有任何節(jié)點(diǎn)驅(qū)動(dòng)總線A/B間的電壓可能接近0V接收器的輸出不確定導(dǎo)致誤收充電平。常用做法是在A線上拉一個(gè)電阻到VCC在B線下拉一個(gè)電阻到GND阻值通常在390Ω到10kΩ之間具體根據(jù)總線上節(jié)點(diǎn)數(shù)量和匹配電阻計(jì)算。如果總線只有兩個(gè)節(jié)點(diǎn)并且都接了120Ω終端電阻偏置電阻的計(jì)算稍微復(fù)雜一些但原則上要保證差分電壓高于200mV。另外RS-485總線不要用星型拓?fù)?。MODBUS RTU標(biāo)準(zhǔn)要求菊花鏈接線也就是從主站到從站再到下一個(gè)從站逐級(jí)串聯(lián)。如果現(xiàn)場(chǎng)為了布線方便做成了星型長(zhǎng)線分支處的信號(hào)反射會(huì)相當(dāng)嚴(yán)重輕則偶發(fā)誤碼重則完全無(wú)法通信。如果實(shí)在沒法改拓?fù)淇稍诿總€(gè)分支盡量縮短支線長(zhǎng)度并在主站端增加終端電阻和偏置電阻來(lái)抑制反射。提示排查MODBUS問題永遠(yuǎn)從物理層向協(xié)議層推進(jìn)不要一開始就懷疑CRC算法或寄存器映射除非鏈路和幀格式已經(jīng)被證明完全正常。這篇筆記寫到這MODBUS RTU從幀格式、地址模型、從站狀態(tài)機(jī)、調(diào)試工具鏈到物理層參數(shù)調(diào)整算是基本閉環(huán)了。最后再分享一個(gè)實(shí)操上的小技巧正式交付設(shè)備固件之前建議把Modbus Poll待測(cè)設(shè)備連續(xù)跑一個(gè)晚上的輪詢測(cè)試并把錯(cuò)誤計(jì)數(shù)和異常響應(yīng)幀記錄到日志中。很多偶發(fā)問題只有在長(zhǎng)時(shí)間壓力測(cè)試中才會(huì)顯形而這種回歸測(cè)試的成本極低卻能在出廠前攔截掉一大批硬件和時(shí)序缺陷。記住協(xié)議不難難的是在真實(shí)總線環(huán)境下把每一個(gè)細(xì)節(jié)都做對(duì)。 MODBUS RTU從站調(diào)試實(shí)戰(zhàn)：幀格式、寄存器映射與物理層排查指南
RS-485的A/B線明明焊對(duì)了示波器上也有波形設(shè)備就是不回?cái)?shù)據(jù)。這是我調(diào)MODBUS從站時(shí)卡得最久的一次后來(lái)發(fā)現(xiàn)是終端電阻沒焊信號(hào)反射把從站芯片的接收引腳電平直接拉死在不確定區(qū)。這種問題在文檔里永遠(yuǎn)查不到只有拿串口抓報(bào)文再對(duì)著協(xié)議一條條比對(duì)才能定位。所以這篇筆記我不打算寫成MODBUS協(xié)議手冊(cè)的翻譯版而是從幀格式的字節(jié)級(jí)細(xì)節(jié)、地址模型的存儲(chǔ)區(qū)映射、調(diào)試工具鏈的搭建到完整排查方法論把整個(gè)調(diào)通過(guò)程里有價(jià)值的東西一次性梳理清楚。先說(shuō)適用范圍如果你在用STM32、ESP32這類MCU做設(shè)備聯(lián)網(wǎng)或者維護(hù)PLC、變頻器、智能儀表這類工業(yè)設(shè)備需要和上位機(jī)組態(tài)軟件、觸摸屏、網(wǎng)關(guān)通信這篇文章能幫你省掉大量在協(xié)議細(xì)節(jié)上浪費(fèi)的時(shí)間。如果你是剛接觸MODBUS的初學(xué)者建議先動(dòng)手把0x03讀保持寄存器這個(gè)功能碼完整調(diào)通一次再回頭看地址映射的章節(jié)。1. 幀格式的字節(jié)級(jí)拆解從協(xié)議棧底層看MODBUS RTU的消息邊界MODBUS RTU的消息幀沒有像TCP那樣的長(zhǎng)度字段也沒有像UART幀那樣自帶起始位和停止位它完全依靠幀間靜默時(shí)間來(lái)劃分消息邊界。這就要求同一個(gè)幀里相鄰兩個(gè)字符的間隔不能超過(guò)1.5個(gè)字符時(shí)間而幀與幀之間的間隔必須大于等于3.5個(gè)字符時(shí)間。這個(gè)定義看著簡(jiǎn)單實(shí)際用MCU實(shí)現(xiàn)時(shí)卻是第一個(gè)坑。1.1 為什么字符間隔決定了整個(gè)協(xié)議棧的可靠性假設(shè)波特率是9600一個(gè)字符包含1個(gè)起始位、8個(gè)數(shù)據(jù)位、1個(gè)停止位無(wú)校驗(yàn)總共10位那么1個(gè)字符時(shí)間約為1.04ms3.5個(gè)字符時(shí)間約為3.65ms。如果你的從站程序在接收完一個(gè)字節(jié)之后進(jìn)入了某個(gè)耗時(shí)比較長(zhǎng)的中斷處理函數(shù)恰好這個(gè)中斷占用了超過(guò)1.5個(gè)字符時(shí)間約1.56ms主站發(fā)來(lái)的后續(xù)字節(jié)就會(huì)被判定為另一個(gè)幀的起始整個(gè)報(bào)文直接被丟棄。我遇到過(guò)一種情況從站代碼里把接收放在串口中斷中但中斷服務(wù)函數(shù)里有一個(gè)用于打印調(diào)試信息的printf這個(gè)printf走的是阻塞式的UART發(fā)送波特率只有9600發(fā)送一個(gè)字符就要1ms左右如果打印十幾個(gè)字符整個(gè)中斷就被卡死了。結(jié)果就是主站輪詢寄存器時(shí)從站偶發(fā)無(wú)響應(yīng)但又不是每次都失敗用串口助手抓報(bào)文又看不出規(guī)律。后來(lái)把printf從接收中斷里挪到空閑時(shí)間處理占用率立刻恢復(fù)正常。這個(gè)問題的真實(shí)原因不是MODBUS協(xié)議本身的邏輯復(fù)雜度而是中斷響應(yīng)時(shí)間破壞了幀的連續(xù)性。所以后來(lái)我在做MODBUS從站框架時(shí)接收部分一律采用環(huán)形緩沖區(qū)加DMA空閑中斷的方案絕對(duì)不在中斷里做任何阻塞操作。1.2 CRC校驗(yàn)的位移寄存器運(yùn)算細(xì)節(jié)MODBUS RTU的CRC-16算法使用多項(xiàng)式0xA001反轉(zhuǎn)多項(xiàng)式對(duì)應(yīng)標(biāo)準(zhǔn)CRC-16/IBM初始值為0xFFFF。它的運(yùn)算過(guò)程是每個(gè)字節(jié)先與CRC低字節(jié)異或然后右移8次每次右移后如果最低位LSB為1就與0xA001異或。很多剛接觸的人不理解為什么多項(xiàng)式是0xA001而不是常見的0x8005因?yàn)檫@兩種寫法是同一條多項(xiàng)式的正序和反序表示。標(biāo)準(zhǔn)CRC-16/IBM的多項(xiàng)式是0x8005即x^16 x^15 x^2 1但MODBUS規(guī)范要求LSB-first也就是從最低位開始處理數(shù)據(jù)所以要把多項(xiàng)式按位反轉(zhuǎn)才得到0xA001。如果你用查表法實(shí)現(xiàn)CRC務(wù)必確認(rèn)表是由0xA001生成的。我曾經(jīng)在某個(gè)項(xiàng)目里直接拷貝了一個(gè)0x8005的查表法CRC函數(shù)結(jié)果模擬器測(cè)試時(shí)CRC校驗(yàn)全部錯(cuò)誤排查了很久才發(fā)現(xiàn)是表用錯(cuò)了。驗(yàn)證CRC是否正確的簡(jiǎn)單方法是用01 03 00 00 00 01這組數(shù)據(jù)計(jì)算CRC正確結(jié)果是84 0A低字節(jié)在前。如果結(jié)果不對(duì)你的CRC實(shí)現(xiàn)肯定有問題。2. 地址模型與存儲(chǔ)區(qū)映射為什么MODBUS寄存器編號(hào)從0開始卻要從1訪問MODBUS的地址模型是理解整個(gè)協(xié)議最核心的部分也是現(xiàn)場(chǎng)調(diào)試時(shí)最容易混淆的地方。這里有一個(gè)關(guān)鍵區(qū)分協(xié)議層的數(shù)據(jù)地址和應(yīng)用層的寄存器編號(hào)不是一回事。MODBUS協(xié)議規(guī)定數(shù)據(jù)地址從0開始編號(hào)比如0x03功能碼讀取保持寄存器的起始地址是0x0000。但是很多設(shè)備廠商在文檔里給出的寄存器地址卻是從40001開始的MODBUS協(xié)議傳統(tǒng)的寄存器編號(hào)方式即40001對(duì)應(yīng)數(shù)據(jù)地址0x000040002對(duì)應(yīng)數(shù)據(jù)地址0x0001。2.1 四個(gè)數(shù)據(jù)塊與功能碼的對(duì)應(yīng)關(guān)系MODBUS定義了四種數(shù)據(jù)塊線圈Coil、離散輸入Discrete Input、輸入寄存器Input Register、保持寄存器Holding Register。它們的區(qū)別在于讀寫權(quán)限和數(shù)據(jù)類型數(shù)據(jù)塊位/字讀寫權(quán)限對(duì)應(yīng)功能碼讀/寫線圈Coil位可讀寫0x01 / 0x05, 0x0F離散輸入Discrete Input位只讀0x02 / 無(wú)輸入寄存器Input Register16位字只讀0x04 / 無(wú)保持寄存器Holding Register16位字可讀寫0x03 / 0x06, 0x10現(xiàn)場(chǎng)調(diào)試時(shí)我習(xí)慣先畫一張地址映射表明確每個(gè)數(shù)據(jù)點(diǎn)在哪個(gè)數(shù)據(jù)塊、偏移量是多少。比如一個(gè)溫控器設(shè)備保持寄存器的0x0000是當(dāng)前溫度只讀0x0001是目標(biāo)溫度可讀寫。那上位機(jī)想讀當(dāng)前溫度就要用0x03功能碼、起始地址0x0000、寄存器數(shù)量0x0001。很多組態(tài)軟件或觸摸屏在變量配置界面里填地址時(shí)會(huì)直接讓你填40001這種形式它內(nèi)部會(huì)自動(dòng)換算成數(shù)據(jù)地址0x0000。如果你在代碼里把寄存器編號(hào)40001當(dāng)成數(shù)據(jù)地址0x0000來(lái)用就完全正確但如果你直接在協(xié)議幀里填40001的十六進(jìn)制0x9C41那就會(huì)發(fā)瘋。2.2 偏移1的坑廠商文檔與協(xié)議標(biāo)準(zhǔn)的錯(cuò)位這個(gè)問題在MODBUS協(xié)議里非常常見就是Offset by One問題。不同廠商的文檔風(fēng)格截然不同有些設(shè)備手冊(cè)直接給數(shù)據(jù)地址有些給PLC風(fēng)格的寄存器編號(hào)如40001還有些給的是地址偏移加1的表示法。讀設(shè)備寄存器的時(shí)候一定要先用串口助手發(fā)一幀已知的報(bào)文確認(rèn)返回?cái)?shù)據(jù)在預(yù)期范圍內(nèi)再開始映射變量。我之前調(diào)試一個(gè)電表時(shí)設(shè)備的文檔寫溫度寄存器地址為0x0101我按這個(gè)地址去讀返回的數(shù)據(jù)完全沒規(guī)律后來(lái)發(fā)現(xiàn)文檔里的地址是協(xié)議地址加1的表示實(shí)際協(xié)議地址應(yīng)該是0x0100。這種錯(cuò)位屬于設(shè)備廠商的文檔定義習(xí)慣和MODBUS規(guī)范不一致讓人浪費(fèi)了一整天。2.3 32位數(shù)據(jù)的字節(jié)序陷阱16位寄存器只能表達(dá)0到65535但很多設(shè)備參數(shù)比如累計(jì)電量、頻率值×100、浮點(diǎn)數(shù)需要32位。這就要用兩個(gè)連續(xù)的16位寄存器來(lái)拼。問題來(lái)了兩個(gè)寄存器之間誰(shuí)高誰(shuí)低以及每個(gè)寄存器內(nèi)部的字節(jié)序大端/小端不同廠商定義不同。最常見的兩種組合是大端模式Big-EndianMotorola格式先存高16位寄存器再存低16位寄存器寄存器內(nèi)部也是高字節(jié)在前。比如32位值0x12345678第一個(gè)寄存器是0x1234第二個(gè)寄存器是0x5678。小端模式Little-EndianIntel格式先存低16位寄存器再存高16位寄存器。第一個(gè)寄存器是0x5678第二個(gè)寄存器是0x1234。這還沒完有些設(shè)備還會(huì)把寄存器內(nèi)部的字節(jié)序也調(diào)轉(zhuǎn)比如低字節(jié)在前組合方式就更多了。遇到32位參數(shù)讀數(shù)異常時(shí)建議先用相同的數(shù)據(jù)地址和功能碼分別用兩種字節(jié)序來(lái)解析至少能快速確定是不是字節(jié)序的問題。3. 從零開始寫一個(gè)從站/主站幀解析的狀態(tài)機(jī)設(shè)計(jì)說(shuō)到實(shí)現(xiàn)MODBUS RTU的從站核心其實(shí)就是一個(gè)字節(jié)狀態(tài)機(jī)。它需要處理兩種情況空閑幀間隔檢測(cè)和幀內(nèi)字符間隔超時(shí)。狀態(tài)機(jī)的設(shè)計(jì)直接決定了協(xié)議的健壯性。3.1 空閑檢測(cè)的兩種實(shí)現(xiàn)路徑第一種是定時(shí)器計(jì)數(shù)法。在串口接收中斷里每收到一個(gè)字節(jié)就復(fù)位一個(gè)定時(shí)器定時(shí)長(zhǎng)度設(shè)為3.5個(gè)字符時(shí)間定時(shí)器超時(shí)后觸發(fā)幀接收完成標(biāo)志。主循環(huán)檢測(cè)到標(biāo)志后對(duì)緩沖區(qū)里的數(shù)據(jù)做CRC校驗(yàn)并處理。這里的重點(diǎn)是定時(shí)器超時(shí)時(shí)間必須相對(duì)準(zhǔn)確太短會(huì)導(dǎo)致正常幀被拆斷太長(zhǎng)會(huì)導(dǎo)致兩個(gè)相鄰的幀被誤并成一個(gè)幀。第二種是DMA空閑中斷法。利用MCU的UART空閑中斷IDLE來(lái)檢測(cè)一幀結(jié)束。這種方案在STM32等MCU上比較省CPU接收數(shù)據(jù)直接進(jìn)DMA緩沖區(qū)空閑中斷觸發(fā)后從緩沖區(qū)里取數(shù)據(jù)。這種方式配合環(huán)形緩沖區(qū)效率高比較適合需要處理大量數(shù)據(jù)的場(chǎng)景。但需要注意STM32的IDLE中斷在一幀數(shù)據(jù)的最后一個(gè)字節(jié)之后觸發(fā)如果DMA緩沖區(qū)正好填滿會(huì)同時(shí)觸發(fā)傳輸完成中斷和空閑中斷代碼里要處理這種情況防止數(shù)據(jù)被覆蓋。3.2 功能碼的分發(fā)與異常響應(yīng)從站收到合法幀后需要按功能碼分發(fā)到不同的處理函數(shù)。MODBUS協(xié)議規(guī)定了異常響應(yīng)的標(biāo)準(zhǔn)格式從站地址 功能碼最高位置1 異常碼 CRC。常見異常碼包括異常碼含義常見場(chǎng)景0x01非法功能碼從站不支持該功能碼0x02非法數(shù)據(jù)地址讀取地址超范圍0x03非法數(shù)據(jù)值寫入的值超范圍0x04從站設(shè)備故障內(nèi)部錯(cuò)誤無(wú)法處理異常響應(yīng)在設(shè)計(jì)時(shí)必須認(rèn)真地實(shí)現(xiàn)因?yàn)橹髡究梢酝ㄟ^(guò)異常響應(yīng)判斷通訊狀態(tài)。如果主站發(fā)了一個(gè)不存在的功能碼從站什么都不回主站可能會(huì)一直等待到超時(shí)。而如果從站能迅速返回異常幀主站就能立刻知道功能碼不支持方便定位問題。我之前調(diào)試一個(gè)網(wǎng)關(guān)設(shè)備從站把異常響應(yīng)全部屏蔽掉了結(jié)果上位機(jī)那邊輪詢時(shí)報(bào)超時(shí)隔了很久才排查到從站的異常幀邏輯有缺陷把異常碼打印出來(lái)問題一下就清晰了。3.3 01功能碼離散輸出DO的讀寫模型與02功能碼的對(duì)應(yīng)關(guān)系01功能碼讀線圈和02功能碼讀離散輸入都是按位操作的。它們的數(shù)據(jù)組織方式是按位打包假設(shè)你讀起始地址0x0000的線圈數(shù)量8個(gè)返回的數(shù)據(jù)量是1個(gè)字節(jié)這個(gè)字節(jié)的每一位對(duì)應(yīng)一個(gè)線圈狀態(tài)最低位對(duì)應(yīng)起始地址0x0000的線圈狀態(tài)。超過(guò)8個(gè)線圈時(shí)一個(gè)字節(jié)不夠就需要多個(gè)字節(jié)響應(yīng)幀里數(shù)據(jù)量字節(jié)數(shù)由寄存器數(shù)量除以8向上取整決定。實(shí)現(xiàn)時(shí)要注意位打包的位序是低位在前。很多人在這里栽跟頭比如要讀取線圈地址0x0000到0x0007實(shí)際返回字節(jié)的第0位對(duì)應(yīng)地址0x0000第1位對(duì)應(yīng)0x0001以此類推。如果你把它們當(dāng)成高位在前解析結(jié)果就是完全不一樣的位序?qū)е翽LC和觸摸屏上顯示的狀態(tài)錯(cuò)亂。4. 調(diào)試工具的選型與實(shí)戰(zhàn)串口助手的正確打開方式工具是調(diào)試效率的根本。這里我把實(shí)際調(diào)MODBUS用到的工具鏈做一個(gè)橫向?qū)Ρ劝ù谥?、MODBUS調(diào)試助手、邏輯分析儀、總線分析儀再看看在嵌入式Linux環(huán)境下的調(diào)試思路。先提醒一點(diǎn)調(diào)試前去網(wǎng)上搜工具一定會(huì)看到類似推薦XX個(gè)MODBUS調(diào)試軟件的文章但真正好用的工具就那么幾個(gè)不要在選工具上浪費(fèi)太多時(shí)間。4.1 通用串口助手的使用邊界通用串口助手比如SSCOM適用于最底層的報(bào)文級(jí)調(diào)試。它能看到原始收發(fā)的十六進(jìn)制幀但需要你手動(dòng)計(jì)算CRC、手動(dòng)解析響應(yīng)效率不高。不過(guò)它有一個(gè)不可替代的優(yōu)勢(shì)完全沒有協(xié)議層過(guò)濾能捕捉到任何錯(cuò)誤幀和異常幀。如果設(shè)備一點(diǎn)反應(yīng)都不給我最先干的事就是用SSCOM直接發(fā)一幀看看有沒有任何返回?cái)?shù)據(jù)來(lái)判斷是物理層問題還是協(xié)議層問題。用SSCOM調(diào)MODBUS RTU操作流程是打開串口、設(shè)置波特率9600/8/N/1為例、勾選十六進(jìn)制顯示、在發(fā)送欄填入01 03 00 00 00 01 84 0A點(diǎn)發(fā)送如果能收到01 03 02 XX XX CRC_LO CRC_HI這種格式的響應(yīng)就說(shuō)明鏈路通了。如果提示發(fā)送超時(shí)或者完全沒有接收數(shù)據(jù)那就回到物理層排查。4.2 專業(yè)的MODBUS調(diào)試助手調(diào)試助手軟件比如Modbus Poll、Modbus Slave適合從寄存器語(yǔ)義層面驗(yàn)證設(shè)備邏輯而不是看裸協(xié)議幀。主站模擬器可以配置輪詢間隔、超時(shí)時(shí)間、數(shù)據(jù)解析格式16位/32位、大小端從站模擬器可以模擬一組寄存器數(shù)據(jù)用來(lái)測(cè)試主機(jī)邏輯。兩者的區(qū)別是用Modbus Poll當(dāng)主站可以直接以表格形式看到寄存器數(shù)據(jù)變化用Modbus Slave當(dāng)從站能快速驗(yàn)證上位機(jī)是否正確地讀寫寄存器地址。我在開發(fā)從站設(shè)備時(shí)通常會(huì)用Modbus Poll把每個(gè)功能碼、每個(gè)地址范圍都完整測(cè)試一遍重點(diǎn)看異常響應(yīng)是否準(zhǔn)確。4.3 幀級(jí)分析與物理層驗(yàn)證邏輯分析儀如果協(xié)議看起來(lái)正常但數(shù)據(jù)偶爾錯(cuò)亂就需要上升到物理層和時(shí)序?qū)?。普通USB轉(zhuǎn)串口工具抓不到RS-485的電平波形這時(shí)可以用邏輯分析儀比如Saleae邏輯分析儀或者幾十塊錢的國(guó)產(chǎn)8通道邏輯分析儀直接測(cè)量RS-485收發(fā)器比如MAX3485或SP3485的RO接收輸出和DI發(fā)送輸入引腳也可以直接測(cè)量A/B差分信號(hào)經(jīng)過(guò)電平轉(zhuǎn)換后的UART信號(hào)。常見問題如幀間時(shí)序不合格字符間隔不足1.5個(gè)字符時(shí)間、靜默時(shí)間不足3.5個(gè)字符時(shí)間通過(guò)邏輯分析儀一看便知。有時(shí)候主站發(fā)送間隔太快從站來(lái)不及處理表現(xiàn)為某幾條指令丟了這種隱性時(shí)序問題只有靠邏輯分析儀抓波形才能發(fā)現(xiàn)。4.4 嵌入式LinuxARM上的MODBUS調(diào)試思路嵌入式Linux設(shè)備調(diào)試MODBUS有兩種思路在開發(fā)板側(cè)直接調(diào)用串口終端工具比如用echo -ne \x01\x03\x00\x00\x00\x01\x84\x0A /dev/ttyS0發(fā)送報(bào)文再用cat /dev/ttyS0 接收或者用專業(yè)的命令行工具比如modbus-cli、modpoll。這類命令在命令行里直接指定從站地址、功能碼、起始地址和數(shù)據(jù)數(shù)量比較適合腳本化測(cè)試。在生產(chǎn)環(huán)境里我更喜歡用modpoll做批量回歸測(cè)試配合shell腳本把讀出的數(shù)據(jù)與預(yù)期值對(duì)比。不過(guò)需要注意開發(fā)板的串口節(jié)點(diǎn)可能有權(quán)限限制先確認(rèn)當(dāng)前用戶是否在dialout組或?qū)?yīng)的串口權(quán)限組否則打開設(shè)備文件會(huì)報(bào)Permission denied。5. 實(shí)戰(zhàn)排查從設(shè)備無(wú)響應(yīng)到定位到具體寄存器的完整鏈路現(xiàn)在我們把這個(gè)過(guò)程搬到一個(gè)完整的排查實(shí)例里。假設(shè)現(xiàn)場(chǎng)環(huán)境是一塊自研的溫控器主板MCU是STM32F103外掛SP3485作為RS-485收發(fā)器用USB轉(zhuǎn)RS-485的調(diào)試線連接到電腦軟件工具使用串口助手。設(shè)備地址設(shè)為1要讀取保持寄存器0x0000的當(dāng)前溫度值預(yù)期數(shù)據(jù)應(yīng)該在2500左右表示25.00℃。5.1 第一步確認(rèn)物理層信號(hào)先把示波器或邏輯分析儀接到A/B差分線和MCU的UART RX/TX引腳上。如果整個(gè)板子只有一個(gè)RS-485接口手邊又沒有差分探頭可以觀察SP3485的RO引腳MCU的RX輸入端有沒有正常的TTL電平波形。這時(shí)候有一個(gè)典型的坑USB轉(zhuǎn)RS-485調(diào)試線通常默認(rèn)是自動(dòng)收發(fā)切換的它在發(fā)送完畢之后會(huì)把方向引腳拉低但有部分廉價(jià)轉(zhuǎn)換器在切換時(shí)會(huì)產(chǎn)生毛刺導(dǎo)致從站收到的幀第一位就出錯(cuò)。用示波器一看如果RS-485總線空閑時(shí)A/B之間沒有電壓差應(yīng)該A比B高200mV以上基本可以判斷收發(fā)器供電或偏置電阻有問題。另外確認(rèn)一下調(diào)試適配器的接地RS-485是差分信號(hào)理論上可以不共地但實(shí)際應(yīng)用中如果A/B線兩端參考地電位差太大容易損壞收發(fā)器或造成誤碼。穩(wěn)妥做法是兩端共地或者選擇帶隔離的USB轉(zhuǎn)RS-485模塊。5.2 第二步用最小報(bào)文驗(yàn)證協(xié)議通路物理層正常后用串口助手發(fā)01 03 00 00 00 01 84 0A。如果返回的是01 83 02 CRC說(shuō)明從站返回了非法數(shù)據(jù)地址這是一個(gè)很有價(jià)值的故障模式說(shuō)明鏈路完全正常而是寄存器的起始地址超出了范圍——快去核對(duì)設(shè)備的寄存器映射表。如果從站完全無(wú)響應(yīng)優(yōu)先考慮這幾個(gè)方向按順序檢查檢查串口助手發(fā)送的HEX數(shù)據(jù)是否包含多余的空格或換行符甚至有的串口助手默認(rèn)會(huì)加回車換行某些從站在\r或\n到達(dá)時(shí)直接判定幀結(jié)束或出錯(cuò)丟棄。檢查從站的地址是否與報(bào)文中的從站地址一致。從站地址0x00是廣播地址有些從站實(shí)現(xiàn)中廣播不響應(yīng)這是正常現(xiàn)象。檢查CRC對(duì)不對(duì)用串口助手的CRC計(jì)算功能或在線CRC計(jì)算確認(rèn)不要手算容易犯低級(jí)錯(cuò)誤。5.3 第三步功能碼校驗(yàn)與數(shù)據(jù)解析如果返回了正常幀01 03 02 09 C4 8D xx之類從站的MODBUS功能碼和CRC驗(yàn)證都通過(guò)了接下來(lái)把第一個(gè)數(shù)據(jù)字節(jié)和第二個(gè)數(shù)據(jù)字節(jié)解析成溫度值。需要注意的是字節(jié)序問題如果設(shè)備是高字節(jié)在前那么0x09C4算出來(lái)是2500完全符合預(yù)期如果設(shè)備是低字節(jié)在前那么0xC409算出來(lái)是50185這就不對(duì)。所以每次解析時(shí)必須確認(rèn)設(shè)備定義的字節(jié)序。如果數(shù)據(jù)看起來(lái)不對(duì)但也差不太多比如變成了09 C4和相鄰寄存器交換了位置那可以考慮是不是寄存器映射偏移的問題而不是字節(jié)序問題。比如設(shè)備文檔上標(biāo)的是0x0001是溫度而你讀了0x0000恰好0x0000是設(shè)備型號(hào)或狀態(tài)字?jǐn)?shù)據(jù)自然不對(duì)。這時(shí)候把讀的范圍擴(kuò)大到連續(xù)幾個(gè)寄存器比如0x0000到0x0005再把原始數(shù)據(jù)表打出來(lái)跟設(shè)備文檔里的寄存器映射逐項(xiàng)比對(duì)很快就能定位出偏差。5.4 第四步異常響應(yīng)的進(jìn)一步診斷假設(shè)從站返回了01 83 02 C0 F1這就是標(biāo)準(zhǔn)的異常響應(yīng)。根據(jù)前面的異常碼表02代表非法數(shù)據(jù)地址。這時(shí)不要懷疑硬件而是肯定軟件在地址范圍判斷上有問題。打開從站的代碼檢查寄存器地址范圍判斷是否寫死了比如正確處理0x0000-0x0007的保持寄存器但請(qǐng)求0x0008時(shí)返回了地址非法那就對(duì)。反過(guò)來(lái)如果請(qǐng)求0x0008也沒返回異常而是返回了正常數(shù)據(jù)那就要考慮是不是從站代碼沒有做地址范圍檢查。這比較常見于自己練手寫的小從站。雖然MODBUS規(guī)范沒規(guī)定從站必須對(duì)超范圍地址返回異常但從站設(shè)計(jì)上建議做嚴(yán)格的范圍檢查這也是現(xiàn)場(chǎng)工程質(zhì)量高低的體現(xiàn)。5.5 第五步多條指令輪詢時(shí)序的調(diào)優(yōu)當(dāng)單條指令測(cè)通之后下一步就是驗(yàn)證多寄存器的批量讀寫和輪詢時(shí)序。假設(shè)主站每100ms輪詢一次總線上的3個(gè)從站每個(gè)從站依次響應(yīng)整體總線周期就必須在100ms內(nèi)完成。實(shí)測(cè)時(shí)如果發(fā)現(xiàn)偶爾有從站響應(yīng)超時(shí)先用邏輯分析儀抓UART波形看主站連續(xù)發(fā)送兩幀之間的間隔是否不足3.5個(gè)字符時(shí)間。不足的話主站側(cè)要增加幀間隔延時(shí)或者從站側(cè)要優(yōu)化接收中斷的處理時(shí)間來(lái)縮短響應(yīng)延遲。還要注意RS-485是半雙工總線。從站不能在接收到幀尾后立即開始發(fā)送響應(yīng)必須留出足夠的方向切換時(shí)間。這個(gè)時(shí)間通常由收發(fā)器的DE/RE引腳控制邏輯決定最少也要留出幾十微秒。如果從站在收到幀后立刻把485方向改為發(fā)送而此時(shí)總線還在被主站驅(qū)動(dòng)就會(huì)造成總線沖突。這也是很多自研從站偶發(fā)響異常的原因之一。6. 現(xiàn)場(chǎng)經(jīng)驗(yàn)補(bǔ)遺終端電阻、偏置電阻和地電位差最后補(bǔ)充幾個(gè)從站硬件設(shè)計(jì)上的常見問題因?yàn)镸ODBUS調(diào)試到后來(lái)問題往往不在協(xié)議棧而在RS-485總線的物理信號(hào)質(zhì)量上。終端電阻的作用是消除信號(hào)在總線末端的反射。按RS-485規(guī)范總線兩端各需一個(gè)120Ω的終端電阻阻值等于雙絞線的特性阻抗。但很多小系統(tǒng)比如一個(gè)主站帶一兩個(gè)從站線纜很短不接終端電阻也能正常工作這就容易讓人忽視它的重要性。當(dāng)總線距離超過(guò)幾十米或節(jié)點(diǎn)數(shù)多、波特率上到115200以上時(shí)反射現(xiàn)象會(huì)變得明顯表現(xiàn)為隨機(jī)誤碼和偶發(fā)丟幀。調(diào)試時(shí)如果出現(xiàn)近距離沒毛病接上長(zhǎng)線就亂碼大概率就是終端電阻缺失或阻值不匹配。偏置電阻也叫失效保護(hù)電阻的作用是保證總線空閑時(shí)A-B差分電壓高于200mV。有些RS-485收發(fā)器比如SP3485內(nèi)部沒有集成失效保護(hù)如果總線上所有節(jié)點(diǎn)都處于接收狀態(tài)且沒有任何節(jié)點(diǎn)驅(qū)動(dòng)總線A/B間的電壓可能接近0V接收器的輸出不確定導(dǎo)致誤收充電平。常用做法是在A線上拉一個(gè)電阻到VCC在B線下拉一個(gè)電阻到GND阻值通常在390Ω到10kΩ之間具體根據(jù)總線上節(jié)點(diǎn)數(shù)量和匹配電阻計(jì)算。如果總線只有兩個(gè)節(jié)點(diǎn)并且都接了120Ω終端電阻偏置電阻的計(jì)算稍微復(fù)雜一些但原則上要保證差分電壓高于200mV。另外RS-485總線不要用星型拓?fù)?。MODBUS RTU標(biāo)準(zhǔn)要求菊花鏈接線也就是從主站到從站再到下一個(gè)從站逐級(jí)串聯(lián)。如果現(xiàn)場(chǎng)為了布線方便做成了星型長(zhǎng)線分支處的信號(hào)反射會(huì)相當(dāng)嚴(yán)重輕則偶發(fā)誤碼重則完全無(wú)法通信。如果實(shí)在沒法改拓?fù)淇稍诿總€(gè)分支盡量縮短支線長(zhǎng)度并在主站端增加終端電阻和偏置電阻來(lái)抑制反射。提示排查MODBUS問題永遠(yuǎn)從物理層向協(xié)議層推進(jìn)不要一開始就懷疑CRC算法或寄存器映射除非鏈路和幀格式已經(jīng)被證明完全正常。這篇筆記寫到這MODBUS RTU從幀格式、地址模型、從站狀態(tài)機(jī)、調(diào)試工具鏈到物理層參數(shù)調(diào)整算是基本閉環(huán)了。最后再分享一個(gè)實(shí)操上的小技巧正式交付設(shè)備固件之前建議把Modbus Poll待測(cè)設(shè)備連續(xù)跑一個(gè)晚上的輪詢測(cè)試并把錯(cuò)誤計(jì)數(shù)和異常響應(yīng)幀記錄到日志中。很多偶發(fā)問題只有在長(zhǎng)時(shí)間壓力測(cè)試中才會(huì)顯形而這種回歸測(cè)試的成本極低卻能在出廠前攔截掉一大批硬件和時(shí)序缺陷。記住協(xié)議不難難的是在真實(shí)總線環(huán)境下把每一個(gè)細(xì)節(jié)都做對(duì)。