Lähdekoodi sivulle Digi-tv

Digi-tv-sovittimen käyttöön tarvitset sopivan ajurin, nipun ohjelmia joilla voit säätää sovittimen oikealle kanavalle sekä mediasoittimen, joka osaa toistaa sovittimen lähettämää videodataa. Jokin sopiva mediasoitin ja koodekit ovat saatavilla useimpiin [[jakelu]]ihin, digi-tv-kortin ohjausohjelmistot taas sisältyvät esimerkiksi [[Debian]]issa, [[Fedora]]ssa ja [[Mandriva]]ssa <tt>dvb-apps</tt> ja vanhemmissa [[Ubuntu]]issa pakettiin <tt>dvb-utils</tt> (Ubuntu 9.10 käyttää <tt>dvb-apps</tt>ia). [[Ohjelmien asentaminen|Lisätietoja ohjelmapakettien asentamisesta]].

== Kanavan valinta ja virittäminen ==

Periaatteessa voisit käskyttää digi-tv-sovittimen oikealle kanavalle vain käskemällä sen oikealle taajuudelle. Koska harva tuntee taajuuksia ulkoa tai jaksaa kirjoittaa koko taajuutta aina kanavaa vaihtaessa, kannattaa digi-tv-sovitinta ensin käskeä skannaamaan yleisimmät taajuudet ja tekemään tiedoston, jossa on näkyvät kanavat taajuuksineen. Yleensä tiedoston nimeksi annetaan channels.conf.

Ensin kannattaa tarkistaa, että dvb-apps/dvb-utils-ohjelmapaketti on asennettuna ja että scandvb -ohjelma löytyy koneesta. Seuraavaksi kannattaa tarkistaa, onko <tt>/usr/share/dvb-apps</tt>- tai <tt>/usr/share/doc/dvb-utils/examples/scan/dvb-t</tt> (tai .../dvb-c tai .../dvb-s) -alihakemistoissa tiedostoa, jossa olisi oman DVB-jakeluverkon kanavanippuparametreja tarjolla. Tiedoston nimi on muotoa <tt>fi-kaupunki</tt> tai <tt>fi-operaattori</tt>. Aja sitten
 scandvb /usr/share/dvb-apps/ntsc/finnish
tai
 scan /usr/share/doc/dvb-utils/examples/scan/dvb-t/fi-Kaupunki

tai vastaava komento, parametrinä löytämäsi tiedosto. Jos et saa listausta tv-kanavista, katso ytimen viestien (<tt>[[dmesg]]</tt>) ja moduulien (<tt>[[lsmod]]</tt>) listauksista, onko sovitinta ylipäänsä tunnistettu. Mikäli löydät näistä tulosteista digi-tv-sovitinta kuvaavia rivejä, tarkista antennijohdot, kuuluvuudet jne. Ellei em. kanavanipputiedostoa löydy omasta T-, C- tai S-verkosta, selvitä ensin oman digiboksisi kanavatietojen tai operaattorisi www-sivujen kautta digitv-kanavanippujen parametrit, ja luo sitten em. dvb-apps -ohjelmiston mukana tulevien fi-kaupunki -mallikonfiguraatioiden pohjalta oma kanavanippujen syötetiedosto, jota käytät em. tapaan apuna kanavien haussa.

Jos sait tv-kanavalistauksen, aja komento uudelleen ja kopioi tuloste esimerkiksi tiedostoon channels.conf, jonka voit sijoittaa vaikkapa piilohakemistoon .azap kotihakemistosi alle:
 cd ~
 mkdir .azap
 scandvb /usr/share/dvb-apps/ntsc/finnish > .azap/channels.conf

Komennolla
 dvbtraffic
voit tarkkailla sovittimen dataliikennettä.

Sovittimen vastaanottamaan MPEG2-videokuvaan pääsee käsiksi laitetiedoston /dev/dvb/adapter0/dvr0 (tai adapter1, adapter2 jne.) kautta. Jos sovittimessa on MPEG2-purkupiiri, valmiiksi puretun videon saa laitetiedostosta /dev/video (tai /dev/video0, video1 jne).

=== Kaffeine ===
[[Kaffeine]] osaa hakea kanavat itse. Jos se tunnistaa digi-tv-kortin, Dvb-valikosta löytyy toiminto kanavien virittämiseen. Näin löydetyt kanavat ilmestyvät sitten kanavalistaan.

Kun Kaffeine on käynnistetty ensimmäisen kerran, se luo kansion <tt>~/.kde/share/apps/kaffeine/</tt> jonne se kopioi muutamien eri DVB-verkkojen kanavanippujen tiedot. Kaffeine ei siis käytä suoraan dvb-apps mukana tulevia jakeluverkkojen kanavanipputietoja. Syntaksi on sama kaffeine v0.xx versioissa, eli voit kopioida dvb-apps -sovelluksen <tt>dvb-{t,c,s}/fi-Kaupunki</tt> tiedoston tuonne <tt>~/.kde/share/apps/kaffeine/</tt> hakemistoon, ja antaa Kaffeinen käyttää sitä kanavien hakuun. Kaffeine v1.xx (esim. Fedora 13) käyttää lähetysverkkojen profiilitiedostoa ~/.kde/share/apps/kaffeine/scanfile.dvb, jonne on tarvittaessa mahdollista lisätä oman lähetysverkon kanavanippujen tiedot.

Kaffeine osaa näyttää YLE:n DVB-tekstitykset oikein. Xinessä olevan [http://bugs.xine-project.org/show_bug.cgi?id=267 bugin] vuoksi ne tulevat tosin viiveellä. EPG- ja OSD-tiedot näkyvät oikein versiosta 0.8.7 alkaen, tosin joskus ne ovat ruotsiksi.

=== MPlayer ===
[[MPlayer]] osaa näyttää digi-tv-kortin tuottamaa kuvaa. <tt>scandvb</tt>- tai <tt>scan</tt>-ohjelmalla luotu kanavatiedosto on tällöin tallennettava nimelle <tt>~/.mplayer/channels.conf</tt>. Tämä tapahtuu esim. DVB-T verkon kanavien osalta komennolla:
 scandvb /usr/share/dvb-apps/dvb-t/fi-Paikkakunta > ~/.mplayer/channels.conf
Tämän jälkeen MPlayerilla voidaan katsoa kanavaa komennolla
 mplayer dvb://kanava
Esimerkiksi
 mplayer "dvb://YLE TV2"
Eli <tt>dvb://</tt>-alun jälkeen tulee kanavan nimi. Nimet löytyvät <tt>~/.mplayer/channels.conf</tt> -tiedostosta.

Usein digi-tv:n sisältö on lomitettua, joten kannattaa käyttää lomituksenpoistoa. Esimerkkinä lomituksenpoistosta fd:
 mplayer -vf pp=fd "dvb://YLE TV2"

MPlayer ei kuitenkaan ainakaan toistaiseksi hallitse oikeaoppisia tekstityksiä (ns. ylen tekstit).

=== xine ===
[[xine]] osaa samoin näyttää DVB-lähetyksiä, kun laiteajurit on vaan asianmukaisesti asennettuna. Kanavahaku tapahtuu samalla tavalla, kuin mplayer-ohjelmankin osalta, eli esim. DVB-T verkossa:

 scandvb /usr/share/dvb-apps/dvb-t/fi-Paikkakunta > ~/.xine/channels.conf


Jos MPlayerille kanavat on jo haettu, voidaan ottaa sen kanavalista suoraan xine-ohjelman käyttöön:

 cp -p ~/.mplayer/channels.conf ~/.xine/channels.conf

YLE:n kanavien nk. DVB-tekstitykset saa xine-ohjelmassa näkyviin, kun subtitle-asetukset on vaan asetettu oikein.

=== Totem ===
[[Totem]] on [[edustaohjelma]]na toimiva mediasoitin joka käyttää [[taustaohjelma]]naan [[GStreamer]]ia (vanhemmissa versioissa oli mahdollista käyttää myös [[Xine]]ä). Kanavalista on samanlainen kuin edellä, se pitää vain kopioida oikealle paikalle:

 [[cp]] -p channels.conf ~/.gstreamer-0.10/dvb-channels.conf

Mikäli käytät totem-xineä, katso kohta Xine.

=== gxine ===

DVB-toiston aloittaminen: "Tiedosto > DVB" tai "Tiedosto > Avaa MRL... > dvb://".  Kanavalistalla olevat kanavat ilmestyvät soittolistalle ja viimeksi toistettua kanavaa aletaan toistaa.  Kanavalista luetaan tiedostosta "~/.xine/channels.conf".

DVB-tekstitys pitää tarvittaessa aktivoida valikosta: Esimerkiksi "Näytä > Tekstitykset > Kanava 0 / fin" tai "Näytä > Tekstitykset > Kanava 1 / swe".  Soittolistalta voi haluamansa kanavat tallentaa mediamerkintöihin, jolloin ne ovat helpommin saatavilla.  Ääniraitaa ei voi valita, ensimmäinen saatavilla oleva toistetaan.

Kanavalistan kanaviin viitataan niiden nimellä ("dvb://YLE Teema") tai järjestysnumerolla ("dvb://4", ensimmäinen kanava listalla on "dvb://0").  Ohjelmatiedot tämänhetkisestä ja seuraavasta ohjelmasta saa näkyviin OSD-näyttöön näppäimellä "u" tai "<f7>" toiston aikana.

=== VLC ===

Lataa kanavalista seuraavasti: "Media > Avaa tiedosto > .xine/channels.conf".  Viite kanavalistaan luodaan soittolistalle.  Puumuotoisen hierarkian laajentamalla saa esiin listan kaikista kanavista. Jos työpöydälle tai ylä/alapalkkiin haluaa oman pikakuvakkeen VLC:n DVB-katselua varten, niin komentorivi on tällöin 

<tt>vlc --playlist ~/.xine/channels.conf</tt>

VLC v1.13 alkaen syntaksi on hieman erilainen:

<tt>vlc --open ~/.xine/channels.conf</tt>

Yksittäisiä kanavia ei voi kopioida soittolistalta mediakirjastoon, mutta koko hierarkian voi.  Kanavan nimi tai esitettävä ohjelma näkyy toistoa aloittaessa OSD-viestinä.  Äänen ja tekstityksen kielen voi asetuksista määritellä oletusarvoisesti käyttöön, mutta niitä voi myös toiston aikana vaihtaa.  Esimerkiksi "Ääni > Ääniraita > Raita 1 - [English]" ja "Video > Tekstitysraita > 4:3 subtitles [Suomi]". 

Tekstitys- ja ääniasetukset on mahdollista asettaa niin, että VLC käyttää haluttuja kieliä ensisijaisesti ja jos niitä ei löydy, käytetään sitten varalla mitä tahansa lähetteen tekstitys/ääniraitaa. Esim. Yle lähettää tanskalaiset elokuvat Dansk/tanskalaisella äänellä ja tuo ao. any-valinta varmistaa, että ko. ääniraita tulee automaattisesti kuuluviin. Subtitles/Tekstitysraita -asetuksiin voisi laittaa esim 'fi,gb,us,en,uk,se,any', jolloin tuossa priorisointijärjestyksessä näytetään tekstitysraita, jos se lähetteessä on mukana. Vastaavasti Audio/ääniraidan kielet voisi laittaa esim. 'fi,se,en,uk,us,any', mutta Ylen lähetyksissä näkövammaisia varten oleva suomenkielinen ääniraita (DVB-ääniraita hollanninkielelle) tulee valituksi vaikkapa norjankielistä (no) ohjelmaa katsottaessa. Ääniraidan valinnassa tuo viimeinen 'any' ei siis välttämättä johda toivottuun lopputulokseen.

VLC käyttää Kaffeinea vähemmän prosessoritehoa ja näin se soveltuu hitaammissakin koneissa SD-tasoisten kanavien katseluun. VLC selviytyy HD-kanavistakin selvästi pienemmällä prosessoriteholla, kuin Kaffeine.

== Sovittimet ==
{|  border=1
|'''Sovitin'''
|'''Toimivuus'''
|-
|width=20%|'''Afatech''' AF9015 (myös AF9016 toimii samalla ajurilla)
'''A-Link''' DTU(m), '''Fujitech / Fuj:Tech''' (Verkkokauppa.com), TubeStick
|Toimii, kernel 2.6.28 tai uudempi.  Vanhempiin, haettavissa [[Mercurial]]-versionhallintajärjestelmällä osoitteesta http://linuxtv.org/hg/~anttip/af9015/ . Firmware on ladattavissa osoitteesta http://www.otit.fi/~crope/v4l-dvb/af9015/af9015_firmware_cutter/firmware_files/ ja tyypillisesti se tulee ladata hakemistoon /lib/firmware/. Verkkokauppa.comin tällä hetkellä (30.7.2010) myymät Fuj:techit ovat Realtekin piirillä, joka ei toimi linuxissa.
|-
|width=20%|'''Anysee''' E30 ja E30C Plus
|Toimii beta-vaiheessa olevalla ajurilla, haettavissa [[Mercurial]]-versionhallintajärjestelmällä osoitteesta http://linuxtv.org/hg/v4l-dvb/ . Osassa laitteista olevalle Conax-kortinlukijalla ei ole tukea.
|-
|width=20%|'''Artec''' T14 USB2.0 DVB-T (myös USB1.1)
|Toimii. Huom! Artec T14BR -mallille ei ainakaan toistaiseksi ole tukea ilman ajurin patchaamista. [[Patch]]-tiedosto löytyy [http://www.mail-archive.com/linux-dvb@linuxtv.org/msg27701.html täältä] ja se lisättänee linuxtv.org-ajureihin tulevaisuudessa. Testattu (T14BR & patch): Kubuntu 7.10 Gutsy. Kernelin versiossa 2.6.25 molemmat tuettuna suoraan.
|-
|'''Artec''' T14BR USB2.0 DVB-T
|Toimii. Firmware: Kernel 2.6.25-.27 [http://www.wi-bw.tfh-wildau.de/~pboettch/home/linux-dvb-firmware/dvb-usb-dib0700-1.10.fw dvb-usb-dib0700-1.10.fw] ja Kernel 2.6.28 [http://www.wi-bw.tfh-wildau.de/~pboettch/home/files/dvb-usb-dib0700-1.20.fw dvb-usb-dib0700-1.20.fw] (kansioon /lib/firmware/). Eri sisuskalut kuin Artec T14:ssa. Testattu: Arch Linux x86_64 Toimii suoraan: Ubuntu 8.04 ja 8.10
|-
|'''Digital Everywhere''' FireDTV / FloppyDTV
|Toimii, ajuri "firedtv" on sisällytetty Linux -ytimeen versiosta 2.6.29 alkaen, sitä edeltänyt [http://firesat.kurelid.se/ kehitysversio] on saatavilla Linux -ytimille versiosta 2.6.25 alkaen.  Myös CI-tuki pitäisi olla toiminnassa.  Testattu: Ubuntu 8.04. x86_64.  Testattu kehitys- ja vakaa versio arkkitehtuurilla PowerPC.
|-
|'''Hauppauge''' WinTV-Nexus-CA
|Kortin digitaalinen viritin toimii. Testattu: [[Suse]] 10.0. ja [[Suse]] 10.3. (MythTV, Kaffeine)
|-
|'''Hauppauge''' WinTV NOVA-T USB2 (rev. 93004)
|Toimii oikealla firmwarella. Testattu: Mandriva 2007.
|-
|'''Hauppauge''' WinTV NOVA-T PCI (90002)
|Toimii. Saattaa vaatia moduulin <tt>cx88_dvb</tt> [[modprobe|lataamisen]]. Testattu: Ubuntu 6.06->
|-
|'''Nebula''' DVB-T PCI ja kaukosäädin
|Toimivat. Ohjeet asennukseen löytyvät [http://forum.ubuntu-fi.org/index.php?topic=3634.0 Ubuntu Suomen keskustelualueelta]. Testattu: Ubuntu, Debian.
|-
|'''Pinnacle''' PCTV 300i DVB-T PCI 
|Toimii ytimestä löytyvällä SAA7134-ajurilla. Lisätietoja sen säätämiseen löytyy [http://gentoo-wiki.com/HARDWARE_saa7134 Gentoon wikistä]. 
|-
|'''Technotrend''' C-1500 
|Toimii tuoreimmilla [http://www.linuxtv.org/repo linuxtv.orgin] ajureilla.  Myös oheislaitteena saatava CI-moduuli toimii Conax CAMillamythtv:ssä ja Kaffeinella
|-
|'''Technotrend''' T-1500
|Toimii. Vaatii [http://gentoo-wiki.com/HARDWARE_Terratec_Cinergy_1200_DVB-T#Getting_and_installing_the_needed_firmware get_dvb_firmware]-skriptin käyttöä (sama piirisarja kuin Terratec Cinergy 1200:ssä). Katso myös [http://forum.ubuntu-fi.org/index.php?topic=13743.msg99891#msg99891 oheinen Ubuntu-juttu].
|-
|'''Technotrend''' DVB-C Budget (Hauppauge WinTV NOVA)
|Toimii. Testattu: Suse 10.0
|-
|'''Technotrend/Hauppauge''' WinTV DVB-C rev2.X
|Toimii.
|-
|'''Technotrend''' Premium C-2300
|Digitaalinen viritin toimii. Käytännössä identtinen Hauppauge Nexus-CA:n (yllä) kanssa.
|-
|'''Terratec''' Cinergy T USB XE (USB)
|Toimii [http://www.linuxtv.org linuxtv.orgin] ajurin ja af9005-firmwaren yhdistelmällä. YLEN kanavat näkyivät testissä huonosti, mikä tosin saattoi johtua usb-väylän heikosta virransyötöstä. Testattu: [[Ubuntu]] 7.04.
|-
|'''Terratec''' Cinergy T USB XS (USB)
|Toimii [http://www.iki.fi/kuparine/comp/ubuntu/en/Terratec.html kokeellisella ajurilla]. Testattu: [[Ubuntu]] 7.04 ja 7.10. '''8.04 versiossa toimii täydellisesti''' kun asentaa ubuntu-restricted-extras paketin ja käyttää kaffeine soitinta. Totem tarvitsee ilmeisesti kanavaluettelon johonkin asetustiedostoon, mutta tuo kaffeine osaa virittää kanavat nappia klikkaamalla.
|-
|'''Terratec''' Cinergy T USB XXS (USB)
|Toimii [http://www.iki.fi/kuparine/comp/ubuntu/en/Terratecxxs.html uusimmilla v4l-dvb ajurilla]. Testattu: [[Ubuntu]] 8.04
- Testattu Kubuntu 8.10:ssä: toimii täydellisesti ilman mitään virityksiä (kaffeinella),
myös YLEn tekstitykset. (Kaukosäädintä ei kokeiltu.)
|-
|'''Terratec''' Cinergy T2 (USB)
|Toimii täysin. Testattu: [[Suse]] 10.0, [[Ubuntu]] 7.04 - 10.10.
|-
|'''Terratec''' Cinergy 1200-C
|Toimii suoraan ainakin [[Mythbuntu]] 10.04:llä. Jotkin vanhemmat Linux-versiot: Toimii ajurilla <tt>budget-av</tt>, joka löytyy uusimmista [[ydin|ytimen]] versioista. Huom! Kortista on ilmestynyt uusi versio, jolle pitää itse [[kääntäminen|kääntää]] kokeellinen ajuri, kts [http://www.cs.helsinki.fi/u/aulaskar/digi/'''Terratec'''_cinergy_1200_dvb-c.html ohje] ja [http://linuxtv.org/wiki/index.php/Terratec_Cinergy_1200_DVB-C linuxtv.orgin artikkeli]. Huom2! <tt>v4l-dvb</tt> on kehittynyt sen verran, että nykyään riittää lähdekoodin hakeminen ja kääntäminen. Korjaustiedostoja (''patcheja'') ei tarvita. Testattu: [[Gentoo]], [[Mandriva]], [[Debian]] 4.0, [[Ubuntu]], [[KnoppMyth]], [[Fedora]], [[Mythbuntu]]
|-
|'''Terratec''' Cinergy 1200-T
|Toimii. Vaatii [http://gentoo-wiki.com/HARDWARE_Terratec_Cinergy_1200_DVB-T#Getting_and_installing_the_needed_firmware get_dvb_firmware]-skriptin käyttöä. Katso myös [http://forum.ubuntu-fi.org/index.php?topic=13743.msg99891#msg99891 oheinen Ubuntu-juttu].
|-
|'''Terratec''' Cinergy C PCI
|Toimii, ajuri mukana Linuxin versiossa 2.6.33. DVB-C kortti. Myös HD-kanavat näkyvät. Ajuriprojektit: [http://jusst.de/hg/mantis mantis] ja [http://jusst.de/hg/mantis-v4l mantis-v4l]. Ajuriprojektien vetäjä suosittelee mantis-v4l:n käyttöä. Jos kanavahaku ei kuitenkaan onnistu, lue [http://lists-archives.org/video4linux/27321-mantis-driver-jusst-de-selects-wrong-tuner-on-Terratec-cinergy-c-pci.html tästä] vinkki, jolla moni on saanut kortin toimimaan. Katso myös [http://www.linuxtv.org/wiki/index.php/TerraTec_Cinergy_C_DVB-C oheinen LinuxTVWiki-juttu], [http://tven.Terratec.net/modules.php?op=modload&name=News&file=article&sid=267 valmistajan infosivu] ja [http://thread.gmane.org/gmane.linux.drivers.dvb/39902 patch kaukosäätimelle]. Testattu: [[Fedora]] 8, 9, 10 ja 11 (x86_64), Arch Linux kernelillä 2.6.31 (x86_64). Toimii suoraan Fedora 13 jakelussa, kun /etc/rc.d/rc.local scriptiin laittaa modulin latautumaan '/sbin/modeprobe mantis'.
|-
|'''TwinhanDTV''' Alpha (USB)
|Toimii. Vaatii erikseen ladattavan [http://www.linuxtv.org/downloads/firmware/dvb-usb-vp702x-01.fw firmware-koodin]. Mukana tuleva [[Kaukosäätimet|kaukosäädinkin]] toimii. Huom! Markkinoille on tullut laitteita uudemmalla piirisarjalla(esim. 7045A), joka ei vielä ole tuettu Linuxissa. Testattu: Fedora Core 4, Debian unstable
|-
|'''TwinhanDTV''' USB-Ter (USB1.1)
|Toimii, mutta vaatii [http://www.linuxtv.org/downloads/firmware/dvb-usb-dibusb-5.0.0.11.fw firmware-tiedoston] kopioimisen <tt>hotplug</tt>-kansioon. [[Mepis]] 6:ssa toimii suoraan, [[Suse]] 10.2 vaati vanilla-ytimen (>=2.6.20) kääntämisen.
|}

== Huomioitavia asioita sovittimista ==

USB-sovitin saattaa vaatia enemmän virtaa kuin mitä kaikki koneet antavat usb-porteistaan. Ainakin yhdessä tapauksessa virran loppumin<!---->en näkyi siten, että kortti näytti toimivan oikein, mutta kuvassa oli vaan merkittävästi häiriöitä. Häiriöt näyttivät siltä, että signaali olisi liian heikko. Onneksi tämä vika on helppo korjata ottamalla käyttöön usb toistin (hub), jolla on erillinen sähkönsyöttö.


Nämä (usb-liitäntäiset) myöskin lämpenevät käytössä aika runsaasti.

==Katso myös==
*[[Digiboksit ja Linux]]
*[[DigiTV:n tallennukset DVD:lle]]
*[[Dvb]]
*[[Multimediatietokone]]
*[[Sub.fi]]
*[[YLE Areena]]
*[[MTV3:n Katsomo]]
*[[Ruutu.fi]]

==Aiheesta muualla==
*[http://www.linuxtv.fi/ LinuxTV.fi] (keskustelufoorumi)
*[http://linuxtv.org/wiki/ LinuxTV:n DVB-wiki]
*[http://linuxtv.org/vdrwiki/ LinuxTV:n VDR-wiki]
*[http://linuxtv.org/v4lwiki/ LinuxTV:n video4linux-wiki]

[[Luokka:Laitteisto]]
[[Luokka:Ohjeet]]