Satellite Equipment Control

Files
file	dvb-sat.h
	Provides interfaces to deal with DVB Satellite systems.

Data Structures
struct	dvb_sat_lnb
	Stores the information of a LNBf. More...

Functions
int	dvb_sat_search_lnb (const char *name)
	search for a LNBf entry
int	dvb_print_lnb (int index)
	prints the contents of a LNBf entry at STDOUT.
void	dvb_print_all_lnb (void)
	Prints all LNBf entries at STDOUT.
const struct dvb_sat_lnb *	dvb_sat_get_lnb (int index)
	gets a LNBf entry at its internal database
const char *	dvb_sat_get_lnb_name (int index)
	gets a LNBf entry at its internal database
int	dvb_sat_set_parms (struct dvb_v5_fe_parms *parms)
	sets the satellite parameters
int	dvb_sat_real_freq (struct dvb_v5_fe_parms *p, int freq)
	return the real satellite frequency

Detailed Description

Function Documentation

dvb_print_all_lnb()

void dvb_print_all_lnb

(

void

)

Prints all LNBf entries at STDOUT.

This function doesn't return anything. Internally, it calls dvb_print_lnb() for all entries inside its LNBf database.

Examples

dvbv5-scan.c, and dvbv5-zap.c.

dvb_print_lnb()

int dvb_print_lnb

(

int

index

)

prints the contents of a LNBf entry at STDOUT.

Parameters

index

index for the entry

Returns

returns -1 if the index is out of range, zero otherwise.

Examples

dvbv5-scan.c, and dvbv5-zap.c.

dvb_sat_get_lnb()

const struct dvb_sat_lnb * dvb_sat_get_lnb

(

int

index

)

gets a LNBf entry at its internal database

Parameters

index

index for the entry.

Returns

returns NULL if not found, of a struct dvb_sat_lnb pointer otherwise.

NOTE: none of the strings are i18n translated. In order to get the translated name, you should use dvb_sat_get_lnb_name()

Examples

dvbv5-scan.c, and dvbv5-zap.c.

dvb_sat_get_lnb_name()

const char * dvb_sat_get_lnb_name

(

int

index

)

gets a LNBf entry at its internal database

Parameters

index

index for the entry.

Returns

returns NULL if not found, of the name of a LNBf, translated to the user language, if translation is available.

dvb_sat_real_freq()

int dvb_sat_real_freq	(	struct dvb_v5_fe_parms *	p,
		int	freq
	)

return the real satellite frequency

Parameters

p	struct dvb_v5_fe_parms pointer.
freq	the DTV frequency.

This function is called internally by the library to get the satellite frequency, considering the LO frequency.

Returns

frequency.

dvb_sat_search_lnb()

int dvb_sat_search_lnb

(

const char *

name

)

search for a LNBf entry

Parameters

name	name of the LNBf entry to seek.

On sucess, it returns a non-negative number with corresponds to the LNBf entry inside the LNBf structure at dvb-sat.c.

Returns

A -1 return code indicates that the LNBf was not found.

Examples

dvbv5-scan.c, and dvbv5-zap.c.

dvb_sat_set_parms()

int dvb_sat_set_parms

(

struct dvb_v5_fe_parms *

parms

)

sets the satellite parameters

Parameters

parms

struct dvb_v5_fe_parms pointer.

This function is called internally by the library to set the LNBf parameters, if the dvb_v5_fe_parms::lnb field is filled.

Returns

0 on success.