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

1、修改版本： V1.9ModbusMaster產(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發(fā)送。二、驅(qū)動(dòng)接口：3.0 開(kāi)發(fā)包三、設(shè)備添加方式a) 在組態(tài)王中定義設(shè)備時(shí)請(qǐng)選擇：通用版下：PLC 莫迪康 ModbusRTU COMPLC 莫迪康 ModbusRTU(unpack) COMPLC 莫迪康 ModbusASCII

2、COMPLC 莫迪康 ModbusTCP TCP其他的設(shè)備，設(shè)備名中必須包含有ModbusRTU，或 ModbusASCII ，或 ModbusTCP字樣。區(qū)分大小寫。否則無(wú)法使用該驅(qū)動(dòng)。由于驅(qū)動(dòng)是通過(guò)des 文件里面的這些關(guān)鍵字進(jìn)行匹配的。英文版下：PLC Modicon ModbusRTU COMPLC Modicon ModbusRTU(unpack) COMPLC Modicon ModbusASCII COMPLC Modicon ModbusTCP TCP錯(cuò)誤 ! 未找到引用源。北京亞控版權(quán)所有第 1頁(yè)共10頁(yè)2020-4-1821:41修改版本： V1.9注：串口統(tǒng)一為“ COM

3、 ”，以太網(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|SwapCAddress1-255設(shè)備地址Delay0-60000發(fā)送每條命令幀后的延遲時(shí)間

4、（毫秒）BeforeDelay0-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 地址或域名錯(cuò)誤 ! 未找到引用源。北京亞控版權(quán)所有第 2頁(yè)共10頁(yè)2020-4-1821:41修改版本： V1.9Port設(shè)備 IP 地址端口，默認(rèn)為 502Address 1-255設(shè)備地址SwapF 0

5、-3浮點(diǎn)數(shù)的字節(jié)順序，默認(rèn)為0(廠家溝通 )SwapL 0-3長(zhǎng)征性的字節(jié)順序，默認(rèn)為0SwapC 0-1CRC 校驗(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ù)類型01 65535Bit11 65535Bit3dddd:1Byte/Ushort/sho3dd.xx65535rt/BCD/float/Loxx: 0-1ng/LongBCD/St3m.nm:16553ring5n:0 127并且m+n=65

6、5354dddd:1Byte4dd.xx65535Ushort/short/Bxx: 0-1CD/float/Long/4m.nm:16553LongBCD/Strin5gn:0 127并且m+n1）時(shí)：讀取長(zhǎng)度為 N 的字符串，從地址X 開(kāi)始。b) 組態(tài)王支持可輸入的 ASCII 碼。c) #號(hào)只能讀不能寫入。d) 長(zhǎng)度問(wèn)題：字符串長(zhǎng)度為N，但在內(nèi)存中還有一位結(jié)束符，實(shí)際共占N+1 位。即若寫入 N 長(zhǎng)度的字符串，實(shí)際在內(nèi)存中寫入N+1 位e）當(dāng)寫入字符串的長(zhǎng)度小于y 時(shí)，其他內(nèi)存全部填充0。y 為奇數(shù)時(shí) ,實(shí)際在內(nèi)存中寫入 y+1 位。7) SWAPC 寄存器用于調(diào)整 CRC 校驗(yàn)字節(jié)次序

7、 .例如在通訊時(shí)從 1#Modbus 從設(shè)備 40001地址讀取的數(shù)據(jù)為 01 03 02 00 06 38 46 當(dāng) SWAPC = 0時(shí)，將按 LOBYTE = 38 ，HIBYTE = 46 正常方式進(jìn)行 CRC 校驗(yàn)錯(cuò)誤 ! 未找到引用源。北京亞控版權(quán)所有第 5頁(yè)共10頁(yè)2020-4-1821:41修改版本： V1.9當(dāng) SWAPC = 1時(shí)，將按 LOBYTE = 46 ，HIBYTE = 38 反向方式進(jìn)行 CRC 校驗(yàn)六、打包規(guī)格描述：1) 相同的寄存器，數(shù)據(jù)長(zhǎng)度相同，不超過(guò)最大打包長(zhǎng)度時(shí)，可以打一個(gè)包。2) Byte，Ushort，short，bcd 長(zhǎng)度相同； long， f

8、loat，longbcd 長(zhǎng)度相同。3) 配置文件中能夠配置打包長(zhǎng)度和打包段。七、接收緩沖區(qū)的大?。海ǔ绦騿T需要提供此參數(shù)，此說(shuō)明只用于測(cè)試工程師測(cè)試，用戶文檔中不列此項(xiàng)。）1024 個(gè)字節(jié)八、配置文件格式以及打包規(guī)則說(shuō)明(1) 配置文件格式配置文件名稱為 ModbusMaster，是一個(gè)文本格式文件，文件后綴名為.ini ，其格式以及相關(guān)說(shuō)明如下： 設(shè)備名稱 1/設(shè)備名稱，與 Devlst 中的設(shè)備名稱一致PackLen =125/ 最大打包長(zhǎng)度， 0 為不打包SupReg = 0,1,3,4/ 支持的寄存器，如果支持就添加到括號(hào)中Timeout = 15000/ 使用 GPRS 或者 Mo

9、dem 時(shí)的通訊超時(shí)，默認(rèn)15000 毫秒Num = 4/ 后續(xù)的打包規(guī)則個(gè)數(shù)1 = 01，010，F(xiàn)ixed/ 打包規(guī)則 1，0 寄存器的 180 點(diǎn)數(shù)據(jù)可以打/在一個(gè)包里（協(xié)議層）， Fixed 為可選項(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，1250/1 寄存器的 15932000 點(diǎn)數(shù)據(jù)可以打在一個(gè)包里3 = 31，310 ，320，330/3 寄存器的 110 點(diǎn)數(shù)據(jù)可以打在一個(gè)包里 （協(xié)議層），20 30/點(diǎn)數(shù)據(jù)可以打在一個(gè)包里（協(xié)議層） 。4 = 41，41

10、0，420，430，F(xiàn)ixed/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ì)于錯(cuò)誤 ! 未找到引用源。北京亞控版權(quán)所有第 6頁(yè)共10頁(yè)2020-4-1821:41修改版本： V1.9/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ù)谝粠瑢懨钍∈牵瑥呐渲梦募x取指定的嘗試連接幀的處理TryConnectnTryStartAddress = 1

11、/注意起始地址是 1 nTryEndAddress = 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_DATATYPE1BYTE_DATATYPE2INT_DATATYPE4錯(cuò)誤 ! 未找到引用源。北京亞控版權(quán)所有第 7頁(yè)共10頁(yè)2020-4-1821:41修改版本： V1.9UINT_DATATYPE8BCD_DATATYPE16LONG_DATATYPE32

12、LONGBCD_DATATYPE64FLOAT_DATATYPE128STRING_DATATYPE256(2) 打包規(guī)則說(shuō)明配置文件是一個(gè)信息文件格式，其中定義了設(shè)備名稱以及打包規(guī)則。需要說(shuō)明的是，這里定義的打包規(guī)則是基于協(xié)議的。比如協(xié)議里規(guī)定， 4 寄存器的 1 10 是一個(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ī)則

13、后沒(méi)有 fixed ，那么組包為 42-49。4) 如果相應(yīng)的規(guī)則后有 fixed，那么組包為 41-410。5) 如果變量不在規(guī)則指定的范圍內(nèi)，則每個(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:ProgramFilesKingviewdriver 。2) PackLen

14、單位為字 (WORD) 。由于 ModbusRTU 應(yīng)答的數(shù)據(jù)最多255 字節(jié) (127 個(gè)WORD) ，PackLen 最大設(shè)置為 127。3) 每個(gè)寄存器需單獨(dú)列出打包規(guī)則。若有多個(gè)打包段，按順序?qū)憽Ｗ疃嘀С?2 個(gè)打包段。4) 0 和 1 寄存器是以字節(jié) (BYTE) 為單位，其他寄存器是以字(WORD) 為單位。錯(cuò)誤 ! 未找到引用源。北京亞控版權(quán)所有第 8頁(yè)共10頁(yè)2020-4-1821:41修改版本： V1.9例如：1 = 10003,10004 表示寄存器變量10017-10032 可以打一個(gè)包2 = 40008,40012 表示寄存器變量40008-40012 可以打在一個(gè)包5

15、) 如果用戶沒(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è)包， 321 一個(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)的一些特殊

16、需要說(shuō)明的問(wèn)題， 例如某個(gè)寄存器寫范圍超過(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ō)明（有特殊連線要求的填寫）十五、對(duì)于性能事項(xiàng)的特別說(shuō)明十六、參考資料的說(shuō)明附錄： 3.0 接口程序編程規(guī)范關(guān)于程

17、序的規(guī)范，會(huì)影響到測(cè)試環(huán)節(jié)的部分a) 寄存器和通道號(hào)之間的 0 不做限制， 0 通道的 0 可輸入可不輸入。寄存器加通道號(hào)的總長(zhǎng)度不能超過(guò) 32。錯(cuò)誤 ! 未找到引用源。北京亞控版權(quán)所有第 9頁(yè)共10頁(yè)2020-4-1821:41修改版本： V1.9b)寄存器通道的多級(jí)通道之間使用英文輸入下的英文點(diǎn)號(hào) （” .）”，例如 A 寄存器有三級(jí)通Ax.y.zc)設(shè)備地址有多層含義時(shí)用 英文輸入下的冒號(hào) （” :）”分開(kāi) .比如 Modbus tcp 地址格式為IP地址:端口號(hào) :單元號(hào) ，地址舉例應(yīng)為為：127.0.0.1:502:12 （ IP 地址按照國(guó)際標(biāo)準(zhǔn)之間用英文”.）”各個(gè)分隔符中間只能是數(shù)字。數(shù)字可以是十進(jìn)制的或者十六進(jìn)制的。十六進(jìn)制A F 字符大小寫不敏感。如