Application level CI control functions. More...

Functions
U8BIT	ACI_GetCamUpgradeMode (void)
	Return CAM upgrade option (Yes/No/Ask)
void	ACI_SetCamUpgradeMode (U8BIT upgrade_mode)
	Sets the CAM upgrade option (Yes/No/Ask)
U8BIT	ACI_GetOperatorSearchMode (void)
	Return the option for starting an operator profile search (yes/no/ask)
void	ACI_SetOperatorSearchMode (U8BIT search_mode)
	Sets the operator profile search mode (Yes/No/Ask). This should be used by the app to control whether a search can be started, or the user should be asked first, or can't run.
void	ACI_OperatorSearchRequired (U32BIT module, BOOLEAN required)
	Sets whether an operator profile search needs to be run.
void	ACI_ScheduleOperatorSearch (U32BIT module, U16BIT date, U8BIT hour, U8BIT min)
	Sets the date/time that an operator search should be started for the given module.
BOOLEAN	ACI_IsOperatorSearchRequired (void)
	Returns whether an operator profile search has been requested.
U32BIT	ACI_GetOperatorSearchModule (void)
	Returns the module performing or requiring and operator search.
BOOLEAN	ACI_GetFirstOperatorSearchModule (U32BIT *module)
	Checks all the CI+ profiles to see if any have requested an update search.
BOOLEAN	ACI_GetFirstScheduledOperatorSearch (U32BIT module, U16BIT date, U8BIT hours, U8BIT mins)
	Checks all the CI+ profiles to find the one with the earliest scheduled search. All returned values are only valid if the function returns TRUE.
BOOLEAN	ACI_StartOperatorSearchForModule (U32BIT module)
	Called by the app to start an operator profile search for the given module.
void	ACI_OperatorSearchFinished (void)
	Called when an operator search has finished. Returns the live path to the service that was being viewed before the search started.
BOOLEAN	ACI_AcquireCISlot (U8BIT path, void *s_ptr)
	Acquires a CI slot for the given path on the given service after releasing any slot already being used by the path.
void	ACI_AcquireCISlotForRecording (U8BIT path, void *s_ptr)
	Acquires a CI slot for the recording path. This function may need to "steal" the CI slot from the live path (if they are not the same path).
U8BIT	ACI_FindCISlotForService (void *serv_ptr)
	Looks for a CAM that's able to descramble the given service and returns its slot id.
S32BIT	ACI_ReadPinForSlot (U8BIT slot_id)
	Checks if a pin has been saved for the CAM in the given slot and returns it.
BOOLEAN	ACI_WritePinForSlot (U8BIT slot_id, S32BIT pin)
	Saves the given pin associated with the CAM in the given slot. If the pin for this CAM has previously been saved then the saved value will be updated. If all entries are used then the oldest will be overwritten.
BOOLEAN	ACI_HandlePrivateTimer (U32BIT timer_handle)
	Checks whether the given timer is associated with any of the CI+ profiles and starts the operator search if possible.
BOOLEAN	ACI_SetSecureRouting (U8BIT path)
	Ensures the TS is routed securely for CI+, either by setting the TS to pass through if a CI slot contains a CI+ CAM or bypass it if it doesn't.
void	ACI_CISlotStatusChanged (U8BIT slot_id)
	Re-evaluate current state follwing a change related to CI slots.
void	ACI_UsageRulesStatusChanged (U8BIT path)
	Re-evaluate current state follwing a change related to usage rules.
void	ACI_ContentControlKeysChanged (void)
	Apply new content control keys on all active paths.
void	ACI_ProgramMapTableChanged (U8BIT *pmt)
	Handle PMT change.
void	ACI_ApplyCCKeys (U8BIT slot_id)
	Handle PMT change.
BOOLEAN	ACI_IsTrustedPath (U8BIT path)
	The given decode path is only trusted if it doesn't include a CI slot or the CI slot contains a CI+ CAM.
void	ACI_RecordLicenceChanged (U8BIT path, U8BIT slot_id)
	Handles a CICAM licence update when recording, which results in the licence being saved with the recording for use during playback.
void	ACI_PlaybackLicenceChanged (U8BIT slot_id)
	Handles a CICAM licence update during playback, which may result in the app being informed that the licence is no longer valid for the recording.
void	ACI_RecordPin (U8BIT path, U8BIT slot_id)
	Handles a CICAM pin update when recording, which results in the pin info being saved with the recording for use during playback.

Detailed Description

Application level CI control functions.

Date:: February 2011

Author:: Ocean Blue

Function Documentation

BOOLEAN ACI_AcquireCISlot	(	U8BIT	path,
		void *	s_ptr
	)

Acquires a CI slot for the given path on the given service after releasing any slot already being used by the path.

Parameters:

path	decode path
s_ptr	service to be used on the path

Returns:: TRUE if a slot is acquired, FALSE otherwise

void ACI_AcquireCISlotForRecording	(	U8BIT	path,
		void *	s_ptr
	)

Acquires a CI slot for the recording path. This function may need to "steal" the CI slot from the live path (if they are not the same path).

Parameters:

path	decode path for recording
s_ptr	service to be used on the path

void ACI_ApplyCCKeys ( U8BIT slot_id )

Handle PMT change.

Parameters:

pmt	the new PMT

void ACI_CISlotStatusChanged ( U8BIT slot_id )

Re-evaluate current state follwing a change related to CI slots.

Parameters:

slot_id slot on which the status has changed

U8BIT ACI_FindCISlotForService ( void * serv_ptr )

Looks for a CAM that's able to descramble the given service and returns its slot id.

Parameters:

serv_ptr service

Returns:: slot id, if CAM is found, or INVALID_RES_ID if not

U8BIT ACI_GetCamUpgradeMode ( void )

Return CAM upgrade option (Yes/No/Ask)

Returns:: U8BIT the cams current upgrade mode

BOOLEAN ACI_GetFirstOperatorSearchModule ( U32BIT * module )

Checks all the CI+ profiles to see if any have requested an update search.

Parameters:

module pointer to return the handle of the first module requiring an update Only valid if the function returns TRUE

Returns:: TRUE if a profile needs updating, FALSE otherwise

BOOLEAN ACI_GetFirstScheduledOperatorSearch	(	U32BIT *	module,
		U16BIT *	date,
		U8BIT *	hours,
		U8BIT *	mins
	)

Checks all the CI+ profiles to find the one with the earliest scheduled search. All returned values are only valid if the function returns TRUE.

Parameters:

module	pointer to return the handle of the first module requiring an update
date	pointer to return the date code of the search
hours	pointer to return the hour of the search
mins	pointer to return the minute of the search

Returns:: TRUE if a scheduled search is found for a profile, FALSE otherwise

U8BIT ACI_GetOperatorSearchMode ( void )

Return the option for starting an operator profile search (yes/no/ask)

Returns:: The current setting

U32BIT ACI_GetOperatorSearchModule ( void )

Returns the module performing or requiring and operator search.

Returns:: module

BOOLEAN ACI_HandlePrivateTimer ( U32BIT timer_handle )

Checks whether the given timer is associated with any of the CI+ profiles and starts the operator search if possible.

Parameters:

timer_handle timer handle

Returns:: TRUE if the timer is associated with a profile, FALSE otherwise

BOOLEAN ACI_IsOperatorSearchRequired ( void )

Returns whether an operator profile search has been requested.

Returns:: TRUE if a search has been requested, FALSE otherwise

BOOLEAN ACI_IsTrustedPath ( U8BIT path )

The given decode path is only trusted if it doesn't include a CI slot or the CI slot contains a CI+ CAM.

Parameters:

path	decode path

Returns:: TRUE if the decode path is trusted, FALSE otherwise

void ACI_OperatorSearchRequired	(	U32BIT	module,
		BOOLEAN	required
	)

Sets whether an operator profile search needs to be run.

Parameters:

module	module requesting or cancelling an operator search
required	TRUE if a search is required, FALSE otherwise

void ACI_PlaybackLicenceChanged ( U8BIT slot_id )

Handles a CICAM licence update during playback, which may result in the app being informed that the licence is no longer valid for the recording.

Parameters:

slot_id CI slot

void ACI_ProgramMapTableChanged ( U8BIT * pmt )

Handle PMT change.

Parameters:

pmt	the new PMT

S32BIT ACI_ReadPinForSlot ( U8BIT slot_id )

Checks if a pin has been saved for the CAM in the given slot and returns it.

Parameters:

slot_id CI slot

Returns:: pin value, or -1 if there's no CAM in the slot or no pin has been saved

void ACI_RecordLicenceChanged	(	U8BIT	path,
		U8BIT	slot_id
	)

Handles a CICAM licence update when recording, which results in the licence being saved with the recording for use during playback.

Parameters:

path	decode path
slot_id	CI slot

void ACI_RecordPin	(	U8BIT	path,
		U8BIT	slot_id
	)

Handles a CICAM pin update when recording, which results in the pin info being saved with the recording for use during playback.

Parameters:

path	decode path
slot_id	CI slot

void ACI_ScheduleOperatorSearch	(	U32BIT	module,
		U16BIT	date,
		U8BIT	hour,
		U8BIT	min
	)

Sets the date/time that an operator search should be started for the given module.

Parameters:

module	module requesting an operator search
date	UTC MJD date code
hour	UTC hour
min	UTC minute

void ACI_SetCamUpgradeMode ( U8BIT upgrade_mode )

Sets the CAM upgrade option (Yes/No/Ask)

Parameters:

upgrade_mode cam upgrade mode

void ACI_SetOperatorSearchMode ( U8BIT search_mode )

Sets the operator profile search mode (Yes/No/Ask). This should be used by the app to control whether a search can be started, or the user should be asked first, or can't run.

Parameters:

search_mode search mode

BOOLEAN ACI_StartOperatorSearchForModule ( U32BIT module )

Called by the app to start an operator profile search for the given module.

Parameters:

module operator module

Returns:: TRUE if the search is started, FALSE otherwise

void ACI_UsageRulesStatusChanged ( U8BIT path )

Re-evaluate current state follwing a change related to usage rules.

Parameters:

path	decode path

BOOLEAN ACI_WritePinForSlot	(	U8BIT	slot_id,
		S32BIT	pin
	)

Saves the given pin associated with the CAM in the given slot. If the pin for this CAM has previously been saved then the saved value will be updated. If all entries are used then the oldest will be overwritten.

Parameters:

slot_id	CI slot
pin	pin value to be saved

Returns:: TRUE on success, FALSE otherwise

Functions

Detailed Description

Function Documentation