See: Description
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 | 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 | 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. |
Peripheral
sub-interfaces. Peripheral devices are registered under a peripheral ID
and with optionally a name and a set of properties. 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). 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 |
Copyright (c) 1990, 2013, Oracle and/or its affiliates. All rights reserved.