ap_dbdef.h File Reference

Application database control. More...

#include "techtype.h"
#include "stbsiflt.h"
#include "stbsitab.h"
#include "stbllist.h"
#include "ap_cfg.h"
#include "ap_tmr.h"
#include "ap_dbacc.h"

Go to the source code of this file.

Classes
struct	adb_string
struct	adb_lnb_rec
struct	adb_bat_version_rec
struct	adb_satellite_rec
struct	adb_lnb_band_rec
struct	adb_network_rec
struct	adb_pmt_version_rec
struct	adb_transport_rec
struct	adb_audio_stream_data
struct	adb_subtitle_stream_data
struct	adb_ttext_stream_data
union	adb_stream_data
struct	adb_stream_rec
struct	adb_event_desc
struct	adb_event_rec
struct	adb_alt_serv_rec
struct	adb_icon_image
struct	adb_rct_link_info
struct	ADB_GUIDANCE_DESC
struct	adb_service_rec
struct	adb_crid_record
struct	adb_favserv_rec
struct	adb_favlist_rec
struct	ADB_ALARM_REC
struct	ADB_PVR_RECORD_REC
struct	ADB_TIMER_REC
struct	s_event

Macros
#define	ADB_LANG_CODE_UNDEF   0x756e64
#define	ADB_LANG_CODE_QAA   0x716161
#define	ADB_LANG_CODE_NAR   0x6e6172
#define	LINKAGE_DTAG   0x4a
#define	SHORT_EVENT_DTAG   0x4d
#define	EXTENDED_EVENT_DTAG   0x4e
#define	COMPONENT_DTAG   0x50
#define	CONTENT_DTAG   0x54
#define	PARENTAL_RATING_DTAG   0x55
#define	PRIVATE_DATA_SPEC_DTAG   0x5f
#define	CONT_ID_DESC_DTAG   0x76
#define	FTA_CONTENT_DESC_DTAG   0x7e
#define	EXTENSION_DTAG   0x7f
#define	USER_DEFINED_DTAG_0x85   0x85
#define	USER_DEFINED_DTAG_0x89   0x89
#define	LINK_TYPE_EVENT   0x0d
#define	LINK_TYPE_EXT_EVENT   0x0e
#define	INVALID_FREESAT_SERV_ID   0x8000
#define	TVA_PROGRAMME_CRID   0x01
#define	TVA_SERIES_CRID   0x02
#define	TVA_RECOMMENDATION_CRID   0x03
#define	UK_PROGRAMME_CRID   0x31
#define	UK_SERIES_CRID   0x32
#define	UK_RECOMMENDATION_CRID   0x33

Typedefs
typedef struct adb_string	ADB_STRING
typedef struct adb_lnb_rec	ADB_LNB_REC
typedef struct adb_bat_version_rec	ADB_BAT_VERSION_REC
typedef struct adb_satellite_rec	ADB_SATELLITE_REC
typedef struct adb_lnb_band_rec	ADB_LNB_BAND_REC
typedef struct adb_network_rec	ADB_NETWORK_REC
typedef struct adb_pmt_version_rec	ADB_PMT_VERSION_REC
typedef struct adb_transport_rec	ADB_TRANSPORT_REC
typedef struct adb_audio_stream_data	ADB_AUDIO_STREAM_DATA
typedef struct adb_subtitle_stream_data	ADB_SUBTITLE_STREAM_DATA
typedef struct adb_ttext_stream_data	ADB_TTEXT_STREAM_DATA
typedef union adb_stream_data	ADB_STREAM_DATA
typedef struct adb_stream_rec	ADB_STREAM_REC
typedef struct adb_event_desc	ADB_EVENT_DESC
typedef struct adb_event_rec	ADB_EVENT_REC
typedef struct adb_alt_serv_rec	ADB_ALT_SERV_REC
typedef struct adb_icon_image	ADB_IMAGE_ICON
typedef struct adb_rct_link_info	ADB_RCT_LINK_INFO
typedef struct adb_service_rec	ADB_SERVICE_REC
typedef struct adb_crid_record	ADB_CRID_REC
typedef struct adb_favserv_rec	ADB_FAVSERV_REC
typedef struct adb_favlist_rec	ADB_FAVLIST_REC
typedef struct s_event	S_EVENT

Enumerations
enum	E_STREAM_MATCH_TYPE {   STREAM_MATCH_EXACT, STREAM_MATCH_ASPECT, STREAM_MATCH_LANG, STREAM_MATCH_TYPE,   STREAM_MATCH_NOT_ZERO, STREAM_MATCH_NONE }
enum	E_ICON_TYPE { ICON_TYPE_PNG, ICON_TYPE_JPEG }

Functions
void	DBDEF_Initialise (void)
	Initialises the database, preparing for it to be accessed.
void	DBDEF_RequestAccess (void)
	Requests access to the app's database.
void	DBDEF_ReleaseAccess (void)
	Releases access to the app's database.
BOOLEAN	DBDEF_LoadDatabase (U8BIT *db_pathname)
	Loads the service database from non-volatile storage and creates the RAM version of this data that will be used by the DVB stack. More...
void	DBDEF_DeleteAllRecords (void)
	Deletes all records in the database.
BOOLEAN	DBDEF_SaveDatabase (void)
void	DBDEF_DeleteRecordsForTunerType (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
	Deletes all network, transport and services records for the given tuner type. More...
void	DBDEF_DeleteServiceRec (ADB_SERVICE_REC *s_ptr)
	Deletes specified service record. More...
U16BIT	DBDEF_NumStreamsInList (ADB_STREAM_REC *slist)
	Returns the number of stream records in the given list. More...
ADB_STREAM_REC *	DBDEF_CopyStreamList (ADB_STREAM_REC *slist)
	Creates a copy of a stream list, allocating new memory as required. More...
void	DBDEF_DeleteStreamList (ADB_STREAM_REC *slist)
	Deletes all records in a service stream list. More...
void	DBDEF_DeleteAltServList (ADB_ALT_SERV_REC *aslist)
	Deletes all records in a service alternate service list. More...
void	DBDEF_DeleteRCTLinks (ADB_RCT_LINK_INFO *links)
	Frees the given list of RCT links. More...
void	DBDEF_DeleteImageIcons (ADB_IMAGE_ICON *icon_list)
	Frees given list of image icons and any associated memory. More...
void	DBDEF_SortServicesByLcn (void)
	Sort the full service list into ascending logical channel number order.
BOOLEAN	DBDEF_AllocateLcns (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN assign_lcns)
	allocates lcns - expects allocated lcn for all services to be 0 More...
BOOLEAN	DBDEF_AllocateLcnsDefault (E_STB_DP_SIGNAL_TYPE tuner_type)
U16BIT	DBDEF_GetNumLNBs (void)
	Returns the number of LNB records in the database. More...
ADB_LNB_REC *	DBDEF_AddLNB (E_STB_DP_LNB_TYPE type, ADB_STRING *name)
	Add an LNB record to the database. More...
BOOLEAN	DBDEF_SetLNBPower (ADB_LNB_REC *lnb, E_STB_DP_LNB_POWER power)
	Sets the LNB power setting. More...
BOOLEAN	DBDEF_SetLNB22k (ADB_LNB_REC *lnb, BOOLEAN is_22k)
	Sets the LNB 22k setting. More...
BOOLEAN	DBDEF_SetLNB12V (ADB_LNB_REC *lnb, BOOLEAN is_12v)
	Sets the LNB 12V setting. More...
BOOLEAN	DBDEF_SetLNBPulsePosition (ADB_LNB_REC *lnb, BOOLEAN is_pulse_posn)
	Sets the LNB pulse position setting. More...
BOOLEAN	DBDEF_SetLNBDiSEqCPosition (ADB_LNB_REC *lnb, BOOLEAN is_diseqc_posn)
	Sets the LNB DiSEqC position setting. More...
BOOLEAN	DBDEF_SetLNBDiSEqCTone (ADB_LNB_REC *lnb, E_STB_DP_DISEQC_TONE diseqc_tone)
	Sets the LNB DiSEqC tone setting. More...
BOOLEAN	DBDEF_SetLNBCSwitch (ADB_LNB_REC *lnb, E_STB_DP_DISEQC_CSWITCH cswitch)
	Sets the LNB committed switch setting. More...
BOOLEAN	DBDEF_SetLNBUSwitch (ADB_LNB_REC *lnb, U8BIT uswitch)
	Sets the LNB uncommitted switch setting. More...
BOOLEAN	DBDEF_SetLNBSmatv (ADB_LNB_REC *lnb, BOOLEAN is_smatv)
	Sets the LNB SMATV setting. More...
BOOLEAN	DBDEF_SetLNBRepeats (ADB_LNB_REC *lnb, U8BIT repeats)
	Sets the LNB message repeat setting in the range 0 to 3. More...
BOOLEAN	DBDEF_SetLNBUnicable (ADB_LNB_REC *lnb, U32BIT inter_freq, U8BIT chan)
	Sets the LNB Unicable settings. More...
ADB_LNB_REC *	DBDEF_GetNextLNBRec (ADB_LNB_REC *lnb_ptr)
	Returns the next LNB record after the one given. If the argument is NULL then the first record is returned. More...
U16BIT	DBDEF_GetNumSatellites (void)
	Returns the number of satellite records in the database. More...
ADB_SATELLITE_REC *	DBDEF_AddSatelliteRec (ADB_STRING *name_str, U16BIT dish_pos, U16BIT long_pos, BOOLEAN east_west, ADB_LNB_REC *associated_lnb)
	Add a satellite record to the database. More...
ADB_SATELLITE_REC *	DBDEF_GetNextSatelliteRec (ADB_SATELLITE_REC *sat_ptr)
	Returns the next satellite record after the one given. If the argument is NULL then the first record is returned. More...
U16BIT	DBDEF_GetNumLNBBands (void)
	Returns the number of LNB band records in the database. More...
ADB_LNB_BAND_REC *	DBDEF_AddLNBBandRec (S_STB_DP_LNB_BAND *band_parameters, ADB_LNB_REC *associated_lnb)
	Add an LNB band record to the database. More...
ADB_LNB_BAND_REC *	DBDEF_GetNextLNBBandRec (ADB_LNB_BAND_REC *band_ptr)
	Returns the next LNB band record after the one given. If the argument is NULL then the first record is returned. More...
void	DBDEF_DeleteLNBBandRec (ADB_LNB_BAND_REC *band_ptr)
	Deletes an LNB band record from the database. More...
U16BIT	DBDEF_GetNumNetworks (void)
	Returns the number of networks in ther service database. More...
ADB_NETWORK_REC *	DBDEF_AddNetworkRec (U16BIT net_id, ADB_SATELLITE_REC *satellite)
	Adds a new network record to the database with the given network ID. More...
void	DBDEF_DeleteNetworkRec (ADB_NETWORK_REC *n_ptr)
	Deletes specified network record. More...
void	DBDEF_SetNetworkName (ADB_NETWORK_REC *n_ptr, U8BIT *name)
	Set or change the name of the given network. More...
ADB_NETWORK_REC *	DBDEF_FindNetworkRec (U16BIT net_id, ADB_SATELLITE_REC *satellite)
	Finds the network with the given network ID. More...
ADB_NETWORK_REC *	DBDEF_GetNextNetworkRec (ADB_NETWORK_REC *n_ptr)
	Returns the network following the one given. If the argument is NULL then the first network will be returned. More...
U16BIT	DBDEF_GetNumTransports (void)
	Returns the number of transports in ther service database. More...
ADB_TRANSPORT_REC *	DBDEF_GetNextTransportRec (ADB_TRANSPORT_REC *t_ptr)
	Returns the transport following the one given. If the argument is NULL then the first transport will be returned. More...
ADB_TRANSPORT_REC *	DBDEF_AddTerrestrialTransportRec (U32BIT freq_hz, U8BIT plp_id, ADB_NETWORK_REC *network)
	Adds a terrestrial transport record with the given frequency and PLP id. More...
ADB_TRANSPORT_REC *	DBDEF_FindTerrestrialTransportRec (U32BIT freq_hz, U8BIT plp_id)
	Find the terrestrial transport record in the database matching the given params. More...
ADB_TRANSPORT_REC *	DBDEF_AddCableTransportRec (U32BIT freq_hz, U32BIT symbol_rate, ADB_NETWORK_REC *network)
	Adds a cable transport record with the given frequency and symbol rate. More...
ADB_TRANSPORT_REC *	DBDEF_FindCableTransportRec (U32BIT freq_hz, U32BIT symbol_rate)
	Find the cable transport record in the database matching the given params. More...
void	DBDEF_SetCableTransportSymbolRate (ADB_TRANSPORT_REC *t_ptr, U16BIT symbol_rate)
void	DBDEF_SetCableTransportMode (ADB_TRANSPORT_REC *t_ptr, E_STB_DP_CMODE cmode)
ADB_TRANSPORT_REC *	DBDEF_AddSatTransportRec (U32BIT freq_hz, U16BIT symbol_rate, E_STB_DP_POLARITY polarity, BOOLEAN dvb_s2, E_STB_DP_MODULATION modulation, ADB_NETWORK_REC *network)
	Adds a satellite transport record with the given frequency, symbol rate and polarity. More...
ADB_TRANSPORT_REC *	DBDEF_FindSatTransportRec (U32BIT freq_hz, U16BIT symbol_rate, E_STB_DP_POLARITY polarity, BOOLEAN dvb_s2, E_STB_DP_MODULATION modulation, void *satellite)
	Find the satellite transport record in the database matching the given params. More...
void	DBDEF_SetSatTransportTuningParams (ADB_TRANSPORT_REC *t_ptr, U32BIT freq_hz, U16BIT symbol_rate, E_STB_DP_POLARITY polarity, BOOLEAN dvb_s2, E_STB_DP_MODULATION modulation, ADB_NETWORK_REC *network)
	Sets the tuning parameters for an existing satellite transport. More...
ADB_TRANSPORT_REC *	DBDEF_FindTransportRecByIds (ADB_TRANSPORT_REC *transp, U32BIT net_id, U32BIT onet_id, U32BIT tran_id)
	Find a transport record matching the given set of IDs, starting from the given transport. More...
void	DBDEF_SetTransportTransportId (ADB_TRANSPORT_REC *t_ptr, U16BIT tran_id)
	Sets the transport ID of the given transport. More...
void	DBDEF_SetTransportOrigNetworkId (ADB_TRANSPORT_REC *t_ptr, U16BIT orig_net_id)
	Sets the original network ID of the given transport. More...
void	DBDEF_GetTransportAdditionalFrequencies (ADB_TRANSPORT_REC *t_ptr, U8BIT *num_freqs, U32BIT **freqs)
	Returns the additional frequencies associated with a transport. The returned array should not be modified or freed. More...
void	DBDEF_DeleteTransportRec (ADB_TRANSPORT_REC *t_ptr)
	Deletes the given transport from the service database. More...
void	DBDEF_ClearTableVersionHistory (ADB_TRANSPORT_REC *t_ptr)
	Clears the version histories stored in the transport records.
U16BIT	DBDEF_GetNumServices (void)
	Returns the total number of services. More...
ADB_SERVICE_REC *	DBDEF_GetNextServiceRec (ADB_SERVICE_REC *s_ptr)
	Returns the service after the one given. If NULL is passed then the first service in the list is returned. More...
ADB_SERVICE_REC *	DBDEF_GetPrevServiceRec (ADB_SERVICE_REC *s_ptr)
	Returns the service before the one given. If NULL is passed then the last service in the list is returned. More...
ADB_SERVICE_REC *	DBDEF_AddServiceRec (U16BIT serv_id, ADB_TRANSPORT_REC *t_ptr)
	Adds a new service record to the service database with the given service ID and parent transport. More...
ADB_SERVICE_REC *	DBDEF_CopyServiceRec (ADB_SERVICE_REC *orig_serv)
	Creates a copy of the given service, copying the service's attributes, e.g. service name, scrambled, locked, hidde, etc, but not the runtime specific data such as the stream list or event schedule data. More...
BOOLEAN	DBDEF_SetServiceName (ADB_SERVICE_REC *s_ptr, U8BIT *name)
	Set or change the name of a service. More...
BOOLEAN	DBDEF_SetServiceShortName (ADB_SERVICE_REC *s_ptr, U8BIT *name)
	Set or change the short name of a service. More...
BOOLEAN	DBDEF_SetServiceProviderName (ADB_SERVICE_REC *s_ptr, U8BIT *name)
	Set or change the name of a service's provider. More...
BOOLEAN	DBDEF_SetServiceType (ADB_SERVICE_REC *s_ptr, ADB_SERVICE_TYPE serv_type)
	Sets the service type for the given service record. More...
void	DBDEF_SaveServiceEventSchedule (ADB_SERVICE_REC *s_ptr)
	Saves the event schedule of a service to the service database. More...
ADB_SERVICE_REC *	DBDEF_GetNextServiceOnTransport (ADB_SERVICE_REC *s_ptr, ADB_TRANSPORT_REC *t_ptr)
	Find the next service following the given service that's on the given transport. More...
ADB_SERVICE_REC *	DBDEF_FindServiceRec (U16BIT serv_id, ADB_TRANSPORT_REC *t_ptr)
	Search for the service with the given service ID on the given transport. More...
ADB_SERVICE_REC *	DBDEF_FindServiceRecByIds (ADB_SERVICE_REC *servp, U32BIT net_id, U32BIT onet_id, U32BIT tran_id, U32BIT serv_id)
	Search for a service with the given IDs. More...
ADB_SERVICE_REC *	DBDEF_FindServiceRecByLcn (U16BIT lcn, ADB_TRANSPORT_REC *t_ptr, BOOLEAN allocated_lcn)
	Find the service with the given LCN, and optionally on the given transport. More...
ADB_SERVICE_REC *	DBDEF_FindServiceRecByFreesatId (ADB_SERVICE_REC *servp, U16BIT freesat_id)
	Search for a service with the given Freesat ID. More...
U16BIT	DBDEF_GetReqdAudioPid (ADB_SERVICE_REC *s_ptr, E_STB_DP_AUDIO_MODE *audio_mode, ADB_STREAM_TYPE *audio_type)
	Gets the appropriate audio pid - looks first for the pid matching exactly the required audio settings in the database, then for the pid matching the default language, then the first audip pid in the stream list. If no pid found the returned pid value will be 0. More...
U16BIT	DBDEF_GetReqdADPid (ADB_SERVICE_REC *s_ptr, E_STB_DP_AUDIO_MODE *ad_mode, ADB_STREAM_TYPE *ad_type, BOOLEAN *broadcast_mix)
	Gets the appropriate audio description pid - looks first for the pid matching exactly the required audio settings in the database, then for the pid matching the default language, then the first audip pid in the stream list. If no pid found the returned pid value will be 0. More...
E_STREAM_MATCH_TYPE	DBDEF_GetReqdTtextPid (ADB_SERVICE_REC *s_ptr, BOOLEAN for_subtitles, U16BIT *pid_ptr, U8BIT *magazine, U8BIT *page)
	Gets the appropriate teletext pid - looks first for the params matching exactly the required teletext settings in the database, then for the pid matching the default language, then the first teletext stream in the stream list. If no teletext found the returned pid will be 0. More...
E_STREAM_MATCH_TYPE	DBDEF_GetReqdSubtitleParams (ADB_SERVICE_REC *s_ptr, U16BIT *pid_ptr, U16BIT *cpage_ptr, U16BIT *apage_ptr)
	Gets the appropriate subtitle pid and page ids - looks first for the params matching exactly the required subtitle settings in the database, then for the pid matching the default language, then the first subtitle stream in the stream list. If no subtitles found the returned pid will be 0. More...
U16BIT	DBDEF_GetReqdVideoPid (ADB_SERVICE_REC *s_ptr, ADB_STREAM_TYPE *video_type)
	Returns the video pid and type that should be used for the given service from the list of video streams available. The "best one" is based on HD being better than SD and uses the priorities from the Nordig spec. More...
ADB_STRING *	DBDEF_GetServiceName (ADB_SERVICE_REC *s_ptr, BOOLEAN short_name, BOOLEAN pref_name)
	Returns a pointer to the service name, taking into account perferred names and short names, if available. More...
ADB_STRING *	DBDEF_GetServiceProviderName (ADB_SERVICE_REC *s_ptr)
	Returns a pointer to the service provider name. More...
void	DBDEF_SetServiceDeletedFlag (ADB_SERVICE_REC *s_ptr, BOOLEAN deleted)
	Marks whether a service is deleted or not. More...
U16BIT	DBDEF_GetNumDeletedServices (E_STB_DP_SIGNAL_TYPE tuner_type)
	Returns the number of services that are marked as deleted for the given tuner type. More...
U16BIT	DBDEF_GetDeletedServiceList (E_STB_DP_SIGNAL_TYPE tuner_type, void ***slist_ptr)
BOOLEAN	DBDEF_AddAnalogService (void)
	Adds an analogue service, transport and, if necessary, network to the database based on the current tuning parameters in the decode path. More...
void	DBDEF_SetAnalogServiceName (ADB_SERVICE_REC *s_ptr, U8BIT *new_name, U8BIT new_len)
	Updates analog service names - ASSUMES NORMAL ASCII CODED. More...
void	DBDEF_SetServicePmtPid (ADB_SERVICE_REC *s_ptr, U16BIT pmt_pid)
	Updates the pmt pid. More...
U16BIT	DBDEF_GetServicePmtPid (ADB_SERVICE_REC *s_ptr)
	gets the PMT PID associated with the service More...
void	DBDEF_SetServiceFavGroups (ADB_SERVICE_REC *s_ptr, U8BIT groups)
	Sets the favourite groups for a service. More...
ADB_EVENT_REC *	DBDEF_FindScheduleEventById (ADB_SERVICE_REC *s_ptr, U16BIT event_id)
	Find an event for a service from its event_id. More...
ADB_EVENT_DESC *	DBDEF_FindEventDescriptor (ADB_EVENT_DESC *start_desc, U8BIT desc_tag, U32BIT private_data_specifier)
	Searches a descriptor list for the first descriptor with the given descriptor tag. More...
U8BIT *	DBDEF_GetEventName (ADB_EVENT_REC *e_ptr)
	Returns the name of the event as a UTF-8 string in the currently selected language. The returned string should be freed using STB_ReleaseUnicodeString. More...
U8BIT *	DBDEF_GetEventDescription (ADB_EVENT_REC *e_ptr)
	Returns the short event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
U8BIT *	DBDEF_GetEventExtendedDescription (ADB_EVENT_REC *e_ptr)
	Returns the extended event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
ADB_EVENT_ITEMIZED_INFO *	DBDEF_GetEventItemizedDescription (ADB_EVENT_REC *e_ptr, U16BIT *num_items_ptr)
	Returns the items of extended event descriptor as item descriptor and item itself. More...
U8BIT *	DBDEF_GetEventGuidance (ADB_EVENT_REC *e_ptr, ADB_SERVICE_REC *s_ptr, U8BIT *type, U8BIT *mode)
	Returns the guidance text for an event, either from the event itself or the event's service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
U8BIT *	DBDEF_GetServiceGuidanceData (ADB_SERVICE_REC *s_ptr, U8BIT *type, U8BIT *mode)
	Returns the guidance text for the service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
U8BIT *	DBDEF_GetServiceGuidance (ADB_SERVICE_REC *s_ptr)
	Returns the guidance text for the service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString. More...
U8BIT	DBDEF_GetEventParentalAge (ADB_EVENT_REC *e_ptr)
	Returns the parental age value for the given event. More...
BOOLEAN	DBDEF_GetEventAudioDescriptionFlag (ADB_EVENT_REC *e_ptr)
	Returns whether audio description is signalled as being available for the given event. More...
BOOLEAN	DBDEF_GetEventHDLinkageInfo (ADB_EVENT_REC *e_ptr, BOOLEAN verify_event, BOOLEAN only_simulcast, ADB_SERVICE_REC **hd_serv_ptr, ADB_EVENT_REC **hd_event_ptr)
	Returns whether there's an HD event linked to the SD event and returns the info for it. The DVB info is checked to ensure it relates to a known service. More...
U8BIT	DBDEF_GetEventComponentList (ADB_EVENT_REC *e_ptr, ADB_EVENT_COMPONENT_INFO **component_list)
	Retrieves a list of components associated with the specified event, as described by component descriptors in the EIT. More...
BOOLEAN	DBDEF_GetEventSubtitlesAvailFlag (ADB_EVENT_REC *e_ptr)
	Returns whether DVB subtitles are signalled as being available for the given event. More...
ADB_EVENT_CONTENT	DBDEF_GetEventGenre (ADB_EVENT_REC *e_ptr, ADB_SERVICE_REC *s_ptr)
	Returns the genre of an event. More...
U8BIT *	DBDEF_GetEventContentData (ADB_EVENT_REC *e_ptr, U8BIT *p_len)
	Returns the level 1 and 2 values for all content identifiers for the given event. More...
U8BIT *	DBDEF_GetEventCrid (ADB_SERVICE_REC *serv_ptr, ADB_EVENT_REC *e_ptr, U8BIT crid_type, U8BIT index)
	Returns the full CRID of the type given for the given event. More...
U8BIT	DBDEF_NumberOfCridsOfType (ADB_EVENT_REC *e_ptr, U8BIT crid_type)
	Returns the number of CRIDs of the given type for the event. More...
U8BIT *	DBDEF_GetFullCrid (ADB_SERVICE_REC *serv_ptr, U8BIT *event_str)
	Returns the full CRID for the given CRID string The returned string should be freed using STB_AppFreeMemory. More...
U8BIT *	DBDEF_GetServiceDefaultAuthority (ADB_SERVICE_REC *s_ptr)
	Returns a copy of the default authority CRID string for the given service. This string will be returned as broadcast and should be freed using STB_AppFreMemory. More...
void	DBDEF_DeleteEventList (ADB_EVENT_REC *elist)
	Deletes all events in the given list. More...
void	DBDEF_SetTunedNetwork (U8BIT path, ADB_NETWORK_REC *n_ptr)
	sets the currently tuned network More...
ADB_NETWORK_REC *	DBDEF_GetTunedNetwork (U8BIT path)
	gets the currently tuned network More...
void	DBDEF_SetTunedTransport (U8BIT path, ADB_TRANSPORT_REC *t_ptr)
	sets the currently tuned transport More...
ADB_TRANSPORT_REC *	DBDEF_GetTunedTransport (U8BIT path)
	gets the currently tuned transport More...
void	DBDEF_SetTunedService (U8BIT path, ADB_SERVICE_REC *s_ptr)
	Sets the currently tuned service. More...
ADB_SERVICE_REC *	DBDEF_GetTunedService (U8BIT path)
	Returns the currently tuned service on the given path. More...
void	DBDEF_SetTextLang (U8BIT *lang_ids)
	sets current text lang More...
U8BIT *	DBDEF_GetTextLang (void)
	returns array of current text langs More...
void	DBDEF_SetSecondaryTextLang (U8BIT *lang_ids)
	sets secondary text lang More...
U8BIT *	DBDEF_GetSecondaryTextLang (void)
	returns array of secondary text langs More...
void	DBDEF_SetAudioLang (U8BIT *lang_ids)
	sets current audio lang More...
U8BIT *	DBDEF_GetAudioLang (void)
	returns current audio lang More...
U8BIT *	DBDEF_GetSecondaryAudioLang (void)
	returns current secondary audio lang More...
void	DBDEF_SetSecondaryAudioLang (U8BIT *lang_ids)
	sets the secondary audio lang More...
void	DBDEF_TidyDatabaseAfterSearch (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite, BOOLEAN search_completed, BOOLEAN manual)
	Calls any country and tuner type specific function to tidy up the database following a search, such as removing duplicate services, etc. More...
void	DBDEF_TidyDatabaseNordig (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
	Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country. More...
void	DBDEF_TidyDatabaseUK (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
	Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country. More...
void	DBDEF_TidyDatabaseSatUK (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
	Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country. More...
void	DBDEF_TidyDatabaseDefault (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
	Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country. More...
void	DBDEF_RemoveEmptyTransports (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
	Delete all transport records that don't have any services. More...
void	DBDEF_DeleteLinkageDescripterArray (SI_LINKAGE_DESC_ENTRY *list_ptr)
ADB_CRID_REC *	DBDEF_AddCridRecord (U8BIT *crid, BOOLEAN series, BOOLEAN recommended)
	Creates a CRID record and adds it to the database. More...
void	DBDEF_SetCridDateTime (ADB_CRID_REC *c_ptr, U32DHMS date_time)
	Sets the date and time fields in the crid record. More...
void	DBDEF_SetCridService (ADB_CRID_REC *c_ptr, U16BIT serv_id)
	Sets the service ID in the crid record. More...
void	DBDEF_SetCridProgrammeName (ADB_CRID_REC *c_ptr, U8BIT *prog_name)
	Sets the programme name field of the given CRID record. More...
void	DBDEF_SetCridDoNotDelete (ADB_CRID_REC *c_ptr, BOOLEAN do_not_delete)
	Sets the do not delete flag in the crid record. More...
void	DBDEF_UpdateCridEitDate (ADB_CRID_REC *c_ptr)
	Updates the stored EIT date of this CRID with the current GMT date. More...
void	DBDEF_DeleteCridRecord (ADB_CRID_REC *c_ptr)
	Deletes the given CRID record from the database. More...
U16BIT	DBDEF_GetNumCridRecords (void)
	Returns the number of CRID records in the database. More...
ADB_CRID_REC *	DBDEF_GetNextCridRecord (ADB_CRID_REC *c_ptr)
	Returns the next CRID record after the one specified. If the record specified is NULL then the first record is returned. More...
BOOLEAN	DBDEF_IsValidCridRecord (ADB_CRID_REC *c_ptr)
	Checks whether the given crid record is in the list of valid crid records. More...
U16BIT	DBDEF_GetNumFavouriteLists (void)
	Returns the number of favourite lists. More...
ADB_FAVLIST_REC *	DBDEF_AddFavouriteList (U8BIT list_id, U8BIT *name, U32BIT user_data, S16BIT index)
	Creates a new favourite list and adds it to the list of favourite lists. Creation of the new list will fail if a list_id can't be found for it, or memory allocation fails. More...
ADB_FAVLIST_REC *	DBDEF_GetNextFavouriteList (ADB_FAVLIST_REC *fav_list)
	Returns the favourite list following the given item. More...
ADB_FAVLIST_REC *	DBDEF_FindFavouriteList (U8BIT list_id)
	Return the favourite list with the given list id. More...
void	DBDEF_SetFavouriteListUserData (ADB_FAVLIST_REC *fav_list, U32BIT user_data)
	Saves the given user data with a favourite list. More...
void	DBDEF_MoveFavouriteListTo (ADB_FAVLIST_REC *fav_list, S16BIT index)
	Changes the order of the favourite lists by moving the given list to the given position. More...
void	DBDEF_DeleteFavouriteList (ADB_FAVLIST_REC *fav_list)
	Deletes the given favourite list. More...
U16BIT	DBDEF_GetNumServicesInFavouriteList (ADB_FAVLIST_REC *fav_list)
	Returns the number of services in the given favourite list. More...
ADB_FAVSERV_REC *	DBDEF_AddServiceToFavouriteList (ADB_FAVLIST_REC *fav_list, ADB_SERVICE_REC *serv_ptr, S16BIT index)
	Adds a new service to the given favourite list at the given position. More...
ADB_FAVSERV_REC *	DBDEF_FindServiceInFavouriteList (ADB_FAVLIST_REC *fav_list, void *serv_ptr)
	Returns the ADB_FAVSERV_REC from the given favourite list for the given service. More...
ADB_FAVSERV_REC *	DBDEF_GetNextServiceFromFavouriteList (ADB_FAVLIST_REC *fav_list, ADB_FAVSERV_REC *fav_serv)
	Returns the next favourite list service record. More...
ADB_FAVSERV_REC *	DBDEF_GetPrevServiceFromFavouriteList (ADB_FAVLIST_REC *fav_list, ADB_FAVSERV_REC *fav_serv)
	Returns the previous favourite list service record. More...
void	DBDEF_MoveFavouriteListServiceTo (ADB_FAVLIST_REC *fav_list, ADB_FAVSERV_REC *fav_serv, S16BIT index)
	Changes the order of the services in the favourite list by moving the given service to the given position. More...
void	DBDEF_DeleteServiceFromFavouriteList (ADB_FAVLIST_REC *fav_list, ADB_FAVSERV_REC *fav_serv)
	Delete the given service from the given favourite list. More...
void	DBDEF_DeleteAllServicesFromFavouriteList (ADB_FAVLIST_REC *fav_list)
	Delete the all services from the given favourite list. More...
void	DBDEF_SetFavouriteListName (ADB_FAVLIST_REC *f_ptr, U8BIT *name)
	Set or change the name of the given favourite list. More...
BOOLEAN	DBDEF_ServiceForTunerType (ADB_SERVICE_REC *s_ptr, E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
	Checks whether the given service is a terrestrial, cable or satellite service, and optionally check whether it's on a particular satellite. More...
BOOLEAN	DBDEF_TransportForTunerType (ADB_TRANSPORT_REC *t_ptr, E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
	Checks whether the given transport is a terrestrial, cable or satellite transport, and optionally check whether it's on a particular satellite. More...
ADB_TIMER_REC *	DBDEF_AddTimerRec (BOOLEAN store_in_nvm)
	Creates a new timer record in the database, assigning it a unique handle. More...
ADB_TIMER_REC *	DBDEF_FindTimerRec (U32BIT handle)
	Returns the timer record with the given timer handle. More...
ADB_TIMER_REC *	DBDEF_GetNextTimerRec (ADB_TIMER_REC *timer_ptr)
	Returns the next timer record after the one given. If the argument is NULL then the first record is returned. More...
void	DBDEF_SortTimers (BOOLEAN date_time_order)
	Sorts timer list into date/time or alphabetical order. More...
void	DBDEF_DeleteTimerRec (ADB_TIMER_REC *timer)
	Deletes the given timer from the database. More...
U16BIT	DBDEF_GetNumProfiles (void)
	Returns the number of network profiles.
U16BIT	DBDEF_GetProfileList (void ***profile_list, U16BIT *active_profile)
	Gets a list of the available network profiles. More...
void	DBDEF_ReleaseProfileList (void **profile_list, U16BIT num_profiles)
	Frees a profile list returned by DBDEF_GetProfileList. More...
BOOLEAN	DBDEF_IsActiveProfile (ADB_NETWORK_REC *profile)
	Is the given profile the currently active profile? More...
ADB_PROFILE_TYPE	DBDEF_GetCurrentProfileType (void)
	Returns the current profile type. More...
void	DBDEF_SelectBroadcastProfile (void)
	Sets the broadcast profile type for for all network, transport and service record accesses.
void	DBDEF_PushBroadcastProfile (void)
	Saves the current profile and any related data so that it can restored using DBDEF_PopProfile(), and sets the broadcast profile type for for all network, transport and service record accesses.
void	DBDEF_PopProfile (void)
	Restores a previously pushed profile.
BOOLEAN	DBDEF_ServiceInProfile (ADB_SERVICE_REC *s_ptr)
	Checks whether the given service is valid for the current profile. There may be multiple CI+ profiles and so data related to the CAM is also checked. More...
BOOLEAN	DBDEF_TransportInProfile (ADB_TRANSPORT_REC *t_ptr)
	Checks whether the given transport is valid for the current profile. There may be multiple CI+ profiles and so data related to the CAM is also checked. More...
BOOLEAN	DBDEF_NetworkInProfile (ADB_NETWORK_REC *n_ptr)
	Checks whether the given network is valid for the current profile. There may be multiple CI+ profiles and so data related to the CAM is also checked. More...
ADB_NETWORK_REC *	DBDEF_FindOrAddPrivateNetwork (void *satellite)
	Find or add a private network, assigning an unused private network ID. More...
ADB_STRING *	DBDEF_MakeString (U32BIT lang_code, U8BIT *str_ptr, U16BIT nbytes)
	Creates an ADB_STRING, copying the given data into it. If the string passed in is NULL or the number of bytes is 0, then no string will be created. More...
ADB_STRING *	DBDEF_CopyString (ADB_STRING *src_str)
	Creates a copy of the given ADB_STRING. More...
ADB_STRING *	DBDEF_ConcatSIString (ADB_STRING *str1, SI_STRING_DESC *str2)
	Concatenates an SI_STRING_DESC string to the end of an ADB_STRING string, removing any terminating '\0' chars from the first string, and returns a new string. More...
void	DBDEF_ReleaseString (ADB_STRING *string)
	Releases an ADB_STRING. More...

Detailed Description

Application database control.

Date

March 2003

Definition in file ap_dbdef.h.

Function Documentation

DBDEF_AddAnalogService()

BOOLEAN DBDEF_AddAnalogService

(

void

)

Adds an analogue service, transport and, if necessary, network to the database based on the current tuning parameters in the decode path.

Returns

TRUE if new service record successfully created

Definition at line 6825 of file ap_dbdef.c.

DBDEF_AddCableTransportRec()

ADB_TRANSPORT_REC* DBDEF_AddCableTransportRec	(	U32BIT	freq_hz,
		U32BIT	symbol_rate,
		ADB_NETWORK_REC *	network
	)

Adds a cable transport record with the given frequency and symbol rate.

Parameters

freq_hz	frequency in Hz
symbol_rate	symbol rate
network	network the transport is on

Returns

pointer to the new transport record or NULL if not created

Definition at line 4982 of file ap_dbdef.c.

DBDEF_AddCridRecord()

ADB_CRID_REC* DBDEF_AddCridRecord	(	U8BIT *	crid,
		BOOLEAN	series,
		BOOLEAN	recommended
	)

Creates a CRID record and adds it to the database.

Parameters

crid	CRID string
series	TRUE if this is a series CRID
recommended	TRUE if this is a recommended programme CRID

Returns

pointer to the created CRID record

Definition at line 8793 of file ap_dbdef.c.

DBDEF_AddFavouriteList()

ADB_FAVLIST_REC* DBDEF_AddFavouriteList	(	U8BIT	list_id,
		U8BIT *	name,
		U32BIT	user_data,
		S16BIT	index
	)

Creates a new favourite list and adds it to the list of favourite lists. Creation of the new list will fail if a list_id can't be found for it, or memory allocation fails.

Parameters

list_id	id to be given to the list, should be passed as 0 to have an id assigned. If an id is supplied and a list already exists with that id then no list will be created.
name	name to be given to the list, call be NULL
user_data	user defined valueto be stored in the list,
index	where to add the new list into the existing lists, 0 = at start, negative = at end, else 0 based index

Returns

pointer to new favourite list, or NULL on failure

Parameters

list_id	id to be given to the list, should be passed as 0 to have an id assigned. If an id is supplied and a list already exists with that id then no list will be created.
name	name to be given to the list, call be NULL
user_data	user defined value to be stored in the list,
index	where to add the new list into the existing lists, 0 = at start, negative = at end, else 0 based index

Returns

pointer to new favourite list, or NULL on failure

Definition at line 9061 of file ap_dbdef.c.

DBDEF_AddLNB()

ADB_LNB_REC* DBDEF_AddLNB	(	E_STB_DP_LNB_TYPE	type,
		ADB_STRING *	name
	)

Add an LNB record to the database.

Parameters

type	single, universal, unicable or used defined
name	LNB name, NULL for no name

Returns

pointer to the new LNB record or NULL if not created

Definition at line 4012 of file ap_dbdef.c.

DBDEF_AddLNBBandRec()

ADB_LNB_BAND_REC* DBDEF_AddLNBBandRec	(	S_STB_DP_LNB_BAND *	band_parameters,
		ADB_LNB_REC *	associated_lnb
	)

Add an LNB band record to the database.

Parameters

band_parameters	Structure describing the band and the expected LNB behaviour.
associated_lnb	LNB record the band record is associated with.

Returns

pointer to the new LNB band record or NULL if not created

Definition at line 4506 of file ap_dbdef.c.

DBDEF_AddNetworkRec()

ADB_NETWORK_REC* DBDEF_AddNetworkRec	(	U16BIT	net_id,
		ADB_SATELLITE_REC *	satellite
	)

Adds a new network record to the database with the given network ID.

Parameters

net_id	network ID
satellite	satellite that contains the network, can be NULL

Returns

pointer to new network record

Definition at line 4644 of file ap_dbdef.c.

DBDEF_AddSatelliteRec()

ADB_SATELLITE_REC* DBDEF_AddSatelliteRec	(	ADB_STRING *	name_str,
		U16BIT	dish_pos,
		U16BIT	long_pos,
		BOOLEAN	east_west,
		ADB_LNB_REC *	associated_lnb
	)

Add a satellite record to the database.

Parameters

name_str	satellite name
dish_pos
long_pos	position in 1/10ths of a degree
east_west	TRUE=east, FALSE=west
associated_lnb	LNB record the satellite record is associated with

Returns

pointer to the new satellite record or NULL if not created

Definition at line 4378 of file ap_dbdef.c.

DBDEF_AddSatTransportRec()

ADB_TRANSPORT_REC* DBDEF_AddSatTransportRec	(	U32BIT	freq_hz,
		U16BIT	symbol_rate,
		E_STB_DP_POLARITY	polarity,
		BOOLEAN	dvb_s2,
		E_STB_DP_MODULATION	modulation,
		ADB_NETWORK_REC *	network
	)

Adds a satellite transport record with the given frequency, symbol rate and polarity.

Parameters

freq_hz	frequency in Hz
symbol_rate	symbol rate
polarity	polarity
dvb_s2	TRUE for DVB-S2
modulation	modulation type
network	network the transport is on

Returns

pointer to the new transport record or NULL if not created

Definition at line 5102 of file ap_dbdef.c.

DBDEF_AddServiceRec()

ADB_SERVICE_REC* DBDEF_AddServiceRec	(	U16BIT	serv_id,
		ADB_TRANSPORT_REC *	t_ptr
	)

Adds a new service record to the service database with the given service ID and parent transport.

Parameters

serv_id	service ID for the new service
t_ptr	parent transport for the new service

Returns

pointer to the new service, or NULL if the creation fails

Definition at line 5598 of file ap_dbdef.c.

DBDEF_AddServiceToFavouriteList()

ADB_FAVSERV_REC* DBDEF_AddServiceToFavouriteList	(	ADB_FAVLIST_REC *	fav_list,
		ADB_SERVICE_REC *	serv_ptr,
		S16BIT	index
	)

Adds a new service to the given favourite list at the given position.

Parameters

fav_list	list service is to be added to
serv_ptr	service to be added to the list
index	position to add the service in the list, 0 = at start, negative = at end, any other value is the position

Returns

new favourite service record, or NULL on failure

Definition at line 9404 of file ap_dbdef.c.

DBDEF_AddTerrestrialTransportRec()

ADB_TRANSPORT_REC* DBDEF_AddTerrestrialTransportRec	(	U32BIT	freq_hz,
		U8BIT	plp_id,
		ADB_NETWORK_REC *	network
	)

Adds a terrestrial transport record with the given frequency and PLP id.

Parameters

freq_hz	frequency in Hz
plp_id	PLP id for T2, pass 0 for T
network	network the transport is on

Returns

pointer to the new transport record or NULL if not created

Definition at line 4874 of file ap_dbdef.c.

DBDEF_AddTimerRec()

ADB_TIMER_REC* DBDEF_AddTimerRec

(

BOOLEAN

store_in_nvm

)

Creates a new timer record in the database, assigning it a unique handle.

Parameters

store_in_nvm

save the timer in non-volatile memory

Returns

pointer to the new timer, or NULL on failure

Definition at line 9833 of file ap_dbdef.c.

DBDEF_AllocateLcns()

BOOLEAN DBDEF_AllocateLcns	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		BOOLEAN	assign_lcns
	)

allocates lcns - expects allocated lcn for all services to be 0

Parameters

assign_lcns	- if set to FALSE the LCNs assigned to the services as a result of running this function will be reset at the end.
use_target_region	- TRUE if the target region info is to be used when services with duplicate LCNs are encountered.

Returns

BOOLEAN - TRUE if more than one service requires the same LCN

Definition at line 7038 of file ap_dbdef.c.

DBDEF_ConcatSIString()

ADB_STRING* DBDEF_ConcatSIString	(	ADB_STRING *	str1,
		SI_STRING_DESC *	str2
	)

Concatenates an SI_STRING_DESC string to the end of an ADB_STRING string, removing any terminating '\0' chars from the first string, and returns a new string.

Parameters

str1	string 1
str2	string 2

Returns

new ADB_STRING containing the contents of both strings

Definition at line 3948 of file ap_dbdef.c.

DBDEF_CopyServiceRec()

ADB_SERVICE_REC* DBDEF_CopyServiceRec

(

ADB_SERVICE_REC *

orig_serv

)

Creates a copy of the given service, copying the service's attributes, e.g. service name, scrambled, locked, hidde, etc, but not the runtime specific data such as the stream list or event schedule data.

Parameters

orig_serv

service to be copied

Returns

new copied service, NULL on failure

Creates a copy of the given service, copying the service's attributes, e.g. service name, scrambled, locked, hidde, etc, but not the runtime specific data such as the stream list or event schedule data.

Parameters

orig_serv

service to be copied

Returns

new copied service, NULL on failure

Definition at line 5663 of file ap_dbdef.c.

DBDEF_CopyStreamList()

ADB_STREAM_REC* DBDEF_CopyStreamList

(

ADB_STREAM_REC *

slist

)

Creates a copy of a stream list, allocating new memory as required.

---

Parameters

slist

list of stream recs to be copied

Returns

copied stream list

Definition at line 1881 of file ap_dbdef.c.

DBDEF_CopyString()

ADB_STRING* DBDEF_CopyString

(

ADB_STRING *

src_str

)

Creates a copy of the given ADB_STRING.

Parameters

src_str

string to be copied

Returns

new ADB_STRING

Definition at line 3922 of file ap_dbdef.c.

DBDEF_DeleteAllServicesFromFavouriteList()

void DBDEF_DeleteAllServicesFromFavouriteList

(

ADB_FAVLIST_REC *

fav_list

)

Delete the all services from the given favourite list.

Parameters

fav_list

favourite list

Definition at line 9673 of file ap_dbdef.c.

DBDEF_DeleteAltServList()

void DBDEF_DeleteAltServList

(

ADB_ALT_SERV_REC *

aslist

)

Deletes all records in a service alternate service list.

Parameters

aslist

- the first alt serv record in the list

Definition at line 3797 of file ap_dbdef.c.

DBDEF_DeleteCridRecord()

void DBDEF_DeleteCridRecord

(

ADB_CRID_REC *

c_ptr

)

Deletes the given CRID record from the database.

Parameters

c_ptr

pointer to CRID record to be deleted

Definition at line 8939 of file ap_dbdef.c.

DBDEF_DeleteEventList()

void DBDEF_DeleteEventList

(

ADB_EVENT_REC *

elist

)

Deletes all events in the given list.

Parameters

elist

list of events to be deleted

Definition at line 3754 of file ap_dbdef.c.

DBDEF_DeleteFavouriteList()

void DBDEF_DeleteFavouriteList

(

ADB_FAVLIST_REC *

fav_list

)

Deletes the given favourite list.

Parameters

fav_list

favourite list to be deleted

Definition at line 9339 of file ap_dbdef.c.

DBDEF_DeleteImageIcons()

void DBDEF_DeleteImageIcons

(

ADB_IMAGE_ICON *

icon_list

)

Frees given list of image icons and any associated memory.

---

Parameters

icon_list

icon list to be freed

Definition at line 3849 of file ap_dbdef.c.

DBDEF_DeleteLNBBandRec()

void DBDEF_DeleteLNBBandRec

(

ADB_LNB_BAND_REC *

band_ptr

)

Deletes an LNB band record from the database.

Parameters

band_ptr

pointer to record to be deleted

Definition at line 4611 of file ap_dbdef.c.

DBDEF_DeleteNetworkRec()

void DBDEF_DeleteNetworkRec

(

ADB_NETWORK_REC *

n_ptr

)

Deletes specified network record.

Parameters

n_ptr

Pointer to network record

Definition at line 4696 of file ap_dbdef.c.

DBDEF_DeleteRCTLinks()

void DBDEF_DeleteRCTLinks

(

ADB_RCT_LINK_INFO *

links

)

Frees the given list of RCT links.

---

Parameters

links

links to be freed

Definition at line 3815 of file ap_dbdef.c.

DBDEF_DeleteRecordsForTunerType()

void DBDEF_DeleteRecordsForTunerType	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		void *	satellite
	)

Deletes all network, transport and services records for the given tuner type.

---

Parameters

tuner_type	tuner type
satellite	only used when tuner_type == SIGNAL_QPSK to specify the satellite from which services should be deleted. If tuner_type is SIGNAL_QPSK and satellite is NULL then all DVB-S services will be deleted.

Definition at line 1588 of file ap_dbdef.c.

DBDEF_DeleteServiceFromFavouriteList()

void DBDEF_DeleteServiceFromFavouriteList	(	ADB_FAVLIST_REC *	fav_list,
		ADB_FAVSERV_REC *	fav_serv
	)

Delete the given service from the given favourite list.

Parameters

fav_list	favourite list to delete service from
fav_serv	service to be deleted from the favourite list

Definition at line 9639 of file ap_dbdef.c.

DBDEF_DeleteServiceRec()

void DBDEF_DeleteServiceRec

(

ADB_SERVICE_REC *

s_ptr

)

Deletes specified service record.

Parameters

s_ptr

- pointer to service record

Definition at line 1754 of file ap_dbdef.c.

DBDEF_DeleteStreamList()

void DBDEF_DeleteStreamList

(

ADB_STREAM_REC *

slist

)

Deletes all records in a service stream list.

Parameters

slist

- the first stream record in the stream list

Definition at line 1941 of file ap_dbdef.c.

DBDEF_DeleteTimerRec()

void DBDEF_DeleteTimerRec

(

ADB_TIMER_REC *

timer

)

Deletes the given timer from the database.

Parameters

timer

timer to be deleted

Definition at line 9966 of file ap_dbdef.c.

DBDEF_DeleteTransportRec()

void DBDEF_DeleteTransportRec

(

ADB_TRANSPORT_REC *

t_ptr

)

Deletes the given transport from the service database.

Parameters

t_ptr

pointer to transport to be deleted

Deletes the given transport from the service database.

Parameters

t_ptr

pointer to transport to be deleted

Definition at line 5431 of file ap_dbdef.c.

DBDEF_FindCableTransportRec()

ADB_TRANSPORT_REC* DBDEF_FindCableTransportRec	(	U32BIT	freq_hz,
		U32BIT	symbol_rate
	)

Find the cable transport record in the database matching the given params.

Parameters

freq_hz	frequency in Hz
symbol_rate	symbol rate

Returns

pointer to the transport record or NULL if not found

Definition at line 5040 of file ap_dbdef.c.

DBDEF_FindEventDescriptor()

ADB_EVENT_DESC* DBDEF_FindEventDescriptor	(	ADB_EVENT_DESC *	start_desc,
		U8BIT	desc_tag,
		U32BIT	private_data_specifier
	)

Searches a descriptor list for the first descriptor with the given descriptor tag.

Parameters

start_desc	descriptor where the search should start
desc_tag	descriptor tag to be found
private_data_specifier	the value of the private data specifier that must precede the descriptor being searched for. Use 0 if it isn't required.

Returns

pointer to the descriptor, or NULL if not found

Definition at line 2003 of file ap_dbdef.c.

DBDEF_FindFavouriteList()

ADB_FAVLIST_REC* DBDEF_FindFavouriteList

(

U8BIT

list_id

)

Return the favourite list with the given list id.

Parameters

list_id

favourite list id to find

Returns

pointer to favourite list record, or NULL if not found

Definition at line 9237 of file ap_dbdef.c.

DBDEF_FindNetworkRec()

ADB_NETWORK_REC* DBDEF_FindNetworkRec	(	U16BIT	net_id,
		ADB_SATELLITE_REC *	satellite
	)

Finds the network with the given network ID.

Parameters

net_id	network ID to be found
satellite	satellite the network is on, can be NULL

Returns

pointer to network record, or NULL if not found

Definition at line 4772 of file ap_dbdef.c.

DBDEF_FindOrAddPrivateNetwork()

ADB_NETWORK_REC* DBDEF_FindOrAddPrivateNetwork

(

void *

satellite

)

Find or add a private network, assigning an unused private network ID.

Parameters

satellite

optional satellite, can be NULL

Returns

pointer to existing or new network record

Definition at line 10603 of file ap_dbdef.c.

DBDEF_FindSatTransportRec()

ADB_TRANSPORT_REC* DBDEF_FindSatTransportRec	(	U32BIT	freq_hz,
		U16BIT	symbol_rate,
		E_STB_DP_POLARITY	polarity,
		BOOLEAN	dvb_s2,
		E_STB_DP_MODULATION	modulation,
		void *	satellite
	)

Find the satellite transport record in the database matching the given params.

Parameters

freq_hz	frequency in Hz
symbol_rate	symbol rate
dvb_s2	TRUE if DVB-S2
modulation	modulation type

Returns

pointer to the transport record or NULL if not found

Definition at line 5170 of file ap_dbdef.c.

DBDEF_FindScheduleEventById()

ADB_EVENT_REC* DBDEF_FindScheduleEventById	(	ADB_SERVICE_REC *	s_ptr,
		U16BIT	event_id
	)

Find an event for a service from its event_id.

Parameters

s_ptr	service to be searched
event_id	ID of the event to be found

Returns

pointer to the ADB_EVENT_REC, or NULL if not found

Definition at line 1967 of file ap_dbdef.c.

DBDEF_FindServiceInFavouriteList()

ADB_FAVSERV_REC* DBDEF_FindServiceInFavouriteList	(	ADB_FAVLIST_REC *	fav_list,
		void *	serv_ptr
	)

Returns the ADB_FAVSERV_REC from the given favourite list for the given service.

Parameters

fav_list	favourite list to be searched
serv_ptr	service to be searched for

Returns

pointer to service record, or NULL if not found

Definition at line 9501 of file ap_dbdef.c.

DBDEF_FindServiceRec()

ADB_SERVICE_REC* DBDEF_FindServiceRec	(	U16BIT	serv_id,
		ADB_TRANSPORT_REC *	t_ptr
	)

Search for the service with the given service ID on the given transport.

Parameters

serv_id	service ID
t_ptr	transport to be searched

Returns

pointer to the service, or NULL if no service found

Definition at line 6119 of file ap_dbdef.c.

DBDEF_FindServiceRecByFreesatId()

ADB_SERVICE_REC* DBDEF_FindServiceRecByFreesatId	(	ADB_SERVICE_REC *	servp,
		U16BIT	freesat_id
	)

Search for a service with the given Freesat ID.

Parameters

servp	start searching from this service, NULL to start from first service
freesat_id	Freesat service ID

Returns

pointer to the next service found, or NULL if no service found

Definition at line 6252 of file ap_dbdef.c.

DBDEF_FindServiceRecByIds()

ADB_SERVICE_REC* DBDEF_FindServiceRecByIds	(	ADB_SERVICE_REC *	servp,
		U32BIT	net_id,
		U32BIT	onet_id,
		U32BIT	tran_id,
		U32BIT	serv_id
	)

Search for a service with the given IDs.

Parameters

servp	start searching from this service, NULL to start from first service
net_id	network ID, use ADB_INVALID_DVB_ID if not to be used
onet_id	original network ID, use ADB_INVALID_DVB_ID if not to be used
tran_id	transport ID, use ADB_INVALID_DVB_ID if not to be used
serv_id	service ID, use ADB_INVALID_DVB_ID if not to be used

Returns

pointer to the next service found, or NULL if no service found

Definition at line 6150 of file ap_dbdef.c.

DBDEF_FindServiceRecByLcn()

ADB_SERVICE_REC* DBDEF_FindServiceRecByLcn	(	U16BIT	lcn,
		ADB_TRANSPORT_REC *	t_ptr,
		BOOLEAN	allocated_lcn
	)

Find the service with the given LCN, and optionally on the given transport.

Parameters

lcn	LCN
t_ptr	transport the service must be on, use NULL for any transport
allocated_lcn	TRUE if the search should be based on the LCN a service has been allocated rather than the one it requested (its service LCN)

Returns

pointer to service if found, NULL otherwise

Definition at line 6218 of file ap_dbdef.c.

DBDEF_FindTerrestrialTransportRec()

ADB_TRANSPORT_REC* DBDEF_FindTerrestrialTransportRec	(	U32BIT	freq_hz,
		U8BIT	plp_id
	)

Find the terrestrial transport record in the database matching the given params.

Parameters

freq_hz	frequency in Hz
plp_id	PLP id for T2, pass 0 to T

Returns

pointer to the transport record or NULL if not found

Definition at line 4952 of file ap_dbdef.c.

DBDEF_FindTimerRec()

ADB_TIMER_REC* DBDEF_FindTimerRec

(

U32BIT

handle

)

Returns the timer record with the given timer handle.

Parameters

handle

timer handle

Returns

pointer to the timer record, or NULL if not found

Definition at line 9899 of file ap_dbdef.c.

DBDEF_FindTransportRecByIds()

ADB_TRANSPORT_REC* DBDEF_FindTransportRecByIds	(	ADB_TRANSPORT_REC *	transp,
		U32BIT	net_id,
		U32BIT	onet_id,
		U32BIT	tran_id
	)

Find a transport record matching the given set of IDs, starting from the given transport.

Parameters

transp	start search from this transport, use NULL to start from the first transport
net_id	network ID, use ADB_INVALID_DVB_ID to ignore this value
onet_id	original network ID, use ADB_INVALID_DVB_ID to ignore this value
tran_id	transport ID, use ADB_INVALID_DVB_ID to ignore this value

Returns

pointer to transport record, NULL if none found

Definition at line 5314 of file ap_dbdef.c.

DBDEF_GetAudioLang()

U8BIT* DBDEF_GetAudioLang

(

void

)

returns current audio lang

Returns

lang id

Definition at line 8223 of file ap_dbdef.c.

DBDEF_GetCurrentProfileType()

ADB_PROFILE_TYPE DBDEF_GetCurrentProfileType

(

void

)

Returns the current profile type.

Returns

Current profile type in use

Definition at line 10163 of file ap_dbdef.c.

DBDEF_GetDeletedServiceList()

U16BIT DBDEF_GetDeletedServiceList	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		void ***	slist_ptr
	)

Parameters

tuner_type	type of tuner that will be used for the search, if SIGNAL_NONE is specified then all services marked as deleted will be returned
slist_ptr	pointer to an array that will be allocated, value will be NULL on return if there are no services. The list must be freed using STB_AppFreeMemory

Returns

number of services in the returned list

Definition at line 6772 of file ap_dbdef.c.

DBDEF_GetEventAudioDescriptionFlag()

BOOLEAN DBDEF_GetEventAudioDescriptionFlag

(

ADB_EVENT_REC *

e_ptr

)

Returns whether audio description is signalled as being available for the given event.

Parameters

e_ptr

event

Returns

TRUE if available, FALSE otherwise

Definition at line 2984 of file ap_dbdef.c.

DBDEF_GetEventComponentList()

U8BIT DBDEF_GetEventComponentList	(	ADB_EVENT_REC *	e_ptr,
		ADB_EVENT_COMPONENT_INFO **	component_list
	)

Retrieves a list of components associated with the specified event, as described by component descriptors in the EIT.

Parameters

e_ptr	Pointer to the event
component_list	Pointer to the returned list of components. The list must be freed by calling STB_AppFreeMemory, provided the returned number of components is greater than 0.

Returns

Number of components associated with the specified event.

Definition at line 3298 of file ap_dbdef.c.

DBDEF_GetEventContentData()

U8BIT* DBDEF_GetEventContentData	(	ADB_EVENT_REC *	e_ptr,
		U8BIT *	p_len
	)

Returns the level 1 and 2 values for all content identifiers for the given event.

Parameters

e_ptr	event
p_len	address to return the number of bytes in the returned data

Returns

pointer to the content data

Parameters

event_ptr	event
p_len	address to return the number of bytes in the returned data

Returns

pointer to the content data

Definition at line 3406 of file ap_dbdef.c.

DBDEF_GetEventCrid()

U8BIT* DBDEF_GetEventCrid	(	ADB_SERVICE_REC *	serv_ptr,
		ADB_EVENT_REC *	e_ptr,
		U8BIT	crid_type,
		U8BIT	index
	)

Returns the full CRID of the type given for the given event.

Parameters

serv_ptr	service for the event
e_ptr	event CRID to be returned
crid_type	CRID type to be returned (CRID_TYPE_PROGRAMME, CRID_TYPE_SERIES, or CRID_TYPE_RECOMMENDATION)
index	the index of the CRID to be returned (only valid for series CRIDs)

Returns

pointer to a string containing the CRID name, or NULL if the event doesn't have the requested CRID type

Parameters

serv_ptr	service for the event
event_ptr	event CRID to be returned
crid_type	CRID type to be returned
index	the index of the CRID to be returned (only valid for series CRIDs)

Returns

pointer to a string containing the CRID name, or NULL if the event doesn't have the requested CRID type

Definition at line 3515 of file ap_dbdef.c.

DBDEF_GetEventDescription()

U8BIT* DBDEF_GetEventDescription

(

ADB_EVENT_REC *

e_ptr

)

Returns the short event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters

e_ptr

event

Returns

pointer to UTF-8 string, NULL on error

Definition at line 2175 of file ap_dbdef.c.

DBDEF_GetEventExtendedDescription()

U8BIT* DBDEF_GetEventExtendedDescription

(

ADB_EVENT_REC *

e_ptr

)

Returns the extended event description text of the event as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters

e_ptr

event

Returns

pointer to UTF-8 string, NULL on error

Definition at line 2302 of file ap_dbdef.c.

DBDEF_GetEventGenre()

ADB_EVENT_CONTENT DBDEF_GetEventGenre	(	ADB_EVENT_REC *	e_ptr,
		ADB_SERVICE_REC *	s_ptr
	)

Returns the genre of an event.

Parameters

e_ptr	event
s_ptr	service containing the event

Returns

event content value, ADB_EVENT_CONTENT_UNCLASSIFIED if not available

Definition at line 3440 of file ap_dbdef.c.

DBDEF_GetEventGuidance()

U8BIT* DBDEF_GetEventGuidance	(	ADB_EVENT_REC *	e_ptr,
		ADB_SERVICE_REC *	s_ptr,
		U8BIT *	type,
		U8BIT *	mode
	)

Returns the guidance text for an event, either from the event itself or the event's service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters

e_ptr	event, can be NULL, in which case any guidance defined by the service will be returned
s_ptr	service, can be NULL to just get guidance text from the event
type	pointer to value to return the guidance type, valid if guidance text is returned
mode	pointer to value to return the guidance mode, valid if guidance text is returned

Returns

pointer to UTF-8 guidance string, NULL if there isn't any guidance text

Definition at line 2732 of file ap_dbdef.c.

DBDEF_GetEventHDLinkageInfo()

BOOLEAN DBDEF_GetEventHDLinkageInfo	(	ADB_EVENT_REC *	e_ptr,
		BOOLEAN	verify_event,
		BOOLEAN	only_simulcast,
		ADB_SERVICE_REC **	hd_serv_ptr,
		ADB_EVENT_REC **	hd_event_ptr
	)

Returns whether there's an HD event linked to the SD event and returns the info for it. The DVB info is checked to ensure it relates to a known service.

Parameters

e_ptr	pointer to the event to check
verify_event	TRUE, if the schedule should be checked for the target event
only_simulcast	TRUE, if only an HD simulcast event should be returned
hd_serv_ptr	pointer to return the service for the HD event, if found. This can be NULL if not required.
hd_event_ptr	pointer to return the HD event, if found. Note that this will only be filled in if verify_event is TRUE. This can be NULL if not required.

Returns

TRUE if an event is found, FALSE otherwise

Definition at line 3042 of file ap_dbdef.c.

DBDEF_GetEventItemizedDescription()

ADB_EVENT_ITEMIZED_INFO* DBDEF_GetEventItemizedDescription	(	ADB_EVENT_REC *	e_ptr,
		U16BIT *	num_items_ptr
	)

Returns the items of extended event descriptor as item descriptor and item itself.

Parameters

e_ptr	event
num_items_ptr	address in which to return the number of items

Returns

ADB_EVENT_ITEMIZED_INFO pointer to the list of items, NULL on error

Definition at line 2503 of file ap_dbdef.c.

DBDEF_GetEventName()

U8BIT* DBDEF_GetEventName

(

ADB_EVENT_REC *

e_ptr

)

Returns the name of the event as a UTF-8 string in the currently selected language. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters

e_ptr

event

Returns

pointer to UTF-8 string, NULL on error

Definition at line 2055 of file ap_dbdef.c.

DBDEF_GetEventParentalAge()

U8BIT DBDEF_GetEventParentalAge

(

ADB_EVENT_REC *

e_ptr

)

Returns the parental age value for the given event.

Parameters

e_ptr

event

Returns

parental age value, 0 for invalid event

Definition at line 2938 of file ap_dbdef.c.

DBDEF_GetEventSubtitlesAvailFlag()

BOOLEAN DBDEF_GetEventSubtitlesAvailFlag

(

ADB_EVENT_REC *

e_ptr

)

Returns whether DVB subtitles are signalled as being available for the given event.

Parameters

e_ptr

event

Returns

TRUE if subtitles are available, FALSE otherwise

Definition at line 3363 of file ap_dbdef.c.

DBDEF_GetFullCrid()

U8BIT* DBDEF_GetFullCrid	(	ADB_SERVICE_REC *	serv_ptr,
		U8BIT *	event_str
	)

Returns the full CRID for the given CRID string The returned string should be freed using STB_AppFreeMemory.

Parameters

serv_ptr	service for the event
event_str	CRID string

Returns

pointer to a string containing the CRID name

Definition at line 3649 of file ap_dbdef.c.

DBDEF_GetNextCridRecord()

ADB_CRID_REC* DBDEF_GetNextCridRecord

(

ADB_CRID_REC *

c_ptr

)

Returns the next CRID record after the one specified. If the record specified is NULL then the first record is returned.

Parameters

c_ptr

CRID record pointer, NULL if first record is required

Returns

pointer to the next record after the one specified

Definition at line 8982 of file ap_dbdef.c.

DBDEF_GetNextFavouriteList()

ADB_FAVLIST_REC* DBDEF_GetNextFavouriteList

(

ADB_FAVLIST_REC *

fav_list

)

Returns the favourite list following the given item.

Parameters

fav_list

return the item after this one, if NULL, returns the first item

Returns

next favourite list, or NULL if no more

Definition at line 9212 of file ap_dbdef.c.

DBDEF_GetNextLNBBandRec()

ADB_LNB_BAND_REC* DBDEF_GetNextLNBBandRec

(

ADB_LNB_BAND_REC *

band_ptr

)

Returns the next LNB band record after the one given. If the argument is NULL then the first record is returned.

Parameters

band_ptr

LNB band record pointer, NULL if first record is required

Returns

pointer to next LNB band record

Definition at line 4587 of file ap_dbdef.c.

DBDEF_GetNextLNBRec()

ADB_LNB_REC* DBDEF_GetNextLNBRec

(

ADB_LNB_REC *

lnb_ptr

)

Returns the next LNB record after the one given. If the argument is NULL then the first record is returned.

Parameters

lnb_ptr

LNB record pointer, NULL if first record is required

Returns

pointer to next LNB record

Definition at line 4338 of file ap_dbdef.c.

DBDEF_GetNextNetworkRec()

ADB_NETWORK_REC* DBDEF_GetNextNetworkRec

(

ADB_NETWORK_REC *

n_ptr

)

Returns the network following the one given. If the argument is NULL then the first network will be returned.

Parameters

n_ptr

network record, NULL if first network is required

Returns

pointer to next network, NULL if no more networks

Definition at line 4800 of file ap_dbdef.c.

DBDEF_GetNextSatelliteRec()

ADB_SATELLITE_REC* DBDEF_GetNextSatelliteRec

(

ADB_SATELLITE_REC *

sat_ptr

)

Returns the next satellite record after the one given. If the argument is NULL then the first record is returned.

Parameters

sat_ptr

satellite record pointer, NULL if first record is required

Returns

pointer to next satellite record

Definition at line 4469 of file ap_dbdef.c.

DBDEF_GetNextServiceFromFavouriteList()

ADB_FAVSERV_REC* DBDEF_GetNextServiceFromFavouriteList	(	ADB_FAVLIST_REC *	fav_list,
		ADB_FAVSERV_REC *	fav_serv
	)

Returns the next favourite list service record.

Parameters

fav_list	favourite list
fav_serv	current service, or NULL if first service to be returned

Returns

pointer to service record, or NULL if no more services

Definition at line 9529 of file ap_dbdef.c.

DBDEF_GetNextServiceOnTransport()

ADB_SERVICE_REC* DBDEF_GetNextServiceOnTransport	(	ADB_SERVICE_REC *	s_ptr,
		ADB_TRANSPORT_REC *	t_ptr
	)

Find the next service following the given service that's on the given transport.

Parameters

s_ptr	find the service after this one, use NULL to get the first service
t_ptr	transport the service is on

Returns

pointer to the service found, or NULL if not found

Definition at line 6083 of file ap_dbdef.c.

DBDEF_GetNextServiceRec()

ADB_SERVICE_REC* DBDEF_GetNextServiceRec

(

ADB_SERVICE_REC *

s_ptr

)

Returns the service after the one given. If NULL is passed then the first service in the list is returned.

Parameters

s_ptr

pointer to service, NULL if first service is to be returned

Returns

pointer to service, or NULL if no more services

Definition at line 5535 of file ap_dbdef.c.

DBDEF_GetNextTimerRec()

ADB_TIMER_REC* DBDEF_GetNextTimerRec

(

ADB_TIMER_REC *

timer_ptr

)

Returns the next timer record after the one given. If the argument is NULL then the first record is returned.

Parameters

timer_ptr

timer record pointer, NULL if first record is required

Returns

pointer to next timer record

Definition at line 9922 of file ap_dbdef.c.

DBDEF_GetNextTransportRec()

ADB_TRANSPORT_REC* DBDEF_GetNextTransportRec

(

ADB_TRANSPORT_REC *

t_ptr

)

Returns the transport following the one given. If the argument is NULL then the first transport will be returned.

Parameters

t_ptr

transport record, NULL if first transport is required

Returns

pointer to next transport, NULL if no more transports

Definition at line 4842 of file ap_dbdef.c.

DBDEF_GetNumCridRecords()

U16BIT DBDEF_GetNumCridRecords

(

void

)

Returns the number of CRID records in the database.

Returns

number of records

Definition at line 8969 of file ap_dbdef.c.

DBDEF_GetNumDeletedServices()

U16BIT DBDEF_GetNumDeletedServices

(

E_STB_DP_SIGNAL_TYPE

tuner_type

)

Returns the number of services that are marked as deleted for the given tuner type.

Parameters

tuner_type

type of tuner that will be used for the search, if SIGNAL_NONE is specified then all services marked as deleted will be returned

Returns

number of services

Definition at line 6737 of file ap_dbdef.c.

DBDEF_GetNumFavouriteLists()

U16BIT DBDEF_GetNumFavouriteLists

(

void

)

Returns the number of favourite lists.

Returns

number of favourite lists

Definition at line 9041 of file ap_dbdef.c.

DBDEF_GetNumLNBBands()

U16BIT DBDEF_GetNumLNBBands

(

void

)

Returns the number of LNB band records in the database.

Returns

number of LNB band records

Definition at line 4493 of file ap_dbdef.c.

DBDEF_GetNumLNBs()

U16BIT DBDEF_GetNumLNBs

(

void

)

Returns the number of LNB records in the database.

Returns

number of LNB records

Definition at line 3999 of file ap_dbdef.c.

DBDEF_GetNumNetworks()

U16BIT DBDEF_GetNumNetworks

(

void

)

Returns the number of networks in ther service database.

Returns

number of transports

Definition at line 4631 of file ap_dbdef.c.

DBDEF_GetNumSatellites()

U16BIT DBDEF_GetNumSatellites

(

void

)

Returns the number of satellite records in the database.

Returns

number of satellite records

Definition at line 4362 of file ap_dbdef.c.

DBDEF_GetNumServices()

U16BIT DBDEF_GetNumServices

(

void

)

Returns the total number of services.

Returns

total number of services

Definition at line 5506 of file ap_dbdef.c.

DBDEF_GetNumServicesInFavouriteList()

U16BIT DBDEF_GetNumServicesInFavouriteList

(

ADB_FAVLIST_REC *

fav_list

)

Returns the number of services in the given favourite list.

Parameters

fav_list

favourite list

Returns

number of services

Definition at line 9389 of file ap_dbdef.c.

DBDEF_GetNumTransports()

U16BIT DBDEF_GetNumTransports

(

void

)

Returns the number of transports in ther service database.

Returns

number of transports

Definition at line 4829 of file ap_dbdef.c.

DBDEF_GetPrevServiceFromFavouriteList()

ADB_FAVSERV_REC* DBDEF_GetPrevServiceFromFavouriteList	(	ADB_FAVLIST_REC *	fav_list,
		ADB_FAVSERV_REC *	fav_serv
	)

Returns the previous favourite list service record.

Parameters

fav_list	favourite list
fav_serv	current service, or NULL if last service to be returned

Returns

pointer to service record, or NULL if no more services

Definition at line 9554 of file ap_dbdef.c.

DBDEF_GetPrevServiceRec()

ADB_SERVICE_REC* DBDEF_GetPrevServiceRec

(

ADB_SERVICE_REC *

s_ptr

)

Returns the service before the one given. If NULL is passed then the last service in the list is returned.

Parameters

s_ptr

pointer to service, NULL if last service is to be returned

Returns

pointer to service, or NULL if no more services

Definition at line 5566 of file ap_dbdef.c.

DBDEF_GetProfileList()

U16BIT DBDEF_GetProfileList	(	void ***	profile_list,
		U16BIT *	active_profile
	)

Gets a list of the available network profiles.

Parameters

profile_list	address of pointer to an array that will be allocated by this function that will contain the profiles
active_profile	pointer to return the index of the currently active profile

Returns

number of profiles in the returned array

Definition at line 10031 of file ap_dbdef.c.

DBDEF_GetReqdADPid()

U16BIT DBDEF_GetReqdADPid	(	ADB_SERVICE_REC *	s_ptr,
		E_STB_DP_AUDIO_MODE *	ad_mode,
		ADB_STREAM_TYPE *	ad_type,
		BOOLEAN *	broadcast_mix
	)

Gets the appropriate audio description pid - looks first for the pid matching exactly the required audio settings in the database, then for the pid matching the default language, then the first audip pid in the stream list. If no pid found the returned pid value will be 0.

Parameters

s_ptr	- service record ptr
ad_mode	- pointer to the returned channel setting (mono)
ad_type	- pointer to the returned stream type (codec)
broadcast_mix	- pointer to the returned boolean indicator of broadcast mix audio

Returns

required audio pid

Definition at line 6352 of file ap_dbdef.c.

DBDEF_GetReqdAudioPid()

U16BIT DBDEF_GetReqdAudioPid	(	ADB_SERVICE_REC *	s_ptr,
		E_STB_DP_AUDIO_MODE *	audio_mode,
		ADB_STREAM_TYPE *	audio_type
	)

Gets the appropriate audio pid - looks first for the pid matching exactly the required audio settings in the database, then for the pid matching the default language, then the first audip pid in the stream list. If no pid found the returned pid value will be 0.

Parameters

s_ptr	- service record ptr
audio_mode	- pointer to the returned channel setting (mono, stereo, left, right)
audio_type	- pointer to the returned stream type (codec)

Returns

required audio pid

Definition at line 6298 of file ap_dbdef.c.

DBDEF_GetReqdSubtitleParams()

E_STREAM_MATCH_TYPE DBDEF_GetReqdSubtitleParams	(	ADB_SERVICE_REC *	s_ptr,
		U16BIT *	pid_ptr,
		U16BIT *	cpage_ptr,
		U16BIT *	apage_ptr
	)

Gets the appropriate subtitle pid and page ids - looks first for the params matching exactly the required subtitle settings in the database, then for the pid matching the default language, then the first subtitle stream in the stream list. If no subtitles found the returned pid will be 0.

Parameters

s_ptr	- service record ptr
pid_ptr	- pointer for the return of the pid
cpage_ptr	- pointer for the return of the composition page
apage_ptr	- pointer for the return of the ancilliary page

Definition at line 6472 of file ap_dbdef.c.

DBDEF_GetReqdTtextPid()

E_STREAM_MATCH_TYPE DBDEF_GetReqdTtextPid	(	ADB_SERVICE_REC *	s_ptr,
		BOOLEAN	for_subtitles,
		U16BIT *	pid_ptr,
		U8BIT *	magazine,
		U8BIT *	page
	)

Gets the appropriate teletext pid - looks first for the params matching exactly the required teletext settings in the database, then for the pid matching the default language, then the first teletext stream in the stream list. If no teletext found the returned pid will be 0.

Parameters

s_ptr	- service record ptr
for_subtitles	- TRUE if subtitle stream is to be selected
magazine	- returns the magazine defined in the stream
page	- returns the defined page in the stream

Returns

The required PID value

Definition at line 6404 of file ap_dbdef.c.

DBDEF_GetReqdVideoPid()

U16BIT DBDEF_GetReqdVideoPid	(	ADB_SERVICE_REC *	s_ptr,
		ADB_STREAM_TYPE *	video_type
	)

Returns the video pid and type that should be used for the given service from the list of video streams available. The "best one" is based on HD being better than SD and uses the priorities from the Nordig spec.

---

Parameters

s_ptr	service
video_type	pointer used to return the type of the video selected

Returns

Selected video PID

Definition at line 6531 of file ap_dbdef.c.

DBDEF_GetSecondaryAudioLang()

U8BIT* DBDEF_GetSecondaryAudioLang

(

void

)

returns current secondary audio lang

Returns

lang id

Definition at line 8241 of file ap_dbdef.c.

DBDEF_GetSecondaryTextLang()

U8BIT* DBDEF_GetSecondaryTextLang

(

void

)

returns array of secondary text langs

Returns

lang ids

Definition at line 8169 of file ap_dbdef.c.

DBDEF_GetServiceDefaultAuthority()

U8BIT* DBDEF_GetServiceDefaultAuthority

(

ADB_SERVICE_REC *

s_ptr

)

Returns a copy of the default authority CRID string for the given service. This string will be returned as broadcast and should be freed using STB_AppFreMemory.

Parameters

c_ptr

pointer to CRID record

Returns

pointer to a copy of the CRID string, or NULL

Definition at line 3700 of file ap_dbdef.c.

DBDEF_GetServiceGuidance()

U8BIT* DBDEF_GetServiceGuidance

(

ADB_SERVICE_REC *

s_ptr

)

Returns the guidance text for the service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters

s_ptr

service

Returns

pointer to UTF-8 guidance string, NULL if there isn't any guidance text

Definition at line 2918 of file ap_dbdef.c.

DBDEF_GetServiceGuidanceData()

U8BIT* DBDEF_GetServiceGuidanceData	(	ADB_SERVICE_REC *	s_ptr,
		U8BIT *	type,
		U8BIT *	mode
	)

Returns the guidance text for the service, as a UTF-8 string. The returned string should be freed using STB_ReleaseUnicodeString.

Parameters

s_ptr	service
type	pointer to value to return the guidance type, valid if guidance text is returned
mode	pointer to value to return the guidance mode, valid if guidance text is returned

Returns

pointer to UTF-8 guidance string, NULL if there isn't any guidance text

Definition at line 2879 of file ap_dbdef.c.

DBDEF_GetServiceName()

ADB_STRING* DBDEF_GetServiceName	(	ADB_SERVICE_REC *	s_ptr,
		BOOLEAN	short_name,
		BOOLEAN	pref_name
	)

Returns a pointer to the service name, taking into account perferred names and short names, if available.

Parameters

s_ptr	service
short_name	TRUE if short name is to be returned, if available
pref_name	TRUE if preferred name is to be returned, if available

Returns

pointer to the service name

Definition at line 6586 of file ap_dbdef.c.

DBDEF_GetServicePmtPid()

U16BIT DBDEF_GetServicePmtPid

(

ADB_SERVICE_REC *

s_ptr

)

gets the PMT PID associated with the service

Parameters

s_ptr

pointer to the service

Returns

PMT PID

Definition at line 6980 of file ap_dbdef.c.

DBDEF_GetServiceProviderName()

ADB_STRING* DBDEF_GetServiceProviderName

(

ADB_SERVICE_REC *

s_ptr

)

Returns a pointer to the service provider name.

Parameters

s_ptr

service

Returns

pointer to the service provider name

Definition at line 6682 of file ap_dbdef.c.

DBDEF_GetTextLang()

U8BIT* DBDEF_GetTextLang

(

void

)

returns array of current text langs

Returns

lang ids

Definition at line 8133 of file ap_dbdef.c.

DBDEF_GetTransportAdditionalFrequencies()

void DBDEF_GetTransportAdditionalFrequencies	(	ADB_TRANSPORT_REC *	t_ptr,
		U8BIT *	num_freqs,
		U32BIT **	freqs
	)

Returns the additional frequencies associated with a transport. The returned array should not be modified or freed.

Parameters

t_ptr	transport being queried
num_freqs	pointer to a value that returns the number of additional frequencies in the array
freqs	pointer to an array that contains the additional frequencies

Definition at line 5408 of file ap_dbdef.c.

DBDEF_GetTunedNetwork()

ADB_NETWORK_REC* DBDEF_GetTunedNetwork

(

U8BIT

path

)

gets the currently tuned network

Returns

pointer to the network

Definition at line 8015 of file ap_dbdef.c.

DBDEF_GetTunedService()

ADB_SERVICE_REC* DBDEF_GetTunedService

(

U8BIT

path

)

Returns the currently tuned service on the given path.

---

Parameters

path	decode path

Returns

service pointer

Definition at line 8084 of file ap_dbdef.c.

DBDEF_GetTunedTransport()

ADB_TRANSPORT_REC* DBDEF_GetTunedTransport

(

U8BIT

path

)

gets the currently tuned transport

Returns

pointer to the transport

Definition at line 8053 of file ap_dbdef.c.

DBDEF_IsActiveProfile()

BOOLEAN DBDEF_IsActiveProfile

(

ADB_NETWORK_REC *

profile

)

Is the given profile the currently active profile?

Parameters

profile

profile

Returns

TRUE if the given profile is the currently active profile, FALSE otherwise

Definition at line 10122 of file ap_dbdef.c.

DBDEF_IsValidCridRecord()

BOOLEAN DBDEF_IsValidCridRecord

(

ADB_CRID_REC *

c_ptr

)

Checks whether the given crid record is in the list of valid crid records.

Parameters

c_ptr

crid record to look for

Returns

TRUE if crid record is valid, FALSE otherwise

Definition at line 9007 of file ap_dbdef.c.

DBDEF_LoadDatabase()

BOOLEAN DBDEF_LoadDatabase

(

U8BIT *

db_pathname

)

Loads the service database from non-volatile storage and creates the RAM version of this data that will be used by the DVB stack.

Parameters

db_pathname

pathname of the database file to be loaded, may be NULL or ignored if not relevant for the type of storage being used.

Returns

TRUE if the database is loaded, FALSE otherwise

Definition at line 259 of file ap_dbdef.c.

DBDEF_MakeString()

ADB_STRING* DBDEF_MakeString	(	U32BIT	lang_code,
		U8BIT *	str_ptr,
		U16BIT	nbytes
	)

Creates an ADB_STRING, copying the given data into it. If the string passed in is NULL or the number of bytes is 0, then no string will be created.

Parameters

lang_code	ISO 639-2 3 char language code
str_ptr	pointer to string data to be copied into the ADB_STRING
nbytes	number of bytes of string data

Returns

pointer to new ADB_STRING, or NULL

Definition at line 3890 of file ap_dbdef.c.

DBDEF_MoveFavouriteListServiceTo()

void DBDEF_MoveFavouriteListServiceTo	(	ADB_FAVLIST_REC *	fav_list,
		ADB_FAVSERV_REC *	fav_serv,
		S16BIT	index
	)

Changes the order of the services in the favourite list by moving the given service to the given position.

Parameters

fav_list	favourite list
fav_serv	service to be moved
index	position to move the service to

Returns

TRUE if successful, FALSE otherwise

Definition at line 9581 of file ap_dbdef.c.

DBDEF_MoveFavouriteListTo()

void DBDEF_MoveFavouriteListTo	(	ADB_FAVLIST_REC *	fav_list,
		S16BIT	index
	)

Changes the order of the favourite lists by moving the given list to the given position.

Parameters

fav_list	favourite list to be moved
index	position to move the list to

Returns

TRUE if successful, FALSE otherwise

Definition at line 9283 of file ap_dbdef.c.

DBDEF_NetworkInProfile()

BOOLEAN DBDEF_NetworkInProfile

(

ADB_NETWORK_REC *

n_ptr

)

Checks whether the given network is valid for the current profile. There may be multiple CI+ profiles and so data related to the CAM is also checked.

Parameters

n_ptr

network to be checked

Returns

TRUE if the network is in the current profile, FALSE otherwise

Definition at line 10348 of file ap_dbdef.c.

DBDEF_NumberOfCridsOfType()

U8BIT DBDEF_NumberOfCridsOfType	(	ADB_EVENT_REC *	e_ptr,
		U8BIT	crid_type
	)

Returns the number of CRIDs of the given type for the event.

Parameters

e_ptr	counting the CRIDs for this event
crid_type	CRID type to be returned (CRID_TYPE_PROGRAMME, CRID_TYPE_SERIES, or CRID_TYPE_RECOMMENDATION)

Returns

number of CRIDs found

Parameters

event_ptr	counting the CRIDs for this event
crid_type	CRID type to be returned

Returns

number of CRIDs found

Definition at line 3587 of file ap_dbdef.c.

DBDEF_NumStreamsInList()

U16BIT DBDEF_NumStreamsInList

(

ADB_STREAM_REC *

slist

)

Returns the number of stream records in the given list.

---

Parameters

slist

list of stream recs

Returns

Number of stream recs

Definition at line 1860 of file ap_dbdef.c.

DBDEF_ReleaseProfileList()

void DBDEF_ReleaseProfileList	(	void **	profile_list,
		U16BIT	num_profiles
	)

Frees a profile list returned by DBDEF_GetProfileList.

Parameters

profile_list	profile list to be freed
num_profiles	number of profiles in the list

Definition at line 10104 of file ap_dbdef.c.

DBDEF_ReleaseString()

void DBDEF_ReleaseString

(

ADB_STRING *

string

)

Releases an ADB_STRING.

Parameters

string

string to be freed

Definition at line 3983 of file ap_dbdef.c.

DBDEF_RemoveEmptyTransports()

void DBDEF_RemoveEmptyTransports	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		void *	satellite
	)

Delete all transport records that don't have any services.

Parameters

tuner_type	- empty transports of this signal type will be deleted
satellite	- if the signal type is SIGNAL_QPSK then this parameter specifies the satellite the transports must be on. Ignored if tuner type isn't SIGNAL_QPSK, and can be NULL to indicate all satellites.

Definition at line 8745 of file ap_dbdef.c.

DBDEF_SaveServiceEventSchedule()

void DBDEF_SaveServiceEventSchedule

(

ADB_SERVICE_REC *

s_ptr

)

Saves the event schedule of a service to the service database.

Parameters

s_ptr

event data to be saved for this service

Definition at line 5994 of file ap_dbdef.c.

DBDEF_ServiceForTunerType()

BOOLEAN DBDEF_ServiceForTunerType	(	ADB_SERVICE_REC *	s_ptr,
		E_STB_DP_SIGNAL_TYPE	tuner_type,
		void *	satellite
	)

Checks whether the given service is a terrestrial, cable or satellite service, and optionally check whether it's on a particular satellite.

Parameters

s_ptr	service to be checked
tuner_type	type of tuner to check
satellite	if tuner type is SIGNAL_QPSK then check whether the service is from this satellite. This can be NULL if the satellite isn't important and is ignored for a non-satellite tuner.

Returns

TRUE if the service is of the given type, FALSE otherwise

Definition at line 9775 of file ap_dbdef.c.

DBDEF_ServiceInProfile()

BOOLEAN DBDEF_ServiceInProfile

(

ADB_SERVICE_REC *

s_ptr

)

Checks whether the given service is valid for the current profile. There may be multiple CI+ profiles and so data related to the CAM is also checked.

Parameters

s_ptr

service to be checked

Returns

TRUE if the service isn't part of a network or is in the current profile, FALSE otherwise

Definition at line 10276 of file ap_dbdef.c.

DBDEF_SetAnalogServiceName()

void DBDEF_SetAnalogServiceName	(	ADB_SERVICE_REC *	s_ptr,
		U8BIT *	new_name,
		U8BIT	new_len
	)

Updates analog service names - ASSUMES NORMAL ASCII CODED.

Parameters

s_ptr	- service to be changed
new_name	- pointer to new name
new_len	- number of bytes in new name (incl null terminator)

Definition at line 6903 of file ap_dbdef.c.

DBDEF_SetAudioLang()

void DBDEF_SetAudioLang

(

U8BIT *

lang_ids

)

sets current audio lang

Parameters

lang_id

- id of required language

Definition at line 8187 of file ap_dbdef.c.

DBDEF_SetCridDateTime()

void DBDEF_SetCridDateTime	(	ADB_CRID_REC *	c_ptr,
		U32DHMS	date_time
	)

Sets the date and time fields in the crid record.

Parameters

c_ptr	pointer to CRID record
date_time	date & time to set in the crid

Definition at line 8845 of file ap_dbdef.c.

DBDEF_SetCridDoNotDelete()

void DBDEF_SetCridDoNotDelete	(	ADB_CRID_REC *	c_ptr,
		BOOLEAN	do_not_delete
	)

Sets the do not delete flag in the crid record.

Parameters

c_ptr	pointer to CRID record
do_not_delete	new value of the flag

Definition at line 8903 of file ap_dbdef.c.

DBDEF_SetCridProgrammeName()

void DBDEF_SetCridProgrammeName	(	ADB_CRID_REC *	c_ptr,
		U8BIT *	prog_name
	)

Sets the programme name field of the given CRID record.

Parameters

c_ptr	pointer to CRID record
prog_name	name string to save in the CRID record

Definition at line 8881 of file ap_dbdef.c.

DBDEF_SetCridService()

void DBDEF_SetCridService	(	ADB_CRID_REC *	c_ptr,
		U16BIT	serv_id
	)

Sets the service ID in the crid record.

Parameters

c_ptr	pointer to CRID record
serv_id	service ID

Definition at line 8863 of file ap_dbdef.c.

DBDEF_SetFavouriteListName()

void DBDEF_SetFavouriteListName	(	ADB_FAVLIST_REC *	f_ptr,
		U8BIT *	name
	)

Set or change the name of the given favourite list.

Parameters

f_ptr	pointer to favourite record to be updated
name	of the favourite list

Returns

void

Definition at line 9706 of file ap_dbdef.c.

DBDEF_SetFavouriteListUserData()

void DBDEF_SetFavouriteListUserData	(	ADB_FAVLIST_REC *	fav_list,
		U32BIT	user_data
	)

Saves the given user data with a favourite list.

Parameters

fav_list	favourite list
user_data	data to be stored with the list

Definition at line 9263 of file ap_dbdef.c.

DBDEF_SetLNB12V()

BOOLEAN DBDEF_SetLNB12V	(	ADB_LNB_REC *	lnb,
		BOOLEAN	is_12v
	)

Sets the LNB 12V setting.

Parameters

lnb	pointer to LNB record
is_12v	12V setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4110 of file ap_dbdef.c.

DBDEF_SetLNB22k()

BOOLEAN DBDEF_SetLNB22k	(	ADB_LNB_REC *	lnb,
		BOOLEAN	is_22k
	)

Sets the LNB 22k setting.

Parameters

lnb	pointer to LNB record
is_22k	22k setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4085 of file ap_dbdef.c.

DBDEF_SetLNBCSwitch()

BOOLEAN DBDEF_SetLNBCSwitch	(	ADB_LNB_REC *	lnb,
		E_STB_DP_DISEQC_CSWITCH	cswitch
	)

Sets the LNB committed switch setting.

Parameters

lnb	pointer to LNB record
cswitch	switch setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4210 of file ap_dbdef.c.

DBDEF_SetLNBDiSEqCPosition()

BOOLEAN DBDEF_SetLNBDiSEqCPosition	(	ADB_LNB_REC *	lnb,
		BOOLEAN	is_diseqc_posn
	)

Sets the LNB DiSEqC position setting.

Parameters

lnb	pointer to LNB record
is_diseqc_posn	diseqc position setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4160 of file ap_dbdef.c.

DBDEF_SetLNBDiSEqCTone()

BOOLEAN DBDEF_SetLNBDiSEqCTone	(	ADB_LNB_REC *	lnb,
		E_STB_DP_DISEQC_TONE	diseqc_tone
	)

Sets the LNB DiSEqC tone setting.

Parameters

lnb	pointer to LNB record
diseqc_tone	diseqc tone setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4185 of file ap_dbdef.c.

DBDEF_SetLNBPower()

BOOLEAN DBDEF_SetLNBPower	(	ADB_LNB_REC *	lnb,
		E_STB_DP_LNB_POWER	power
	)

Sets the LNB power setting.

Parameters

lnb	pointer to LNB record
power	power setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4060 of file ap_dbdef.c.

DBDEF_SetLNBPulsePosition()

BOOLEAN DBDEF_SetLNBPulsePosition	(	ADB_LNB_REC *	lnb,
		BOOLEAN	is_pulse_posn
	)

Sets the LNB pulse position setting.

Parameters

lnb	pointer to LNB record
is_pulse_posn	pulse position setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4135 of file ap_dbdef.c.

DBDEF_SetLNBRepeats()

BOOLEAN DBDEF_SetLNBRepeats	(	ADB_LNB_REC *	lnb,
		U8BIT	repeats
	)

Sets the LNB message repeat setting in the range 0 to 3.

Parameters

lnb	pointer to LNB record
repeats	repeat setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4285 of file ap_dbdef.c.

DBDEF_SetLNBSmatv()

BOOLEAN DBDEF_SetLNBSmatv	(	ADB_LNB_REC *	lnb,
		BOOLEAN	is_smatv
	)

Sets the LNB SMATV setting.

Parameters

lnb	pointer to LNB record
is_smatv	SMATV setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4260 of file ap_dbdef.c.

DBDEF_SetLNBUnicable()

BOOLEAN DBDEF_SetLNBUnicable	(	ADB_LNB_REC *	lnb,
		U32BIT	inter_freq,
		U8BIT	chan
	)

Sets the LNB Unicable settings.

Parameters

lnb	pointer to LNB record
inter_freq	intermediate frequency setting
chan	channel setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4311 of file ap_dbdef.c.

DBDEF_SetLNBUSwitch()

BOOLEAN DBDEF_SetLNBUSwitch	(	ADB_LNB_REC *	lnb,
		U8BIT	uswitch
	)

Sets the LNB uncommitted switch setting.

Parameters

lnb	pointer to LNB record
uswitch	switch setting

Returns

TRUE if value set successfully, FALSE otherwise

Definition at line 4235 of file ap_dbdef.c.

DBDEF_SetNetworkName()

void DBDEF_SetNetworkName	(	ADB_NETWORK_REC *	n_ptr,
		U8BIT *	name
	)

Set or change the name of the given network.

Parameters

n_ptr	pointer to network record to be updated
name	name to be given to the network, can be any format, or NULL to clear the network name

Definition at line 4708 of file ap_dbdef.c.

DBDEF_SetSatTransportTuningParams()

void DBDEF_SetSatTransportTuningParams	(	ADB_TRANSPORT_REC *	t_ptr,
		U32BIT	freq_hz,
		U16BIT	symbol_rate,
		E_STB_DP_POLARITY	polarity,
		BOOLEAN	dvb_s2,
		E_STB_DP_MODULATION	modulation,
		ADB_NETWORK_REC *	network
	)

Sets the tuning parameters for an existing satellite transport.

Parameters

t_ptr	satellite transport record
freq_hz	frequency in Hz
symbol_rate	symbol rate
polarity	polarity
dvb_s2	TRUE for DVB-S2
modulation	modulation type
network	network the transport is on, can be NULL

Definition at line 5271 of file ap_dbdef.c.

DBDEF_SetSecondaryAudioLang()

void DBDEF_SetSecondaryAudioLang

(

U8BIT *

lang_ids

)

sets the secondary audio lang

Parameters

lang_ids

- ids of required language

Definition at line 8205 of file ap_dbdef.c.

DBDEF_SetSecondaryTextLang()

void DBDEF_SetSecondaryTextLang

(

U8BIT *

lang_ids

)

sets secondary text lang

Parameters

lang_ids

- array of required language ids

Definition at line 8151 of file ap_dbdef.c.

DBDEF_SetServiceDeletedFlag()

void DBDEF_SetServiceDeletedFlag	(	ADB_SERVICE_REC *	s_ptr,
		BOOLEAN	deleted
	)

Marks whether a service is deleted or not.

Parameters

s_ptr	service
deleted	TRUE to mark the service as deleted, FALSE as available

Definition at line 6721 of file ap_dbdef.c.

DBDEF_SetServiceFavGroups()

void DBDEF_SetServiceFavGroups	(	ADB_SERVICE_REC *	s_ptr,
		U8BIT	groups
	)

Sets the favourite groups for a service.

Parameters

s_ptr	service
groups	bitmask containing the favourite groups the service is to be in

Definition at line 7001 of file ap_dbdef.c.

DBDEF_SetServiceName()

BOOLEAN DBDEF_SetServiceName	(	ADB_SERVICE_REC *	s_ptr,
		U8BIT *	name
	)

Set or change the name of a service.

Parameters

s_ptr	service
name	name to be given to the service, can be any format, or NULL to clear the current name

Returns

TRUE if the name is changed, FALSE otherwise

Definition at line 5783 of file ap_dbdef.c.

DBDEF_SetServicePmtPid()

void DBDEF_SetServicePmtPid	(	ADB_SERVICE_REC *	s_ptr,
		U16BIT	pmt_pid
	)

Updates the pmt pid.

Parameters

s_ptr	- service to be changed
pmt_pid	- PID of the PMT associated with the service

Definition at line 6959 of file ap_dbdef.c.

DBDEF_SetServiceProviderName()

BOOLEAN DBDEF_SetServiceProviderName	(	ADB_SERVICE_REC *	s_ptr,
		U8BIT *	name
	)

Set or change the name of a service's provider.

Parameters

s_ptr	service
name	name to be given to the service's provider, can be any format, or NULL to clear the current name

Returns

TRUE if the name is changed, FALSE otherwise

Definition at line 5910 of file ap_dbdef.c.

DBDEF_SetServiceShortName()

BOOLEAN DBDEF_SetServiceShortName	(	ADB_SERVICE_REC *	s_ptr,
		U8BIT *	name
	)

Set or change the short name of a service.

Parameters

s_ptr	service
name	new short name of the service, can be any format, or NULL to clear the current name

Returns

TRUE if the name is changed, FALSE otherwise

Definition at line 5850 of file ap_dbdef.c.

DBDEF_SetServiceType()

BOOLEAN DBDEF_SetServiceType	(	ADB_SERVICE_REC *	s_ptr,
		ADB_SERVICE_TYPE	serv_type
	)

Sets the service type for the given service record.

Parameters

s_ptr	service
serv_type	type of service

Returns

TRUE if the type is changed, FALSE otherwise

Definition at line 5969 of file ap_dbdef.c.

DBDEF_SetTextLang()

void DBDEF_SetTextLang

(

U8BIT *

lang_ids

)

sets current text lang

Parameters

lang_ids

- array of required language ids

Definition at line 8115 of file ap_dbdef.c.

DBDEF_SetTransportOrigNetworkId()

void DBDEF_SetTransportOrigNetworkId	(	ADB_TRANSPORT_REC *	t_ptr,
		U16BIT	orig_net_id
	)

Sets the original network ID of the given transport.

Parameters

t_ptr	transport record the ID will be set for
orig_net_id	original network ID to be set

Definition at line 5387 of file ap_dbdef.c.

DBDEF_SetTransportTransportId()

void DBDEF_SetTransportTransportId	(	ADB_TRANSPORT_REC *	t_ptr,
		U16BIT	tran_id
	)

Sets the transport ID of the given transport.

Parameters

t_ptr	transport record the ID will be set for
tran_id	transport ID to be set

Definition at line 5368 of file ap_dbdef.c.

DBDEF_SetTunedNetwork()

void DBDEF_SetTunedNetwork	(	U8BIT	path,
		ADB_NETWORK_REC *	n_ptr
	)

sets the currently tuned network

Parameters

t_ptr

- pointer to the network

Definition at line 7996 of file ap_dbdef.c.

DBDEF_SetTunedService()

void DBDEF_SetTunedService	(	U8BIT	path,
		ADB_SERVICE_REC *	s_ptr
	)

Sets the currently tuned service.

---

Parameters

path	decode path
s_ptr	service tuned to

Definition at line 8066 of file ap_dbdef.c.

DBDEF_SetTunedTransport()

void DBDEF_SetTunedTransport	(	U8BIT	path,
		ADB_TRANSPORT_REC *	t_ptr
	)

sets the currently tuned transport

Parameters

t_ptr

- pointer to the transport

Definition at line 8034 of file ap_dbdef.c.

DBDEF_SortTimers()

void DBDEF_SortTimers

(

BOOLEAN

date_time_order

)

Sorts timer list into date/time or alphabetical order.

Parameters

date_time_order

TRUE to sort into date/time order, FALSE for alphabetical

Definition at line 9946 of file ap_dbdef.c.

DBDEF_TidyDatabaseAfterSearch()

void DBDEF_TidyDatabaseAfterSearch	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		void *	satellite,
		BOOLEAN	search_completed,
		BOOLEAN	manual
	)

Calls any country and tuner type specific function to tidy up the database following a search, such as removing duplicate services, etc.

Parameters

tuner_type	tuner type used for the search
satellite	satellite search was performed on for SIGNAL_QPSK, ignored otherwise
search_completed	TRUE if the search completed, FALSE if terminated prematurely
manual	TRUE if a manual search was performed, FALSE otherwise

Definition at line 8256 of file ap_dbdef.c.

DBDEF_TidyDatabaseDefault()

void DBDEF_TidyDatabaseDefault	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		BOOLEAN	search_completed,
		BOOLEAN	manual
	)

Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country.

Parameters

tuner_type	tuner type used for the search
search_completed	TRUE if the search completed, FALSE if terminated prematurely
manual	TRUE if a manual search was performed, FALSE otherwise

Definition at line 8656 of file ap_dbdef.c.

DBDEF_TidyDatabaseNordig()

void DBDEF_TidyDatabaseNordig	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		BOOLEAN	search_completed,
		BOOLEAN	manual
	)

Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country.

Parameters

tuner_type	tuner type used for the search
search_completed	TRUE if the search completed, FALSE if terminated prematurely
manual	TRUE if a manual search was performed, FALSE otherwise

Definition at line 8332 of file ap_dbdef.c.

DBDEF_TidyDatabaseSatUK()

void DBDEF_TidyDatabaseSatUK	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		BOOLEAN	search_completed,
		BOOLEAN	manual
	)

Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country.

Parameters

tuner_type	tuner type used for the search
search_completed	TRUE if the search completed, FALSE if terminated prematurely
manual	TRUE if a manual search was performed, FALSE otherwise

Definition at line 8562 of file ap_dbdef.c.

DBDEF_TidyDatabaseUK()

void DBDEF_TidyDatabaseUK	(	E_STB_DP_SIGNAL_TYPE	tuner_type,
		BOOLEAN	search_completed,
		BOOLEAN	manual
	)

Iterates through all the services following a search search to see whether any need to be deleted based on the rules for that country.

Parameters

tuner_type	tuner type used for the search
search_completed	TRUE if the search completed, FALSE if terminated prematurely
manual	TRUE if a manual search was performed, FALSE otherwise

Definition at line 8474 of file ap_dbdef.c.

DBDEF_TransportForTunerType()

BOOLEAN DBDEF_TransportForTunerType	(	ADB_TRANSPORT_REC *	t_ptr,
		E_STB_DP_SIGNAL_TYPE	tuner_type,
		void *	satellite
	)

Checks whether the given transport is a terrestrial, cable or satellite transport, and optionally check whether it's on a particular satellite.

Parameters

t_ptr	transport to be checked
tuner_type	type of tuner to check
satellite	if tuner type is SIGNAL_QPSK then check whether the transport is from this satellite. This can be NULL if the satellite isn't important and is ignored for a non-satellite tuner.

Returns

TRUE if the transport is of the given type, FALSE otherwise

Definition at line 9805 of file ap_dbdef.c.

DBDEF_TransportInProfile()

BOOLEAN DBDEF_TransportInProfile

(

ADB_TRANSPORT_REC *

t_ptr

)

Checks whether the given transport is valid for the current profile. There may be multiple CI+ profiles and so data related to the CAM is also checked.

Parameters

t_ptr

transport to be checked

Returns

TRUE if the transport isn't part of a network or is in the current profile, FALSE otherwise

Definition at line 10312 of file ap_dbdef.c.

DBDEF_UpdateCridEitDate()

void DBDEF_UpdateCridEitDate

(

ADB_CRID_REC *

c_ptr

)

Updates the stored EIT date of this CRID with the current GMT date.

Parameters

c_ptr

pointer to CRID record

Definition at line 8920 of file ap_dbdef.c.