04074f1fdf
changeset 2ccf12a did a crappy job when added multi-line comment lines,
violating CodingStyle.
Change the comments added there to fulfill CodingStyle, and document
the platform_data using Documentation/kernel-doc-nano-HOWTO.txt.
Cc: Jon Arne Jørgensen <jonarne@jonarne.no>
Cc: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>
141 lines
4.7 KiB
C
141 lines
4.7 KiB
C
/*
|
|
saa7115.h - definition for saa7111/3/4/5 inputs and frequency flags
|
|
|
|
Copyright (C) 2006 Hans Verkuil (hverkuil@xs4all.nl)
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*/
|
|
|
|
#ifndef _SAA7115_H_
|
|
#define _SAA7115_H_
|
|
|
|
/* s_routing inputs, outputs, and config */
|
|
|
|
/* SAA7111/3/4/5 HW inputs */
|
|
#define SAA7115_COMPOSITE0 0
|
|
#define SAA7115_COMPOSITE1 1
|
|
#define SAA7115_COMPOSITE2 2
|
|
#define SAA7115_COMPOSITE3 3
|
|
#define SAA7115_COMPOSITE4 4 /* not available for the saa7111/3 */
|
|
#define SAA7115_COMPOSITE5 5 /* not available for the saa7111/3 */
|
|
#define SAA7115_SVIDEO0 6
|
|
#define SAA7115_SVIDEO1 7
|
|
#define SAA7115_SVIDEO2 8
|
|
#define SAA7115_SVIDEO3 9
|
|
|
|
/* outputs */
|
|
#define SAA7115_IPORT_ON 1
|
|
#define SAA7115_IPORT_OFF 0
|
|
|
|
/* SAA7111 specific outputs. */
|
|
#define SAA7111_VBI_BYPASS 2
|
|
#define SAA7111_FMT_YUV422 0x00
|
|
#define SAA7111_FMT_RGB 0x40
|
|
#define SAA7111_FMT_CCIR 0x80
|
|
#define SAA7111_FMT_YUV411 0xc0
|
|
|
|
/* config flags */
|
|
/*
|
|
* Register 0x85 should set bit 0 to 0 (it's 1 by default). This bit
|
|
* controls the IDQ signal polarity which is set to 'inverted' if the bit
|
|
* it 1 and to 'default' if it is 0.
|
|
*/
|
|
#define SAA7115_IDQ_IS_DEFAULT (1 << 0)
|
|
|
|
/* s_crystal_freq values and flags */
|
|
|
|
/* SAA7115 v4l2_crystal_freq frequency values */
|
|
#define SAA7115_FREQ_32_11_MHZ 32110000 /* 32.11 MHz crystal, SAA7114/5 only */
|
|
#define SAA7115_FREQ_24_576_MHZ 24576000 /* 24.576 MHz crystal */
|
|
|
|
/* SAA7115 v4l2_crystal_freq audio clock control flags */
|
|
#define SAA7115_FREQ_FL_UCGC (1 << 0) /* SA 3A[7], UCGC, SAA7115 only */
|
|
#define SAA7115_FREQ_FL_CGCDIV (1 << 1) /* SA 3A[6], CGCDIV, SAA7115 only */
|
|
#define SAA7115_FREQ_FL_APLL (1 << 2) /* SA 3A[3], APLL, SAA7114/5 only */
|
|
#define SAA7115_FREQ_FL_DOUBLE_ASCLK (1 << 3) /* SA 39, LRDIV, SAA7114/5 only */
|
|
|
|
/* ===== SAA7113 Config enums ===== */
|
|
|
|
/* Register 0x08 "Horizontal time constant" [Bit 3..4]:
|
|
* Should be set to "Fast Locking Mode" according to the datasheet,
|
|
* and that is the default setting in the gm7113c_init table.
|
|
* saa7113_init sets this value to "VTR Mode". */
|
|
enum saa7113_r08_htc {
|
|
SAA7113_HTC_TV_MODE = 0x00,
|
|
SAA7113_HTC_VTR_MODE, /* Default for saa7113_init */
|
|
SAA7113_HTC_FAST_LOCKING_MODE = 0x03 /* Default for gm7113c_init */
|
|
};
|
|
|
|
/* Register 0x10 "Output format selection" [Bit 6..7]:
|
|
* Defaults to ITU_656 as specified in datasheet. */
|
|
enum saa7113_r10_ofts {
|
|
SAA7113_OFTS_ITU_656 = 0x0, /* Default */
|
|
SAA7113_OFTS_VFLAG_BY_VREF,
|
|
SAA7113_OFTS_VFLAG_BY_DATA_TYPE
|
|
};
|
|
|
|
/*
|
|
* Register 0x12 "Output control" [Bit 0..3 Or Bit 4..7]:
|
|
* This is used to select what data is output on the RTS0 and RTS1 pins.
|
|
* RTS1 [Bit 4..7] Defaults to DOT_IN. (This value can not be set for RTS0)
|
|
* RTS0 [Bit 0..3] Defaults to VIPB in gm7113c_init as specified
|
|
* in the datasheet, but is set to HREF_HS in the saa7113_init table.
|
|
*/
|
|
enum saa7113_r12_rts {
|
|
SAA7113_RTS_DOT_IN = 0, /* OBS: Only for RTS1 (Default RTS1) */
|
|
SAA7113_RTS_VIPB, /* Default RTS0 For gm7113c_init */
|
|
SAA7113_RTS_GPSW,
|
|
SAA7115_RTS_HL,
|
|
SAA7113_RTS_VL,
|
|
SAA7113_RTS_DL,
|
|
SAA7113_RTS_PLIN,
|
|
SAA7113_RTS_HREF_HS, /* Default RTS0 For saa7113_init */
|
|
SAA7113_RTS_HS,
|
|
SAA7113_RTS_HQ,
|
|
SAA7113_RTS_ODD,
|
|
SAA7113_RTS_VS,
|
|
SAA7113_RTS_V123,
|
|
SAA7113_RTS_VGATE,
|
|
SAA7113_RTS_VREF,
|
|
SAA7113_RTS_FID
|
|
};
|
|
|
|
/**
|
|
* struct saa7115_platform_data - Allow overriding default initialization
|
|
*
|
|
* @saa7113_force_gm7113c_init: Force the use of the gm7113c_init table
|
|
* instead of saa7113_init table
|
|
* (saa7113 only)
|
|
* @saa7113_r08_htc: [R_08 - Bit 3..4]
|
|
* @saa7113_r10_vrln: [R_10 - Bit 3]
|
|
* default: Disabled for gm7113c_init
|
|
* Enabled for saa7113c_init
|
|
* @saa7113_r10_ofts: [R_10 - Bit 6..7]
|
|
* @saa7113_r12_rts0: [R_12 - Bit 0..3]
|
|
* @saa7113_r12_rts1: [R_12 - Bit 4..7]
|
|
* @saa7113_r13_adlsb: [R_13 - Bit 7] - default: disabled
|
|
*/
|
|
struct saa7115_platform_data {
|
|
bool saa7113_force_gm7113c_init;
|
|
enum saa7113_r08_htc *saa7113_r08_htc;
|
|
bool *saa7113_r10_vrln;
|
|
enum saa7113_r10_ofts *saa7113_r10_ofts;
|
|
enum saa7113_r12_rts *saa7113_r12_rts0;
|
|
enum saa7113_r12_rts *saa7113_r12_rts1;
|
|
bool *saa7113_r13_adlsb;
|
|
};
|
|
|
|
#endif
|
|
|