Package com.oracle.deviceaccess

Provides interfaces and classes for device I/O access and control.

See: Description

Interface Summary

Interface	Description
Peripheral	The Peripheral interface represents peripheral devices in the system.
PeripheralConfig	The PeripheralConfig class is a tagging interface for all peripheral configuration classes.
PeripheralEventListener	The PeripheralEventListener interface is a tagging interface that all event listeners must implement.
Transactional	The Transactional interface provides methods for demarcating a communication transaction.

Class Summary

Class	Description
PeripheralEvent	The PeripheralEvent class encapsulates events fired by or on behalf of a peripheral device.
PeripheralManager	The PeripheralManager class provides methods for opening and registering peripheral devices that can then be handled as Peripheral instances.

Exception Summary

Exception	Description
InvalidStateException	Thrown by an instance of Peripheral to indicate that an operation as been attempted at an inappropriate time.
PeripheralConfigInvalidException	Thrown to indicate that the provided peripheral configuration is invalid/is not supported.
PeripheralException	Thrown to indicate that a general exception occurred on a peripheral operation.
PeripheralExistsException	Thrown by the PeripheralManager to indicate that a peripheral device is already registered for the specified ID.
PeripheralNotAvailableException	Thrown by an instance of Peripheral to indicate that an operation is attempted on a peripheral which is not (yet) available.
PeripheralNotFoundException	Thrown to indicate that there is no peripheral matching the provided peripheral numerical ID, name or properties.
PeripheralTypeNotSupportedException	Thrown by the PeripheralManager to indicate permanent unavailability of the looked up peripheral.

Package com.oracle.deviceaccess Description

Provides interfaces and classes for device I/O access and control. Peripheral devices are of defined types and can be accessed and control by the means of Peripheral sub-interfaces. Peripheral devices are registered under a peripheral ID and with optionally a name and a set of properties.

Security

Peripheral devices are opened by invoking one of the com.oracle.deviceaccess.PeripheralManager.open methods. Opening a peripheral device of a specific type is subject to permission checks specific for that type - see each peripheral device package overview for a description of the security permissions that may apply (e.g. GPIO permissions).
Peripheral devices are registered, un-registered, configured and listed by invoking one of the open, register, unregister and list methods of PeripheralManager. The permissions below allow access to be granted for registration, configuration, un-registration and listing of peripheral devices. Note that these permissions must be granted in addition to the permissions granting access to a specific peripheral type. For example, opening a GPIO pin with an ad-hoc configuration requires both the "com.oracle.deviceaccess.gpio" and "com.oracle.deviceaccess.PeripheralManager.configure" to be granted. Similarly, registering a GPIO pin with an ad-hoc configuration requires both the "com.oracle.deviceaccess.gpio" and "com.oracle.deviceaccess.PeripheralManager.register" to be granted.

Permission	Function
"com.oracle.deviceaccess.PeripheralManager.configure"	Ad-hoc configuration of peripheral devices
"com.oracle.deviceaccess.PeripheralManager.register"	Registration of peripheral devices
"com.oracle.deviceaccess.PeripheralManager.unregister"	Unregistration of peripheral devices
"com.oracle.deviceaccess.PeripheralManager.list"	Listing of registered peripheral devices