aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorJohannes Stezenbach <js@linuxtv.org>2005-06-24 01:02:35 -0400
committerLinus Torvalds <torvalds@ppc970.osdl.org>2005-06-24 03:05:30 -0400
commit776338e121b9db3156bfb4e21622a0219bbab9d4 (patch)
tree5102272b708a9e8ff81165714870d3d38363cc23 /Documentation
parentb6a235b1186dda0800c8bedc2526830a4a36b44e (diff)
[PATCH] dvb: Add generalized dvb-usb driver
Add generalized dvb-usb driver which supports a wide variety of devices. Signed-off-by: Patrick Boettcher <pb@linuxtv.org> Signed-off-by: Johannes Stezenbach <js@linuxtv.org> Signed-off-by: Randy Dunlap <rdunlap@xenotime.net> Signed-off-by: Andrew Morton <akpm@osdl.org> Signed-off-by: Linus Torvalds <torvalds@osdl.org>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/dvb/README.dvb-usb308
1 files changed, 308 insertions, 0 deletions
diff --git a/Documentation/dvb/README.dvb-usb b/Documentation/dvb/README.dvb-usb
new file mode 100644
index 000000000000..c7ed01b9f8f4
--- /dev/null
+++ b/Documentation/dvb/README.dvb-usb
@@ -0,0 +1,308 @@
1Documentation for dvb-usb-framework module and its devices
2
3Idea behind the dvb-usb-framework
4=================================
5
6In March 2005 I got the new Twinhan USB2.0 DVB-T device. They provided specs and a firmware.
7
8Quite keen I wanted to put the driver (with some quirks of course) into dibusb.
9After reading some specs and doing some USB snooping, it realized, that the
10dibusb-driver would be a complete mess afterwards. So I decided to do it in a
11different way: With the help of a dvb-usb-framework.
12
13The framework provides generic functions (mostly kernel API calls), such as:
14
15- Transport Stream URB handling in conjunction with dvb-demux-feed-control
16 (bulk and isoc (TODO) are supported)
17- registering the device for the DVB-API
18- registering an I2C-adapter if applicable
19- remote-control/input-device handling
20- firmware requesting and loading (currently just for the Cypress USB
21 controller)
22- other functions/methods which can be shared by several drivers (such as
23 functions for bulk-control-commands)
24
25The source code of the particular DVB USB devices does just the communication
26with the device via the bus. The connection between the DVB-API-functionality
27is done via callbacks, assigned in a static device-description (struct
28dvb_usb_device) each device-driver has to have.
29
30For an example have a look in drivers/media/dvb/dvb-usb/vp7045*.
31
32Objective is to migrate all the usb-devices (dibusb, cinergyT2, maybe the
33ttusb; flexcop-usb already benefits from the generic flexcop-device) to use
34the dvb-usb-lib.
35
36TODO: dynamic enabling and disabling of the pid-filter in regard to number of
37feeds requested.
38
39Supported devices USB1.1
40========================
41
42Produced and reselled by Twinhan:
43---------------------------------
44- TwinhanDTV USB-Ter DVB-T Device (VP7041)
45 http://www.twinhan.com/product_terrestrial_3.asp
46
47- TwinhanDTV Magic Box (VP7041e)
48 http://www.twinhan.com/product_terrestrial_4.asp
49
50- HAMA DVB-T USB device
51 http://www.hama.de/portal/articleId*110620/action*2598
52
53- CTS Portable (Chinese Television System) (2)
54 http://www.2cts.tv/ctsportable/
55
56- Unknown USB DVB-T device with vendor ID Hyper-Paltek
57
58
59Produced and reselled by KWorld:
60--------------------------------
61- KWorld V-Stream XPERT DTV DVB-T USB
62 http://www.kworld.com.tw/en/product/DVBT-USB/DVBT-USB.html
63
64- JetWay DTV DVB-T USB
65 http://www.jetway.com.tw/evisn/product/lcd-tv/DVT-USB/dtv-usb.htm
66
67- ADSTech Instant TV DVB-T USB
68 http://www.adstech.com/products/PTV-333/intro/PTV-333_intro.asp?pid=PTV-333
69
70
71Others:
72-------
73- Ultima Electronic/Artec T1 USB TVBOX (AN2135, AN2235, AN2235 with Panasonic Tuner)
74 http://82.161.246.249/products-tvbox.html
75
76- Compro Videomate DVB-U2000 - DVB-T USB (2)
77 http://www.comprousa.com/products/vmu2000.htm
78
79- Grandtec USB DVB-T
80 http://www.grand.com.tw/
81
82- AVerMedia AverTV DVBT USB
83 http://www.avermedia.com/
84
85- DiBcom USB DVB-T reference device (non-public)
86
87
88Supported devices USB2.0-only
89=============================
90- Twinhan MagicBox II
91 http://www.twinhan.com/product_terrestrial_7.asp
92
93- TwinhanDTV Alpha
94 http://www.twinhan.com/product_terrestrial_8.asp
95
96- DigitalNow TinyUSB 2 DVB-t Receiver
97 http://www.digitalnow.com.au/DigitalNow%20tinyUSB2%20Specifications.html
98
99- Hanftek UMT-010
100 http://www.globalsources.com/si/6008819757082/ProductDetail/Digital-TV/product_id-100046529
101
102
103Supported devices USB2.0 and USB1.1
104=============================
105- Typhoon/Yakumo/HAMA/Yuan DVB-T mobile USB2.0
106 http://www.yakumo.de/produkte/index.php?pid=1&ag=DVB-T
107 http://www.yuan.com.tw/en/products/vdo_ub300.html
108 http://www.hama.de/portal/articleId*114663/action*2563
109 http://www.anubisline.com/english/articlec.asp?id=50502&catid=002
110
111- Artec T1 USB TVBOX (FX2) (2)
112
113- Hauppauge WinTV NOVA-T USB2
114 http://www.hauppauge.com/
115
116- KWorld/ADSTech Instant DVB-T USB2.0 (DiB3000M-B)
117
118- DiBcom USB2.0 DVB-T reference device (non-public)
119
120- AVerMedia AverTV A800 DVB-T USB2.0
121
1221) It is working almost - work-in-progress.
1232) No test reports received yet.
124
1250. History & News:
126 2005-04-17 - all dibusb devices ported to make use of the dvb-usb-framework
127 2005-04-02 - re-enabled and improved remote control code.
128 2005-03-31 - ported the Yakumo/Hama/Typhoon DVB-T USB2.0 device to dvb-usb.
129 2005-03-30 - first commit of the dvb-usb-module based on the dibusb-source. First device is a new driver for the
130 TwinhanDTV Alpha / MagicBox II USB2.0-only DVB-T device.
131
132 (change from dvb-dibusb to dvb-usb)
133 2005-03-28 - added support for the AVerMedia AverTV DVB-T USB2.0 device (Thanks to Glen Harris and Jiun-Kuei Jung, AVerMedia)
134 2005-03-14 - added support for the Typhoon/Yakumo/HAMA DVB-T mobile USB2.0
135 2005-02-11 - added support for the KWorld/ADSTech Instant DVB-T USB2.0. Thanks a lot to Joachim von Caron
136 2005-02-02 - added support for the Hauppauge Win-TV Nova-T USB2
137 2005-01-31 - distorted streaming is gone for USB1.1 devices
138 2005-01-13 - moved the mirrored pid_filter_table back to dvb-dibusb
139 - first almost working version for HanfTek UMT-010
140 - found out, that Yakumo/HAMA/Typhoon are predessors of the HanfTek UMT-010
141 2005-01-10 - refactoring completed, now everything is very delightful
142 - tuner quirks for some weird devices (Artec T1 AN2235 device has sometimes a
143 Panasonic Tuner assembled). Tunerprobing implemented. Thanks a lot to Gunnar Wittich.
144 2004-12-29 - after several days of struggling around bug of no returning URBs fixed.
145 2004-12-26 - refactored the dibusb-driver, splitted into separate files
146 - i2c-probing enabled
147 2004-12-06 - possibility for demod i2c-address probing
148 - new usb IDs (Compro, Artec)
149 2004-11-23 - merged changes from DiB3000MC_ver2.1
150 - revised the debugging
151 - possibility to deliver the complete TS for USB2.0
152 2004-11-21 - first working version of the dib3000mc/p frontend driver.
153 2004-11-12 - added additional remote control keys. Thanks to Uwe Hanke.
154 2004-11-07 - added remote control support. Thanks to David Matthews.
155 2004-11-05 - added support for a new devices (Grandtec/Avermedia/Artec)
156 - merged my changes (for dib3000mb/dibusb) to the FE_REFACTORING, because it became HEAD
157 - moved transfer control (pid filter, fifo control) from usb driver to frontend, it seems
158 better settled there (added xfer_ops-struct)
159 - created a common files for frontends (mc/p/mb)
160 2004-09-28 - added support for a new device (Unkown, vendor ID is Hyper-Paltek)
161 2004-09-20 - added support for a new device (Compro DVB-U2000), thanks
162 to Amaury Demol for reporting
163 - changed usb TS transfer method (several urbs, stopping transfer
164 before setting a new pid)
165 2004-09-13 - added support for a new device (Artec T1 USB TVBOX), thanks
166 to Christian Motschke for reporting
167 2004-09-05 - released the dibusb device and dib3000mb-frontend driver
168
169 (old news for vp7041.c)
170 2004-07-15 - found out, by accident, that the device has a TUA6010XS for
171 PLL
172 2004-07-12 - figured out, that the driver should also work with the
173 CTS Portable (Chinese Television System)
174 2004-07-08 - firmware-extraction-2.422-problem solved, driver is now working
175 properly with firmware extracted from 2.422
176 - #if for 2.6.4 (dvb), compile issue
177 - changed firmware handling, see vp7041.txt sec 1.1
178 2004-07-02 - some tuner modifications, v0.1, cleanups, first public
179 2004-06-28 - now using the dvb_dmx_swfilter_packets, everything
180 runs fine now
181 2004-06-27 - able to watch and switching channels (pre-alpha)
182 - no section filtering yet
183 2004-06-06 - first TS received, but kernel oops :/
184 2004-05-14 - firmware loader is working
185 2004-05-11 - start writing the driver
186
1871. How to use?
1881.1. Firmware
189
190Most of the USB drivers need to download a firmware to start working.
191
192for USB1.1 (AN2135) you need: dvb-usb-dibusb-5.0.0.11.fw
193for USB2.0 HanfTek: dvb-usb-umt-010-02.fw
194for USB2.0 DiBcom: dvb-usb-dibusb-6.0.0.8.fw
195for USB2.0 AVerMedia AverTV DVB-T USB2: dvb-usb-avertv-a800-01.fw
196for USB2.0 TwinhanDTV Alpha/MagicBox II: dvb-usb-vp7045-01.fw
197
198The files can be found on http://www.linuxtv.org/download/firmware/ .
199
200We do not have the permission (yet) to publish the following firmware-files.
201You'll need to extract them from the windows drivers.
202
203You should be able to use "get_dvb_firmware dvb-usb" to get the firmware:
204
205for USB1.1 (AN2235) (a few Artec T1 devices): dvb-usb-dibusb-an2235-01.fw
206for USB2.0 Hauppauge: dvb-usb-nova-t-usb2-01.fw
207for USB2.0 ADSTech/Kworld USB2.0: dvb-usb-adstech-usb2-01.fw
208for USB2.0 Yakumo/Typhoon/Hama: dvb-usb-dtt200u-01.fw
209
2101.2. Compiling
211
212Since the driver is in the linux kernel, activating the driver in
213your favorite config-environment should sufficient. I recommend
214to compile the driver as module. Hotplug does the rest.
215
216If you use dvb-kernel enter the build-2.6 directory run 'make' and 'insmod.sh
217load' afterwards.
218
2191.3. Loading the drivers
220
221Hotplug is able to load the driver, when it is needed (because you plugged
222in the device).
223
224If you want to enable debug output, you have to load the driver manually and
225from withing the dvb-kernel cvs repository.
226
227first have a look, which debug level are available:
228
229modinfo dvb-usb
230modinfo dvb-usb-vp7045
231etc.
232
233modprobe dvb-usb debug=<level>
234modprobe dvb-usb-vp7045 debug=<level>
235etc.
236
237should do the trick.
238
239When the driver is loaded successfully, the firmware file was in
240the right place and the device is connected, the "Power"-LED should be
241turned on.
242
243At this point you should be able to start a dvb-capable application. I'm use
244(t|s)zap, mplayer and dvbscan to test the basics. VDR-xine provides the
245long-term test scenario.
246
2472. Known problems and bugs
248
249- Don't remove the USB device while running an DVB application, your system
250 will go crazy or die most likely.
251
2522.1. Adding support for devices
253
254TODO
255
2562.2. USB1.1 Bandwidth limitation
257
258A lot of the currently supported devices are USB1.1 and thus they have a
259maximum bandwidth of about 5-6 MBit/s when connected to a USB2.0 hub.
260This is not enough for receiving the complete transport stream of a
261DVB-T channel (which is about 16 MBit/s). Normally this is not a
262problem, if you only want to watch TV (this does not apply for HDTV),
263but watching a channel while recording another channel on the same
264frequency simply does not work very well. This applies to all USB1.1
265DVB-T devices, not just the dvb-usb-devices)
266
267The bug, where the TS is distorted by a heavy usage of the device is gone
268definitely. All dvb-usb-devices I was using (Twinhan, Kworld, DiBcom) are
269working like charm now with VDR. Sometimes I even was able to record a channel
270and watch another one.
271
2722.3. Comments
273
274Patches, comments and suggestions are very very welcome.
275
2763. Acknowledgements
277 Amaury Demol (ademol@dibcom.fr) and Francois Kanounnikoff from DiBcom for
278 providing specs, code and help, on which the dvb-dibusb, dib3000mb and
279 dib3000mc are based.
280
281 David Matthews for identifying a new device type (Artec T1 with AN2235)
282 and for extending dibusb with remote control event handling. Thank you.
283
284 Alex Woods for frequently answering question about usb and dvb
285 stuff, a big thank you.
286
287 Bernd Wagner for helping with huge bug reports and discussions.
288
289 Gunnar Wittich and Joachim von Caron for their trust for providing
290 root-shells on their machines to implement support for new devices.
291
292 Glen Harris for bringing up, that there is a new dibusb-device and Jiun-Kuei
293 Jung from AVerMedia who kindly provided a special firmware to get the device
294 up and running in Linux.
295
296 Jennifer Chen, Jeff and Jack from Twinhan for kindly supporting by
297 writing the vp7045-driver.
298
299 Some guys on the linux-dvb mailing list for encouraging me
300
301 Peter Schildmann >peter.schildmann-nospam-at-web.de< for his
302 user-level firmware loader, which saves a lot of time
303 (when writing the vp7041 driver)
304
305 Ulf Hermenau for helping me out with traditional chinese.
306
307 André Smoktun and Christian Frömmel for supporting me with
308 hardware and listening to my problems very patient.