User Tools

Site Tools


Sidebar

MyCNC Shop

MyCNC website

myCNC Price List

mycnc:host_modbus_api

Host Modbus API

Modbus Master API is implemented in myCNC software.

Host computer with myCNC able to read Input registers and write data Holding registers from/to modbus Slave device.

User API is available through the Software PLC.

Register Name Address Description
GVAR_XMODBUS_SERVER_ADDR 5750 Writing to this register sets Modbus Server Address
GVAR_XMODBUS_VALUE 5751 Writing to this register sets a Value that will be sent while write to Modbus Server
GVAR_XMODBUS_RW_READY 5752
GVAR_XMODBUS_READY_READ 5753 Ready Read flag. The value is automatically cleared ion start of Modbus read operation.
If Read is finished successfully, the value is set to “1”.
If Read operation is failed, the value is set to “-1”.
GVAR_XMODBUS_WRITE 5755 Writing to this register initiates Modbus Write operation.
Written value is Modbus Server Register address (for Write).
A value defined in register 5751 will be sent
GVAR_XMODBUS_READ 5756 Writing to this register initiates Modbus Read operation.
Written value is a Modbus Server Register address (for Read).
Writing to this register will clear READY_READ register (5753). The READ_READY register value will be set to “1” when Read completed successfully. The READ_READY register will be set to “-1” if Read Error happens
GVAR_XMODBUS_ADDR2READ 5761 Writing to this Register sets Address of Global register to put a result of Modbus Read operation
GVAR_XMODBUS_READ_INPUT_BITS 5763 Read the input bits. This will read the digital inputs/outputs in the
GVAR_XMODBUS_READ 5764 Read Modbus register (specify the particular register to read such as 5764,0)

Example:

  • Need to write a value of “999” to Modbus Server with Address #7 to register #25,
  • then read register #24 and save it in global variable register #500
//Write
  gvarset(5750,7);  //Set Modbus Server Address
  gvarset(5751,99); //Set a value to write
  gvarset(5755,25); //Write to Modbus regsiter #25
 
//Read
  gvarset(5752,500); //Set Register #500 to receive Modbus Read result
  gvarset(5756,24);  //Read Modbus register #24
 
  do
  {
    //wait ready_ready
    timer++;
  }while(gvarget(5753)==0);
 
  if (gvarget(5753)<0)
  {
    exit(99); //Modbus Ready Error
  };
 
  a=gvarget(500); //Read modbus result can be used by reading redister #500
 

Another read/write example for WP9038ADAM with digital inputs/outputs and analog inputs

The analog inputs in this example are the holding registers, while the bits are the digital inputs and outputs which are dealt with through read/write commands. The code is using a 3 ms delay in order to loop the timer and to allow the Modbus device to receive/send all the necessary commands.

main()
{
 
 
//Write
  gvarset(5750,34);  //Set Modbus Server Address (device ID is set to be 34 in this case)
  gvarset(5752,1);  //Indicator whether the operation is complete (0 for complete, 1 for not complete)
 
  timer=0; 
 
  address=500; //the variable address is specified to the 500
  gvarset(5761,address);  //Address to store read value
 
count=0;
  do
  {
  gvarset(5761,address);  //Address to store read value
 
  gvarset(5751,count); //Set a value to write (selects which value will be written)
  gvarset(5756,0); //Set a value to write (command to write the value that was set)
 
  timer=3;do{timer--; }while(timer>0); //0.3 ms timer to loop
 
// Read Bits
  gvarset(5763,0);  //Read Modbus register #0
  timer=3;do{timer--; }while(timer>0); 
 
// Read Holding Registers
 
  gvarset(5761,address+1);  //Address to store read value will be variable 501
  gvarset(5764,0);  //Read Modbus register #0
  timer=3;do{timer--; }while(timer>0); 
 
// Read Holding Registers
 
  gvarset(5761,address+2);  //Address to store read value will be variable 502
  gvarset(5764,1);  //Read Modbus register #1
  timer=3;do{timer--; }while(timer>0); 
 
// Read Holding Registers
 
  gvarset(5761,address+3);  //Address to store read value will be variable 503
  gvarset(5764,2);  //Read Modbus register #2
  timer=3;do{timer--; }while(timer>0); 
 
// Read Holding Registers
 
  gvarset(5761,address+4);  //Address to store read value will be variable 504
  gvarset(5764,3);  //Read Modbus register #3
  timer=3;do{timer--; }while(timer>0); 
 
count++;
gvarset(507,count); //specifies the value for the 507 address
 
   }while(1);
 
 exit(99);
};

The specifications for the Modbus devices that are currently sold through the myCNC shop can be found here: Modbus Devices available

mycnc/host_modbus_api.txt · Last modified: 2019/08/01 15:26 by ivan