README.dvb-usb 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238
  1. Documentation for dvb-usb-framework module and its devices
  2. Idea behind the dvb-usb-framework
  3. =================================
  4. In March 2005 I got the new Twinhan USB2.0 DVB-T device. They provided specs and a firmware.
  5. Quite keen I wanted to put the driver (with some quirks of course) into dibusb.
  6. After reading some specs and doing some USB snooping, it realized, that the
  7. dibusb-driver would be a complete mess afterwards. So I decided to do it in a
  8. different way: With the help of a dvb-usb-framework.
  9. The framework provides generic functions (mostly kernel API calls), such as:
  10. - Transport Stream URB handling in conjunction with dvb-demux-feed-control
  11. (bulk and isoc are supported)
  12. - registering the device for the DVB-API
  13. - registering an I2C-adapter if applicable
  14. - remote-control/input-device handling
  15. - firmware requesting and loading (currently just for the Cypress USB
  16. controllers)
  17. - other functions/methods which can be shared by several drivers (such as
  18. functions for bulk-control-commands)
  19. - TODO: a I2C-chunker. It creates device-specific chunks of register-accesses
  20. depending on length of a register and the number of values that can be
  21. multi-written and multi-read.
  22. The source code of the particular DVB USB devices does just the communication
  23. with the device via the bus. The connection between the DVB-API-functionality
  24. is done via callbacks, assigned in a static device-description (struct
  25. dvb_usb_device) each device-driver has to have.
  26. For an example have a look in drivers/media/dvb/dvb-usb/vp7045*.
  27. Objective is to migrate all the usb-devices (dibusb, cinergyT2, maybe the
  28. ttusb; flexcop-usb already benefits from the generic flexcop-device) to use
  29. the dvb-usb-lib.
  30. TODO: dynamic enabling and disabling of the pid-filter in regard to number of
  31. feeds requested.
  32. Supported devices
  33. ========================
  34. See the LinuxTV DVB Wiki at www.linuxtv.org for a complete list of
  35. cards/drivers/firmwares:
  36. http://www.linuxtv.org/wiki/index.php/DVB_USB
  37. 0. History & News:
  38. 2005-05-30 - added basic isochronous support to the dvb-usb-framework
  39. added support for Conexant Hybrid reference design and Nebula DigiTV USB
  40. 2005-04-17 - all dibusb devices ported to make use of the dvb-usb-framework
  41. 2005-04-02 - re-enabled and improved remote control code.
  42. 2005-03-31 - ported the Yakumo/Hama/Typhoon DVB-T USB2.0 device to dvb-usb.
  43. 2005-03-30 - first commit of the dvb-usb-module based on the dibusb-source. First device is a new driver for the
  44. TwinhanDTV Alpha / MagicBox II USB2.0-only DVB-T device.
  45. (change from dvb-dibusb to dvb-usb)
  46. 2005-03-28 - added support for the AVerMedia AverTV DVB-T USB2.0 device (Thanks to Glen Harris and Jiun-Kuei Jung, AVerMedia)
  47. 2005-03-14 - added support for the Typhoon/Yakumo/HAMA DVB-T mobile USB2.0
  48. 2005-02-11 - added support for the KWorld/ADSTech Instant DVB-T USB2.0. Thanks a lot to Joachim von Caron
  49. 2005-02-02 - added support for the Hauppauge Win-TV Nova-T USB2
  50. 2005-01-31 - distorted streaming is gone for USB1.1 devices
  51. 2005-01-13 - moved the mirrored pid_filter_table back to dvb-dibusb
  52. - first almost working version for HanfTek UMT-010
  53. - found out, that Yakumo/HAMA/Typhoon are predessors of the HanfTek UMT-010
  54. 2005-01-10 - refactoring completed, now everything is very delightful
  55. - tuner quirks for some weird devices (Artec T1 AN2235 device has sometimes a
  56. Panasonic Tuner assembled). Tunerprobing implemented. Thanks a lot to Gunnar Wittich.
  57. 2004-12-29 - after several days of struggling around bug of no returning URBs fixed.
  58. 2004-12-26 - refactored the dibusb-driver, splitted into separate files
  59. - i2c-probing enabled
  60. 2004-12-06 - possibility for demod i2c-address probing
  61. - new usb IDs (Compro, Artec)
  62. 2004-11-23 - merged changes from DiB3000MC_ver2.1
  63. - revised the debugging
  64. - possibility to deliver the complete TS for USB2.0
  65. 2004-11-21 - first working version of the dib3000mc/p frontend driver.
  66. 2004-11-12 - added additional remote control keys. Thanks to Uwe Hanke.
  67. 2004-11-07 - added remote control support. Thanks to David Matthews.
  68. 2004-11-05 - added support for a new devices (Grandtec/Avermedia/Artec)
  69. - merged my changes (for dib3000mb/dibusb) to the FE_REFACTORING, because it became HEAD
  70. - moved transfer control (pid filter, fifo control) from usb driver to frontend, it seems
  71. better settled there (added xfer_ops-struct)
  72. - created a common files for frontends (mc/p/mb)
  73. 2004-09-28 - added support for a new device (Unkown, vendor ID is Hyper-Paltek)
  74. 2004-09-20 - added support for a new device (Compro DVB-U2000), thanks
  75. to Amaury Demol for reporting
  76. - changed usb TS transfer method (several urbs, stopping transfer
  77. before setting a new pid)
  78. 2004-09-13 - added support for a new device (Artec T1 USB TVBOX), thanks
  79. to Christian Motschke for reporting
  80. 2004-09-05 - released the dibusb device and dib3000mb-frontend driver
  81. (old news for vp7041.c)
  82. 2004-07-15 - found out, by accident, that the device has a TUA6010XS for
  83. PLL
  84. 2004-07-12 - figured out, that the driver should also work with the
  85. CTS Portable (Chinese Television System)
  86. 2004-07-08 - firmware-extraction-2.422-problem solved, driver is now working
  87. properly with firmware extracted from 2.422
  88. - #if for 2.6.4 (dvb), compile issue
  89. - changed firmware handling, see vp7041.txt sec 1.1
  90. 2004-07-02 - some tuner modifications, v0.1, cleanups, first public
  91. 2004-06-28 - now using the dvb_dmx_swfilter_packets, everything
  92. runs fine now
  93. 2004-06-27 - able to watch and switching channels (pre-alpha)
  94. - no section filtering yet
  95. 2004-06-06 - first TS received, but kernel oops :/
  96. 2004-05-14 - firmware loader is working
  97. 2004-05-11 - start writing the driver
  98. 1. How to use?
  99. 1.1. Firmware
  100. Most of the USB drivers need to download a firmware to start working.
  101. for USB1.1 (AN2135) you need: dvb-usb-dibusb-5.0.0.11.fw
  102. for USB2.0 HanfTek: dvb-usb-umt-010-02.fw
  103. for USB2.0 DiBcom: dvb-usb-dibusb-6.0.0.8.fw
  104. for USB2.0 AVerMedia AverTV DVB-T USB2: dvb-usb-avertv-a800-01.fw
  105. for USB2.0 TwinhanDTV Alpha/MagicBox II: dvb-usb-vp7045-01.fw
  106. The files can be found on http://www.linuxtv.org/download/firmware/ .
  107. We do not have the permission (yet) to publish the following firmware-files.
  108. You'll need to extract them from the windows drivers.
  109. You should be able to use "get_dvb_firmware dvb-usb" to get the firmware:
  110. for USB1.1 (AN2235) (a few Artec T1 devices): dvb-usb-dibusb-an2235-01.fw
  111. for USB2.0 Hauppauge: dvb-usb-nova-t-usb2-01.fw
  112. for USB2.0 ADSTech/Kworld USB2.0: dvb-usb-adstech-usb2-01.fw
  113. for USB2.0 Yakumo/Typhoon/Hama: dvb-usb-dtt200u-01.fw
  114. 1.2. Compiling
  115. Since the driver is in the linux kernel, activating the driver in
  116. your favorite config-environment should sufficient. I recommend
  117. to compile the driver as module. Hotplug does the rest.
  118. If you use dvb-kernel enter the build-2.6 directory run 'make' and 'insmod.sh
  119. load' afterwards.
  120. 1.3. Loading the drivers
  121. Hotplug is able to load the driver, when it is needed (because you plugged
  122. in the device).
  123. If you want to enable debug output, you have to load the driver manually and
  124. from withing the dvb-kernel cvs repository.
  125. first have a look, which debug level are available:
  126. modinfo dvb-usb
  127. modinfo dvb-usb-vp7045
  128. etc.
  129. modprobe dvb-usb debug=<level>
  130. modprobe dvb-usb-vp7045 debug=<level>
  131. etc.
  132. should do the trick.
  133. When the driver is loaded successfully, the firmware file was in
  134. the right place and the device is connected, the "Power"-LED should be
  135. turned on.
  136. At this point you should be able to start a dvb-capable application. I'm use
  137. (t|s)zap, mplayer and dvbscan to test the basics. VDR-xine provides the
  138. long-term test scenario.
  139. 2. Known problems and bugs
  140. - Don't remove the USB device while running an DVB application, your system
  141. will go crazy or die most likely.
  142. 2.1. Adding support for devices
  143. TODO
  144. 2.2. USB1.1 Bandwidth limitation
  145. A lot of the currently supported devices are USB1.1 and thus they have a
  146. maximum bandwidth of about 5-6 MBit/s when connected to a USB2.0 hub.
  147. This is not enough for receiving the complete transport stream of a
  148. DVB-T channel (which is about 16 MBit/s). Normally this is not a
  149. problem, if you only want to watch TV (this does not apply for HDTV),
  150. but watching a channel while recording another channel on the same
  151. frequency simply does not work very well. This applies to all USB1.1
  152. DVB-T devices, not just the dvb-usb-devices)
  153. The bug, where the TS is distorted by a heavy usage of the device is gone
  154. definitely. All dvb-usb-devices I was using (Twinhan, Kworld, DiBcom) are
  155. working like charm now with VDR. Sometimes I even was able to record a channel
  156. and watch another one.
  157. 2.3. Comments
  158. Patches, comments and suggestions are very very welcome.
  159. 3. Acknowledgements
  160. Amaury Demol (ademol@dibcom.fr) and Francois Kanounnikoff from DiBcom for
  161. providing specs, code and help, on which the dvb-dibusb, dib3000mb and
  162. dib3000mc are based.
  163. David Matthews for identifying a new device type (Artec T1 with AN2235)
  164. and for extending dibusb with remote control event handling. Thank you.
  165. Alex Woods for frequently answering question about usb and dvb
  166. stuff, a big thank you.
  167. Bernd Wagner for helping with huge bug reports and discussions.
  168. Gunnar Wittich and Joachim von Caron for their trust for providing
  169. root-shells on their machines to implement support for new devices.
  170. Allan Third and Michael Hutchinson for their help to write the Nebula
  171. digitv-driver.
  172. Glen Harris for bringing up, that there is a new dibusb-device and Jiun-Kuei
  173. Jung from AVerMedia who kindly provided a special firmware to get the device
  174. up and running in Linux.
  175. Jennifer Chen, Jeff and Jack from Twinhan for kindly supporting by
  176. writing the vp7045-driver.
  177. Some guys on the linux-dvb mailing list for encouraging me
  178. Peter Schildmann >peter.schildmann-nospam-at-web.de< for his
  179. user-level firmware loader, which saves a lot of time
  180. (when writing the vp7041 driver)
  181. Ulf Hermenau for helping me out with traditional chinese.
  182. André Smoktun and Christian Frömmel for supporting me with
  183. hardware and listening to my problems very patiently.