System Interface, Configuration. More...

#include <stdio.h>
#include <string.h>
#include <techtype.h>
#include <dbgfuncs.h>
#include "stbhwtun.h"
#include "stbheap.h"
#include "stbdpc.h"
#include "stbsitab.h"
#include "ap_cfg.h"
#include "ap_cntrl.h"
#include "hbbtv_sif_types.h"
#include "hbbtv_sif_conf.h"

Macros
#define	SYSTEM_FLAG_DVBT 1

#define	SYSTEM_FLAG_DVBT2 2

#define	SYSTEM_FLAG_DVBS 4

#define	SYSTEM_FLAG_DVBS2 8

#define	SYSTEM_FLAG_DVBC 16

Functions
E_HBBTV_ERR	HBBTV_GetPrefAudioLang (U8BIT *lang_string, U32BIT size)
	Retrieves a string containing a comma-separated set of languages to be used for audio playback, in order of preference. The returned string must be freed with HBBTV_ReleaseLangString. More...

E_HBBTV_ERR	HBBTV_GetPrefSubtLang (U8BIT *lang_string, U32BIT size)
	Retrieves a string containing a comma-separated set of languages to be used for subtitles, in order of preference. The returned string must be freed with HBBTV_ReleaseLangString. More...

E_HBBTV_ERR	HBBTV_GetPrefCountryId (U8BIT *lang_string, U32BIT size)
	Retrieves a string containing the three character string representing country code identifying the country in which the receiver is deployed. The returned string must be freed with HBBTV_ReleaseLangString. More...

void	HBBTV_ReleaseLangString (U8BIT *lang_string)
	Frees the string obtained from HBBTV_GetPrefAudioLang, HBBTV_GetPrefSubtLang, HBBTV_GetPrefUiLang or HBBTV_GetPrefCountryId. More...

U8BIT *	HBBTV_GetDeliverySystemsString (void)
	Retrieves the string describing the supported Broadcast Delivery Systems (DVB_S, DVB_C, DVB_T, DVB_C2, DVB_T2 or DVB_S2) as defined in Section 9.2, Table 15, under "UI Profile Name Fragment". the HbbTV engine will call HBBTV_ReleaseDeliverySystemsString when the string is not needed any more. More...

void	HBBTV_ReleaseDeliverySystemsString (U8BIT *systems)
	Frees the Broadacast Delivery Systems string, returned by HBBTV_GetDeliverySystemsString. More...

void	HBBTV_GetParentalControlSettings (BOOLEAN enabled, U8BIT age)
	Query whether parental control is enabled and the selected age, if applicable. The age is the actual age, so for DVB the valid values are 4 to 18, inclusive. More...

BOOLEAN	HBBTV_GetSpeechDescriptionEnabled (void)
	Returns the speech description status. This function is used by the HbbTV engine only if support for speech description has been signalled in the S_HBBTV_SYSTEM_INFO structure. The correct implementation of this function is not required for HbbTV 1.2.1, it is used to implement the Configuration speechDescriptionEnabled property as defined in Freesat OPAL v1.0 section 8.4.1.2. More...

BOOLEAN	HBBTV_GetVoiceControlEnabled (void)
	Returns the voice control status. This function is used by the HbbTV engine only if support for voice control has been signalled in the S_HBBTV_SYSTEM_INFO structure. The correct implementation of this function is not required for HbbTV 1.2.1, it is used to implement the Configuration voiceControlEnable property as defined in Freesat OPAL v1.0 section 8.4.1.3. More...

Detailed Description

System Interface, Configuration.

Date: January 2014

Author: Sergio Panseri

Function Documentation

U8BIT* HBBTV_GetDeliverySystemsString ( void )

Retrieves the string describing the supported Broadcast Delivery Systems (DVB_S, DVB_C, DVB_T, DVB_C2, DVB_T2 or DVB_S2) as defined in Section 9.2, Table 15, under "UI Profile Name Fragment". the HbbTV engine will call HBBTV_ReleaseDeliverySystemsString when the string is not needed any more.

Returns: Pointer to an allocated buffer containing a string describing the list of supported broadcast deliverys systems (e.g. "+DVB_T2+DVB_T+DVB_C", note that the first '+' character is needed). The buffer will be freed by the HbbTV engine using HBBTV_ReleaseDeliverySystemsString.

void HBBTV_GetParentalControlSettings	(	BOOLEAN *	enabled,
		U8BIT *	age
	)

Query whether parental control is enabled and the selected age, if applicable. The age is the actual age, so for DVB the valid values are 4 to 18, inclusive.

Parameters

enabled	Used to return a boolean defining whether parental control is enabled (TRUE), or not (FALSE).
age	Pointer to returned age value. Should be returned as 0 if parental control is disabled or age isn't set

E_HBBTV_ERR HBBTV_GetPrefAudioLang	(	U8BIT **	lang_string,
		U32BIT *	size
	)

Retrieves a string containing a comma-separated set of languages to be used for audio playback, in order of preference. The returned string must be freed with HBBTV_ReleaseLangString.

Parameters

lang_string	Pointer to the returned string
size	Pointer to the number of bytes in the returned string

Returns

- HBBTV_OK on success

HBBTV_ERR_BAD_PARAMETER invalid parameter
HBBTV_ERR_ALLOCATING_MEMORYThe string couldn't be allocated

E_HBBTV_ERR HBBTV_GetPrefCountryId	(	U8BIT **	lang_string,
		U32BIT *	size
	)

Retrieves a string containing the three character string representing country code identifying the country in which the receiver is deployed. The returned string must be freed with HBBTV_ReleaseLangString.

Parameters

lang_string	Pointer to the returned string
size	Pointer to the number of bytes in the returned string

Returns

- HBBTV_OK on success

HBBTV_ERR_BAD_PARAMETER invalid parameter
HBBTV_ERR_ALLOCATING_MEMORYThe string couldn't be allocated

E_HBBTV_ERR HBBTV_GetPrefSubtLang	(	U8BIT **	lang_string,
		U32BIT *	size
	)

Retrieves a string containing a comma-separated set of languages to be used for subtitles, in order of preference. The returned string must be freed with HBBTV_ReleaseLangString.

Parameters

lang_string	Pointer to the returned string
size	Pointer to the number of bytes in the returned string

Returns

- HBBTV_OK on success

HBBTV_ERR_BAD_PARAMETER invalid parameter
HBBTV_ERR_ALLOCATING_MEMORYThe string couldn't be allocated

BOOLEAN HBBTV_GetSpeechDescriptionEnabled ( void )

Returns the speech description status. This function is used by the HbbTV engine only if support for speech description has been signalled in the S_HBBTV_SYSTEM_INFO structure. The correct implementation of this function is not required for HbbTV 1.2.1, it is used to implement the Configuration speechDescriptionEnabled property as defined in Freesat OPAL v1.0 section 8.4.1.2.

Returns

BOOLEAN HBBTV_GetVoiceControlEnabled ( void )

Returns the voice control status. This function is used by the HbbTV engine only if support for voice control has been signalled in the S_HBBTV_SYSTEM_INFO structure. The correct implementation of this function is not required for HbbTV 1.2.1, it is used to implement the Configuration voiceControlEnable property as defined in Freesat OPAL v1.0 section 8.4.1.3.

Returns

void HBBTV_ReleaseDeliverySystemsString ( U8BIT * systems )

Frees the Broadacast Delivery Systems string, returned by HBBTV_GetDeliverySystemsString.

Parameters

systems Pointer to string to be freed

void HBBTV_ReleaseLangString ( U8BIT * lang_string )

Frees the string obtained from HBBTV_GetPrefAudioLang, HBBTV_GetPrefSubtLang, HBBTV_GetPrefUiLang or HBBTV_GetPrefCountryId.

Parameters

lang_string Pointer to string to be freed

Macros

Functions

Detailed Description

Function Documentation