- * Copyright 2006-2007 Advanced Micro Devices, Inc.

-/****************************************************************************/

-#ifndef ULONG

-typedef unsigned long ULONG;

-#endif

-#ifndef UCHAR

-typedef unsigned char UCHAR;

-#endif

-#ifndef USHORT

-typedef unsigned short USHORT;

-#endif

-

-#define ATOM_DAC_A 0

-#define ATOM_SCALER_DISABLE 0

-#define ATOM_SCALER_CENTER 1

-#define ATOM_SCALER_EXPANSION 2

-#define ATOM_SCALER_MULTI_EX 3

-

-#define ATOM_FIREGL_FLAG_STRING "FGL" /* Flag used to enable FireGL Support */

-#define ATOM_MAX_SIZE_OF_FIREGL_FLAG_STRING 3 /* sizeof( ATOM_FIREGL_FLAG_STRING ) */

-#define ATOM_FAKE_DESKTOP_STRING "DSK" /* Flag used to enable mobile ASIC on Desktop */

-#define ATOM_MAX_SIZE_OF_FAKE_DESKTOP_STRING ATOM_MAX_SIZE_OF_FIREGL_FLAG_STRING

-#define ATOM_M54T_FLAG_STRING "M54T" /* Flag used to enable M54T Support */

-#define ATOM_MAX_SIZE_OF_M54T_FLAG_STRING 4 /* sizeof( ATOM_M54T_FLAG_STRING ) */

-#pragma pack(1) /* BIOS data must use byte aligment */

-#define MAXSIZE_OF_ATOMBIOS_ASIC_BUS_MEM_TYPE 20 /* including the terminator 0x0! */

- Every table pointed _ATOM_MASTER_DATA_TABLE has this common header.

-typedef struct _ATOM_COMMON_TABLE_HEADER {

- USHORT usStructureSize;

- UCHAR ucTableFormatRevision; /*Change it when the Parser is not backward compatible */

- UCHAR ucTableContentRevision; /*Change it only when the table needs to change but the firmware */

- /*Image can't be updated, while Driver needs to carry the new table! */

-} ATOM_COMMON_TABLE_HEADER;

-

-typedef struct _ATOM_ROM_HEADER {

- ATOM_COMMON_TABLE_HEADER sHeader;

- UCHAR uaFirmWareSignature[4]; /*Signature to distinguish between Atombios and non-atombios,

- atombios should init it as "ATOM", don't change the position */

- USHORT usBiosRuntimeSegmentAddress;

- USHORT usProtectedModeInfoOffset;

- USHORT usConfigFilenameOffset;

- USHORT usCRC_BlockOffset;

- USHORT usBIOS_BootupMessageOffset;

- USHORT usInt10Offset;

- USHORT usPciBusDevInitCode;

- USHORT usIoBaseAddress;

- USHORT usSubsystemVendorID;

- USHORT usSubsystemID;

- USHORT usPCI_InfoOffset;

- USHORT usMasterCommandTableOffset; /*Offset for SW to get all command table offsets, Don't change the position */

- USHORT usMasterDataTableOffset; /*Offset for SW to get all data table offsets, Don't change the position */

- UCHAR ucExtendedFunctionCode;

- UCHAR ucReserved;

-} ATOM_ROM_HEADER;

-#define UTEMP USHORT

-#define USHORT void*

-typedef struct _ATOM_MASTER_LIST_OF_COMMAND_TABLES {

- USHORT ASIC_Init; /* Function Table, used by various SW components,latest version 1.1 */

- USHORT GetDisplaySurfaceSize; /* Atomic Table, Used by Bios when enabling HW ICON */

- USHORT ASIC_RegistersInit; /* Atomic Table, indirectly used by various SW components,called from ASIC_Init */

- USHORT VRAM_BlockVenderDetection; /* Atomic Table, used only by Bios */

- USHORT DIGxEncoderControl; /* Only used by Bios */

- USHORT MemoryControllerInit; /* Atomic Table, indirectly used by various SW components,called from ASIC_Init */

- USHORT EnableCRTCMemReq; /* Function Table,directly used by various SW components,latest version 2.1 */

- USHORT MemoryParamAdjust; /* Atomic Table, indirectly used by various SW components,called from SetMemoryClock if needed */

- USHORT DVOEncoderControl; /* Function Table,directly used by various SW components,latest version 1.2 */

- USHORT GPIOPinControl; /* Atomic Table, only used by Bios */

- USHORT SetEngineClock; /*Function Table,directly used by various SW components,latest version 1.1 */

- USHORT SetMemoryClock; /* Function Table,directly used by various SW components,latest version 1.1 */

- USHORT SetPixelClock; /*Function Table,directly used by various SW components,latest version 1.2 */

- USHORT DynamicClockGating; /* Atomic Table, indirectly used by various SW components,called from ASIC_Init */

- USHORT ResetMemoryDLL; /* Atomic Table, indirectly used by various SW components,called from SetMemoryClock */

- USHORT ResetMemoryDevice; /* Atomic Table, indirectly used by various SW components,called from SetMemoryClock */

- USHORT MemoryPLLInit;

- USHORT AdjustDisplayPll; /* only used by Bios */

- USHORT AdjustMemoryController; /* Atomic Table, indirectly used by various SW components,called from SetMemoryClock */

- USHORT EnableASIC_StaticPwrMgt; /* Atomic Table, only used by Bios */

- USHORT ASIC_StaticPwrMgtStatusChange; /* Obsolete, only used by Bios */

- USHORT DAC_LoadDetection; /* Atomic Table, directly used by various SW components,latest version 1.2 */

- USHORT LVTMAEncoderControl; /* Atomic Table,directly used by various SW components,latest version 1.3 */

- USHORT LCD1OutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT DAC1EncoderControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT DAC2EncoderControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT DVOOutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT CV1OutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT GetConditionalGoldenSetting; /* only used by Bios */

- USHORT TVEncoderControl; /* Function Table,directly used by various SW components,latest version 1.1 */

- USHORT TMDSAEncoderControl; /* Atomic Table, directly used by various SW components,latest version 1.3 */

- USHORT LVDSEncoderControl; /* Atomic Table, directly used by various SW components,latest version 1.3 */

- USHORT TV1OutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT EnableScaler; /* Atomic Table, used only by Bios */

- USHORT BlankCRTC; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT EnableCRTC; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT GetPixelClock; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT EnableVGA_Render; /* Function Table,directly used by various SW components,latest version 1.1 */

- USHORT EnableVGA_Access; /* Obsolete , only used by Bios */

- USHORT SetCRTC_Timing; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT SetCRTC_OverScan; /* Atomic Table, used by various SW components,latest version 1.1 */

- USHORT SetCRTC_Replication; /* Atomic Table, used only by Bios */

- USHORT SelectCRTC_Source; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT EnableGraphSurfaces; /* Atomic Table, used only by Bios */

- USHORT UpdateCRTC_DoubleBufferRegisters;

- USHORT LUT_AutoFill; /* Atomic Table, only used by Bios */

- USHORT EnableHW_IconCursor; /* Atomic Table, only used by Bios */

- USHORT GetMemoryClock; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT GetEngineClock; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT SetCRTC_UsingDTDTiming; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT ExternalEncoderControl; /* Atomic Table, directly used by various SW components,latest version 2.1 */

- USHORT LVTMAOutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT VRAM_BlockDetectionByStrap; /* Atomic Table, used only by Bios */

- USHORT MemoryCleanUp; /* Atomic Table, only used by Bios */

- USHORT ProcessI2cChannelTransaction; /* Function Table,only used by Bios */

- USHORT WriteOneByteToHWAssistedI2C; /* Function Table,indirectly used by various SW components */

- USHORT ReadHWAssistedI2CStatus; /* Atomic Table, indirectly used by various SW components */

- USHORT SpeedFanControl; /* Function Table,indirectly used by various SW components,called from ASIC_Init */

- USHORT PowerConnectorDetection; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT MC_Synchronization; /* Atomic Table, indirectly used by various SW components,called from SetMemoryClock */

- USHORT ComputeMemoryEnginePLL; /* Atomic Table, indirectly used by various SW components,called from SetMemory/EngineClock */

- USHORT MemoryRefreshConversion; /* Atomic Table, indirectly used by various SW components,called from SetMemory or SetEngineClock */

- USHORT VRAM_GetCurrentInfoBlock; /* Atomic Table, used only by Bios */

- USHORT DynamicMemorySettings; /* Atomic Table, indirectly used by various SW components,called from SetMemoryClock */

- USHORT MemoryTraining; /* Atomic Table, used only by Bios */

- USHORT EnableSpreadSpectrumOnPPLL; /* Atomic Table, directly used by various SW components,latest version 1.2 */

- USHORT TMDSAOutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT SetVoltage; /* Function Table,directly and/or indirectly used by various SW components,latest version 1.1 */

- USHORT DAC1OutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT DAC2OutputControl; /* Atomic Table, directly used by various SW components,latest version 1.1 */

- USHORT SetupHWAssistedI2CStatus; /* Function Table,only used by Bios, obsolete soon.Switch to use "ReadEDIDFromHWAssistedI2C" */

- USHORT ClockSource; /* Atomic Table, indirectly used by various SW components,called from ASIC_Init */

- USHORT MemoryDeviceInit; /* Atomic Table, indirectly used by various SW components,called from SetMemoryClock */

- USHORT EnableYUV; /* Atomic Table, indirectly used by various SW components,called from EnableVGARender */

- USHORT DIG1EncoderControl; /* Atomic Table,directly used by various SW components,latest version 1.1 */

- USHORT DIG2EncoderControl; /* Atomic Table,directly used by various SW components,latest version 1.1 */

- USHORT DIG1TransmitterControl; /* Atomic Table,directly used by various SW components,latest version 1.1 */

- USHORT DIG2TransmitterControl; /* Atomic Table,directly used by various SW components,latest version 1.1 */

- USHORT ProcessAuxChannelTransaction; /* Function Table,only used by Bios */

- USHORT DPEncoderService; /* Function Table,only used by Bios */

-} ATOM_MASTER_LIST_OF_COMMAND_TABLES;

-

-/* For backward compatible */

-typedef struct _ATOM_MASTER_COMMAND_TABLE {

- ATOM_COMMON_TABLE_HEADER sHeader;

- ATOM_MASTER_LIST_OF_COMMAND_TABLES ListOfCommandTables;

-} ATOM_MASTER_COMMAND_TABLE;

-

-/****************************************************************************/

-/* Structures used in every command table */

-/****************************************************************************/

-typedef struct _ATOM_TABLE_ATTRIBUTE {

- USHORT UpdatedByUtility:1; /* [15]=Table updated by utility flag */

- USHORT PS_SizeInBytes:7; /* [14:8]=Size of parameter space in Bytes (multiple of a dword), */

- USHORT WS_SizeInBytes:8; /* [7:0]=Size of workspace in Bytes (in multiple of a dword), */

- USHORT WS_SizeInBytes:8; /* [7:0]=Size of workspace in Bytes (in multiple of a dword), */

- USHORT PS_SizeInBytes:7; /* [14:8]=Size of parameter space in Bytes (multiple of a dword), */

- USHORT UpdatedByUtility:1; /* [15]=Table updated by utility flag */

-} ATOM_TABLE_ATTRIBUTE;

-

-typedef union _ATOM_TABLE_ATTRIBUTE_ACCESS {

- ATOM_TABLE_ATTRIBUTE sbfAccess;

- USHORT susAccess;

-} ATOM_TABLE_ATTRIBUTE_ACCESS;

-/****************************************************************************/

-/* Common header for all command tables. */

-/* Every table pointed by _ATOM_MASTER_COMMAND_TABLE has this common header. */

-/* And the pointer actually points to this header. */

-/****************************************************************************/

-typedef struct _ATOM_COMMON_ROM_COMMAND_TABLE_HEADER {

- ATOM_COMMON_TABLE_HEADER CommonHeader;

- ATOM_TABLE_ATTRIBUTE TableAttribute;

-} ATOM_COMMON_ROM_COMMAND_TABLE_HEADER;

-/****************************************************************************/

-/* Structures used by ComputeMemoryEnginePLLTable */

-/****************************************************************************/

-typedef struct _COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS {

- ULONG ulClock; /* When returen, it's the re-calculated clock based on given Fb_div Post_Div and ref_div */

- UCHAR ucAction; /* 0:reserved //1:Memory //2:Engine */

- UCHAR ucReserved; /* may expand to return larger Fbdiv later */

- UCHAR ucFbDiv; /* return value */

- UCHAR ucPostDiv; /* return value */

-} COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS;

-

-typedef struct _COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS_V2 {

- ULONG ulClock; /* When return, [23:0] return real clock */

- UCHAR ucAction; /* 0:reserved;COMPUTE_MEMORY_PLL_PARAM:Memory;COMPUTE_ENGINE_PLL_PARAM:Engine. it return ref_div to be written to register */

- USHORT usFbDiv; /* return Feedback value to be written to register */

- UCHAR ucPostDiv; /* return post div to be written to register */

-} COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS_V2;

-#define SET_CLOCK_FREQ_MASK 0x00FFFFFF /* Clock change tables only take bit [23:0] as the requested clock value */

-#define USE_NON_BUS_CLOCK_MASK 0x01000000 /* Applicable to both memory and engine clock change, when set, it uses another clock as the temporary clock (engine uses memory and vice versa) */

-#define USE_MEMORY_SELF_REFRESH_MASK 0x02000000 /* Only applicable to memory clock change, when set, using memory self refresh during clock transition */

-#define SKIP_INTERNAL_MEMORY_PARAMETER_CHANGE 0x04000000 /* Only applicable to memory clock change, when set, the table will skip predefined internal memory parameter change */

-#define FIRST_TIME_CHANGE_CLOCK 0x08000000 /* Applicable to both memory and engine clock change,when set, it means this is 1st time to change clock after ASIC bootup */

-#define SKIP_SW_PROGRAM_PLL 0x10000000 /* Applicable to both memory and engine clock change, when set, it means the table will not program SPLL/MPLL */

-#define b3USE_NON_BUS_CLOCK_MASK 0x01 /* Applicable to both memory and engine clock change, when set, it uses another clock as the temporary clock (engine uses memory and vice versa) */

-#define b3USE_MEMORY_SELF_REFRESH 0x02 /* Only applicable to memory clock change, when set, using memory self refresh during clock transition */

-#define b3SKIP_INTERNAL_MEMORY_PARAMETER_CHANGE 0x04 /* Only applicable to memory clock change, when set, the table will skip predefined internal memory parameter change */

-#define b3FIRST_TIME_CHANGE_CLOCK 0x08 /* Applicable to both memory and engine clock change,when set, it means this is 1st time to change clock after ASIC bootup */

-#define b3SKIP_SW_PROGRAM_PLL 0x10 /* Applicable to both memory and engine clock change, when set, it means the table will not program SPLL/MPLL */

-typedef struct _ATOM_COMPUTE_CLOCK_FREQ {

- ULONG ulComputeClockFlag:8; /* =1: COMPUTE_MEMORY_PLL_PARAM, =2: COMPUTE_ENGINE_PLL_PARAM */

- ULONG ulClockFreq:24; /* in unit of 10kHz */

- ULONG ulClockFreq:24; /* in unit of 10kHz */

- ULONG ulComputeClockFlag:8; /* =1: COMPUTE_MEMORY_PLL_PARAM, =2: COMPUTE_ENGINE_PLL_PARAM */

-} ATOM_COMPUTE_CLOCK_FREQ;

-

-typedef struct _ATOM_S_MPLL_FB_DIVIDER {

- USHORT usFbDivFrac;

- USHORT usFbDiv;

-} ATOM_S_MPLL_FB_DIVIDER;

-typedef struct _COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS_V3 {

- union {

- ATOM_COMPUTE_CLOCK_FREQ ulClock; /* Input Parameter */

- ATOM_S_MPLL_FB_DIVIDER ulFbDiv; /* Output Parameter */

- };

- UCHAR ucRefDiv; /* Output Parameter */

- UCHAR ucPostDiv; /* Output Parameter */

- UCHAR ucCntlFlag; /* Output Parameter */

- UCHAR ucReserved;

-} COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS_V3;

-/* ucCntlFlag */

-typedef struct _DYNAMICE_MEMORY_SETTINGS_PARAMETER {

- ATOM_COMPUTE_CLOCK_FREQ ulClock;

- ULONG ulReserved[2];

-} DYNAMICE_MEMORY_SETTINGS_PARAMETER;

-

-typedef struct _DYNAMICE_ENGINE_SETTINGS_PARAMETER {

- ATOM_COMPUTE_CLOCK_FREQ ulClock;

- ULONG ulMemoryClock;

- ULONG ulReserved;

-} DYNAMICE_ENGINE_SETTINGS_PARAMETER;

-

-/****************************************************************************/

-/* Structures used by SetEngineClockTable */

-/****************************************************************************/

-typedef struct _SET_ENGINE_CLOCK_PARAMETERS {

- ULONG ulTargetEngineClock; /* In 10Khz unit */

-} SET_ENGINE_CLOCK_PARAMETERS;

-typedef struct _SET_ENGINE_CLOCK_PS_ALLOCATION {

- ULONG ulTargetEngineClock; /* In 10Khz unit */

- COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS_PS_ALLOCATION sReserved;

-} SET_ENGINE_CLOCK_PS_ALLOCATION;

-/****************************************************************************/

-/* Structures used by SetMemoryClockTable */

-/****************************************************************************/

-typedef struct _SET_MEMORY_CLOCK_PARAMETERS {

- ULONG ulTargetMemoryClock; /* In 10Khz unit */

-} SET_MEMORY_CLOCK_PARAMETERS;

-typedef struct _SET_MEMORY_CLOCK_PS_ALLOCATION {

- ULONG ulTargetMemoryClock; /* In 10Khz unit */

- COMPUTE_MEMORY_ENGINE_PLL_PARAMETERS_PS_ALLOCATION sReserved;

-} SET_MEMORY_CLOCK_PS_ALLOCATION;

-/****************************************************************************/

-/* Structures used by ASIC_Init.ctb */

-/****************************************************************************/

-typedef struct _ASIC_INIT_PARAMETERS {

- ULONG ulDefaultEngineClock; /* In 10Khz unit */

- ULONG ulDefaultMemoryClock; /* In 10Khz unit */

-} ASIC_INIT_PARAMETERS;

-typedef struct _ASIC_INIT_PS_ALLOCATION {

- ASIC_INIT_PARAMETERS sASICInitClocks;

- SET_ENGINE_CLOCK_PS_ALLOCATION sReserved; /* Caller doesn't need to init this structure */

-} ASIC_INIT_PS_ALLOCATION;

-/****************************************************************************/

-/* Structure used by DynamicClockGatingTable.ctb */

-/****************************************************************************/

-typedef struct _DYNAMIC_CLOCK_GATING_PARAMETERS {

- UCHAR ucEnable; /* ATOM_ENABLE or ATOM_DISABLE */

- UCHAR ucPadding[3];

-} DYNAMIC_CLOCK_GATING_PARAMETERS;

-/**************************************