Package org.onosproject.net.driver

Set of facilities to allow the platform to be extended with device specific behaviours and to allow modeling device behaviours while hiding details of specific device driver implementations.

See: Description

Interface Summary

Interface	Description
Behaviour	Representation of a facet of device behaviour that can be used to talk about a device (in context of DriverData) or to a device (in context of DriverHandler).
DefaultDriverProviderService	Service representing availability of default drivers.
Driver	Representation of a specific family of device drivers.
DriverAdminService	Service for managing drivers and driver behaviour implementations.
DriverConnect	Abstraction of handler behaviour used to set-up and tear-down driver connection with a device.
DriverData	Container for data about a device.
DriverHandler	Representation of context for interacting with a device.
DriverProvider	Represents entity capable of providing device drivers and their behaviours.
DriverResolver	Entity capable of resolving a driver using its name.
DriverService	Service for obtaining drivers and driver behaviour implementations.
HandlerBehaviour	Representation of a facet of device behaviour that can be used to interact with a device (in context of DriverHandler).

Class Summary

Class	Description
AbstractBehaviour	Base implementation of device driver behaviour.
AbstractHandlerBehaviour	Base implementation of device driver handler behaviour.
DefaultDriver	Default implementation of extensible driver.
DefaultDriverData	Default implementation of driver data descriptor.
DefaultDriverHandler	Default implementation of driver handler.
DefaultDriverProvider	Default driver provider implementation.
XmlDriverLoader	Utility capable of reading driver configuration XML resources and producing a device driver provider as a result.

Package org.onosproject.net.driver Description

Set of facilities to allow the platform to be extended with device specific behaviours and to allow modeling device behaviours while hiding details of specific device driver implementations.

Driver is a representation of a specific family of devices supports set of behaviour classes. Default implementation is provided by the platform and allows DriverProviders to add different behaviour implementations via DriverService.

DriverData is a container for data learned about a device. It is associated with a specific Driver and provides set of behaviours for talking about a device. A default implementation provided by platform and has mutable key/value store for use by implementations of behaviours.

DriverHandler is an entity used as a context to interact with a device. It has a peer DriverData instance, which is used to store information learned about a device. It also provides set of behaviours for talking to a device.

DriverService can be used to query the inventory of device drivers and their behaviours, while the DriverAdminService allows adding/removing drivers and managing behaviour implementations. DriverProvider is an entity capable of add/removing drivers and supplying and managing behaviour implementations. A default implementation is provided by the framework along with a loader utility to create a driver provider from an XML file structured as follows:

     <drivers>
         <driver name=“...” [manufacturer="..." hwVersion="..." swVersion="..."]>
             <behaviour api="..." impl="..."/>
             ...
             [<property name=“key”>value</key>]
             ...
         </driver>
         ...
     </drivers>