1. Comportement général

Pour fonctionner correctement, MuMuDVB a besoin d’un fichier de configuration.

L’ordre des paramètres n’a, la plupart du temps, pas d’importance.

Vous pouvez mettre des commentaires n’importe où dans le fichier de configuration, il suffit de commencer la ligne par un #. Les commentaires dans une ligne ne sont pas autorisés, exemple port=1234 #Le port multicast n’est pas une ligne valide.

Tous les paramètres s'écrivent sous la forme nom=valeur

Example
#La fréquence d'accord
freq=11987

Le fichier de configurations est constitué de deux parts : une partie générale, et une partie définissant les chaînes

1.1. Partie générale

Cette partie, la première du fichier de configuration, contient les paramètres nécessaires pour accorder la carte DVB et les autres paramètres globaux.

Pour les paramètres concernant l’accord de la carte, référez vous à la section paramètres d’accord. Pour les autres paramètres globaux, référez vous à la section paramètres globaux

1.2. Partie concernant les chaînes

Si vous n’utilisez pas l’autoconfiguration complète, vous devez définir les chaînes que vous voulez diffuser.

Chaque définition de chaîne commence par une ligne ip= et fini par une ligne pids=.

Référez vous a la section configuration des chaînes pour une liste détaillée des différents paramètres.

2. Fichiers d’exemple

Vous pouvez trouver des fichiers de configuration documentés dans le répertoire doc/configuration_examples

3. Paramètres concernant l’accord de la carte

Note
Pour la réception terrestre et câblée, vous pouvez utiliser w_scan pour savoir quelles chaînes vous pouvez recevoir. Pour plus de détails référez vous a la section w_scan. Sinon vous pouvez regarder le contenu des "initial tuning files" fourni avec dvb-apps de linuxtv. Le site King Of Sat référence les chaînes satellite pouvant être reçues en Europe

3.1. Paramètres communs à tous les modes de réception (terrestre, satellite et câble)

Dans la liste suivante, seul le paramètre freq est obligatoire

Nom Description Valeur par défaut Commentaires

freq

Fréquence du transpondeur en MHz

Obligatoire

card

Le numéro de carte DVB/ATSC

0

Limité seulement par l’OS

tuning_timeout

Temps d’attente pour l’accord de la carte

300

0 = attente infinie

timeout_no_diff

Si aucune chaîne n’est diffusée, MuMuDVB se "suicidera" au bout de ce délai ( en secondes )

600

0 = attente infinie

dont_tune

MuMuDVB n’accordera pas la carte si ce paramètre est spécifié (un autre programme comme tzap l’a fait)

Ceci est principalement pour le DVB-S2

3.2. Paramètres spécifiques à la réception satellite

Nom Description Valeur par défaut Valeurs possibles Commentaires

pol

Polarisation. Un caractère. v (verticale), h (horizontale), l ( circulaire gauche ), r ( circulaire droite )

h, H, v, V, l, L, r ou R

Obligatoire

srate

Le taux de symboles ( symbol rate )

Obligatoire

lnb_type

Le type de LNB

universal

universal, standard

Universel : deux oscillateurs locaux. Standard : un oscillateur local. La plupart des LNBs sont universels.

lnb_lof_standard

La fréquence de l’oscillateur local du LNB ( lorsque le type de LNB est standard )

10750

En MHz, voir plus bas

lnb_slof

La fréquence de commutation pour le LNB, définit les bandes haute et basse ( lorsque le type de LNB est universel )

11700

En MHz, voir plus bas

lnb_lof_low

La fréquence de l’oscillateur local du LNB pour la bande basse ( lorsque le type de LNB est universel )

9750

En MHz, voir plus bas

lnb_lof_high

La fréquence de l’oscillateur local du LNB pour la bande haute ( lorsque le type de LNB est universel )

10600

En MHz, voir plus bas

sat_number

Le numéro de satellite si vous avez plusieurs LNB. Aucun effet si égal à 0 (seulement ton 22kHz et 13/18V), envoie un message diseqc si différent de 0

0

0, 1 à 4

lnb_voltage_off

Force la tension pour le LNB à 0V (au lieu de 13V ou 18V). Ceci est utile si votre LNB possède sa propre alimentation.

0

0 ou 1

coderate

coderate, appelé aussi FEC

auto

none, 1/2, 2/3, 3/4, 4/5, 5/6, 6/7, 7/8, 8/9, auto

3.2.1. Fréquences pour l’oscillateur local :

3.3. Paramètres spécifiques à la réception terrestre (DVB-T)

Note
auto marche habituellement bien excepté pour bandwidth
Nom Description Valeur par défaut Valeurs possibles

bandwidth

Largeur de bande

8MHz

8MHz, 7MHz, 6MHz, auto

trans_mode

Mode de transmission

auto

2k, 8k, auto

guardinterval

Intervalle de garde

auto

1/32, 1/16, 1/8, 1/4, auto

coderate

coderate, aussi appelé FEC

auto

none, 1/2, 2/3, 3/4, 4/5, 5/6, 6/7, 7/8, 8/9, auto

3.4. Paramètres spécifiques a la réception par câble (DVB-C)

Nom Description Valeur par défaut Valeurs possibles Commentaires

srate

Le taux de symboles (Symbol rate)

obligatoire

qam

Modulation : quadrature amplitude modulation

auto

qpsk, 16, 32, 64, 128, 256, auto

coderate

coderate aussi appelé FEC

auto

none, 1/2, 2/3, 3/4, 4/5, 5/6, 6/7, 7/8, 8/9, auto

Note
L’inversion spectrale est fixée à OFF, ceci doit fonctionner pour la plupart des utilisateurs. Merci de contacter si vous avez besoin de changer ce paramètre.

3.5. Paramètres pour la réception ATSC (Câble ou Terrestre)

Nom Description Valeur par défaut Valeurs possibles

atsc_modulation

La modulation

vsb8

vsb8, vsb16, qam256, qam64, qamauto

Note
VSB 8 est la modulation par défaut pour la plupart des diffuseurs ATSC terrestre.

4. Autres paramètres globaux

Nom Description Valeur par défaut Valeurs possibles Commentaires

common_port

Le port par défaut pour la diffusion multicast

1234

multicast_ttl

Le TTL multicast

2

multicast_auto_join

Si positionné à 1 MuMuDVB joindra automatiquement tous les groupes multicast créés

0

0 or 1

cf problèmes connus dans le README

dont_send_sdt

Si positionné à 1, MuMuDVB n’enverra pas le PID SDT, c’est un contournement d’un bug de VLC

0

voir le README pour plus de détails

dont_send_scrambled

Si positionné à 1, MuMuDVB n’enverra pas les paquets brouillés. Cela retirera (indirectement) les annonces SAP pour les chaînes brouillées

0

show_traffic_interval

Le temps en secondes entre deux affichages du trafic

10

>2

rtp_header

Envoie les en-têtes RTP avec le flux (excepté pour l’unicast HTTP)

0

0 ou 1

dvr_buffer_size

La taille du "tampon DVR" en paquets de 188 octets

1

>=1

Fonctionnalité "expérimentale", se référer au README

Paramètres concernant le support des cartes CAM

cam_support

Indique si l’on veux le support pour les chaînes brouillées

0

0 ou 1

cam_number

Le numéro du module CAM que l’on veux utiliser

0

Dans le cas ou vouz avez plusieurs modules CAM sur une carte DVB

cam_reset_interval

Le temps (en secondes) que MuMuDVB attends pour que la CAM soit initialisée. Après ce délai, MuMuDVB tentera de réinitialiser le module CAM.

30

Si la réinitialisation échoue, MuMuDVB retentera de réinitialiser le module après cet intervelle de temps. Le nombre maximum de tentatives de réinitialisations avant de quitter est 5.

Paramètres pour l’autoconfiguration

autoconfiguration

autoconfiguration 1: Trouve les PIDs audio et video, 2: autoconfiguration complète

0

0, 1 or 2

Se référer au README pour plus de détails

autoconf_ip_header

Pour l’autoconfiguration complète, la première partie de l’ip des chaînes diffusées

239.100

Se référer au README pour plus de détails

autoconf_radios

Lors de l’autoconfiguration complète, est ce que les radios seront diffusées ?

0

0 ou 1

autoconf_scrambled

Lors de l’autoconfiguration complète, est ce que les chaînes brouillées seront diffusées ?

0

0 or 1

Automatique lorsque cam_support=1. Parfois, une chaîne en clair peut être marquée comme étant cryptée. Cette option est aussi nécessaire lorsqu’une softcam est utilisée.

autoconf_pid_update

Est ce que MuMuDVB se reconfigure lorsque le PMT est mis à jour ?

1

0 or 1

autoconf_unicast_start_port

Le port unicast pour la première chaine découverte

Voir README-fr pour plus de détails.

Paramètres concernant les annonces SAP

sap

Génération des annonces SAP

0 (1 si autoconfiguration complète)

0 or 1

sap_organisation

Champ "organisation" envoyé avec les annonces SAP

MuMuDVB

Optionnel

sap_uri

Champ "URI" envoyé avec les annonces SAP

Optionnel

sap_sending_ip

L’IP d’envoi des annonces SAP

0.0.0.0

Optionnel, non détecté automatiquement

sap_interval

Intervalle en secondes entre les annonces SAP

5

entiers positifs

sap_default_group

Le groupe de liste de lecture par défaut pour les annonces SAP

string

Optionnel

sap_ttl

Le TTL pour les paquets SAP multicast

255

RFC 2974 : "SAP announcements … SHOULD be sent with an IP time-to-live of 255 (the use of TTL scoping for multicast is discouraged [RFC 2365])."

Paramètres concernant l’unicast HTTP

ip_http

L’ip d'écoute du serveur unicast. Si vous voulez écouter sur toutes les interfaces mettez 0.0.0.0

vide

Cette option active l’unicast HTTP, se référer au README pour plus de détails.

port_http

Le port d'écoute pour l’unicast HTTP

4242

se référer au README pour plus de détails.

unicast_consecutive_errors_timeout

Le délai pour déconnecter un client qui ne réponds pas

5

Un client sera déconnecté si aucune donnée n’a été envoyée avec succès durant cet intervalle. Une valeur 0 désactive cette fonctionnalité (déconseillé).

unicast_max_clients

Limite sur le nombre de clients simultanés

0

0 : pas de limite.

5. Paramètres concernant les chaînes

Chaque définition de chaîne doit commencer par une ligne ip= et finir par une ligne pids=. Le seul autre paramètre obligatoire est le paramètre name.

Concernant les PIDs, référez vous à la section obtenir les PIDs.

Nom Description Valeur par défaut Commentaires

ip

Adresse ip multicast sur laquelle la chaîne sera diffusée

Obligatoire

port

Le port

1234 ou common_port

Les ports inférieurs à 1024 nécessitent les droits root.

unicast_port

Le port pour l’unicast HTTP ( associé à cette chaîne )

Les ports inférieurs à 1024 nécessitent les droits root. Vous devez activer l’unicast HTTP avec l’option ip_http

sap_group

Le groupe de liste de lecture pour les annonces SAP

optionnel

cam_pmt_pid

Uniquement pour les chaînes brouillées. Le PID PMT pour le module CAM

ts_id

Le "transport stream id" (appelé aussi "program number"), uniquement pour l’autoconfiguration ou la réécriture du PID PAT, se référer au README pour plus de détails

name

Le nom de la chaîne. Sera utilisé pour /var/run/mumudvb/chaines_diffusees%d, les journaux et les annonces SAP

Obligatoire

pids

La liste des PIDs, séparés par des espaces.

Certains PIDs sont systématiquement envoyés (PAT CAT EIT SDT TDT NIT).

6. Obtenir les PIDs

La manière la plus simple est d’utiliser l’autoconfiguration et de modifier le fichier de configuration généré : /var/run/mumudvb/mumudvb_generated_conf_card%d

6.1. Vous utilisez l’autoconfiguration

Si vous utilisez l’autoconfiguration complète, vous n’avez à spécifier aucune chaîne et vous n’avez besoin de spécifier aucun PID, cette section ne vous concerne donc pas.

Si vous utilisez l’autoconfiguration partielle, vous aurez besoin seulement du PID PMT pour chaque chaîne, lisez la suite pour savoir comment l’obtenir.

6.2. Vous n’utilisez pas l’autoconfiguration

Si vous n’utilisez pas l’autoconfiguration, vous devez obtenir les PIDs (Program Identifier) pour chaque chaîne.

Pour chaque chaîne, il est conseillé de spécifier au minimum :

Si vous n’avez pas accès aux PIDs via un site web comme King Of Sat, la manière la plus facile pour les obtenir est d’utiliser les dvb-apps de linuxtv.

Si vous ne savez pas sur quelle fréquence accorder votre carte ou les chaînes que vous pouvez recevoir, vous pouvez utiliser w_scan ou scan (des dvb-apps) si vous avez un fichier d’accord initial (généralement fourni avec la documentation de scan).

6.2.1. Utiliser w_scan pour obtenir un fichier d’accord initial

Note
w_scan fonctionne uniquement pour la réception terrestre ou câblée.

Vous pouvez obtenir w_scan à partir du site web de w_scan.

Une fois que vous l’avez compilé (facultatif pour les x86), vous pouvez le lancer en utilisant

./w_scan -x >> inital_tuning_file.txt
Note
Si vous n’utilisez pas une carte DVB-T vous aurez a définir l’option
-f type frontend type
 What programs do you want to search for?
  a = atsc (vsb/qam)
  c = cable
  t = terrestrian [default]

Votre fichier initial_tuning_file.txt devrai contenir des lignes similaires à

T 482000000 8MHz AUTO AUTO AUTO AUTO AUTO AUTO
T 498000000 8MHz AUTO AUTO AUTO AUTO AUTO AUTO
T 514000000 8MHz 2/3 2/3 QAM64 8k 1/4 NONE

Si vous voulez utiliser l’autoconfiguration complète, ce fichier contient toutes les informations nécessaires. Par exemple, la seconde colonne est la fréquence ( en Hz ).

Le format est le suivant :

Terrestre
T freq bandwidth fec_hi fec_lo modulation transmission-mode guard-interval hierarchy
Câble
C freq symbol_rate fec modulation
ATSC
A freq modulation

Si vous ne voulez pas utiliser l’autoconfiguration complète, vous pouvez utiliser scan avec ce fichier, voir la section utiliser scan avec un fichier d’accord initial.

6.2.2. Utiliser scan avec un fichier d’accord initial

Note
En réception satellite, ceci vous permet de trouver toutes les fréquences (si le diffuseur suit la norme). En effet chaque transpondeur annonce les autres.

Dans la suite vous aurez besoin de l’utilitaire scan des dvb-apps.

Si vous avez un fichier d’accord initial de w_scan, de la documentation de scan ou tout autre source, tapez :

scan -o pids cheminversvotrefichierdaccordinitial

Vous allez d’abord obtenir des blocs comme :

>>> 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

Vous avez maintenant accès au PID PMT (en hexadecimal), vous pouvez le convertir en décimal et utiliser l’autoconfiguration partielle.

Après ces blocs vous obtiendrez des lignes comme :

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

Vouz avez maintenant accès aux autres PIDs.

MuMuDVB a besoin des PIDs en décimal, vous avez donc a faire la conversion Hexadécimal→décimal.

6.2.3. Scanner seulement un transpondeur

Vous devez d’abord accorder votre carte sur la fréquence désirée ( avec, par exemple, tune, szap ou tzap ).

Ensuite vous pouvez utiliser l’utilitaire scan :

scan -o pids -c -a 0

Où 0 doit être remplacé par le numéro de carte

Et vous obtiendrez des résultats similaires a ceux présentés dans la section utiliser scan avec un fichier d’accord initial