Merge tag 'leds-5.11-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git/pavel...
[linux-2.6-microblaze.git] / Documentation / admin-guide / media / avermedia.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 ======================================
4 Avermedia DVB-T on BT878 Release Notes
5 ======================================
6
7 February 14th 2006
8
9 .. note::
10
11    Several other Avermedia devices are supported. For a more
12    broader and updated content about that, please check:
13
14    https://linuxtv.org/wiki/index.php/AVerMedia
15
16 The Avermedia DVB-T
17 ~~~~~~~~~~~~~~~~~~~
18
19 The Avermedia DVB-T is a budget PCI DVB card. It has 3 inputs:
20
21 * RF Tuner Input
22 * Composite Video Input (RCA Jack)
23 * SVIDEO Input (Mini-DIN)
24
25 The  RF  Tuner  Input  is the input to the tuner module of the
26 card.  The  Tuner  is  otherwise known as the "Frontend" . The
27 Frontend of the Avermedia DVB-T is a Microtune 7202D. A timely
28 post  to  the  linux-dvb  mailing  list  ascertained  that the
29 Microtune  7202D  is  supported  by the sp887x driver which is
30 found in the dvb-hw CVS module.
31
32 The  DVB-T card is based around the BT878 chip which is a very
33 common multimedia bridge and often found on Analogue TV cards.
34 There is no on-board MPEG2 decoder, which means that all MPEG2
35 decoding  must  be done in software, or if you have one, on an
36 MPEG2 hardware decoding card or chipset.
37
38
39 Getting the card going
40 ~~~~~~~~~~~~~~~~~~~~~~
41
42 At  this  stage,  it  has  not  been  able  to  ascertain  the
43 functionality  of the remaining device nodes in respect of the
44 Avermedia  DVBT.  However,  full  functionality  in respect of
45 tuning,  receiving  and  supplying  the  MPEG2  data stream is
46 possible  with the currently available versions of the driver.
47 It  may be possible that additional functionality is available
48 from  the  card  (i.e.  viewing the additional analogue inputs
49 that  the card presents), but this has not been tested yet. If
50 I get around to this, I'll update the document with whatever I
51 find.
52
53 To  power  up  the  card,  load  the  following modules in the
54 following order:
55
56 * modprobe bttv (normally loaded automatically)
57 * modprobe dvb-bt8xx (or place dvb-bt8xx in /etc/modules)
58
59 Insertion  of  these  modules  into  the  running  kernel will
60 activate the appropriate DVB device nodes. It is then possible
61 to start accessing the card with utilities such as scan, tzap,
62 dvbstream etc.
63
64 The frontend module sp887x.o, requires an external   firmware.
65 Please use  the  command "get_dvb_firmware sp887x" to download
66 it. Then copy it to /usr/lib/hotplug/firmware or /lib/firmware/
67 (depending on configuration of firmware hotplug).
68
69 Known Limitations
70 ~~~~~~~~~~~~~~~~~
71
72 At  present  I can say with confidence that the frontend tunes
73 via /dev/dvb/adapter{x}/frontend0 and supplies an MPEG2 stream
74 via   /dev/dvb/adapter{x}/dvr0.   I   have   not   tested  the
75 functionality  of any other part of the card yet. I will do so
76 over time and update this document.
77
78 There  are some limitations in the i2c layer due to a returned
79 error message inconsistency. Although this generates errors in
80 dmesg  and  the  system logs, it does not appear to affect the
81 ability of the frontend to function correctly.
82
83 Further Update
84 ~~~~~~~~~~~~~~
85
86 dvbstream  and  VideoLAN  Client on windows works a treat with
87 DVB,  in  fact  this  is  currently  serving as my main way of
88 viewing  DVB-T  at  the  moment.  Additionally, VLC is happily
89 decoding  HDTV  signals,  although  the PC is dropping the odd
90 frame here and there - I assume due to processing capability -
91 as all the decoding is being done under windows in software.
92
93 Many  thanks to Nigel Pearson for the updates to this document
94 since the recent revision of the driver.