These docs are for v5.0.0. Click to read the latest docs for v7.5.0.

Driver Implementation

A Driver encapsulates the communication protocol and its configuration parameters.

The Driver API abstracts the specificities of the end Fieldbus protocols providing a clean and easy to use set of calls that can be used to develop end-applications.

Using the Driver APIs, an application can simply use the connect and disconnect methods to open or close the connection with the Field device. Furthermore, the read and write methods allow to exchange data with the Field device.

A Driver instance can be associated with an Asset to abstract even more the low-level specificities and allow an easy and portable development of the Java applications that need to interact with sensors, actuators and PLCs.

The Asset will use the Driver's protocol-specific channel descriptor to compose the Asset Channel description.

Driver Configuration

Generally, a Driver instance is a configurable component which parameters can be updated in the Services section of the ESF Administrative User Interface.

2718

Supported Field Protocols and Availability

Drivers will be provided as add-ons available in the Eclipse IoT Marketplace.

Currently, supported drivers are:

Driver-Specific Optimizations

The Driver API provides a simple method to read a list of Channel Records:

public void read(List<ChannelRecord> records) throws ConnectionException;

Typically, since the records to read do not change until the Asset configuration is changed by the user, a Driver can perform some optimisations to efficiently read the requested records at once. For example, a Modbus driver can read a range of holding registers using a single request.

Since these operations are costly, the ESF API adds methods to ask the driver to prepare reading a given list of records and execute the prepared read:

public PreparedRead prepareRead(List<ChannelRecord> records);

Invocation of the preparedRead method will result in a PreparedRead instance returned.

On a PreparedRead, the execute method will perform the optimized read request.