-
Notifications
You must be signed in to change notification settings - Fork 1
ModbusDriver
The device type specific configuration of the modbus sMAP driver takes place in a CSV file specified in the sMAP configuration file. (See the register_config argument of the volttron.drivers.modbus.Modbus in the sMAP config example [ControllerAccess].) An example file can be found in the voltron-list repository at volttron/drivers/example.csv
The CSV file should be comma delimited. An Excel spreadsheet converted to CSV should work fine, even with commas in the data.
The CSV file requires a header line with the following columns labeled in any order (without quotes):
The name to used access the point. References to this point will use name.
Used for meta data when creating point information on the sMAP historian.
A string representing how to interpret the data register and how to read it it from the device. The string takes two forms:
- "BOOL" for coils and discrete inputs.
- A format string for the Python struct module. See http://docs.python.org/2/library/struct.html for full documentation. Note that sMAP only supports numerical types. Strings will not work. Also the supplied format string must only produce one value.
- Examples:
- ">f" - A big endian 32-bit floating point number.
- "
- ">l" - A big endian 32-bit integer.
Either TRUE or FALSE. Determines if the point can be written to. If TRUE an actuation point will be created in addition to the normal point representing periodically scraped data. Only points labeled TRUE can be accessed through the ActuatorAgent.
Modbus address of the point. Cannot include any offset value, it must be the exact value of the address.
Additional notes for the point.
Additional columns may be added at the user discretion as long as they are labeled differently.
The following is a simple example:
| Point Name | PNNL Point Name | Units | Units Details | Modbus Register | Writable | Point Address | Notes |
|---|---|---|---|---|---|---|---|
| SampleFloat | SampleFloat | PPM | 0.00-2000.00 | >f | FALSE | 1001 | CO2 Reading 0.00-2000.0 ppm |
| SampleWritableFloat | SampleWritableFloat | PPM | 1000.00 (default) | >f | TRUE | 1003 | Setpoint to enable demand control ventilation |
| SampleLong | SampleLong | Enumeration | 1 through 13 | >l | FALSE | 1005 | Status indicator of service switch |
| SampleWritableShort | SampleWritableShort | % | 0.00 to 100.00 (20 default) | >H | TRUE | 1007 | Minimum damper position during the standard mode |
| SampleBool | SampleBool | On / Off | on/off | BOOL | FALSE | 1101 | Status indidcator of cooling stage 1 |
| SampleWritableBool | SampleWritableBool | On / Off | on/off | BOOL | TRUE | 1102 | Status indicator |