Initial contribution supporting NaviEngine 1
This package_definition.xml will build support for three memory models
- Single (sne1_tb)
- Multiple (ne1_tb)
- Flexible (fne1_tb)
/*
* Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
* naviengine_assp\naviengine_lcd.h
*
*/
#ifndef __NAVIENGINE_LCD_H__
#define __NAVIENGINE_LCD_H__
#include <e32const.h>
#include <platform.h>
#include <e32hal.h>
#include <assp.h>
#include <kernel/kern_priv.h>
// Macro to calculate the screen buffer size
// aBpp is the number of bits-per-pixel, aPpl is the number of pixels per line and aLpp number of lines per panel
#define FRAME_BUFFER_SIZE(aBpp,aPpl,aLpp) (aBpp*aPpl*aLpp)/8
//----------------------------------------------------------------------------
//Display Controller registers
//----------------------------------------------------------------------------
// ------------------------------
// Interface control registers
// ------------------------------
const TUint KHoDisplayInterfaceControl = 0x00; //!!!
const TUint KHwDisplayInterfaceControl = KHwDisplayBase + KHoDisplayInterfaceControl;
//DE - positive logic
//EVSYNC - negative logic
//VSYNC - negative logic
//EHSYNC - negative logic
//HSYNC - negative logic
//Dot clock normal polarity
//Switch on VSync, HSync, CSync, DEN
const TUint KInterfaceControlValue = 0x04;
const TUint KHoDisplayInterruptStatus = 0x08;
const TUint KHwDisplayInterruptStatus = KHwDisplayBase + KHoDisplayInterruptStatus;
const TUint KHoDisplayInterruptClear = 0x10;
const TUint KHwDisplayInterruptClear = KHwDisplayBase + KHoDisplayInterruptClear;
const TUint KHoDisplayInterruptEnable = 0x18;
const TUint KHwDisplayInterruptEnable = KHwDisplayBase + KHoDisplayInterruptEnable;
const TUint KHoDisplayInterruptLineSettings = 0x20; //???
const TUint KHwDisplayInterruptLineSettings = KHwDisplayBase + KHoDisplayInterruptLineSettings; //???
// ic_al_h???
const TUint KHoDisplayInterruptEnableSelection = 0x28;
const TUint KHwDisplayInterruptEnableSelection = KHwDisplayBase + KHoDisplayInterruptEnableSelection;
// ------------------------------
// Display control registers
// ------------------------------
const TUint KHoDisplayResolutionAndCycle = 0x30; //!!!
const TUint KHwDisplayResolutionAndCycle = KHwDisplayBase + KHoDisplayResolutionAndCycle;
//ds_hr[10:0] - Sets the horizontal (width) resolution. The valid range is 320 (QVGA) to 1280 (WXGA).
//ds_vr[25:16] - Sets the vertical (height) resolution. The valid range is 240 (QVGA) to 800 (WXGA).
//ds_th[42:32] - Sets HSYNC in dot clock units. ds_hr + 3 to 7FEh (7FFh is prohibited).
//ds_tv[57:48] - Sets VSYNC in line units. ds_vr + 3 to 3FEh (3FFh is prohibited).
#define DISPLAY_RESOLUTION_AND_CYCLE(height, width, linesInFrame, pixelsInLine) (((height<<16) + width) | ((TUint64) ((linesInFrame<<16) + (pixelsInLine)) <<32))
const TUint KHoDisplayPulseWidth = 0x38; //!!!
const TUint KHwDisplayPulseWidth = KHwDisplayBase + KHoDisplayPulseWidth;
//ds_thp[10:0] - Sets the HSYNC pulse width in dot clock units. Set these bits so that the total blank period is 3 clocks or more.
//ds_tvp[25:16] - Sets the VSYNC pulse width in line units. Set these bits so that the total blank period is 3H or more.
//ds_thb[42:32] - Sets the HSYNC back porch width in dot clock units.
//ds_tvb[57:48] - Sets the VSYNC back porch width in line units.
//settings for LCD QVGA mode
// const TUint KPulseWidthLow = (3<<16)+25; // SW4-2 OFF
// const TUint KPulseWidthHigh = (3<<16)+38; // SW4-2 OFF
const TUint KPulseWidthLow = (2<<16)+25; // SW4-2 ON -on some VGA monitors it doesn't show the whole area
const TUint KPulseWidthHigh = (2<<16)+14; // SW4-2 ON
const TUint64 KPulseWidth = KPulseWidthLow | ((TUint64)KPulseWidthHigh <<32);
//settings for Hitachi LCD VGA mode
const TUint KPulseWidthLowVgaLCD = (2<<16)+30;
const TUint KPulseWidthHighVgaLCD = 0x00020030;
const TUint64 KPulseWidthVgaLCD = KPulseWidthLowVgaLCD | ((TUint64)KPulseWidthHighVgaLCD <<32);
//settings for NEC LCD WVGA mode
const TUint KPulseWidthLowWvga = (2<<16)+30; // RMH - xxx - magic numbers!!!
const TUint KPulseWidthHighWvga = 0x000A0000; // RMH - xxx - magic numbers!!! 0a seems to be a vertical offset, with 02 being too small and 21 being too large; the last two digits, now 00, were 30 seem to be the horizintal offset...
const TUint64 KPulseWidthWvga = KPulseWidthLowWvga | ((TUint64)KPulseWidthHighWvga <<32);
//settings for VGA mode on monitor (if LCD panel is not present)
const TUint KPulseWidthLowVga = (2<<16)+96;
const TUint KPulseWidthHighVga = 0x00210030;
const TUint64 KPulseWidthVga = KPulseWidthLowVga | ((TUint64)KPulseWidthHighVga <<32);
const TUint KHoDisplayDisplaySettings = 0x40; //!!!
const TUint KHwDisplaySettings = KHwDisplayBase + KHoDisplayDisplaySettings;
//ds_oc[0] - Sets on/off of display output to LCD panel; 0 - Off (Black output if sync signal is output); 1 - On
//gamma correction and dithering
const TUint KDisplaySettingsValue = 0x1;
const TUint KHoDisplayDithering = 0x48;
const TUint KHwDisplayDithering = KHwDisplayBase + KHoDisplayDithering;
const TUint KHoDisplayBrightness = 0x50; //!!!
const TUint KHwDisplayBrightness = KHwDisplayBase + KHoDisplayBrightness;
//ds_bc[7:0] Sets the brightness coefficient for RGB data. The range is -128 to 127 (8 bits). To turn off brightness control, set to 0.
const TUint KDisplayBrightnessVal = 0x00; //!!!
// ------------------------------
// Memory Frame control registers
// ------------------------------
const TUint KHoDisplayEndianConversion = 0x58; //!!!
const TUint KHwDisplayEndianConversion = KHwDisplayBase + KHoDisplayEndianConversion;
//mf_es0[1::0] - endian conversion of data in VRAM - should be 00b ???
//mf_lbs[25:24] = 0 -limits of layers and dimensions
const TUint KEndianConversionValue = 0x00; //!!!
//mf_pf0[3:0] Sets the pixel format of each memory frame stored in VRAM. 0h: ARGB0565
const TUint KHoDisplayPixelFormat = 0x60; //!!!
const TUint KHwDisplayPixelFormat = KHwDisplayBase + KHoDisplayPixelFormat;
const TUint KPixelFormatValue16bpp = 0x0; // ARGB0565
const TUint KPixelFormatValue32bpp = 0x4; // ARGB8888
const TUint KPixelFormatValue = KPixelFormatValue32bpp; // Retain keyword and default to bpp32
//mf_sa0[31:0] - Sets the start address of the memory frame stored in VRAM, in byte units.
//mf_sa1[63:32] - Sets the start address of the memory frame stored in VRAM, in byte units.
const TUint KHoDisplayMemoryFrameAddress = 0x0070; //!!!
const TUint KHwDisplayMemoryFrameAddress = KHwDisplayBase + KHoDisplayMemoryFrameAddress;
// physical address in VRAM
const TUint KHoDisplayColorPalletAddress = 0x90;
const TUint KHwDisplayColorPalletAddress = KHwDisplayBase + KHoDisplayColorPalletAddress;
const TUint KHoDisplayColorPalletDirection = 0xA0;
const TUint KHwDisplayColorPalletDirection = KHwDisplayBase + KHoDisplayColorPalletDirection;
const TUint KHoDisplayMemoryFrameSizeH = 0xA8; //!!!
const TUint KHwDisplayMemoryFrameSizeH = KHwDisplayBase + KHoDisplayMemoryFrameSizeH;
// mf_ws_h0[11:0] - horisontal(width) size in byte units. The valid setting range is 1 to 4,096 at 0 to 4,095.
// Usually the width value - 1, eg for 640 pixels wide, use 639
const TUint KHoDisplayMemoryFrameSizeV = 0xB8; //!!!
const TUint KHwDisplayMemoryFrameSizeV = KHwDisplayBase + KHoDisplayMemoryFrameSizeV;
// mf_ws_v0[11:0] - vertical(height) size in line units
// Usually the height value - 1, eg for 480 pixels high, use 479
const TUint KHoDisplayMemoryFrameStartPointX = 0xc8; //!!!
const TUint KHwDisplayMemoryFrameStartPointX = KHwDisplayBase + KHoDisplayMemoryFrameStartPointX;
//mf_sp_x0[11:0] - Sets the horizontal-direction start point coordinates of the
// frame memory stored in VRAM, in pixel units
const TUint KHoDisplayMemoryFrameStartPointY = 0xd8; //!!!
const TUint KHwDisplayMemoryFrameStartPointY = KHwDisplayBase + KHoDisplayMemoryFrameStartPointY;
//mf_sp_y0[11:0] - Sets the vertical-direction start point coordinates of the
// frame memory stored in VRAM, in line units.
const TUint KHoDisplayMemoryFrameStartFractionV = 0xe8;
const TUint KHwDisplayMemoryFrameStartFractionV = KHwDisplayBase + KHoDisplayMemoryFrameStartFractionV;
const TUint KHoDisplayMemoryFrameDisplayFrameSizeH = 0xf0; //!!!
const TUint KHwDisplayMemoryFrameDisplayFrameSizeH = KHwDisplayBase + KHoDisplayMemoryFrameDisplayFrameSizeH;
//mf_ds_h0[11:0] - Sets display frame horizontal-direction size in the memory
// frame, in pixel units. The valid setting range is 1 to 1,280 at 0 to 1,279.
// Usually the width value - 1, eg for 640 pixels wide, use 639
const TUint KHoDisplayMemoryFrameDisplayFrameSizeV = 0x100; //!!!
const TUint KHwDisplayMemoryFrameDisplayFrameSizeV = KHwDisplayBase + KHoDisplayMemoryFrameDisplayFrameSizeV;
//mf_ds_v0[11:0] - Sets display frame vertical-direction size in the memory
// frame, in line units. The valid setting range is 1 to 800 at 0 to 799.
// Usually the height value - 1, eg for 480 pixels high, use 479
const TUint KHoDisplayBorderColourRGB = 0x110; //!!!
const TUint KHwDisplayBorderColourRGB = KHwDisplayBase + KHoDisplayBorderColourRGB; //!!!
//!!!
//mf_bc0[23:0] - Sets the border color value. Correspondence of mf_bcX[23:0] is as shown in Figure 2-6-22.
//mf_bc_s0[28] - Sets the border color format for the corresponding layer.
// 0: Format set by mf_pf0 (memory frame pixel format)
// 1: ARGB0888
// ------------------------------
// Display frame control registers
// ------------------------------
// NOTE: KH*DisplayDisplay is done on purpose because KH*Display is the prefix and the next Display is part of the register name!
const TUint KHoDisplayDisplayFrameControl = 0x130; //!!!
const TUint KHwDisplayDisplayFrameControl = KHwDisplayBase + KHoDisplayDisplayFrameControl;
//df_dc0[3:0] - Sets whether a layer is to be displayed according to a priority.7 - is off
//df_vs0[8] - Selects the contents of VRAM or register to be displayed.
// 0: VRAM
// 1: Register (Value of constant color (df_cc_r, df_cc_g, and df_cc_b) registers is displayed.)
//df_lc0[12] - Sets layer on/off. (Stops access to VRAM.) Display can be turned off by df_dc0, but
// access to VRAM is not stopped. To accurately turn off display, use this register
// Values to set layers 0-3 frame control on and fix their priority.
const TUint64 KDisplayFrameControlValue = (1<<12);
const TUint64 KDisplayFrame1ControlValue = (1<<28) | (0x1<<16);
const TUint64 KDisplayFrame2ControlValue = ((TInt64)1<<44) | ((TInt64)0x2<<32) ;
const TUint64 KDisplayFrame3ControlValue = ((TInt64)1<<60) | ((TInt64)0x3<<48) ;
const TUint KHoDisplayDisplayFrameStartPointX = 0x140; //!!!
const TUint KHwDisplayDisplayFrameStartPointX = KHwDisplayBase + KHoDisplayDisplayFrameStartPointX;
//df_sp_x0[11:0] - Sets the horizontal-direction start point coordinates to be
// displayed, in pixel units. The valid setting range is -2,048 to 2,047.
const TUint KHoDisplayDisplayFrameStartPointY = 0x150; //!!!
const TUint KHwDisplayDisplayFrameStartPointY = KHwDisplayBase + KHoDisplayDisplayFrameStartPointY;
//df_sp_y0[11:0] - Sets the vertical-direction start point coordinates to be
// displayed, in line units. The valid setting range is -2,048 to 2,047.
const TUint KHoDisplayDisplayFrameSizeH = 0x160; //!!!
const TUint KHwDisplayDisplayFrameSizeH = KHwDisplayBase + KHoDisplayDisplayFrameSizeH;
//df_ds_h0[10:0] - Sets the horizontal size to be displayed in pixel units.
// The valid setting range is 1 to 1,280 at 0 to 1,279
const TUint KHoDisplayDisplayFrameSizeV = 0x170; //!!!
const TUint KHwDisplayDisplayFrameSizeV = KHwDisplayBase + KHoDisplayDisplayFrameSizeV;
//df_ds_v0[10:0] - Sets the vertical size to be displayed in line units. The valid setting range is 1-800 at 0-799.
// Caution Ignored depending on the setting of mf_ms_v (memory frame, magnification select, V0, V2,V4)
const TUint KHoDisplayDisplayFrameExpansionRateH = 0x180;
const TUint KHwDisplayDisplayFrameExpansionRateH = KHwDisplayBase + KHoDisplayDisplayFrameExpansionRateH;
// df_rc_h0[12:0] - set to 0
const TUint KHoDisplayDisplayFrameExpansionRateV = 0x190;
const TUint KHwDisplayDisplayFrameExpansionRateV = KHwDisplayBase + KHoDisplayDisplayFrameExpansionRateV;
// df_rc_v0[12:0] - set to 0
const TUint KHoDisplayDisplayFramePixelTransmittance = 0x1a0;
const TUint KHwDisplayDisplayPixelTransmittance = KHwDisplayBase + KHoDisplayDisplayFramePixelTransmittance;
const TUint KHoDisplayDisplayFrameTranCtrlLayerTransmittance = 0x1b0;
const TUint KHwDisplayDisplayTranCtrlLayerTransmittance = KHwDisplayBase + KHoDisplayDisplayFrameTranCtrlLayerTransmittance;
//Display frames 0 to 6 transmission control layer transmittance
const TUint KHoDisplayDisplayFrameColourKeyControl = 0x1c0;
const TUint KHwDisplayDisplayColourKeyControl = KHwDisplayBase + KHoDisplayDisplayFrameColourKeyControl;
// Display frames color key control and color key R, G, B format instruction
const TUint KHoDisplayDisplayFrameColourKey = 0x1c8;
const TUint KHwDisplayDisplayColourKey = KHwDisplayBase + KHoDisplayDisplayFrameColourKey;
const TUint KHoDisplayDisplayFrameColourKeyControlRange = 0x1e8;
const TUint KHwDisplayDisplayColourKeyControlRange = KHwDisplayBase + KHoDisplayDisplayFrameColourKeyControlRange;
// Display frame color key control R, G, B permissible range
const TUint KHoDisplayDisplayFrameConstantColour = 0x1f8; //!!!
const TUint KHwDisplayDisplayFrameConstantColour = KHwDisplayBase + KHoDisplayDisplayFrameConstantColour;
//Sets the constant colours rgb
const TUint KHoDisplayDisplayFrameBackgroundColour = 0x218; //!!!
const TUint KHwDisplayDisplayFrameBackgroundColour = KHwDisplayBase + KHoDisplayDisplayFrameBackgroundColour;
// df_bc_r[23:16], df_bc_g[15:8] & df_bc_b[7:0]
// 220 CDE
// ------------------------------
// (5) H/W cursor control register
// ------------------------------
// ...
// ------------------------------
// (6) V blank update control register
// ------------------------------
// If the display supports Contrast and/or Brightness control then supply the following defines:
// This is only example code... you may need to modify it for your hardware
const TInt KConfigInitialDisplayContrast = 128;
const TInt KConfigLcdMinDisplayContrast = 1;
const TInt KConfigLcdMaxDisplayContrast = 255;
const TInt KConfigInitialDisplayBrightness = 128;
const TInt KConfigLcdMinDisplayBrightness = 1;
const TInt KConfigLcdMaxDisplayBrightness = 255;
#endif //__NAVIENGINE_LCD_H__