org.ocap.hardware.pod.HostParamHandler.html Maven / Gradle / Ivy

A class that implements this interface can reject the update of the Feature parameter in the Host device. Feature parameter is defined for the Generic Feature Control Support in the OpenCable CableCARD Interface specification. An OCAP-J application can set only one instance of such classes to the OCAP implementation via the POD.setHostParamHandler(org.ocap.hardware.pod.HostParamHandler) method.

Before Feature parameter in the Host is modified, the notifyUpdate(int, byte[]) method shall be called with the Feature ID to be modified and its Feature parameter value. And only if the HostParamHandler.notifyUpdate() method returns true, the Feature parameter value in the Host device will be modified. Note that the Host device may reject the update of Feature parameter even if the HostParamHandler.notifyUpdate() method returns true.

The Feature ID and the Feature parameter value format are defined in the CableCARD Interface 2.0 Specification [4]. For example, the Feature ID of "RF Output Channel" Feature is 0x1, and its parameter value format is
Rf_output_channel() {
    Output_channel
    Output_channel_ui
}


The Feature parameters in the Host device will be modified by the following cases.

• The CableCARD sends feature_parameters APDU to the Host. (See the [CCIF 2.0].)
• The Host modifies its own Feature parameters.
• An OCAP-J application calls the POD.updateHostParam(int, byte[]) method.

notifyUpdate

boolean notifyUpdate(int featureID,
                     byte[] value)

This is a call back method to notify an update of the Feature parameter in the Host device. This method shall be called every time before the Feature parameter is modified. Only if this method returns true, the Host device can modify its Feature parameter by the specified value.

Note that the Host device may reject the update of Feature parameter even if the HostParamHandler.notifyUpdate() method returns true.

This method should return immediately without blocking.

Parameters:

featureID - a Feature ID for the Generic Feature Control Support in the CableCARD Interface 2.0 Specification [4]. The Feature ID reserved for proprietary use (0x70 - 0xFF) can be specified.

value - a Feature parameter value for the specified featureID. An actual format of each Feature parameter is defined in the CableCARD Interface 2.0 Specification [4]. For example, if the featureID is 0x1, the value is
Rf_output_channel() {
    Output_channel
    Output_channel_ui
}

Returns:

true to accept the modification of the specified value. false to reject it.

See Also:

POD.setHostParamHandler(org.ocap.hardware.pod.HostParamHandler)