ModbusMaster規(guī)格說(shuō)明書(shū)

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

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

3、口統(tǒng)一為“ COM”，以太網(wǎng)統(tǒng)一為“ TCP” b）設(shè)備向?qū)ы?yè)選項(xiàng)的特殊說(shuō)明：如果是串口設(shè)備：是否選用口是是否后地址選擇頁(yè)是通訊方式RS232/RS485/RS422/描述COM如果是以太網(wǎng)設(shè)備:是否選用口是是否后地址選擇頁(yè)是通訊方式串口描述TCP網(wǎng)絡(luò)設(shè)備需要選擇串口的原因是：一個(gè)設(shè)備接口（如Com1、網(wǎng)卡）開(kāi)啟一個(gè)線程c）對(duì)于串口設(shè)備通訊參數(shù)的推薦設(shè)置如下無(wú)，視具體設(shè)備而定四、本設(shè)備的地址格式及地址范圍串口連接方式（Rtu）:Address :Delay : BeforeDelay |SwapF|SwapL|SwapCAddress1255設(shè)備地址Delay060000 發(fā)送每條命令幀后的延

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

5、RC校驗(yàn)的字節(jié)順序，默認(rèn)為0如：192。168。0。100 1|0|0|0注：如果在設(shè)備定義中對(duì) Swap系列功能設(shè)定，需要同時(shí)設(shè)定 3個(gè)Swap順序, 且SwapF、SwapL、SwapC次序不得有誤。五、寄存器列說(shuō)明寄存器范圍數(shù)據(jù)類型讀寫(xiě)說(shuō)明01 65535Bit讀寫(xiě)邏輯線圈,I/O離散（0XXXX ）1165535Bit讀輸入位寄存器（1XXXX）3dd3dd.xx3m.ndd: 1 65535xx: 0-1m : 1 65535n:0 127 并且m+n=65535Byte/Ushort/sho rt/BCD/float/Lo ng/LongBCD/St ring讀輸入葉器（3XXXX

6、 ）4dd4dd.xx4m。ndd: 1 65535xx: 0-1m:165535n： 0127 并且m+n<=65535Byte Ushort/short/B CD/float/Long/ LongBCD/Strin g讀讀寫(xiě)保持加器（4XXXX ）SwapF0Byte寫(xiě)浮點(diǎn)型字節(jié)順序SwapL0Byte寫(xiě)長(zhǎng)整型字節(jié)順序SwapC0Byte寫(xiě)CRC校驗(yàn)字節(jié)次序FMC1-65535String強(qiáng)制多線圈狀態(tài)說(shuō)明：1 .該寄存器最多強(qiáng)制16個(gè)連續(xù)的 線圈X犬態(tài);2 .通道號(hào)為線圈的起始地址；3 .只能寫(xiě)入'0'或只組合的字符串如：FMC1寫(xiě)入111表示線圈1-3置位0000

7、0表示線圈1-5復(fù)位11111111俵示線圈1-9置位下表2是Modbus功能碼與本驅(qū)動(dòng)支持的寄存器間的關(guān)系:功能碼名稱作用相關(guān)寄存器01讀取線圈狀態(tài)取得一組邏輯線圈的當(dāng)前狀態(tài)(ON/OFF)002讀取輸入狀態(tài)取得一組開(kāi)關(guān)輸入的當(dāng)前狀態(tài)(ON/OFF)103讀取保持寄存器在一個(gè)或多個(gè)保持寄存器中取得當(dāng)前的二進(jìn)制 值404讀取輸入寄存器在一個(gè)或多個(gè)輸入寄存器中取得當(dāng)前的二進(jìn)制 值305強(qiáng)置單線圈強(qiáng)十個(gè)邏輯線圈的通斷狀態(tài)006預(yù)置單寄存器把具體二進(jìn)值裝入一個(gè)保持寄存器415強(qiáng)置多線圈強(qiáng)置一串連續(xù)邏輯線圈的通斷FMC說(shuō)明：1) SWAPF寄存器用于改變浮點(diǎn)數(shù)的字節(jié)順序，SWAPL寄存器用語(yǔ)改變10n

8、g型數(shù)據(jù) 的字節(jié)順序，只有0, 1, 2, 3四種取值。例如在通訊時(shí)從0001地址讀取的四個(gè)十六進(jìn)制值為HV1 , HV2, HV3, HV4則：當(dāng)SWAP = 0時(shí)，轉(zhuǎn)換后浮點(diǎn)數(shù)對(duì)應(yīng)的內(nèi)存值為：HV4 HV3 HV2 HV1.當(dāng)SWAP = 1時(shí)，轉(zhuǎn)換后浮點(diǎn)數(shù)對(duì)應(yīng)的內(nèi)存值為：HV3 HV4 HV1 HV2.當(dāng)SWAP = 2時(shí)，轉(zhuǎn)換后浮點(diǎn)數(shù)對(duì)應(yīng)的內(nèi)存值為：HV1 HV2 HV3 HV4 。當(dāng)SWAP = 3時(shí)，轉(zhuǎn)換后浮點(diǎn)數(shù)對(duì)應(yīng)的內(nèi)存值為：HV2 HV1 HV4 HV3 。2）對(duì)于只寫(xiě)寄存器，請(qǐng)將采集頻率設(shè)置為003） 3,4寄存器，如果客戶需要讀取Byte數(shù)據(jù)類型，需要定義二級(jí)通道。分別表示

9、字的 高字節(jié)和低字節(jié)。例：31。0表示地址為0的數(shù)據(jù)的低字節(jié)，31.1表示地址為0 的數(shù)據(jù)的高字節(jié)。Byte數(shù)據(jù)類型只可以讀，不可以寫(xiě).如果需要寫(xiě)，請(qǐng)定義Short 或Ushort數(shù)據(jù)類型。4）寄存器4讀功能碼為03,寫(xiě)單字（Short, Ushort, BCD）的功能碼為06寫(xiě)雙字（Long, Float, LongBCD）的功能碼為 0x10。5）驅(qū)動(dòng)的變量后的寄存器通道號(hào)（寄存器范圍），是按照以1為起始地址的。對(duì)于以0 為起始地址的設(shè)備，定義變量應(yīng)該加1。例如，如果某設(shè)備的一個(gè)變量在數(shù)據(jù) 4區(qū)，為40100,如果地址是從1開(kāi)始，對(duì)應(yīng)變量定義為40100;如果地址是從0開(kāi) 始，定義為401

10、01.6） 3, 4寄存器的String類型說(shuō)明：a） 二級(jí)通道表示 x.yX表示讀/寫(xiě)字符串的起始地址；y表示字符串的長(zhǎng)度。長(zhǎng)度說(shuō)明：字符串長(zhǎng)度為N,但行內(nèi)存中還有一位結(jié)束符，由于 Modbus Holding Register只能以雙字節(jié)為單位寫(xiě)，所以實(shí)際發(fā)幀的時(shí)候共發(fā)N+1個(gè)字節(jié)或N+2個(gè) 字節(jié)。即若寫(xiě)入N長(zhǎng)度的字符串，實(shí)際在 PLC中寫(xiě)入N+1或N+2個(gè)字節(jié)。Y = 0 時(shí)：驅(qū)動(dòng)代碼中賦一個(gè)空用給組態(tài)王，但組態(tài)王顯示為“0”。Y=1 時(shí)：讀取的字符串為地址X的當(dāng)前ASCII字符。Y=N （N1）時(shí)：讀取長(zhǎng)度為N的字符串，從地址X開(kāi)始.b）組態(tài)王支持可輸入的ASCII碼。c）#號(hào)只能讀不

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

12、RC校驗(yàn)六、打包規(guī)格描述：1）相同的寄存器，數(shù)據(jù)長(zhǎng)度相同，不超過(guò)最大打包長(zhǎng)度時(shí)，可以打一個(gè)包。2） Byte, Ushort, short, bcd長(zhǎng)度相同;long, float, longbcd長(zhǎng)度相同。3）配置文件中能夠配置打包長(zhǎng)度和打包段。七、接收緩沖區(qū)的大小：（程序員需要提供此參數(shù)，此說(shuō)明只用于測(cè)試工程師測(cè)試，用戶文檔中不列此項(xiàng)。）1024個(gè)字節(jié)K、配置文件格式以及打包規(guī)則說(shuō)明（1）配置文件格式配置文件名稱為ModbusMaster是一個(gè)文本格式文件，文件后綴名為.ini,其格式以及相關(guān)說(shuō)明如下:設(shè)備名稱1/設(shè)備名稱，與Devlst中的設(shè)備名稱一致PackLen =125/最大打包長(zhǎng)

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

14、10點(diǎn)數(shù)據(jù)可以打在一個(gè)包里（協(xié)議層），2030/點(diǎn)數(shù)據(jù)可以打在一個(gè)包里（協(xié)議層）4 = 41, 410, 420, 430,Fixed /4寄存器的110點(diǎn)數(shù)據(jù)可以打在一個(gè)包里（協(xié)議層）， /由于定義了 Fixed標(biāo)記，驅(qū)動(dòng)在請(qǐng)求該數(shù)據(jù)段中的任何/數(shù)據(jù)時(shí)，都會(huì)組幀請(qǐng)求1到10的固定幀；同樣，對(duì)于 /20 30點(diǎn)數(shù)據(jù)可以打在一個(gè)包里，由于 Fixed標(biāo)記的存 /在，請(qǐng)求20 30數(shù)據(jù)段之間的任何數(shù)據(jù)時(shí)，都會(huì)組幀請(qǐng) /求20到30的固定幀.設(shè)備名稱2:添加對(duì)當(dāng)?shù)谝粠瑢?xiě)命令失敗是，從配置文件讀取指定的嘗試連接幀的處理TryConnectnTryStartAddress = 1 /注意起始地址是1nT

15、ryEndAddress = 1 /結(jié)束地址應(yīng)該大于等于起始地址nTryRegType = 3/寄存器的類型（寄存器的順序取值0,1, 2,3分別對(duì)應(yīng)寄存器0, 1,3,4）nTryDataType = 2/數(shù)據(jù)類型，可以按默認(rèn)處理 / 解釋nTryDataType可以選取如下值，數(shù)字代表所對(duì)應(yīng)的數(shù)據(jù)類型BIT_DATATYPE 1BYTE_DATATYPE 2INT_DATATYPE 4UINT_DATATYPE 8BCD_DATATYPE 16LONG_DATATYPE 32LONGBCD_DATATYP4 FLOAT_DATATYPE 128STRING_DATATYPE256(2)打包

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

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

18、，按順序?qū)?。最多支?32個(gè)打包 段。4）0和1寄存器是以字節(jié)（BYTE）為單位，其他寄存器是以字（WORD）為單位。例如：1 = 10003,10004表示寄存器變量1001710032可以打一個(gè)包2 = 40008, 40012表示寄存器變量4000840012可以打在一個(gè)包5）如果用戶沒(méi)有使用配置文件，則默認(rèn)打包規(guī)則見(jiàn)“六打包規(guī)則描述"；如果用戶定義 了配置文件，則默認(rèn)打包規(guī)則無(wú)效，用戶定義的打包段外的寄存器不打包。例：用戶定義配置文件：3 = 310, 320,最大打包長(zhǎng)度127定義寄存器 35, 310, 320,321, 322,則 35一個(gè)包,310-320 一個(gè)包，3

19、21 一個(gè)包, 322 一個(gè)包.6） Modbus TCP/IP的一幀比通用的Modbus的一幀在幀前多加了 6個(gè)字節(jié)，而且在幀 尾除去了 CRC或LRC校驗(yàn)。九、重點(diǎn)測(cè)試部分說(shuō)明（需要測(cè)試工程師重點(diǎn)測(cè)試部分的說(shuō)明）十、程序員測(cè)試特殊說(shuō)明（程序員在調(diào)試程序中發(fā)現(xiàn)的一些特殊需要說(shuō)明的問(wèn)題，例如某個(gè)寄存器寫(xiě)范圍超過(guò)多大的數(shù)據(jù)就有問(wèn)題了）十一、是否需要雙機(jī)熱備測(cè)試？十二、驅(qū)動(dòng)運(yùn)行需要涉及的其他軟件的支持（備注：驅(qū)動(dòng)運(yùn)行需要安裝的軟件或需要調(diào)用的庫(kù)文件或數(shù)據(jù)庫(kù)文件的說(shuō)明）十三、其他軟硬件環(huán)境支持的簡(jiǎn)要操作說(shuō)明和注意事項(xiàng)（備注：1,和通訊相關(guān)的硬件參數(shù)的設(shè)置，例如儀表需要設(shè)備某個(gè)參數(shù)才能和組態(tài)王通訊2,設(shè)備軟件上影響通訊的參數(shù)的設(shè)置方法，例如對(duì)于plc設(shè)備，需要用軟件對(duì)設(shè)備進(jìn)行特殊的參數(shù)設(shè)置后，設(shè)備才能和組態(tài)王通訊，結(jié)合圖片說(shuō)明 ）十四、具體接線圖的說(shuō)明（有特殊連線要求的填寫(xiě)）十五、對(duì)于性能事項(xiàng)的特別說(shuō)明十六、參考資料的說(shuō)明附錄:3.0接口程序編程規(guī)范關(guān)于程序的規(guī)范，會(huì)影響到測(cè)試環(huán)節(jié)的部分a）寄存器和通道號(hào)