new file mode 100644
@@ -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"