V4L/DVB: Add driver for Telegent tlg2300

pd-common.h contains the common data structures, while
vendorcmds.h contains the vendor commands for firmware.

[mchehab@redhat.com: Folded the 10 patches with the driver]
Signed-off-by: Huang Shijie <shijie8@gmail.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

1 files changed, 231 insertions, 0 deletions

diff --git a/Documentation/video4linux/README.tlg2300 b/Documentation/video4linux/README.tlg2300
new file mode 100644
index 00000000000..82417db3256
--- /dev/null
+++ b/Documentation/video4linux/README.tlg2300
@@ -0,0 +1,231 @@
+tlg2300 release notes
+====================
+
+This is a v4l2/dvb device driver for the tlg2300 chip.
+
+
+current status
+==============
+
+video
+        - support mmap and read().(no overlay)
+
+audio
+        - The driver will register a ALSA card for the audio input.
+
+vbi
+        - Works for almost TV norms.
+
+dvb-t
+        - works for DVB-T
+
+FM
+        - Works for radio.
+
+---------------------------------------------------------------------------
+TESTED APPLICATIONS:
+
+-VLC1.0.4 test the video and dvb. The GUI is friendly to use.
+
+-Mplayer test the video.
+
+-Mplayer test the FM. The mplayer should be compiled with --enable-radio and
+         --enable-radio-capture.
+        The command runs as this(The alsa audio registers to card 1):
+        #mplayer radio://103.7/capture/ -radio adevice=hw=1,0:arate=48000 \
+                -rawaudio rate=48000:channels=2
+
+---------------------------------------------------------------------------
+KNOWN PROBLEMS:
+
+country code
+        - The firmware of the chip needs the country code to determine
+        the stardards of video and audio when it runs for analog TV or radio.
+        The DVB-T does not need the country code.
+
+        So you must set the country-code correctly. The V4L2 does not have
+        the interface,the driver has to provide a parameter `country_code'.
+
+        You could set the coutry code in two ways, take USA as example
+        (The USA's country code is 1):
+
+        [1] add the following line in /etc/modprobe.conf before you insert the
+            card into USB hub's port :
+                poseidon country_code=1
+
+        [2] You can also modify the parameter at runtime (before you run the
+            application such as VLC)
+                #echo 1 > /sys/module/poseidon/parameter/country_code
+
+        The known country codes show below:
+        country code :  country
+        93              "Afghanistan"
+        355             "Albania"
+        213             "Algeria"
+        684             "American Samoa"
+        376             "Andorra"
+        244             "Angola"
+        54              "Argentina"
+        374             "Armenia"
+        61              "Australia"
+        43              "Austria"
+        994             "Azerbaijan"
+        973             "Bahrain"
+        880             "Bangladesh"
+        375             "Belarus"
+        32              "Belgium"
+        501             "Belize"
+        229             "Benin"
+        591             "Bolivia"
+        387             "Bosnia and Herzegovina"
+        267             "Botswana"
+        55              "Brazil"
+        673             "Brunei Darussalam"
+        359             "Bulgalia"
+        226             "Burkina Faso"
+        257             "Burundi"
+        237             "Cameroon"
+        1               "Canada"
+        236             "Central African Republic"
+        235             "Chad"
+        56              "Chile"
+        86              "China"
+        57              "Colombia"
+        242             "Congo"
+        243             "Congo, Dem. Rep. of "
+        506             "Costa Rica"
+        385             "Croatia"
+        53              "Cuba or Guantanamo Bay"
+        357             "Cyprus"
+        420             "Czech Republic"
+        45              "Denmark"
+        246             "Diego Garcia"
+        253             "Djibouti"
+        593             "Ecuador"
+        20              "Egypt"
+        503             "El Salvador"
+        240             "Equatorial Guinea"
+        372             "Estonia"
+        251             "Ethiopia"
+        358             "Finland"
+        33              "France"
+        594             "French Guiana"
+        689             "French Polynesia"
+        241             "Gabonese Republic"
+        220             "Gambia"
+        995             "Georgia"
+        49              "Germany"
+        233             "Ghana"
+        350             "Gibraltar"
+        30              "Greece"
+        299             "Greenland"
+        671             "Guam"
+        502             "Guatemala"
+        592             "Guyana"
+        509             "Haiti"
+        504             "Honduras"
+        852             "Hong Kong SAR, China"
+        36              "Hungary"
+        354             "Iceland"
+        91              "India"
+        98              "Iran"
+        964             "Iraq"
+        353             "Ireland"
+        972             "Israel"
+        39              "Italy or Vatican City"
+        225             "Ivory Coast"
+        81              "Japan"
+        962             "Jordan"
+        7               "Kazakhstan or Kyrgyzstan"
+        254             "Kenya"
+        686             "Kiribati"
+        965             "Kuwait"
+        856             "Laos"
+        371             "Latvia"
+        961             "Lebanon"
+        266             "Lesotho"
+        231             "Liberia"
+        218             "Libya"
+        41              "Liechtenstein or Switzerland"
+        370             "Lithuania"
+        352             "Luxembourg"
+        853             "Macau SAR, China"
+        261             "Madagascar"
+        60              "Malaysia"
+        960             "Maldives"
+        223             "Mali Republic"
+        356             "Malta"
+        692             "Marshall Islands"
+        596             "Martinique"
+        222             "Mauritania"
+        230             "Mauritus"
+        52              "Mexico"
+        691             "Micronesia"
+        373             "Moldova"
+        377             "Monaco"
+        976             "Mongolia"
+        212             "Morocco"
+        258             "Mozambique"
+        95              "Myanmar"
+        264             "Namibia"
+        674             "Nauru"
+        31              "Netherlands"
+        687             "New Caledonia"
+        64              "New Zealand"
+        505             "Nicaragua"
+        227             "Niger"
+        234             "Nigeria"
+        850             "North Korea"
+        47              "Norway"
+        968             "Oman"
+        92              "Pakistan"
+        680             "Palau"
+        507             "Panama"
+        675             "Papua New Guinea"
+        595             "Paraguay"
+        51              "Peru"
+        63              "Philippines"
+        48              "Poland"
+        351             "Portugal"
+        974             "Qatar"
+        262             "Reunion Island"
+        40              "Romania"
+        7               "Russia"
+        378             "San Marino"
+        239             "Sao Tome and Principe"
+        966             "Saudi Arabia"
+        221             "Senegal"
+        248             "Seychelles Republic"
+        232             "Sierra Leone"
+        65              "Singapore"
+        421             "Slovak Republic"
+        386             "Slovenia"
+        27              "South Africa"
+        82              "South Korea "
+        34              "Spain"
+        94              "Sri Lanka"
+        508             "St. Pierre and Miquelon"
+        249             "Sudan"
+        597             "Suriname"
+        268             "Swaziland"
+        46              "Sweden"
+        963             "Syria"
+        886             "Taiwan Region"
+        255             "Tanzania"
+        66              "Thailand"
+        228             "Togolese Republic"
+        216             "Tunisia"
+        90              "Turkey"
+        993             "Turkmenistan"
+        256             "Uganda"
+        380             "Ukraine"
+        971             "United Arab Emirates"
+        44              "United Kingdom"
+        1               "United States of America"
+        598             "Uruguay"
+        58              "Venezuela"
+        84              "Vietnam"
+        967             "Yemen"
+        260             "Zambia"
+        255             "Zanzibar"
+        263             "Zimbabwe"