Click here to Skip to main content
11,802,636 members (69,338 online)
Click here to Skip to main content

Modbus TCP class

, 23 May 2014 CPOL 343.9K 39.5K 131
Rate this:
Please Sign up or sign in to vote.
A Modbus TCP class.


This article explains a Modbus TCP common driver class. This class implements a modbus TCP master driver.

It supports the following commands:

  • Read coils
  • Read discrete inputs
  • Write single coil
  • Write multiple cooils
  • Read holding register
  • Read input register
  • Write single register
  • Write multiple register


I don't want to explain how the modbus protocol works in detail, because there is plenty of information around.

Using the code

All commands are sent in synchronous or asynchronous mode. If a value is accessed in synchronous mode, the program will stop and wait for the slave to respond. If the slave does not answer within a specified time, a timeout exception is called. The class uses multi-threading for both synchronous and asynchronous access. The class opens two communication channels for each slave. This is necessary because the synchronous thread has to wait for a command to finish. This would block the asynchronous connection. The class directory contains a help file (ModbusClassTCP\doc) with detailed information for every function.

A sample application is included in the package that shows the basic features. It uses asynchronous mode for all function calls. The sample has some additional code to make the result handling more comfortable.

Points of Interest

Remember that a lot of Modbus clients use a watchdog telegram to make sure the master is still active. If you don’t call this watchdog within a specified time, the slave will close the connection. This feature is used to avoid unused open ports when the connection is interrupted.


Version 3.3 (6/14/2013)
- Fixed: ID high and low byte swapped
- Added: Modbus paramater UNIT added to function calls
Version 3.2
First release


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Stephan Stricker
Product Manager
United States United States
No Biography provided

You may also be interested in...

Comments and Discussions

AnswerRe: convert error Pin
Stephan Stricker18-Nov-12 8:44
memberStephan Stricker18-Nov-12 8:44 
QuestionCan't open with free ms tools Pin
chris wedgwood26-Oct-12 4:09
memberchris wedgwood26-Oct-12 4:09 
AnswerRe: Can't open with free ms tools Pin
Stephan Stricker18-Nov-12 8:45
memberStephan Stricker18-Nov-12 8:45 
GeneralRe: Can't open with free ms tools Pin
chris wedgwood18-Nov-12 23:11
memberchris wedgwood18-Nov-12 23:11 
Ah, I fixed it. I was confused about which tool to use, and ended up with the 2012 desktop version, which works really well.

Thank you !
QuestionUnable to Read, able to write Pin
alexamex16-Oct-12 6:38
memberalexamex16-Oct-12 6:38 
AnswerRe: Unable to Read, able to write Pin
Stephan Stricker16-Oct-12 7:15
memberStephan Stricker16-Oct-12 7:15 
QuestionAny VB.Net synchronous mode examples available? Pin
Member 90645551-Jul-12 2:25
memberMember 90645551-Jul-12 2:25 
QuestionIt works Pin
Member 862908814-May-12 6:06
memberMember 862908814-May-12 6:06 
QuestionDisconnects and holding registers value displacement Pin
harizhent16-Mar-12 4:31
memberharizhent16-Mar-12 4:31 
AnswerRe: Disconnects and holding registers value displacement Pin
Stephan Stricker20-Mar-12 2:51
memberStephan Stricker20-Mar-12 2:51 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.151002.1 | Last Updated 23 May 2014
Article Copyright 2006 by Stephan Stricker
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid