簡(jiǎn)介這份資源面向具備一定C#基礎(chǔ)、希望打通上位機(jī)與工業(yè)控制設(shè)備數(shù)據(jù)鏈路的開(kāi)發(fā)者圍繞C#與匯川PLC之間的通信展開(kāi)重點(diǎn)解決TCP/IP連接建立、Modbus協(xié)議報(bào)文構(gòu)造與寄存器讀寫(xiě)等實(shí)際問(wèn)題適合自動(dòng)化系統(tǒng)集成、工控上位機(jī)開(kāi)發(fā)等場(chǎng)景的初中級(jí)學(xué)習(xí)者參考。壓縮包共624個(gè)文件、約214.54MB包含12個(gè)cs源碼、12個(gè)vb示例、6個(gè)sln解決方案及配套csproj工程文件另有大量h、cpp、lib、dll等底層庫(kù)與編譯產(chǎn)物以及docx說(shuō)明、xml配置和txt日志便于對(duì)照源碼理解通信庫(kù)的調(diào)用方式。資源已有582人學(xué)習(xí)下載。內(nèi)容覆蓋C#網(wǎng)絡(luò)編程、Modbus主從架構(gòu)與ASCII/RTU/TCP傳輸模式、匯川PLC地址映射與命令集配置并涉及CRC校驗(yàn)、異常處理與超時(shí)重試、通信性能優(yōu)化及WinForms/WPF界面集成等要點(diǎn)讀者可據(jù)此搭建可運(yùn)行的通信示例掌握請(qǐng)求響應(yīng)解析與排錯(cuò)思路。1. 從一條產(chǎn)線調(diào)試現(xiàn)場(chǎng)說(shuō)起C# 對(duì)接匯川 PLC 到底難在哪產(chǎn)線聯(lián)調(diào)最怕的不是 PLC 邏輯寫(xiě)錯(cuò)而是上位機(jī)連不上。某次現(xiàn)場(chǎng)一臺(tái)工控機(jī)跑著 C# 寫(xiě)的上位機(jī)網(wǎng)線插好、IP 也配了點(diǎn)“連接”就是沒(méi)反應(yīng)換成調(diào)試軟件卻能讀到數(shù)據(jù)。折騰半天才發(fā)現(xiàn)問(wèn)題出在端口號(hào)和站號(hào)上——調(diào)試軟件默認(rèn)走的是另一套參數(shù)而代碼里寫(xiě)死的是另一套。這類“玄學(xué)”問(wèn)題在 C# 與匯川 PLC 通信里太常見(jiàn)了。這份示例資源要解決的就是讓 C# 上位機(jī)穩(wěn)定讀寫(xiě)匯川 PLC 的寄存器、線圈和狀態(tài)位。它適合兩類人一是剛接手產(chǎn)線上位機(jī)、需要快速跑通通信的 C# 開(kāi)發(fā)者二是想把通信層封裝成可復(fù)用模塊、后續(xù)接 MES 或數(shù)據(jù)采集的老手。下面按“協(xié)議選型 → 代碼落地 → 排錯(cuò)避坑 → 進(jìn)階驗(yàn)證”的順序拆開(kāi)講每一步都能照著復(fù)現(xiàn)。2. 協(xié)議選型與連接參數(shù)先把 Modbus TCP 這條鏈路理清楚匯川 PLC 的以太網(wǎng)通信主流走的是 Modbus TCP。它把 Modbus 的 RTU 幀塞進(jìn) TCP 載荷里去掉了 CRC 校驗(yàn)靠 TCP 本身保證可靠性。對(duì) C# 來(lái)說(shuō)這意味著不需要額外驅(qū)動(dòng)用System.Net.Sockets就能直接發(fā)字節(jié)流。選它的理由很實(shí)在協(xié)議公開(kāi)、調(diào)試工具多、跨平臺(tái)工控機(jī)上跑 .NET Framework 或 .NET 8 都行。但“能通”和“穩(wěn)定”是兩回事。連接參數(shù)里藏著幾個(gè)必須對(duì)齊的點(diǎn)錯(cuò)一個(gè)就連不上或者讀回臟數(shù)據(jù)。2.1 端口、站號(hào)與寄存器地址的三組對(duì)齊Modbus TCP 默認(rèn)端口是 502但匯川部分型號(hào)的以太網(wǎng)口會(huì)映射到其他端口現(xiàn)場(chǎng)一定要以 PLC 側(cè)配置為準(zhǔn)。站號(hào)Unit ID在 TCP 模式下通常填 1可有些網(wǎng)關(guān)或雙機(jī)場(chǎng)景會(huì)改成別的值代碼里寫(xiě)死 1 就可能被拒。寄存器地址是最容易翻車(chē)的地方。匯川 PLC 的軟元件地址如 D100、M10和 Modbus 寄存器地址之間有一個(gè)偏移映射常見(jiàn)做法是 D 寄存器從 0 開(kāi)始對(duì)應(yīng)保持寄存器 40001 之后的區(qū)域但不同系列偏移規(guī)則不完全一樣。我一般會(huì)先拿調(diào)試軟件讀一個(gè)已知值記下它實(shí)際發(fā)出的寄存器地址再把這個(gè)地址寫(xiě)進(jìn)代碼而不是憑手冊(cè)硬推。參數(shù)常見(jiàn)取值說(shuō)明協(xié)議Modbus TCP匯川以太網(wǎng)口主流支持端口502以 PLC 側(cè)實(shí)際配置為準(zhǔn)站號(hào)1網(wǎng)關(guān)或多機(jī)場(chǎng)景需核對(duì)功能碼03/06/16讀保持寄存器、寫(xiě)單寄存器、寫(xiě)多寄存器超時(shí)10003000 ms產(chǎn)線網(wǎng)絡(luò)抖動(dòng)大時(shí)適當(dāng)放寬2.2 用 Socket 手搓一幀請(qǐng)求看清字節(jié)序再動(dòng)手不急著上庫(kù)先用最原始的方式發(fā)一幀能幫你把協(xié)議吃透。下面這段代碼構(gòu)造一個(gè)讀保持寄存器的請(qǐng)求讀站號(hào) 1、起始地址 0、數(shù)量 2。using System; using System.Net.Sockets; byte[] BuildReadHolding(int unitId, ushort startAddr, ushort count) { // Modbus TCP 報(bào)文頭事務(wù)號(hào)(2) 協(xié)議號(hào)(2) 長(zhǎng)度(2) 站號(hào)(1) byte[] frame new byte[12]; frame[0] 0x00; frame[1] 0x01; // 事務(wù)號(hào)任意響應(yīng)會(huì)原樣帶回 frame[2] 0x00; frame[3] 0x00; // 協(xié)議號(hào)固定 0 frame[4] 0x00; frame[5] 0x06; // 后續(xù)字節(jié)數(shù) 站號(hào)1 PDU5 frame[6] (byte)unitId; // 站號(hào) frame[7] 0x03; // 功能碼讀保持寄存器 frame[8] (byte)(startAddr 8); // 起始地址高字節(jié) frame[9] (byte)(startAddr 0xFF); // 起始地址低字節(jié) frame[10] (byte)(count 8); // 數(shù)量高字節(jié) frame[11] (byte)(count 0xFF); // 數(shù)量低字節(jié) return frame; } using var client new TcpClient(); client.Connect(192.168.1.10, 502); // PLC 實(shí)際 IP 與端口 var stream client.GetStream(); var req BuildReadHolding(1, 0, 2); stream.Write(req, 0, req.Length); byte[] resp new byte[256]; int n stream.Read(resp, 0, resp.Length); Console.WriteLine($收到 {n} 字節(jié)功能碼 {resp[7]:X2});邏輯上分三層報(bào)文頭負(fù)責(zé)事務(wù)匹配和長(zhǎng)度聲明PDU 里的功能碼決定操作類型地址和數(shù)量按大端序排列。參數(shù)說(shuō)明unitId填 PLC 站號(hào)startAddr是 Modbus 寄存器地址而非軟元件編號(hào)count一次別超過(guò) 125 個(gè)寄存器否則部分設(shè)備會(huì)直接回異常碼。響應(yīng)里resp[7]是功能碼若最高位為 1如 0x83說(shuō)明是異常響應(yīng)resp[8]就是異常碼常見(jiàn) 0x02 是地址非法、0x03 是數(shù)量超限。2.3 封裝成可復(fù)用類把連接、重連、超時(shí)收進(jìn)一個(gè)殼手搓幀適合理解協(xié)議真上產(chǎn)線得封裝。我一般會(huì)做一個(gè)ModbusTcpClient類內(nèi)部持有TcpClient對(duì)外暴露ReadHolding、WriteSingle、WriteMultiple三個(gè)方法連接狀態(tài)用IsConnected屬性暴露重連邏輯放在調(diào)用方或定時(shí)器里。public class ModbusTcpClient : IDisposable { private TcpClient _tcp; private NetworkStream _stream; private readonly string _ip; private readonly int _port; private readonly int _timeoutMs; public ModbusTcpClient(string ip, int port 502, int timeoutMs 2000) { _ip ip; _port port; _timeoutMs timeoutMs; } public bool Connect() { try { _tcp new TcpClient(); var task _tcp.ConnectAsync(_ip, _port); if (!task.Wait(_timeoutMs)) return false; // 連接超時(shí)保護(hù) _stream _tcp.GetStream(); _stream.ReadTimeout _timeoutMs; _stream.WriteTimeout _timeoutMs; return true; } catch { return false; } } public ushort[] ReadHolding(byte unitId, ushort start, ushort count) { var req BuildReadHolding(unitId, start, count); _stream.Write(req, 0, req.Length); byte[] head ReadExact(7); // 先讀 7 字節(jié)頭 int len (head[4] 8) | head[5]; // 頭里聲明的后續(xù)長(zhǎng)度 byte[] body ReadExact(len - 1); // 再讀剩余部分 if ((body[0] 0x80) ! 0) throw new Exception($異常碼 {body[1]:X2}); int byteCount body[1]; var result new ushort[byteCount / 2]; for (int i 0; i result.Length; i) result[i] (ushort)((body[2 i * 2] 8) | body[3 i * 2]); return result; } private byte[] ReadExact(int n) { byte[] buf new byte[n]; int off 0; while (off n) { int r _stream.Read(buf, off, n - off); if (r 0) throw new IOException(連接被對(duì)端關(guān)閉); off r; } return buf; } public void Dispose() { _stream?.Dispose(); _tcp?.Dispose(); } }這里的關(guān)鍵是ReadExactTCP 是流式協(xié)議一次Read不保證讀滿必須循環(huán)讀到指定長(zhǎng)度否則解析會(huì)錯(cuò)位。Connect里用Wait加超時(shí)避免網(wǎng)絡(luò)不通時(shí)界面卡死。參數(shù)上timeoutMs建議 2000 起步產(chǎn)線交換機(jī)負(fù)載高時(shí)調(diào)到 3000。寫(xiě)操作同理功能碼 06 寫(xiě)單寄存器、16 寫(xiě)多寄存器注意寫(xiě)多寄存器時(shí)字節(jié)數(shù)要按“數(shù)量×2”填。3. 讀寫(xiě)寄存器與線圈把軟元件映射成 C# 里的強(qiáng)類型協(xié)議通了下一步是把 PLC 里的 D、M、X、Y 這些軟元件映射成 C# 里能直接用的變量。這一步做得好上層業(yè)務(wù)代碼就不用關(guān)心字節(jié)序和地址偏移做得糙后面每加一個(gè)點(diǎn)位都要改通信層。3.1 D 寄存器與 M 線圈的地址換算表匯川 PLC 的軟元件和 Modbus 地址之間不是一一對(duì)應(yīng)常見(jiàn)映射關(guān)系如下表。注意這只是常見(jiàn)做法具體型號(hào)要以手冊(cè)或調(diào)試軟件實(shí)測(cè)為準(zhǔn)。軟元件類型Modbus 區(qū)域常見(jiàn)起始地址讀寫(xiě)功能碼D0Dn數(shù)據(jù)寄存器保持寄存器003 / 06 / 16M0Mn輔助繼電器線圈001 / 05 / 15X0Xn輸入離散輸入002只讀Y0Yn輸出線圈001 / 05 / 15換算時(shí)最容易錯(cuò)的是“軟元件編號(hào)”和“Modbus 地址”混用。比如 D100 不一定對(duì)應(yīng)寄存器地址 100有的系列會(huì)整體偏移。我的習(xí)慣是先在調(diào)試軟件里讀 D100抓包看它實(shí)際請(qǐng)求的地址再把這個(gè)地址寫(xiě)進(jìn)配置表而不是在代碼里做加減。3.2 批量讀寫(xiě)的分塊策略與字節(jié)序處理一次讀太多寄存器PLC 可能回異?；蝽憫?yīng)變慢。常見(jiàn)做法是按 100 個(gè)寄存器一塊切分循環(huán)讀取再拼接。字節(jié)序方面Modbus 寄存器內(nèi)部是大端但 32 位浮點(diǎn)數(shù)跨兩個(gè)寄存器時(shí)有的設(shè)備高字在前、有的低字在前讀回來(lái)要按實(shí)際順序拼。// 分塊讀取 0299 共 300 個(gè)保持寄存器 var all new Listushort(); for (ushort start 0; start 300; start 100) { ushort count (ushort)Math.Min(100, 300 - start); all.AddRange(client.ReadHolding(1, start, count)); } // 兩個(gè)寄存器拼一個(gè) float注意字序 float ToFloat(ushort high, ushort low) { byte[] b new byte[4]; BitConverter.GetBytes(high).CopyTo(b, 0); BitConverter.GetBytes(low).CopyTo(b, 2); if (BitConverter.IsLittleEndian) Array.Reverse(b); return BitConverter.ToSingle(b, 0); }分塊大小 100 是經(jīng)驗(yàn)值既不會(huì)觸發(fā)數(shù)量上限又能減少往返次數(shù)。ToFloat里先按大端拼字節(jié)再轉(zhuǎn)若現(xiàn)場(chǎng)讀出的浮點(diǎn)數(shù)明顯不對(duì)比如變成極小值或 NaN多半是字序反了把high和low對(duì)調(diào)再試。線圈讀寫(xiě)類似功能碼 01 讀、05 寫(xiě)單個(gè)、15 寫(xiě)多個(gè)讀回來(lái)按位解析第 0 位對(duì)應(yīng)起始地址那個(gè)線圈。3.3 用定時(shí)器做輪詢別讓界面線程背鍋上位機(jī)要實(shí)時(shí)刷新數(shù)據(jù)常見(jiàn)做法是開(kāi)一個(gè)后臺(tái)線程或System.Threading.Timer按固定周期讀一批點(diǎn)位讀到后更新緩存界面只讀緩存。千萬(wàn)別在 UI 線程里同步調(diào)通信方法網(wǎng)絡(luò)一抖界面就假死。private readonly object _lock new object(); private ushort[] _cache Array.Emptyushort(); var timer new System.Threading.Timer(_ { try { var data client.ReadHolding(1, 0, 50); lock (_lock) { _cache data; } // 只換引用讀側(cè)無(wú)鎖競(jìng)爭(zhēng) } catch (Exception ex) { // 記錄日志標(biāo)記連接異常交給重連邏輯 Console.WriteLine($輪詢失敗{ex.Message}); } }, null, 0, 500); // 500ms 一輪輪詢周期 500ms 適合大多數(shù)監(jiān)控場(chǎng)景點(diǎn)位多時(shí)降到 1000ms避免把 PLC 通信口打滿。緩存用引用替換而不是逐元素拷貝讀側(cè)加鎖時(shí)間極短。異常不要吞掉至少記日志并置一個(gè)連接狀態(tài)標(biāo)志重連邏輯根據(jù)這個(gè)標(biāo)志決定是否重建連接。4. 避坑與排查連不上、讀回臟數(shù)據(jù)、斷線重連的現(xiàn)場(chǎng)記錄通信層寫(xiě)完只是開(kāi)始現(xiàn)場(chǎng)跑起來(lái)才是真正的考驗(yàn)。下面幾條是反復(fù)踩過(guò)的坑按“現(xiàn)象 → 原因 → 解決”記下來(lái)遇到時(shí)能少走彎路。4.1 現(xiàn)象連接成功但讀回全 0 或異常碼 0x02原因通常是寄存器地址算錯(cuò)或者站號(hào)不對(duì)。有的 PLC 在 TCP 模式下站號(hào)必須與配置一致填錯(cuò)時(shí)設(shè)備會(huì)回異常而不是斷開(kāi)。解決先用調(diào)試軟件讀同一地址抓包對(duì)比請(qǐng)求幀里的站號(hào)和地址字段逐字節(jié)核對(duì)確認(rèn)地址偏移規(guī)則后把映射表固化成配置不要散落在代碼里。4.2 現(xiàn)象偶發(fā)讀到半截?cái)?shù)據(jù)解析錯(cuò)位這是典型的 TCP 粘包/半包問(wèn)題。一次Read可能只拿到報(bào)文頭的一部分直接按固定長(zhǎng)度解析就會(huì)錯(cuò)位。解決嚴(yán)格按報(bào)文頭里的長(zhǎng)度字段循環(huán)讀滿像前面ReadExact那樣讀到 0 字節(jié)說(shuō)明對(duì)端關(guān)閉要觸發(fā)重連而不是繼續(xù)解析。4.3 現(xiàn)象運(yùn)行幾小時(shí)后連接假死重啟程序才恢復(fù)原因多是網(wǎng)絡(luò)閃斷后TcpClient處于半開(kāi)狀態(tài)Read一直阻塞或返回 0 卻沒(méi)被處理。解決設(shè)置ReadTimeout/WriteTimeout捕獲IOException后主動(dòng)Dispose舊連接并重建輪詢線程里加一個(gè)“連續(xù)失敗 N 次則重連”的計(jì)數(shù)器N 取 3 比較穩(wěn)。4.4 現(xiàn)象寫(xiě)寄存器成功但 PLC 側(cè)數(shù)值沒(méi)變先確認(rèn)寫(xiě)的是不是保持寄存器、功能碼對(duì)不對(duì)再確認(rèn) PLC 程序里有沒(méi)有對(duì)該寄存器做覆蓋寫(xiě)。有些場(chǎng)景下 HMI 和上位機(jī)同時(shí)寫(xiě)同一地址后寫(xiě)的覆蓋先寫(xiě)的。解決寫(xiě)之前讀一次確認(rèn)當(dāng)前值寫(xiě)之后回讀校驗(yàn)失敗則重試一次并記錄避免“以為寫(xiě)成功”的假象。4.5 現(xiàn)象多線程同時(shí)讀寫(xiě)導(dǎo)致響應(yīng)串包多個(gè)線程共用一個(gè)NetworkStream且沒(méi)有加鎖請(qǐng)求和響應(yīng)會(huì)交錯(cuò)。解決通信層內(nèi)部加一把鎖保證“發(fā)一幀、收一幀”原子完成或者每個(gè)連接只由一個(gè)輪詢線程使用其他線程通過(guò)隊(duì)列提交請(qǐng)求。我一般選后者結(jié)構(gòu)更清晰。5. 進(jìn)階驗(yàn)證用回環(huán)測(cè)試和抓包把通信層釘死通信層交付前我習(xí)慣做兩件事一是本地回環(huán)測(cè)試二是在真實(shí)鏈路上抓包核對(duì)。回環(huán)測(cè)試不依賴 PLC用一個(gè)本地 TCP 服務(wù)端模擬響應(yīng)能驗(yàn)證解析邏輯和異常分支抓包則能看清實(shí)際發(fā)出的每一幀地址、站號(hào)、功能碼一目了然。回環(huán)測(cè)試可以這樣搭起一個(gè)TcpListener監(jiān)聽(tīng)本地端口收到請(qǐng)求后按協(xié)議拼一個(gè)響應(yīng)回去重點(diǎn)覆蓋正常響應(yīng)、異常響應(yīng)、半包三種情況。半包場(chǎng)景手動(dòng)把響應(yīng)拆成兩次發(fā)送驗(yàn)證ReadExact是否還能正確拼回。抓包用常見(jiàn)的網(wǎng)絡(luò)分析工具過(guò)濾目標(biāo) IP 和 502 端口對(duì)照代碼里的請(qǐng)求幀逐字段看地址偏移對(duì)不對(duì)、站號(hào)有沒(méi)有被改一眼就能看出來(lái)。驗(yàn)證項(xiàng)方法通過(guò)標(biāo)準(zhǔn)正常讀回環(huán)返回合法響應(yīng)解析出的寄存器值與預(yù)期一致異常響應(yīng)回環(huán)返回 0x83 異常碼拋出帶異常碼的異常不崩潰半包響應(yīng)分兩次發(fā)送仍能拼出完整幀斷線重連中途關(guān)閉服務(wù)端計(jì)數(shù)觸發(fā)重連恢復(fù)后繼續(xù)讀有個(gè)細(xì)節(jié)值得單獨(dú)說(shuō)浮點(diǎn)數(shù)和 32 位整數(shù)跨寄存器時(shí)字序問(wèn)題在回環(huán)測(cè)試?yán)锞鸵采w到別等到現(xiàn)場(chǎng)才發(fā)現(xiàn)讀出來(lái)是天文數(shù)字。我一般會(huì)在回環(huán)里準(zhǔn)備兩組字序的樣本確認(rèn)代碼能按配置切換。從那以后我每次交付通信模塊都強(qiáng)制走一遍“回環(huán) 抓包 斷線重連”三件套哪怕工期再緊也不省這一步——現(xiàn)場(chǎng)返工的成本遠(yuǎn)比多花半天驗(yàn)證高。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取