ap_cfg.h File Reference

Application configuration. More...

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

Go to the source code of this file.

Classes
struct	ana_rf_channel_data
struct	ter_rf_channel_data
struct	cab_rf_channel_data
struct	ACFG_DYNAMIC_SI_UPDATES
struct	region_data_entry
struct	ACFG_LANGUAGE_IDS
struct	ACFG_COUNTRY_SPECIFIC_DESCRIPTOR
struct	ACFG_COUNTRY_CONFIG

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_DENMARK   (U32BIT)(('d' << 16) | ('n' << 8) | 'k')
#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_IRELAND   (U32BIT)(('i' << 16) | ('r' << 8) | 'l')
#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_NORWAY   (U32BIT)(('n' << 16) | ('o' << 8) | 'r')
#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	COUNTRY_CODE_USERDEFINED   (U32BIT)(('u' << 24) | ('s' << 16) | ('e' << 8) | 'r')
#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	IRISH1_LANG_CODE   (('i' << 16) | ('r' << 8) | 'i')
#define	IRISH2_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')
#define	ARABIC_LANG_CODE   (('a' << 16) | ('r' << 8) | 'a')

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)
typedef struct region_data_entry	ACFG_REGION_DATA

Enumerations
enum	E_DVB_LANGUAGE_IDS {   DVB_LANGUAGE_ENGLISH, DVB_LANGUAGE_WELSH, DVB_LANGUAGE_GAELIC, DVB_LANGUAGE_IRISH,   DVB_LANGUAGE_FRENCH, DVB_LANGUAGE_GERMAN, DVB_LANGUAGE_DUTCH, DVB_LANGUAGE_RUSSIAN,   DVB_LANGUAGE_SIMPLIFIED_CHINESE, DVB_LANGUAGE_TRADITIONAL_CHINESE, DVB_LANGUAGE_FINNISH, DVB_LANGUAGE_SWEDISH,   DVB_LANGUAGE_NORWEGIAN, DVB_LANGUAGE_DANISH, DVB_LANGUAGE_MANDARIN, DVB_LANGUAGE_CANTONESE,   DVB_LANGUAGE_MAORI, DVB_LANGUAGE_JAPANESE, DVB_LANGUAGE_ITALIAN, DVB_LANGUAGE_SPANISH,   DVB_LANGUAGE_KOREAN, DVB_LANGUAGE_HINDI, DVB_LANGUAGE_CZECH, DVB_LANGUAGE_SLOVAK,   DVB_LANGUAGE_AFRIKAANS, DVB_LANGUAGE_NDEBELE, DVB_LANGUAGE_NORTHERN_SOTHO, DVB_LANGUAGE_SOUTHERN_SOTHO,   DVB_LANGUAGE_SWATI, DVB_LANGUAGE_TSONGA, DVB_LANGUAGE_TSWANA, DVB_LANGUAGE_VENDA,   DVB_LANGUAGE_XHOSA, DVB_LANGUAGE_ZULU, DVB_LANGUAGE_CROATIAN, DVB_LANGUAGE_HUNGARIAN,   DVB_LANGUAGE_LATVIAN, DVB_LANGUAGE_LUXEMBOURGISH, DVB_LANGUAGE_POLISH, DVB_LANGUAGE_PORTUGUESE,   DVB_LANGUAGE_SERBIAN, DVB_LANGUAGE_ROMANIAN, DVB_LANGUAGE_ALBANIAN, DVB_LANGUAGE_SLOVENE,   DVB_LANGUAGE_CATALAN, DVB_LANGUAGE_GALICIAN, DVB_LANGUAGE_BASQUE, DVB_LANGUAGE_UKRAINIAN,   DVB_LANGUAGE_ARABIC }
enum	E_DB_LANGS {   ACFG_DB_LANG_ENGLISH, ACFG_DB_LANG_WELSH1, ACFG_DB_LANG_WELSH2, ACFG_DB_LANG_GAELIC,   ACFG_DB_LANG_IRISH1, ACFG_DB_LANG_IRISH2, 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_DB_LANG_ARABIC, ACFG_NUM_DB_LANGUAGES }
enum	E_ACFG_DYNAMIC_SI_UPDATE_TYPE {   ACFG_DYNAMIC_SI_UPDATE_NONE = 0, ACFG_DYNAMIC_SI_UPDATE_LCNS = 0x0001, ACFG_DYNAMIC_SI_UPDATE_SERVICE_ADD = 0x0002, ACFG_DYNAMIC_SI_UPDATE_SERVICE_REMOVE = 0x0004,   ACFG_DYNAMIC_SI_UPDATE_SERVICE_MOVE = 0x0008 }

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...
BOOLEAN	ACFG_GetCountryConfig (U32BIT country_code, ACFG_COUNTRY_CONFIG *config)
	Copies the country configuration for the given country into the provided structure. None of the included arrays should be freed. More...
BOOLEAN	ACFG_SetCountryConfig (U32BIT country_code, ACFG_COUNTRY_CONFIG *config)
	Sets the country configuration settings that will be used for given country. This could be used to override the built-in configuration for a country but would more normally be used to set the configuration for the user defined country, if it's been included. If the config is set for the current country then ACFG_SetCountryIds will be called to ensure any country settings are changed if necessary. 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_SetDbLanguages (U32BIT country_code, ACFG_LANGUAGE_IDS *languages, U8BIT num_languages)
	Sets the languages that can be used for setting the default primary and secondary audio, subtitle and teletext languages. These will override any languages that are defined in the country configuration. The currently set primary and secondary audio language ids will be reset to 0 if they're greater than the number of languages in the new array. 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...
U16BIT	ACFG_GetOriginalNetworkID (U32BIT country_code, E_STB_DP_SIGNAL_TYPE tuner_type)
	Returns the original network ID for the given country and tuner type. More...
void	ACFG_SetOriginalNetworkID (U32BIT country_code, E_STB_DP_SIGNAL_TYPE tuner_type, U16BIT onet_id)
	Sets the original network ID for the given country and tuner type, replacing any existing value defined in the country's data table. More...
U32BIT	ACFG_GetPrivateDataSpecifier (U32BIT country_code)
	Returns the private data specifier value for the given country. More...
U16BIT	ACFG_GetFirstUnallocatedLcn (U32BIT country_code, E_STB_DP_SIGNAL_TYPE tuner_type)
	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, E_STB_DP_SIGNAL_TYPE tuner_type)
	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...
BOOLEAN	ACFG_IsNordigService (E_STB_DP_SIGNAL_TYPE tuner_type)
	Returns whether the broadcast SI data for the given tuner type is to be treated as Nordig compliant. This is in relation to the current country. 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...
BOOLEAN	ACFG_GetDynamicSIUpdate (E_STB_DP_SIGNAL_TYPE signal_type, U16BIT onet_id, E_ACFG_DYNAMIC_SI_UPDATE_TYPE update_type)
	Use to check whether a dynamic SI update is enabled for the currently configured country and given signal type and original network ID. If an array item is found with an original network ID of ADB_INVALID_DVB_ID then this item will be used. More...
BOOLEAN	ACFG_SetDynamicSIUpdates (E_STB_DP_SIGNAL_TYPE signal_type, ACFG_DYNAMIC_SI_UPDATES *dynamic_updates, U8BIT num_updates)
	Sets the dynamic SI updates for the given tuner type of the currently configured country. 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

BOOLEAN ACFG_GetCountryConfig	(	U32BIT	country_code,
		ACFG_COUNTRY_CONFIG *	config
	)

Copies the country configuration for the given country into the provided structure. None of the included arrays should be freed.

Parameters

country_code	3 character country code
config	structure into which the configuration data will be copied

Returns

TRUE if the country code is valid, FALSE otherwise

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, value returned by ACFG_GetNumCountries() 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

BOOLEAN ACFG_GetDynamicSIUpdate	(	E_STB_DP_SIGNAL_TYPE	signal_type,
		U16BIT	onet_id,
		E_ACFG_DYNAMIC_SI_UPDATE_TYPE	update_type
	)

Use to check whether a dynamic SI update is enabled for the currently configured country and given signal type and original network ID. If an array item is found with an original network ID of ADB_INVALID_DVB_ID then this item will be used.

Parameters

signal_type	terrestrial, satellite or cable
onet_id	original network ID to be checked
update_type	see whether this type of update is enabled

Returns

TRUE if the update is enabled, FALSE otherwise

Use to check whether a dynamic SI update is enabled for the currently configured country and given signal type and original network ID. If an array item is found with an original network ID of ADB_INVALID_DVB_ID then this item will be used.

Parameters

signal_type	terrestrial, satellite or cable
onet_id	original network ID to be checked
update_type	see whether this type of update is enabled

Returns

TRUE if the update is enabled, FALSE otherwise

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,
		E_STB_DP_SIGNAL_TYPE	tuner_type
	)

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
tuner_type	tuner type of the value to be returned

Returns

LCN; 0 if country or tuner type aren't valid

U16BIT ACFG_GetLastUnallocatedLcn	(	U32BIT	country_code,
		E_STB_DP_SIGNAL_TYPE	tuner_type
	)

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
tuner_type	tuner type of the value to be returned

Returns

LCN; 0 if country or tuner type aren'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

U16BIT ACFG_GetOriginalNetworkID	(	U32BIT	country_code,
		E_STB_DP_SIGNAL_TYPE	tuner_type
	)

Returns the original network ID for the given country and tuner type.

Parameters

country_code	country code
tuner_type	defines the original network ID value to be returned

Returns

original network ID which will be 0 if the country isn't defined or tuner type is invalid

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

BOOLEAN ACFG_IsNordigService

(

E_STB_DP_SIGNAL_TYPE

tuner_type

)

Returns whether the broadcast SI data for the given tuner type is to be treated as Nordig compliant. This is in relation to the current country.

Parameters

tuner_type

tuner type to be checked; SIGNAL_NONE is not a valid argument

Returns

TRUE if SI data should comply with Nordig specifications, 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

BOOLEAN ACFG_SetCountryConfig	(	U32BIT	country_code,
		ACFG_COUNTRY_CONFIG *	config
	)

Sets the country configuration settings that will be used for given country. This could be used to override the built-in configuration for a country but would more normally be used to set the configuration for the user defined country, if it's been included. If the config is set for the current country then ACFG_SetCountryIds will be called to ensure any country settings are changed if necessary.

Parameters

country_code	3 character country code
config	configuration settings to be used for the country

Returns

TRUE if the country code is valid, 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

BOOLEAN ACFG_SetDbLanguages	(	U32BIT	country_code,
		ACFG_LANGUAGE_IDS *	languages,
		U8BIT	num_languages
	)

Sets the languages that can be used for setting the default primary and secondary audio, subtitle and teletext languages. These will override any languages that are defined in the country configuration. The currently set primary and secondary audio language ids will be reset to 0 if they're greater than the number of languages in the new array.

Parameters

country_code	country code of the country whose languages are to be set
languages	array of languages. This array will be copied.
num_languages	number of items in the above language array

Returns

TRUE if the country is found and the languages are set, FALSE otherwise

BOOLEAN ACFG_SetDynamicSIUpdates	(	E_STB_DP_SIGNAL_TYPE	signal_type,
		ACFG_DYNAMIC_SI_UPDATES *	dynamic_updates,
		U8BIT	num_updates
	)

Sets the dynamic SI updates for the given tuner type of the currently configured country.

Parameters

signal_type	terrestrial, satellite or cable
dynamic_updates	array of SI update types; the content of this array isn't copied so must continue to exist after it's set. The last element of the array must be an entry with the update type of ACFG_DYNAMIC_SI_UPDATE_NONE; the original network ID for this entry will be ignored so can be any value.
num_updates	number of SI update entries in the provided array

Returns

TRUE if the country and signal type are valid, FALSE otherwise

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_SetOriginalNetworkID	(	U32BIT	country_code,
		E_STB_DP_SIGNAL_TYPE	tuner_type,
		U16BIT	onet_id
	)

Sets the original network ID for the given country and tuner type, replacing any existing value defined in the country's data table.

Parameters

country_code	country code
tuner_type	defines the original network ID value to be returned
onet_id	original network ID to be used

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.