ModbusMaster規(guī)格說明書

1、修改版本：V1.9ModbusMaster產(chǎn)品規(guī)格說明書一、 產(chǎn)品功能簡介a) 支持協(xié)議說明通用協(xié)議：ModbusRtu，ModbusASCII，ModbusTCPb) 支持的硬件型號說明：所有支持上述協(xié)議的設(shè)備。c) 支持的連接說明及發(fā)送方式支持串口連接和TCP連接。如果是串口連接，支持按Rtu和ASCII發(fā)送；如果是TCP連接，支持以socket發(fā)送。二、 驅(qū)動接口：3.0開發(fā)包三、 設(shè)備添加方式a) 在組態(tài)王中定義設(shè)備時請選擇：通用版下：PLC > 莫迪康 > ModbusRTU > COMPLC > 莫迪康 > ModbusRTU(unpack) >

2、 COMPLC > 莫迪康 > ModbusASCII > COMPLC > 莫迪康 > ModbusTCP > TCP其他的設(shè)備，設(shè)備名中必須包含有ModbusRTU，或ModbusASCII，或ModbusTCP字樣。區(qū)分大小寫。否則無法使用該驅(qū)動。由于驅(qū)動是通過des文件里面的這些關(guān)鍵字進(jìn)行匹配的。英文版下：PLC > Modicon > ModbusRTU > COMPLC > Modicon > ModbusRTU(unpack) > COMPLC > Modicon > ModbusASCII &g

3、t; COMPLC > Modicon > ModbusTCP > TCP注：串口統(tǒng)一為“COM”，以太網(wǎng)統(tǒng)一為“TCP”b) 設(shè)備向?qū)ы撨x項的特殊說明：如果是串口設(shè)備：是否選串口是是否有地址選擇頁是 通訊方式RS232/RS485/RS422/描述COM如果是以太網(wǎng)設(shè)備：是否選串口是是否有地址選擇頁是 通訊方式串口描述TCP網(wǎng)絡(luò)設(shè)備需要選擇串口的原因是：一個設(shè)備接口(如Com1、網(wǎng)卡)開啟一個線程。c) 對于串口設(shè)備通訊參數(shù)的推薦設(shè)置如下無，視具體設(shè)備而定四、 本設(shè)備的地址格式及地址X圍串口連接方式（Rtu）：Address:Delay:BeforeDelay |SwapF

4、|SwapL|SwapCAddress 1-255設(shè)備地址Delay 0-60000 發(fā)送每條命令幀后的延遲時間（毫秒）BeforeDelay 0-60000 發(fā)送每條命令幀前的延遲時間（毫秒）SwapF 0-3 浮點數(shù)的字節(jié)順序，默認(rèn)為0SwapL 0-3 長征性的字節(jié)順序，默認(rèn)為0SwapC 0-1 CRC校驗的字節(jié)順序，默認(rèn)為0如：1:50:50|0|0|0串口連接方式（ASCII）：同RTUTCP連接方式：IP:Port Address|SwapF|SwapL|SwapCIP設(shè)備IP地址或域名Port設(shè)備IP地址端口，默認(rèn)為502Address1-255設(shè)備地址 SwapF 0-3 浮

5、點數(shù)的字節(jié)順序，默認(rèn)為0(廠家溝通) SwapL 0-3 長征性的字節(jié)順序，默認(rèn)為0SwapC 0-1 CRC校驗的字節(jié)順序，默認(rèn)為0如：192.168.0.100 1|0|0|0注：如果在設(shè)備定義中對Swap系列功能設(shè)定，需要同時設(shè)定3個Swap順序，且SwapF、SwapL、SwapC次序不得有誤。五、 寄存器列說明寄存器X圍數(shù)據(jù)類型讀寫說明01 65535Bit讀寫邏輯線圈，I/O離散 （0XXXX）11 65535Bit讀輸入位寄存器（1XXXX）3dd3dd.xx3m.ndd: 1 65535xx: 0-1m:165535n:0127并且m+n<=65535Byte/Ushor

6、t/short/BCD/float/Long/LongBCD/String讀輸入寄存器（3XXXX）4dd4dd.xx4m.ndd: 1 65535xx: 0-1m:165535n:0127并且m+n<=65535ByteUshort/short/BCD/float/Long/LongBCD/String讀讀寫保持寄存器（4XXXX）SwapF0Byte寫浮點型字節(jié)順序SwapL0Byte寫長整型字節(jié)順序SwapC0Byte寫CRC校驗字節(jié)次序FMC165535String寫強(qiáng)制多線圈狀態(tài)說明：1. 該寄存器最多強(qiáng)制16個連續(xù)的線圈狀態(tài)；2. 通道號為線圈的起始地址；3. 只能寫入0或1

7、組合的字符串如：FMC1寫入111表示線圈1-3置位00000表示線圈1-5復(fù)位111111111表示線圈1-9置位下表2是Modbus功能碼與本驅(qū)動支持的寄存器間的關(guān)系：功能碼 名稱 作用 相關(guān)寄存器01 讀取線圈狀態(tài) 取得一組邏輯線圈的當(dāng)前狀態(tài)（ON/OFF)002 讀取輸入狀態(tài) 取得一組開關(guān)輸入的當(dāng)前狀態(tài)（ON/OFF) 103 讀取保持寄存器 在一個或多個保持寄存器中取得當(dāng)前的二進(jìn)制值404 讀取輸入寄存器 在一個或多個輸入寄存器中取得當(dāng)前的二進(jìn)制值305 強(qiáng)置單線圈 強(qiáng)置一個邏輯線圈的通斷狀態(tài) 006 預(yù)置單寄存器 把具體二進(jìn)值裝入一個保持寄存器 415 強(qiáng)置多線圈 強(qiáng)置一串連續(xù)邏輯

8、線圈的通斷 FMC說明： 1) SWAPF寄存器用于改變浮點數(shù)的字節(jié)順序，SWAPL寄存器用語改變long型數(shù)據(jù)的字節(jié)順序，只有0， 1， 2， 3四種取值。例如在通訊時從0001地址讀取的四個十六進(jìn)制值為 HV1,HV2, HV3, HV4則：當(dāng)SWAP = 0時，轉(zhuǎn)換后浮點數(shù)對應(yīng)的內(nèi)存值為： HV4 HV3 HV2 HV1。當(dāng)SWAP = 1時，轉(zhuǎn)換后浮點數(shù)對應(yīng)的內(nèi)存值為： HV3 HV4 HV1 HV2。當(dāng)SWAP = 2時，轉(zhuǎn)換后浮點數(shù)對應(yīng)的內(nèi)存值為： HV1 HV2 HV3 HV4。當(dāng)SWAP = 3時，轉(zhuǎn)換后浮點數(shù)對應(yīng)的內(nèi)存值為： HV2 HV1 HV4 HV3。2) 對于只寫寄存

9、器，請將采集頻率設(shè)置為0。3) 3，4寄存器，如果客戶需要讀取Byte數(shù)據(jù)類型，需要定義二級通道。分別表示字的高字節(jié)和低字節(jié)。例：31.0表示地址為0的數(shù)據(jù)的低字節(jié)，31.1表示地址為0的數(shù)據(jù)的高字節(jié)。Byte數(shù)據(jù)類型只可以讀，不可以寫。如果需要寫，請定義Short或Ushort數(shù)據(jù)類型。4) 寄存器4讀功能碼為03，寫單字(Short，Ushort，BCD)的功能碼為06，寫雙字(Long，F(xiàn)loat，LongBCD)的功能碼為0x10。5) 驅(qū)動的變量后的寄存器通道號(寄存器X圍)，是按照以1為起始地址的。對于以0為起始地址的設(shè)備，定義變量應(yīng)該加1。例如，如果某設(shè)備的一個變量在數(shù)據(jù)4區(qū)，為

10、40100，如果地址是從1開始，對應(yīng)變量定義為40100；如果地址是從0開始，定義為40101。6) 3,4寄存器的String類型說明：a) 二級通道表示 x.y X表示讀/寫字符串的起始地址；y表示字符串的長度。長度說明：字符串長度為N，但在內(nèi)存中還有一位結(jié)束符，由于Modbus Holding Register只能以雙字節(jié)為單位寫，所以實際發(fā)幀的時候共發(fā)N+1個字節(jié)或N+2個字節(jié)。即若寫入N長度的字符串，實際在PLC中寫入N+1或N+2個字節(jié)。Y = 0 時：驅(qū)動代碼中賦一個空串給組態(tài)王，但組態(tài)王顯示為“0”。Y=1 時： 讀取的字符串為地址X的當(dāng)前ASCII字符。Y=N（N>1）

11、時：讀取長度為N的字符串，從地址X開始。b) 組態(tài)王支持可輸入的ASCII碼。c) #號只能讀不能寫入。d) 長度問題：字符串長度為N，但在內(nèi)存中還有一位結(jié)束符，實際共占N+1位。即若寫入N長度的字符串，實際在內(nèi)存中寫入N+1位e）當(dāng)寫入字符串的長度小于y時，其他內(nèi)存全部填充'0'。y為奇數(shù)時,實際在內(nèi)存中寫入y+1位。7) SWAPC寄存器用于調(diào)整CRC校驗字節(jié)次序.例如在通訊時從1#Modbus 從設(shè)備40001地址讀取的數(shù)據(jù)為 01 03 02 00 06 3846當(dāng)SWAPC = 0時，將按 LOBYTE = 38，HIBYTE = 46 正常方式進(jìn)行CRC校驗當(dāng)SWA

12、PC = 1時，將按 LOBYTE = 46，HIBYTE = 38 反向方式進(jìn)行CRC校驗六、 打包規(guī)格描述：1) 相同的寄存器，數(shù)據(jù)長度相同，不超過最大打包長度時，可以打一個包。2) Byte，Ushort，short，bcd長度相同；long，float，longbcd長度相同。3) 配置文件中能夠配置打包長度和打包段。七、 接收緩沖區(qū)的大?。海ǔ绦騿T需要提供此參數(shù)，此說明只用于測試工程師測試，用戶文檔中不列此項。）1024個字節(jié)八、 配置文件格式以及打包規(guī)則說明(1) 配置文件格式配置文件名稱為ModbusMaster，是一個文本格式文件，文件后綴名為.ini，其格式以及相關(guān)說明如下：

13、設(shè)備名稱1 /設(shè)備名稱，與Devlst中的設(shè)備名稱一致PackLen =125 / 最大打包長度，0為不打包SupReg = 0,1,3,4 / 支持的寄存器，如果支持就添加到括號中Timeout = 15000 / 使用GPRS或者M(jìn)odem時的通訊超時，默認(rèn)15000毫秒Num = 4 / 后續(xù)的打包規(guī)則個數(shù)1 = 01，010，F(xiàn)ixed / 打包規(guī)則1，0寄存器的180點數(shù)據(jù)可以打/在一個包里（協(xié)議層），F(xiàn)ixed為可選項，當(dāng)協(xié)議里規(guī)/定，該數(shù)據(jù)段的數(shù)據(jù)必須在一個數(shù)據(jù)幀里請求，則定義該標(biāo)記；/驅(qū)動在請求該數(shù)據(jù)段中的任何數(shù)據(jù)時，都會組幀請求1到10的/固定幀。2 = 1200，1250

14、/1寄存器的15932000點數(shù)據(jù)可以打在一個包里3 = 31，310 ，320，330 /3寄存器的110點數(shù)據(jù)可以打在一個包里（協(xié)議層），20 30/點數(shù)據(jù)可以打在一個包里（協(xié)議層）。4 = 41，410，420，430，F(xiàn)ixed /4寄存器的110點數(shù)據(jù)可以打在一個包里（協(xié)議層），/由于定義了Fixed標(biāo)記，驅(qū)動在請求該數(shù)據(jù)段中的任何/數(shù)據(jù)時，都會組幀請求1到10的固定幀；同樣，對于 /20 30點數(shù)據(jù)可以打在一個包里，由于Fixed標(biāo)記的存/在，請求20 30數(shù)據(jù)段之間的任何數(shù)據(jù)時，都會組幀請/求20 到30的固定幀。設(shè)備名稱2添加對當(dāng)?shù)谝粠瑢懨钍∈?，從配置文件讀取指定的嘗試連接

15、幀的處理TryConnectnTryStartAddress = 1 /注意起始地址是1nTryEndAddress = 1 /結(jié)束地址應(yīng)該大于等于起始地址nTryRegType = 3 /寄存器的類型（寄存器的順序取值0,1,2,3分別對應(yīng)寄存器0,1,3,4）nTryDataType = 2 /數(shù)據(jù)類型，可以按默認(rèn)處理/ 解釋nTryDataType可以選取如下值，數(shù)字代表所對應(yīng)的數(shù)據(jù)類型BIT_DATATYPE1BYTE_DATATYPE2INT_DATATYPE4UINT_DATATYPE8BCD_DATATYPE16LONG_DATATYPE32LONGBCD_DATATYPE64F

16、LOAT_DATATYPE128STRING_DATATYPE256(2) 打包規(guī)則說明配置文件是一個信息文件格式，其中定義了設(shè)備名稱以及打包規(guī)則。需要說明的是，這里定義的打包規(guī)則是基于協(xié)議的。比如協(xié)議里規(guī)定，4寄存器的110是一個數(shù)據(jù)段，可以在一個包里請求，那么就在配置文件里定義41，410如果客戶在組態(tài)王中定義了變量的情況如下：42，45，46，47，48，49則會依據(jù)下面的步驟進(jìn)行判斷，1) 從配置文件里，載入配置信息，獲得協(xié)議層的打包規(guī)則；2) 42，45，46，47，48，49這些變量在一個包里可以讀出。3) 如果相應(yīng)的規(guī)則后沒有fixed，那么組包為42-49。4) 如果相應(yīng)的規(guī)則

17、后有fixed，那么組包為41-410。5) 如果變量不在規(guī)則指定的X圍內(nèi)，則每個變量單獨一個包。 (3) 配置文件使用說明目前配置文件ModbusRTU段后的信息為標(biāo)準(zhǔn)的modbus協(xié)議的打包規(guī)則。ModbusRTU(unpack)段后的信息為不打包的打包規(guī)則。如果需要修改相應(yīng)的規(guī)則，則按照文件的格式要求進(jìn)行修改。(4) 其他說明1) ModbusMaster.ini文件保存在組態(tài)王驅(qū)動安裝文件夾下，默認(rèn)安裝在: C:Program FilesKingviewdriver。2) PackLen單位為字(WORD)。由于ModbusRTU應(yīng)答的數(shù)據(jù)最多255字節(jié)(127個WORD)，PackL

18、en最大設(shè)置為127。3) 每個寄存器需單獨列出打包規(guī)則。若有多個打包段，按順序?qū)憽Ｗ疃嘀С?2個打包段。4) 0和1寄存器是以字節(jié)(BYTE)為單位，其他寄存器是以字(WORD)為單位。例如：1 = 10003,10004 表示寄存器變量10017-10032可以打一個包2 = 40008,40012 表示寄存器變量40008-40012可以打在一個包5) 如果用戶沒有使用配置文件，則默認(rèn)打包規(guī)則見“六 打包規(guī)則描述”；如果用戶定義了配置文件，則默認(rèn)打包規(guī)則無效，用戶定義的打包段外的寄存器不打包。例：用戶定義配置文件：3 = 310，320，最大打包長度127定義寄存器35，310，320，

19、321，322，則35一個包，310-320一個包，321一個包，322一個包。6) Modbus TCP/IP 的一幀比通用的Modbus的一幀在幀前多加了6個字節(jié)，而且在幀尾除去了CRC或LRC校驗。九、 重點測試部分說明（需要測試工程師重點測試部分的說明）十、 程序員測試特殊說明（程序員在調(diào)試程序中發(fā)現(xiàn)的一些特殊需要說明的問題，例如某個寄存器寫X圍超過多大的數(shù)據(jù)就有問題了）十一、 是否需要雙機(jī)熱備測試？十二、 驅(qū)動運行需要涉及的其他軟件的支持（備注：驅(qū)動運行需要安裝的軟件或需要調(diào)用的庫文件或數(shù)據(jù)庫文件的說明）十三、 其他軟硬件環(huán)境支持的簡要操作說明和注意事項（備注：1,和通訊相關(guān)的硬件參數(shù)的設(shè)置，例如