1.\" $NetBSD: dtviic.4,v 1.5 2011/08/31 07:04:49 jruoho Exp $ 2.\" 3.\" Copyright (c) 2011 The NetBSD Foundation, Inc. 4.\" All rights reserved. 5.\" 6.\" This code is derived from software contributed to The NetBSD Foundation 7.\" by Thomas Klausner. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice, this list of conditions and the following disclaimer. 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.Dd August 30, 2011 31.Dt DTVIIC 4 32.Os 33.Sh NAME 34.Nm dtviic , 35.Nm au8522 , 36.Nm cx24227 , 37.Nm lg3303 , 38.Nm mt2131 , 39.Nm nxt2k , 40.Nm zl10353 , 41.Nm tvpll , 42.Nm xc3028 , 43.Nm xc5k 44.Nd Inter IC (I2C) modules for DTV 45.Sh DESCRIPTION 46The 47.Nm 48modules provide support for 49.Xr dtv 4 50devices. 51The 52.Nm 53module group includes tuners, demodulators, and analog video decoders. 54.Pp 55The usual hardware structure consists of a host controller 56(connected for instance via 57.Xr usb 4 58or 59.Xr pci 4 ) 60that provides the data moving facilities (for the analog or 61digital video streams) and an 62.Xr iic 4 63bus over which the other chips can be configured. 64.Pp 65For example, a typical 66.Xr dtv 4 67setup would look like this: 68.Bl -enum -offset indent 69.It 70Initialize transport stream 71.Pq Dv TS 72port on the host controller. 73.It 74Configure the demodulator that 75.Dq demodulates 76the information from an intermediate frequency 77.Pq Dv IF 78that is provided to it by the associated tuner. 79This step typically includes setting the desired 80quadrature amplitude modulation 81.Pq Dv QAM 82and bandwidth, among other things. 83.It 84Configure the tuner. 85Typically this step includes at least setting the frequency. 86.It 87Start TS transfer (using 88.Dv DMA 89transfers or 90.Dv USB 91high speed transfers). 92.El 93.Pp 94The supported demodulators include: 95.Bl -tag -width 10n -offset indent 96.It Nm au8522 97Auvitek AU8522 ATSC/QAM64/QAM256 demodulator 98.It Nm cx24227 99Conexant CX24227 ATSC/QAM64/QAM256 demodulator 100.It Nm lg3303 101LG LGDT3303 ATSC/QAM64/QAM256 demodulator 102.It Nm mt2131 103MicroTune MT2131 ATSC demodulator 104.It Nm nxt2k 105NxtWave Communications NXT2004 ATSC demodulator 106.It Nm zl10353 107Zarlink ZL10353 (Intel CE623x) COFDM/DVB-T demodulator 108.El 109.Pp 110The supported tuners are: 111.Bl -tag -width 10n -offset indent 112.It Ic tvpll 113Generic PLL-based tuners 114.It Nm xc3028 115XCeive XC3028 analog and digital tuner 116.It Nm xc5k 117Xceive XC5000 analog and digital tuner 118.El 119.Sh FILES 120.Bl -bullet -offset indent 121.It 122.Pa dvb-fe-nxt2004.fw 123needed by 124.Nm nxt2k 125.It 126.Pa xc3028-v27.fw 127or 128.Pa xc3028L-v36.fw 129(provided by 130.Pa pkgsrc/sysutils/xc3028l-firmware ) 131needed by 132.Nm xc3028 133.It 134.Pa dvb-fe-xc5000-1.6.114.fw 135needed by 136.Nm xc5k , 137provided by the 138.Pa pkgsrc/sysutils/xc5k-firmware 139.El 140.Sh SEE ALSO 141.Xr dtv 4 , 142.Xr iic 4 , 143.Xr module 7 144.Sh HISTORY 145The 146.Nm 147modules first appeared in 148.Nx 6.0 . 149.Sh AUTHORS 150.An -nosplit 151Authors include 152.An Jared D. McNeill 153.Aq jmcneill@NetBSD.org , 154.An Jonathan A. Kollasch 155.Aq jakllsch@NetBSD.org , 156and 157.An Jukka Ruohonen 158.Aq jruohonen@iki.fi . 159