MuMuDVB - README for the configuration file

1. General behavior

MuMuDVB needs a configuration file in order to run properly.

The order of the parameters is most of the times not relevant.

You can put comments everywhere in the configuration file: just start the line with #. In line comments are not allowed i.e. port=1234 #The multicast port is not a valid line.

All parameters are in the form: name=value

Example

#The tuning frequency
freq=11987

The configuration file contains two parts

1.1. Common part

This is the first part of the configuration file, it contains the parameters needed for tuning the DVB card and the global parameters.

See the tuning section for the list of parameters used to tune the card. and other global parameters section for parameters like autoconfiguration, cam support etc …

1.2. Channels part

If you are not using autoconfiguration you need to set the list of the channels you want to stream. Each channel start with an new_channel line.

Example (unicast only)

new_channel
name=Barcelona TV
unicast_port=8090
pids=272

Example

new_channel
ip=239.100.0.0
port=1234
name=Barcelona TV
pids=272 256 257 258

See channel parameters section for a list of detailed parameters.

2. Example configuration files

You can find documented examples in the directory doc/configuration_examples

3. Parameters concerning the tuning of the card

Note	You can use w_scan to see the channels you can receive see w_scan section. Otherwise you can have a look at the initial tuning files given with linuxtv’s dvb-apps. For european satellite users, you can have a look at King Of Sat

3.1. Parameters concerning all modes (terrestrial, satellite, cable, ATSC)

In the following list, only the parameter freq is mandatory

Parameter name	Description	Default value	Comments
freq	transponder’s frequency in MHz		Mandatory
modulation	The kind of modulation used (can be : QPSK QAM16 QAM32 QAM64 QAM128 QAM256 QAMAUTO VSB8 VSB16 8PSK 16APSK 32APSK DQPSK)	ATSC: VSB_8, cable/terrestrial: QAM_AUTO, satellite: QPSK	Optional most of the times
delivery_system	the delivery system used (can be DVBT DVBT2 DVBS DVBS2 DVBC_ANNEX_AC DVBC_ANNEX_B ATSC)	Undefined	Set it if you want to use the new tuning API (DVB API 5/S2API). Mandatory for DVB-S2 and DVB-T2
card	The DVB/ATSC card number	0	only limited by your OS
tuner	The tuner number	0	If you have a card with multiple tuners (ie there are several frontend* in /dev/dvb/adapter%card)
card_dev_path	The path of the DVB card devices. Use it if you have a personalised path like /dev/dvb/astra%card	/dev/dvb/adapter%card	The template %card can be used
tuning_timeout	tuning timeout in seconds.	300	0 = no timeout
timeout_no_diff	If no channels are streamed, MuMuDVB will kill himself after this time (specified in seconds)	600	0 = infinite timeout
check_status	Do we check the card status and display a message if lock is lost	1	0 = no check.

3.2. Parameters specific to satellite

Parameter name	Description	Default value	Possible values	Comments
pol	transponder’s polarisation. One char. v (vertical), h (horizontal), l (left circular), r (right circular)		h, H, v, V, l, L, r or R	Mandatory
srate	transponder’s symbol rate			Mandatory
lnb_type	The LNB type	universal	universal, standard	Universal : two local oscilators. Standard : one local oscillator.Most of the LNBs are universal.
lnb_lof_standard	The frequency of the LNB’s local oscillator when lnb_type=standard	10750		In MHz, see below.
lnb_slof	The switching frequency frequency of the LNB (define the two bands). Valid when lnb_type=universal	11700		In MHz, see below.
lnb_lof_low	The frequency of the LNB’s local oscillator for the low band. Valid when lnb_type=universal	9750		In MHz, see below.
lnb_lof_high	The frequency of the LNB’s local oscillator for the high band. Valid when lnb_type=universal	10600		In MHz, see below.
sat_number	The satellite number in case you have multiples lnb, no effect if 0 (only 22kHz tone and 13/18V), send a diseqc message if non 0	0	1 to 4	If you have equipment which support more, please contact. For Unicable 0,1 : position A, 2 position B
switch_input	The switch input number in case you have multiples lnb, overrides sat_number, send a diseqc message if non 0, for unicable, this is the unicable ID	0	0 to 15	If you have equipment which support more, please contact
switch_type	The DiSEqC switch type: Committed ©, Uncommitted (N) or uNicable (N)	C	C, c, U, u, N or n
diseqc_repeat	Do we repeat the DiSEqC message (useful for some switches)	0	0 or 1
uni_freq	For SCR/unicable: the translated frequency in MHz			Optional: needed if switch_type N
lnb_voltage_off	Force the LNB voltage to be 0V (instead of 13V or 18V). This is useful when your LNB have it’s own power supply.	0	0 or 1
coderate	coderate, also called FEC	auto	none, 1/2, 2/3, 3/4, 4/5, 5/6, 6/7, 7/8, 8/9, auto
rolloff	rolloff important only for DVB-S2	35	35, 20, 25, auto	The default value should work most of the times
stream_id	the id of the substream for DVB-S2	0	>0
pls_code	the PLS code for DVB-S2 (will modify the stream_id)	0
pls_type	the PLS type for DVB-S2	root	root, gold, common	common not implemented please contact if needed

3.2.1. Local oscillator frequencies :

S-Band 3650 MHz
C band (Hi) 5950 MHz
C band (Lo) 5150 MHz
Ku Band : this is the default band for MuMuDVB, you don’t have to set the LO frequency. For information : Hi band : 10600, Low band : 9750, Single : 10750

3.3. Parameters specific to terrestrial (DVB-T)

Note	`auto` usually works fine for all the parameters except `bandwidth`

Parameter name	Description	Default value	Possible values
bandwidth	bandwidth	8MHz	8MHz, 7MHz, 6MHz, auto (DVB-T2: 5MHz, 10MHz, 1.712MHz)
trans_mode	transmission mode	auto	2k, 8k, auto (DVB-T2: 4k, 16k, 32k)
guardinterval	guard interval	auto	1/32, 1/16, 1/8, 1/4, auto (DVB-T2 : 1/128, 19/128, 19/256)
coderate	coderate, also called FEC	auto	none, 1/2, 2/3, 3/4, 4/5, 5/6, 6/7, 7/8, 8/9, auto
stream_id	the id of the substream for DVB-T2	0	0 to 255

3.4. Parameters specific to cable (DVB-C)

Parameter name	Description	Default value	Possible values	Comments
srate	transponder’s symbol rate			Mandatory
coderate	coderate, also called FEC	auto	none, 1/2, 2/3, 3/4, 4/5, 5/6, 6/7, 7/8, 8/9, auto

Note	The spectral inversion is fixed to OFF, it should work for most of the people, if you need to change this parameter, please contact.

3.5. Parameters specific to ATSC (Cable or Terrestrial)

If needed, specify the modulation using the option modulation.

Note	VSB 8 is the default modulation for most of the terrestrial ATSC transmission

4. Other global parameters

4.1. Various parameters

Parameter name	Description	Default value	Possible values	Comments
show_traffic_interval	the interval in second between two displays of the traffic	10
compute_traffic_interval	the interval in second between two computations of the traffic	10
dvr_buffer_size	The size of the "DVR buffer" in packets	20	>=1	see README
dvr_thread	Are the packets retrieved from the card in a thread	0	0 or 1	See README
dvr_thread_buffer_size	The size of the "DVR thread buffer" in packets	5000	>=1	See README
server_id	The server number for the `%server` template	0		Useful only if you use the %server template
filename_pid	Specify where MuMuDVB will write it’s PID (Processus IDentifier)	/var/run/mumudvb/mumudvb_adapter%card_tuner%tuner.pid		the templates %card %tuner and %server are allowed
check_cc	Do MuMuDVB check the discontibuities in the stream ?	0		Displayed via the XML status pages or the signal display
store_eit	Do MuMuDVB store EIT (Electronic Program Guide) for the webservices ?	0		beta, please report your results
debug_updown	Do MuMuDVB show debugging messages concerning up/down channel detection	0		The threshold can be adjusted with up_threshold and down_threshold

4.2. Packets sending parameters

Parameter name	Description	Default value	Possible values	Comments
dont_send_scrambled	If set to 1 don’t send the packets detected as scrambled. This will also remove indirectly the sap announces for the scrambled channels	0
filter_transport_error	If set to 1 don’t send the packets tagged with errors by the demodulator.	0
psi_tables_filtering	If set to pat, TS packets with PID from 0x01 to 0x1F are discarded. If set to pat_cat, TS packets with PID from 0x02 to 0x1F are discarded.	none	Option to keep only mandatory PSI PID
rewrite_pat	Do we rewrite the PAT PID	0, 1 in autoconf	0 or 1	See README, important for some set top boxes
rewrite_sdt	Do we rewrite the SDT PID	0, 1 in autoconf	0 or 1	See README
rewrite_eit sort_eit	Do we rewrite/sort the EIT PID	0	0 or 1	See README
sdt_force_eit	Do we force the EIT_schedule_flag and EIT_present_following_flag in SDT	0	0 or 1	Set to 0 if you don’t understand
rtp_header	Send the stream with the rtp headers (except for HTTP unicast)	0	0 or 1

4.3. Logs parameters

Parameter name	Description	Default value	Possible values	Comments
log_header	specify the logging header	%priority: %module		The implemented templates are %priority %module %timeepoch %date %pid
log_flush_interval	LogFile flushing interval (in seconds)	-1 : no periodic flushing
log_type	Where the log information will go	If neither this option and logfile are specified the log destination will be syslog if MuMuDVB run as a deamon, console otherwise	syslog, console	The first time you specify a logging way, it replaces the default one. Then, each time you sepcify a logging channel, it is added to the previous
log_file	The file in which the logs will be written to	no file log		The following templates are allowed %card %tuner %server

4.4. Multicast parameters

Parameter name	Description	Default value	Possible values	Comments
multicast_ipv4	Do we activate IPv4 multicast	1	0 or 1	Put this option to 0 to disable multicast streaming
multicast_ipv6	Do we activate IPv6 multicast	0	0 or 1
multicast_iface4	The network interface to send IPv4 multicast packets (eth1, eth2 etc…)	empty (let the system choose)
multicast_iface6	The network interface to send IPv6 multicast packets (eth1, eth2 etc…)	empty (let the system choose)
common_port	Default port for the streaming	1234		For autoconf, and avoiding typing port= for each channel.
multicast_ttl	The multicast Time To Live	2
multicast_auto_join	Set to 1 if you want MuMuDVB to join automatically the multicast groups	0	0 or 1	See known problems in the README

4.5. CAM support parameters

Parameter name	Description	Default value	Possible values	Comments
cam_support	Specify if we wants the support for scrambled channels	0	0 or 1
cam_number	the number of the CAM we want to use	0		In case you have multiple CAMs on one DVB card
cam_reset_interval	The time (in seconds) we wait for the CAM to be initialized before resetting it.	30		If the reset is not successful, MuMuDVB will reset the CAM again after this interval. The maximum number of resets before exiting is 5
cam_delay_pmt_send	The time (in seconds) we wait between the initialization of the CAM and the sending of the first PMT This behavior is made for some "crazy" CAMs like powercam v4 which doesn’t accept the PMT just after the ca_info\ _callback	0		Normally this time doesn’t have to be changed.
cam_interval_pmt_send	The time (in seconds) we wait between possible updates to the PMT sent to the CAM	3		Normally this time doesn’t have to be changed.

4.6. SCAM support parameters

Parameter name	Description	Default value	Possible values
scam_support	Specify if we wants the support for software descrambling channels	0	0 or 1
ring_buffer_default_size	default number of ts packets in ring buffer (when not specified by channel specific config)	32768	it gets rounded to the value that is power of 2 not lower than it
decsa_default_delay	default delay time in us between getting packet and descrambling (when not specified by channel specific config)	500000	max is 10000000
send_default_delay	default delay time in us between getting packet and sending (when not specified by channel specific config)	1500000	mustn’t be lower than decsa delay

4.7. Autoconfiguration parameters

Parameter name	Description	Default value	Possible values	Comments
autoconfiguration	autoconfiguration allows to detect channels and their parameters	none	none or full	see the README for more details
autoconf_ip4	For autoconfiguration, the template for the ipv4 for streamed channel	239.100.%card.%number		You can use expressions with `+`, `` , `%card`, `%tuner`, `%server`, `%sid_hi`, `%sid_lo` and `%number`. Ex: `239.100.150+%server10+%card.%number`
autoconf_ip6	For autoconfiguration, the template for the ipv6 for streamed channel	FF15:4242::%server:%card:%number		You can use the keywords `%card`, `%tuner`, `%server`, `%sid` (the SID will be in hexadecimal) and `%number`
autoconf_radios	Do we consider radios as valid channels during autoconfiguration ?	0	0 or 1
autoconf_scrambled	Do we consider scrambled channels valid channels during autoconfiguration ?	0	0 or 1	Automatic when cam_support=1 or scam_support=1. Sometimes a clear channel can be marked as scrambled. This option allows you to bypass the ckecking.
autoconf_unicast_start_port	The unicast port for the first discovered channel			`autoconf_unicast_start_port=value` is equivalent to `autoconf_unicast_port=value + %number`
autoconf_unicast_port	The unicast port for each discovered channel. Ex "2000+%number"			You can use expressions with `+` `` `%card` `%tuner` `%server`, `%sid` and `%number`. Ex : `autoconf_unicast_port=2000+100%card+%number`
autoconf_multicast_port	The multicast port for each discovered channel. Ex "2000+%number"			You can use expressions with `+` `` `%card` `%tuner` `%server`, `%sid` and `%number`. Ex : `autoconf_multicast_port=2000+100%card+%number`
autoconf_sid_list	If you don’t want to configure all the channels of the transponder in autoconfiguration mode, specify with this option the list of the service ids of the channels you want to autoconfigure.	empty
autoconf_sid_list_ignore	If you don’t want to configure all the channels of the transponder in autoconfiguration mode, specify with this option the list of the service ids of the channels you want to exclude from autoconfiguration.	empty
autoconf_name_template	The template for the channel name, ex `%number-%name`	empty		See README for more details

4.8. SAP announces parameters

Parameter name	Description	Default value	Possible values	Comments
sap	Generation of SAP announces	0 (1 if autoconfiguration)	0 or 1
sap_organisation	Organisation field sent in the SAP announces	MuMuDVB		Optionnal
sap_uri	URI field sent in the SAP announces			Optionnal
sap_sending_ip4	The SAP sender IPv4 address	0.0.0.0		Optionnal, not autodetected, if set, enable RFC 4570 SDP Source Filters field
sap_sending_ip6	The SAP sender IPv6 address	::		Optionnal, not autodetected, if set, enable RFC 4570 SDP Source Filters field
sap_interval	Interval in seconds between sap announces	5	positive integers
sap_default_group	The default playlist group for sap announces		string	Optional. You can use the keyword %type, see README
sap_ttl	The TTL for the multicast SAP packets	255		The RFC 2974 says "SAP announcements … SHOULD be sent with an IP time-to-live of 255 (the use of TTL scoping for multicast is discouraged [RFC 2365])."

4.9. HTTP unicast parameters

Parameter name	Description	Default value	Comments
unicast	Set this option to one to activate HTTP unicast	0	see the README for more details
ip_http	the listening ip for http unicast, if you want to listen to all interfaces put 0.0.0.0	0.0.0.0	see the README for more details
port_http	The listening port for http unicast	4242	You can use mathematical expressions containing integers, * and +. You can use the `%card`, `%tuner` and %server template. Ex `port_http=2000+%card*100`
unicast_consecutive_errors_timeout	The timeout for disconnecting a client which is not responding	5	A client will be disconnected if no data have been sucessfully sent during this interval. A value of 0 deactivate the timeout (unadvised).
unicast_max_clients	The limit on the number of connected clients	0	0 : no limit.
unicast_queue_size	The maximum size of the buffering when writting to a client fails	512kBytes	in Bytes.
playlist_ignore_dead	Do we exclude dead channels (no traffic) from playlist?	0	0 or 1

5. Channel parameters

Each channel start with a new_channel line. All these options if they are used together with autoconfiguration will override the detected values. Eg. if the name is specified with name="my channel" this name will be kept even if autoconfiguration detectes that the service is called euronews.

The service id must be set with service_id to allow autoconfiguration to detect parameters which are not user specified.

Concerning the PIDs see the getting the PIDs section

The column "Can be detected/autoset" specifies if this parameter can be ommitted while using autoconfiguration

Parameter name	Description	Default value	Possible values	Can be detected/autoset	Comments
ip	multicast (can also be unicast, in raw UDP ) ipv4 where the channel will be streamed			Yes
ip6	multicast (can also be unicast, in raw UDP ) ipv6 where the channel will be streamed			Yes
port	The port	1234 or common_port		Yes	Ports below 1024 needs root rights.
unicast_port	The HTTP unicast port for this channel			Yes	Ports below 1024 needs root rights. You need to activate HTTP unicast with `ip_http`
sap_group	The playlist group for SAP announces		string	No	optionnal
pmt_pid	Only for scrambled channels without autoconf. The PMT PID for CAM support			Yes	This option needs to be specified for descrambling the channel. The pid will be added to the pid list if ommitted
service_id	The service id (program number), only for autoconfiguration, or rewrite (PAT or SDT) see README for more details			NO	Mandatory for autodetection of the other parameters
name	The name of the channel. Will be used for /var/run/mumudvb/channels_streamed_adapter%d_tuner%d, logging and SAP announces			Yes	templates %name %number %lcn %2lcn can be used, other may be added if necessary
pids	The PIDs list, separated by spaces			Yes	some pids are always sent (PAT CAT EIT SDT TDT NIT), see README for more details
oscam	Do we activate software descrambling for this channel	0	0 or 1	No
ring_buffer_size	number of ts packets in ring buffer (for software CAM)	131072	it gets rounded to the value that is power of 2 not lower than it	No
decsa_delay	delay time in us between getting packet and descrambling (for software CAM)	4500000	max is 10000000	No
send_delay	delay time in us between getting packet and sending (for software CAM)	7000000	mustn’t be lower than decsa delay	No
cam_ask	For CAM support, some providers announce scrambled channels as FTA, this parameter force asking the CAM to descramble	0	0,1	No

6. Get the PID numbers

6.1. You use autoconfiguration

If you use autoconfiguration, you don’t need to specify any channel and don’t need any PID, this section does not concern you.

6.2. You do not use autoconfiguration

It is strongly advised to use autoconfiguration as the PIDs may change and manual PID setting need to maintain them. If you don’t use autoconfiguration because of limitations of the autoconfiguration system pleas contact so we can see how to fix that.

If you don’t use autoconfiguration (see the README), you have to get the PIDs (Program Identifier) for each channel.

For each channel it is advised to specify at least : - One video PID (except for radios) - One audio PID - The PMT PID - The PCR PID (if different from video/audio)

If you don’t have access to the PIDs via a website like King Of Sat, the easiest way is to use linuxtv’s dvb-apps or w_scan.

You don’t know on which frequency to tune and the channels you can receive. In this case, you can use w_scan or using scan from dvb-apps if you have an initial tuning config file.

6.2.1. Using w_scan to get an initial tuning file

Note	w_scan works for DVB-T, DVB-C, DVB-S/S2 and ATSC.

You can find wscan in the w_scan website - German or w_scan website - English translation.

w_scan have one disavantage over dvb-apps scan: it takes (usually) more time. But it have several advantages: no need for initial tuning file, card autodection and deeper channel search.

Once you compiled it (optional for x86), launch it with the options needed (country is mandatory for terrestrial and cable. for DVB-S/S2 you need to specify your satellite)

Note	Here’s the main options for w_scan

        -f type frontend type
                What programs do you want to search for?
                a = atsc (vsb/qam)
                c = cable
                s = sat
                t = terrestrian [default]
        -c      choose your country here:
                        DE, GB, US, AU, ..
                        ? for list
        -s      choose your satellite here:
                        S19E2, S13E0, S15W0, ..
                        ? for list

For more information, see w_scan’s help

Your will get lines channels with the file format described here

If you want to use autoconfiguration, this contains all the parameters you need. For example the second row is the frequency.

6.2.2. Using scan with an initial tuning file

Note	With satellite this allow you to find all the frequencies (if the broadcaster follow the norm). Because, every transponder announces the others.

If you don’t know where to find the inital tuning file, recent versions of scan give the default locations by calling scan without arguments.

You need scan from linuxtv’s dvb-apps

Type

scan -o pids pathtoyourinitialtuningfile

You’ll first get blocks like

>>> tune to: 514000000:INVERSION_AUTO:BANDWIDTH_8_MHZ:FEC_2_3:FEC_2_3:QAM_64:TRANSMISSION_MODE_8K:GUARD_INTERVAL_1_4:HIERARCHY_NONE
0x0000 0x7850: pmt_pid 0x0110 Barcelona TV -- Barcelona TV (running)
0x0000 0x7851: pmt_pid 0x0710 COM Radio -- COM Radio (running)
0x0000 0x7855: pmt_pid 0x0210 TV L'Hospitalet -- TV L'Hospitalet (running)
0x0000 0x7856: pmt_pid 0x0510 Radio Hospitalet -- Radio Hospitalet (running)
0x0000 0x785a: pmt_pid 0x0310 Televisio Badalona -- Televisio Badalona (running)
0x0000 0x785b: pmt_pid 0x0610 Radio Ciutat Badalona -- Radio Ciutat Badal

You have now acces to the PMT PID (in hexadecimal)

After this blocks, you’ll get lines like

Sensacio FM              (0x273f) 02: PCR == A            A 0x0701
urBe TV                  (0x7864) 01: PCR == V   V 0x0300 A 0x0301 (cat)
Canal Catala Barcelona   (0x7869) 01: PCR == V   V 0x0200 A 0x0201 (cat)
25 TV                    (0x786e) 01: PCR == V   V 0x0400 A 0x0401 (spa) TT 0x0402
ONDA RAMBLA PUNTO RADIO  (0x786f) 02: PCR == A            A 0x0601 (cat)
Localia                  (0x7873) 01: PCR == V   V 0x0100 A 0x0101
ONA FM                   (0x7874) 02: PCR == A            A 0x0501
TV3                      (0x0321) 01: PCR == V   V 0x006f A 0x0070 (cat) 0x0072 (vo) 0x0074 (ad) TT 0x0071 AC3 0x0073 SUB 0x032b

You have now acces to the other PIDs

MuMuDVB wants the PIDs in decimal, so you have to convert the pids from hexadecimal to decimal.

6.2.3. Scan only one transponder

You first have to tune the card on the wanted frequency (with tune, szap or tzap for example).

After you use the scan utility:

scan -o pids -c -a 0

Where 0 is the card number

And you’ll get results like in the section scan with an initial tuning file