1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
|
/* $XFree86: xc/programs/Xserver/hw/xfree86/drivers/nsc/gfx/tv_fs450.h,v 1.1 2002/12/10 15:12:27 alanh Exp $ */
/*
* $Workfile: tv_fs450.h $
*
* This file defines the common FS450 API.
*
* NSC_LIC_ALTERNATIVE_PREAMBLE
*
* Revision 1.0
*
* National Semiconductor Alternative GPL-BSD License
*
* National Semiconductor Corporation licenses this software
* ("Software"):
*
* Durango
*
* under one of the two following licenses, depending on how the
* Software is received by the Licensee.
*
* If this Software is received as part of the Linux Framebuffer or
* other GPL licensed software, then the GPL license designated
* NSC_LIC_GPL applies to this Software; in all other circumstances
* then the BSD-style license designated NSC_LIC_BSD shall apply.
*
* END_NSC_LIC_ALTERNATIVE_PREAMBLE */
/* NSC_LIC_BSD
*
* National Semiconductor Corporation Open Source License for Durango
*
* (BSD License with Export Notice)
*
* Copyright (c) 1999-2001
* National Semiconductor Corporation.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided
* with the distribution.
*
* * Neither the name of the National Semiconductor Corporation nor
* the names of its contributors may be used to endorse or promote
* products derived from this software without specific prior
* written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
* NATIONAL SEMICONDUCTOR CORPORATION OR CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
* IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE,
* INTELLECTUAL PROPERTY INFRINGEMENT, OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
* OF SUCH DAMAGE.
*
* EXPORT LAWS: THIS LICENSE ADDS NO RESTRICTIONS TO THE EXPORT LAWS OF
* YOUR JURISDICTION. It is licensee's responsibility to comply with
* any export regulations applicable in licensee's jurisdiction. Under
* CURRENT (2001) U.S. export regulations this software
* is eligible for export from the U.S. and can be downloaded by or
* otherwise exported or reexported worldwide EXCEPT to U.S. embargoed
* destinations which include Cuba, Iraq, Libya, North Korea, Iran,
* Syria, Sudan, Afghanistan and any other country to which the U.S.
* has embargoed goods and services.
*
* END_NSC_LIC_BSD */
/* NSC_LIC_GPL
*
* National Semiconductor Corporation Gnu General Public License for Durango
*
* (GPL License with Export Notice)
*
* Copyright (c) 1999-2001
* National Semiconductor Corporation.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted 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
*
* In addition to the terms of the GNU General Public License, neither
* the name of the National Semiconductor Corporation nor the names of
* its contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
* NATIONAL SEMICONDUCTOR CORPORATION OR CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
* IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE,
* INTELLECTUAL PROPERTY INFRINGEMENT, OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
* OF SUCH DAMAGE. See the GNU General Public License for more details.
*
* EXPORT LAWS: THIS LICENSE ADDS NO RESTRICTIONS TO THE EXPORT LAWS OF
* YOUR JURISDICTION. It is licensee's responsibility to comply with
* any export regulations applicable in licensee's jurisdiction. Under
* CURRENT (2001) U.S. export regulations this software
* is eligible for export from the U.S. and can be downloaded by or
* otherwise exported or reexported worldwide EXCEPT to U.S. embargoed
* destinations which include Cuba, Iraq, Libya, North Korea, Iran,
* Syria, Sudan, Afghanistan and any other country to which the U.S.
* has embargoed goods and services.
*
* You should have received a copy of the GNU General Public License
* along with this file; if not, write to the Free Software Foundation,
* Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* END_NSC_LIC_GPL */
#ifndef __FS450_H__
#define __FS450_H__
#ifdef __cplusplus
extern "C"
{
#endif
/* ==========================================================================*/
/* Init and cleanup functions*/
int FS450_init(void);
void FS450_cleanup(void);
/* call FS450_init at startup to probe for and initialize FS450. */
/* returns 0 if successful. */
/* ==========================================================================*/
/* TV output on or off*/
int FS450_get_tv_enable(unsigned int *p_on);
int FS450_set_tv_enable(unsigned int on);
/* on is 1 for TV on, 0 for off */
/* ==========================================================================*/
/* TV standard*/
int FS450_get_tv_standard(unsigned long *p_standard);
int FS450_get_available_tv_standards(unsigned long *p_standards);
int FS450_set_tv_standard(unsigned long standard);
/* standard is one of the FS450_TV_STANDARD constants */
/* standards is a bitmask of zero or more FS450_TV_STANDARD constants */
/* FS450 TV Standard flags*/
#define FS450_TV_STANDARD_NTSC_M 0x0001
#define FS450_TV_STANDARD_NTSC_M_J 0x0002
#define FS450_TV_STANDARD_PAL_B 0x0004
#define FS450_TV_STANDARD_PAL_D 0x0008
#define FS450_TV_STANDARD_PAL_H 0x0010
#define FS450_TV_STANDARD_PAL_I 0x0020
#define FS450_TV_STANDARD_PAL_M 0x0040
#define FS450_TV_STANDARD_PAL_N 0x0080
#define FS450_TV_STANDARD_PAL_G 0x0100
/* ==========================================================================*/
/* VGA mode assumed by FS450*/
int FS450_get_vga_mode(unsigned long *p_vga_mode);
int FS450_get_available_vga_modes(unsigned long *p_vga_modes);
int FS450_set_vga_mode(unsigned long vga_mode);
/* vga_mode is one of the FS450_VGA_MODE constants */
/* vga_modes is a bitmask of zero or more FS450_VGA_MODE constants */
/* FS450 VGA Mode flags*/
#define FS450_VGA_MODE_UNKNOWN 0
#define FS450_VGA_MODE_640X480 0x0001
#define FS450_VGA_MODE_720X487 0x0002
#define FS450_VGA_MODE_720X576 0x0004
#define FS450_VGA_MODE_800X600 0x0008
#define FS450_VGA_MODE_1024X768 0x0010
/* ==========================================================================*/
/* TVout mode*/
int FS450_get_tvout_mode(unsigned long *p_tvout_mode);
int FS450_set_tvout_mode(unsigned long tvout_mode);
/* tvout_mode is a bitmask of FS450_TVOUT_MODE constants */
/* FS450 TVout mode flags*/
#define FS450_TVOUT_MODE_CVBS 0x0001
#define FS450_TVOUT_MODE_YC 0x0002
#define FS450_TVOUT_MODE_RGB 0x0004
#define FS450_TVOUT_MODE_CVBS_YC (FS450_TVOUT_MODE_CVBS | FS450_TVOUT_MODE_YC)
/* ==========================================================================*/
/* Flicker control*/
int FS450_get_sharpness(int *p_sharpness);
int FS450_set_sharpness(int sharpness);
/* sharpness is a percentage in tenths of a percent, 0 to 1000 */
int FS450_get_flicker_filter(int *p_flicker);
int FS450_set_flicker_filter(int flicker);
/* flicker_filter is a percentage in tenths of a percent, 0 to 1000 */
/* ==========================================================================*/
/* Size and Position*/
int FS450_get_overscan(int *p_x, int *p_y);
int FS450_set_overscan(int x, int y);
int FS450_get_position(int *p_x, int *p_y);
int FS450_set_position(int x, int y);
/* x and y are horizontal and vertical adjustments, -1000 to +1000 */
/* ==========================================================================*/
/* Visual adjustments*/
int FS450_get_color(int *p_color);
int FS450_set_color(int color);
/* color is a percentage, 0 to 100 */
int FS450_get_brightness(int *p_brightness);
int FS450_set_brightness(int brightness);
/* brightness is a percentage, 0 to 100 */
int FS450_get_contrast(int *p_contrast);
int FS450_set_contrast(int constrast);
/* contrast is a percentage, 0 to 100 */
/* ==========================================================================*/
/* Luma and Chroma filter*/
int FS450_get_yc_filter(unsigned int *p_yc_filter);
int FS450_set_yc_filter(unsigned int yc_filter);
/* yc_filter is a bitmask of FS450_LUMA_FILTER and/or FS450_CHROMA_FILTER */
/* FS450 Luma and Chroma Filters*/
#define FS450_LUMA_FILTER 0x0001
#define FS450_CHROMA_FILTER 0x0002
/* ==========================================================================*/
/* Macrovision*/
int FS450_get_aps_trigger_bits(unsigned int *p_trigger_bits);
int FS450_set_aps_trigger_bits(unsigned int trigger_bits);
/* trigger_bits is one of the FS450_APS_TRIGGER constants */
/* APS Trigger Bits*/
#define FS450_APS_TRIGGER_OFF 0
#define FS450_APS_TRIGGER_AGC_ONLY 1
#define FS450_APS_TRIGGER_AGC_2_LINE 2
#define FS450_APS_TRIGGER_AGC_4_LINE 3
/* ==========================================================================*/
/* direct access to Houston and platform registers (debug builds only)*/
/* The two functions FS450_ReadRegister and FS450_WriteRegister allow access*/
/* to device registers. These functions are intended for debugging purposes*/
/* only and should not be included in a shipping product.*/
#ifdef FS450_DIRECTREG
#define SOURCE_HOUSTON 0
#define SOURCE_GCC 1
typedef struct _S_REG_INFO
{
int source;
unsigned int size;
unsigned long offset;
unsigned long value;
}
S_REG_INFO;
int FS450_ReadRegister(S_REG_INFO * p_reg);
int FS450_WriteRegister(S_REG_INFO * p_reg);
#endif
/* ==========================================================================*/
/* Error Codes*/
#define ERR_INVALID_PARAMETER 0x1000
#define ERR_NOT_SUPPORTED 0x1001
#define ERR_CANNOT_CHANGE_WHILE_TV_ON 0x1002
#define ERR_DRIVER_NOT_FOUND 0x1100
#define ERR_DRIVER_ERROR 0x1101
#define ERR_DEVICE_NOT_FOUND 0x1120
#define ERR_I2C_MISSING_DEVICE 0x1200
#define ERR_I2C_WRITE_FAILED 0x1201
#define ERR_I2C_READ_FAILED 0x1202
#ifdef __cplusplus
}
#endif
#endif
|
