Archived:HOW TO Installing DVB: Difference between revisions

From LinuxTVWiki
Jump to navigation Jump to search
(first update to somehow more accurate infos)
Line 1: Line 1:
This page contains information to help an "end user" install a DVB device on his or her GNU/Linux system.
This page contains information to help an "end user" install a DVB device on his or her GNU/Linux system.
<p>'''NOTE:''' Some of the following steps are specific to debian-based distributions, however these instructions should still be helpful to uses of other distributions as a guide.</p>
<p>'''NOTE:''' Some of the following steps are specific to Debian-based distributions, however these instructions should still be helpful to users of other distributions as a guide.</p>

__TOC__


== Required Software ==
== Required Software ==
Before starting, you'll need to have installed the following software:
Before starting, you'll need to have installed the following software:
* mercurial: needed to download the latest source from the Version System used by LinuxTV developers
* mercurial: needed to download the latest source from the source code management system used by LinuxTV developers
* kernel-headers: needed for compiling the the driver
* kernel-headers: needed for compiling the the driver
* compiling suite: tools for compiling and installing the driver
* compiling suite: tools for compiling and installing the driver
Line 13: Line 11:
This guide does not include steps to accomplish the installation of the above software for all distributions.
This guide does not include steps to accomplish the installation of the above software for all distributions.


=== Required Software: Ubuntu, Debian and Debian-based ===
== Required Software: Debian and Debian-based ==
On Debian (or Debian based distributions like Ubuntu) you can use the following command to install all the required software:
On Debian (and Debian-based distributions like Ubuntu) you can use the following command to install all the required software:
sudo apt-get install mercurial linux-headers-$(uname -r) build-essential gcc make
$ sudo apt-get install mercurial linux-headers-$(uname -r) build-essential gcc make


== Obtain latest source ==
== Obtain latest source ==
Now that we have all the software installed you should be able to download the latest source with the following command:
Now that we have all the software installed you should be able to download the latest source with the following command:
hg clone http://linuxtv.org/hg/v4l-dvb
$ hg clone http://linuxtv.org/hg/v4l-dvb
This should create a directory called v4l-dvb in the current working directory.
Let's assume that we have executed the command from the /usr/src directory, so we end up with /usr/src/v4l-dvb


== Compiling the latest Driver ==
== Compiling the latest driver ==
Let's go inside the directory that contains the previously downloaded driver. Continuing with our example, run the command:
Let's go inside the directory that contains the previously downloaded source.
cd /usr/src/v4l-dvb
or
cd v4l-dvb
Now we just have to compile the source with
Now we just have to compile the source with
make
$ make
If you run into any problems here, you can contact the developers via IRC at:
If you run into any problems here, you can contact the developers via IRC at:
* Server: irc.freenode.net
* Server: irc.freenode.net
Line 34: Line 29:


== Obtain the firmware ==
== Obtain the firmware ==
To obtain the firmware needed by your device, you need to know the name and model.
To obtain the firmware needed by your device you need to know the name and model. The device name and model are usually written on the device itself, on the box and/or in the manual, but you can also use the command:
$ lspci -v

if your device is connected by PCI or
=== Discovering the Device Name and Model ===
$ lsusb -v
The device name and model is usually written on the device itself, on the box and/or in the manual, but you can also use the command:
lspci -v
if your device is connected by PCI, or
lsusb -v
if your device is connected by USB to discover such information.
if your device is connected by USB to discover such information.


Line 48: Line 40:
* [[DVB-C_cards|DVB-C Devices]]
* [[DVB-C_cards|DVB-C Devices]]
* [[DVB-T_cards|DVB-T Devices]]
* [[DVB-T_cards|DVB-T Devices]]
There you can find which firmware you'll require.
There you can find which firmware you'll require (if any).


=== Downloading and Installing the firmware ===
=== Downloading and installing the firmware ===
The firmware can be found on one of the following addresses:
The firmware can be found on one of the following addresses:
* http://linuxtv.org/downloads/firmware/
* http://thadathil.net:8000/dvb/fw/
* http://thadathil.net:8000/dvb/fw/
* http://thadathil.net:8000/dvb/fw/dvb-usb/
* http://thadathil.net:8000/dvb/fw/dvb-usb/
It must be downloaded to the directory used by your hotplug installation; that usually depends on the distribution you're using. Normally it's one of the following directories:
* http://linuxtv.org/downloads/firmware/
It must be downloaded to the directory used by your hotplug installation; that usually depends on the distribution that you're using. Directories often used are:
/lib/firmware/$(uname -r) [Ubuntu users - use this directoy for each kernel installed]
/lib/hotplug/firmware/
/lib/firmware
/lib/firmware
/usr/lib/hotplug/firmware/


== Installing the driver ==
== Installing the driver ==
The next step is to install the driver, and connect the device to your PC (if external). To install the driver you have to execute:
The next step is to install the driver. To install the driver you have to execute:
sudo make unload
$ sudo make install
Then connect the device (if external) and reboot. After that start your preferred program for watching DVB (eg. [[Kaffeine]]).
sudo make install
Connect the device and then start your preferred program for watching DVB (eg. [[Kaffeine]]).


== Appendix A: Further reading ==
== Appendix A: Further reading ==
Line 82: Line 72:


A: It's possible that you've saved the firmware in a directory that's not used by the hotplug system for discovering the available firmware, or the firmare is not readble by ALL users. Also, read Documentation/dvb/udev.txt included in your kernel documentation to ensure udev is configured correctly.
A: It's possible that you've saved the firmware in a directory that's not used by the hotplug system for discovering the available firmware, or the firmare is not readble by ALL users. Also, read Documentation/dvb/udev.txt included in your kernel documentation to ensure udev is configured correctly.

== Appendix C: Credits ==
This page was created by:
* Stefano "Kismet" Lenzi

Revision as of 15:06, 11 July 2006

This page contains information to help an "end user" install a DVB device on his or her GNU/Linux system.

NOTE: Some of the following steps are specific to Debian-based distributions, however these instructions should still be helpful to users of other distributions as a guide.

Required Software

Before starting, you'll need to have installed the following software:

  • mercurial: needed to download the latest source from the source code management system used by LinuxTV developers
  • kernel-headers: needed for compiling the the driver
  • compiling suite: tools for compiling and installing the driver
    • make
    • gcc

This guide does not include steps to accomplish the installation of the above software for all distributions.

Required Software: Debian and Debian-based

On Debian (and Debian-based distributions like Ubuntu) you can use the following command to install all the required software:

 $ sudo apt-get install mercurial linux-headers-$(uname -r) build-essential gcc make

Obtain latest source

Now that we have all the software installed you should be able to download the latest source with the following command:

 $ hg clone http://linuxtv.org/hg/v4l-dvb

This should create a directory called v4l-dvb in the current working directory.

Compiling the latest driver

Let's go inside the directory that contains the previously downloaded source. Now we just have to compile the source with

 $ make

If you run into any problems here, you can contact the developers via IRC at:

  • Server: irc.freenode.net
  • Channels: #linuxtv #dvb

Obtain the firmware

To obtain the firmware needed by your device you need to know the name and model. The device name and model are usually written on the device itself, on the box and/or in the manual, but you can also use the command:

 $ lspci -v

if your device is connected by PCI or

 $ lsusb -v

if your device is connected by USB to discover such information.

Selecting the right firmware

Now that you know the details of your device, you can look at the list of the supported devices at:

There you can find which firmware you'll require (if any).

Downloading and installing the firmware

The firmware can be found on one of the following addresses:

It must be downloaded to the directory used by your hotplug installation; that usually depends on the distribution you're using. Normally it's one of the following directories:

 /lib/firmware
 /usr/lib/hotplug/firmware/ 

Installing the driver

The next step is to install the driver. To install the driver you have to execute:

 $ sudo make install

Then connect the device (if external) and reboot. After that start your preferred program for watching DVB (eg. Kaffeine).

Appendix A: Further reading

Further steps can be followed at:

Appendix B: FAQ

Q: My device was working perfectly previously, but now is not recongnized anymore. Any idea why?

A: It's possible that you're using a different kernel now, so you have to install the driver again and ensure that the firmware is reached by the hotplug system. This problem occurs due to certain distributions (such as Ubuntu) using a firmware directory specific to each kernel version installed.

Q: My DVB device is recognized but I'm not able to use it. What can I do?

A: You should check that the user that is trying to access DVB device has permissions to read and write to the /dev/dvb directory which contains all virtual files representing a DVB device discovered by your system.

Q: I have download the firmware but /dev/dvb is not present on my system. How come?

A: It's possible that you've saved the firmware in a directory that's not used by the hotplug system for discovering the available firmware, or the firmare is not readble by ALL users. Also, read Documentation/dvb/udev.txt included in your kernel documentation to ensure udev is configured correctly.