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 000000000000..82417db3256f
--- /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"