1. 同一塊面板上的兩件事旋鈕檔位與float上報做嵌入式調(diào)試做到第6篇我越來越發(fā)現(xiàn)一個規(guī)律真正耗時間的往往不是某個高深算法而是那些看起來很簡單上手全是坑的基礎(chǔ)環(huán)節(jié)。比如這次控制面板項目里同時撞上的兩個問題——4檔旋轉(zhuǎn)開關(guān)怎么用最少IO把檔位讀回來以及float數(shù)據(jù)在Modbus總線上怎么安全地拆出去、再完整地拼回來。前者是典型的省IO采集需求后者是Modbus協(xié)議里最容易被忽視的float拆分還原問題。兩件事湊在一起不是因為巧合而是因為它們本質(zhì)上是同一個需求的上下游旋鈕檔位是輸入Modbus上報是輸出中間隔著一層怎么表達(dá)、怎么轉(zhuǎn)換的嵌入式基本功。1.1 這次調(diào)試背后的具體場景項目是一個小型控制面板MCU用的STM32F103系列片上資源本身不算緊張但板子上已經(jīng)掛了兩個UART、一個SPI Flash、一路PWM調(diào)光、外加若干狀態(tài)指示燈把GPIO擠得只剩三個。面板上有一個機(jī)械式4檔旋轉(zhuǎn)開關(guān)用來切換設(shè)備的工作模式客戶要求當(dāng)前檔位實時顯示在觸摸屏上觸摸屏和MCU之間走M(jìn)odbus RTU通信。這種情況下旋轉(zhuǎn)開關(guān)的檔位采集如果按常規(guī)思路做每個檔位一個IO口去讀4個檔位就要占用4個GPIO——板子上根本騰不出來。最后用的是二進(jìn)制編碼思路選一個雙路輸出的編碼開關(guān)兩個IO口就能編碼出4種組合狀態(tài)。IO省下來了但代價是軟件里多了一套狀態(tài)映射和消抖邏輯。1.2 省IO和拆float其實是一條線上的兩個節(jié)點觸摸屏要顯示當(dāng)前擋位本身是整數(shù)用一個保持寄存器就能傳。但客戶后續(xù)還要在觸摸屏上設(shè)定運行參數(shù)比如目標(biāo)溫度、壓力閾值這類浮點數(shù)。上位機(jī)下發(fā)float數(shù)據(jù)給MCU或者M(jìn)CU上報float給上位機(jī)都繞不開一個現(xiàn)實問題Modbus寄存器是16位的一個寄存器裝不下32位的float。于是兩個問題就在同一個調(diào)試周期里出現(xiàn)了本地要省IO采旋轉(zhuǎn)開關(guān)遠(yuǎn)程要拆float過Modbus。這篇文章就把這兩塊完整的排查思路、實測數(shù)據(jù)和能直接抄的代碼記下來給后面做類似項目的朋友留個參考。特別是float那塊很多人五花八門的錯誤用法我都見過這里一次性說透。2. 4檔旋轉(zhuǎn)開關(guān)省IO采集2個IO讀4個狀態(tài)2.1 旋轉(zhuǎn)開關(guān)選型和引腳摸底先說選型。市面上能實現(xiàn)4檔的旋轉(zhuǎn)開關(guān)大體分三類第一類是普通波段開關(guān)每個檔位對應(yīng)一個獨立觸點公共端COM加4個分檔引腳這種是最常見的但讀它需要4個IO口第二類是編碼輸出開關(guān)內(nèi)部把檔位編碼成2位二進(jìn)制或格雷碼信號外部只有COM、A、B三根線兩路輸出就是4個狀態(tài)正好滿足需求第三類是增量旋轉(zhuǎn)編碼器比如EC11輸出正交脈沖適合無檔位限制的連續(xù)旋轉(zhuǎn)不適合做檔位絕對位置讀取。我這次選的是第二類雙路編碼輸出的旋轉(zhuǎn)開關(guān)。選它之前有個關(guān)鍵動作把開關(guān)手冊找出來或者直接拿萬用表把4個檔位的通斷關(guān)系摸排一遍。原因很簡單不同廠家的編碼表不一樣有的按自然二進(jìn)制排列即檔位1到4對應(yīng)00、01、10、11有的為了旋鈕旋轉(zhuǎn)時的機(jī)械友好性會按格雷碼排列比如00、01、11、10。查清楚之前千萬別開始寫代碼。舉個實際測量的例子我手里這顆開關(guān)公共端是COM編碼輸出是A和B旋到檔位1時A和B都斷開檔位2時A導(dǎo)通、B斷開檔位3時A斷開、B導(dǎo)通檔位4時A和B都導(dǎo)通。這個通斷關(guān)系就是后續(xù)狀態(tài)表的依據(jù)不同型號可能反著來一切以實測為準(zhǔn)。2.2 硬件接線內(nèi)部上拉、公共端和去耦電容接線方案是這樣的旋轉(zhuǎn)開關(guān)的COM腳接GNDA、B輸出腳分別接MCU的兩個GPIOGPIO配置為輸入模式并開啟內(nèi)部上拉電阻。這樣當(dāng)開關(guān)某一位導(dǎo)通時對應(yīng)引腳被拉到低電平斷開時內(nèi)部上拉把引腳拉回高電平。這里有個容易忽略的細(xì)節(jié)內(nèi)部上拉的阻值通常在30kΩ到50kΩ左右阻值偏大抗干擾能力弱一些。如果設(shè)備工作環(huán)境里有電機(jī)、繼電器這類干擾源建議在A、B線上各加一個10kΩ外部上拉電阻再并聯(lián)一個100nF電容到地組成簡單的RC濾波能顯著降低誤讀概率。我這次在面板樣機(jī)上先用的是純內(nèi)部上拉邏輯分析儀上看波形沒問題但裝到帶220V交流電機(jī)的機(jī)柜里之后偶爾出現(xiàn)檔位跳變后來補了外部上拉和電容就好了。對于引腳采集讀的是電平狀態(tài)代碼上把電平映射成邏輯值#define SW_A_GPIO GPIOA #define SW_A_PIN GPIO_PIN_0 #define SW_B_GPIO GPIOA #define SW_B_PIN GPIO_PIN_1 uint8_t sw_get_raw(void) { uint8_t a (HAL_GPIO_ReadPin(SW_A_GPIO, SW_A_PIN) GPIO_PIN_RESET) ? 1 : 0; uint8_t b (HAL_GPIO_ReadPin(SW_B_GPIO, SW_B_PIN) GPIO_PIN_RESET) ? 1 : 0; return (a 1) | b; }在協(xié)議上導(dǎo)通讀到的低電平被轉(zhuǎn)成邏輯1斷開讀到的被上拉拉高轉(zhuǎn)成邏輯0。這步轉(zhuǎn)換做完檔位1到4對應(yīng)的原始值就是00、01、10、11對應(yīng)十進(jìn)制的0、1、2、3狀態(tài)表就很清晰了。2.3 軟件完成狀態(tài)表映射、去抖與檔位鎖定開關(guān)觸點的機(jī)械抖動是必然存在的尤其是旋轉(zhuǎn)過程中兩個引腳的通斷時序會出現(xiàn)毫秒級的抖動窗口。如果每次讀取都直接當(dāng)作最終結(jié)果檔位顯示會在切換瞬間跳出一串亂碼值。所以軟件上要做兩件事一是連續(xù)多次采樣確認(rèn)狀態(tài)穩(wěn)定二是把穩(wěn)定狀態(tài)映射成檔位。我的做法是每5ms采樣一次連續(xù)4次讀到相同編碼才認(rèn)為檔位有效這樣相當(dāng)于20ms的去抖窗口旋轉(zhuǎn)開關(guān)的切換速度遠(yuǎn)沒有這么快不會覺得響應(yīng)遲鈍。狀態(tài)映射用查表而不是一堆if-else代碼更簡潔uint8_t sw_get_position(void) { static uint8_t last_pos 0; static uint8_t sample_count 0; static uint8_t candidate 0; uint8_t raw sw_get_raw(); uint8_t pos 0; switch (raw) { case 0x00: pos 1; break; case 0x01: pos 2; break; case 0x02: pos 3; break; case 0x03: pos 4; break; default: pos 0; break; } if (pos candidate) { if (sample_count 4) { last_pos pos; } } else { candidate pos; sample_count 0; } return last_pos; }注意case 0x02對應(yīng)的是a1, b0的情況因為raw的高位是A低位是B。如果開關(guān)編碼表是格雷碼把case里的值對應(yīng)改掉即可。這里最核心的思路是不穩(wěn)定時保持上一檔位不變穩(wěn)定之后才更新輸出這就避免了抖動造成的檔位閃爍。3. 檔位采集的實測細(xì)節(jié)抖動、中間態(tài)和上電毛刺3.1 邏輯分析儀揭示的切換瞬間亂象第一次寫好采集代碼后我用邏輯分析儀抓了旋轉(zhuǎn)開關(guān)從檔位1擰到檔位3的過程波形讓我意識到問題沒有想象中簡單。A、B兩個通道在全過程出現(xiàn)了多次毛刺有些毛刺持續(xù)時間只有3到5微秒有些則長達(dá)幾毫秒而且出現(xiàn)了一些非法中間態(tài)比如從01直接跳到11再跳到10這在機(jī)械結(jié)構(gòu)上其實是正常的因為兩顆觸點的通斷本來就有前后順序不可能是絕對同步的。如果不對這些中間態(tài)做處理5ms周期采樣恰好采到11時系統(tǒng)就會短暫判定為檔位4觸摸屏上就會閃一下當(dāng)前檔位4雖然只閃幾十毫秒用戶卻能明顯感覺到。所以狀態(tài)鎖存策略非常關(guān)鍵上一小節(jié)里的連續(xù)4次采樣正是基于這個波形觀察做出來的。3.2 非法狀態(tài)三個處理策略旋轉(zhuǎn)開關(guān)雖然只有4個有效檔位但在切換過程中可能會短暫出現(xiàn)任何其他組合比如00和11之間瞬時變化甚至從有效檔位跳到完全沒定義的組合。處理非法狀態(tài)我試過三種思路對比之后選了第三種。第一種是直接丟棄讀到非法值就保持上次狀態(tài)這個在輕微干擾下表現(xiàn)還行但如果在非法狀態(tài)停留時間較長比如開關(guān)觸點氧化導(dǎo)致接觸不良系統(tǒng)會長時間無響應(yīng)。第二種是進(jìn)入錯誤狀態(tài)把檔位顯示成0或者一個特殊數(shù)值讓上位機(jī)知道當(dāng)前狀態(tài)異常。這個對安全要求高的設(shè)備是對的但這個面板項目的檔位切換本來就是個很隨意的操作沒必要因為一次誤讀就讓整個系統(tǒng)報錯。第三種也是最終用的策略非法值視為無效連續(xù)多次讀到同一個非法值才進(jìn)入未定義檔位狀態(tài)否則保持上一有效檔位。這樣既不會閃跳也不會一有風(fēng)吹草動就報錯。工程上穩(wěn)妥的做法是在狀態(tài)機(jī)里加一個計數(shù)器連續(xù)讀到無效值超過200ms才真正認(rèn)為檔位異常。3.3 上電瞬間的防誤判還有一個很容易踩的坑是上電瞬間。MCU復(fù)位后GPIO在復(fù)用功能配置完成之前默認(rèn)可能是浮空輸入此時旋轉(zhuǎn)開關(guān)如果有觸點導(dǎo)通引腳電平被拉低但如果沒有導(dǎo)通引腳電壓處于不確定狀態(tài)可能是高也可能是低。如果恰好讀到一組有效編碼系統(tǒng)一開機(jī)就鎖定了錯誤檔位。解決方法是把檔位初始化函數(shù)的執(zhí)行順序放在GPIO配置完全生效、內(nèi)部上拉穩(wěn)定之后并且在初始化階段連續(xù)讀20次也就是100ms的穩(wěn)定時間期間所有讀到的值只用來刷新候選不直接更新last_pos等第一輪采樣結(jié)束后才把最終候選賦給檔位變量。實際測試下來無論開關(guān)停在哪個檔位上電都能準(zhǔn)確抓到真實檔位沒有再出現(xiàn)錯位。4. Modbus里float為什么拆不對字節(jié)序的真相4.1 1.0f在內(nèi)存里的樣子與IEEE 754布局先說float本身的存儲。按IEEE 754標(biāo)準(zhǔn)單精度float占32位分成三部分最高bit是符號位接下來8位是指數(shù)最低23位是尾數(shù)。以1.0f為例它的十六進(jìn)制表示是0x3F800000二進(jìn)制展開是0 01111111 00000000000000000000000符號位0表示正數(shù)指數(shù)位0x7F加上偏移量之后對應(yīng)2的0次方尾數(shù)部分全是0隱含的整數(shù)位是1所以數(shù)值就是1.0。問題是這個0x3F800000放在MCU內(nèi)存里的順序。STM32、AVR這類主流的小端CPU內(nèi)存地址從低到高存放的是00 00 80 3F。也就是說你用調(diào)試器看一個float變量內(nèi)存窗口里看到的是倒序。這一點如果不搞清楚后面所有轉(zhuǎn)換代碼都會錯得莫名其妙。我見過不少人在串口調(diào)試助手里用printf把float按字節(jié)打印發(fā)現(xiàn)順序和理論值對不上就開始懷疑編譯器有問題其實完全是大小端在作怪。想要看得直觀可以先用聯(lián)合體或者memcpy把float轉(zhuǎn)成無符號整數(shù)再打印十六進(jìn)制值。4.2 Modbus字序、字節(jié)序與寄存器地址順序的關(guān)系Modbus協(xié)議本身做了很多規(guī)定比如讀寫保持寄存器、讀輸入寄存器每個寄存器的數(shù)據(jù)都是16位多字節(jié)的數(shù)據(jù)類型都必須大端傳輸也就是高位字節(jié)在前。但對于float這種跨兩個寄存器的32位數(shù)據(jù)協(xié)議沒有明確規(guī)定兩個寄存器之間按什么順序排也沒有規(guī)定用這兩種字序之外是否允許字節(jié)交換這就給設(shè)備廠商留下了自由空間也給聯(lián)調(diào)挖了坑。我在實際項目里遇到的設(shè)備大致有四種格式格式名稱1.0f的寄存器值兩個寄存器報文中的字節(jié)序列說明AB CD標(biāo)準(zhǔn)大端0x3F80, 0x00003F 80 00 00最高字在前高字節(jié)在前CD AB字交換0x0000, 0x3F8000 00 3F 80低字在前高字在后BADC字節(jié)交換0x803F, 0x000080 3F 00 00每16位內(nèi)部字節(jié)顛倒DCBA全小端0x0000, 0x803F00 00 80 3F字交換外加字節(jié)交換這四種格式在市面上都能找到有的PLC、觸摸屏、儀表用AB CD有的傳感器模塊用CD AB有的國產(chǎn)模塊還默認(rèn)DCBA沒有統(tǒng)一標(biāo)準(zhǔn)。聯(lián)調(diào)時如果不對齊格式上位機(jī)讀回來的float經(jīng)常是一個天文數(shù)字或者兩個寄存器互相拆分成兩個奇怪的整數(shù)。還有一個維度是寄存器地址順序。同一個float拆成兩個寄存器有些設(shè)備把高位字放在低地址功能碼地址小的那一個有些設(shè)備把高位字放在高地址。即使字節(jié)和字序都選對了這兩個寄存器在地址上放反解析出來照樣錯。所以做協(xié)議對接第一步永遠(yuǎn)是查對方手冊里的寄存器表確認(rèn)哪幾個地址裝的是這個float再根據(jù)實際值反推格式。5. float拆分還原的工程實現(xiàn)與驗證5.1 三種常見寫法對比union、指針、位運算拆分float最直觀的做法是用聯(lián)合體把float和uint16_t數(shù)組放在同一個內(nèi)存空間里讀出來就是兩個16位字。代碼很短調(diào)試也方便typedef union { float f; uint16_t w[2]; } float_uint16_union_t; float_uint16_union_t u; u.f 3.14f; // u.w[0], u.w[1] 直接作為兩個寄存器內(nèi)容但問題在于u.w[0]和u.w[1]的排列取決于CPU大小端。在STM32上u.w[0]拿到的是低16位也就是0x1EB8u.w[1]拿到的是高16位0x40483.14f的十六進(jìn)制是0x4048F5C3小端順序是C3 F5 48 40。直接把這兩個字塞進(jìn)Modbus寄存器上位機(jī)按AB CD解析就會得到一個完全不對的數(shù)。第二種寫法是指針直接操作本質(zhì)和union一樣也是受CPU大小端影響。第三種是位運算加memcpy先把float的位模式取成一個uint32_t整數(shù)再用數(shù)值移位的方式按字節(jié)拆分這種寫法與CPU大小端、編譯器平臺都無關(guān)是嵌入式工程里最適合做協(xié)議封裝的方案void float_to_modbus(float value, uint16_t *regs, uint8_t order) { uint32_t bits 0; uint8_t b[4]; memcpy(bits, value, 4); b[0] (uint8_t)(bits 24); /* 最高字節(jié) */ b[1] (uint8_t)(bits 16); b[2] (uint8_t)(bits 8); b[3] (uint8_t)(bits 0xFF); /* 最低字節(jié) */ switch (order) { case FLOAT_ORDER_ABCD: /* 標(biāo)準(zhǔn)大端 AB CD */ regs[0] (uint16_t)((b[0] 8) | b[1]); regs[1] (uint16_t)((b[2] 8) | b[3]); break; case FLOAT_ORDER_CDAB: /* 字交換 */ regs[0] (uint16_t)((b[2] 8) | b[3]); regs[1] (uint16_t)((b[0] 8) | b[1]); break; case FLOAT_ORDER_BADC: /* 字節(jié)交換 */ regs[0] (uint16_t)((b[1] 8) | b[0]); regs[1] (uint16_t)((b[3] 8) | b[2]); break; default: regs[0] 0; regs[1] 0; break; } }這里的關(guān)鍵點是memcpy(bits, value, 4)先把float的位模式原樣搬到uint32_t變量里之后的移位操作是在數(shù)值層面進(jìn)行的不依賴CPU按什么順序存這幾個字節(jié)。無論芯片是小端還是大端b[0]拿到的一定是float的bit31到bit24。5.2 用固定值在Modbus Poll里快速驗證格式代碼寫完之后最怕的是格式選錯了還不知道。我習(xí)慣先用1.0f這種特征非常明顯的數(shù)來驗證。1.0f的十六進(jìn)制是0x3F800000如果設(shè)備按標(biāo)準(zhǔn)AB CD方式發(fā)送Modbus Poll數(shù)據(jù)區(qū)應(yīng)該顯示第一個寄存器為0x3F80第二個寄存器為0x0000。如果第一個寄存器是0x0000第二個是0x3F80說明設(shè)備用的是CD AB字交換?？吹?x803F和0x0000則是BADC字節(jié)交換。這四個特征對照表可以直接拿去做聯(lián)調(diào)時的判斷依據(jù)。Modbus Poll軟件里有一個很方便的功能查看寄存器時可以把顯示格式切到Float或Float swapped它會自動按當(dāng)前配置解釋兩個連續(xù)寄存器。但注意這只是軟件側(cè)的解釋方式真正決定數(shù)據(jù)對不對的是設(shè)備發(fā)出來時采用的格式。我用這個方式跟幾個不同品牌觸摸屏聯(lián)調(diào)時十分鐘內(nèi)就能把格式對上。5.3 實戰(zhàn)中出現(xiàn)天書數(shù)字的排查鏈路如果上位機(jī)讀到的float顯示成了幾百、幾萬、甚至NaN之類的值基本可以肯定是格式不匹配。我的排查鏈路是固定的先用Modbus Poll按無符號整數(shù)格式看兩個寄存器的原始值把原始值轉(zhuǎn)成十六進(jìn)制跟0x3F800000這類已知值對比判斷是哪一種排列再修改代碼里的order參數(shù)或者上位機(jī)的數(shù)據(jù)格式設(shè)置一步步逼近。有一次現(xiàn)場聯(lián)調(diào)上位機(jī)讀到溫度值顯示為-1082130432這個數(shù)一看就是有符號整數(shù)解釋了一個不算太離譜的位模式把寄存器原始值記下來轉(zhuǎn)十六進(jìn)制是0xC1200000和0x00000000的組合0xC1200000是-10.0f的二進(jìn)制表示也就是-192.0之類其實本質(zhì)是對的只是高字和低字位置錯了。把代碼里的FLOAT_ORDER_ABCD改成FLOAT_ORDER_CDAB之后顯示立刻變成-10.0。這類問題一般二十分鐘就能定位完但如果每一步都靠猜可能一整天都搞不定。6. 把兩個問題串起來旋鈕檔位以float量值上報6.1 完整示例檔位采集、參數(shù)映射、寄存器組包整個鏈路捋通之后我寫了一個組合示例旋轉(zhuǎn)開關(guān)當(dāng)前檔位讀出來映射成一個float參數(shù)再按特定格式打包進(jìn)Modbus保持寄存器上位機(jī)直接讀寄存器就能顯示當(dāng)前模式和參數(shù)值。#include string.h #define FLOAT_ORDER_ABCD 0 uint8_t sw_get_position(void); void float_to_modbus(float value, uint16_t *regs, uint8_t order); static const float mode_map[4] { 0.0f, /* 檔位1停機(jī)模式 */ 12.5f, /* 檔位2低速模式 */ 25.0f, /* 檔位3中速模式 */ 37.5f /* 檔位4高速模式 */ }; void app_update_holding_regs(uint16_t *holding_regs, uint16_t len) { uint8_t pos sw_get_position(); uint16_t float_regs[2]; float_to_modbus(mode_map[pos - 1], float_regs, FLOAT_ORDER_ABCD); if (len 4) { holding_regs[0] pos; /* 當(dāng)前檔位 */ holding_regs[1] float_regs[0]; /* float 高字 */ holding_regs[2] float_regs[1]; /* float 低字 */ holding_regs[3] 0; /* 備用 */ } }注意mode_map的索引sw_get_position返回的pos是從1開始的對應(yīng)數(shù)組下標(biāo)要減1。如果旋轉(zhuǎn)開關(guān)的檔位和mode_map的映射關(guān)系在硬件上就是反的那在查表前把pos做一個映射即可不要用1-1這種硬編碼去湊。6.2 上位機(jī)側(cè)和協(xié)議文檔的約定要點寄存器地址規(guī)劃也不是隨意的要寫在協(xié)議文檔里。我的慣例是從地址0開始0號寄存器存當(dāng)前檔位1號和2號寄存器存float參數(shù)兩個寄存器的語義在文檔里寫清楚比如地址1為參數(shù)值高字地址2為參數(shù)值低字格式為IEEE 754標(biāo)準(zhǔn)大端AB CD。別小看這一句話它能讓后面接手的同事少走很多彎路。Modbus RTU從機(jī)收到讀保持寄存器請求后把數(shù)據(jù)從固定數(shù)組里取出來按大端方式組幀返回。STM32上處理Modbus幀時寄存器的字節(jié)序本身也要注意MCU的小端字節(jié)順序和Modbus協(xié)議要求的大端順序不同很多人為了省事直接在協(xié)議層用memcpy把整個寄存器數(shù)組發(fā)出去這在x86測試平臺上可能沒問題但在小端MCU上就會全部反掉。這里有個經(jīng)驗Modbus RTU的CRC計算和幀組包最好獨立寫一個工具函數(shù)幀里的兩個字節(jié)和寄存器內(nèi)部的字節(jié)序分開處理別混在一起。我在初版代碼里就是因為把寄存器字節(jié)序轉(zhuǎn)換和CRC計算寫在一個函數(shù)里出了問題后定位花了很長時間。在實測中我還把旋轉(zhuǎn)開關(guān)切換過程里讀到的檔位變化做成事件通知每當(dāng)檔位穩(wěn)定后才更新保持寄存器并且給上位機(jī)發(fā)一條主動上報的廣播幀。雖然標(biāo)準(zhǔn)Modbus RTU是主從問答式但從機(jī)可以在收到主機(jī)的請求幀后在返回數(shù)據(jù)里帶上最新的狀態(tài)不建議從機(jī)主動發(fā)數(shù)據(jù)容易在總線上造成沖突。我這里的做法是在主機(jī)周期輪詢時從機(jī)每次返回最新值這樣上位機(jī)雖然最多延遲一個輪詢周期但數(shù)據(jù)永遠(yuǎn)是準(zhǔn)的。