org.ocap.hardware.pod

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES

## Package org.ocap.hardware.pod

This package provides a way to set and get OpenCable CableCARD Resource related parameters.

See:
Description

Interface Summary
HostParamHandler | A class that implements this interface can reject the update of the Feature parameter in the Host device.
PODApplication | This class represents an Application that resides in the OpenCable CableCARD device.

Class Summary
POD | This class provides an access to functions and information of the OpenCable CableCARD device on the OCAP Host device.

## Package org.ocap.hardware.pod Description

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 `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 `POD` methods do not check the permissions settings of the invoking object.

### Application Information Resource

The CableCARD device has zero or more `PODApplication`s. The `POD.getApplications()` method returns an array of `PODApplication` instances. The `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 `POD.updateHostParam(int, byte[])` method. Applications can also get notified and reject update of the Feature parameter via the `HostParamHandler`, when the CableCARD device attempts to change Feature parameters. The `HostParamHandler` is registered via the `POD.setHostParamHandler(org.ocap.hardware.pod.HostParamHandler)` 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);

>       ...

Overview | Package | Class | Use | Tree | Deprecated | Index | Help

PREV PACKAGE NEXT PACKAGE | FRAMES NO FRAMES