dvb/src/ap_dbdef.h File Reference

Application database control. More...

#include "stbsiflt.h"
#include "stbsitab.h"
#include "stbllist.h"

Include dependency graph for ap_dbdef.h:

Go to the source code of this file.

Data Structures
struct	adb_string
struct	adb_lnb_rec
struct	adb_bat_version_rec
struct	adb_satellite_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_crid_info
struct	ADB_EVENT_LINKAGE_DESC
struct	ADB_EXT_EVENT_LINKAGE_INFO
struct	ADB_EXT_EVENT_LINKAGE_DESC
struct	adb_linkage_desc
struct	adb_extended_event_info
struct	adb_event_rec
struct	adb_alt_serv_rec
struct	adb_icon_image
struct	adb_rct_link_info
struct	adb_service_rec
struct	adb_crid_record
struct	adb_favserv_rec
struct	adb_favlist_rec
Defines
#define	ADB_LANG_CODE_UNDEF   0x756e64
#define	ADB_LANG_CODE_QAA   0x716161
#define	ADB_LANG_CODE_NAR   0x6e6172
#define	LINK_TYPE_EVENT   0x0d
#define	LINK_TYPE_EXT_EVENT   0x0e
#define	INVALID_FREESAT_SERV_ID   0x8000
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_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_crid_info	ADB_CRID_INFO
typedef struct adb_linkage_desc	ADB_LINKAGE_DESC
typedef struct adb_extended_event_info	ADB_EXTENDED_EVENT_INFO
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
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)
void	DBDEF_DeleteAllRecords (void)
BOOLEAN	DBDEF_SaveDatabase (void)
void	DBDEF_DeleteRecordsForTunerType (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
void	DBDEF_DeleteServiceRec (ADB_SERVICE_REC *s_ptr)
U16BIT	DBDEF_NumStreamsInList (ADB_STREAM_REC *slist)
ADB_STREAM_REC *	DBDEF_CopyStreamList (ADB_STREAM_REC *slist)
void	DBDEF_DeleteStreamList (ADB_STREAM_REC *slist)
void	DBDEF_DeleteEvent (ADB_EVENT_REC *e_ptr)
void	DBDEF_DeleteAltServList (ADB_ALT_SERV_REC *aslist)
void	DBDEF_DeleteRCTLinks (ADB_RCT_LINK_INFO *links)
void	DBDEF_DeleteImageIcons (ADB_IMAGE_ICON *icon_list)
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)
BOOLEAN	DBDEF_AllocateLcnsDefault (E_STB_DP_SIGNAL_TYPE tuner_type)
U16BIT	DBDEF_GetNumLNBs (void)
	Returns the number of LNB records in the database.
ADB_LNB_REC *	DBDEF_AddLNB (E_STB_DP_LNB_TYPE type, U16BIT min_freq, U16BIT max_freq)
	Add an LNB record to the database.
BOOLEAN	DBDEF_SetLNBPower (ADB_LNB_REC *lnb, E_STB_DP_LNB_POWER power)
	Sets the LNB power setting.
BOOLEAN	DBDEF_SetLNB22k (ADB_LNB_REC *lnb, BOOLEAN is_22k)
	Sets the LNB 22k setting.
BOOLEAN	DBDEF_SetLNB12V (ADB_LNB_REC *lnb, BOOLEAN is_12v)
	Sets the LNB 12V setting.
BOOLEAN	DBDEF_SetLNBPulsePosition (ADB_LNB_REC *lnb, BOOLEAN is_pulse_posn)
	Sets the LNB pulse position setting.
BOOLEAN	DBDEF_SetLNBDiSEqCPosition (ADB_LNB_REC *lnb, BOOLEAN is_diseqc_posn)
	Sets the LNB DiSEqC position setting.
BOOLEAN	DBDEF_SetLNBDiSEqCTone (ADB_LNB_REC *lnb, E_STB_DP_DISEQC_TONE diseqc_tone)
	Sets the LNB DiSEqC tone setting.
BOOLEAN	DBDEF_SetLNBCSwitch (ADB_LNB_REC *lnb, E_STB_DP_DISEQC_CSWITCH cswitch)
	Sets the LNB committed switch setting.
BOOLEAN	DBDEF_SetLNBUSwitch (ADB_LNB_REC *lnb, U8BIT uswitch)
	Sets the LNB uncommitted switch setting.
BOOLEAN	DBDEF_SetLNBSmatv (ADB_LNB_REC *lnb, BOOLEAN is_smatv)
	Sets the LNB SMATV setting.
BOOLEAN	DBDEF_SetLNBRepeats (ADB_LNB_REC *lnb, U8BIT repeats)
	Sets the LNB message repeat setting in the range 0 to 3.
BOOLEAN	DBDEF_SetLNBUnicable (ADB_LNB_REC *lnb, U32BIT inter_freq, U8BIT chan)
	Sets the LNB Unicable settings.
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.
U16BIT	DBDEF_GetNumSatellites (void)
	Returns the number of satellite records in the database.
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.
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.
U16BIT	DBDEF_GetNumNetworks (void)
	Returns the number of networks in ther service database.
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.
void	DBDEF_SetNetworkName (ADB_NETWORK_REC *n_ptr, U8BIT *name)
	Set or change the name of the given network.
ADB_NETWORK_REC *	DBDEF_FindNetworkRec (U16BIT net_id, ADB_SATELLITE_REC *satellite)
	Finds the network with the given network ID.
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.
U16BIT	DBDEF_GetNumTransports (void)
	Returns the number of transports in ther service database.
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.
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.
ADB_TRANSPORT_REC *	DBDEF_FindTerrestrialTransportRec (U32BIT freq_hz, U8BIT plp_id)
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.
ADB_TRANSPORT_REC *	DBDEF_FindCableTransportRec (U32BIT freq_hz, U32BIT symbol_rate)
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.
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)
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.
void	DBDEF_SetTransportTransportId (ADB_TRANSPORT_REC *t_ptr, U16BIT tran_id)
	Sets the transport ID of the given transport.
void	DBDEF_SetTransportOrigNetworkId (ADB_TRANSPORT_REC *t_ptr, U16BIT orig_net_id)
	Sets the original network ID of the given transport.
void	DBDEF_DeleteTransportRec (ADB_TRANSPORT_REC *t_ptr)
	Deletes the given transport from the service database.
void	DBDEF_ClearTableVersionHistory (ADB_TRANSPORT_REC *t_ptr)
U16BIT	DBDEF_GetNumServices (void)
	Returns the total number of services.
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.
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.
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.
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.
void	DBDEF_SetServiceName (ADB_SERVICE_REC *s_ptr, U8BIT *name)
	Set or change the name of a service.
void	DBDEF_SetServiceType (ADB_SERVICE_REC *s_ptr, ADB_SERVICE_TYPE serv_type)
	Sets the service type for the given service record.
void	DBDEF_SaveServiceEventSchedule (ADB_SERVICE_REC *s_ptr)
	Saves the event schedule of a service to the service database.
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.
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.
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.
ADB_SERVICE_REC *	DBDEF_FindServiceRecByFreesatId (ADB_SERVICE_REC *servp, U16BIT freesat_id)
	Search for a service with the given Freesat ID.
U16BIT	DBDEF_GetReqdAudioPid (ADB_SERVICE_REC *s_ptr, E_STB_DP_AUDIO_MODE *audio_mode, ADB_STREAM_TYPE *audio_type)
U16BIT	DBDEF_GetReqdADPid (ADB_SERVICE_REC *s_ptr, E_STB_DP_AUDIO_MODE *ad_mode)
E_STREAM_MATCH_TYPE	DBDEF_GetReqdTtextPid (ADB_SERVICE_REC *s_ptr, BOOLEAN for_subtitles, U16BIT *pid_ptr, U8BIT *magazine, U8BIT *page)
E_STREAM_MATCH_TYPE	DBDEF_GetReqdSubtitleParams (ADB_SERVICE_REC *s_ptr, U16BIT *pid_ptr, U16BIT *cpage_ptr, U16BIT *apage_ptr)
U16BIT	DBDEF_GetReqdVideoPid (ADB_SERVICE_REC *s_ptr, ADB_STREAM_TYPE *video_type)
ADB_STRING *	DBDEF_GetServiceName (ADB_SERVICE_REC *s_ptr, BOOLEAN short_name, BOOLEAN pref_name)
ADB_STRING *	DBDEF_GetServiceProviderName (ADB_SERVICE_REC *s_ptr)
BOOLEAN	DBDEF_AddAnalogService (void)
void	DBDEF_SetAnalogServiceName (ADB_SERVICE_REC *s_ptr, U8BIT *new_name, U8BIT new_len)
void	DBDEF_SetServicePmtPid (ADB_SERVICE_REC *s_ptr, U16BIT pmt_pid)
U16BIT	DBDEF_GetServicePmtPid (ADB_SERVICE_REC *s_ptr)
void	DBDEF_SetServiceFavGroups (ADB_SERVICE_REC *s_ptr, U8BIT groups)
	Sets the favourite groups for a service.
ADB_EVENT_REC *	DBDEF_CopyEventRec (ADB_EVENT_REC *e_ptr)
	Makes a new copy of the given event record.
void	DBDEF_DeleteEventList (ADB_EVENT_REC *elist)
	Deletes all events in the given list.
void	DBDEF_SetTunedNetwork (U8BIT path, ADB_NETWORK_REC *n_ptr)
ADB_NETWORK_REC *	DBDEF_GetTunedNetwork (U8BIT path)
void	DBDEF_SetTunedTransport (U8BIT path, ADB_TRANSPORT_REC *t_ptr)
ADB_TRANSPORT_REC *	DBDEF_GetTunedTransport (U8BIT path)
void	DBDEF_SetTunedService (U8BIT path, ADB_SERVICE_REC *s_ptr)
ADB_SERVICE_REC *	DBDEF_GetTunedService (U8BIT path)
void	DBDEF_SetTextLang (U8BIT *lang_ids)
U8BIT *	DBDEF_GetTextLang (void)
void	DBDEF_SetSecondaryTextLang (U8BIT *lang_ids)
U8BIT *	DBDEF_GetSecondaryTextLang (void)
void	DBDEF_SetAudioLang (U8BIT *lang_ids)
U8BIT *	DBDEF_GetAudioLang (void)
U8BIT *	DBDEF_GetSecondaryAudioLang (void)
void	DBDEF_SetSecondaryAudioLang (U8BIT *lang_ids)
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.
void	DBDEF_TidyDatabaseNordig (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
void	DBDEF_TidyDatabaseUK (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
void	DBDEF_TidyDatabaseSatUK (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
void	DBDEF_TidyDatabaseDefault (E_STB_DP_SIGNAL_TYPE tuner_type, BOOLEAN search_completed, BOOLEAN manual)
void	DBDEF_RemoveEmptyTransports (E_STB_DP_SIGNAL_TYPE tuner_type, void *satellite)
	Delete all transport records that don't have any services.
void	DBDEF_DeleteLinkageDescripterArray (SI_LINKAGE_DESC_ENTRY *list_ptr)
ADB_CRID_REC *	DBDEF_AddCridRecord (U8BIT *crid, BOOLEAN series, BOOLEAN recommended, BOOLEAN radio_service)
	Creates a CRID record and adds it to the database.
void	DBDEF_SetCridDateTime (ADB_CRID_REC *c_ptr, U32DHMS date_time)
	Sets the date and time fields in the crid record.
void	DBDEF_SetCridService (ADB_CRID_REC *c_ptr, U16BIT serv_id)
	Sets the service ID in the crid record.
void	DBDEF_SetCridProgrammeName (ADB_CRID_REC *c_ptr, U8BIT *prog_name)
	Sets the programme name field of the given CRID record.
void	DBDEF_UpdateCridEitDate (ADB_CRID_REC *c_ptr)
	Updates the stored EIT date of this CRID with the current GMT date.
void	DBDEF_DeleteCridRecord (ADB_CRID_REC *c_ptr)
	Deletes the given CRID record from the database.
U16BIT	DBDEF_GetNumCridRecords (void)
	Returns the number of CRID records in the database.
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.
BOOLEAN	DBDEF_IsValidCridRecord (ADB_CRID_REC *c_ptr)
	Checks whether the given crid record is in the list of valid crid records.
U16BIT	DBDEF_GetNumFavouriteLists (void)
	Returns the number of favourite lists.
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.
ADB_FAVLIST_REC *	DBDEF_GetNextFavouriteList (ADB_FAVLIST_REC *fav_list)
	Returns the favourite list following the given item.
ADB_FAVLIST_REC *	DBDEF_FindFavouriteList (U8BIT list_id)
	Return the favourite list with the given list id.
void	DBDEF_SetFavouriteListUserData (ADB_FAVLIST_REC *fav_list, U32BIT user_data)
	Saves the given user data with a favourite list.
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.
void	DBDEF_DeleteFavouriteList (ADB_FAVLIST_REC *fav_list)
	Deletes the given favourite list.
U16BIT	DBDEF_GetNumServicesInFavouriteList (ADB_FAVLIST_REC *fav_list)
	Returns the number of services in the given favourite list.
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.
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.
ADB_FAVSERV_REC *	DBDEF_GetNextServiceFromFavouriteList (ADB_FAVLIST_REC *fav_list, ADB_FAVSERV_REC *fav_serv)
	Returns the next favourite list service record.
ADB_FAVSERV_REC *	DBDEF_GetPrevServiceFromFavouriteList (ADB_FAVLIST_REC *fav_list, ADB_FAVSERV_REC *fav_serv)
	Returns the previous favourite list service record.
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.
void	DBDEF_DeleteServiceFromFavouriteList (ADB_FAVLIST_REC *fav_list, ADB_FAVSERV_REC *fav_serv)
	Delete the given service from the given favourite list.
void	DBDEF_DeleteAllServicesFromFavouriteList (ADB_FAVLIST_REC *fav_list)
	Delete the all services from the given favourite list.
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.
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.
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.
void	DBDEF_ReleaseProfileList (void **profile_list, U16BIT num_profiles)
	Frees a profile list returned by DBDEF_GetProfileList.
BOOLEAN	DBDEF_IsActiveProfile (ADB_NETWORK_REC *profile)
	Is the given profile the currently active profile?
ADB_PROFILE_TYPE	DBDEF_GetCurrentProfileType (void)
	Returns the current profile type.
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.
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.
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.
ADB_NETWORK_REC *	DBDEF_FindOrAddPrivateNetwork (void *satellite)
	Find or add a private network, assigning an unused private network ID.
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.
ADB_STRING *	DBDEF_CopyString (ADB_STRING *src_str)
	Creates a copy of the given ADB_STRING.
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.
void	DBDEF_ReleaseString (ADB_STRING *string)
	Releases an ADB_STRING.

---

Detailed Description

Application database control.

Date:

March 2003

---

Function Documentation

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

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

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
radio_service	TRUE if this CRID is for a radio service, TV otherwise

Returns:

pointer to the created CRID record

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

ADB_LNB_REC* DBDEF_AddLNB	(	E_STB_DP_LNB_TYPE	type,
		U16BIT	min_freq,
		U16BIT	max_freq
	)

Add an LNB record to the database.

Parameters:

type	single, universal or unicable
min_freq	min frequency
max_freq	max frequency

Returns:

pointer to the new LNB record or NULL if not created

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

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

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

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

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

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

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

ADB_EVENT_REC* DBDEF_CopyEventRec

(

ADB_EVENT_REC *

e_ptr

)

Makes a new copy of the given event record.

Parameters:

e_ptr

pointer to event record to be copied

Returns:

pointer to new event, will be NULL on failure

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

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

void DBDEF_DeleteAllServicesFromFavouriteList

(

ADB_FAVLIST_REC *

fav_list

)

Delete the all services from the given favourite list.

Parameters:

fav_list

favourite list

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

void DBDEF_DeleteEventList

(

ADB_EVENT_REC *

elist

)

Deletes all events in the given list.

Parameters:

elist

list of events to be deleted

void DBDEF_DeleteFavouriteList

(

ADB_FAVLIST_REC *

fav_list

)

Deletes the given favourite list.

Parameters:

fav_list

favourite list to be deleted

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

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

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

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

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

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

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

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

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

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

ADB_PROFILE_TYPE DBDEF_GetCurrentProfileType

(

void

)

Returns the current profile type.

Returns:

Current profile type in use

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

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

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

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

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

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

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

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

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

U16BIT DBDEF_GetNumCridRecords

(

void

)

Returns the number of CRID records in the database.

Returns:

number of records

U16BIT DBDEF_GetNumFavouriteLists

(

void

)

Returns the number of favourite lists.

Returns:

number of favourite lists

U16BIT DBDEF_GetNumLNBs

(

void

)

Returns the number of LNB records in the database.

Returns:

number of LNB records

U16BIT DBDEF_GetNumNetworks

(

void

)

Returns the number of networks in ther service database.

Returns:

number of transports

U16BIT DBDEF_GetNumSatellites

(

void

)

Returns the number of satellite records in the database.

Returns:

number of satellite records

U16BIT DBDEF_GetNumServices

(

void

)

Returns the total number of services.

Returns:

total number of services

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

U16BIT DBDEF_GetNumTransports

(

void

)

Returns the number of transports in ther service database.

Returns:

number of transports

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

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

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

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

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

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

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

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

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

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

void DBDEF_ReleaseString

(

ADB_STRING *

string

)

Releases an ADB_STRING.

Parameters:

string

string to be freed

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void 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

void 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

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

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

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

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

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

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