IoTClient開發5 - ModBusRtu協議

時間 2019-12-18

標籤 iotclient 開發 modbusrtu 協議简体版

原文原文鏈接

前言

前面咱們介紹了ModBusTcp協議。今天咱們接着來介紹ModBusRtu協議。和ModBusTcp不一樣的是ModBusRtu基於串口通訊，ModBusTcp是基於Tcp以太網通訊。
因此咱們在講解ModBusRtu協議以前會先介紹下串口通訊。html

串口通訊

串口出如今1980年先後，當初主要目的是用來作電腦外設設備的鏈接，如鼠標、鍵盤等。如今最新的電腦慢慢的取消了原始的串口接口，不過依然普遍用於工控和測量等設備。git

串口通訊參數

串口通訊指的是串口按位(bit)發送和接收字節，串口通訊參數主要有波特率、數據位、中止位、校驗位。github

波特率

波特率表達的是串口通訊的速率，一秒鐘內傳送的信號單元(碼元)個數。信號單元通常包含10位(7個數據位、1個校驗位、1到2箇中止位)。注意：波特率和距離成反比算法

數據位

通訊中實際的數據，有效值爲六、7和8。ide

中止位

用來表示單個包的最後一位，有效值爲一、1.5和2。中止位可用來表示傳輸的結束和校訂時鐘同步。注意：中止位的位數越多，時鐘同步的容忍程度越大，可是數據傳輸率會越慢。測試

校驗位

奇偶校驗做爲通訊中的檢錯方式，若是發現錯誤則從新發送。code

示例數據	偶校驗位	奇校驗位
0000000	00000000	00000001
1010001	10100011	10100010
1101001	11010010	11010011
1111111	11111111	11111110

從上能夠看出奇偶校驗就是在數據最後加一位，使數據中的1的數量保持偶數或奇數。htm

波特率和比特率（擴展知識）

比特率是咱們經常使用來表達寬帶速率的一種方法。看上去和波特率很像，若是波特率的信號碼元只傳1比特(bit)，那麼它們之間是相等的。若是波特率的信號碼元傳10比特，那麼波特率是比特率的10倍。因此，波特率和比特率表達的意義是不同的，不要搞混了。對象

寬帶比特率的實際下載速度（擴展知識）

Mbps和Mbit/s等效、kbit/s和kbps等效、bps和bit/s等效
1Mbps(Mbit/s) = 11024kbit(kbit/s) = 11024*1024bps(bit/s)，注意他們的單位都是bit(比特)，而不是byte(字節)，因此實際下載速度要除以八。1024 / 8 = 128 kb/s。blog

CRC16校驗

CRC，Cyclic Redundancy Check循環冗餘檢驗，是基於數據計算一組效驗碼，用於覈對數據傳輸過程當中是否被更改或傳輸錯誤。而ModBusRtu用到的是其中的CRC16校驗。
其計算原理，可參考 1、2、3
如下是CRC16反向算法，經測試可用於ModBusRtu的CRC計算。

public class CRC16
{
    /// <summary>
    /// 驗證CRC16校驗碼
    /// </summary>
    /// <param name="value">校驗數據</param>
    /// <param name="poly">多項式碼</param>
    /// <param name="crcInit">校驗碼初始值</param>
    /// <returns></returns>
    public static bool CheckCRC16(byte[] value, ushort poly = 0xA001, ushort crcInit = 0xFFFF)
    {
        if (value == null || !value.Any())
            throw new ArgumentException("生成CRC16的入參有誤");

        var crc16 = GetCRC16(value, poly, crcInit);
        if (crc16[crc16.Length - 2] == crc16[crc16.Length - 1] && crc16[crc16.Length - 1] == 0)
            return true;
        return false;
    }

    /// <summary>
    /// 計算CRC16校驗碼
    /// </summary>
    /// <param name="value">校驗數據</param>
    /// <param name="poly">多項式碼</param>
    /// <param name="crcInit">校驗碼初始值</param>
    /// <returns></returns>
    public static byte[] GetCRC16(byte[] value, ushort poly = 0xA001, ushort crcInit = 0xFFFF)
    {
        if (value == null || !value.Any())
            throw new ArgumentException("生成CRC16的入參有誤");

        //運算
        ushort crc = crcInit;
        for (int i = 0; i < value.Length; i++)
        {
            crc = (ushort)(crc ^ (value[i]));
            for (int j = 0; j < 8; j++)
            {
                crc = (crc & 1) != 0 ? (ushort)((crc >> 1) ^ poly) : (ushort)(crc >> 1);
            }
        }
        byte hi = (byte)((crc & 0xFF00) >> 8);  //高位置
        byte lo = (byte)(crc & 0x00FF);         //低位置

        byte[] buffer = new byte[value.Length + 2];
        value.CopyTo(buffer, 0);
        buffer[buffer.Length - 1] = hi;
        buffer[buffer.Length - 2] = lo;
        return buffer;
    }
}

協議報文分析

數據【讀取-請求報文】：01 03 00 04 00 01 C5 CB

01 站號
03 功能碼
00 04 讀取的寄存器的起始地址
00 01 讀取寄存器的個數
C5 CB 爲CRC16的校驗碼【使用上面的CRC16類進行的計算結果，CRC16.GetCRC16([01,03,00,04,00,01])】

數據【讀取-響應報文】：01 03 02 00 21 78 5C

01 站號
03 功能碼
02 數據的字節長度
00 21 數據
78 5C 爲CRC16的校驗碼

數據【寫入-請求報文】：01 10 00 04 00 01 02 00 21 67 CC

01 站號
10 功能碼
00 04 寫入的寄存器的起始地址
00 01 寫入寄存器的個數
02 寫字節的個數
00 21 要寫的數據
67 CC 爲CRC16的校驗碼

數據【寫入-響應報文】：01 10 00 04 00 01 40 08

01 站號
10 功能碼
00 04 寫入的寄存器的起始地址
00 01 寫入寄存器的個數
40 08 爲CRC16的校驗碼

有了報文的分析，具體的協議實現也就不難了。完整實現可參考https://github.com/zhaopeiym/IoTClient/blob/master/IoTClient/Clients/ModBus/ModBusRtuClient.cs

IoTClient中ModBusRtu協議的使用

安裝

Nuget安裝 Install-Package IoTClient
或圖形化安裝

使用

//一、實例化客戶端 - [COM端口名稱,波特率,數據位,中止位,奇偶校驗]
ModBusRtuClient client = new ModBusRtuClient("COM3", 9600, 8, StopBits.One, Parity.None);

//二、寫操做 - 參數依次是：地址 、值 、站號 、功能碼
client.Write("4", (short)33, 2, 16);
client.Write("4", (short)3344, 2, 16);

//三、讀操做 - 參數依次是：地址 、站號 、功能碼
var value = client.ReadInt16("4", 2, 3).Value;
var value2 = client.ReadInt32("4", 2, 3).Value;

//四、若是沒有主動Open，則會每次讀寫操做的時候自動打開自動和關閉鏈接，這樣會使讀寫效率大大減低。因此建議手動Open和Close。
client.Open();

//五、讀寫操做都會返回操做結果對象Result
var result = client.ReadInt16("4", 2, 3);
//5.1 讀取是否成功（true或false）
var isSucceed = result.IsSucceed;
//5.2 讀取失敗的異常信息
var errMsg = result.Err;
//5.3 讀取操做實際發送的請求報文
var requst  = result.Requst;
//5.4 讀取操做服務端響應的報文
var response = result.Response;
//5.5 讀取到的值
var value3 = result.Value;