Linux::DVB::DVBT::Config - DVBT configuration functions
use Linux::DVB::DVBT::Config ;
Module provides a set of configuration routines used by the DVBT module. It is unlikely that you will need to access these functions directly, but you can if you wish.
Given a frequency, find the matching TSID.
$tuning_href is the HASH returned by Linux::DVB::DVBT::get_tuning_info().
Given a tsid, return the frontend params (or undef). The frontend params HASH contain the information used to tune the frontend i.e. this is the transponder (TSID) information. It corresponds to the matching 'ts' entry in the tuning info HASH.
Given a tsid and pid, find the matching channel information and returns the program HASH ref if found. This corresponds to the matching 'pr' entry in the tuning info HASH.
Given a pid, find the matching channel & TSID information
Returns an array of HASH entries, each HASH containing the stream type (video, audio, subtitle, or teletext), along with a copy of the associated program information (i.e. the matching 'pr' entry from the tuning info HASH):
@pid_info = [ { 'pidtype' => video, audio, subtitle, teletext pnr => 4171, tsid => 4107, tuned_freq => 57800000, ... }, ... ]
Given a channel name, do a "fuzzy" search and return an array containing params:
($frontend_params_href, $demux_params_href)
$demux_params_href HASH ref are of the form:
{ pnr => 4171, tsid => 4107, tuned_freq => 57800000, ... },
(i.e. $tuning_href->{'pr'}{$channel_name})
$frontend_params_href HASH ref are of the form:
{ tsid => 4107, frequency => 57800000, ... },
(i.e. $tuning_href->{'ts'}{$tsid} where $tsid is TSID for the channel)
Process the demux parameters and a language specifier to return the list of audio streams required.
demux_params are of the form:
Language specifier string is in the format:
Empty string : just return the default audio stream pid
Comma/space seperated list of one or more language names : returns the audio stream pids for all that match (does not necessarily include default stream)
If the list in (b) contains a '+' character (normally at the start) then the default audio stream is automatically included in teh list, and the extra streams are added to it.
For example, if a channel has the following audio details: eng:100 eng:101 fra:102 deu:103 Then the following specifications result in the lists as shown:
"" => (100)
"eng deu" => (100, 103)
"+eng fra" => (100, 101, 102)
Note that the language names are not case sensitive
Process the demux parameters and an output specifier to return the list of all stream pids required.
Output specifier string is in the format such that it just needs to contain the following characters:
a = audio v = video s = subtitle
Returns an array of HASHes of the form:
{'pid' => $pid, 'pidtype' => $type, 'pmt' => $pmt}
Process the demux parameters and return a list of additional audio streams (or an empty list if none available).
For example:
{ audio => 601, audio_details => eng:601 eng:602, ... },
would return the list: ( 602 )
Process the demux parameters and return a list of additional subtitle streams (or an empty list if none available).
{ subtitle => 601, subtitle_details => DVD_malentendant:601 DVB-francais:602, ... },
Read tuning information from config files. Look in search path and return first set of readable file information in a tuning HASH ref.
Returns a HASH ref of tuning information - i.e. it contains the complete information on all transponders (under the 'ts' field), and all programs (under the 'pr' field). [see Linux::DVB::DVBT::scan() method for format].
Write tuning information into the first writeable area in the search path.
Returns the readable filename for the specified file type, which can be one of: 'pr'=program, 'ts'=transponder.
Optionally specify the search path (otherwise the default search path is used)
Returns undef if invalid file type is specified, or unable to find a readable area.
Returns the writeable filename for the specified file type, which can be one of: 'pr'=program, 'ts'=transponder.
Returns undef if invalid file type is specified, or unable to find a writeable area.
Sorts TSIDs. As I now allow duplicate TSIDs in scans, and the duplicates are suffixed with a letter to make it obvious, numeric sorting is not possible.
This function can be used to correctly sort the TSIDs into order. Returns the usual -1, 0, 1 depending on if a is <, ==, or > b
Format the tsid number/name into a string. As I now allow duplicate TSIDs in scans, and the duplicates are suffixed with a letter to make it obvious which are duplicates. This routine formats the numeric part and always adds a suffix character (or space if none present).
Remove the specified TSID from the tuning information. Also removes any channels that are under that TSID.
Merge tuning information - overwrites previous with new - into $old_href and return the HASH ref.
Merge tuning information - checks to ensure new program info has the best strength, and that new program has all of it's settings
'pr' => { BBC ONE => { pnr => 4171, tsid => 4107, lcn => 1, ... }, $chan => ... }, 'lcn' => { 4107 => { 4171 => { service_type => 2, visible => 1, lcn => 46, ... }, }, $tsid => { $pnr => ... } }, 'ts' => { 4107 => { tsid => 4107, frequency => 57800000, strength => 46829, ... }, $tsid => .. }, 'freqs' => { 57800000 => { strength => 46829, snr => bbb, ber => ccc, ... }, $freq => ... },
Find directory to read from - first readable directory in search path
Find directory to write to - first writeable directory in search path
Read the transponder settings file of the form:
[4107] name = Oxford/Bexley frequency = 578000000 bandwidth = 8 modulation = 16 hierarchy = 0 code_rate_high = 34 code_rate_low = 34 guard_interval = 32 transmission = 2
Read the transponder settings file comments section, if present, containing the frequency file information used during the scan. The values are in "VDR" format:
# VDR freq bw fec_hi fec_lo mod transmission-mode guard-interval hierarchy inversion
For example, the frequency file format:
# T 578000000 8MHz 2/3 NONE QAM64 2k 1/32 NONE
will be saved as:
# VDR 578000000 8 23 0 64 2 32 0 0
Write transponder config information
Read dvb-pr - channel information - of the form:
[4107-4171] video = 600 audio = 601 audio_details = eng:601 eng:602 type = 1 net = BBC name = BBC ONE
Write program config file.
Read dvb-aliases - channel names aliases - of the form:
FIVE = Channel 5
Write channel names aliases config file.
To install Linux::DVB::DVBT, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Linux::DVB::DVBT
CPAN shell
perl -MCPAN -e shell install Linux::DVB::DVBT
For more information on module installation, please visit the detailed CPAN module installation guide.