saa7114.c   [plain text]

/* $XFree86: xc/programs/Xserver/hw/xfree86/drivers/nsc/gfx/saa7114.c,v 1.1 2002/12/10 15:12:27 alanh Exp $ */
/*
 * $Workfile: saa7114.c $
 *
 * This file contains routines to control the Philips SAA7114 video decoder.
 *
 * 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 */

/*---------------------------*/
/*  TABLE OF DEFAULT VALUES  */
/*---------------------------*/

typedef struct tagGFX_SAA7114_INIT
{
   unsigned char index;
   unsigned char value;
}
GFX_SAA7114_INIT;

/* Task A is for VBI raw data and task B is for video */

GFX_SAA7114_INIT gfx_saa7114_init_values[] = {
   {0x01, 0x08}, {0x02, 0xC0}, {0x03, 0x00}, {0x04, 0x90},
   {0x05, 0x90}, {0x06, 0xEB}, {0x07, 0xE0}, {0x08, 0x88},
   {0x09, 0x40}, {0x0A, 0x80}, {0x0B, 0x44}, {0x0C, 0x40},
   {0x0D, 0x00}, {0x0E, 0x89}, {0x0F, 0x2E}, {0x10, 0x0E},
   {0x11, 0x00}, {0x12, 0x05}, {0x13, 0x00}, {0x14, 0x08},
   {0x15, 0x11}, {0x16, 0xFE}, {0x17, 0x00}, {0x18, 0x40},
   {0x19, 0x80}, {0x30, 0xBC}, {0x31, 0xDF}, {0x32, 0x02},
   {0x34, 0xCD}, {0x35, 0xCC}, {0x36, 0x3A}, {0x38, 0x03},
   {0x39, 0x10}, {0x3A, 0x00}, {0x40, 0x00}, {0x41, 0xFF},
   {0x42, 0xFF}, {0x43, 0xFF}, {0x44, 0xFF}, {0x45, 0xFF},
   {0x46, 0xFF}, {0x47, 0xFF}, {0x48, 0xFF}, {0x49, 0xFF},
   {0x4A, 0xFF}, {0x4B, 0xFF}, {0x4C, 0xFF}, {0x4D, 0xFF},
   {0x4E, 0xFF}, {0x4F, 0xFF}, {0x50, 0xFF}, {0x51, 0xFF},
   {0x52, 0xFF}, {0x53, 0xFF}, {0x54, 0xFF}, {0x55, 0xFF},
   {0x56, 0xFF}, {0x57, 0xFF}, {0x58, 0x00}, {0x59, 0x47},
   {0x5A, 0x06}, {0x5B, 0x43}, {0x5D, 0x3E}, {0x5E, 0x00},
   {0x80, 0x30}, {0x83, 0x00}, {0x84, 0x60}, {0x85, 0x00},
   {0x86, 0xE5}, {0x87, 0x01}, {0x88, 0xF8},

   /* VBI task */

   {0x90, 0x01}, {0x91, 0xC8}, {0x92, 0x08}, {0x93, 0x84},
   {0x94, 0x10}, {0x95, 0x00}, {0x96, 0xD0}, {0x97, 0x02},
   {0x98, 0x05}, {0x99, 0x00}, {0x9A, 0x0B}, {0x9B, 0x00},
   {0x9C, 0xA0}, {0x9D, 0x05}, {0x9E, 0x0B}, {0x9F, 0x00},
   {0xA0, 0x01}, {0xA1, 0x00}, {0xA2, 0x00}, {0xA4, 0x80},
   {0xA5, 0x40}, {0xA6, 0x40}, {0xA8, 0x00}, {0xA9, 0x02},
   {0xAA, 0x00}, {0xAC, 0x00}, {0xAD, 0x01}, {0xAE, 0x00},
   {0xB0, 0x00}, {0xB1, 0x04}, {0xB2, 0x00}, {0xB3, 0x04},
   {0xB4, 0x00}, {0xB8, 0x00}, {0xB9, 0x00}, {0xBA, 0x00},
   {0xBB, 0x00}, {0xBC, 0x00}, {0xBD, 0x00}, {0xBE, 0x00},
   {0xBF, 0x00},

   /* Video task */

   {0xC0, 0x80}, {0xC1, 0x08}, {0xC2, 0x00}, {0xC3, 0x80},
   {0xC4, 0x10}, {0xC5, 0x00}, {0xC6, 0xD0}, {0xC7, 0x02},
   {0xC8, 0x11}, {0xC9, 0x00}, {0xCA, 0xF1}, {0xCB, 0x00},
   {0xCC, 0xD0}, {0xCD, 0x02}, {0xCE, 0xF1}, {0xCF, 0x00},
   {0xD0, 0x01}, {0xD1, 0x00}, {0xD2, 0x00}, {0xD4, 0x80},
   {0xD5, 0x40}, {0xD6, 0x40}, {0xD8, 0x00}, {0xD9, 0x04},
   {0xDA, 0x00}, {0xDC, 0x00}, {0xDD, 0x02}, {0xDE, 0x00},
   {0xE0, 0x00}, {0xE1, 0x04}, {0xE2, 0x00}, {0xE3, 0x04},
   {0xE4, 0x00}, {0xE8, 0x00}, {0xE9, 0x00}, {0xEA, 0x00},
   {0xEB, 0x00}, {0xEC, 0x00}, {0xED, 0x00}, {0xEE, 0x00},
   {0xEF, 0x00},
};

#define GFX_NUM_SAA7114_INIT_VALUES sizeof(gfx_saa7114_init_values)/sizeof(GFX_SAA7114_INIT)

/*-----------------------------------------------------*/
/*	  TABLE OF FIR PREFILTER RECOMMENDED VALUES        */
/*-----------------------------------------------------*/

int optimize_for_aliasing = 0;

typedef struct tagGFX_SAA7114_FIR_PREFILTER
{
   unsigned char prescaler;
   unsigned char acl_low;
   unsigned char prefilter_low;
   unsigned char acl_high;
   unsigned char prefilter_high;
}
GFX_SAA7114_FIR_PREFILTER;

GFX_SAA7114_FIR_PREFILTER gfx_saa7114_fir_values[] = {
   {0x01, 0x00, 0x00, 0x00, 0x00}, {0x02, 0x02, 0x5A, 0x01, 0x51},
   {0x03, 0x04, 0xAB, 0x03, 0xA2}, {0x04, 0x07, 0xA3, 0x04, 0xAB},
   {0x05, 0x08, 0xAC, 0x07, 0xA3}, {0x06, 0x08, 0xFC, 0x07, 0xF3},
   {0x07, 0x08, 0xFC, 0x07, 0xF3}, {0x08, 0x0F, 0xF4, 0x08, 0xFC},
   {0x09, 0x0F, 0xF4, 0x08, 0xFC}, {0x0A, 0x10, 0xFD, 0x08, 0xFC},
   {0x0B, 0x10, 0xFD, 0x08, 0xFC}, {0x0C, 0x10, 0xFD, 0x08, 0xFC},
   {0x0D, 0x10, 0xFD, 0x10, 0xFD}, {0x0E, 0x10, 0xFD, 0x10, 0xFD},
   {0x0F, 0x1F, 0xF5, 0x10, 0xFD}, {0x10, 0x20, 0xFE, 0x10, 0xFD},
   {0x11, 0x20, 0xFE, 0x10, 0xFD}, {0x12, 0x20, 0xFE, 0x10, 0xFD},
   {0x13, 0x20, 0xFE, 0x20, 0xFE}, {0x14, 0x20, 0xFE, 0x20, 0xFE},
   {0x15, 0x20, 0xFE, 0x20, 0xFE}, {0x16, 0x20, 0xFE, 0x20, 0xFE},
   {0x17, 0x20, 0xFE, 0x20, 0xFE}, {0x18, 0x20, 0xFE, 0x20, 0xFE},
   {0x19, 0x20, 0xFE, 0x20, 0xFE}, {0x1A, 0x20, 0xFE, 0x20, 0xFE},
   {0x1B, 0x20, 0xFE, 0x20, 0xFE}, {0x1C, 0x20, 0xFE, 0x20, 0xFE},
   {0x1D, 0x20, 0xFE, 0x20, 0xFE}, {0x1E, 0x20, 0xFE, 0x20, 0xFE},
   {0x1F, 0x20, 0xFE, 0x20, 0xFE}, {0x20, 0x3F, 0xFF, 0x20, 0xFE},
   {0x21, 0x3F, 0xFF, 0x20, 0xFE}, {0x22, 0x3F, 0xFF, 0x20, 0xFE},
   {0x23, 0x3F, 0xFF, 0x20, 0xFF}
};

int saa7114_set_decoder_defaults(void);
int saa7114_set_decoder_analog_input(unsigned char input);
int saa7114_set_decoder_brightness(unsigned char brightness);
int saa7114_set_decoder_contrast(unsigned char contrast);
int saa7114_set_decoder_hue(char hue);
int saa7114_set_decoder_saturation(unsigned char saturation);
int saa7114_set_decoder_input_offset(unsigned short x, unsigned short y);
int saa7114_set_decoder_input_size(unsigned short width,
				   unsigned short height);
int saa7114_set_decoder_output_size(unsigned short width,
				    unsigned short height);
int saa7114_set_decoder_scale(unsigned short srcw, unsigned short srch,
			      unsigned short dstw, unsigned short dsth);
int saa7114_set_decoder_vbi_format(int start, int end, int format);
int saa7114_set_decoder_vbi_enable(int enable);
int saa7114_set_decoder_vbi_upscale(void);
int saa7114_set_decoder_TV_standard(TVStandardType TVStandard);
int saa7114_set_decoder_luminance_filter(unsigned char lufi);
int saa7114_decoder_software_reset(void);
int saa7114_decoder_detect_macrovision(void);
int saa7114_decoder_detect_video(void);

/* READ ROUTINES IN GFX_DCDR.C */

unsigned char saa7114_get_decoder_brightness(void);
unsigned char saa7114_get_decoder_contrast(void);
char saa7114_get_decoder_hue(void);
unsigned char saa7114_get_decoder_saturation(void);
unsigned long saa7114_get_decoder_input_offset(void);
unsigned long saa7114_get_decoder_input_size(void);
unsigned long saa7114_get_decoder_output_size(void);
int saa7114_get_decoder_vbi_format(int line);
int saa7114_write_reg(unsigned char reg, unsigned char val);
int saa7114_read_reg(unsigned char reg, unsigned char *val);

int
saa7114_write_reg(unsigned char reg, unsigned char val)
{
   return gfx_i2c_write(2, SAA7114_CHIPADDR, reg, 1, &val);
}

int
saa7114_read_reg(unsigned char reg, unsigned char *val)
{
   return gfx_i2c_read(2, SAA7114_CHIPADDR, reg, 1, val);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_vbi_upscale
 *
 * This routine configures the video decoder task A to upscale raw VBI data
 * horizontally to match a different system clock.
 * The upscale is from 13.5 MHz (SAA7114) to 14.318 MHz (Bt835).
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_vbi_upscale(void)
#else
int
gfx_set_decoder_vbi_upscale(void)
#endif
{
   /* Set horizontal output length to 1528 (720 * 2 * 14.318 / 13.5) */
   saa7114_write_reg(SAA7114_TASK_A_HORZ_OUTPUT_LO, 0xF8);
   saa7114_write_reg(SAA7114_TASK_A_HORZ_OUTPUT_HI, 0x05);

   /* Set horizontal luminance scaling increment to 484 (1024 * 13.5 / 28.636) */
   saa7114_write_reg(SAA7114_TASK_A_HSCALE_LUMA_LO, 0xE4);
   saa7114_write_reg(SAA7114_TASK_A_HSCALE_LUMA_HI, 0x01);

   /* Set horizontal chrominance scaling increment to 242 */
   saa7114_write_reg(SAA7114_TASK_A_HSCALE_CHROMA_LO, 0xF2);
   saa7114_write_reg(SAA7114_TASK_A_HSCALE_CHROMA_HI, 0x00);

   return GFX_STATUS_OK;
}

/*-----------------------------------------------------------------------------
 * gfx_decoder_software_reset
 *
 * This routine performs a software reset of the decoder.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_decoder_software_reset(void)
#else
int
gfx_decoder_software_reset(void)
#endif
{
   saa7114_write_reg(0x88, 0xC0);
   /* I2C-bus latency should be sufficient for resetting the internal state machine. */
   /* gfx_delay_milliseconds(10); */
   saa7114_write_reg(0x88, 0xF0);
   return GFX_STATUS_OK;
}

/*-----------------------------------------------------------------------------
 * gfx_decoder_detect_macrovision
 *
 * This routine detects if macrovision exists in the input of the video decoder.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_decoder_detect_macrovision(void)
#else
int
gfx_decoder_detect_macrovision(void)
#endif
{
   unsigned char macrovision = 0xff;

   saa7114_read_reg(SAA7114_STATUS, &macrovision);
   return ((macrovision & 0x02) >> 1);
}

/*-----------------------------------------------------------------------------
 * gfx_decoder_detect_video
 *
 * This routine detects if video exists in the input of the video decoder.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_decoder_detect_video(void)
#else
int
gfx_decoder_detect_video(void)
#endif
{
   unsigned char video = 0xff;

   saa7114_read_reg(SAA7114_STATUS, &video);
   return !((video & 0x40) >> 6);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_defaults
 *
 * This routine is called to set the initial register values of the 
 * video decoder.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_defaults(void)
#else
int
gfx_set_decoder_defaults(void)
#endif
{
   unsigned int i;

   /* LOOP THROUGH INDEX/DATA PAIRS IN THE TABLE */

   for (i = 0; i < GFX_NUM_SAA7114_INIT_VALUES; i++) {
      saa7114_write_reg(gfx_saa7114_init_values[i].index,
			gfx_saa7114_init_values[i].value);
   }

   gfx_decoder_software_reset();
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_analog_input
 *
 * This routine sets the analog input of the video decoder. 
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_analog_input(unsigned char input)
#else
int
gfx_set_decoder_analog_input(unsigned char input)
#endif
{
   saa7114_write_reg(SAA7114_ANALOG_INPUT_CTRL1, input);
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_brightness
 *
 * This routine sets the brightness of the video decoder. 
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_brightness(unsigned char brightness)
#else
int
gfx_set_decoder_brightness(unsigned char brightness)
#endif
{
   saa7114_write_reg(SAA7114_BRIGHTNESS, brightness);
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_contrast
 *
 * This routine sets the contrast of the video decoder. 
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_contrast(unsigned char contrast)
#else
int
gfx_set_decoder_contrast(unsigned char contrast)
#endif
{
   saa7114_write_reg(SAA7114_CONTRAST, (unsigned char)(contrast >> 1));
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_hue
 *
 * This routine sets the hue control of the video decoder. 
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_hue(char hue)
#else
int
gfx_set_decoder_hue(char hue)
#endif
{
   saa7114_write_reg(SAA7114_HUE, (unsigned char)hue);
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_saturation
 *
 * This routine sets the saturation adjustment of the video decoder. 
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_saturation(unsigned char saturation)
#else
int
gfx_set_decoder_saturation(unsigned char saturation)
#endif
{
   saa7114_write_reg(SAA7114_SATURATION, (unsigned char)(saturation >> 1));
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_input_offset
 *
 * This routine sets the size of the decoder input window.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_input_offset(unsigned short x, unsigned short y)
#else
int
gfx_set_decoder_input_offset(unsigned short x, unsigned short y)
#endif
{
   /* SET THE INPUT WINDOW OFFSET */

   saa7114_write_reg(SAA7114_HORZ_OFFSET_LO, (unsigned char)(x & 0x00FF));
   saa7114_write_reg(SAA7114_HORZ_OFFSET_HI, (unsigned char)(x >> 8));
   saa7114_write_reg(SAA7114_VERT_OFFSET_LO, (unsigned char)(y & 0x00FF));
   saa7114_write_reg(SAA7114_VERT_OFFSET_HI, (unsigned char)(y >> 8));

   gfx_decoder_software_reset();
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_input_size
 *
 * This routine sets the size of the decoder input window.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_input_size(unsigned short width, unsigned short height)
#else
int
gfx_set_decoder_input_size(unsigned short width, unsigned short height)
#endif
{
   /* DIVIDE HEIGHT BY TWO FOR INTERLACING */

   height = (height + 1) >> 1;

   /* SET THE INPUT WINDOW SIZE */

   saa7114_write_reg(SAA7114_HORZ_INPUT_LO, (unsigned char)(width & 0x00FF));
   saa7114_write_reg(SAA7114_HORZ_INPUT_HI, (unsigned char)(width >> 8));
   saa7114_write_reg(SAA7114_VERT_INPUT_LO, (unsigned char)(height & 0x00FF));
   saa7114_write_reg(SAA7114_VERT_INPUT_HI, (unsigned char)(height >> 8));

   gfx_decoder_software_reset();
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_output_size
 *
 * This routine sets the size of the decoder output window.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_output_size(unsigned short width, unsigned short height)
#else
int
gfx_set_decoder_output_size(unsigned short width, unsigned short height)
#endif
{
   /* ROUND WIDTH UP TO EVEN NUMBER TO PREVENT DECODER BECOMING STUCK */

   width = ((width + 1) >> 1) << 1;

   /* DIVIDE HEIGHT BY TWO FOR INTERLACING */

   height = (height + 1) >> 1;

   /* SET THE OUTPUT WINDOW SIZE */

   saa7114_write_reg(SAA7114_HORZ_OUTPUT_LO, (unsigned char)(width & 0x00FF));
   saa7114_write_reg(SAA7114_HORZ_OUTPUT_HI, (unsigned char)(width >> 8));
   saa7114_write_reg(SAA7114_VERT_OUTPUT_LO,
		     (unsigned char)(height & 0x00FF));
   saa7114_write_reg(SAA7114_VERT_OUTPUT_HI, (unsigned char)(height >> 8));

   gfx_decoder_software_reset();
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_scale
 *
 * This routine sets the scaling of the video decoder.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_scale(unsigned short srcw, unsigned short srch,
			  unsigned short dstw, unsigned short dsth)
#else
int
gfx_set_decoder_scale(unsigned short srcw, unsigned short srch,
		      unsigned short dstw, unsigned short dsth)
#endif
{
   unsigned char prescale = 0;
   int scale = 0;

   /* SET THE HORIZONTAL PRESCALE */
   /* Downscale from 1 to 1/63 source size. */

   if (dstw)
      prescale = (unsigned char)(srcw / dstw);
   if (!prescale)
      prescale = 1;
   if (prescale > 63)
      return (1);
   saa7114_write_reg(SAA7114_HORZ_PRESCALER, prescale);

   /* USE FIR PREFILTER FUNCTIONALITY (OPTIMISATION) */

   if (prescale < 36) {
      if (optimize_for_aliasing) {
	 saa7114_write_reg(SAA7114_HORZ_ACL,
			   gfx_saa7114_fir_values[prescale - 1].acl_low);
	 saa7114_write_reg(SAA7114_HORZ_FIR_PREFILTER,
			   gfx_saa7114_fir_values[prescale -
						  1].prefilter_low);
      } else {
	 saa7114_write_reg(SAA7114_HORZ_ACL,
			   gfx_saa7114_fir_values[prescale - 1].acl_high);
	 saa7114_write_reg(SAA7114_HORZ_FIR_PREFILTER,
			   gfx_saa7114_fir_values[prescale -
						  1].prefilter_high);
      }
   } else {
      /* SAME SETTINGS FOR RATIO 1/35 DOWNTO 1/63 */
      if (optimize_for_aliasing) {
	 saa7114_write_reg(SAA7114_HORZ_ACL,
			   gfx_saa7114_fir_values[34].acl_low);
	 saa7114_write_reg(SAA7114_HORZ_FIR_PREFILTER,
			   gfx_saa7114_fir_values[34].prefilter_low);
      } else {
	 saa7114_write_reg(SAA7114_HORZ_ACL,
			   gfx_saa7114_fir_values[34].acl_high);
	 saa7114_write_reg(SAA7114_HORZ_FIR_PREFILTER,
			   gfx_saa7114_fir_values[34].prefilter_high);
      }
   }

   /* SET THE HORIZONTAL SCALING */

   if (!dstw)
      return (1);
   scale = ((1024 * srcw * 1000) / (dstw * prescale)) / 1000;
   if ((scale > 8191) || (scale < 300))
      return (1);
   saa7114_write_reg(SAA7114_HSCALE_LUMA_LO, (unsigned char)(scale & 0x00FF));
   saa7114_write_reg(SAA7114_HSCALE_LUMA_HI, (unsigned char)(scale >> 8));
   scale >>= 1;
   saa7114_write_reg(SAA7114_HSCALE_CHROMA_LO,
		     (unsigned char)(scale & 0x00FF));
   saa7114_write_reg(SAA7114_HSCALE_CHROMA_HI, (unsigned char)(scale >> 8));

   /* SET THE VERTICAL SCALING (INTERPOLATION MODE) */

   if (!dsth)
      return (1);

   /* ROUND DESTINATION HEIGHT UP TO EVEN NUMBER TO PREVENT DECODER BECOMING STUCK */

   dsth = ((dsth + 1) >> 1) << 1;

   scale = (int)((1024 * srch) / dsth);
   saa7114_write_reg(SAA7114_VSCALE_LUMA_LO, (unsigned char)(scale & 0x00FF));
   saa7114_write_reg(SAA7114_VSCALE_LUMA_HI, (unsigned char)(scale >> 8));
   saa7114_write_reg(SAA7114_VSCALE_CHROMA_LO,
		     (unsigned char)(scale & 0x00FF));
   saa7114_write_reg(SAA7114_VSCALE_CHROMA_HI, (unsigned char)(scale >> 8));

   if (dsth >= (srch >> 1)) {
      /* USE INTERPOLATION MODE FOR SCALE FACTOR ABOVE 0.5 */

      saa7114_write_reg(SAA7114_VSCALE_CONTROL, 0x00);

      /* SET VERTICAL PHASE REGISTER FOR CORRECT SCALED INTERLACED OUTPUT (OPTIMISATION) */
      /* THE OPTIMISATION IS BASED ON OFIDC = 0 (REG 90h[6] = 0 ) */
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS0, SAA7114_VSCALE_PHO);
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS1, SAA7114_VSCALE_PHO);
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS2,
			(unsigned char)(SAA7114_VSCALE_PHO + scale / 64 -
					16));
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS3,
			(unsigned char)(SAA7114_VSCALE_PHO + scale / 64 -
					16));

      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS0, SAA7114_VSCALE_PHO);
      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS1, SAA7114_VSCALE_PHO);
      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS2,
			(unsigned char)(SAA7114_VSCALE_PHO + scale / 64 -
					16));
      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS3,
			(unsigned char)(SAA7114_VSCALE_PHO + scale / 64 -
					16));

      /* RESTORE CONTRAST AND SATURATION FOR INTERPOLATION MODE */

      saa7114_write_reg(SAA7114_FILTER_CONTRAST, (unsigned char)0x40);
      saa7114_write_reg(SAA7114_FILTER_SATURATION, (unsigned char)0x40);
   } else {
      /* USE ACCUMULATION MODE FOR DOWNSCALING BY MORE THAN 2x */

      saa7114_write_reg(SAA7114_VSCALE_CONTROL, 0x01);

      /* SET VERTICAL PHASE OFFSETS OFF (OPTIMISATION) */
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS0, 0x00);
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS1, 0x00);
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS2, 0x00);
      saa7114_write_reg(SAA7114_VSCALE_CHROMA_OFFS3, 0x00);

      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS0, 0x00);
      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS1, 0x00);
      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS2, 0x00);
      saa7114_write_reg(SAA7114_VSCALE_LUMINA_OFFS3, 0x00);

      /* ADJUST CONTRAST AND SATURATION FOR ACCUMULATION MODE */

      if (srch)
	 scale = (64 * dsth) / srch;
      saa7114_write_reg(SAA7114_FILTER_CONTRAST, (unsigned char)scale);
      saa7114_write_reg(SAA7114_FILTER_SATURATION, (unsigned char)scale);
   }

   gfx_decoder_software_reset();
   return (0);
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_vbi_format
 *
 * This routine programs the decoder to produce the specified format of VBI
 * data for the specified lines.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_vbi_format(int start, int end, int format)
#else
int
gfx_set_decoder_vbi_format(int start, int end, int format)
#endif
{
   int i;
   unsigned char data;

   for (i = start; i <= end; i++) {
      switch (format) {
      case VBI_FORMAT_VIDEO:
	 data = 0xFF;
	 break;				/* Active video */
      case VBI_FORMAT_RAW:
	 data = 0x77;
	 break;				/* Raw VBI data */
      case VBI_FORMAT_CC:
	 data = 0x55;
	 break;				/* US CC        */
      case VBI_FORMAT_NABTS:
	 data = 0xCC;
	 break;				/* US NABTS     */
      default:
	 return GFX_STATUS_BAD_PARAMETER;
      }
      saa7114_write_reg((unsigned char)(0x3F + i), data);
   }
   return GFX_STATUS_OK;
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_vbi_enable
 *
 * This routine enables or disables VBI transfer in the decoder.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_vbi_enable(int enable)
#else
int
gfx_set_decoder_vbi_enable(int enable)
#endif
{
   unsigned char data;

   saa7114_read_reg(SAA7114_IPORT_CONTROL, &data);
   if (enable)
      data |= 0x80;
   else
      data &= ~0x80;
   saa7114_write_reg(SAA7114_IPORT_CONTROL, data);
   return GFX_STATUS_OK;
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_TV_standard
 *
 * This routine configures the decoder for the required TV standard.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_TV_standard(TVStandardType TVStandard)
#else
int
gfx_set_decoder_TV_standard(TVStandardType TVStandard)
#endif
{
   switch (TVStandard) {
   case TV_STANDARD_NTSC:
      saa7114_write_reg(0x0E, 0x89);
      saa7114_write_reg(0x5A, 0x06);
      break;
   case TV_STANDARD_PAL:
      saa7114_write_reg(0x0E, 0x81);
      saa7114_write_reg(0x5A, 0x03);
      break;
   default:
      return GFX_STATUS_BAD_PARAMETER;
   }
   gfx_decoder_software_reset();
   return GFX_STATUS_OK;
}

/*-----------------------------------------------------------------------------
 * gfx_set_decoder_luminance_filter
 *
 * This routine sets the hue control of the video decoder. 
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_set_decoder_luminance_filter(unsigned char lufi)
#else
int
gfx_set_decoder_luminance_filter(unsigned char lufi)
#endif
{
   unsigned char data;

   saa7114_read_reg(SAA7114_LUMINANCE_CONTROL, &data);
   saa7114_write_reg(SAA7114_LUMINANCE_CONTROL,
		     (unsigned char)((data & ~0x0F) | (lufi & 0x0F)));
   return (0);
}

/*************************************************************/
/*  READ ROUTINES  |  INCLUDED FOR DIAGNOSTIC PURPOSES ONLY  */
/*************************************************************/

#if GFX_READ_ROUTINES

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_brightness
 *
 * This routine returns the current brightness of the video decoder.  
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
unsigned char
saa7114_get_decoder_brightness(void)
#else
unsigned char
gfx_get_decoder_brightness(void)
#endif
{
   unsigned char brightness = 0;

   saa7114_read_reg(SAA7114_BRIGHTNESS, &brightness);
   return (brightness);
}

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_contrast
 *
 * This routine returns the current contrast of the video decoder.  
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
unsigned char
saa7114_get_decoder_contrast(void)
#else
unsigned char
gfx_get_decoder_contrast(void)
#endif
{
   unsigned char contrast = 0;

   saa7114_read_reg(SAA7114_CONTRAST, &contrast);
   contrast <<= 1;
   return (contrast);
}

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_hue
 *
 * This routine returns the current hue of the video decoder.  
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
char
saa7114_get_decoder_hue(void)
#else
char
gfx_get_decoder_hue(void)
#endif
{
   unsigned char hue = 0;

   saa7114_read_reg(SAA7114_HUE, &hue);
   return ((char)hue);
}

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_saturation
 *
 * This routine returns the current saturation of the video decoder.  
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
unsigned char
saa7114_get_decoder_saturation(void)
#else
unsigned char
gfx_get_decoder_saturation(void)
#endif
{
   unsigned char saturation = 0;

   saa7114_read_reg(SAA7114_SATURATION, &saturation);
   saturation <<= 1;
   return (saturation);
}

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_input_offset
 *
 * This routine returns the offset into the input window.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
unsigned long
saa7114_get_decoder_input_offset(void)
#else
unsigned long
gfx_get_decoder_input_offset(void)
#endif
{
   unsigned long value = 0;
   unsigned char data;

   saa7114_read_reg(SAA7114_HORZ_OFFSET_LO, &data);
   value = (unsigned long)data;
   saa7114_read_reg(SAA7114_HORZ_OFFSET_HI, &data);
   value |= ((unsigned long)data) << 8;
   saa7114_read_reg(SAA7114_VERT_OFFSET_LO, &data);
   value |= ((unsigned long)data) << 16;
   saa7114_read_reg(SAA7114_VERT_OFFSET_HI, &data);
   value |= ((unsigned long)data) << 24;
   return (value);
}

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_input_size
 *
 * This routine returns the current size of the input window
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
unsigned long
saa7114_get_decoder_input_size(void)
#else
unsigned long
gfx_get_decoder_input_size(void)
#endif
{
   unsigned long value = 0;
   unsigned char data;

   saa7114_read_reg(SAA7114_HORZ_INPUT_LO, &data);
   value = (unsigned long)data;
   saa7114_read_reg(SAA7114_HORZ_INPUT_HI, &data);
   value |= ((unsigned long)data) << 8;
   saa7114_read_reg(SAA7114_VERT_INPUT_LO, &data);
   value |= ((unsigned long)data) << 17;
   saa7114_read_reg(SAA7114_VERT_INPUT_HI, &data);
   value |= ((unsigned long)data) << 25;
   return (value);
}

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_output_size
 *
 * This routine returns the current size of the output window.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
unsigned long
saa7114_get_decoder_output_size(void)
#else
unsigned long
gfx_get_decoder_output_size(void)
#endif
{
   unsigned long value = 0;
   unsigned char data;

   saa7114_read_reg(SAA7114_HORZ_OUTPUT_LO, &data);
   value = (unsigned long)data;
   saa7114_read_reg(SAA7114_HORZ_OUTPUT_HI, &data);
   value |= ((unsigned long)data) << 8;
   saa7114_read_reg(SAA7114_VERT_OUTPUT_LO, &data);
   value |= ((unsigned long)data) << 17;
   saa7114_read_reg(SAA7114_VERT_OUTPUT_HI, &data);
   value |= ((unsigned long)data) << 25;
   return (value);
}

/*-----------------------------------------------------------------------------
 * gfx_get_decoder_vbi_format
 *
 * This routine returns the current format of VBI data for the specified line.
 *-----------------------------------------------------------------------------
 */
#if GFX_DECODER_DYNAMIC
int
saa7114_get_decoder_vbi_format(int line)
#else
int
gfx_get_decoder_vbi_format(int line)
#endif
{
   unsigned char format = 0, data;

   saa7114_read_reg((unsigned char)(0x3F + line), &data);
   switch (data) {
   case 0xFF:
      format = VBI_FORMAT_VIDEO;
      break;				/* Active video */
   case 0x77:
      format = VBI_FORMAT_RAW;
      break;				/* Raw VBI data */
   case 0x55:
      format = VBI_FORMAT_CC;
      break;				/* US CC        */
   case 0xCC:
      format = VBI_FORMAT_NABTS;
      break;				/* US NABTS     */
   }
   return (format);
}

#endif /* GFX_READ_ROUTINES */

/* END OF FILE */