update by Mark Edwards

1 files changed, 62 insertions, 187 deletions

diff --git a/linux/Documentation/dvb/avermedia.txt b/linux/Documentation/dvb/avermedia.txt
index 050e72be8..5d8dbdada 100644
--- a/linux/Documentation/dvb/avermedia.txt
+++ b/linux/Documentation/dvb/avermedia.txt
@@ -1,23 +1,3 @@
-Hi all,
-
-Mark Edwards was so kind to describe the steps he did to get his (at this time
-unsupported) Avermedia DVB-T card running. Since this is a nice introduction 
-to the DVB infrastructure I added the file to the LinuxDVB CVS repository.
-
-We hope it can help you to get your new unsupported card running or it's just
-an interesting lecture if you are new to the DVB stuff and want to know how
-things work together.
-
-The mentioned patches are now part of the LinuxDVB CVS, you don't have to apply
-them again.
-
-have fun,
-
-Holger
-
-
---------------------------------------------------------------------------------
-
 
 HOWTO: Get An Avermedia DVB-T working under Linux
            ______________________________________________
@@ -26,9 +6,10 @@ HOWTO: Get An Avermedia DVB-T working under Linux
    Assumptions and Introduction
    The Avermedia DVB-T
    Getting the card going
+   Getting the Firmware
    Receiving DVB-T in Australia
-   Patching dvb-bt8xx
    Known Limitations
+   Further Update
 
 Assumptions and Introduction
 
@@ -64,7 +45,7 @@ Assumptions and Introduction
 
    The  digital  datastream from an Analogue TV card is generated
    by  circuitry on the card and is often presented uncompressed.
-   For  a PAL TV signal encoded at a resolution of 720x576 24-bit
+   For  a PAL TV signal encoded at a resolution of 768x576 24-bit
    color pixels over 25 frames per second - a fair amount of data
    is  generated and must be proceesed by the PC before it can be
    displayed  on the video monitor screen. Some Analogue TV cards
@@ -110,7 +91,8 @@ The Avermedia DVB-T
    The  DVB-T card is based around the BT878 chip which is a very
    common multimedia bridge and often found on Analogue TV cards.
    There is no on-board MPEG2 decoder, which means that all MPEG2
-   decoding must be done in software.
+   decoding  must  be done in software, or if you have one, on an
+   MPEG2 hardware decoding card or chipset.
      _________________________________________________________
 
 Getting the card going
@@ -120,8 +102,9 @@ Getting the card going
    been  necessary to download these drivers from the linuxtv CVS
    server and compile them successfully.
 
-   The  Device  Driver  API  for  DVB  under  Linux  exposes  the
-   following device files in the /dev tree:
+   Depending on the card's feature set, the Device Driver API for
+   DVB under Linux will expose some of the following device files
+   in the /dev tree:
 
      * /dev/dvb/adapter0/audio0
      * /dev/dvb/adapter0/ca0
@@ -165,6 +148,28 @@ Getting the card going
    activate the appropriate DVB device nodes. It is then possible
    to start accessing the card with utilities such as scan, tzap,
    dvbstream etc.
+
+   The  current version of the frontend module sp887x.o, contains
+   no firmware drivers?, so the first time you open it with a DVB
+   utility  the driver will try to download some initial firmware
+   to  the card. You will need to download this firmware from the
+   web,  or  copy  it from an installation of the Windows drivers
+   that probably came with your card, before you can use it.
+
+   The  default  Linux  filesystem  location for this firmware is
+   /usr/lib/hotplug/firmware/sc_main.mc .
+     _________________________________________________________
+
+Getting the Firmware
+
+   As the firmware for the card is no longer contained within the
+   driver,  it  is  necessary  to  extract  it  from  the windows
+   drivers.
+
+   The  Windows  drivers  for the Avermedia DVB-T can be obtained
+   from: http://babyurl.com/H3U970 and you can get an application
+   to extract the firmware from:
+   http://www.kyz.uklinux.net/cabextract.php.
      _________________________________________________________
 
 Receiving DVB-T in Australia
@@ -189,136 +194,29 @@ Receiving DVB-T in Australia
    SEVEN       VHF 6   177.5 MHz
    SBS         UHF 29  536.5 MHz
 
-   Documentation  for DVB/apps/scan indicates that it is necesary
-   to  alter  the  initial.h  file  for the local transponders. I
-   didn't spend too much time trying to work out how scan worked,
-   so  I  recompiled  a  new version of scan for each transponder
-   listed  above  and piped the output to a 'channels.conf' file.
-   It  was necessary to alter the initial.h file in the following
-   way:
-static
-struct transponder ofdm_probes [] = {
-    /**
-     * Australia ABC
-     */
-        {
-          .type = FE_OFDM,
-          .param = {
-             .frequency = 226500000,
-             .inversion = INVERSION_OFF,
-                { ofdm:
-                  {
-                     .bandwidth = BANDWIDTH_7_MHZ,
-                     .code_rate_HP = FEC_2_3,
-                     .code_rate_LP = FEC_NONE,
-                     .constellation = QAM_64,
-                     .transmission_mode = TRANSMISSION_MODE_8K,
-                     .guard_interval = GUARD_INTERVAL_1_8,
-                     .hierarchy_information = HIERARCHY_NONE
-                  }
-                }
-           }
-        },
-    /**
-     * Australia TEN
-     */
-        {
-          .type = FE_OFDM,
-          .param = {
-              .frequency = 219500000,
-              .inversion = INVERSION_OFF,
-                 { ofdm:
-                   {
-                      .bandwidth = BANDWIDTH_7_MHZ,
-                      .code_rate_HP = FEC_2_3,
-                      .code_rate_LP = FEC_NONE,
-                      .constellation = QAM_64,
-                      .transmission_mode = TRANSMISSION_MODE_8K,
-                      .guard_interval = GUARD_INTERVAL_1_8,
-                      .hierarchy_information = HIERARCHY_NONE
-                   }
-                 }
-           }
-        },
-    /**
-     * Australia NINE
-     */
-        {
-          .type = FE_OFDM,
-          .param = {
-              .frequency = 191625000,
-              .inversion = INVERSION_OFF,
-                 { ofdm:
-                   {
-                      .bandwidth = BANDWIDTH_7_MHZ,
-                      .code_rate_HP = FEC_2_3,
-                      .code_rate_LP = FEC_NONE,
-                      .constellation = QAM_64,
-                      .transmission_mode = TRANSMISSION_MODE_8K,
-                      .guard_interval = GUARD_INTERVAL_1_8,
-                      .hierarchy_information = HIERARCHY_NONE
-                   }
-                 }
-           }
-        },
-    /**
-     * Australia SEVEN
-     */
-        {
-          .type = FE_OFDM,
-          .param = {
-              .frequency = 177500000,
-              .inversion = INVERSION_OFF,
-                 { ofdm:
-                   {
-                      .bandwidth = BANDWIDTH_7_MHZ,
-                      .code_rate_HP = FEC_2_3,
-                      .code_rate_LP = FEC_NONE,
-                      .constellation = QAM_64,
-                      .transmission_mode = TRANSMISSION_MODE_8K,
-                      .guard_interval = GUARD_INTERVAL_1_8,
-                      .hierarchy_information = HIERARCHY_NONE
-                   }
-                 }
-           }
-        },
-    /**
-     * Australia SBS
-     */
-        {
-          .type = FE_OFDM,
-          .param = {
-              .frequency = 536500000,
-              .inversion = INVERSION_OFF,
-                 { ofdm:
-                   {
-                      .bandwidth = BANDWIDTH_7_MHZ,
-                      .code_rate_HP = FEC_2_3,
-                      .code_rate_LP = FEC_NONE,
-                      .constellation = QAM_64,
-                      .transmission_mode = TRANSMISSION_MODE_8K,
-                      .guard_interval = GUARD_INTERVAL_1_8,
-                      .hierarchy_information = HIERARCHY_NONE
-                   }
-                 }
-           }
-        },
-};
-
-
-#endif
+   The Scan utility has a set of compiled-in defaults for various
+   countries and regions, but if they do not suit, or if you have
+   a pre-compiled scan binary, you can specify a data file on the
+   command  line which contains the transponder frequencies. Here
+   is a sample file for the above channel transponders:
+# Data file for DVB scan program
+#
+# C Frequency SymbolRate FEC QAM
+# S Frequency Polarisation SymbolRate FEC
+# T Frequency Bandwidth FEC FEC2 QAM Mode Guard Hier
+T 226500000 7MHz 2/3 NONE QAM64 8k 1/8 NONE
+T 191625000 7MHz 2/3 NONE QAM64 8k 1/8 NONE
+T 219500000 7MHz 2/3 NONE QAM64 8k 1/8 NONE
+T 177500000 7MHz 2/3 NONE QAM64 8k 1/8 NONE
+T 536500000 7MHz 2/3 NONE QAM64 8k 1/8 NONE
 
    The   defaults   for   the  transponder  frequency  and  other
    modulation parameters were obtained from www.dba.org.au.
 
    When  Scan  runs, it will output channels.conf information for
-   the  first  successful  transponder.  In Australia, where each
-   hannel  has  it's  own  transponder,  it's  necessary  to then
-   comment   out  the  last  transponder  that  was  scanned  and
-   recompile  scan.  This  is a dreadful kludge I know, but all I
-   want with scan is to be able to create a working channels.conf
-   file.  Now  I  have a working channels.conf file, I don't need
-   scan any more.
+   any  channel's transponders which the card's frontend can lock
+   onto.  (i.e.  any  whose  signal  is  strong  enough  at  your
+   antenna).
 
    Here's my channels.conf file for anyone who's interested:
 ABC HDTV:226500000:INVERSION_OFF:BANDWIDTH_7_MHZ:FEC_3_4:FEC_3_4:QAM_64
@@ -397,39 +295,6 @@ SBS RADIO 2:536500000:INVERSION_OFF:BANDWIDTH_7_MHZ:FEC_2_3:FEC_2_3:QAM
 _64:TRANSMISSION_MODE_8K:GUARD_INTERVAL_1_8:HIERARCHY_NONE:0:202:799
      _________________________________________________________
 
-Patching dvb-bt8xx
-
-   The  following  patch  to  dvb-bt8xx is required to be applied
-   against the code prior to file date 5th September 2003. It may
-   have  been  applied  to  CVS  by  the  time  this  HOWTO  gets
-   published.
-Index: dvb-bt8xx.c
-===================================================================
-RCS file: /cvs/linuxtv/dvb-kernel/linux/drivers/media/dvb/bt8xx/dvb-bt8
-xx.c,v
-retrieving revision 1.10
-diff -u -r1.10 dvb-bt8xx.c
---- dvb-bt8xx.c 15 Jul 2003 09:30:02 -0000      1.10
-+++ dvb-bt8xx.c 6 Sep 2003 02:06:20 -0000
-@@ -302,6 +302,14 @@
-                        case 0x01010071:
-                                dvb_bt8xx_load(card_nr, "Nebula DigiTV
-DVB-T", (1 << 26) | (1 << 14) | (1 << 5));
-                                break;
-+                       case 0x07611461:
-+                               dvb_bt8xx_load(card_nr, "Avermedia DVB-
-T", (1 << 26) | (1 << 14) | (1 << 5));
-+                               break;
-+            default:
-+                dprintk("dvb_bt8xx: card_nr found %0X \n",card_nr);
-+                dprintk("dvb_bt8xx: card_id found %0X \n",card_id);
-+                dprintk("dvb_bt8xx: card_type found %0X \n",card_type)
-;
-+                break;;
-                }
-        }
-     _________________________________________________________
-
 Known Limitations
 
    At  present  I can say with confidence that the frontend tunes
@@ -442,8 +307,18 @@ Known Limitations
    error message inconsistency. Although this generates errors in
    dmesg  and  the  system logs, it does not appear to affect the
    ability of the frontend to function correctly.
+     _________________________________________________________
+
+Further Update
+
+   dvbstream  and  VideoLAN  Client on windows works a treat with
+   DVB,  in  fact  this  is  currently  serving as my main way of
+   viewing  DVB-T  at  the  moment.  Additionally, VLC is happily
+   decoding  HDTV  signals,  although  the PC is dropping the odd
+   frame here and there - I assume due to processing capability -
+   as all the decoding is being done under windows in software.
+
+   Many  thanks to Nigel Pearson for the updates to this document
+   since the recent revision of the driver.
 
-   So  far,  I  have  only  been  able  to decode SDTV MPEG2 data
-   streams  from  ABC,  Channel  7,  Channel  9 and SBS. For some
-   reason,  the HDTV and all Channel 10 streams cause xine to die
-   on me. I am pursuing this particular limitation at the moment.
+   January 29th 2004