Plugin:Modbus

From collectd Wiki
Jump to: navigation, search
Modbus plugin
Type: read
Callbacks: config, read, shutdown
Status: supported
First version: 4.10
Copyright: 2010 noris network AG
License: GPLv2 (v4.10)
LGPLv2.1 (since v5.0)
Manpage: collectd.conf(5)
List of Plugins

The Modbus plugin connects to a Modbus "slave" via Modbus/TCP and reads register values. It supports reading single registers (unsigned 16 bit values), large integer values (unsigned 32 bit values) and floating point values (two registers interpreted as IEEE floats in big endian notation).

This plugin is a generic plugin, i.e. it cannot work without configuration, because there is no reasonable default behavior. Please read the Plugin modbus section of the collectd.conf(5) manual page for an in-depth description of the plugin's configuration.

Synopsis

<Plugin modbus>
 <Data "voltage-input-1">
   RegisterBase 0
   RegisterType float
   Type voltage
   Instance "input-1"
 </Data>
 
 <Data "voltage-input-2">
   RegisterBase 2
   RegisterType float
   Type voltage
   Instance "input-2"
 </Data>
 
 <Host "modbus.example.com">
   Address "192.168.0.42"
   Port    "502"
   Interval 60
   
   <Slave 1>
     Instance "power-supply"
     Collect  "voltage-input-1"
     Collect  "voltage-input-2"
   </Slave>
 </Host>
</Plugin>

Example Graphs

None yet. Add one now!

Dependencies

Personal tools
Namespaces

Variants
Actions
Navigation
Tools