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:

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 PODApplications. 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);
  ...