NModbus API 手冊
版本 1.2 , 2013.10
Written by Renee Lin
NModbus API 手冊, v1.2 最後編輯 2013.10 Page:2
Copyright © 2013 ICP DAS Co., Ltd. All Rights Reserved. E-mail: service@icpdas.com
目錄
目錄 ................................................................................................................................. 2
1. 關於手冊 ............................................................................................................... 4
2. NModbus Master API ............................................................................................. 5
2.1. CreateRtu .................................................................................................................... 5
2.2. CreateAscii .................................................................................................................. 6
2.3. CreateIp(TcpClient) ..................................................................................................... 7
2.4. CreateIp(UdpClient) .................................................................................................. 11
2.5. Retries [屬性]............................................................................................................ 12
2.6. ReadTimeout[屬性] .................................................................................................. 12
2.7. ReadCoils .................................................................................................................. 13
2.8. ReadInputs ................................................................................................................ 14
2.9. ReadHoldingRegisters ............................................................................................... 15
2.10. ReadInputRegisters ............................................................................................... 16
2.11. WriteSingleCoil ..................................................................................................... 17
2.12. WriteSingleRegister .............................................................................................. 18
3. NModbus Slave API .............................................................................................. 19
3.1. CreateRtu .................................................................................................................. 20
3.2. CreateAscii ................................................................................................................ 21
3.3. CreateTcp .................................................................................................................. 22
3.4. CreateUdp ................................................................................................................. 23
3.5. CreateDefaultDataStore ........................................................................................... 24
3.6. ModbusSlaveRequestReceived[事件] ...................................................................... 24
3.7. DataStoreWrittenTo[事件] ....................................................................................... 25
3.8. Listen ......................................................................................................................... 28
3.9. CoilDiscretes [DO 資料陣列] .................................................................................... 28
3.10. InputDiscretes [DI 資料陣列] ............................................................................... 29
3.11. HoldingRegisters [AO 資料陣列] .......................................................................... 29
3.12. InputRegisters [AI 資料陣列] ............................................................................... 30
NModbus API 手冊, v1.2 最後編輯 2013.10 Page:3
Copyright © 2013 ICP DAS Co., Ltd. All Rights Reserved. E-mail: service@icpdas.com
4. 通用 API ............................................................................................................. 31
4.1. Dispose...................................................................................................................... 31
附錄 A:錯誤訊息 .......................................................................................................... 32
附錄 B:AI, AO 型別轉換 ............................................................................................... 35
NModbus API 手冊, v1.2 最後編輯 2013.10 Page:4
Copyright © 2013 ICP DAS Co., Ltd. All Rights Reserved. E-mail: service@icpdas.com
1. 關於手冊
此手冊對於 NModbus 中所使用的 API 說明。
什麼是 NModbus?
利用 NModbus 可實現 Modbus 的通訊協定,它是由一群自願者所開發以及維護,並且
免費開放使用。
ICP DAS 基於官方發佈的 NModbus 原始碼進行功能確認與改善,程式開發員可以利用 ICP
DAS 發佈的 DLL 進行 Windows 版 PC 或是 WinCE 版的 Modbus 程式開發。這個 DLL 具
備以下功能
a. Modbus/RTU Master/Slave
b. Modbus/ASCII Master/Slave
c. Modbus/TCP Master/Slave
d. Modbus/UDP Master/Slave
下載 DLL 與範例程式。
a. WinForm 版本
DLL 和文件:nModbusPC.dll, log4net.dll
範例程式 (For C#, VB.Net)
b. WinCE 版本
DLL 和文件:nModbusCE.dll, CABC.dll, FC19.dll
範例程式 (For C#, VB.Net)
了解更多有關 Modbus→http://www.icpdas.com/products/PAC/i-8000/modbus_c.htm
適用 NModbus 開發的 PAC
WinForm
XPAC(WES 2009)
Win8,Win7,Vista,Xp(需有.NET framework 2(含)以上)
WinCE
ViewPAC(CE5)
WinPAC(CE5)
XPAC(CE6)
NModbus API 手冊, v1.2 最後編輯 2013.10 Page:5
Copyright © 2013 ICP DAS Co., Ltd. All Rights Reserved. E-mail: service@icpdas.com
2. NModbus Master API
2.1. CreateRtu
建立 modbus master RTU 的連線。
語法
C#
ModbusSerialMaster CreateRtu(
SerialPort serialPort
)
建立 Master 連線
Master.Read
更新資料至 UI
Master.Dispose
設定 ReadTimeout
設定 Retries
Master.ReadCoils
Master.ReadInputs
Master.ReadHoldingRegisters
Master.ReadInputRegisters