Application configuration. More...

#include "techtype.h"
#include "stbdpc.h"

Data Structures
struct	ana_rf_channel_data

struct	ter_rf_channel_data

struct	cab_rf_channel_data

Macros
#define	ACFG_INVALID_REGION 255

#define	ACFG_INVALID_LANG 255

#define	COUNTRY_CODE_ARGENTINA (U32BIT)(('a' << 16) \| ('r' << 8) \| 'g')

#define	COUNTRY_CODE_AUSTRALIA (U32BIT)(('a' << 16) \| ('u' << 8) \| 's')

#define	COUNTRY_CODE_AUSTRIA (U32BIT)(('a' << 16) \| ('u' << 8) \| 't')

#define	COUNTRY_CODE_BELGIUM (U32BIT)(('b' << 16) \| ('e' << 8) \| 'l')

#define	COUNTRY_CODE_BOLIVIA (U32BIT)(('b' << 16) \| ('o' << 8) \| 'l')

#define	COUNTRY_CODE_BRAZIL (U32BIT)(('b' << 16) \| ('r' << 8) \| 'a')

#define	COUNTRY_CODE_CHILE (U32BIT)(('c' << 16) \| ('h' << 8) \| 'l')

#define	COUNTRY_CODE_CHINA (U32BIT)(('c' << 16) \| ('h' << 8) \| 'i')

#define	COUNTRY_CODE_COLOMBIA (U32BIT)(('c' << 16) \| ('o' << 8) \| 'l')

#define	COUNTRY_CODE_COSTARICA (U32BIT)(('c' << 16) \| ('r' << 8) \| 'i')

#define	COUNTRY_CODE_CROATIA (U32BIT)(('h' << 16) \| ('r' << 8) \| 'v')

#define	COUNTRY_CODE_CZECHREP (U32BIT)(('c' << 16) \| ('z' << 8) \| 'e')

#define	COUNTRY_CODE_DOMINICANREP (U32BIT)(('d' << 16) \| ('m' << 8) \| 'a')

#define	COUNTRY_CODE_ECUADOR (U32BIT)(('e' << 16) \| ('c' << 8) \| 'u')

#define	COUNTRY_CODE_ELSALVADOR (U32BIT)(('s' << 16) \| ('l' << 8) \| 'v')

#define	COUNTRY_CODE_FINLAND (U32BIT)(('f' << 16) \| ('i' << 8) \| 'n')

#define	COUNTRY_CODE_FRANCE (U32BIT)(('f' << 16) \| ('r' << 8) \| 'a')

#define	COUNTRY_CODE_GERMANY (U32BIT)(('d' << 16) \| ('e' << 8) \| 'u')

#define	COUNTRY_CODE_GUATEMALA (U32BIT)(('g' << 16) \| ('t' << 8) \| 'm')

#define	COUNTRY_CODE_HONDURAS (U32BIT)(('h' << 16) \| ('n' << 8) \| 'd')

#define	COUNTRY_CODE_HUNGARY (U32BIT)(('h' << 16) \| ('u' << 8) \| 'n')

#define	COUNTRY_CODE_ITALY (U32BIT)(('i' << 16) \| ('t' << 8) \| 'a')

#define	COUNTRY_CODE_LATVIA (U32BIT)(('l' << 16) \| ('v' << 8) \| 'a')

#define	COUNTRY_CODE_LUXEMBOURG (U32BIT)(('l' << 16) \| ('u' << 8) \| 'x')

#define	COUNTRY_CODE_MEXICO (U32BIT)(('m' << 16) \| ('e' << 8) \| 'x')

#define	COUNTRY_CODE_NETHERLANDS (U32BIT)(('n' << 16) \| ('l' << 8) \| 'd')

#define	COUNTRY_CODE_NICARAGUA (U32BIT)(('n' << 16) \| ('i' << 8) \| 'c')

#define	COUNTRY_CODE_PANAMA (U32BIT)(('p' << 16) \| ('a' << 8) \| 'n')

#define	COUNTRY_CODE_PERU (U32BIT)(('p' << 16) \| ('e' << 8) \| 'r')

#define	COUNTRY_CODE_POLAND (U32BIT)(('p' << 16) \| ('o' << 8) \| 'l')

#define	COUNTRY_CODE_PORTUGAL (U32BIT)(('p' << 16) \| ('o' << 8) \| 'r')

#define	COUNTRY_CODE_RUSSIA (U32BIT)(('r' << 16) \| ('u' << 8) \| 's')

#define	COUNTRY_CODE_SERBIA (U32BIT)(('s' << 16) \| ('r' << 8) \| 'b')

#define	COUNTRY_CODE_SLOVAKIA (U32BIT)(('s' << 16) \| ('v' << 8) \| 'k')

#define	COUNTRY_CODE_SLOVENIA (U32BIT)(('s' << 16) \| ('v' << 8) \| 'n')

#define	COUNTRY_CODE_SOUTHAFRICA (U32BIT)(('z' << 16) \| ('a' << 8) \| 'f')

#define	COUNTRY_CODE_SPAIN (U32BIT)(('e' << 16) \| ('s' << 8) \| 'p')

#define	COUNTRY_CODE_SWEDEN (U32BIT)(('s' << 16) \| ('w' << 8) \| 'e')

#define	COUNTRY_CODE_SWITZERLAND (U32BIT)(('c' << 16) \| ('h' << 8) \| 'e')

#define	COUNTRY_CODE_UK (U32BIT)(('g' << 16) \| ('b' << 8) \| 'r')

#define	COUNTRY_CODE_UKRAINE (U32BIT)(('u' << 16) \| ('k' << 8) \| 'r')

#define	COUNTRY_CODE_VENEZUELA (U32BIT)(('v' << 16) \| ('e' << 8) \| 'n')

#define	ENGLISH_LANG_CODE (('e' << 16) \| ('n' << 8) \| 'g')

#define	WELSH1_LANG_CODE (('w' << 16) \| ('e' << 8) \| 'l')

#define	WELSH2_LANG_CODE (('c' << 16) \| ('y' << 8) \| 'm')

#define	GAELIC_LANG_CODE (('g' << 16) \| ('l' << 8) \| 'a')

#define	IRISH_LANG_CODE (('g' << 16) \| ('l' << 8) \| 'e')

#define	DUTCH1_LANG_CODE (('n' << 16) \| ('l' << 8) \| 'd')

#define	DUTCH2_LANG_CODE (('d' << 16) \| ('u' << 8) \| 't')

#define	GERMAN1_LANG_CODE (('g' << 16) \| ('e' << 8) \| 'r')

#define	GERMAN2_LANG_CODE (('d' << 16) \| ('e' << 8) \| 'u')

#define	FRENCH1_LANG_CODE (('f' << 16) \| ('r' << 8) \| 'e')

#define	FRENCH2_LANG_CODE (('f' << 16) \| ('r' << 8) \| 'a')

#define	RUSSIAN_LANG_CODE (('r' << 16) \| ('u' << 8) \| 's')

#define	SIMPLIFIED_CHINESE_LANG_CODE (('c' << 16) \| ('h' << 8) \| 'i')

#define	TRADITIONAL_CHINESE_LANG_CODE (('c' << 16) \| ('h' << 8) \| 'i')

#define	FINNISH_LANG_CODE (('f' << 16) \| ('i' << 8) \| 'n')

#define	SWEDISH_LANG_CODE (('s' << 16) \| ('w' << 8) \| 'e')

#define	NORWEGIAN_LANG_CODE (('n' << 16) \| ('o' << 8) \| 'r')

#define	DANISH_LANG_CODE (('d' << 16) \| ('a' << 8) \| 'n')

#define	MANDARIN_LANG_CODE (('c' << 16) \| ('m' << 8) \| 'n')

#define	CANTONESE_LANG_CODE (('y' << 16) \| ('u' << 8) \| 'e')

#define	MAORI1_LANG_CODE (('m' << 16) \| ('a' << 8) \| 'o')

#define	MAORI2_LANG_CODE (('m' << 16) \| ('r' << 8) \| 'i')

#define	JAPANESE_LANG_CODE (('j' << 16) \| ('p' << 8) \| 'n')

#define	ITALIAN_LANG_CODE (('i' << 16) \| ('t' << 8) \| 'a')

#define	SPANISH1_LANG_CODE (('s' << 16) \| ('p' << 8) \| 'a')

#define	SPANISH2_LANG_CODE (('e' << 16) \| ('s' << 8) \| 'l')

#define	KOREAN_LANG_CODE (('k' << 16) \| ('o' << 8) \| 'r')

#define	HINDI_LANG_CODE (('h' << 16) \| ('i' << 8) \| 'n')

#define	CZECH1_LANG_CODE (('c' << 16) \| ('z' << 8) \| 'e')

#define	CZECH2_LANG_CODE (('c' << 16) \| ('e' << 8) \| 's')

#define	SLOVAK1_LANG_CODE (('s' << 16) \| ('l' << 8) \| 'k')

#define	SLOVAK2_LANG_CODE (('s' << 16) \| ('l' << 8) \| 'o')

#define	AFRIKAANS_LANG_CODE (('a' << 16) \| ('f' << 8) \| 'r')

#define	NDEBELE_LANG_CODE (('n' << 16) \| ('b' << 8) \| 'l')

#define	NORTHERN_SOTHO_LANG_CODE (('n' << 16) \| ('s' << 8) \| 'o')

#define	SOUTHERN_SOTHO_LANG_CODE (('s' << 16) \| ('o' << 8) \| 't')

#define	SWATI_LANG_CODE (('s' << 16) \| ('s' << 8) \| 'w')

#define	TSONGA_LANG_CODE (('t' << 16) \| ('s' << 8) \| 'o')

#define	TSWANA_LANG_CODE (('t' << 16) \| ('s' << 8) \| 'n')

#define	VENDA_LANG_CODE (('v' << 16) \| ('e' << 8) \| 'n')

#define	XHOSA_LANG_CODE (('x' << 16) \| ('h' << 8) \| 'o')

#define	ZULU_LANG_CODE (('z' << 16) \| ('u' << 8) \| 'l')

#define	CROATIAN_LANG_CODE (('h' << 16) \| ('r' << 8) \| 'v')

#define	HUNGARIAN_LANG_CODE (('h' << 16) \| ('u' << 8) \| 'n')

#define	LATVIAN_LANG_CODE (('l' << 16) \| ('a' << 8) \| 'v')

#define	LUXEMBOURGISH_LANG_CODE (('l' << 16) \| ('t' << 8) \| 'z')

#define	POLISH_LANG_CODE (('p' << 16) \| ('o' << 8) \| 'l')

#define	PORTUGUESE_LANG_CODE (('p' << 16) \| ('o' << 8) \| 'r')

#define	SERBIAN_LANG_CODE (('s' << 16) \| ('r' << 8) \| 'p')

#define	ROMANIAN1_LANG_CODE (('r' << 16) \| ('o' << 8) \| 'n')

#define	ROMANIAN2_LANG_CODE (('r' << 16) \| ('u' << 8) \| 'm')

#define	ALBANIAN1_LANG_CODE (('s' << 16) \| ('q' << 8) \| 'i')

#define	ALBANIAN2_LANG_CODE (('a' << 16) \| ('l' << 8) \| 'b')

#define	SLOVENE_LANG_CODE (('s' << 16) \| ('l' << 8) \| 'v')

#define	CATALAN_LANG_CODE (('c' << 16) \| ('a' << 8) \| 't')

#define	GALICIAN_LANG_CODE (('g' << 16) \| ('l' << 8) \| 'g')

#define	BASQUE1_LANG_CODE (('e' << 16) \| ('u' << 8) \| 's')

#define	BASQUE2_LANG_CODE (('b' << 16) \| ('a' << 8) \| 'q')

#define	UKRAINIAN_LANG_CODE (('u' << 16) \| ('k' << 8) \| 'r')

#define	UND_LANG_CODE (('u' << 16) \| ('n' << 8) \| 'd')

Typedefs
typedef struct ana_rf_channel_data	ACFG_ANA_RF_CHANNEL_DATA

typedef struct ter_rf_channel_data	ACFG_TER_RF_CHANNEL_DATA

typedef struct cab_rf_channel_data	ACFG_CAB_RF_CHANNEL_DATA

typedef BOOLEAN(*	AllocLcnFunc )(E_STB_DP_SIGNAL_TYPE tuner_type)

typedef void(*	DBTidyFunc )(E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)

Enumerations
enum	E_DB_LANGS { ACFG_DB_LANG_ENGLISH, ACFG_DB_LANG_WELSH1, ACFG_DB_LANG_WELSH2, ACFG_DB_LANG_GAELIC, ACFG_DB_LANG_IRISH, ACFG_DB_LANG_DUTCH1, ACFG_DB_LANG_DUTCH2, ACFG_DB_LANG_GERMAN1, ACFG_DB_LANG_GERMAN2, ACFG_DB_LANG_FRENCH1, ACFG_DB_LANG_FRENCH2, ACFG_DB_LANG_RUSSIAN, ACFG_DB_LANG_SIMPLIFIED_CHINESE, ACFG_DB_LANG_TRADITIONAL_CHINESE, ACFG_DB_LANG_FINNISH, ACFG_DB_LANG_SWEDISH, ACFG_DB_LANG_NORWEGIAN, ACFG_DB_LANG_DANISH, ACFG_DB_LANG_MANDARIN, ACFG_DB_LANG_CANTONESE, ACFG_DB_LANG_MAORI1, ACFG_DB_LANG_MAORI2, ACFG_DB_LANG_JAPANESE, ACFG_DB_LANG_ITALIAN, ACFG_DB_LANG_SPANISH1, ACFG_DB_LANG_SPANISH2, ACFG_DB_LANG_KOREAN, ACFG_DB_LANG_HINDI, ACFG_DB_LANG_CZECH1, ACFG_DB_LANG_CZECH2, ACFG_DB_LANG_SLOVAK1, ACFG_DB_LANG_SLOVAK2, ACFG_DB_LANG_AFRIKAANS, ACFG_DB_LANG_NDEBELE, ACFG_DB_LANG_NORTHERN_SOTHO, ACFG_DB_LANG_SOUTHERN_SOTHO, ACFG_DB_LANG_SWATI, ACFG_DB_LANG_TSONGA, ACFG_DB_LANG_TSWANA, ACFG_DB_LANG_VENDA, ACFG_DB_LANG_XHOSA, ACFG_DB_LANG_ZULU, ACFG_DB_LANG_CROATIAN, ACFG_DB_LANG_HUNGARIAN, ACFG_DB_LANG_LATVIAN, ACFG_DB_LANG_LUXEMBOURGISH, ACFG_DB_LANG_POLISH, ACFG_DB_LANG_PORTUGUESE, ACFG_DB_LANG_SERBIAN, ACFG_DB_LANG_ROMANIAN1, ACFG_DB_LANG_ROMANIAN2, ACFG_DB_LANG_ALBANIAN1, ACFG_DB_LANG_ALBANIAN2, ACFG_DB_LANG_SLOVENE, ACFG_DB_LANG_CATALAN, ACFG_DB_LANG_GALICIAN, ACFG_DB_LANG_BASQUE1, ACFG_DB_LANG_BASQUE2, ACFG_DB_LANG_UKRAINIAN, ACFG_DB_LANG_UND, ACFG_NUM_DB_LANGUAGES }

Functions
U8BIT	ACFG_GetNumCountries (void)
	Returns the number of country configurations included in the DVB stack. More...

U32BIT	ACFG_GetCountry (void)
	Returns the country code the DVB is configured for. More...

void	ACFG_GetCountryList (U8BIT **str_array_ptr, U8BIT num_countries_ptr)
	Returns an array containing the names of all the countries included in the DVB. The index into this array is referred to as the country_id. The returned array should be freed using ACFG_ReleaseCountryList. More...

void	ACFG_ReleaseCountryList (U8BIT **str_array, U8BIT num_countries)
	Frees a country list previously acquired using ACFG_GetCountryList. More...

U8BIT	ACFG_GetNumRegions (U32BIT country_code)
	Returns the number of regions in the given country. More...

BOOLEAN	ACFG_GetRegionList (U32BIT country_code, U8BIT **str_array_ptr, U8BIT num_regions_ptr)
	Returns an array of pointers to strings containing the region names for the given country. The index into this array is the region_id. The array is allocated by this function and should be freed using ACFG_ReleaseRegionList. More...

BOOLEAN	ACFG_GetRegionCode (U32BIT country_code, U8BIT region_id, U8BIT *code_ptr)
	Returns the region code that identifies the given region. More...

void	ACFG_ReleaseRegionList (U8BIT **str_array, U8BIT num_regions)
	Frees the region array previously acquired using ACFG_GetRegionList. More...

U8BIT	ACFG_GetCountryIndex (U32BIT country_code)
	Returns the index in the list of countries known by the DVB, of the given country. More...

U8BIT	ACFG_GetRegionId (void)
	Returns the internal ID of the region the DVB is configured for. More...

BOOLEAN	ACFG_SetCountry (U32BIT country_code)
	Sets the current country and sets default values for region and language. More...

U8BIT	ACFG_GetNumDbLanguages (U32BIT country_code)
	Returns the number of languages defined for the given country that can be used for audio and subtitles/teletext. More...

BOOLEAN	ACFG_GetDbLangList (U32BIT country_code, U8BIT **str_array_ptr, U8BIT num_langs_ptr)
	Returns an array of pointers to strings containing the available language names for the given country. The index into this array is the lang_id used when getting and setting audio and text language ids. The array is allocated by this function and should be freed using ACFG_ReleaseDbLangList. More...

U8BIT *	ACFG_GetDbLangId (U32BIT country_code, U8BIT lang_entry)
	Returns an array of language ids for a given country and index into the language array. A language id is one of the ACFG_DB_LANG_XXXX values above and there might be more than one for a given language. For example german language has two ids associated to it: ACFG_DB_LANG_GERMAN1 and ACFG_DB_LANG_GERMAN2 because german language can have two different codes, 'deu' and 'ger'. See also functions ACFG_ConvertLangIdToCode and ACFG_ConvertLangCodeToId. The returned pointer is an internal array and must not be freed. More...

void	ACFG_ReleaseDbLangList (U8BIT **str_array, U8BIT num_langs)
	Frees the language array previously acquired using ACFG_GetDbLangList. More...

U8BIT	ACFG_ConvertLangCodeToId (U32BIT lang_code)
	Returns the language id for the given language code. More...

U32BIT	ACFG_ConvertLangIdToCode (U8BIT lang_id)
	Returns the language code for the given language id. More...

void	ACFG_SetCountryIds (U32BIT country_code, U8BIT region_id, U8BIT audio_lang_id, U8BIT sub_lang_id)
	Saves the configured country and changes settings related to the country. More...

U8BIT	ACFG_GetPrimaryAudioLangId (void)
	Returns the primary audio language ID. More...

U8BIT	ACFG_GetSecondaryAudioLangId (void)
	Returns the secondary audio language ID. More...

U8BIT	ACFG_GetPrimaryTextLangId (void)
	Returns the primary DVB subtitle/teletext language ID. More...

U8BIT	ACFG_GetSecondaryTextLangId (void)
	Returns the secondary DVB subtitle/teletext language ID. More...

void	ACFG_SetPrimaryAudioLangId (U8BIT lang_id)
	Sets the primary language id to be used for audio. This is the language that will be chosen first, if available. More...

void	ACFG_SetSecondaryAudioLangId (U8BIT lang_id)
	Sets the secondary language id to be used for audio. More...

void	ACFG_SetPrimaryTextLangId (U8BIT lang_id)
	Sets the primary language id to be used for teletext/subtitles. More...

void	ACFG_SetSecondaryTextLangId (U8BIT lang_id)
	Sets the secondary language id to be used for teletext/subtitles. More...

U8BIT	ACFG_GetDefaultSecondaryLangId (void)
	Returns the default secondary language for audio and subtitles as defined for the selected country. This is used for countries that don't use the secondary language, but expect a defined language to be used if the primary one isn't available. More...

BOOLEAN	ACFG_GetAnaRfChannelTable (U32BIT country_code, ACFG_ANA_RF_CHANNEL_DATA *rf_chan_data_ptr, U16BIT num_entries_ptr)
	Returns a pointer to the channel table for an analog tuner for the given country. More...

BOOLEAN	ACFG_GetTerRfChannelTable (U32BIT country_code, ACFG_TER_RF_CHANNEL_DATA *rf_chan_data_ptr, U16BIT num_entries_ptr)
	Returns a pointer to the channel table for a terrestrial tuner for the given country. More...

BOOLEAN	ACFG_GetCabRfChannelTable (U32BIT country_code, ACFG_CAB_RF_CHANNEL_DATA *rf_chan_data_ptr, U16BIT num_entries_ptr)
	Returns a pointer to the channel table for a cable tuner for the given country. More...

void	ACFG_SetCableChannelTable (ACFG_CAB_RF_CHANNEL_DATA *cable_channel_data, U16BIT number_channels)
	Replaces the cable tuning table for the current country with the one provided. More...

U32BIT	ACFG_GetCountryCode (U8BIT country_id)
	Returns the country code for the given country index. More...

U32BIT	ACFG_GetPrivateDataSpecifier (U32BIT country_code)
	Returns the private data specifier value for the given country. More...

U16BIT	ACFG_GetFirstUnallocatedLcn (U32BIT country_code)
	Returns the first LCN that should be used when assigning LCNs to services that don't appear in an LCN descriptor, or can't be assigned their desired LCN. More...

U16BIT	ACFG_GetLastUnallocatedLcn (U32BIT country_code)
	Returns the last LCN that should be used when assigning LCNs to services that don't appear in an LCN descriptor, or can't be assigned their desired LCN. More...

BOOLEAN	ACFG_GetWatershedTimes (U32BIT country_code, U16BIT start_time, U16BIT end_time)
	Get the start and end times of the watershed hours for a country. More...

U16BIT	ACFG_GetMinSatelliteScanFreq (U32BIT country_code)
	Returns the minimum frequency to be used when performing a satellite based frequency scan in the given country. More...

U16BIT	ACFG_GetMaxSatelliteScanFreq (U32BIT country_code)
	Returns the maximum frequency to be used when performing a satellite based frequency scan in the given country. More...

U16BIT	ACFG_GetSatelliteScanFreqInc (U32BIT country_code)
	Returns the increment frequency to be used when performing a satellite based frequency scan in the given country. More...

U16BIT *	ACFG_GetSatelliteScanSymbolRates (U32BIT country_code)
	Returns a fixed array of symbol rates to be used when performing a satellite based frequency scan in the given country. More...

U8BIT	ACFG_GetSatelliteScanNumSymbolRates (U32BIT country_code)
	Returns the number of items in the fixed array of symbol rates to be used when performing a satellite based frequency scan in the given country. More...

BOOLEAN	ACFG_GetSatelliteScanDvbS2 (U32BIT country_code)
	Returns whether DVB-S2 should be included when performing a satellite based frequency scan in the given country. More...

BOOLEAN	ACFG_GetAerialPowerOptionReqd (U32BIT country_code)
	Returns whether the aerial power option is required for DVB-T/T2 for the given country. More...

BOOLEAN	ACFG_GetDefaultAerialPower (U32BIT country_code)
	Returns the default aerial power option setting for DVB-T/T2 for the given country. More...

BOOLEAN	ACFG_GetAerialTuningScreenReqd (U32BIT country_code)
	Returns whether an aerial tuning screen should be presented by the interface before performing a DVB-T/T2 scan for services for the given country. More...

U8BIT *	ACFG_GetEventContentTypes (U32BIT country_code)
	Returns the event content types for the given country. This defines how the content type value broadcast as part of the EIT is to be interpreted. More...

void	ACFG_SetBackgroundSearchTime (U16BIT start_time, U16BIT end_time)
	Sets the start and end times during which background searches are allowed run when in standby. More...

void	ACFG_GetBackgroundSearchTime (U16BIT start_time, U16BIT end_time)
	Gets the background start and end search times. More...

void	ACFG_SetBackgroundServiceSearch (BOOLEAN enabled)
	Enables or disables the background service search when in standby. More...

BOOLEAN	ACFG_GetBackgroundServiceSearch (void)
	Returns whether the background service search is enabled or not. More...

void	ACFG_SetBackgroundSSUSearch (BOOLEAN enabled)
	Enables or disables the background SSU search when in standby. More...

BOOLEAN	ACFG_GetBackgroundSSUSearch (void)
	Returns whether the background SSU search is enabled or not. More...

BOOLEAN	ACFG_IsNordigCountry (void)
	Returns whether the current country requires Nordig compliance for SI. More...

U8BIT	ACFG_GetEitUpdateTime (void)
	Returns the number of minutes after which all the events should have been received during an EIT search. This is the EIT repetition time. More...

U8BIT	ACFG_GetEitSearchesPerDay (void)
	Returns the number of EIT searches that should be performed per day when the box is in standby. More...

AllocLcnFunc	ACFG_GetTerrestrialLcnFunction (U32BIT country_code)
	Returns a pointer to a function that's used to assign LCNs following a DVB-T/T2 scan for the given country. More...

void	ACFG_SetTerrestrialLcnFunction (U32BIT country_code, AllocLcnFunc func_ptr)
	Overrides an existing DVB-T/T2 LCN allocation function for the given country. More...

AllocLcnFunc	ACFG_GetCableLcnFunction (U32BIT country_code)
	Returns a pointer to a function that's used to assign LCNs following a DVB-C scan for the given country. More...

void	ACFG_SetCableLcnFunction (U32BIT country_code, AllocLcnFunc func_ptr)
	Overrides an existing DVB-C LCN allocation function for the given country. More...

AllocLcnFunc	ACFG_GetSatelliteLcnFunction (U32BIT country_code)
	Returns a pointer to a function that's used to assign LCNs following a DVB-S/S2 scan for the given country. More...

void	ACFG_SetSatelliteLcnFunction (U32BIT country_code, AllocLcnFunc func_ptr)
	Overrides an existing DVB-S/S2 LCN allocation function for the given country. More...

DBTidyFunc	ACFG_GetTerrestrialDBTidyFunction (U32BIT country_code)
	Returns a pointer to a function that's used to tidy up the database following a DVB-T/T2 scan for the given country. More...

DBTidyFunc	ACFG_GetCableDBTidyFunction (U32BIT country_code)
	Returns a pointer to a function that's used to tidy up the database following a DVB-C scan for the given country. More...

DBTidyFunc	ACFG_GetSatelliteDBTidyFunction (U32BIT country_code)
	Returns a pointer to a function that's used to tidy up the database following a DVB-S/S2 scan for the given country. More...

void	ACFG_SetUndefinedLanguageBehaviour (U32BIT lang_code)
	Sets the language code to be used when the SI descriptors contain 'und', 'qaa' or don't contain any language descriptors. More...

U32BIT	ACFG_GetUndefinedLanguageBehaviour (void)
	Gets the language code set by ACFG_SetUndefinedLanguageBehaviour, or 'und' if that function has not been called. More...

void	ACFG_SetHostCountryLanguageModuleId (U32BIT module)
	Sets the host and country module for CI stack. Value zero for disable. More...

Detailed Description

Application configuration.

Date: 5/04/2004

Author: Ocean Blue

Function Documentation

U8BIT ACFG_ConvertLangCodeToId ( U32BIT lang_code )

Returns the language id for the given language code.

Parameters

lang_code language code

Returns: language id, or ACFG_INVALID_LANG if language code isn't found

U32BIT ACFG_ConvertLangIdToCode ( U8BIT lang )

Returns the language code for the given language id.

Parameters

lang_id language id

Returns: language code, or 0 if language id isn't valid

BOOLEAN ACFG_GetAerialPowerOptionReqd ( U32BIT country_code )

Returns whether the aerial power option is required for DVB-T/T2 for the given country.

Parameters

country_code country code

Returns: TRUE if required, FALSE otherwise

BOOLEAN ACFG_GetAerialTuningScreenReqd ( U32BIT country_code )

Returns whether an aerial tuning screen should be presented by the interface before performing a DVB-T/T2 scan for services for the given country.

Parameters

country_code country code

Returns: TRUE if required, FALSE otherwise

BOOLEAN ACFG_GetAnaRfChannelTable	(	U32BIT	country_code,
		ACFG_ANA_RF_CHANNEL_DATA **	rf_chan_data_ptr,
		U16BIT *	num_entries_ptr
	)

Returns a pointer to the channel table for an analog tuner for the given country.

Parameters

country_code	country whose table is to be returned
rf_chan_data_ptr	returned pointer to the channel table
num_entries_ptr	number of entries in the returned channel table

Returns: TRUE if the country is valid and data is returned, FALSE otherwise

void ACFG_GetBackgroundSearchTime	(	U16BIT *	start_time,
		U16BIT *	end_time
	)

Gets the background start and end search times.

Parameters

start_time	return start time in minutes since midnight
end_time	return end time in minutes

BOOLEAN ACFG_GetBackgroundServiceSearch ( void )

Returns whether the background service search is enabled or not.

Returns: TRUE if enabled, FALSE otherwise

BOOLEAN ACFG_GetBackgroundSSUSearch ( void )

Returns whether the background SSU search is enabled or not.

Returns: TRUE if enabled, FALSE otherwise

DBTidyFunc ACFG_GetCableDBTidyFunction ( U32BIT country_code )

Returns a pointer to a function that's used to tidy up the database following a DVB-C scan for the given country.

Parameters

country_code country code

Returns: pointer to function, or NULL

Parameters

country_code country code

Returns: pointer to functions, or NULL

AllocLcnFunc ACFG_GetCableLcnFunction ( U32BIT country_code )

Returns a pointer to a function that's used to assign LCNs following a DVB-C scan for the given country.

Parameters

country_code country id

Returns: pointer to function, or NULL

Parameters

country_code country code

Returns: pointer to functions, or NULL

BOOLEAN ACFG_GetCabRfChannelTable	(	U32BIT	country_code,
		ACFG_CAB_RF_CHANNEL_DATA **	rf_chan_data_ptr,
		U16BIT *	num_entries_ptr
	)

Returns a pointer to the channel table for a cable tuner for the given country.

Parameters

country_code	country whose table is to be returned
rf_chan_data_ptr	returned pointer to the channel table
num_entries_ptr	number of entries in the returned channel table

Returns: TRUE if the country is valid and data is returned, FALSE otherwise

U32BIT ACFG_GetCountry ( void )

Returns the country code the DVB is configured for.

Returns: country code

U32BIT ACFG_GetCountryCode ( U8BIT country_id )

Returns the country code for the given country index.

Parameters

country_id country index

Returns: country code, or 0 if country id isn't valid

U8BIT ACFG_GetCountryIndex ( U32BIT country_code )

Returns the index in the list of countries known by the DVB, of the given country.

Parameters

country_code country code

Returns: country index, NUM_COUNTRIES if the country isn't found

void ACFG_GetCountryList	(	U8BIT ***	str_array_ptr,
		U8BIT *	num_countries_ptr
	)

Returns an array containing the names of all the countries included in the DVB. The index into this array is referred to as the country_id. The returned array should be freed using ACFG_ReleaseCountryList.

Parameters

str_array_ptr	pointer to an allocated array of static UTF-8 strings
num_countries_ptr	pointer to the number of countries in the returned array

U8BIT* ACFG_GetDbLangId	(	U32BIT	country_code,
		U8BIT	lang_entry
	)

Returns an array of language ids for a given country and index into the language array. A language id is one of the ACFG_DB_LANG_XXXX values above and there might be more than one for a given language. For example german language has two ids associated to it: ACFG_DB_LANG_GERMAN1 and ACFG_DB_LANG_GERMAN2 because german language can have two different codes, 'deu' and 'ger'. See also functions ACFG_ConvertLangIdToCode and ACFG_ConvertLangCodeToId. The returned pointer is an internal array and must not be freed.

Parameters

country_code	country code
lang_entry	index into the language array

Returns: pointer to the array of language ids, or NULL if either of the indices are invalid.

BOOLEAN ACFG_GetDbLangList	(	U32BIT	country_code,
		U8BIT ***	str_array_ptr,
		U8BIT *	num_langs_ptr
	)

Returns an array of pointers to strings containing the available language names for the given country. The index into this array is the lang_id used when getting and setting audio and text language ids. The array is allocated by this function and should be freed using ACFG_ReleaseDbLangList.

Parameters

country_code	country code
str_array_ptr	pointer to an allocated array of static UTF-8 strings
num_langs_ptr	pointer to the number of languages in the returned array

Returns: TRUE if the country_code is valid

Parameters

country_code	country code
str_array_ptr	pointer to an allocated array of static UTF-8 strings
num_langs_ptr	pointer to the number of languages in the returned array

Returns: TRUE if the country_id is valid

BOOLEAN ACFG_GetDefaultAerialPower ( U32BIT country_code )

Returns the default aerial power option setting for DVB-T/T2 for the given country.

Parameters

country_code country code

Returns: TRUE or FALSE

U8BIT ACFG_GetDefaultSecondaryLangId ( void )

Returns the default secondary language for audio and subtitles as defined for the selected country. This is used for countries that don't use the secondary language, but expect a defined language to be used if the primary one isn't available.

Returns: language id, or ACFG_INVALID_LANG when the value is not defined

U8BIT ACFG_GetEitSearchesPerDay ( void )

Returns the number of EIT searches that should be performed per day when the box is in standby.

Returns: number of times

U8BIT ACFG_GetEitUpdateTime ( void )

Returns the number of minutes after which all the events should have been received during an EIT search. This is the EIT repetition time.

Returns: time in minutes

U8BIT* ACFG_GetEventContentTypes ( U32BIT country_code )

Returns the event content types for the given country. This defines how the content type value broadcast as part of the EIT is to be interpreted.

Parameters

country_code country code

Returns: pointer to the content type array. The index of this array is level_1 from the event content descriptors in the EIT and its elements are of type ADB_EVENT_CONTENT, defined in ap_dbacc.h

U16BIT ACFG_GetFirstUnallocatedLcn ( U32BIT country_code )

Returns the first LCN that should be used when assigning LCNs to services that don't appear in an LCN descriptor, or can't be assigned their desired LCN.

Parameters

country_code country code

Returns: LCN; 0 if country isn't valid

U16BIT ACFG_GetLastUnallocatedLcn ( U32BIT country_code )

Returns the last LCN that should be used when assigning LCNs to services that don't appear in an LCN descriptor, or can't be assigned their desired LCN.

Parameters

country_code country code

Returns: LCN; 0 if country isn't valid

U16BIT ACFG_GetMaxSatelliteScanFreq ( U32BIT country_code )

Returns the maximum frequency to be used when performing a satellite based frequency scan in the given country.

Parameters

country_code country code

Returns: frequency in MHz; 0 if undefined or country is invalid

U16BIT ACFG_GetMinSatelliteScanFreq ( U32BIT country_code )

Returns the minimum frequency to be used when performing a satellite based frequency scan in the given country.

Parameters

country_code country code

Returns: frequency in MHz; 0 if undefined or country is invalid

U8BIT ACFG_GetNumCountries ( void )

Returns the number of country configurations included in the DVB stack.

Returns: number of countries

U8BIT ACFG_GetNumDbLanguages ( U32BIT country_code )

Returns the number of languages defined for the given country that can be used for audio and subtitles/teletext.

Parameters

country_code country code

Returns: number of available languages

U8BIT ACFG_GetNumRegions ( U32BIT country_code )

Returns the number of regions in the given country.

Parameters

country_code country code

Returns: number of regions

U8BIT ACFG_GetPrimaryAudioLangId ( void )

Returns the primary audio language ID.

Returns: language id

U8BIT ACFG_GetPrimaryTextLangId ( void )

Returns the primary DVB subtitle/teletext language ID.

Returns: language id

U32BIT ACFG_GetPrivateDataSpecifier ( U32BIT country_code )

Returns the private data specifier value for the given country.

Parameters

country_code coutry code

Returns: private data specifier value; 0 if one isn't defined for the country or country code isn't valid

BOOLEAN ACFG_GetRegionCode	(	U32BIT	country_code,
		U8BIT	region_id,
		U8BIT *	code_ptr
	)

Returns the region code that identifies the given region.

Parameters

country_code	country code
region_id	region index
code_ptr	pointer to value in which the code will be returned

Returns: TRUE if the country and region indices are valid, FALSE otherwise

U8BIT ACFG_GetRegionId ( void )

Returns the internal ID of the region the DVB is configured for.

Returns: region id

BOOLEAN ACFG_GetRegionList	(	U32BIT	country_code,
		U8BIT ***	str_array_ptr,
		U8BIT *	num_regions_ptr
	)

Returns an array of pointers to strings containing the region names for the given country. The index into this array is the region_id. The array is allocated by this function and should be freed using ACFG_ReleaseRegionList.

Parameters

country_code	country code
str_array_ptr	pointer to an allocated array of static UTF-8 strings
num_regions_ptr	pointer to the number of regions in the returned array

Returns: TRUE if the country_code is valid

Parameters

country_code	country code
str_array_ptr	pointer to an allocated array of static UTF-8 strings
num_regions_ptr	pointer to the number of regions in the returned array

Returns: TRUE if the country_id is valid

DBTidyFunc ACFG_GetSatelliteDBTidyFunction ( U32BIT country_code )

Returns a pointer to a function that's used to tidy up the database following a DVB-S/S2 scan for the given country.

Parameters

country_code country code

Returns: pointer to function, or NULL

Parameters

country_code country code

Returns: pointer to functions, or NULL

AllocLcnFunc ACFG_GetSatelliteLcnFunction ( U32BIT country_code )

Returns a pointer to a function that's used to assign LCNs following a DVB-S/S2 scan for the given country.

Parameters

country_code country id

Returns: pointer to function, or NULL

Parameters

country_code country code

Returns: pointer to functions, or NULL

BOOLEAN ACFG_GetSatelliteScanDvbS2 ( U32BIT country_code )

Returns whether DVB-S2 should be included when performing a satellite based frequency scan in the given country.

Parameters

country_code country code

Returns: TRUE if DVB-S2 should be used, FALSE otherwise

U16BIT ACFG_GetSatelliteScanFreqInc ( U32BIT country_code )

Returns the increment frequency to be used when performing a satellite based frequency scan in the given country.

Parameters

country_code country code

Returns: frequency in MHz; 0 if undefined or country is invalid

U8BIT ACFG_GetSatelliteScanNumSymbolRates ( U32BIT country_code )

Returns the number of items in the fixed array of symbol rates to be used when performing a satellite based frequency scan in the given country.

Parameters

country_code country code

Returns: number of symbol rates; 0 if undefined or country is invalid

U16BIT* ACFG_GetSatelliteScanSymbolRates ( U32BIT country_code )

Returns a fixed array of symbol rates to be used when performing a satellite based frequency scan in the given country.

Parameters

country_code country code

Returns: array of symbol rates in Kbps; NULL if undefined or country is invalid

U8BIT ACFG_GetSecondaryAudioLangId ( void )

Returns the secondary audio language ID.

Returns: language id

U8BIT ACFG_GetSecondaryTextLangId ( void )

Returns the secondary DVB subtitle/teletext language ID.

Returns: language id

DBTidyFunc ACFG_GetTerrestrialDBTidyFunction ( U32BIT country_code )

Returns a pointer to a function that's used to tidy up the database following a DVB-T/T2 scan for the given country.

Parameters

country_code country code

Returns: pointer to function, or NULL

Parameters

country_code country code

Returns: pointer to functions, or NULL

AllocLcnFunc ACFG_GetTerrestrialLcnFunction ( U32BIT country_code )

Returns a pointer to a function that's used to assign LCNs following a DVB-T/T2 scan for the given country.

Parameters

country_code country id

Returns: pointer to function, or NULL

Parameters

country_code country code

Returns: pointer to functions, or NULL

BOOLEAN ACFG_GetTerRfChannelTable	(	U32BIT	country_code,
		ACFG_TER_RF_CHANNEL_DATA **	rf_chan_data_ptr,
		U16BIT *	num_entries_ptr
	)

Returns a pointer to the channel table for a terrestrial tuner for the given country.

Parameters

country_code	country whose table is to be returned
rf_chan_data_ptr	returned pointer to the channel table
num_entries_ptr	number of entries in the returned channel table

Returns: TRUE if the country is valid and data is returned, FALSE otherwise

U32BIT ACFG_GetUndefinedLanguageBehaviour ( void )

Gets the language code set by ACFG_SetUndefinedLanguageBehaviour, or 'und' if that function has not been called.

Returns: Language code currently used when the SI descriptors don't define a language

BOOLEAN ACFG_GetWatershedTimes	(	U32BIT	country_code,
		U16BIT *	start_time,
		U16BIT *	end_time
	)

Get the start and end times of the watershed hours for a country.

Parameters

country_code	country code
start_time	returns the start time in minutes since midnight
end_time	returns the end time in minutes since midnight

Returns: TRUE if the start and end times are valid and have been returned, FALSE otherwise

BOOLEAN ACFG_IsNordigCountry ( void )

Returns whether the current country requires Nordig compliance for SI.

Returns: TRUE if Nordig, FALSE otherwise

void ACFG_ReleaseCountryList	(	U8BIT **	str_array,
		U8BIT	num_countries
	)

Frees a country list previously acquired using ACFG_GetCountryList.

Parameters

str_array	array to be freed
num_countries	number of items in the array

void ACFG_ReleaseDbLangList	(	U8BIT **	str_array,
		U8BIT	num_langs
	)

Frees the language array previously acquired using ACFG_GetDbLangList.

Parameters

str_array	array of lang names to be freed
num_langs	number of names in the array

void ACFG_ReleaseRegionList	(	U8BIT **	str_array,
		U8BIT	num_regions
	)

Frees the region array previously acquired using ACFG_GetRegionList.

Parameters

str_array	array to be freed
num_regions	number of items in the array

void ACFG_SetBackgroundSearchTime	(	U16BIT	start_time,
		U16BIT	end_time
	)

Sets the start and end times during which background searches are allowed run when in standby.

Parameters

start_time	start time in minutes since midnight
end_time	end time in minutes

void ACFG_SetBackgroundServiceSearch ( BOOLEAN enabled )

Enables or disables the background service search when in standby.

Parameters

enabled TRUE to enable, FALSE to disable

void ACFG_SetBackgroundSSUSearch ( BOOLEAN enabled )

Enables or disables the background SSU search when in standby.

Parameters

enabled TRUE to enable, FALSE to disable

void ACFG_SetCableChannelTable	(	ACFG_CAB_RF_CHANNEL_DATA *	cable_channel_data,
		U16BIT	number_channels
	)

Replaces the cable tuning table for the current country with the one provided.

Parameters

cable_channel_data	pointer to the new table to point
number_channels	number of entries in the channel table

void ACFG_SetCableLcnFunction	(	U32BIT	country_code,
		AllocLcnFunc	func_ptr
	)

Overrides an existing DVB-C LCN allocation function for the given country.

Parameters

country_code	country id
pointer	to function, can be NULL if no function is to be called
country_code	country code
pointer	to function, can be NULL if no function is to be called

BOOLEAN ACFG_SetCountry ( U32BIT country_code )

Sets the current country and sets default values for region and language.

Parameters

country_code country code, as defined above (see COUNTRY_CODE_* defines)

Returns: TRUE if country is known, FALSE otherwise

void ACFG_SetCountryIds	(	U32BIT	country_code,
		U8BIT	region_id,
		U8BIT	audio_lang_id,
		U8BIT	sub_lang_id
	)

Saves the configured country and changes settings related to the country.

Parameters

country_code	country code
region_id	ID of region in country, if appropriate
audio_lang_id	ID of language to be used for audio
sub_lang_id	ID of language to be used for subtitles/teletext

void ACFG_SetHostCountryLanguageModuleId ( U32BIT module )

Sets the host and country module for CI stack. Value zero for disable.

Parameters

module Module Id given by CI stack

void ACFG_SetPrimaryAudioLangId ( U8BIT lang_id )

Sets the primary language id to be used for audio. This is the language that will be chosen first, if available.

Parameters

lang_id language id

void ACFG_SetPrimaryTextLangId ( U8BIT lang_id )

Sets the primary language id to be used for teletext/subtitles.

Parameters

lang_id language id

void ACFG_SetSatelliteLcnFunction	(	U32BIT	country_code,
		AllocLcnFunc	func_ptr
	)

Overrides an existing DVB-S/S2 LCN allocation function for the given country.

Parameters

country_code	country id
pointer	to function, can be NULL if no function is to be called
country_code	country code
pointer	to function, can be NULL if no function is to be called

void ACFG_SetSecondaryAudioLangId ( U8BIT lang_id )

Sets the secondary language id to be used for audio.

Parameters

lang_id language id

void ACFG_SetSecondaryTextLangId ( U8BIT lang_id )

Sets the secondary language id to be used for teletext/subtitles.

Parameters

lang_id language id

void ACFG_SetTerrestrialLcnFunction	(	U32BIT	country_code,
		AllocLcnFunc	func_ptr
	)

Overrides an existing DVB-T/T2 LCN allocation function for the given country.

Parameters

country_code	country id
pointer	to function, can be NULL if no function is to be called
country_code	country code
pointer	to function, can be NULL if no function is to be called

void ACFG_SetUndefinedLanguageBehaviour ( U32BIT lang_code )

Sets the language code to be used when the SI descriptors contain 'und', 'qaa' or don't contain any language descriptors.

Parameters

lang_code Language code to be use when the language is undefined. ILanguage codes that are not present in db_lang_list[] (defined in ap_cfdat.h), except ADB_LANG_CODE_UNDEF, will be ignored.

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Function Documentation