org.ocap.hardware.pod.package.html Maven / Gradle / Ivy
This package provides a way to set and get OpenCable
CableCARD Resource related parameters.
The following CableCARD Resources are covered by this package:
- Application Information
Resource
- Generic Feature Control
Support Resource
The {@link org.ocap.hardware.pod.POD} class provides access to information
and functions related to the CableCARD Resources listed above. It is based on a
generic singleton model; only privileged applications that have
MonitorAppPermission(podApplication), such as the Monitor Application, can get
an instance of it via the POD.getInstance() method. Other {@link
org.ocap.hardware.pod.POD} methods do not check the permissions settings of the
invoking object.
Application Information Resource
The CableCARD device has zero or more {@link
org.ocap.hardware.pod.PODApplication}s. The {@link
org.ocap.hardware.pod.POD#getApplications} method returns an array of {@link
org.ocap.hardware.pod.PODApplication} instances. The {@link
org.ocap.hardware.pod.PODApplication} class provides access to the parameters
defined in the Application Information Resource of the OpenCable CableCARD
Interface Specification.
Example:
? import org.ocap.hardware.pod.*;? ...? POD pod = POD.getInstance();? PODApplication[] apps = pod.getApplications();? String name = apps[0].getName();? ...
Generic
Feature Control Support Resource
OCAP applications may modify the Feature parameter in the Host
device via the {@link org.ocap.hardware.pod.POD#updateHostParam} method.
Applications can also get notified and reject update of the Feature parameter
via the {@link org.ocap.hardware.pod.HostParamHandler}, when the CableCARD
device attempts to change Feature parameters. The {@link
org.ocap.hardware.pod.HostParamHandler} is registered via the {@link org.ocap.hardware.pod.POD#setHostParamHandler}
method.
Example:
? import org.ocap.hardware.pod.*;? ...? POD pod = POD.getInstance();? int acOutlet = 7;? byte[] unswitched = {0X02};? byte[] value = pod.getHostParam(acOutlet);? ...? pod.updateHostParam(acOutlet, unswitched);? ...