xref: /linux/drivers/gpu/drm/amd/include/atomfirmware.h (revision 2c1ed907520c50326b8f604907a8478b27881a2e)
1  /****************************************************************************\
2  *
3  *  File Name      atomfirmware.h
4  *  Project        This is an interface header file between atombios and OS GPU drivers for SoC15 products
5  *
6  *  Description    header file of general definitions for OS and pre-OS video drivers
7  *
8  *  Copyright 2014 Advanced Micro Devices, Inc.
9  *
10  * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
11  * and associated documentation files (the "Software"), to deal in the Software without restriction,
12  * including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
13  * and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
14  * subject to the following conditions:
15  *
16  * The above copyright notice and this permission notice shall be included in all copies or substantial
17  * portions of the Software.
18  *
19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
22  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
23  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
24  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
25  * OTHER DEALINGS IN THE SOFTWARE.
26  *
27  \****************************************************************************/
28  
29  /*IMPORTANT NOTES
30  * If a change in VBIOS/Driver/Tool's interface is only needed for SoC15 and forward products, then the change is only needed in this atomfirmware.h header file.
31  * If a change in VBIOS/Driver/Tool's interface is only needed for pre-SoC15 products, then the change is only needed in atombios.h header file.
32  * If a change is needed for both pre and post SoC15 products, then the change has to be made separately and might be differently in both atomfirmware.h and atombios.h.
33  */
34  
35  #ifndef _ATOMFIRMWARE_H_
36  #define _ATOMFIRMWARE_H_
37  
38  enum  atom_bios_header_version_def{
39    ATOM_MAJOR_VERSION        =0x0003,
40    ATOM_MINOR_VERSION        =0x0003,
41  };
42  
43  #ifdef _H2INC
44    #ifndef uint32_t
45      typedef unsigned long uint32_t;
46    #endif
47  
48    #ifndef uint16_t
49      typedef unsigned short uint16_t;
50    #endif
51  
52    #ifndef uint8_t
53      typedef unsigned char uint8_t;
54    #endif
55  #endif
56  
57  enum atom_crtc_def{
58    ATOM_CRTC1      =0,
59    ATOM_CRTC2      =1,
60    ATOM_CRTC3      =2,
61    ATOM_CRTC4      =3,
62    ATOM_CRTC5      =4,
63    ATOM_CRTC6      =5,
64    ATOM_CRTC_INVALID  =0xff,
65  };
66  
67  enum atom_ppll_def{
68    ATOM_PPLL0          =2,
69    ATOM_GCK_DFS        =8,
70    ATOM_FCH_CLK        =9,
71    ATOM_DP_DTO         =11,
72    ATOM_COMBOPHY_PLL0  =20,
73    ATOM_COMBOPHY_PLL1  =21,
74    ATOM_COMBOPHY_PLL2  =22,
75    ATOM_COMBOPHY_PLL3  =23,
76    ATOM_COMBOPHY_PLL4  =24,
77    ATOM_COMBOPHY_PLL5  =25,
78    ATOM_PPLL_INVALID   =0xff,
79  };
80  
81  // define ASIC internal encoder id ( bit vector ), used for CRTC_SourceSel
82  enum atom_dig_def{
83    ASIC_INT_DIG1_ENCODER_ID  =0x03,
84    ASIC_INT_DIG2_ENCODER_ID  =0x09,
85    ASIC_INT_DIG3_ENCODER_ID  =0x0a,
86    ASIC_INT_DIG4_ENCODER_ID  =0x0b,
87    ASIC_INT_DIG5_ENCODER_ID  =0x0c,
88    ASIC_INT_DIG6_ENCODER_ID  =0x0d,
89    ASIC_INT_DIG7_ENCODER_ID  =0x0e,
90  };
91  
92  //ucEncoderMode
93  enum atom_encode_mode_def
94  {
95    ATOM_ENCODER_MODE_DP          =0,
96    ATOM_ENCODER_MODE_DP_SST      =0,
97    ATOM_ENCODER_MODE_LVDS        =1,
98    ATOM_ENCODER_MODE_DVI         =2,
99    ATOM_ENCODER_MODE_HDMI        =3,
100    ATOM_ENCODER_MODE_DP_AUDIO    =5,
101    ATOM_ENCODER_MODE_DP_MST      =5,
102    ATOM_ENCODER_MODE_CRT         =15,
103    ATOM_ENCODER_MODE_DVO         =16,
104  };
105  
106  enum atom_encoder_refclk_src_def{
107    ENCODER_REFCLK_SRC_P1PLL      =0,
108    ENCODER_REFCLK_SRC_P2PLL      =1,
109    ENCODER_REFCLK_SRC_P3PLL      =2,
110    ENCODER_REFCLK_SRC_EXTCLK     =3,
111    ENCODER_REFCLK_SRC_INVALID    =0xff,
112  };
113  
114  enum atom_scaler_def{
115    ATOM_SCALER_DISABLE          =0,  /*scaler bypass mode, auto-center & no replication*/
116    ATOM_SCALER_CENTER           =1,  //For Fudo, it's bypass and auto-center & auto replication
117    ATOM_SCALER_EXPANSION        =2,  /*scaler expansion by 2 tap alpha blending mode*/
118  };
119  
120  enum atom_operation_def{
121    ATOM_DISABLE             = 0,
122    ATOM_ENABLE              = 1,
123    ATOM_INIT                = 7,
124    ATOM_GET_STATUS          = 8,
125  };
126  
127  enum atom_embedded_display_op_def{
128    ATOM_LCD_BL_OFF                = 2,
129    ATOM_LCD_BL_OM                 = 3,
130    ATOM_LCD_BL_BRIGHTNESS_CONTROL = 4,
131    ATOM_LCD_SELFTEST_START        = 5,
132    ATOM_LCD_SELFTEST_STOP         = 6,
133  };
134  
135  enum atom_spread_spectrum_mode{
136    ATOM_SS_CENTER_OR_DOWN_MODE_MASK  = 0x01,
137    ATOM_SS_DOWN_SPREAD_MODE          = 0x00,
138    ATOM_SS_CENTRE_SPREAD_MODE        = 0x01,
139    ATOM_INT_OR_EXT_SS_MASK           = 0x02,
140    ATOM_INTERNAL_SS_MASK             = 0x00,
141    ATOM_EXTERNAL_SS_MASK             = 0x02,
142  };
143  
144  /* define panel bit per color  */
145  enum atom_panel_bit_per_color{
146    PANEL_BPC_UNDEFINE     =0x00,
147    PANEL_6BIT_PER_COLOR   =0x01,
148    PANEL_8BIT_PER_COLOR   =0x02,
149    PANEL_10BIT_PER_COLOR  =0x03,
150    PANEL_12BIT_PER_COLOR  =0x04,
151    PANEL_16BIT_PER_COLOR  =0x05,
152  };
153  
154  //ucVoltageType
155  enum atom_voltage_type
156  {
157    VOLTAGE_TYPE_VDDC = 1,
158    VOLTAGE_TYPE_MVDDC = 2,
159    VOLTAGE_TYPE_MVDDQ = 3,
160    VOLTAGE_TYPE_VDDCI = 4,
161    VOLTAGE_TYPE_VDDGFX = 5,
162    VOLTAGE_TYPE_PCC = 6,
163    VOLTAGE_TYPE_MVPP = 7,
164    VOLTAGE_TYPE_LEDDPM = 8,
165    VOLTAGE_TYPE_PCC_MVDD = 9,
166    VOLTAGE_TYPE_PCIE_VDDC = 10,
167    VOLTAGE_TYPE_PCIE_VDDR = 11,
168    VOLTAGE_TYPE_GENERIC_I2C_1 = 0x11,
169    VOLTAGE_TYPE_GENERIC_I2C_2 = 0x12,
170    VOLTAGE_TYPE_GENERIC_I2C_3 = 0x13,
171    VOLTAGE_TYPE_GENERIC_I2C_4 = 0x14,
172    VOLTAGE_TYPE_GENERIC_I2C_5 = 0x15,
173    VOLTAGE_TYPE_GENERIC_I2C_6 = 0x16,
174    VOLTAGE_TYPE_GENERIC_I2C_7 = 0x17,
175    VOLTAGE_TYPE_GENERIC_I2C_8 = 0x18,
176    VOLTAGE_TYPE_GENERIC_I2C_9 = 0x19,
177    VOLTAGE_TYPE_GENERIC_I2C_10 = 0x1A,
178  };
179  
180  enum atom_dgpu_vram_type {
181    ATOM_DGPU_VRAM_TYPE_GDDR5 = 0x50,
182    ATOM_DGPU_VRAM_TYPE_HBM2  = 0x60,
183    ATOM_DGPU_VRAM_TYPE_HBM2E = 0x61,
184    ATOM_DGPU_VRAM_TYPE_GDDR6 = 0x70,
185    ATOM_DGPU_VRAM_TYPE_HBM3 = 0x80,
186  };
187  
188  enum atom_dp_vs_preemph_def{
189    DP_VS_LEVEL0_PREEMPH_LEVEL0 = 0x00,
190    DP_VS_LEVEL1_PREEMPH_LEVEL0 = 0x01,
191    DP_VS_LEVEL2_PREEMPH_LEVEL0 = 0x02,
192    DP_VS_LEVEL3_PREEMPH_LEVEL0 = 0x03,
193    DP_VS_LEVEL0_PREEMPH_LEVEL1 = 0x08,
194    DP_VS_LEVEL1_PREEMPH_LEVEL1 = 0x09,
195    DP_VS_LEVEL2_PREEMPH_LEVEL1 = 0x0a,
196    DP_VS_LEVEL0_PREEMPH_LEVEL2 = 0x10,
197    DP_VS_LEVEL1_PREEMPH_LEVEL2 = 0x11,
198    DP_VS_LEVEL0_PREEMPH_LEVEL3 = 0x18,
199  };
200  
201  #define BIOS_ATOM_PREFIX   "ATOMBIOS"
202  #define BIOS_VERSION_PREFIX  "ATOMBIOSBK-AMD"
203  #define BIOS_STRING_LENGTH 43
204  
205  /*
206  enum atom_string_def{
207  asic_bus_type_pcie_string = "PCI_EXPRESS",
208  atom_fire_gl_string       = "FGL",
209  atom_bios_string          = "ATOM"
210  };
211  */
212  
213  #pragma pack(1)                          /* BIOS data must use byte aligment*/
214  
215  enum atombios_image_offset{
216    OFFSET_TO_ATOM_ROM_HEADER_POINTER          = 0x00000048,
217    OFFSET_TO_ATOM_ROM_IMAGE_SIZE              = 0x00000002,
218    OFFSET_TO_ATOMBIOS_ASIC_BUS_MEM_TYPE       = 0x94,
219    MAXSIZE_OF_ATOMBIOS_ASIC_BUS_MEM_TYPE      = 20,  /*including the terminator 0x0!*/
220    OFFSET_TO_GET_ATOMBIOS_NUMBER_OF_STRINGS   = 0x2f,
221    OFFSET_TO_GET_ATOMBIOS_STRING_START        = 0x6e,
222    OFFSET_TO_VBIOS_PART_NUMBER                = 0x80,
223    OFFSET_TO_VBIOS_DATE                       = 0x50,
224  };
225  
226  /****************************************************************************
227  * Common header for all tables (Data table, Command function).
228  * Every table pointed in _ATOM_MASTER_DATA_TABLE has this common header.
229  * And the pointer actually points to this header.
230  ****************************************************************************/
231  
232  struct atom_common_table_header
233  {
234    uint16_t structuresize;
235    uint8_t  format_revision;   //mainly used for a hw function, when the parser is not backward compatible
236    uint8_t  content_revision;  //change it when a data table has a structure change, or a hw function has a input/output parameter change
237  };
238  
239  /****************************************************************************
240  * Structure stores the ROM header.
241  ****************************************************************************/
242  struct atom_rom_header_v2_2
243  {
244    struct atom_common_table_header table_header;
245    uint8_t  atom_bios_string[4];        //enum atom_string_def atom_bios_string;     //Signature to distinguish between Atombios and non-atombios,
246    uint16_t bios_segment_address;
247    uint16_t protectedmodeoffset;
248    uint16_t configfilenameoffset;
249    uint16_t crc_block_offset;
250    uint16_t vbios_bootupmessageoffset;
251    uint16_t int10_offset;
252    uint16_t pcibusdevinitcode;
253    uint16_t iobaseaddress;
254    uint16_t subsystem_vendor_id;
255    uint16_t subsystem_id;
256    uint16_t pci_info_offset;
257    uint16_t masterhwfunction_offset;      //Offest for SW to get all command function offsets, Don't change the position
258    uint16_t masterdatatable_offset;       //Offest for SW to get all data table offsets, Don't change the position
259    uint16_t reserved;
260    uint32_t pspdirtableoffset;
261  };
262  
263  /*==============================hw function portion======================================================================*/
264  
265  
266  /****************************************************************************
267  * Structures used in Command.mtb, each function name is not given here since those function could change from time to time
268  * The real functionality of each function is associated with the parameter structure version when defined
269  * For all internal cmd function definitions, please reference to atomstruct.h
270  ****************************************************************************/
271  struct atom_master_list_of_command_functions_v2_1{
272    uint16_t asic_init;                   //Function
273    uint16_t cmd_function1;               //used as an internal one
274    uint16_t cmd_function2;               //used as an internal one
275    uint16_t cmd_function3;               //used as an internal one
276    uint16_t digxencodercontrol;          //Function
277    uint16_t cmd_function5;               //used as an internal one
278    uint16_t cmd_function6;               //used as an internal one
279    uint16_t cmd_function7;               //used as an internal one
280    uint16_t cmd_function8;               //used as an internal one
281    uint16_t cmd_function9;               //used as an internal one
282    uint16_t setengineclock;              //Function
283    uint16_t setmemoryclock;              //Function
284    uint16_t setpixelclock;               //Function
285    uint16_t enabledisppowergating;       //Function
286    uint16_t cmd_function14;              //used as an internal one
287    uint16_t cmd_function15;              //used as an internal one
288    uint16_t cmd_function16;              //used as an internal one
289    uint16_t cmd_function17;              //used as an internal one
290    uint16_t cmd_function18;              //used as an internal one
291    uint16_t cmd_function19;              //used as an internal one
292    uint16_t cmd_function20;              //used as an internal one
293    uint16_t cmd_function21;              //used as an internal one
294    uint16_t cmd_function22;              //used as an internal one
295    uint16_t cmd_function23;              //used as an internal one
296    uint16_t cmd_function24;              //used as an internal one
297    uint16_t cmd_function25;              //used as an internal one
298    uint16_t cmd_function26;              //used as an internal one
299    uint16_t cmd_function27;              //used as an internal one
300    uint16_t cmd_function28;              //used as an internal one
301    uint16_t cmd_function29;              //used as an internal one
302    uint16_t cmd_function30;              //used as an internal one
303    uint16_t cmd_function31;              //used as an internal one
304    uint16_t cmd_function32;              //used as an internal one
305    uint16_t cmd_function33;              //used as an internal one
306    uint16_t blankcrtc;                   //Function
307    uint16_t enablecrtc;                  //Function
308    uint16_t cmd_function36;              //used as an internal one
309    uint16_t cmd_function37;              //used as an internal one
310    uint16_t cmd_function38;              //used as an internal one
311    uint16_t cmd_function39;              //used as an internal one
312    uint16_t cmd_function40;              //used as an internal one
313    uint16_t getsmuclockinfo;             //Function
314    uint16_t selectcrtc_source;           //Function
315    uint16_t cmd_function43;              //used as an internal one
316    uint16_t cmd_function44;              //used as an internal one
317    uint16_t cmd_function45;              //used as an internal one
318    uint16_t setdceclock;                 //Function
319    uint16_t getmemoryclock;              //Function
320    uint16_t getengineclock;              //Function
321    uint16_t setcrtc_usingdtdtiming;      //Function
322    uint16_t externalencodercontrol;      //Function
323    uint16_t cmd_function51;              //used as an internal one
324    uint16_t cmd_function52;              //used as an internal one
325    uint16_t cmd_function53;              //used as an internal one
326    uint16_t processi2cchanneltransaction;//Function
327    uint16_t cmd_function55;              //used as an internal one
328    uint16_t cmd_function56;              //used as an internal one
329    uint16_t cmd_function57;              //used as an internal one
330    uint16_t cmd_function58;              //used as an internal one
331    uint16_t cmd_function59;              //used as an internal one
332    uint16_t computegpuclockparam;        //Function
333    uint16_t cmd_function61;              //used as an internal one
334    uint16_t cmd_function62;              //used as an internal one
335    uint16_t dynamicmemorysettings;       //Function function
336    uint16_t memorytraining;              //Function function
337    uint16_t cmd_function65;              //used as an internal one
338    uint16_t cmd_function66;              //used as an internal one
339    uint16_t setvoltage;                  //Function
340    uint16_t cmd_function68;              //used as an internal one
341    uint16_t readefusevalue;              //Function
342    uint16_t cmd_function70;              //used as an internal one
343    uint16_t cmd_function71;              //used as an internal one
344    uint16_t cmd_function72;              //used as an internal one
345    uint16_t cmd_function73;              //used as an internal one
346    uint16_t cmd_function74;              //used as an internal one
347    uint16_t cmd_function75;              //used as an internal one
348    uint16_t dig1transmittercontrol;      //Function
349    uint16_t cmd_function77;              //used as an internal one
350    uint16_t processauxchanneltransaction;//Function
351    uint16_t cmd_function79;              //used as an internal one
352    uint16_t getvoltageinfo;              //Function
353  };
354  
355  struct atom_master_command_function_v2_1
356  {
357    struct atom_common_table_header  table_header;
358    struct atom_master_list_of_command_functions_v2_1 listofcmdfunctions;
359  };
360  
361  /****************************************************************************
362  * Structures used in every command function
363  ****************************************************************************/
364  struct atom_function_attribute
365  {
366    uint16_t  ws_in_bytes:8;            //[7:0]=Size of workspace in Bytes (in multiple of a dword),
367    uint16_t  ps_in_bytes:7;            //[14:8]=Size of parameter space in Bytes (multiple of a dword),
368    uint16_t  updated_by_util:1;        //[15]=flag to indicate the function is updated by util
369  };
370  
371  
372  /****************************************************************************
373  * Common header for all hw functions.
374  * Every function pointed by _master_list_of_hw_function has this common header.
375  * And the pointer actually points to this header.
376  ****************************************************************************/
377  struct atom_rom_hw_function_header
378  {
379    struct atom_common_table_header func_header;
380    struct atom_function_attribute func_attrib;
381  };
382  
383  
384  /*==============================sw data table portion======================================================================*/
385  /****************************************************************************
386  * Structures used in data.mtb, each data table name is not given here since those data table could change from time to time
387  * The real name of each table is given when its data structure version is defined
388  ****************************************************************************/
389  struct atom_master_list_of_data_tables_v2_1{
390    uint16_t utilitypipeline;               /* Offest for the utility to get parser info,Don't change this position!*/
391    uint16_t multimedia_info;
392    uint16_t smc_dpm_info;
393    uint16_t sw_datatable3;
394    uint16_t firmwareinfo;                  /* Shared by various SW components */
395    uint16_t sw_datatable5;
396    uint16_t lcd_info;                      /* Shared by various SW components */
397    uint16_t sw_datatable7;
398    uint16_t smu_info;
399    uint16_t sw_datatable9;
400    uint16_t sw_datatable10;
401    uint16_t vram_usagebyfirmware;          /* Shared by various SW components */
402    uint16_t gpio_pin_lut;                  /* Shared by various SW components */
403    uint16_t sw_datatable13;
404    uint16_t gfx_info;
405    uint16_t powerplayinfo;                 /* Shared by various SW components */
406    uint16_t sw_datatable16;
407    uint16_t sw_datatable17;
408    uint16_t sw_datatable18;
409    uint16_t sw_datatable19;
410    uint16_t sw_datatable20;
411    uint16_t sw_datatable21;
412    uint16_t displayobjectinfo;             /* Shared by various SW components */
413    uint16_t indirectioaccess;			  /* used as an internal one */
414    uint16_t umc_info;                      /* Shared by various SW components */
415    uint16_t sw_datatable25;
416    uint16_t sw_datatable26;
417    uint16_t dce_info;                      /* Shared by various SW components */
418    uint16_t vram_info;                     /* Shared by various SW components */
419    uint16_t sw_datatable29;
420    uint16_t integratedsysteminfo;          /* Shared by various SW components */
421    uint16_t asic_profiling_info;           /* Shared by various SW components */
422    uint16_t voltageobject_info;            /* shared by various SW components */
423    uint16_t sw_datatable33;
424    uint16_t sw_datatable34;
425  };
426  
427  
428  struct atom_master_data_table_v2_1
429  {
430    struct atom_common_table_header table_header;
431    struct atom_master_list_of_data_tables_v2_1 listOfdatatables;
432  };
433  
434  
435  struct atom_dtd_format
436  {
437    uint16_t  pixclk;
438    uint16_t  h_active;
439    uint16_t  h_blanking_time;
440    uint16_t  v_active;
441    uint16_t  v_blanking_time;
442    uint16_t  h_sync_offset;
443    uint16_t  h_sync_width;
444    uint16_t  v_sync_offset;
445    uint16_t  v_syncwidth;
446    uint16_t  reserved;
447    uint16_t  reserved0;
448    uint8_t   h_border;
449    uint8_t   v_border;
450    uint16_t  miscinfo;
451    uint8_t   atom_mode_id;
452    uint8_t   refreshrate;
453  };
454  
455  /* atom_dtd_format.modemiscinfo defintion */
456  enum atom_dtd_format_modemiscinfo{
457    ATOM_HSYNC_POLARITY    = 0x0002,
458    ATOM_VSYNC_POLARITY    = 0x0004,
459    ATOM_H_REPLICATIONBY2  = 0x0010,
460    ATOM_V_REPLICATIONBY2  = 0x0020,
461    ATOM_INTERLACE         = 0x0080,
462    ATOM_COMPOSITESYNC     = 0x0040,
463  };
464  
465  
466  /* utilitypipeline
467   * when format_revision==1 && content_revision==1, then this an info table for atomworks to use during debug session, no structure is associated with it.
468   * the location of it can't change
469  */
470  
471  
472  /*
473    ***************************************************************************
474      Data Table firmwareinfo  structure
475    ***************************************************************************
476  */
477  
478  struct atom_firmware_info_v3_1
479  {
480    struct atom_common_table_header table_header;
481    uint32_t firmware_revision;
482    uint32_t bootup_sclk_in10khz;
483    uint32_t bootup_mclk_in10khz;
484    uint32_t firmware_capability;             // enum atombios_firmware_capability
485    uint32_t main_call_parser_entry;          /* direct address of main parser call in VBIOS binary. */
486    uint32_t bios_scratch_reg_startaddr;      // 1st bios scratch register dword address
487    uint16_t bootup_vddc_mv;
488    uint16_t bootup_vddci_mv;
489    uint16_t bootup_mvddc_mv;
490    uint16_t bootup_vddgfx_mv;
491    uint8_t  mem_module_id;
492    uint8_t  coolingsolution_id;              /*0: Air cooling; 1: Liquid cooling ... */
493    uint8_t  reserved1[2];
494    uint32_t mc_baseaddr_high;
495    uint32_t mc_baseaddr_low;
496    uint32_t reserved2[6];
497  };
498  
499  /* Total 32bit cap indication */
500  enum atombios_firmware_capability
501  {
502  	ATOM_FIRMWARE_CAP_FIRMWARE_POSTED = 0x00000001,
503  	ATOM_FIRMWARE_CAP_GPU_VIRTUALIZATION  = 0x00000002,
504  	ATOM_FIRMWARE_CAP_WMI_SUPPORT  = 0x00000040,
505  	ATOM_FIRMWARE_CAP_HWEMU_ENABLE  = 0x00000080,
506  	ATOM_FIRMWARE_CAP_HWEMU_UMC_CFG = 0x00000100,
507  	ATOM_FIRMWARE_CAP_SRAM_ECC      = 0x00000200,
508  	ATOM_FIRMWARE_CAP_ENABLE_2STAGE_BIST_TRAINING  = 0x00000400,
509  	ATOM_FIRMWARE_CAP_ENABLE_2ND_USB20PORT = 0x0008000,
510  	ATOM_FIRMWARE_CAP_DYNAMIC_BOOT_CFG_ENABLE = 0x0020000,
511  };
512  
513  enum atom_cooling_solution_id{
514    AIR_COOLING    = 0x00,
515    LIQUID_COOLING = 0x01
516  };
517  
518  struct atom_firmware_info_v3_2 {
519    struct atom_common_table_header table_header;
520    uint32_t firmware_revision;
521    uint32_t bootup_sclk_in10khz;
522    uint32_t bootup_mclk_in10khz;
523    uint32_t firmware_capability;             // enum atombios_firmware_capability
524    uint32_t main_call_parser_entry;          /* direct address of main parser call in VBIOS binary. */
525    uint32_t bios_scratch_reg_startaddr;      // 1st bios scratch register dword address
526    uint16_t bootup_vddc_mv;
527    uint16_t bootup_vddci_mv;
528    uint16_t bootup_mvddc_mv;
529    uint16_t bootup_vddgfx_mv;
530    uint8_t  mem_module_id;
531    uint8_t  coolingsolution_id;              /*0: Air cooling; 1: Liquid cooling ... */
532    uint8_t  reserved1[2];
533    uint32_t mc_baseaddr_high;
534    uint32_t mc_baseaddr_low;
535    uint8_t  board_i2c_feature_id;            // enum of atom_board_i2c_feature_id_def
536    uint8_t  board_i2c_feature_gpio_id;       // i2c id find in gpio_lut data table gpio_id
537    uint8_t  board_i2c_feature_slave_addr;
538    uint8_t  reserved3;
539    uint16_t bootup_mvddq_mv;
540    uint16_t bootup_mvpp_mv;
541    uint32_t zfbstartaddrin16mb;
542    uint32_t reserved2[3];
543  };
544  
545  struct atom_firmware_info_v3_3
546  {
547    struct atom_common_table_header table_header;
548    uint32_t firmware_revision;
549    uint32_t bootup_sclk_in10khz;
550    uint32_t bootup_mclk_in10khz;
551    uint32_t firmware_capability;             // enum atombios_firmware_capability
552    uint32_t main_call_parser_entry;          /* direct address of main parser call in VBIOS binary. */
553    uint32_t bios_scratch_reg_startaddr;      // 1st bios scratch register dword address
554    uint16_t bootup_vddc_mv;
555    uint16_t bootup_vddci_mv;
556    uint16_t bootup_mvddc_mv;
557    uint16_t bootup_vddgfx_mv;
558    uint8_t  mem_module_id;
559    uint8_t  coolingsolution_id;              /*0: Air cooling; 1: Liquid cooling ... */
560    uint8_t  reserved1[2];
561    uint32_t mc_baseaddr_high;
562    uint32_t mc_baseaddr_low;
563    uint8_t  board_i2c_feature_id;            // enum of atom_board_i2c_feature_id_def
564    uint8_t  board_i2c_feature_gpio_id;       // i2c id find in gpio_lut data table gpio_id
565    uint8_t  board_i2c_feature_slave_addr;
566    uint8_t  reserved3;
567    uint16_t bootup_mvddq_mv;
568    uint16_t bootup_mvpp_mv;
569    uint32_t zfbstartaddrin16mb;
570    uint32_t pplib_pptable_id;                // if pplib_pptable_id!=0, pplib get powerplay table inside driver instead of from VBIOS
571    uint32_t reserved2[2];
572  };
573  
574  struct atom_firmware_info_v3_4 {
575  	struct atom_common_table_header table_header;
576  	uint32_t firmware_revision;
577  	uint32_t bootup_sclk_in10khz;
578  	uint32_t bootup_mclk_in10khz;
579  	uint32_t firmware_capability;             // enum atombios_firmware_capability
580  	uint32_t main_call_parser_entry;          /* direct address of main parser call in VBIOS binary. */
581  	uint32_t bios_scratch_reg_startaddr;      // 1st bios scratch register dword address
582  	uint16_t bootup_vddc_mv;
583  	uint16_t bootup_vddci_mv;
584  	uint16_t bootup_mvddc_mv;
585  	uint16_t bootup_vddgfx_mv;
586  	uint8_t  mem_module_id;
587  	uint8_t  coolingsolution_id;              /*0: Air cooling; 1: Liquid cooling ... */
588  	uint8_t  reserved1[2];
589  	uint32_t mc_baseaddr_high;
590  	uint32_t mc_baseaddr_low;
591  	uint8_t  board_i2c_feature_id;            // enum of atom_board_i2c_feature_id_def
592  	uint8_t  board_i2c_feature_gpio_id;       // i2c id find in gpio_lut data table gpio_id
593  	uint8_t  board_i2c_feature_slave_addr;
594  	uint8_t  ras_rom_i2c_slave_addr;
595  	uint16_t bootup_mvddq_mv;
596  	uint16_t bootup_mvpp_mv;
597  	uint32_t zfbstartaddrin16mb;
598  	uint32_t pplib_pptable_id;                // if pplib_pptable_id!=0, pplib get powerplay table inside driver instead of from VBIOS
599  	uint32_t mvdd_ratio;                      // mvdd_raio = (real mvdd in power rail)*1000/(mvdd_output_from_svi2)
600  	uint16_t hw_bootup_vddgfx_mv;             // hw default vddgfx voltage level decide by board strap
601  	uint16_t hw_bootup_vddc_mv;               // hw default vddc voltage level decide by board strap
602  	uint16_t hw_bootup_mvddc_mv;              // hw default mvddc voltage level decide by board strap
603  	uint16_t hw_bootup_vddci_mv;              // hw default vddci voltage level decide by board strap
604  	uint32_t maco_pwrlimit_mw;                // bomaco mode power limit in unit of m-watt
605  	uint32_t usb_pwrlimit_mw;                 // power limit when USB is enable in unit of m-watt
606  	uint32_t fw_reserved_size_in_kb;          // VBIOS reserved extra fw size in unit of kb.
607          uint32_t pspbl_init_done_reg_addr;
608          uint32_t pspbl_init_done_value;
609          uint32_t pspbl_init_done_check_timeout;   // time out in unit of us when polling pspbl init done
610          uint32_t reserved[2];
611  };
612  
613  struct atom_firmware_info_v3_5 {
614    struct atom_common_table_header table_header;
615    uint32_t firmware_revision;
616    uint32_t bootup_clk_reserved[2];
617    uint32_t firmware_capability;             // enum atombios_firmware_capability
618    uint32_t fw_protect_region_size_in_kb;    /* FW allocate a write protect region at top of FB. */
619    uint32_t bios_scratch_reg_startaddr;      // 1st bios scratch register dword address
620    uint32_t bootup_voltage_reserved[2];
621    uint8_t  mem_module_id;
622    uint8_t  coolingsolution_id;              /*0: Air cooling; 1: Liquid cooling ... */
623    uint8_t  hw_blt_mode;                     //0:HW_BLT_DMA_PIO_MODE; 1:HW_BLT_LITE_SDMA_MODE; 2:HW_BLT_PCI_IO_MODE
624    uint8_t  reserved1;
625    uint32_t mc_baseaddr_high;
626    uint32_t mc_baseaddr_low;
627    uint8_t  board_i2c_feature_id;            // enum of atom_board_i2c_feature_id_def
628    uint8_t  board_i2c_feature_gpio_id;       // i2c id find in gpio_lut data table gpio_id
629    uint8_t  board_i2c_feature_slave_addr;
630    uint8_t  ras_rom_i2c_slave_addr;
631    uint32_t bootup_voltage_reserved1;
632    uint32_t zfb_reserved;
633    // if pplib_pptable_id!=0, pplib get powerplay table inside driver instead of from VBIOS
634    uint32_t pplib_pptable_id;
635    uint32_t hw_voltage_reserved[3];
636    uint32_t maco_pwrlimit_mw;                // bomaco mode power limit in unit of m-watt
637    uint32_t usb_pwrlimit_mw;                 // power limit when USB is enable in unit of m-watt
638    uint32_t fw_reserved_size_in_kb;          // VBIOS reserved extra fw size in unit of kb.
639    uint32_t pspbl_init_reserved[3];
640    uint32_t spi_rom_size;                    // GPU spi rom size
641    uint16_t support_dev_in_objinfo;
642    uint16_t disp_phy_tunning_size;
643    uint32_t reserved[16];
644  };
645  /*
646    ***************************************************************************
647      Data Table lcd_info  structure
648    ***************************************************************************
649  */
650  
651  struct lcd_info_v2_1
652  {
653    struct  atom_common_table_header table_header;
654    struct  atom_dtd_format  lcd_timing;
655    uint16_t backlight_pwm;
656    uint16_t special_handle_cap;
657    uint16_t panel_misc;
658    uint16_t lvds_max_slink_pclk;
659    uint16_t lvds_ss_percentage;
660    uint16_t lvds_ss_rate_10hz;
661    uint8_t  pwr_on_digon_to_de;          /*all pwr sequence numbers below are in uint of 4ms*/
662    uint8_t  pwr_on_de_to_vary_bl;
663    uint8_t  pwr_down_vary_bloff_to_de;
664    uint8_t  pwr_down_de_to_digoff;
665    uint8_t  pwr_off_delay;
666    uint8_t  pwr_on_vary_bl_to_blon;
667    uint8_t  pwr_down_bloff_to_vary_bloff;
668    uint8_t  panel_bpc;
669    uint8_t  dpcd_edp_config_cap;
670    uint8_t  dpcd_max_link_rate;
671    uint8_t  dpcd_max_lane_count;
672    uint8_t  dpcd_max_downspread;
673    uint8_t  min_allowed_bl_level;
674    uint8_t  max_allowed_bl_level;
675    uint8_t  bootup_bl_level;
676    uint8_t  dplvdsrxid;
677    uint32_t reserved1[8];
678  };
679  
680  /* lcd_info_v2_1.panel_misc defintion */
681  enum atom_lcd_info_panel_misc{
682    ATOM_PANEL_MISC_FPDI            =0x0002,
683  };
684  
685  //uceDPToLVDSRxId
686  enum atom_lcd_info_dptolvds_rx_id
687  {
688    eDP_TO_LVDS_RX_DISABLE                 = 0x00,       // no eDP->LVDS translator chip
689    eDP_TO_LVDS_COMMON_ID                  = 0x01,       // common eDP->LVDS translator chip without AMD SW init
690    eDP_TO_LVDS_REALTEK_ID                 = 0x02,       // Realtek tansaltor which require AMD SW init
691  };
692  
693  
694  /*
695    ***************************************************************************
696      Data Table gpio_pin_lut  structure
697    ***************************************************************************
698  */
699  
700  struct atom_gpio_pin_assignment
701  {
702    uint32_t data_a_reg_index;
703    uint8_t  gpio_bitshift;
704    uint8_t  gpio_mask_bitshift;
705    uint8_t  gpio_id;
706    uint8_t  reserved;
707  };
708  
709  /* atom_gpio_pin_assignment.gpio_id definition */
710  enum atom_gpio_pin_assignment_gpio_id {
711    I2C_HW_LANE_MUX        =0x0f, /* only valid when bit7=1 */
712    I2C_HW_ENGINE_ID_MASK  =0x70, /* only valid when bit7=1 */
713    I2C_HW_CAP             =0x80, /*only when the I2C_HW_CAP is set, the pin ID is assigned to an I2C pin pair, otherwise, it's an generic GPIO pin */
714  
715    /* gpio_id pre-define id for multiple usage */
716    /* GPIO use to control PCIE_VDDC in certain SLT board */
717    PCIE_VDDC_CONTROL_GPIO_PINID = 56,
718    /* if PP_AC_DC_SWITCH_GPIO_PINID in Gpio_Pin_LutTable, AC/DC swithing feature is enable */
719    PP_AC_DC_SWITCH_GPIO_PINID = 60,
720    /* VDDC_REGULATOR_VRHOT_GPIO_PINID in Gpio_Pin_LutTable, VRHot feature is enable */
721    VDDC_VRHOT_GPIO_PINID = 61,
722    /*if VDDC_PCC_GPIO_PINID in GPIO_LUTable, Peak Current Control feature is enabled */
723    VDDC_PCC_GPIO_PINID = 62,
724    /* Only used on certain SLT/PA board to allow utility to cut Efuse. */
725    EFUSE_CUT_ENABLE_GPIO_PINID = 63,
726    /* ucGPIO=DRAM_SELF_REFRESH_GPIO_PIND uses  for memory self refresh (ucGPIO=0, DRAM self-refresh; ucGPIO= */
727    DRAM_SELF_REFRESH_GPIO_PINID = 64,
728    /* Thermal interrupt output->system thermal chip GPIO pin */
729    THERMAL_INT_OUTPUT_GPIO_PINID =65,
730  };
731  
732  
733  struct atom_gpio_pin_lut_v2_1
734  {
735    struct  atom_common_table_header  table_header;
736    /*the real number of this included in the structure is calcualted by using the (whole structure size - the header size)/size of atom_gpio_pin_lut  */
737    struct  atom_gpio_pin_assignment  gpio_pin[];
738  };
739  
740  
741  /*
742   * VBIOS/PRE-OS always reserve a FB region at the top of frame buffer. driver should not write
743   * access that region. driver can allocate their own reservation region as long as it does not
744   * overlap firwmare's reservation region.
745   * if (pre-NV1X) atom data table firmwareInfoTable version < 3.3:
746   * in this case, atom data table vram_usagebyfirmwareTable version always <= 2.1
747   *   if VBIOS/UEFI GOP is posted:
748   *     VBIOS/UEFIGOP update used_by_firmware_in_kb = total reserved size by VBIOS
749   *     update start_address_in_kb = total_mem_size_in_kb - used_by_firmware_in_kb;
750   *     ( total_mem_size_in_kb = reg(CONFIG_MEMSIZE)<<10)
751   *     driver can allocate driver reservation region under firmware reservation,
752   *     used_by_driver_in_kb = driver reservation size
753   *     driver reservation start address =  (start_address_in_kb - used_by_driver_in_kb)
754   *     Comment1[hchan]: There is only one reservation at the beginning of the FB reserved by
755   *     host driver. Host driver would overwrite the table with the following
756   *     used_by_firmware_in_kb = total reserved size for pf-vf info exchange and
757   *     set SRIOV_MSG_SHARE_RESERVATION mask start_address_in_kb = 0
758   *   else there is no VBIOS reservation region:
759   *     driver must allocate driver reservation region at top of FB.
760   *     driver set used_by_driver_in_kb = driver reservation size
761   *     driver reservation start address =  (total_mem_size_in_kb - used_by_driver_in_kb)
762   *     same as Comment1
763   * else (NV1X and after):
764   *   if VBIOS/UEFI GOP is posted:
765   *     VBIOS/UEFIGOP update:
766   *       used_by_firmware_in_kb = atom_firmware_Info_v3_3.fw_reserved_size_in_kb;
767   *       start_address_in_kb = total_mem_size_in_kb - used_by_firmware_in_kb;
768   *       (total_mem_size_in_kb = reg(CONFIG_MEMSIZE)<<10)
769   *   if vram_usagebyfirmwareTable version <= 2.1:
770   *     driver can allocate driver reservation region under firmware reservation,
771   *     driver set used_by_driver_in_kb = driver reservation size
772   *     driver reservation start address = start_address_in_kb - used_by_driver_in_kb
773   *     same as Comment1
774   *   else driver can:
775   *     allocate it reservation any place as long as it does overlap pre-OS FW reservation area
776   *     set used_by_driver_region0_in_kb = driver reservation size
777   *     set driver_region0_start_address_in_kb =  driver reservation region start address
778   *     Comment2[hchan]: Host driver can set used_by_firmware_in_kb and start_address_in_kb to
779   *     zero as the reservation for VF as it doesn’t exist.  And Host driver should also
780   *     update atom_firmware_Info table to remove the same VBIOS reservation as well.
781   */
782  
783  struct vram_usagebyfirmware_v2_1
784  {
785  	struct  atom_common_table_header  table_header;
786  	uint32_t  start_address_in_kb;
787  	uint16_t  used_by_firmware_in_kb;
788  	uint16_t  used_by_driver_in_kb;
789  };
790  
791  struct vram_usagebyfirmware_v2_2 {
792  	struct  atom_common_table_header  table_header;
793  	uint32_t  fw_region_start_address_in_kb;
794  	uint16_t  used_by_firmware_in_kb;
795  	uint16_t  reserved;
796  	uint32_t  driver_region0_start_address_in_kb;
797  	uint32_t  used_by_driver_region0_in_kb;
798  	uint32_t  reserved32[7];
799  };
800  
801  /*
802    ***************************************************************************
803      Data Table displayobjectinfo  structure
804    ***************************************************************************
805  */
806  
807  enum atom_object_record_type_id {
808  	ATOM_I2C_RECORD_TYPE = 1,
809  	ATOM_HPD_INT_RECORD_TYPE = 2,
810  	ATOM_CONNECTOR_CAP_RECORD_TYPE = 3,
811  	ATOM_CONNECTOR_SPEED_UPTO = 4,
812  	ATOM_OBJECT_GPIO_CNTL_RECORD_TYPE = 9,
813  	ATOM_CONNECTOR_HPDPIN_LUT_RECORD_TYPE = 16,
814  	ATOM_CONNECTOR_AUXDDC_LUT_RECORD_TYPE = 17,
815  	ATOM_ENCODER_CAP_RECORD_TYPE = 20,
816  	ATOM_BRACKET_LAYOUT_RECORD_TYPE = 21,
817  	ATOM_CONNECTOR_FORCED_TMDS_CAP_RECORD_TYPE = 22,
818  	ATOM_DISP_CONNECTOR_CAPS_RECORD_TYPE = 23,
819  	ATOM_BRACKET_LAYOUT_V2_RECORD_TYPE = 25,
820  	ATOM_RECORD_END_TYPE = 0xFF,
821  };
822  
823  struct atom_common_record_header
824  {
825    uint8_t record_type;                      //An emun to indicate the record type
826    uint8_t record_size;                      //The size of the whole record in byte
827  };
828  
829  struct atom_i2c_record
830  {
831    struct atom_common_record_header record_header;   //record_type = ATOM_I2C_RECORD_TYPE
832    uint8_t i2c_id;
833    uint8_t i2c_slave_addr;                   //The slave address, it's 0 when the record is attached to connector for DDC
834  };
835  
836  struct atom_hpd_int_record
837  {
838    struct atom_common_record_header record_header;  //record_type = ATOM_HPD_INT_RECORD_TYPE
839    uint8_t  pin_id;              //Corresponding block in GPIO_PIN_INFO table gives the pin info
840    uint8_t  plugin_pin_state;
841  };
842  
843  struct atom_connector_caps_record {
844  	struct atom_common_record_header
845  		record_header; //record_type = ATOM_CONN_CAP_RECORD_TYPE
846  	uint16_t connector_caps; //01b if internal display is checked; 10b if internal BL is checked; 0 of Not
847  };
848  
849  struct atom_connector_speed_record {
850  	struct atom_common_record_header
851  		record_header; //record_type = ATOM_CONN_SPEED_UPTO
852  	uint32_t connector_max_speed; // connector Max speed attribute, it sets 8100 in Mhz when DP connector @8.1Ghz.
853  	uint16_t reserved;
854  };
855  
856  // Bit maps for ATOM_ENCODER_CAP_RECORD.usEncoderCap
857  enum atom_encoder_caps_def
858  {
859    ATOM_ENCODER_CAP_RECORD_HBR2                  =0x01,         // DP1.2 HBR2 is supported by HW encoder, it is retired in NI. the real meaning from SI is MST_EN
860    ATOM_ENCODER_CAP_RECORD_MST_EN                =0x01,         // from SI, this bit means DP MST is enable or not.
861    ATOM_ENCODER_CAP_RECORD_HBR2_EN               =0x02,         // DP1.2 HBR2 setting is qualified and HBR2 can be enabled
862    ATOM_ENCODER_CAP_RECORD_HDMI6Gbps_EN          =0x04,         // HDMI2.0 6Gbps enable or not.
863    ATOM_ENCODER_CAP_RECORD_HBR3_EN               =0x08,         // DP1.3 HBR3 is supported by board.
864    ATOM_ENCODER_CAP_RECORD_DP2                   =0x10,         // DP2 is supported by ASIC/board.
865    ATOM_ENCODER_CAP_RECORD_UHBR10_EN             =0x20,         // DP2.0 UHBR10 settings is supported by board
866    ATOM_ENCODER_CAP_RECORD_UHBR13_5_EN           =0x40,         // DP2.0 UHBR13.5 settings is supported by board
867    ATOM_ENCODER_CAP_RECORD_UHBR20_EN             =0x80,         // DP2.0 UHBR20 settings is supported by board
868    ATOM_ENCODER_CAP_RECORD_USB_C_TYPE            =0x100,        // the DP connector is a USB-C type.
869  };
870  
871  struct  atom_encoder_caps_record
872  {
873    struct atom_common_record_header record_header;  //record_type = ATOM_ENCODER_CAP_RECORD_TYPE
874    uint32_t  encodercaps;
875  };
876  
877  enum atom_connector_caps_def
878  {
879    ATOM_CONNECTOR_CAP_INTERNAL_DISPLAY         = 0x01,        //a cap bit to indicate that this non-embedded display connector is an internal display
880    ATOM_CONNECTOR_CAP_INTERNAL_DISPLAY_BL      = 0x02,        //a cap bit to indicate that this internal display requires BL control from GPU, refers to lcd_info for BL PWM freq
881  };
882  
883  struct atom_disp_connector_caps_record
884  {
885    struct atom_common_record_header record_header;
886    uint32_t connectcaps;
887  };
888  
889  //The following generic object gpio pin control record type will replace JTAG_RECORD/FPGA_CONTROL_RECORD/DVI_EXT_INPUT_RECORD above gradually
890  struct atom_gpio_pin_control_pair
891  {
892    uint8_t gpio_id;               // GPIO_ID, find the corresponding ID in GPIO_LUT table
893    uint8_t gpio_pinstate;         // Pin state showing how to set-up the pin
894  };
895  
896  struct atom_object_gpio_cntl_record
897  {
898    struct atom_common_record_header record_header;
899    uint8_t flag;                   // Future expnadibility
900    uint8_t number_of_pins;         // Number of GPIO pins used to control the object
901    struct atom_gpio_pin_control_pair gpio[1];              // the real gpio pin pair determined by number of pins ucNumberOfPins
902  };
903  
904  //Definitions for GPIO pin state
905  enum atom_gpio_pin_control_pinstate_def
906  {
907    GPIO_PIN_TYPE_INPUT             = 0x00,
908    GPIO_PIN_TYPE_OUTPUT            = 0x10,
909    GPIO_PIN_TYPE_HW_CONTROL        = 0x20,
910  
911  //For GPIO_PIN_TYPE_OUTPUT the following is defined
912    GPIO_PIN_OUTPUT_STATE_MASK      = 0x01,
913    GPIO_PIN_OUTPUT_STATE_SHIFT     = 0,
914    GPIO_PIN_STATE_ACTIVE_LOW       = 0x0,
915    GPIO_PIN_STATE_ACTIVE_HIGH      = 0x1,
916  };
917  
918  // Indexes to GPIO array in GLSync record
919  // GLSync record is for Frame Lock/Gen Lock feature.
920  enum atom_glsync_record_gpio_index_def
921  {
922    ATOM_GPIO_INDEX_GLSYNC_REFCLK    = 0,
923    ATOM_GPIO_INDEX_GLSYNC_HSYNC     = 1,
924    ATOM_GPIO_INDEX_GLSYNC_VSYNC     = 2,
925    ATOM_GPIO_INDEX_GLSYNC_SWAP_REQ  = 3,
926    ATOM_GPIO_INDEX_GLSYNC_SWAP_GNT  = 4,
927    ATOM_GPIO_INDEX_GLSYNC_INTERRUPT = 5,
928    ATOM_GPIO_INDEX_GLSYNC_V_RESET   = 6,
929    ATOM_GPIO_INDEX_GLSYNC_SWAP_CNTL = 7,
930    ATOM_GPIO_INDEX_GLSYNC_SWAP_SEL  = 8,
931    ATOM_GPIO_INDEX_GLSYNC_MAX       = 9,
932  };
933  
934  
935  struct atom_connector_hpdpin_lut_record     //record for ATOM_CONNECTOR_HPDPIN_LUT_RECORD_TYPE
936  {
937    struct atom_common_record_header record_header;
938    uint8_t hpd_pin_map[8];
939  };
940  
941  struct atom_connector_auxddc_lut_record     //record for ATOM_CONNECTOR_AUXDDC_LUT_RECORD_TYPE
942  {
943    struct atom_common_record_header record_header;
944    uint8_t aux_ddc_map[8];
945  };
946  
947  struct atom_connector_forced_tmds_cap_record
948  {
949    struct atom_common_record_header record_header;
950    // override TMDS capability on this connector when it operate in TMDS mode.  usMaxTmdsClkRate = max TMDS Clock in Mhz/2.5
951    uint8_t  maxtmdsclkrate_in2_5mhz;
952    uint8_t  reserved;
953  };
954  
955  struct atom_connector_layout_info
956  {
957    uint16_t connectorobjid;
958    uint8_t  connector_type;
959    uint8_t  position;
960  };
961  
962  // define ATOM_CONNECTOR_LAYOUT_INFO.ucConnectorType to describe the display connector size
963  enum atom_connector_layout_info_connector_type_def
964  {
965    CONNECTOR_TYPE_DVI_D                 = 1,
966  
967    CONNECTOR_TYPE_HDMI                  = 4,
968    CONNECTOR_TYPE_DISPLAY_PORT          = 5,
969    CONNECTOR_TYPE_MINI_DISPLAY_PORT     = 6,
970  };
971  
972  struct  atom_bracket_layout_record
973  {
974    struct atom_common_record_header record_header;
975    uint8_t bracketlen;
976    uint8_t bracketwidth;
977    uint8_t conn_num;
978    uint8_t reserved;
979    struct atom_connector_layout_info  conn_info[1];
980  };
981  struct atom_bracket_layout_record_v2 {
982  	struct atom_common_record_header
983  		record_header; //record_type =  ATOM_BRACKET_LAYOUT_RECORD_TYPE
984  	uint8_t bracketlen; //Bracket Length in mm
985  	uint8_t bracketwidth; //Bracket Width in mm
986  	uint8_t conn_num; //Connector numbering
987  	uint8_t mini_type; //Mini Type (0 = Normal; 1 = Mini)
988  	uint8_t reserved1;
989  	uint8_t reserved2;
990  };
991  
992  enum atom_connector_layout_info_mini_type_def {
993  	MINI_TYPE_NORMAL = 0,
994  	MINI_TYPE_MINI = 1,
995  };
996  
997  enum atom_display_device_tag_def{
998    ATOM_DISPLAY_LCD1_SUPPORT            = 0x0002, //an embedded display is either an LVDS or eDP signal type of display
999    ATOM_DISPLAY_LCD2_SUPPORT			       = 0x0020, //second edp device tag 0x0020 for backward compability
1000    ATOM_DISPLAY_DFP1_SUPPORT            = 0x0008,
1001    ATOM_DISPLAY_DFP2_SUPPORT            = 0x0080,
1002    ATOM_DISPLAY_DFP3_SUPPORT            = 0x0200,
1003    ATOM_DISPLAY_DFP4_SUPPORT            = 0x0400,
1004    ATOM_DISPLAY_DFP5_SUPPORT            = 0x0800,
1005    ATOM_DISPLAY_DFP6_SUPPORT            = 0x0040,
1006    ATOM_DISPLAY_DFPx_SUPPORT            = 0x0ec8,
1007  };
1008  
1009  struct atom_display_object_path_v2
1010  {
1011    uint16_t display_objid;                  //Connector Object ID or Misc Object ID
1012    uint16_t disp_recordoffset;
1013    uint16_t encoderobjid;                   //first encoder closer to the connector, could be either an external or intenal encoder
1014    uint16_t extencoderobjid;                //2nd encoder after the first encoder, from the connector point of view;
1015    uint16_t encoder_recordoffset;
1016    uint16_t extencoder_recordoffset;
1017    uint16_t device_tag;                     //a supported device vector, each display path starts with this.the paths are enumerated in the way of priority, a path appears first
1018    uint8_t  priority_id;
1019    uint8_t  reserved;
1020  };
1021  
1022  struct atom_display_object_path_v3 {
1023  	uint16_t display_objid; //Connector Object ID or Misc Object ID
1024  	uint16_t disp_recordoffset;
1025  	uint16_t encoderobjid; //first encoder closer to the connector, could be either an external or intenal encoder
1026  	uint16_t reserved1; //only on USBC case, otherwise always = 0
1027  	uint16_t reserved2; //reserved and always = 0
1028  	uint16_t reserved3; //reserved and always = 0
1029  	//a supported device vector, each display path starts with this.the paths are enumerated in the way of priority,
1030  	//a path appears first
1031  	uint16_t device_tag;
1032  	uint16_t reserved4; //reserved and always = 0
1033  };
1034  
1035  struct display_object_info_table_v1_4
1036  {
1037    struct    atom_common_table_header  table_header;
1038    uint16_t  supporteddevices;
1039    uint8_t   number_of_path;
1040    uint8_t   reserved;
1041    struct    atom_display_object_path_v2 display_path[];   //the real number of this included in the structure is calculated by using the (whole structure size - the header size- number_of_path)/size of atom_display_object_path
1042  };
1043  
1044  struct display_object_info_table_v1_5 {
1045  	struct atom_common_table_header table_header;
1046  	uint16_t supporteddevices;
1047  	uint8_t number_of_path;
1048  	uint8_t reserved;
1049  	// the real number of this included in the structure is calculated by using the
1050  	// (whole structure size - the header size- number_of_path)/size of atom_display_object_path
1051  	struct atom_display_object_path_v3 display_path[];
1052  };
1053  
1054  /*
1055    ***************************************************************************
1056      Data Table dce_info  structure
1057    ***************************************************************************
1058  */
1059  struct atom_display_controller_info_v4_1
1060  {
1061    struct  atom_common_table_header  table_header;
1062    uint32_t display_caps;
1063    uint32_t bootup_dispclk_10khz;
1064    uint16_t dce_refclk_10khz;
1065    uint16_t i2c_engine_refclk_10khz;
1066    uint16_t dvi_ss_percentage;       // in unit of 0.001%
1067    uint16_t dvi_ss_rate_10hz;
1068    uint16_t hdmi_ss_percentage;      // in unit of 0.001%
1069    uint16_t hdmi_ss_rate_10hz;
1070    uint16_t dp_ss_percentage;        // in unit of 0.001%
1071    uint16_t dp_ss_rate_10hz;
1072    uint8_t  dvi_ss_mode;             // enum of atom_spread_spectrum_mode
1073    uint8_t  hdmi_ss_mode;            // enum of atom_spread_spectrum_mode
1074    uint8_t  dp_ss_mode;              // enum of atom_spread_spectrum_mode
1075    uint8_t  ss_reserved;
1076    uint8_t  hardcode_mode_num;       // a hardcode mode number defined in StandardVESA_TimingTable when a CRT or DFP EDID is not available
1077    uint8_t  reserved1[3];
1078    uint16_t dpphy_refclk_10khz;
1079    uint16_t reserved2;
1080    uint8_t  dceip_min_ver;
1081    uint8_t  dceip_max_ver;
1082    uint8_t  max_disp_pipe_num;
1083    uint8_t  max_vbios_active_disp_pipe_num;
1084    uint8_t  max_ppll_num;
1085    uint8_t  max_disp_phy_num;
1086    uint8_t  max_aux_pairs;
1087    uint8_t  remotedisplayconfig;
1088    uint8_t  reserved3[8];
1089  };
1090  
1091  struct atom_display_controller_info_v4_2
1092  {
1093    struct  atom_common_table_header  table_header;
1094    uint32_t display_caps;
1095    uint32_t bootup_dispclk_10khz;
1096    uint16_t dce_refclk_10khz;
1097    uint16_t i2c_engine_refclk_10khz;
1098    uint16_t dvi_ss_percentage;       // in unit of 0.001%
1099    uint16_t dvi_ss_rate_10hz;
1100    uint16_t hdmi_ss_percentage;      // in unit of 0.001%
1101    uint16_t hdmi_ss_rate_10hz;
1102    uint16_t dp_ss_percentage;        // in unit of 0.001%
1103    uint16_t dp_ss_rate_10hz;
1104    uint8_t  dvi_ss_mode;             // enum of atom_spread_spectrum_mode
1105    uint8_t  hdmi_ss_mode;            // enum of atom_spread_spectrum_mode
1106    uint8_t  dp_ss_mode;              // enum of atom_spread_spectrum_mode
1107    uint8_t  ss_reserved;
1108    uint8_t  dfp_hardcode_mode_num;   // DFP hardcode mode number defined in StandardVESA_TimingTable when EDID is not available
1109    uint8_t  dfp_hardcode_refreshrate;// DFP hardcode mode refreshrate defined in StandardVESA_TimingTable when EDID is not available
1110    uint8_t  vga_hardcode_mode_num;   // VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1111    uint8_t  vga_hardcode_refreshrate;// VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1112    uint16_t dpphy_refclk_10khz;
1113    uint16_t reserved2;
1114    uint8_t  dcnip_min_ver;
1115    uint8_t  dcnip_max_ver;
1116    uint8_t  max_disp_pipe_num;
1117    uint8_t  max_vbios_active_disp_pipe_num;
1118    uint8_t  max_ppll_num;
1119    uint8_t  max_disp_phy_num;
1120    uint8_t  max_aux_pairs;
1121    uint8_t  remotedisplayconfig;
1122    uint8_t  reserved3[8];
1123  };
1124  
1125  struct atom_display_controller_info_v4_3
1126  {
1127    struct  atom_common_table_header  table_header;
1128    uint32_t display_caps;
1129    uint32_t bootup_dispclk_10khz;
1130    uint16_t dce_refclk_10khz;
1131    uint16_t i2c_engine_refclk_10khz;
1132    uint16_t dvi_ss_percentage;       // in unit of 0.001%
1133    uint16_t dvi_ss_rate_10hz;
1134    uint16_t hdmi_ss_percentage;      // in unit of 0.001%
1135    uint16_t hdmi_ss_rate_10hz;
1136    uint16_t dp_ss_percentage;        // in unit of 0.001%
1137    uint16_t dp_ss_rate_10hz;
1138    uint8_t  dvi_ss_mode;             // enum of atom_spread_spectrum_mode
1139    uint8_t  hdmi_ss_mode;            // enum of atom_spread_spectrum_mode
1140    uint8_t  dp_ss_mode;              // enum of atom_spread_spectrum_mode
1141    uint8_t  ss_reserved;
1142    uint8_t  dfp_hardcode_mode_num;   // DFP hardcode mode number defined in StandardVESA_TimingTable when EDID is not available
1143    uint8_t  dfp_hardcode_refreshrate;// DFP hardcode mode refreshrate defined in StandardVESA_TimingTable when EDID is not available
1144    uint8_t  vga_hardcode_mode_num;   // VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1145    uint8_t  vga_hardcode_refreshrate;// VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1146    uint16_t dpphy_refclk_10khz;
1147    uint16_t reserved2;
1148    uint8_t  dcnip_min_ver;
1149    uint8_t  dcnip_max_ver;
1150    uint8_t  max_disp_pipe_num;
1151    uint8_t  max_vbios_active_disp_pipe_num;
1152    uint8_t  max_ppll_num;
1153    uint8_t  max_disp_phy_num;
1154    uint8_t  max_aux_pairs;
1155    uint8_t  remotedisplayconfig;
1156    uint8_t  reserved3[8];
1157  };
1158  
1159  struct atom_display_controller_info_v4_4 {
1160  	struct atom_common_table_header table_header;
1161  	uint32_t display_caps;
1162  	uint32_t bootup_dispclk_10khz;
1163  	uint16_t dce_refclk_10khz;
1164  	uint16_t i2c_engine_refclk_10khz;
1165  	uint16_t dvi_ss_percentage;	 // in unit of 0.001%
1166  	uint16_t dvi_ss_rate_10hz;
1167  	uint16_t hdmi_ss_percentage;	 // in unit of 0.001%
1168  	uint16_t hdmi_ss_rate_10hz;
1169  	uint16_t dp_ss_percentage;	 // in unit of 0.001%
1170  	uint16_t dp_ss_rate_10hz;
1171  	uint8_t dvi_ss_mode;		 // enum of atom_spread_spectrum_mode
1172  	uint8_t hdmi_ss_mode;		 // enum of atom_spread_spectrum_mode
1173  	uint8_t dp_ss_mode;		 // enum of atom_spread_spectrum_mode
1174  	uint8_t ss_reserved;
1175  	uint8_t dfp_hardcode_mode_num;	 // DFP hardcode mode number defined in StandardVESA_TimingTable when EDID is not available
1176  	uint8_t dfp_hardcode_refreshrate;// DFP hardcode mode refreshrate defined in StandardVESA_TimingTable when EDID is not available
1177  	uint8_t vga_hardcode_mode_num;	 // VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1178  	uint8_t vga_hardcode_refreshrate;// VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1179  	uint16_t dpphy_refclk_10khz;
1180  	uint16_t hw_chip_id;
1181  	uint8_t dcnip_min_ver;
1182  	uint8_t dcnip_max_ver;
1183  	uint8_t max_disp_pipe_num;
1184  	uint8_t max_vbios_active_disp_pipum;
1185  	uint8_t max_ppll_num;
1186  	uint8_t max_disp_phy_num;
1187  	uint8_t max_aux_pairs;
1188  	uint8_t remotedisplayconfig;
1189  	uint32_t dispclk_pll_vco_freq;
1190  	uint32_t dp_ref_clk_freq;
1191  	uint32_t max_mclk_chg_lat;	 // Worst case blackout duration for a memory clock frequency (p-state) change, units of 100s of ns (0.1 us)
1192  	uint32_t max_sr_exit_lat;	 // Worst case memory self refresh exit time, units of 100ns of ns (0.1us)
1193  	uint32_t max_sr_enter_exit_lat;	 // Worst case memory self refresh entry followed by immediate exit time, units of 100ns of ns (0.1us)
1194  	uint16_t dc_golden_table_offset; // point of struct of atom_dc_golden_table_vxx
1195  	uint16_t dc_golden_table_ver;
1196  	uint32_t reserved3[3];
1197  };
1198  
1199  struct atom_dc_golden_table_v1
1200  {
1201  	uint32_t aux_dphy_rx_control0_val;
1202  	uint32_t aux_dphy_tx_control_val;
1203  	uint32_t aux_dphy_rx_control1_val;
1204  	uint32_t dc_gpio_aux_ctrl_0_val;
1205  	uint32_t dc_gpio_aux_ctrl_1_val;
1206  	uint32_t dc_gpio_aux_ctrl_2_val;
1207  	uint32_t dc_gpio_aux_ctrl_3_val;
1208  	uint32_t dc_gpio_aux_ctrl_4_val;
1209  	uint32_t dc_gpio_aux_ctrl_5_val;
1210  	uint32_t reserved[23];
1211  };
1212  
1213  enum dce_info_caps_def {
1214  	// only for VBIOS
1215  	DCE_INFO_CAPS_FORCE_DISPDEV_CONNECTED = 0x02,
1216  	// only for VBIOS
1217  	DCE_INFO_CAPS_DISABLE_DFP_DP_HBR2 = 0x04,
1218  	// only for VBIOS
1219  	DCE_INFO_CAPS_ENABLE_INTERLAC_TIMING = 0x08,
1220  	// only for VBIOS
1221  	DCE_INFO_CAPS_LTTPR_SUPPORT_ENABLE = 0x20,
1222  	DCE_INFO_CAPS_VBIOS_LTTPR_TRANSPARENT_ENABLE = 0x40,
1223  };
1224  
1225  struct atom_display_controller_info_v4_5
1226  {
1227    struct  atom_common_table_header  table_header;
1228    uint32_t display_caps;
1229    uint32_t bootup_dispclk_10khz;
1230    uint16_t dce_refclk_10khz;
1231    uint16_t i2c_engine_refclk_10khz;
1232    uint16_t dvi_ss_percentage;       // in unit of 0.001%
1233    uint16_t dvi_ss_rate_10hz;
1234    uint16_t hdmi_ss_percentage;      // in unit of 0.001%
1235    uint16_t hdmi_ss_rate_10hz;
1236    uint16_t dp_ss_percentage;        // in unit of 0.001%
1237    uint16_t dp_ss_rate_10hz;
1238    uint8_t  dvi_ss_mode;             // enum of atom_spread_spectrum_mode
1239    uint8_t  hdmi_ss_mode;            // enum of atom_spread_spectrum_mode
1240    uint8_t  dp_ss_mode;              // enum of atom_spread_spectrum_mode
1241    uint8_t  ss_reserved;
1242    // DFP hardcode mode number defined in StandardVESA_TimingTable when EDID is not available
1243    uint8_t  dfp_hardcode_mode_num;
1244    // DFP hardcode mode refreshrate defined in StandardVESA_TimingTable when EDID is not available
1245    uint8_t  dfp_hardcode_refreshrate;
1246    // VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1247    uint8_t  vga_hardcode_mode_num;
1248    // VGA hardcode mode number defined in StandardVESA_TimingTable when EDID is not avablable
1249    uint8_t  vga_hardcode_refreshrate;
1250    uint16_t dpphy_refclk_10khz;
1251    uint16_t hw_chip_id;
1252    uint8_t  dcnip_min_ver;
1253    uint8_t  dcnip_max_ver;
1254    uint8_t  max_disp_pipe_num;
1255    uint8_t  max_vbios_active_disp_pipe_num;
1256    uint8_t  max_ppll_num;
1257    uint8_t  max_disp_phy_num;
1258    uint8_t  max_aux_pairs;
1259    uint8_t  remotedisplayconfig;
1260    uint32_t dispclk_pll_vco_freq;
1261    uint32_t dp_ref_clk_freq;
1262    // Worst case blackout duration for a memory clock frequency (p-state) change, units of 100s of ns (0.1 us)
1263    uint32_t max_mclk_chg_lat;
1264    // Worst case memory self refresh exit time, units of 100ns of ns (0.1us)
1265    uint32_t max_sr_exit_lat;
1266    // Worst case memory self refresh entry followed by immediate exit time, units of 100ns of ns (0.1us)
1267    uint32_t max_sr_enter_exit_lat;
1268    uint16_t dc_golden_table_offset;  // point of struct of atom_dc_golden_table_vxx
1269    uint16_t dc_golden_table_ver;
1270    uint32_t aux_dphy_rx_control0_val;
1271    uint32_t aux_dphy_tx_control_val;
1272    uint32_t aux_dphy_rx_control1_val;
1273    uint32_t dc_gpio_aux_ctrl_0_val;
1274    uint32_t dc_gpio_aux_ctrl_1_val;
1275    uint32_t dc_gpio_aux_ctrl_2_val;
1276    uint32_t dc_gpio_aux_ctrl_3_val;
1277    uint32_t dc_gpio_aux_ctrl_4_val;
1278    uint32_t dc_gpio_aux_ctrl_5_val;
1279    uint32_t reserved[26];
1280  };
1281  
1282  /*
1283    ***************************************************************************
1284      Data Table ATOM_EXTERNAL_DISPLAY_CONNECTION_INFO  structure
1285    ***************************************************************************
1286  */
1287  struct atom_ext_display_path
1288  {
1289    uint16_t  device_tag;                      //A bit vector to show what devices are supported
1290    uint16_t  device_acpi_enum;                //16bit device ACPI id.
1291    uint16_t  connectorobjid;                  //A physical connector for displays to plug in, using object connector definitions
1292    uint8_t   auxddclut_index;                 //An index into external AUX/DDC channel LUT
1293    uint8_t   hpdlut_index;                    //An index into external HPD pin LUT
1294    uint16_t  ext_encoder_objid;               //external encoder object id
1295    uint8_t   channelmapping;                  // if ucChannelMapping=0, using default one to one mapping
1296    uint8_t   chpninvert;                      // bit vector for up to 8 lanes, =0: P and N is not invert, =1 P and N is inverted
1297    uint16_t  caps;
1298    uint16_t  reserved;
1299  };
1300  
1301  //usCaps
1302  enum ext_display_path_cap_def {
1303    EXT_DISPLAY_PATH_CAPS__EXT_CHIP_MASK =		0x007E,
1304    AMD_EXT_DISPLAY_PATH_CAPS__EXT_CHIP_MASK =		0x007E,
1305    AMD_EXT_DISPLAY_PATH_CAPS__DP_FIXED_VS_EN =		(0x01 << 1),
1306    AMD_EXT_DISPLAY_PATH_CAPS__HDMI20_PI3EQX1204 =	(0x02 << 1),
1307    AMD_EXT_DISPLAY_PATH_CAPS__DP_EARLY_8B10B_TPS2 =	(0x03 << 1),
1308    AMD_EXT_DISPLAY_PATH_CAPS__HDMI20_TISN65DP159RSBT =	(0x04 << 1),
1309    AMD_EXT_DISPLAY_PATH_CAPS__HDMI20_PARADE_PS175 =	(0x06 << 1),
1310    EXT_DISPLAY_PATH_CAPS__DP_FIXED_VS_EN =		(0x07 << 1),
1311    EXT_DISPLAY_PATH_CAPS__HDMI20_PI3EQX1204 =		(0x08 << 1),   //PI redriver chip
1312    EXT_DISPLAY_PATH_CAPS__HDMI20_TISN65DP159RSBT =	(0x09 << 1),   //TI retimer chip
1313    EXT_DISPLAY_PATH_CAPS__AMD_INTERNAL =		(0x0a << 1),   //AMD internal customer chip placeholder
1314  };
1315  
1316  struct atom_external_display_connection_info
1317  {
1318    struct  atom_common_table_header  table_header;
1319    uint8_t                  guid[16];                                  // a GUID is a 16 byte long string
1320    struct atom_ext_display_path path[7];                               // total of fixed 7 entries.
1321    uint8_t                  checksum;                                  // a simple Checksum of the sum of whole structure equal to 0x0.
1322    uint8_t                  stereopinid;                               // use for eDP panel
1323    uint8_t                  remotedisplayconfig;
1324    uint8_t                  edptolvdsrxid;
1325    uint8_t                  fixdpvoltageswing;                         // usCaps[1]=1, this indicate DP_LANE_SET value
1326    uint8_t                  reserved[3];                               // for potential expansion
1327  };
1328  
1329  /*
1330    ***************************************************************************
1331      Data Table integratedsysteminfo  structure
1332    ***************************************************************************
1333  */
1334  
1335  struct atom_camera_dphy_timing_param
1336  {
1337    uint8_t  profile_id;       // SENSOR_PROFILES
1338    uint32_t param;
1339  };
1340  
1341  struct atom_camera_dphy_elec_param
1342  {
1343    uint16_t param[3];
1344  };
1345  
1346  struct atom_camera_module_info
1347  {
1348    uint8_t module_id;                    // 0: Rear, 1: Front right of user, 2: Front left of user
1349    uint8_t module_name[8];
1350    struct atom_camera_dphy_timing_param timingparam[6]; // Exact number is under estimation and confirmation from sensor vendor
1351  };
1352  
1353  struct atom_camera_flashlight_info
1354  {
1355    uint8_t flashlight_id;                // 0: Rear, 1: Front
1356    uint8_t name[8];
1357  };
1358  
1359  struct atom_camera_data
1360  {
1361    uint32_t versionCode;
1362    struct atom_camera_module_info cameraInfo[3];      // Assuming 3 camera sensors max
1363    struct atom_camera_flashlight_info flashInfo;      // Assuming 1 flashlight max
1364    struct atom_camera_dphy_elec_param dphy_param;
1365    uint32_t crc_val;         // CRC
1366  };
1367  
1368  
1369  struct atom_14nm_dpphy_dvihdmi_tuningset
1370  {
1371    uint32_t max_symclk_in10khz;
1372    uint8_t encoder_mode;            //atom_encode_mode_def, =2: DVI, =3: HDMI mode
1373    uint8_t phy_sel;                 //bit vector of phy, bit0= phya, bit1=phyb, ....bit5 = phyf
1374    uint16_t margindeemph;           //COMMON_MAR_DEEMPH_NOM[7:0]tx_margin_nom [15:8]deemph_gen1_nom
1375    uint8_t deemph_6db_4;            //COMMON_SELDEEMPH60[31:24]deemph_6db_4
1376    uint8_t boostadj;                //CMD_BUS_GLOBAL_FOR_TX_LANE0 [19:16]tx_boost_adj  [20]tx_boost_en  [23:22]tx_binary_ron_code_offset
1377    uint8_t tx_driver_fifty_ohms;    //COMMON_ZCALCODE_CTRL[21].tx_driver_fifty_ohms
1378    uint8_t deemph_sel;              //MARGIN_DEEMPH_LANE0.DEEMPH_SEL
1379  };
1380  
1381  struct atom_14nm_dpphy_dp_setting{
1382    uint8_t dp_vs_pemph_level;       //enum of atom_dp_vs_preemph_def
1383    uint16_t margindeemph;           //COMMON_MAR_DEEMPH_NOM[7:0]tx_margin_nom [15:8]deemph_gen1_nom
1384    uint8_t deemph_6db_4;            //COMMON_SELDEEMPH60[31:24]deemph_6db_4
1385    uint8_t boostadj;                //CMD_BUS_GLOBAL_FOR_TX_LANE0 [19:16]tx_boost_adj  [20]tx_boost_en  [23:22]tx_binary_ron_code_offset
1386  };
1387  
1388  struct atom_14nm_dpphy_dp_tuningset{
1389    uint8_t phy_sel;                 // bit vector of phy, bit0= phya, bit1=phyb, ....bit5 = phyf
1390    uint8_t version;
1391    uint16_t table_size;             // size of atom_14nm_dpphy_dp_tuningset
1392    uint16_t reserved;
1393    struct atom_14nm_dpphy_dp_setting dptuning[10];
1394  };
1395  
1396  struct atom_14nm_dig_transmitter_info_header_v4_0{
1397    struct  atom_common_table_header  table_header;
1398    uint16_t pcie_phy_tmds_hdmi_macro_settings_offset;     // offset of PCIEPhyTMDSHDMIMacroSettingsTbl
1399    uint16_t uniphy_vs_emph_lookup_table_offset;           // offset of UniphyVSEmphLookUpTbl
1400    uint16_t uniphy_xbar_settings_table_offset;            // offset of UniphyXbarSettingsTbl
1401  };
1402  
1403  struct atom_14nm_combphy_tmds_vs_set
1404  {
1405    uint8_t sym_clk;
1406    uint8_t dig_mode;
1407    uint8_t phy_sel;
1408    uint16_t common_mar_deemph_nom__margin_deemph_val;
1409    uint8_t common_seldeemph60__deemph_6db_4_val;
1410    uint8_t cmd_bus_global_for_tx_lane0__boostadj_val ;
1411    uint8_t common_zcalcode_ctrl__tx_driver_fifty_ohms_val;
1412    uint8_t margin_deemph_lane0__deemph_sel_val;
1413  };
1414  
1415  struct atom_DCN_dpphy_dvihdmi_tuningset
1416  {
1417    uint32_t max_symclk_in10khz;
1418    uint8_t  encoder_mode;           //atom_encode_mode_def, =2: DVI, =3: HDMI mode
1419    uint8_t  phy_sel;                //bit vector of phy, bit0= phya, bit1=phyb, ....bit5 = phyf
1420    uint8_t  tx_eq_main;             // map to RDPCSTX_PHY_FUSE0/1/2/3[5:0](EQ_MAIN)
1421    uint8_t  tx_eq_pre;              // map to RDPCSTX_PHY_FUSE0/1/2/3[11:6](EQ_PRE)
1422    uint8_t  tx_eq_post;             // map to RDPCSTX_PHY_FUSE0/1/2/3[17:12](EQ_POST)
1423    uint8_t  reserved1;
1424    uint8_t  tx_vboost_lvl;          // tx_vboost_lvl, map to RDPCSTX_PHY_CNTL0.RDPCS_PHY_TX_VBOOST_LVL
1425    uint8_t  reserved2;
1426  };
1427  
1428  struct atom_DCN_dpphy_dp_setting{
1429    uint8_t dp_vs_pemph_level;       //enum of atom_dp_vs_preemph_def
1430    uint8_t tx_eq_main;             // map to RDPCSTX_PHY_FUSE0/1/2/3[5:0](EQ_MAIN)
1431    uint8_t tx_eq_pre;              // map to RDPCSTX_PHY_FUSE0/1/2/3[11:6](EQ_PRE)
1432    uint8_t tx_eq_post;             // map to RDPCSTX_PHY_FUSE0/1/2/3[17:12](EQ_POST)
1433    uint8_t tx_vboost_lvl;          // tx_vboost_lvl, map to RDPCSTX_PHY_CNTL0.RDPCS_PHY_TX_VBOOST_LVL
1434  };
1435  
1436  struct atom_DCN_dpphy_dp_tuningset{
1437    uint8_t phy_sel;                 // bit vector of phy, bit0= phya, bit1=phyb, ....bit5 = phyf
1438    uint8_t version;
1439    uint16_t table_size;             // size of atom_14nm_dpphy_dp_setting
1440    uint16_t reserved;
1441    struct atom_DCN_dpphy_dp_setting dptunings[10];
1442  };
1443  
1444  struct atom_i2c_reg_info {
1445    uint8_t ucI2cRegIndex;
1446    uint8_t ucI2cRegVal;
1447  };
1448  
1449  struct atom_hdmi_retimer_redriver_set {
1450    uint8_t HdmiSlvAddr;
1451    uint8_t HdmiRegNum;
1452    uint8_t Hdmi6GRegNum;
1453    struct atom_i2c_reg_info HdmiRegSetting[9];        //For non 6G Hz use
1454    struct atom_i2c_reg_info Hdmi6GhzRegSetting[3];    //For 6G Hz use.
1455  };
1456  
1457  struct atom_integrated_system_info_v1_11
1458  {
1459    struct  atom_common_table_header  table_header;
1460    uint32_t  vbios_misc;                       //enum of atom_system_vbiosmisc_def
1461    uint32_t  gpucapinfo;                       //enum of atom_system_gpucapinf_def
1462    uint32_t  system_config;
1463    uint32_t  cpucapinfo;
1464    uint16_t  gpuclk_ss_percentage;             //unit of 0.001%,   1000 mean 1%
1465    uint16_t  gpuclk_ss_type;
1466    uint16_t  lvds_ss_percentage;               //unit of 0.001%,   1000 mean 1%
1467    uint16_t  lvds_ss_rate_10hz;
1468    uint16_t  hdmi_ss_percentage;               //unit of 0.001%,   1000 mean 1%
1469    uint16_t  hdmi_ss_rate_10hz;
1470    uint16_t  dvi_ss_percentage;                //unit of 0.001%,   1000 mean 1%
1471    uint16_t  dvi_ss_rate_10hz;
1472    uint16_t  dpphy_override;                   // bit vector, enum of atom_sysinfo_dpphy_override_def
1473    uint16_t  lvds_misc;                        // enum of atom_sys_info_lvds_misc_def
1474    uint16_t  backlight_pwm_hz;                 // pwm frequency in hz
1475    uint8_t   memorytype;                       // enum of atom_dmi_t17_mem_type_def, APU memory type indication.
1476    uint8_t   umachannelnumber;                 // number of memory channels
1477    uint8_t   pwr_on_digon_to_de;               /* all pwr sequence numbers below are in uint of 4ms */
1478    uint8_t   pwr_on_de_to_vary_bl;
1479    uint8_t   pwr_down_vary_bloff_to_de;
1480    uint8_t   pwr_down_de_to_digoff;
1481    uint8_t   pwr_off_delay;
1482    uint8_t   pwr_on_vary_bl_to_blon;
1483    uint8_t   pwr_down_bloff_to_vary_bloff;
1484    uint8_t   min_allowed_bl_level;
1485    uint8_t   htc_hyst_limit;
1486    uint8_t   htc_tmp_limit;
1487    uint8_t   reserved1;
1488    uint8_t   reserved2;
1489    struct atom_external_display_connection_info extdispconninfo;
1490    struct atom_14nm_dpphy_dvihdmi_tuningset dvi_tuningset;
1491    struct atom_14nm_dpphy_dvihdmi_tuningset hdmi_tuningset;
1492    struct atom_14nm_dpphy_dvihdmi_tuningset hdmi6g_tuningset;
1493    struct atom_14nm_dpphy_dp_tuningset dp_tuningset;        // rbr 1.62G dp tuning set
1494    struct atom_14nm_dpphy_dp_tuningset dp_hbr3_tuningset;   // HBR3 dp tuning set
1495    struct atom_camera_data  camera_info;
1496    struct atom_hdmi_retimer_redriver_set dp0_retimer_set;   //for DP0
1497    struct atom_hdmi_retimer_redriver_set dp1_retimer_set;   //for DP1
1498    struct atom_hdmi_retimer_redriver_set dp2_retimer_set;   //for DP2
1499    struct atom_hdmi_retimer_redriver_set dp3_retimer_set;   //for DP3
1500    struct atom_14nm_dpphy_dp_tuningset dp_hbr_tuningset;    //hbr 2.7G dp tuning set
1501    struct atom_14nm_dpphy_dp_tuningset dp_hbr2_tuningset;   //hbr2 5.4G dp turnig set
1502    struct atom_14nm_dpphy_dp_tuningset edp_tuningset;       //edp tuning set
1503    uint32_t  reserved[66];
1504  };
1505  
1506  struct atom_integrated_system_info_v1_12
1507  {
1508    struct  atom_common_table_header  table_header;
1509    uint32_t  vbios_misc;                       //enum of atom_system_vbiosmisc_def
1510    uint32_t  gpucapinfo;                       //enum of atom_system_gpucapinf_def
1511    uint32_t  system_config;
1512    uint32_t  cpucapinfo;
1513    uint16_t  gpuclk_ss_percentage;             //unit of 0.001%,   1000 mean 1%
1514    uint16_t  gpuclk_ss_type;
1515    uint16_t  lvds_ss_percentage;               //unit of 0.001%,   1000 mean 1%
1516    uint16_t  lvds_ss_rate_10hz;
1517    uint16_t  hdmi_ss_percentage;               //unit of 0.001%,   1000 mean 1%
1518    uint16_t  hdmi_ss_rate_10hz;
1519    uint16_t  dvi_ss_percentage;                //unit of 0.001%,   1000 mean 1%
1520    uint16_t  dvi_ss_rate_10hz;
1521    uint16_t  dpphy_override;                   // bit vector, enum of atom_sysinfo_dpphy_override_def
1522    uint16_t  lvds_misc;                        // enum of atom_sys_info_lvds_misc_def
1523    uint16_t  backlight_pwm_hz;                 // pwm frequency in hz
1524    uint8_t   memorytype;                       // enum of atom_dmi_t17_mem_type_def, APU memory type indication.
1525    uint8_t   umachannelnumber;                 // number of memory channels
1526    uint8_t   pwr_on_digon_to_de;               // all pwr sequence numbers below are in uint of 4ms //
1527    uint8_t   pwr_on_de_to_vary_bl;
1528    uint8_t   pwr_down_vary_bloff_to_de;
1529    uint8_t   pwr_down_de_to_digoff;
1530    uint8_t   pwr_off_delay;
1531    uint8_t   pwr_on_vary_bl_to_blon;
1532    uint8_t   pwr_down_bloff_to_vary_bloff;
1533    uint8_t   min_allowed_bl_level;
1534    uint8_t   htc_hyst_limit;
1535    uint8_t   htc_tmp_limit;
1536    uint8_t   reserved1;
1537    uint8_t   reserved2;
1538    struct atom_external_display_connection_info extdispconninfo;
1539    struct atom_DCN_dpphy_dvihdmi_tuningset  TMDS_tuningset;
1540    struct atom_DCN_dpphy_dvihdmi_tuningset  hdmiCLK5_tuningset;
1541    struct atom_DCN_dpphy_dvihdmi_tuningset  hdmiCLK8_tuningset;
1542    struct atom_DCN_dpphy_dp_tuningset rbr_tuningset;        // rbr 1.62G dp tuning set
1543    struct atom_DCN_dpphy_dp_tuningset hbr3_tuningset;   // HBR3 dp tuning set
1544    struct atom_camera_data  camera_info;
1545    struct atom_hdmi_retimer_redriver_set dp0_retimer_set;   //for DP0
1546    struct atom_hdmi_retimer_redriver_set dp1_retimer_set;   //for DP1
1547    struct atom_hdmi_retimer_redriver_set dp2_retimer_set;   //for DP2
1548    struct atom_hdmi_retimer_redriver_set dp3_retimer_set;   //for DP3
1549    struct atom_DCN_dpphy_dp_tuningset hbr_tuningset;    //hbr 2.7G dp tuning set
1550    struct atom_DCN_dpphy_dp_tuningset hbr2_tuningset;   //hbr2 5.4G dp turnig set
1551    struct atom_DCN_dpphy_dp_tuningset edp_tunings;       //edp tuning set
1552    struct atom_DCN_dpphy_dvihdmi_tuningset  hdmiCLK6_tuningset;
1553    uint32_t  reserved[63];
1554  };
1555  
1556  struct edp_info_table
1557  {
1558          uint16_t edp_backlight_pwm_hz;
1559          uint16_t edp_ss_percentage;
1560          uint16_t edp_ss_rate_10hz;
1561          uint16_t reserved1;
1562          uint32_t reserved2;
1563          uint8_t  edp_pwr_on_off_delay;
1564          uint8_t  edp_pwr_on_vary_bl_to_blon;
1565          uint8_t  edp_pwr_down_bloff_to_vary_bloff;
1566          uint8_t  edp_panel_bpc;
1567          uint8_t  edp_bootup_bl_level;
1568          uint8_t  reserved3[3];
1569          uint32_t reserved4[3];
1570  };
1571  
1572  struct atom_integrated_system_info_v2_1
1573  {
1574          struct  atom_common_table_header  table_header;
1575          uint32_t  vbios_misc;                       //enum of atom_system_vbiosmisc_def
1576          uint32_t  gpucapinfo;                       //enum of atom_system_gpucapinf_def
1577          uint32_t  system_config;
1578          uint32_t  cpucapinfo;
1579          uint16_t  gpuclk_ss_percentage;             //unit of 0.001%,   1000 mean 1%
1580          uint16_t  gpuclk_ss_type;
1581          uint16_t  dpphy_override;                   // bit vector, enum of atom_sysinfo_dpphy_override_def
1582          uint8_t   memorytype;                       // enum of atom_dmi_t17_mem_type_def, APU memory type indication.
1583          uint8_t   umachannelnumber;                 // number of memory channels
1584          uint8_t   htc_hyst_limit;
1585          uint8_t   htc_tmp_limit;
1586          uint8_t   reserved1;
1587          uint8_t   reserved2;
1588          struct edp_info_table edp1_info;
1589          struct edp_info_table edp2_info;
1590          uint32_t  reserved3[8];
1591          struct atom_external_display_connection_info extdispconninfo;
1592          struct atom_DCN_dpphy_dvihdmi_tuningset  TMDS_tuningset;
1593          struct atom_DCN_dpphy_dvihdmi_tuningset  hdmiCLK5_tuningset; //add clk6
1594          struct atom_DCN_dpphy_dvihdmi_tuningset  hdmiCLK6_tuningset;
1595          struct atom_DCN_dpphy_dvihdmi_tuningset  hdmiCLK8_tuningset;
1596          uint32_t reserved4[6];//reserve 2*sizeof(atom_DCN_dpphy_dvihdmi_tuningset)
1597          struct atom_DCN_dpphy_dp_tuningset rbr_tuningset;        // rbr 1.62G dp tuning set
1598          struct atom_DCN_dpphy_dp_tuningset hbr_tuningset;    //hbr 2.7G dp tuning set
1599          struct atom_DCN_dpphy_dp_tuningset hbr2_tuningset;   //hbr2 5.4G dp turnig set
1600          struct atom_DCN_dpphy_dp_tuningset hbr3_tuningset;   // HBR3 dp tuning set
1601          struct atom_DCN_dpphy_dp_tuningset edp_tunings;       //edp tuning set
1602          uint32_t reserved5[28];//reserve 2*sizeof(atom_DCN_dpphy_dp_tuningset)
1603          struct atom_hdmi_retimer_redriver_set dp0_retimer_set;   //for DP0
1604          struct atom_hdmi_retimer_redriver_set dp1_retimer_set;   //for DP1
1605          struct atom_hdmi_retimer_redriver_set dp2_retimer_set;   //for DP2
1606          struct atom_hdmi_retimer_redriver_set dp3_retimer_set;   //for DP3
1607          uint32_t reserved6[30];// reserve size of(atom_camera_data) for camera_info
1608          uint32_t reserved7[32];
1609  
1610  };
1611  
1612  struct atom_n6_display_phy_tuning_set {
1613  	uint8_t display_signal_type;
1614  	uint8_t phy_sel;
1615  	uint8_t preset_level;
1616  	uint8_t reserved1;
1617  	uint32_t reserved2;
1618  	uint32_t speed_upto;
1619  	uint8_t tx_vboost_level;
1620  	uint8_t tx_vreg_v2i;
1621  	uint8_t tx_vregdrv_byp;
1622  	uint8_t tx_term_cntl;
1623  	uint8_t tx_peak_level;
1624  	uint8_t tx_slew_en;
1625  	uint8_t tx_eq_pre;
1626  	uint8_t tx_eq_main;
1627  	uint8_t tx_eq_post;
1628  	uint8_t tx_en_inv_pre;
1629  	uint8_t tx_en_inv_post;
1630  	uint8_t reserved3;
1631  	uint32_t reserved4;
1632  	uint32_t reserved5;
1633  	uint32_t reserved6;
1634  };
1635  
1636  struct atom_display_phy_tuning_info {
1637  	struct atom_common_table_header table_header;
1638  	struct atom_n6_display_phy_tuning_set disp_phy_tuning[1];
1639  };
1640  
1641  struct atom_integrated_system_info_v2_2
1642  {
1643  	struct  atom_common_table_header  table_header;
1644  	uint32_t  vbios_misc;                       //enum of atom_system_vbiosmisc_def
1645  	uint32_t  gpucapinfo;                       //enum of atom_system_gpucapinf_def
1646  	uint32_t  system_config;
1647  	uint32_t  cpucapinfo;
1648  	uint16_t  gpuclk_ss_percentage;             //unit of 0.001%,   1000 mean 1%
1649  	uint16_t  gpuclk_ss_type;
1650  	uint16_t  dpphy_override;                   // bit vector, enum of atom_sysinfo_dpphy_override_def
1651  	uint8_t   memorytype;                       // enum of atom_dmi_t17_mem_type_def, APU memory type indication.
1652  	uint8_t   umachannelnumber;                 // number of memory channels
1653  	uint8_t   htc_hyst_limit;
1654  	uint8_t   htc_tmp_limit;
1655  	uint8_t   reserved1;
1656  	uint8_t   reserved2;
1657  	struct edp_info_table edp1_info;
1658  	struct edp_info_table edp2_info;
1659  	uint32_t  reserved3[8];
1660  	struct atom_external_display_connection_info extdispconninfo;
1661  
1662  	uint32_t  reserved4[189];
1663  };
1664  
1665  struct uma_carveout_option {
1666    char       optionName[29];        //max length of string is 28chars + '\0'. Current design is for "minimum", "Medium", "High". This makes entire struct size 64bits
1667    uint8_t    memoryCarvedGb;        //memory carved out with setting
1668    uint8_t    memoryRemainingGb;     //memory remaining on system
1669    union {
1670      struct _flags {
1671        uint8_t Auto     : 1;
1672        uint8_t Custom   : 1;
1673        uint8_t Reserved : 6;
1674      } flags;
1675      uint8_t all8;
1676    } uma_carveout_option_flags;
1677  };
1678  
1679  struct atom_integrated_system_info_v2_3 {
1680    struct  atom_common_table_header table_header;
1681    uint32_t  vbios_misc; // enum of atom_system_vbiosmisc_def
1682    uint32_t  gpucapinfo; // enum of atom_system_gpucapinf_def
1683    uint32_t  system_config;
1684    uint32_t  cpucapinfo;
1685    uint16_t  gpuclk_ss_percentage; // unit of 0.001%,   1000 mean 1%
1686    uint16_t  gpuclk_ss_type;
1687    uint16_t  dpphy_override;  // bit vector, enum of atom_sysinfo_dpphy_override_def
1688    uint8_t memorytype;       // enum of atom_dmi_t17_mem_type_def, APU memory type indication.
1689    uint8_t umachannelnumber; // number of memory channels
1690    uint8_t htc_hyst_limit;
1691    uint8_t htc_tmp_limit;
1692    uint8_t reserved1; // dp_ss_control
1693    uint8_t gpu_package_id;
1694    struct  edp_info_table  edp1_info;
1695    struct  edp_info_table  edp2_info;
1696    uint32_t  reserved2[8];
1697    struct  atom_external_display_connection_info extdispconninfo;
1698    uint8_t UMACarveoutVersion;
1699    uint8_t UMACarveoutIndexMax;
1700    uint8_t UMACarveoutTypeDefault;
1701    uint8_t UMACarveoutIndexDefault;
1702    uint8_t UMACarveoutType;           //Auto or Custom
1703    uint8_t UMACarveoutIndex;
1704    struct  uma_carveout_option UMASizeControlOption[20];
1705    uint8_t reserved3[110];
1706  };
1707  
1708  // system_config
1709  enum atom_system_vbiosmisc_def{
1710    INTEGRATED_SYSTEM_INFO__GET_EDID_CALLBACK_FUNC_SUPPORT = 0x01,
1711  };
1712  
1713  
1714  // gpucapinfo
1715  enum atom_system_gpucapinf_def{
1716    SYS_INFO_GPUCAPS__ENABEL_DFS_BYPASS  = 0x10,
1717  };
1718  
1719  //dpphy_override
1720  enum atom_sysinfo_dpphy_override_def{
1721    ATOM_ENABLE_DVI_TUNINGSET   = 0x01,
1722    ATOM_ENABLE_HDMI_TUNINGSET  = 0x02,
1723    ATOM_ENABLE_HDMI6G_TUNINGSET  = 0x04,
1724    ATOM_ENABLE_DP_TUNINGSET  = 0x08,
1725    ATOM_ENABLE_DP_HBR3_TUNINGSET  = 0x10,
1726  };
1727  
1728  //lvds_misc
1729  enum atom_sys_info_lvds_misc_def
1730  {
1731    SYS_INFO_LVDS_MISC_888_FPDI_MODE                 =0x01,
1732    SYS_INFO_LVDS_MISC_888_BPC_MODE                  =0x04,
1733    SYS_INFO_LVDS_MISC_OVERRIDE_EN                   =0x08,
1734  };
1735  
1736  
1737  //memorytype  DMI Type 17 offset 12h - Memory Type
1738  enum atom_dmi_t17_mem_type_def{
1739    OtherMemType = 0x01,                                  ///< Assign 01 to Other
1740    UnknownMemType,                                       ///< Assign 02 to Unknown
1741    DramMemType,                                          ///< Assign 03 to DRAM
1742    EdramMemType,                                         ///< Assign 04 to EDRAM
1743    VramMemType,                                          ///< Assign 05 to VRAM
1744    SramMemType,                                          ///< Assign 06 to SRAM
1745    RamMemType,                                           ///< Assign 07 to RAM
1746    RomMemType,                                           ///< Assign 08 to ROM
1747    FlashMemType,                                         ///< Assign 09 to Flash
1748    EepromMemType,                                        ///< Assign 10 to EEPROM
1749    FepromMemType,                                        ///< Assign 11 to FEPROM
1750    EpromMemType,                                         ///< Assign 12 to EPROM
1751    CdramMemType,                                         ///< Assign 13 to CDRAM
1752    ThreeDramMemType,                                     ///< Assign 14 to 3DRAM
1753    SdramMemType,                                         ///< Assign 15 to SDRAM
1754    SgramMemType,                                         ///< Assign 16 to SGRAM
1755    RdramMemType,                                         ///< Assign 17 to RDRAM
1756    DdrMemType,                                           ///< Assign 18 to DDR
1757    Ddr2MemType,                                          ///< Assign 19 to DDR2
1758    Ddr2FbdimmMemType,                                    ///< Assign 20 to DDR2 FB-DIMM
1759    Ddr3MemType = 0x18,                                   ///< Assign 24 to DDR3
1760    Fbd2MemType,                                          ///< Assign 25 to FBD2
1761    Ddr4MemType,                                          ///< Assign 26 to DDR4
1762    LpDdrMemType,                                         ///< Assign 27 to LPDDR
1763    LpDdr2MemType,                                        ///< Assign 28 to LPDDR2
1764    LpDdr3MemType,                                        ///< Assign 29 to LPDDR3
1765    LpDdr4MemType,                                        ///< Assign 30 to LPDDR4
1766    GDdr6MemType,                                         ///< Assign 31 to GDDR6
1767    HbmMemType,                                           ///< Assign 32 to HBM
1768    Hbm2MemType,                                          ///< Assign 33 to HBM2
1769    Ddr5MemType,                                          ///< Assign 34 to DDR5
1770    LpDdr5MemType,                                        ///< Assign 35 to LPDDR5
1771  };
1772  
1773  
1774  // this Table is used starting from NL/AM, used by SBIOS and pass the IntegratedSystemInfoTable/PowerPlayInfoTable/SystemCameraInfoTable
1775  struct atom_fusion_system_info_v4
1776  {
1777    struct atom_integrated_system_info_v1_11   sysinfo;           // refer to ATOM_INTEGRATED_SYSTEM_INFO_V1_8 definition
1778    uint32_t   powerplayinfo[256];                                // Reserve 1024 bytes space for PowerPlayInfoTable
1779  };
1780  
1781  
1782  /*
1783    ***************************************************************************
1784      Data Table gfx_info  structure
1785    ***************************************************************************
1786  */
1787  
1788  struct  atom_gfx_info_v2_2
1789  {
1790    struct  atom_common_table_header  table_header;
1791    uint8_t gfxip_min_ver;
1792    uint8_t gfxip_max_ver;
1793    uint8_t max_shader_engines;
1794    uint8_t max_tile_pipes;
1795    uint8_t max_cu_per_sh;
1796    uint8_t max_sh_per_se;
1797    uint8_t max_backends_per_se;
1798    uint8_t max_texture_channel_caches;
1799    uint32_t regaddr_cp_dma_src_addr;
1800    uint32_t regaddr_cp_dma_src_addr_hi;
1801    uint32_t regaddr_cp_dma_dst_addr;
1802    uint32_t regaddr_cp_dma_dst_addr_hi;
1803    uint32_t regaddr_cp_dma_command;
1804    uint32_t regaddr_cp_status;
1805    uint32_t regaddr_rlc_gpu_clock_32;
1806    uint32_t rlc_gpu_timer_refclk;
1807  };
1808  
1809  struct  atom_gfx_info_v2_3 {
1810    struct  atom_common_table_header  table_header;
1811    uint8_t gfxip_min_ver;
1812    uint8_t gfxip_max_ver;
1813    uint8_t max_shader_engines;
1814    uint8_t max_tile_pipes;
1815    uint8_t max_cu_per_sh;
1816    uint8_t max_sh_per_se;
1817    uint8_t max_backends_per_se;
1818    uint8_t max_texture_channel_caches;
1819    uint32_t regaddr_cp_dma_src_addr;
1820    uint32_t regaddr_cp_dma_src_addr_hi;
1821    uint32_t regaddr_cp_dma_dst_addr;
1822    uint32_t regaddr_cp_dma_dst_addr_hi;
1823    uint32_t regaddr_cp_dma_command;
1824    uint32_t regaddr_cp_status;
1825    uint32_t regaddr_rlc_gpu_clock_32;
1826    uint32_t rlc_gpu_timer_refclk;
1827    uint8_t active_cu_per_sh;
1828    uint8_t active_rb_per_se;
1829    uint16_t gcgoldenoffset;
1830    uint32_t rm21_sram_vmin_value;
1831  };
1832  
1833  struct  atom_gfx_info_v2_4
1834  {
1835    struct  atom_common_table_header  table_header;
1836    uint8_t gfxip_min_ver;
1837    uint8_t gfxip_max_ver;
1838    uint8_t max_shader_engines;
1839    uint8_t reserved;
1840    uint8_t max_cu_per_sh;
1841    uint8_t max_sh_per_se;
1842    uint8_t max_backends_per_se;
1843    uint8_t max_texture_channel_caches;
1844    uint32_t regaddr_cp_dma_src_addr;
1845    uint32_t regaddr_cp_dma_src_addr_hi;
1846    uint32_t regaddr_cp_dma_dst_addr;
1847    uint32_t regaddr_cp_dma_dst_addr_hi;
1848    uint32_t regaddr_cp_dma_command;
1849    uint32_t regaddr_cp_status;
1850    uint32_t regaddr_rlc_gpu_clock_32;
1851    uint32_t rlc_gpu_timer_refclk;
1852    uint8_t active_cu_per_sh;
1853    uint8_t active_rb_per_se;
1854    uint16_t gcgoldenoffset;
1855    uint16_t gc_num_gprs;
1856    uint16_t gc_gsprim_buff_depth;
1857    uint16_t gc_parameter_cache_depth;
1858    uint16_t gc_wave_size;
1859    uint16_t gc_max_waves_per_simd;
1860    uint16_t gc_lds_size;
1861    uint8_t gc_num_max_gs_thds;
1862    uint8_t gc_gs_table_depth;
1863    uint8_t gc_double_offchip_lds_buffer;
1864    uint8_t gc_max_scratch_slots_per_cu;
1865    uint32_t sram_rm_fuses_val;
1866    uint32_t sram_custom_rm_fuses_val;
1867  };
1868  
1869  struct atom_gfx_info_v2_7 {
1870  	struct atom_common_table_header table_header;
1871  	uint8_t gfxip_min_ver;
1872  	uint8_t gfxip_max_ver;
1873  	uint8_t max_shader_engines;
1874  	uint8_t reserved;
1875  	uint8_t max_cu_per_sh;
1876  	uint8_t max_sh_per_se;
1877  	uint8_t max_backends_per_se;
1878  	uint8_t max_texture_channel_caches;
1879  	uint32_t regaddr_cp_dma_src_addr;
1880  	uint32_t regaddr_cp_dma_src_addr_hi;
1881  	uint32_t regaddr_cp_dma_dst_addr;
1882  	uint32_t regaddr_cp_dma_dst_addr_hi;
1883  	uint32_t regaddr_cp_dma_command;
1884  	uint32_t regaddr_cp_status;
1885  	uint32_t regaddr_rlc_gpu_clock_32;
1886  	uint32_t rlc_gpu_timer_refclk;
1887  	uint8_t active_cu_per_sh;
1888  	uint8_t active_rb_per_se;
1889  	uint16_t gcgoldenoffset;
1890  	uint16_t gc_num_gprs;
1891  	uint16_t gc_gsprim_buff_depth;
1892  	uint16_t gc_parameter_cache_depth;
1893  	uint16_t gc_wave_size;
1894  	uint16_t gc_max_waves_per_simd;
1895  	uint16_t gc_lds_size;
1896  	uint8_t gc_num_max_gs_thds;
1897  	uint8_t gc_gs_table_depth;
1898  	uint8_t gc_double_offchip_lds_buffer;
1899  	uint8_t gc_max_scratch_slots_per_cu;
1900  	uint32_t sram_rm_fuses_val;
1901  	uint32_t sram_custom_rm_fuses_val;
1902  	uint8_t cut_cu;
1903  	uint8_t active_cu_total;
1904  	uint8_t cu_reserved[2];
1905  	uint32_t gc_config;
1906  	uint8_t inactive_cu_per_se[8];
1907  	uint32_t reserved2[6];
1908  };
1909  
1910  struct atom_gfx_info_v3_0 {
1911  	struct atom_common_table_header table_header;
1912  	uint8_t gfxip_min_ver;
1913  	uint8_t gfxip_max_ver;
1914  	uint8_t max_shader_engines;
1915  	uint8_t max_tile_pipes;
1916  	uint8_t max_cu_per_sh;
1917  	uint8_t max_sh_per_se;
1918  	uint8_t max_backends_per_se;
1919  	uint8_t max_texture_channel_caches;
1920  	uint32_t regaddr_lsdma_queue0_rb_rptr;
1921  	uint32_t regaddr_lsdma_queue0_rb_rptr_hi;
1922  	uint32_t regaddr_lsdma_queue0_rb_wptr;
1923  	uint32_t regaddr_lsdma_queue0_rb_wptr_hi;
1924  	uint32_t regaddr_lsdma_command;
1925  	uint32_t regaddr_lsdma_status;
1926  	uint32_t regaddr_golden_tsc_count_lower;
1927  	uint32_t golden_tsc_count_lower_refclk;
1928  	uint8_t active_wgp_per_se;
1929  	uint8_t active_rb_per_se;
1930  	uint8_t active_se;
1931  	uint8_t reserved1;
1932  	uint32_t sram_rm_fuses_val;
1933  	uint32_t sram_custom_rm_fuses_val;
1934  	uint32_t inactive_sa_mask;
1935  	uint32_t gc_config;
1936  	uint8_t inactive_wgp[16];
1937  	uint8_t inactive_rb[16];
1938  	uint32_t gdfll_as_wait_ctrl_val;
1939  	uint32_t gdfll_as_step_ctrl_val;
1940  	uint32_t reserved[8];
1941  };
1942  
1943  /*
1944    ***************************************************************************
1945      Data Table smu_info  structure
1946    ***************************************************************************
1947  */
1948  struct atom_smu_info_v3_1
1949  {
1950    struct  atom_common_table_header  table_header;
1951    uint8_t smuip_min_ver;
1952    uint8_t smuip_max_ver;
1953    uint8_t smu_rsd1;
1954    uint8_t gpuclk_ss_mode;           // enum of atom_spread_spectrum_mode
1955    uint16_t sclk_ss_percentage;
1956    uint16_t sclk_ss_rate_10hz;
1957    uint16_t gpuclk_ss_percentage;    // in unit of 0.001%
1958    uint16_t gpuclk_ss_rate_10hz;
1959    uint32_t core_refclk_10khz;
1960    uint8_t  ac_dc_gpio_bit;          // GPIO bit shift in SMU_GPIOPAD_A  configured for AC/DC switching, =0xff means invalid
1961    uint8_t  ac_dc_polarity;          // GPIO polarity for AC/DC switching
1962    uint8_t  vr0hot_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A  configured for VR0 HOT event, =0xff means invalid
1963    uint8_t  vr0hot_polarity;         // GPIO polarity for VR0 HOT event
1964    uint8_t  vr1hot_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A configured for VR1 HOT event , =0xff means invalid
1965    uint8_t  vr1hot_polarity;         // GPIO polarity for VR1 HOT event
1966    uint8_t  fw_ctf_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A configured for CTF, =0xff means invalid
1967    uint8_t  fw_ctf_polarity;         // GPIO polarity for CTF
1968  };
1969  
1970  struct atom_smu_info_v3_2 {
1971    struct   atom_common_table_header  table_header;
1972    uint8_t  smuip_min_ver;
1973    uint8_t  smuip_max_ver;
1974    uint8_t  smu_rsd1;
1975    uint8_t  gpuclk_ss_mode;
1976    uint16_t sclk_ss_percentage;
1977    uint16_t sclk_ss_rate_10hz;
1978    uint16_t gpuclk_ss_percentage;    // in unit of 0.001%
1979    uint16_t gpuclk_ss_rate_10hz;
1980    uint32_t core_refclk_10khz;
1981    uint8_t  ac_dc_gpio_bit;          // GPIO bit shift in SMU_GPIOPAD_A  configured for AC/DC switching, =0xff means invalid
1982    uint8_t  ac_dc_polarity;          // GPIO polarity for AC/DC switching
1983    uint8_t  vr0hot_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A  configured for VR0 HOT event, =0xff means invalid
1984    uint8_t  vr0hot_polarity;         // GPIO polarity for VR0 HOT event
1985    uint8_t  vr1hot_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A configured for VR1 HOT event , =0xff means invalid
1986    uint8_t  vr1hot_polarity;         // GPIO polarity for VR1 HOT event
1987    uint8_t  fw_ctf_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A configured for CTF, =0xff means invalid
1988    uint8_t  fw_ctf_polarity;         // GPIO polarity for CTF
1989    uint8_t  pcc_gpio_bit;            // GPIO bit shift in SMU_GPIOPAD_A configured for PCC, =0xff means invalid
1990    uint8_t  pcc_gpio_polarity;       // GPIO polarity for CTF
1991    uint16_t smugoldenoffset;
1992    uint32_t gpupll_vco_freq_10khz;
1993    uint32_t bootup_smnclk_10khz;
1994    uint32_t bootup_socclk_10khz;
1995    uint32_t bootup_mp0clk_10khz;
1996    uint32_t bootup_mp1clk_10khz;
1997    uint32_t bootup_lclk_10khz;
1998    uint32_t bootup_dcefclk_10khz;
1999    uint32_t ctf_threshold_override_value;
2000    uint32_t reserved[5];
2001  };
2002  
2003  struct atom_smu_info_v3_3 {
2004    struct   atom_common_table_header  table_header;
2005    uint8_t  smuip_min_ver;
2006    uint8_t  smuip_max_ver;
2007    uint8_t  waflclk_ss_mode;
2008    uint8_t  gpuclk_ss_mode;
2009    uint16_t sclk_ss_percentage;
2010    uint16_t sclk_ss_rate_10hz;
2011    uint16_t gpuclk_ss_percentage;    // in unit of 0.001%
2012    uint16_t gpuclk_ss_rate_10hz;
2013    uint32_t core_refclk_10khz;
2014    uint8_t  ac_dc_gpio_bit;          // GPIO bit shift in SMU_GPIOPAD_A  configured for AC/DC switching, =0xff means invalid
2015    uint8_t  ac_dc_polarity;          // GPIO polarity for AC/DC switching
2016    uint8_t  vr0hot_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A  configured for VR0 HOT event, =0xff means invalid
2017    uint8_t  vr0hot_polarity;         // GPIO polarity for VR0 HOT event
2018    uint8_t  vr1hot_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A configured for VR1 HOT event , =0xff means invalid
2019    uint8_t  vr1hot_polarity;         // GPIO polarity for VR1 HOT event
2020    uint8_t  fw_ctf_gpio_bit;         // GPIO bit shift in SMU_GPIOPAD_A configured for CTF, =0xff means invalid
2021    uint8_t  fw_ctf_polarity;         // GPIO polarity for CTF
2022    uint8_t  pcc_gpio_bit;            // GPIO bit shift in SMU_GPIOPAD_A configured for PCC, =0xff means invalid
2023    uint8_t  pcc_gpio_polarity;       // GPIO polarity for CTF
2024    uint16_t smugoldenoffset;
2025    uint32_t gpupll_vco_freq_10khz;
2026    uint32_t bootup_smnclk_10khz;
2027    uint32_t bootup_socclk_10khz;
2028    uint32_t bootup_mp0clk_10khz;
2029    uint32_t bootup_mp1clk_10khz;
2030    uint32_t bootup_lclk_10khz;
2031    uint32_t bootup_dcefclk_10khz;
2032    uint32_t ctf_threshold_override_value;
2033    uint32_t syspll3_0_vco_freq_10khz;
2034    uint32_t syspll3_1_vco_freq_10khz;
2035    uint32_t bootup_fclk_10khz;
2036    uint32_t bootup_waflclk_10khz;
2037    uint32_t smu_info_caps;
2038    uint16_t waflclk_ss_percentage;    // in unit of 0.001%
2039    uint16_t smuinitoffset;
2040    uint32_t reserved;
2041  };
2042  
2043  struct atom_smu_info_v3_5
2044  {
2045    struct   atom_common_table_header  table_header;
2046    uint8_t  smuip_min_ver;
2047    uint8_t  smuip_max_ver;
2048    uint8_t  waflclk_ss_mode;
2049    uint8_t  gpuclk_ss_mode;
2050    uint16_t sclk_ss_percentage;
2051    uint16_t sclk_ss_rate_10hz;
2052    uint16_t gpuclk_ss_percentage;    // in unit of 0.001%
2053    uint16_t gpuclk_ss_rate_10hz;
2054    uint32_t core_refclk_10khz;
2055    uint32_t syspll0_1_vco_freq_10khz;
2056    uint32_t syspll0_2_vco_freq_10khz;
2057    uint8_t  pcc_gpio_bit;            // GPIO bit shift in SMU_GPIOPAD_A configured for PCC, =0xff means invalid
2058    uint8_t  pcc_gpio_polarity;       // GPIO polarity for CTF
2059    uint16_t smugoldenoffset;
2060    uint32_t syspll0_0_vco_freq_10khz;
2061    uint32_t bootup_smnclk_10khz;
2062    uint32_t bootup_socclk_10khz;
2063    uint32_t bootup_mp0clk_10khz;
2064    uint32_t bootup_mp1clk_10khz;
2065    uint32_t bootup_lclk_10khz;
2066    uint32_t bootup_dcefclk_10khz;
2067    uint32_t ctf_threshold_override_value;
2068    uint32_t syspll3_0_vco_freq_10khz;
2069    uint32_t syspll3_1_vco_freq_10khz;
2070    uint32_t bootup_fclk_10khz;
2071    uint32_t bootup_waflclk_10khz;
2072    uint32_t smu_info_caps;
2073    uint16_t waflclk_ss_percentage;    // in unit of 0.001%
2074    uint16_t smuinitoffset;
2075    uint32_t bootup_dprefclk_10khz;
2076    uint32_t bootup_usbclk_10khz;
2077    uint32_t smb_slave_address;
2078    uint32_t cg_fdo_ctrl0_val;
2079    uint32_t cg_fdo_ctrl1_val;
2080    uint32_t cg_fdo_ctrl2_val;
2081    uint32_t gdfll_as_wait_ctrl_val;
2082    uint32_t gdfll_as_step_ctrl_val;
2083    uint32_t bootup_dtbclk_10khz;
2084    uint32_t fclk_syspll_refclk_10khz;
2085    uint32_t smusvi_svc0_val;
2086    uint32_t smusvi_svc1_val;
2087    uint32_t smusvi_svd0_val;
2088    uint32_t smusvi_svd1_val;
2089    uint32_t smusvi_svt0_val;
2090    uint32_t smusvi_svt1_val;
2091    uint32_t cg_tach_ctrl_val;
2092    uint32_t cg_pump_ctrl1_val;
2093    uint32_t cg_pump_tach_ctrl_val;
2094    uint32_t thm_ctf_delay_val;
2095    uint32_t thm_thermal_int_ctrl_val;
2096    uint32_t thm_tmon_config_val;
2097    uint32_t reserved[16];
2098  };
2099  
2100  struct atom_smu_info_v3_6
2101  {
2102  	struct   atom_common_table_header  table_header;
2103  	uint8_t  smuip_min_ver;
2104  	uint8_t  smuip_max_ver;
2105  	uint8_t  waflclk_ss_mode;
2106  	uint8_t  gpuclk_ss_mode;
2107  	uint16_t sclk_ss_percentage;
2108  	uint16_t sclk_ss_rate_10hz;
2109  	uint16_t gpuclk_ss_percentage;
2110  	uint16_t gpuclk_ss_rate_10hz;
2111  	uint32_t core_refclk_10khz;
2112  	uint32_t syspll0_1_vco_freq_10khz;
2113  	uint32_t syspll0_2_vco_freq_10khz;
2114  	uint8_t  pcc_gpio_bit;
2115  	uint8_t  pcc_gpio_polarity;
2116  	uint16_t smugoldenoffset;
2117  	uint32_t syspll0_0_vco_freq_10khz;
2118  	uint32_t bootup_smnclk_10khz;
2119  	uint32_t bootup_socclk_10khz;
2120  	uint32_t bootup_mp0clk_10khz;
2121  	uint32_t bootup_mp1clk_10khz;
2122  	uint32_t bootup_lclk_10khz;
2123  	uint32_t bootup_dxioclk_10khz;
2124  	uint32_t ctf_threshold_override_value;
2125  	uint32_t syspll3_0_vco_freq_10khz;
2126  	uint32_t syspll3_1_vco_freq_10khz;
2127  	uint32_t bootup_fclk_10khz;
2128  	uint32_t bootup_waflclk_10khz;
2129  	uint32_t smu_info_caps;
2130  	uint16_t waflclk_ss_percentage;
2131  	uint16_t smuinitoffset;
2132  	uint32_t bootup_gfxavsclk_10khz;
2133  	uint32_t bootup_mpioclk_10khz;
2134  	uint32_t smb_slave_address;
2135  	uint32_t cg_fdo_ctrl0_val;
2136  	uint32_t cg_fdo_ctrl1_val;
2137  	uint32_t cg_fdo_ctrl2_val;
2138  	uint32_t gdfll_as_wait_ctrl_val;
2139  	uint32_t gdfll_as_step_ctrl_val;
2140  	uint32_t reserved_clk;
2141  	uint32_t fclk_syspll_refclk_10khz;
2142  	uint32_t smusvi_svc0_val;
2143  	uint32_t smusvi_svc1_val;
2144  	uint32_t smusvi_svd0_val;
2145  	uint32_t smusvi_svd1_val;
2146  	uint32_t smusvi_svt0_val;
2147  	uint32_t smusvi_svt1_val;
2148  	uint32_t cg_tach_ctrl_val;
2149  	uint32_t cg_pump_ctrl1_val;
2150  	uint32_t cg_pump_tach_ctrl_val;
2151  	uint32_t thm_ctf_delay_val;
2152  	uint32_t thm_thermal_int_ctrl_val;
2153  	uint32_t thm_tmon_config_val;
2154  	uint32_t bootup_vclk_10khz;
2155  	uint32_t bootup_dclk_10khz;
2156  	uint32_t smu_gpiopad_pu_en_val;
2157  	uint32_t smu_gpiopad_pd_en_val;
2158  	uint32_t reserved[12];
2159  };
2160  
2161  struct atom_smu_info_v4_0 {
2162  	struct atom_common_table_header table_header;
2163  	uint32_t bootup_gfxclk_bypass_10khz;
2164  	uint32_t bootup_usrclk_10khz;
2165  	uint32_t bootup_csrclk_10khz;
2166  	uint32_t core_refclk_10khz;
2167  	uint32_t syspll1_vco_freq_10khz;
2168  	uint32_t syspll2_vco_freq_10khz;
2169  	uint8_t pcc_gpio_bit;
2170  	uint8_t pcc_gpio_polarity;
2171  	uint16_t bootup_vddusr_mv;
2172  	uint32_t syspll0_vco_freq_10khz;
2173  	uint32_t bootup_smnclk_10khz;
2174  	uint32_t bootup_socclk_10khz;
2175  	uint32_t bootup_mp0clk_10khz;
2176  	uint32_t bootup_mp1clk_10khz;
2177  	uint32_t bootup_lclk_10khz;
2178  	uint32_t bootup_dcefclk_10khz;
2179  	uint32_t ctf_threshold_override_value;
2180  	uint32_t syspll3_vco_freq_10khz;
2181  	uint32_t mm_syspll_vco_freq_10khz;
2182  	uint32_t bootup_fclk_10khz;
2183  	uint32_t bootup_waflclk_10khz;
2184  	uint32_t smu_info_caps;
2185  	uint16_t waflclk_ss_percentage;
2186  	uint16_t smuinitoffset;
2187  	uint32_t bootup_dprefclk_10khz;
2188  	uint32_t bootup_usbclk_10khz;
2189  	uint32_t smb_slave_address;
2190  	uint32_t cg_fdo_ctrl0_val;
2191  	uint32_t cg_fdo_ctrl1_val;
2192  	uint32_t cg_fdo_ctrl2_val;
2193  	uint32_t gdfll_as_wait_ctrl_val;
2194  	uint32_t gdfll_as_step_ctrl_val;
2195  	uint32_t bootup_dtbclk_10khz;
2196  	uint32_t fclk_syspll_refclk_10khz;
2197  	uint32_t smusvi_svc0_val;
2198  	uint32_t smusvi_svc1_val;
2199  	uint32_t smusvi_svd0_val;
2200  	uint32_t smusvi_svd1_val;
2201  	uint32_t smusvi_svt0_val;
2202  	uint32_t smusvi_svt1_val;
2203  	uint32_t cg_tach_ctrl_val;
2204  	uint32_t cg_pump_ctrl1_val;
2205  	uint32_t cg_pump_tach_ctrl_val;
2206  	uint32_t thm_ctf_delay_val;
2207  	uint32_t thm_thermal_int_ctrl_val;
2208  	uint32_t thm_tmon_config_val;
2209  	uint32_t smbus_timing_cntrl0_val;
2210  	uint32_t smbus_timing_cntrl1_val;
2211  	uint32_t smbus_timing_cntrl2_val;
2212  	uint32_t pwr_disp_timer_global_control_val;
2213  	uint32_t bootup_mpioclk_10khz;
2214  	uint32_t bootup_dclk0_10khz;
2215  	uint32_t bootup_vclk0_10khz;
2216  	uint32_t bootup_dclk1_10khz;
2217  	uint32_t bootup_vclk1_10khz;
2218  	uint32_t bootup_baco400clk_10khz;
2219  	uint32_t bootup_baco1200clk_bypass_10khz;
2220  	uint32_t bootup_baco700clk_bypass_10khz;
2221  	uint32_t reserved[16];
2222  };
2223  
2224  /*
2225   ***************************************************************************
2226     Data Table smc_dpm_info  structure
2227   ***************************************************************************
2228   */
2229  struct atom_smc_dpm_info_v4_1
2230  {
2231    struct   atom_common_table_header  table_header;
2232    uint8_t  liquid1_i2c_address;
2233    uint8_t  liquid2_i2c_address;
2234    uint8_t  vr_i2c_address;
2235    uint8_t  plx_i2c_address;
2236  
2237    uint8_t  liquid_i2c_linescl;
2238    uint8_t  liquid_i2c_linesda;
2239    uint8_t  vr_i2c_linescl;
2240    uint8_t  vr_i2c_linesda;
2241  
2242    uint8_t  plx_i2c_linescl;
2243    uint8_t  plx_i2c_linesda;
2244    uint8_t  vrsensorpresent;
2245    uint8_t  liquidsensorpresent;
2246  
2247    uint16_t maxvoltagestepgfx;
2248    uint16_t maxvoltagestepsoc;
2249  
2250    uint8_t  vddgfxvrmapping;
2251    uint8_t  vddsocvrmapping;
2252    uint8_t  vddmem0vrmapping;
2253    uint8_t  vddmem1vrmapping;
2254  
2255    uint8_t  gfxulvphasesheddingmask;
2256    uint8_t  soculvphasesheddingmask;
2257    uint8_t  padding8_v[2];
2258  
2259    uint16_t gfxmaxcurrent;
2260    uint8_t  gfxoffset;
2261    uint8_t  padding_telemetrygfx;
2262  
2263    uint16_t socmaxcurrent;
2264    uint8_t  socoffset;
2265    uint8_t  padding_telemetrysoc;
2266  
2267    uint16_t mem0maxcurrent;
2268    uint8_t  mem0offset;
2269    uint8_t  padding_telemetrymem0;
2270  
2271    uint16_t mem1maxcurrent;
2272    uint8_t  mem1offset;
2273    uint8_t  padding_telemetrymem1;
2274  
2275    uint8_t  acdcgpio;
2276    uint8_t  acdcpolarity;
2277    uint8_t  vr0hotgpio;
2278    uint8_t  vr0hotpolarity;
2279  
2280    uint8_t  vr1hotgpio;
2281    uint8_t  vr1hotpolarity;
2282    uint8_t  padding1;
2283    uint8_t  padding2;
2284  
2285    uint8_t  ledpin0;
2286    uint8_t  ledpin1;
2287    uint8_t  ledpin2;
2288    uint8_t  padding8_4;
2289  
2290  	uint8_t  pllgfxclkspreadenabled;
2291  	uint8_t  pllgfxclkspreadpercent;
2292  	uint16_t pllgfxclkspreadfreq;
2293  
2294    uint8_t uclkspreadenabled;
2295    uint8_t uclkspreadpercent;
2296    uint16_t uclkspreadfreq;
2297  
2298    uint8_t socclkspreadenabled;
2299    uint8_t socclkspreadpercent;
2300    uint16_t socclkspreadfreq;
2301  
2302  	uint8_t  acggfxclkspreadenabled;
2303  	uint8_t  acggfxclkspreadpercent;
2304  	uint16_t acggfxclkspreadfreq;
2305  
2306  	uint8_t Vr2_I2C_address;
2307  	uint8_t padding_vr2[3];
2308  
2309  	uint32_t boardreserved[9];
2310  };
2311  
2312  /*
2313   ***************************************************************************
2314     Data Table smc_dpm_info  structure
2315   ***************************************************************************
2316   */
2317  struct atom_smc_dpm_info_v4_3
2318  {
2319    struct   atom_common_table_header  table_header;
2320    uint8_t  liquid1_i2c_address;
2321    uint8_t  liquid2_i2c_address;
2322    uint8_t  vr_i2c_address;
2323    uint8_t  plx_i2c_address;
2324  
2325    uint8_t  liquid_i2c_linescl;
2326    uint8_t  liquid_i2c_linesda;
2327    uint8_t  vr_i2c_linescl;
2328    uint8_t  vr_i2c_linesda;
2329  
2330    uint8_t  plx_i2c_linescl;
2331    uint8_t  plx_i2c_linesda;
2332    uint8_t  vrsensorpresent;
2333    uint8_t  liquidsensorpresent;
2334  
2335    uint16_t maxvoltagestepgfx;
2336    uint16_t maxvoltagestepsoc;
2337  
2338    uint8_t  vddgfxvrmapping;
2339    uint8_t  vddsocvrmapping;
2340    uint8_t  vddmem0vrmapping;
2341    uint8_t  vddmem1vrmapping;
2342  
2343    uint8_t  gfxulvphasesheddingmask;
2344    uint8_t  soculvphasesheddingmask;
2345    uint8_t  externalsensorpresent;
2346    uint8_t  padding8_v;
2347  
2348    uint16_t gfxmaxcurrent;
2349    uint8_t  gfxoffset;
2350    uint8_t  padding_telemetrygfx;
2351  
2352    uint16_t socmaxcurrent;
2353    uint8_t  socoffset;
2354    uint8_t  padding_telemetrysoc;
2355  
2356    uint16_t mem0maxcurrent;
2357    uint8_t  mem0offset;
2358    uint8_t  padding_telemetrymem0;
2359  
2360    uint16_t mem1maxcurrent;
2361    uint8_t  mem1offset;
2362    uint8_t  padding_telemetrymem1;
2363  
2364    uint8_t  acdcgpio;
2365    uint8_t  acdcpolarity;
2366    uint8_t  vr0hotgpio;
2367    uint8_t  vr0hotpolarity;
2368  
2369    uint8_t  vr1hotgpio;
2370    uint8_t  vr1hotpolarity;
2371    uint8_t  padding1;
2372    uint8_t  padding2;
2373  
2374    uint8_t  ledpin0;
2375    uint8_t  ledpin1;
2376    uint8_t  ledpin2;
2377    uint8_t  padding8_4;
2378  
2379    uint8_t  pllgfxclkspreadenabled;
2380    uint8_t  pllgfxclkspreadpercent;
2381    uint16_t pllgfxclkspreadfreq;
2382  
2383    uint8_t uclkspreadenabled;
2384    uint8_t uclkspreadpercent;
2385    uint16_t uclkspreadfreq;
2386  
2387    uint8_t fclkspreadenabled;
2388    uint8_t fclkspreadpercent;
2389    uint16_t fclkspreadfreq;
2390  
2391    uint8_t fllgfxclkspreadenabled;
2392    uint8_t fllgfxclkspreadpercent;
2393    uint16_t fllgfxclkspreadfreq;
2394  
2395    uint32_t boardreserved[10];
2396  };
2397  
2398  struct smudpm_i2ccontrollerconfig_t {
2399    uint32_t  enabled;
2400    uint32_t  slaveaddress;
2401    uint32_t  controllerport;
2402    uint32_t  controllername;
2403    uint32_t  thermalthrottler;
2404    uint32_t  i2cprotocol;
2405    uint32_t  i2cspeed;
2406  };
2407  
2408  struct atom_smc_dpm_info_v4_4
2409  {
2410    struct   atom_common_table_header  table_header;
2411    uint32_t  i2c_padding[3];
2412  
2413    uint16_t maxvoltagestepgfx;
2414    uint16_t maxvoltagestepsoc;
2415  
2416    uint8_t  vddgfxvrmapping;
2417    uint8_t  vddsocvrmapping;
2418    uint8_t  vddmem0vrmapping;
2419    uint8_t  vddmem1vrmapping;
2420  
2421    uint8_t  gfxulvphasesheddingmask;
2422    uint8_t  soculvphasesheddingmask;
2423    uint8_t  externalsensorpresent;
2424    uint8_t  padding8_v;
2425  
2426    uint16_t gfxmaxcurrent;
2427    uint8_t  gfxoffset;
2428    uint8_t  padding_telemetrygfx;
2429  
2430    uint16_t socmaxcurrent;
2431    uint8_t  socoffset;
2432    uint8_t  padding_telemetrysoc;
2433  
2434    uint16_t mem0maxcurrent;
2435    uint8_t  mem0offset;
2436    uint8_t  padding_telemetrymem0;
2437  
2438    uint16_t mem1maxcurrent;
2439    uint8_t  mem1offset;
2440    uint8_t  padding_telemetrymem1;
2441  
2442  
2443    uint8_t  acdcgpio;
2444    uint8_t  acdcpolarity;
2445    uint8_t  vr0hotgpio;
2446    uint8_t  vr0hotpolarity;
2447  
2448    uint8_t  vr1hotgpio;
2449    uint8_t  vr1hotpolarity;
2450    uint8_t  padding1;
2451    uint8_t  padding2;
2452  
2453  
2454    uint8_t  ledpin0;
2455    uint8_t  ledpin1;
2456    uint8_t  ledpin2;
2457    uint8_t  padding8_4;
2458  
2459  
2460    uint8_t  pllgfxclkspreadenabled;
2461    uint8_t  pllgfxclkspreadpercent;
2462    uint16_t pllgfxclkspreadfreq;
2463  
2464  
2465    uint8_t  uclkspreadenabled;
2466    uint8_t  uclkspreadpercent;
2467    uint16_t uclkspreadfreq;
2468  
2469  
2470    uint8_t  fclkspreadenabled;
2471    uint8_t  fclkspreadpercent;
2472    uint16_t fclkspreadfreq;
2473  
2474  
2475    uint8_t  fllgfxclkspreadenabled;
2476    uint8_t  fllgfxclkspreadpercent;
2477    uint16_t fllgfxclkspreadfreq;
2478  
2479  
2480    struct smudpm_i2ccontrollerconfig_t  i2ccontrollers[7];
2481  
2482  
2483    uint32_t boardreserved[10];
2484  };
2485  
2486  enum smudpm_v4_5_i2ccontrollername_e{
2487      SMC_V4_5_I2C_CONTROLLER_NAME_VR_GFX = 0,
2488      SMC_V4_5_I2C_CONTROLLER_NAME_VR_SOC,
2489      SMC_V4_5_I2C_CONTROLLER_NAME_VR_VDDCI,
2490      SMC_V4_5_I2C_CONTROLLER_NAME_VR_MVDD,
2491      SMC_V4_5_I2C_CONTROLLER_NAME_LIQUID0,
2492      SMC_V4_5_I2C_CONTROLLER_NAME_LIQUID1,
2493      SMC_V4_5_I2C_CONTROLLER_NAME_PLX,
2494      SMC_V4_5_I2C_CONTROLLER_NAME_SPARE,
2495      SMC_V4_5_I2C_CONTROLLER_NAME_COUNT,
2496  };
2497  
2498  enum smudpm_v4_5_i2ccontrollerthrottler_e{
2499      SMC_V4_5_I2C_CONTROLLER_THROTTLER_TYPE_NONE = 0,
2500      SMC_V4_5_I2C_CONTROLLER_THROTTLER_VR_GFX,
2501      SMC_V4_5_I2C_CONTROLLER_THROTTLER_VR_SOC,
2502      SMC_V4_5_I2C_CONTROLLER_THROTTLER_VR_VDDCI,
2503      SMC_V4_5_I2C_CONTROLLER_THROTTLER_VR_MVDD,
2504      SMC_V4_5_I2C_CONTROLLER_THROTTLER_LIQUID0,
2505      SMC_V4_5_I2C_CONTROLLER_THROTTLER_LIQUID1,
2506      SMC_V4_5_I2C_CONTROLLER_THROTTLER_PLX,
2507      SMC_V4_5_I2C_CONTROLLER_THROTTLER_COUNT,
2508  };
2509  
2510  enum smudpm_v4_5_i2ccontrollerprotocol_e{
2511      SMC_V4_5_I2C_CONTROLLER_PROTOCOL_VR_0,
2512      SMC_V4_5_I2C_CONTROLLER_PROTOCOL_VR_1,
2513      SMC_V4_5_I2C_CONTROLLER_PROTOCOL_TMP_0,
2514      SMC_V4_5_I2C_CONTROLLER_PROTOCOL_TMP_1,
2515      SMC_V4_5_I2C_CONTROLLER_PROTOCOL_SPARE_0,
2516      SMC_V4_5_I2C_CONTROLLER_PROTOCOL_SPARE_1,
2517      SMC_V4_5_I2C_CONTROLLER_PROTOCOL_COUNT,
2518  };
2519  
2520  struct smudpm_i2c_controller_config_v2
2521  {
2522      uint8_t   Enabled;
2523      uint8_t   Speed;
2524      uint8_t   Padding[2];
2525      uint32_t  SlaveAddress;
2526      uint8_t   ControllerPort;
2527      uint8_t   ControllerName;
2528      uint8_t   ThermalThrotter;
2529      uint8_t   I2cProtocol;
2530  };
2531  
2532  struct atom_smc_dpm_info_v4_5
2533  {
2534    struct   atom_common_table_header  table_header;
2535      // SECTION: BOARD PARAMETERS
2536      // I2C Control
2537    struct smudpm_i2c_controller_config_v2  I2cControllers[8];
2538  
2539    // SVI2 Board Parameters
2540    uint16_t     MaxVoltageStepGfx; // In mV(Q2) Max voltage step that SMU will request. Multiple steps are taken if voltage change exceeds this value.
2541    uint16_t     MaxVoltageStepSoc; // In mV(Q2) Max voltage step that SMU will request. Multiple steps are taken if voltage change exceeds this value.
2542  
2543    uint8_t      VddGfxVrMapping;   // Use VR_MAPPING* bitfields
2544    uint8_t      VddSocVrMapping;   // Use VR_MAPPING* bitfields
2545    uint8_t      VddMem0VrMapping;  // Use VR_MAPPING* bitfields
2546    uint8_t      VddMem1VrMapping;  // Use VR_MAPPING* bitfields
2547  
2548    uint8_t      GfxUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2549    uint8_t      SocUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2550    uint8_t      ExternalSensorPresent; // External RDI connected to TMON (aka TEMP IN)
2551    uint8_t      Padding8_V;
2552  
2553    // Telemetry Settings
2554    uint16_t     GfxMaxCurrent;   // in Amps
2555    uint8_t      GfxOffset;       // in Amps
2556    uint8_t      Padding_TelemetryGfx;
2557    uint16_t     SocMaxCurrent;   // in Amps
2558    uint8_t      SocOffset;       // in Amps
2559    uint8_t      Padding_TelemetrySoc;
2560  
2561    uint16_t     Mem0MaxCurrent;   // in Amps
2562    uint8_t      Mem0Offset;       // in Amps
2563    uint8_t      Padding_TelemetryMem0;
2564  
2565    uint16_t     Mem1MaxCurrent;   // in Amps
2566    uint8_t      Mem1Offset;       // in Amps
2567    uint8_t      Padding_TelemetryMem1;
2568  
2569    // GPIO Settings
2570    uint8_t      AcDcGpio;        // GPIO pin configured for AC/DC switching
2571    uint8_t      AcDcPolarity;    // GPIO polarity for AC/DC switching
2572    uint8_t      VR0HotGpio;      // GPIO pin configured for VR0 HOT event
2573    uint8_t      VR0HotPolarity;  // GPIO polarity for VR0 HOT event
2574  
2575    uint8_t      VR1HotGpio;      // GPIO pin configured for VR1 HOT event
2576    uint8_t      VR1HotPolarity;  // GPIO polarity for VR1 HOT event
2577    uint8_t      GthrGpio;        // GPIO pin configured for GTHR Event
2578    uint8_t      GthrPolarity;    // replace GPIO polarity for GTHR
2579  
2580    // LED Display Settings
2581    uint8_t      LedPin0;         // GPIO number for LedPin[0]
2582    uint8_t      LedPin1;         // GPIO number for LedPin[1]
2583    uint8_t      LedPin2;         // GPIO number for LedPin[2]
2584    uint8_t      padding8_4;
2585  
2586    // GFXCLK PLL Spread Spectrum
2587    uint8_t      PllGfxclkSpreadEnabled;   // on or off
2588    uint8_t      PllGfxclkSpreadPercent;   // Q4.4
2589    uint16_t     PllGfxclkSpreadFreq;      // kHz
2590  
2591    // GFXCLK DFLL Spread Spectrum
2592    uint8_t      DfllGfxclkSpreadEnabled;   // on or off
2593    uint8_t      DfllGfxclkSpreadPercent;   // Q4.4
2594    uint16_t     DfllGfxclkSpreadFreq;      // kHz
2595  
2596    // UCLK Spread Spectrum
2597    uint8_t      UclkSpreadEnabled;   // on or off
2598    uint8_t      UclkSpreadPercent;   // Q4.4
2599    uint16_t     UclkSpreadFreq;      // kHz
2600  
2601    // SOCCLK Spread Spectrum
2602    uint8_t      SoclkSpreadEnabled;   // on or off
2603    uint8_t      SocclkSpreadPercent;   // Q4.4
2604    uint16_t     SocclkSpreadFreq;      // kHz
2605  
2606    // Total board power
2607    uint16_t     TotalBoardPower;     //Only needed for TCP Estimated case, where TCP = TGP+Total Board Power
2608    uint16_t     BoardPadding;
2609  
2610    // Mvdd Svi2 Div Ratio Setting
2611    uint32_t MvddRatio; // This is used for MVDD Vid workaround. It has 16 fractional bits (Q16.16)
2612  
2613    uint32_t     BoardReserved[9];
2614  
2615  };
2616  
2617  struct atom_smc_dpm_info_v4_6
2618  {
2619    struct   atom_common_table_header  table_header;
2620    // section: board parameters
2621    uint32_t     i2c_padding[3];   // old i2c control are moved to new area
2622  
2623    uint16_t     maxvoltagestepgfx; // in mv(q2) max voltage step that smu will request. multiple steps are taken if voltage change exceeds this value.
2624    uint16_t     maxvoltagestepsoc; // in mv(q2) max voltage step that smu will request. multiple steps are taken if voltage change exceeds this value.
2625  
2626    uint8_t      vddgfxvrmapping;     // use vr_mapping* bitfields
2627    uint8_t      vddsocvrmapping;     // use vr_mapping* bitfields
2628    uint8_t      vddmemvrmapping;     // use vr_mapping* bitfields
2629    uint8_t      boardvrmapping;      // use vr_mapping* bitfields
2630  
2631    uint8_t      gfxulvphasesheddingmask; // set this to 1 to set psi0/1 to 1 in ulv mode
2632    uint8_t      externalsensorpresent; // external rdi connected to tmon (aka temp in)
2633    uint8_t      padding8_v[2];
2634  
2635    // telemetry settings
2636    uint16_t     gfxmaxcurrent;   // in amps
2637    uint8_t      gfxoffset;       // in amps
2638    uint8_t      padding_telemetrygfx;
2639  
2640    uint16_t     socmaxcurrent;   // in amps
2641    uint8_t      socoffset;       // in amps
2642    uint8_t      padding_telemetrysoc;
2643  
2644    uint16_t     memmaxcurrent;   // in amps
2645    uint8_t      memoffset;       // in amps
2646    uint8_t      padding_telemetrymem;
2647  
2648    uint16_t     boardmaxcurrent;   // in amps
2649    uint8_t      boardoffset;       // in amps
2650    uint8_t      padding_telemetryboardinput;
2651  
2652    // gpio settings
2653    uint8_t      vr0hotgpio;      // gpio pin configured for vr0 hot event
2654    uint8_t      vr0hotpolarity;  // gpio polarity for vr0 hot event
2655    uint8_t      vr1hotgpio;      // gpio pin configured for vr1 hot event
2656    uint8_t      vr1hotpolarity;  // gpio polarity for vr1 hot event
2657  
2658   // gfxclk pll spread spectrum
2659    uint8_t	   pllgfxclkspreadenabled;	// on or off
2660    uint8_t	   pllgfxclkspreadpercent;	// q4.4
2661    uint16_t	   pllgfxclkspreadfreq;		// khz
2662  
2663   // uclk spread spectrum
2664    uint8_t	   uclkspreadenabled;   // on or off
2665    uint8_t	   uclkspreadpercent;   // q4.4
2666    uint16_t	   uclkspreadfreq;	   // khz
2667  
2668   // fclk spread spectrum
2669    uint8_t	   fclkspreadenabled;   // on or off
2670    uint8_t	   fclkspreadpercent;   // q4.4
2671    uint16_t	   fclkspreadfreq;	   // khz
2672  
2673  
2674    // gfxclk fll spread spectrum
2675    uint8_t      fllgfxclkspreadenabled;   // on or off
2676    uint8_t      fllgfxclkspreadpercent;   // q4.4
2677    uint16_t     fllgfxclkspreadfreq;      // khz
2678  
2679    // i2c controller structure
2680    struct smudpm_i2c_controller_config_v2 i2ccontrollers[8];
2681  
2682    // memory section
2683    uint32_t	 memorychannelenabled; // for dram use only, max 32 channels enabled bit mask.
2684  
2685    uint8_t 	 drambitwidth; // for dram use only.  see dram bit width type defines
2686    uint8_t 	 paddingmem[3];
2687  
2688  	// total board power
2689    uint16_t	 totalboardpower;	  //only needed for tcp estimated case, where tcp = tgp+total board power
2690    uint16_t	 boardpadding;
2691  
2692  	// section: xgmi training
2693    uint8_t 	 xgmilinkspeed[4];
2694    uint8_t 	 xgmilinkwidth[4];
2695  
2696    uint16_t	 xgmifclkfreq[4];
2697    uint16_t	 xgmisocvoltage[4];
2698  
2699    // reserved
2700    uint32_t   boardreserved[10];
2701  };
2702  
2703  struct atom_smc_dpm_info_v4_7
2704  {
2705    struct   atom_common_table_header  table_header;
2706      // SECTION: BOARD PARAMETERS
2707      // I2C Control
2708    struct smudpm_i2c_controller_config_v2  I2cControllers[8];
2709  
2710    // SVI2 Board Parameters
2711    uint16_t     MaxVoltageStepGfx; // In mV(Q2) Max voltage step that SMU will request. Multiple steps are taken if voltage change exceeds this value.
2712    uint16_t     MaxVoltageStepSoc; // In mV(Q2) Max voltage step that SMU will request. Multiple steps are taken if voltage change exceeds this value.
2713  
2714    uint8_t      VddGfxVrMapping;   // Use VR_MAPPING* bitfields
2715    uint8_t      VddSocVrMapping;   // Use VR_MAPPING* bitfields
2716    uint8_t      VddMem0VrMapping;  // Use VR_MAPPING* bitfields
2717    uint8_t      VddMem1VrMapping;  // Use VR_MAPPING* bitfields
2718  
2719    uint8_t      GfxUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2720    uint8_t      SocUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2721    uint8_t      ExternalSensorPresent; // External RDI connected to TMON (aka TEMP IN)
2722    uint8_t      Padding8_V;
2723  
2724    // Telemetry Settings
2725    uint16_t     GfxMaxCurrent;   // in Amps
2726    uint8_t      GfxOffset;       // in Amps
2727    uint8_t      Padding_TelemetryGfx;
2728    uint16_t     SocMaxCurrent;   // in Amps
2729    uint8_t      SocOffset;       // in Amps
2730    uint8_t      Padding_TelemetrySoc;
2731  
2732    uint16_t     Mem0MaxCurrent;   // in Amps
2733    uint8_t      Mem0Offset;       // in Amps
2734    uint8_t      Padding_TelemetryMem0;
2735  
2736    uint16_t     Mem1MaxCurrent;   // in Amps
2737    uint8_t      Mem1Offset;       // in Amps
2738    uint8_t      Padding_TelemetryMem1;
2739  
2740    // GPIO Settings
2741    uint8_t      AcDcGpio;        // GPIO pin configured for AC/DC switching
2742    uint8_t      AcDcPolarity;    // GPIO polarity for AC/DC switching
2743    uint8_t      VR0HotGpio;      // GPIO pin configured for VR0 HOT event
2744    uint8_t      VR0HotPolarity;  // GPIO polarity for VR0 HOT event
2745  
2746    uint8_t      VR1HotGpio;      // GPIO pin configured for VR1 HOT event
2747    uint8_t      VR1HotPolarity;  // GPIO polarity for VR1 HOT event
2748    uint8_t      GthrGpio;        // GPIO pin configured for GTHR Event
2749    uint8_t      GthrPolarity;    // replace GPIO polarity for GTHR
2750  
2751    // LED Display Settings
2752    uint8_t      LedPin0;         // GPIO number for LedPin[0]
2753    uint8_t      LedPin1;         // GPIO number for LedPin[1]
2754    uint8_t      LedPin2;         // GPIO number for LedPin[2]
2755    uint8_t      padding8_4;
2756  
2757    // GFXCLK PLL Spread Spectrum
2758    uint8_t      PllGfxclkSpreadEnabled;   // on or off
2759    uint8_t      PllGfxclkSpreadPercent;   // Q4.4
2760    uint16_t     PllGfxclkSpreadFreq;      // kHz
2761  
2762    // GFXCLK DFLL Spread Spectrum
2763    uint8_t      DfllGfxclkSpreadEnabled;   // on or off
2764    uint8_t      DfllGfxclkSpreadPercent;   // Q4.4
2765    uint16_t     DfllGfxclkSpreadFreq;      // kHz
2766  
2767    // UCLK Spread Spectrum
2768    uint8_t      UclkSpreadEnabled;   // on or off
2769    uint8_t      UclkSpreadPercent;   // Q4.4
2770    uint16_t     UclkSpreadFreq;      // kHz
2771  
2772    // SOCCLK Spread Spectrum
2773    uint8_t      SoclkSpreadEnabled;   // on or off
2774    uint8_t      SocclkSpreadPercent;   // Q4.4
2775    uint16_t     SocclkSpreadFreq;      // kHz
2776  
2777    // Total board power
2778    uint16_t     TotalBoardPower;     //Only needed for TCP Estimated case, where TCP = TGP+Total Board Power
2779    uint16_t     BoardPadding;
2780  
2781    // Mvdd Svi2 Div Ratio Setting
2782    uint32_t     MvddRatio; // This is used for MVDD Vid workaround. It has 16 fractional bits (Q16.16)
2783  
2784    // GPIO pins for I2C communications with 2nd controller for Input Telemetry Sequence
2785    uint8_t      GpioI2cScl;          // Serial Clock
2786    uint8_t      GpioI2cSda;          // Serial Data
2787    uint16_t     GpioPadding;
2788  
2789    // Additional LED Display Settings
2790    uint8_t      LedPin3;         // GPIO number for LedPin[3] - PCIE GEN Speed
2791    uint8_t      LedPin4;         // GPIO number for LedPin[4] - PMFW Error Status
2792    uint16_t     LedEnableMask;
2793  
2794    // Power Limit Scalars
2795    uint8_t      PowerLimitScalar[4];    //[PPT_THROTTLER_COUNT]
2796  
2797    uint8_t      MvddUlvPhaseSheddingMask;
2798    uint8_t      VddciUlvPhaseSheddingMask;
2799    uint8_t      Padding8_Psi1;
2800    uint8_t      Padding8_Psi2;
2801  
2802    uint32_t     BoardReserved[5];
2803  };
2804  
2805  struct smudpm_i2c_controller_config_v3
2806  {
2807    uint8_t   Enabled;
2808    uint8_t   Speed;
2809    uint8_t   SlaveAddress;
2810    uint8_t   ControllerPort;
2811    uint8_t   ControllerName;
2812    uint8_t   ThermalThrotter;
2813    uint8_t   I2cProtocol;
2814    uint8_t   PaddingConfig;
2815  };
2816  
2817  struct atom_smc_dpm_info_v4_9
2818  {
2819    struct   atom_common_table_header  table_header;
2820  
2821    //SECTION: Gaming Clocks
2822    //uint32_t     GamingClk[6];
2823  
2824    // SECTION: I2C Control
2825    struct smudpm_i2c_controller_config_v3  I2cControllers[16];
2826  
2827    uint8_t      GpioScl;  // GPIO Number for SCL Line, used only for CKSVII2C1
2828    uint8_t      GpioSda;  // GPIO Number for SDA Line, used only for CKSVII2C1
2829    uint8_t      FchUsbPdSlaveAddr; //For requesting USB PD controller S-states via FCH I2C when entering PME turn off
2830    uint8_t      I2cSpare;
2831  
2832    // SECTION: SVI2 Board Parameters
2833    uint8_t      VddGfxVrMapping;   // Use VR_MAPPING* bitfields
2834    uint8_t      VddSocVrMapping;   // Use VR_MAPPING* bitfields
2835    uint8_t      VddMem0VrMapping;  // Use VR_MAPPING* bitfields
2836    uint8_t      VddMem1VrMapping;  // Use VR_MAPPING* bitfields
2837  
2838    uint8_t      GfxUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2839    uint8_t      SocUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2840    uint8_t      VddciUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2841    uint8_t      MvddUlvPhaseSheddingMask; // set this to 1 to set PSI0/1 to 1 in ULV mode
2842  
2843    // SECTION: Telemetry Settings
2844    uint16_t     GfxMaxCurrent;   // in Amps
2845    uint8_t      GfxOffset;       // in Amps
2846    uint8_t      Padding_TelemetryGfx;
2847  
2848    uint16_t     SocMaxCurrent;   // in Amps
2849    uint8_t      SocOffset;       // in Amps
2850    uint8_t      Padding_TelemetrySoc;
2851  
2852    uint16_t     Mem0MaxCurrent;   // in Amps
2853    uint8_t      Mem0Offset;       // in Amps
2854    uint8_t      Padding_TelemetryMem0;
2855  
2856    uint16_t     Mem1MaxCurrent;   // in Amps
2857    uint8_t      Mem1Offset;       // in Amps
2858    uint8_t      Padding_TelemetryMem1;
2859  
2860    uint32_t     MvddRatio; // This is used for MVDD  Svi2 Div Ratio workaround. It has 16 fractional bits (Q16.16)
2861  
2862    // SECTION: GPIO Settings
2863    uint8_t      AcDcGpio;        // GPIO pin configured for AC/DC switching
2864    uint8_t      AcDcPolarity;    // GPIO polarity for AC/DC switching
2865    uint8_t      VR0HotGpio;      // GPIO pin configured for VR0 HOT event
2866    uint8_t      VR0HotPolarity;  // GPIO polarity for VR0 HOT event
2867  
2868    uint8_t      VR1HotGpio;      // GPIO pin configured for VR1 HOT event
2869    uint8_t      VR1HotPolarity;  // GPIO polarity for VR1 HOT event
2870    uint8_t      GthrGpio;        // GPIO pin configured for GTHR Event
2871    uint8_t      GthrPolarity;    // replace GPIO polarity for GTHR
2872  
2873    // LED Display Settings
2874    uint8_t      LedPin0;         // GPIO number for LedPin[0]
2875    uint8_t      LedPin1;         // GPIO number for LedPin[1]
2876    uint8_t      LedPin2;         // GPIO number for LedPin[2]
2877    uint8_t      LedEnableMask;
2878  
2879    uint8_t      LedPcie;        // GPIO number for PCIE results
2880    uint8_t      LedError;       // GPIO number for Error Cases
2881    uint8_t      LedSpare1[2];
2882  
2883    // SECTION: Clock Spread Spectrum
2884  
2885    // GFXCLK PLL Spread Spectrum
2886    uint8_t      PllGfxclkSpreadEnabled;   // on or off
2887    uint8_t      PllGfxclkSpreadPercent;   // Q4.4
2888    uint16_t     PllGfxclkSpreadFreq;      // kHz
2889  
2890    // GFXCLK DFLL Spread Spectrum
2891    uint8_t      DfllGfxclkSpreadEnabled;   // on or off
2892    uint8_t      DfllGfxclkSpreadPercent;   // Q4.4
2893    uint16_t     DfllGfxclkSpreadFreq;      // kHz
2894  
2895    // UCLK Spread Spectrum
2896    uint8_t      UclkSpreadEnabled;   // on or off
2897    uint8_t      UclkSpreadPercent;   // Q4.4
2898    uint16_t     UclkSpreadFreq;      // kHz
2899  
2900    // FCLK Spread Spectrum
2901    uint8_t      FclkSpreadEnabled;   // on or off
2902    uint8_t      FclkSpreadPercent;   // Q4.4
2903    uint16_t     FclkSpreadFreq;      // kHz
2904  
2905    // Section: Memory Config
2906    uint32_t     MemoryChannelEnabled; // For DRAM use only, Max 32 channels enabled bit mask.
2907  
2908    uint8_t      DramBitWidth; // For DRAM use only.  See Dram Bit width type defines
2909    uint8_t      PaddingMem1[3];
2910  
2911    // Section: Total Board Power
2912    uint16_t     TotalBoardPower;     //Only needed for TCP Estimated case, where TCP = TGP+Total Board Power
2913    uint16_t     BoardPowerPadding;
2914  
2915    // SECTION: XGMI Training
2916    uint8_t      XgmiLinkSpeed   [4];
2917    uint8_t      XgmiLinkWidth   [4];
2918  
2919    uint16_t     XgmiFclkFreq    [4];
2920    uint16_t     XgmiSocVoltage  [4];
2921  
2922    // SECTION: Board Reserved
2923  
2924    uint32_t     BoardReserved[16];
2925  
2926  };
2927  
2928  struct atom_smc_dpm_info_v4_10
2929  {
2930    struct   atom_common_table_header  table_header;
2931  
2932    // SECTION: BOARD PARAMETERS
2933    // Telemetry Settings
2934    uint16_t GfxMaxCurrent; // in Amps
2935    uint8_t   GfxOffset;     // in Amps
2936    uint8_t  Padding_TelemetryGfx;
2937  
2938    uint16_t SocMaxCurrent; // in Amps
2939    uint8_t   SocOffset;     // in Amps
2940    uint8_t  Padding_TelemetrySoc;
2941  
2942    uint16_t MemMaxCurrent; // in Amps
2943    uint8_t   MemOffset;     // in Amps
2944    uint8_t  Padding_TelemetryMem;
2945  
2946    uint16_t BoardMaxCurrent; // in Amps
2947    uint8_t   BoardOffset;     // in Amps
2948    uint8_t  Padding_TelemetryBoardInput;
2949  
2950    // Platform input telemetry voltage coefficient
2951    uint32_t BoardVoltageCoeffA; // decode by /1000
2952    uint32_t BoardVoltageCoeffB; // decode by /1000
2953  
2954    // GPIO Settings
2955    uint8_t  VR0HotGpio;     // GPIO pin configured for VR0 HOT event
2956    uint8_t  VR0HotPolarity; // GPIO polarity for VR0 HOT event
2957    uint8_t  VR1HotGpio;     // GPIO pin configured for VR1 HOT event
2958    uint8_t  VR1HotPolarity; // GPIO polarity for VR1 HOT event
2959  
2960    // UCLK Spread Spectrum
2961    uint8_t  UclkSpreadEnabled; // on or off
2962    uint8_t  UclkSpreadPercent; // Q4.4
2963    uint16_t UclkSpreadFreq;    // kHz
2964  
2965    // FCLK Spread Spectrum
2966    uint8_t  FclkSpreadEnabled; // on or off
2967    uint8_t  FclkSpreadPercent; // Q4.4
2968    uint16_t FclkSpreadFreq;    // kHz
2969  
2970    // I2C Controller Structure
2971    struct smudpm_i2c_controller_config_v3  I2cControllers[8];
2972  
2973    // GPIO pins for I2C communications with 2nd controller for Input Telemetry Sequence
2974    uint8_t  GpioI2cScl; // Serial Clock
2975    uint8_t  GpioI2cSda; // Serial Data
2976    uint16_t spare5;
2977  
2978    uint32_t reserved[16];
2979  };
2980  
2981  /*
2982    ***************************************************************************
2983      Data Table asic_profiling_info  structure
2984    ***************************************************************************
2985  */
2986  struct  atom_asic_profiling_info_v4_1
2987  {
2988    struct  atom_common_table_header  table_header;
2989    uint32_t  maxvddc;
2990    uint32_t  minvddc;
2991    uint32_t  avfs_meannsigma_acontant0;
2992    uint32_t  avfs_meannsigma_acontant1;
2993    uint32_t  avfs_meannsigma_acontant2;
2994    uint16_t  avfs_meannsigma_dc_tol_sigma;
2995    uint16_t  avfs_meannsigma_platform_mean;
2996    uint16_t  avfs_meannsigma_platform_sigma;
2997    uint32_t  gb_vdroop_table_cksoff_a0;
2998    uint32_t  gb_vdroop_table_cksoff_a1;
2999    uint32_t  gb_vdroop_table_cksoff_a2;
3000    uint32_t  gb_vdroop_table_ckson_a0;
3001    uint32_t  gb_vdroop_table_ckson_a1;
3002    uint32_t  gb_vdroop_table_ckson_a2;
3003    uint32_t  avfsgb_fuse_table_cksoff_m1;
3004    uint32_t  avfsgb_fuse_table_cksoff_m2;
3005    uint32_t  avfsgb_fuse_table_cksoff_b;
3006    uint32_t  avfsgb_fuse_table_ckson_m1;
3007    uint32_t  avfsgb_fuse_table_ckson_m2;
3008    uint32_t  avfsgb_fuse_table_ckson_b;
3009    uint16_t  max_voltage_0_25mv;
3010    uint8_t   enable_gb_vdroop_table_cksoff;
3011    uint8_t   enable_gb_vdroop_table_ckson;
3012    uint8_t   enable_gb_fuse_table_cksoff;
3013    uint8_t   enable_gb_fuse_table_ckson;
3014    uint16_t  psm_age_comfactor;
3015    uint8_t   enable_apply_avfs_cksoff_voltage;
3016    uint8_t   reserved;
3017    uint32_t  dispclk2gfxclk_a;
3018    uint32_t  dispclk2gfxclk_b;
3019    uint32_t  dispclk2gfxclk_c;
3020    uint32_t  pixclk2gfxclk_a;
3021    uint32_t  pixclk2gfxclk_b;
3022    uint32_t  pixclk2gfxclk_c;
3023    uint32_t  dcefclk2gfxclk_a;
3024    uint32_t  dcefclk2gfxclk_b;
3025    uint32_t  dcefclk2gfxclk_c;
3026    uint32_t  phyclk2gfxclk_a;
3027    uint32_t  phyclk2gfxclk_b;
3028    uint32_t  phyclk2gfxclk_c;
3029  };
3030  
3031  struct  atom_asic_profiling_info_v4_2 {
3032  	struct  atom_common_table_header  table_header;
3033  	uint32_t  maxvddc;
3034  	uint32_t  minvddc;
3035  	uint32_t  avfs_meannsigma_acontant0;
3036  	uint32_t  avfs_meannsigma_acontant1;
3037  	uint32_t  avfs_meannsigma_acontant2;
3038  	uint16_t  avfs_meannsigma_dc_tol_sigma;
3039  	uint16_t  avfs_meannsigma_platform_mean;
3040  	uint16_t  avfs_meannsigma_platform_sigma;
3041  	uint32_t  gb_vdroop_table_cksoff_a0;
3042  	uint32_t  gb_vdroop_table_cksoff_a1;
3043  	uint32_t  gb_vdroop_table_cksoff_a2;
3044  	uint32_t  gb_vdroop_table_ckson_a0;
3045  	uint32_t  gb_vdroop_table_ckson_a1;
3046  	uint32_t  gb_vdroop_table_ckson_a2;
3047  	uint32_t  avfsgb_fuse_table_cksoff_m1;
3048  	uint32_t  avfsgb_fuse_table_cksoff_m2;
3049  	uint32_t  avfsgb_fuse_table_cksoff_b;
3050  	uint32_t  avfsgb_fuse_table_ckson_m1;
3051  	uint32_t  avfsgb_fuse_table_ckson_m2;
3052  	uint32_t  avfsgb_fuse_table_ckson_b;
3053  	uint16_t  max_voltage_0_25mv;
3054  	uint8_t   enable_gb_vdroop_table_cksoff;
3055  	uint8_t   enable_gb_vdroop_table_ckson;
3056  	uint8_t   enable_gb_fuse_table_cksoff;
3057  	uint8_t   enable_gb_fuse_table_ckson;
3058  	uint16_t  psm_age_comfactor;
3059  	uint8_t   enable_apply_avfs_cksoff_voltage;
3060  	uint8_t   reserved;
3061  	uint32_t  dispclk2gfxclk_a;
3062  	uint32_t  dispclk2gfxclk_b;
3063  	uint32_t  dispclk2gfxclk_c;
3064  	uint32_t  pixclk2gfxclk_a;
3065  	uint32_t  pixclk2gfxclk_b;
3066  	uint32_t  pixclk2gfxclk_c;
3067  	uint32_t  dcefclk2gfxclk_a;
3068  	uint32_t  dcefclk2gfxclk_b;
3069  	uint32_t  dcefclk2gfxclk_c;
3070  	uint32_t  phyclk2gfxclk_a;
3071  	uint32_t  phyclk2gfxclk_b;
3072  	uint32_t  phyclk2gfxclk_c;
3073  	uint32_t  acg_gb_vdroop_table_a0;
3074  	uint32_t  acg_gb_vdroop_table_a1;
3075  	uint32_t  acg_gb_vdroop_table_a2;
3076  	uint32_t  acg_avfsgb_fuse_table_m1;
3077  	uint32_t  acg_avfsgb_fuse_table_m2;
3078  	uint32_t  acg_avfsgb_fuse_table_b;
3079  	uint8_t   enable_acg_gb_vdroop_table;
3080  	uint8_t   enable_acg_gb_fuse_table;
3081  	uint32_t  acg_dispclk2gfxclk_a;
3082  	uint32_t  acg_dispclk2gfxclk_b;
3083  	uint32_t  acg_dispclk2gfxclk_c;
3084  	uint32_t  acg_pixclk2gfxclk_a;
3085  	uint32_t  acg_pixclk2gfxclk_b;
3086  	uint32_t  acg_pixclk2gfxclk_c;
3087  	uint32_t  acg_dcefclk2gfxclk_a;
3088  	uint32_t  acg_dcefclk2gfxclk_b;
3089  	uint32_t  acg_dcefclk2gfxclk_c;
3090  	uint32_t  acg_phyclk2gfxclk_a;
3091  	uint32_t  acg_phyclk2gfxclk_b;
3092  	uint32_t  acg_phyclk2gfxclk_c;
3093  };
3094  
3095  /*
3096    ***************************************************************************
3097      Data Table multimedia_info  structure
3098    ***************************************************************************
3099  */
3100  struct atom_multimedia_info_v2_1
3101  {
3102    struct  atom_common_table_header  table_header;
3103    uint8_t uvdip_min_ver;
3104    uint8_t uvdip_max_ver;
3105    uint8_t vceip_min_ver;
3106    uint8_t vceip_max_ver;
3107    uint16_t uvd_enc_max_input_width_pixels;
3108    uint16_t uvd_enc_max_input_height_pixels;
3109    uint16_t vce_enc_max_input_width_pixels;
3110    uint16_t vce_enc_max_input_height_pixels;
3111    uint32_t uvd_enc_max_bandwidth;           // 16x16 pixels/sec, codec independent
3112    uint32_t vce_enc_max_bandwidth;           // 16x16 pixels/sec, codec independent
3113  };
3114  
3115  
3116  /*
3117    ***************************************************************************
3118      Data Table umc_info  structure
3119    ***************************************************************************
3120  */
3121  struct atom_umc_info_v3_1
3122  {
3123    struct  atom_common_table_header  table_header;
3124    uint32_t ucode_version;
3125    uint32_t ucode_rom_startaddr;
3126    uint32_t ucode_length;
3127    uint16_t umc_reg_init_offset;
3128    uint16_t customer_ucode_name_offset;
3129    uint16_t mclk_ss_percentage;
3130    uint16_t mclk_ss_rate_10hz;
3131    uint8_t umcip_min_ver;
3132    uint8_t umcip_max_ver;
3133    uint8_t vram_type;              //enum of atom_dgpu_vram_type
3134    uint8_t umc_config;
3135    uint32_t mem_refclk_10khz;
3136  };
3137  
3138  // umc_info.umc_config
3139  enum atom_umc_config_def {
3140    UMC_CONFIG__ENABLE_1KB_INTERLEAVE_MODE  =   0x00000001,
3141    UMC_CONFIG__DEFAULT_MEM_ECC_ENABLE      =   0x00000002,
3142    UMC_CONFIG__ENABLE_HBM_LANE_REPAIR      =   0x00000004,
3143    UMC_CONFIG__ENABLE_BANK_HARVESTING      =   0x00000008,
3144    UMC_CONFIG__ENABLE_PHY_REINIT           =   0x00000010,
3145    UMC_CONFIG__DISABLE_UCODE_CHKSTATUS     =   0x00000020,
3146  };
3147  
3148  struct atom_umc_info_v3_2
3149  {
3150    struct  atom_common_table_header  table_header;
3151    uint32_t ucode_version;
3152    uint32_t ucode_rom_startaddr;
3153    uint32_t ucode_length;
3154    uint16_t umc_reg_init_offset;
3155    uint16_t customer_ucode_name_offset;
3156    uint16_t mclk_ss_percentage;
3157    uint16_t mclk_ss_rate_10hz;
3158    uint8_t umcip_min_ver;
3159    uint8_t umcip_max_ver;
3160    uint8_t vram_type;              //enum of atom_dgpu_vram_type
3161    uint8_t umc_config;
3162    uint32_t mem_refclk_10khz;
3163    uint32_t pstate_uclk_10khz[4];
3164    uint16_t umcgoldenoffset;
3165    uint16_t densitygoldenoffset;
3166  };
3167  
3168  struct atom_umc_info_v3_3
3169  {
3170    struct  atom_common_table_header  table_header;
3171    uint32_t ucode_reserved;
3172    uint32_t ucode_rom_startaddr;
3173    uint32_t ucode_length;
3174    uint16_t umc_reg_init_offset;
3175    uint16_t customer_ucode_name_offset;
3176    uint16_t mclk_ss_percentage;
3177    uint16_t mclk_ss_rate_10hz;
3178    uint8_t umcip_min_ver;
3179    uint8_t umcip_max_ver;
3180    uint8_t vram_type;              //enum of atom_dgpu_vram_type
3181    uint8_t umc_config;
3182    uint32_t mem_refclk_10khz;
3183    uint32_t pstate_uclk_10khz[4];
3184    uint16_t umcgoldenoffset;
3185    uint16_t densitygoldenoffset;
3186    uint32_t umc_config1;
3187    uint32_t bist_data_startaddr;
3188    uint32_t reserved[2];
3189  };
3190  
3191  enum atom_umc_config1_def {
3192  	UMC_CONFIG1__ENABLE_PSTATE_PHASE_STORE_TRAIN = 0x00000001,
3193  	UMC_CONFIG1__ENABLE_AUTO_FRAMING = 0x00000002,
3194  	UMC_CONFIG1__ENABLE_RESTORE_BIST_DATA = 0x00000004,
3195  	UMC_CONFIG1__DISABLE_STROBE_MODE = 0x00000008,
3196  	UMC_CONFIG1__DEBUG_DATA_PARITY_EN = 0x00000010,
3197  	UMC_CONFIG1__ENABLE_ECC_CAPABLE = 0x00010000,
3198  };
3199  
3200  struct atom_umc_info_v4_0 {
3201  	struct atom_common_table_header table_header;
3202  	uint32_t ucode_reserved[5];
3203  	uint8_t umcip_min_ver;
3204  	uint8_t umcip_max_ver;
3205  	uint8_t vram_type;
3206  	uint8_t umc_config;
3207  	uint32_t mem_refclk_10khz;
3208  	uint32_t clk_reserved[4];
3209  	uint32_t golden_reserved;
3210  	uint32_t umc_config1;
3211  	uint32_t reserved[2];
3212  	uint8_t channel_num;
3213  	uint8_t channel_width;
3214  	uint8_t channel_reserve[2];
3215  	uint8_t umc_info_reserved[16];
3216  };
3217  
3218  /*
3219    ***************************************************************************
3220      Data Table vram_info  structure
3221    ***************************************************************************
3222  */
3223  struct atom_vram_module_v9 {
3224    // Design Specific Values
3225    uint32_t  memory_size;                   // Total memory size in unit of MB for CONFIG_MEMSIZE zeros
3226    uint32_t  channel_enable;                // bit vector, each bit indicate specific channel enable or not
3227    uint32_t  max_mem_clk;                   // max memory clock of this memory in unit of 10kHz, =0 means it is not defined
3228    uint16_t  reserved[3];
3229    uint16_t  mem_voltage;                   // mem_voltage
3230    uint16_t  vram_module_size;              // Size of atom_vram_module_v9
3231    uint8_t   ext_memory_id;                 // Current memory module ID
3232    uint8_t   memory_type;                   // enum of atom_dgpu_vram_type
3233    uint8_t   channel_num;                   // Number of mem. channels supported in this module
3234    uint8_t   channel_width;                 // CHANNEL_16BIT/CHANNEL_32BIT/CHANNEL_64BIT
3235    uint8_t   density;                       // _8Mx32, _16Mx32, _16Mx16, _32Mx16
3236    uint8_t   tunningset_id;                 // MC phy registers set per.
3237    uint8_t   vender_rev_id;                 // [7:4] Revision, [3:0] Vendor code
3238    uint8_t   refreshrate;                   // [1:0]=RefreshFactor (00=8ms, 01=16ms, 10=32ms,11=64ms)
3239    uint8_t   hbm_ven_rev_id;		   // hbm_ven_rev_id
3240    uint8_t   vram_rsd2;			   // reserved
3241    char    dram_pnstring[20];               // part number end with '0'.
3242  };
3243  
3244  struct atom_vram_info_header_v2_3 {
3245    struct   atom_common_table_header table_header;
3246    uint16_t mem_adjust_tbloffset;                         // offset of atom_umc_init_reg_block structure for memory vendor specific UMC adjust setting
3247    uint16_t mem_clk_patch_tbloffset;                      // offset of atom_umc_init_reg_block structure for memory clock specific UMC setting
3248    uint16_t mc_adjust_pertile_tbloffset;                  // offset of atom_umc_init_reg_block structure for Per Byte Offset Preset Settings
3249    uint16_t mc_phyinit_tbloffset;                         // offset of atom_umc_init_reg_block structure for MC phy init set
3250    uint16_t dram_data_remap_tbloffset;                    // reserved for now
3251    uint16_t tmrs_seq_offset;                              // offset of HBM tmrs
3252    uint16_t post_ucode_init_offset;                       // offset of atom_umc_init_reg_block structure for MC phy init after MC uCode complete umc init
3253    uint16_t vram_rsd2;
3254    uint8_t  vram_module_num;                              // indicate number of VRAM module
3255    uint8_t  umcip_min_ver;
3256    uint8_t  umcip_max_ver;
3257    uint8_t  mc_phy_tile_num;                              // indicate the MCD tile number which use in DramDataRemapTbl and usMcAdjustPerTileTblOffset
3258    struct   atom_vram_module_v9  vram_module[16];         // just for allocation, real number of blocks is in ucNumOfVRAMModule;
3259  };
3260  
3261  /*
3262    ***************************************************************************
3263      Data Table vram_info v3.0  structure
3264    ***************************************************************************
3265  */
3266  struct atom_vram_module_v3_0 {
3267  	uint8_t density;
3268  	uint8_t tunningset_id;
3269  	uint8_t ext_memory_id;
3270  	uint8_t dram_vendor_id;
3271  	uint16_t dram_info_offset;
3272  	uint16_t mem_tuning_offset;
3273  	uint16_t tmrs_seq_offset;
3274  	uint16_t reserved1;
3275  	uint32_t dram_size_per_ch;
3276  	uint32_t reserved[3];
3277  	char dram_pnstring[40];
3278  };
3279  
3280  struct atom_vram_info_header_v3_0 {
3281  	struct atom_common_table_header table_header;
3282  	uint16_t mem_tuning_table_offset;
3283  	uint16_t dram_info_table_offset;
3284  	uint16_t tmrs_table_offset;
3285  	uint16_t mc_init_table_offset;
3286  	uint16_t dram_data_remap_table_offset;
3287  	uint16_t umc_emuinittable_offset;
3288  	uint16_t reserved_sub_table_offset[2];
3289  	uint8_t vram_module_num;
3290  	uint8_t umcip_min_ver;
3291  	uint8_t umcip_max_ver;
3292  	uint8_t mc_phy_tile_num;
3293  	uint8_t memory_type;
3294  	uint8_t channel_num;
3295  	uint8_t channel_width;
3296  	uint8_t reserved1;
3297  	uint32_t channel_enable;
3298  	uint32_t channel1_enable;
3299  	uint32_t feature_enable;
3300  	uint32_t feature1_enable;
3301  	uint32_t hardcode_mem_size;
3302  	uint32_t reserved4[4];
3303  	struct atom_vram_module_v3_0 vram_module[8];
3304  };
3305  
3306  struct atom_umc_register_addr_info{
3307    uint32_t  umc_register_addr:24;
3308    uint32_t  umc_reg_type_ind:1;
3309    uint32_t  umc_reg_rsvd:7;
3310  };
3311  
3312  //atom_umc_register_addr_info.
3313  enum atom_umc_register_addr_info_flag{
3314    b3ATOM_UMC_REG_ADD_INFO_INDIRECT_ACCESS  =0x01,
3315  };
3316  
3317  union atom_umc_register_addr_info_access
3318  {
3319    struct atom_umc_register_addr_info umc_reg_addr;
3320    uint32_t u32umc_reg_addr;
3321  };
3322  
3323  struct atom_umc_reg_setting_id_config{
3324    uint32_t memclockrange:24;
3325    uint32_t mem_blk_id:8;
3326  };
3327  
3328  union atom_umc_reg_setting_id_config_access
3329  {
3330    struct atom_umc_reg_setting_id_config umc_id_access;
3331    uint32_t  u32umc_id_access;
3332  };
3333  
3334  struct atom_umc_reg_setting_data_block{
3335    union atom_umc_reg_setting_id_config_access  block_id;
3336    uint32_t u32umc_reg_data[1];
3337  };
3338  
3339  struct atom_umc_init_reg_block{
3340    uint16_t umc_reg_num;
3341    uint16_t reserved;
3342    union atom_umc_register_addr_info_access umc_reg_list[1];     //for allocation purpose, the real number come from umc_reg_num;
3343    struct atom_umc_reg_setting_data_block umc_reg_setting_list[1];
3344  };
3345  
3346  struct atom_vram_module_v10 {
3347    // Design Specific Values
3348    uint32_t  memory_size;                   // Total memory size in unit of MB for CONFIG_MEMSIZE zeros
3349    uint32_t  channel_enable;                // bit vector, each bit indicate specific channel enable or not
3350    uint32_t  max_mem_clk;                   // max memory clock of this memory in unit of 10kHz, =0 means it is not defined
3351    uint16_t  reserved[3];
3352    uint16_t  mem_voltage;                   // mem_voltage
3353    uint16_t  vram_module_size;              // Size of atom_vram_module_v9
3354    uint8_t   ext_memory_id;                 // Current memory module ID
3355    uint8_t   memory_type;                   // enum of atom_dgpu_vram_type
3356    uint8_t   channel_num;                   // Number of mem. channels supported in this module
3357    uint8_t   channel_width;                 // CHANNEL_16BIT/CHANNEL_32BIT/CHANNEL_64BIT
3358    uint8_t   density;                       // _8Mx32, _16Mx32, _16Mx16, _32Mx16
3359    uint8_t   tunningset_id;                 // MC phy registers set per
3360    uint8_t   vender_rev_id;                 // [7:4] Revision, [3:0] Vendor code
3361    uint8_t   refreshrate;                   // [1:0]=RefreshFactor (00=8ms, 01=16ms, 10=32ms,11=64ms)
3362    uint8_t   vram_flags;			   // bit0= bankgroup enable
3363    uint8_t   vram_rsd2;			   // reserved
3364    uint16_t  gddr6_mr10;                    // gddr6 mode register10 value
3365    uint16_t  gddr6_mr1;                     // gddr6 mode register1 value
3366    uint16_t  gddr6_mr2;                     // gddr6 mode register2 value
3367    uint16_t  gddr6_mr7;                     // gddr6 mode register7 value
3368    char    dram_pnstring[20];               // part number end with '0'
3369  };
3370  
3371  struct atom_vram_info_header_v2_4 {
3372    struct   atom_common_table_header table_header;
3373    uint16_t mem_adjust_tbloffset;                         // offset of atom_umc_init_reg_block structure for memory vendor specific UMC adjust setting
3374    uint16_t mem_clk_patch_tbloffset;                      // offset of atom_umc_init_reg_block structure for memory clock specific UMC setting
3375    uint16_t mc_adjust_pertile_tbloffset;                  // offset of atom_umc_init_reg_block structure for Per Byte Offset Preset Settings
3376    uint16_t mc_phyinit_tbloffset;                         // offset of atom_umc_init_reg_block structure for MC phy init set
3377    uint16_t dram_data_remap_tbloffset;                    // reserved for now
3378    uint16_t reserved;                                     // offset of reserved
3379    uint16_t post_ucode_init_offset;                       // offset of atom_umc_init_reg_block structure for MC phy init after MC uCode complete umc init
3380    uint16_t vram_rsd2;
3381    uint8_t  vram_module_num;                              // indicate number of VRAM module
3382    uint8_t  umcip_min_ver;
3383    uint8_t  umcip_max_ver;
3384    uint8_t  mc_phy_tile_num;                              // indicate the MCD tile number which use in DramDataRemapTbl and usMcAdjustPerTileTblOffset
3385    struct   atom_vram_module_v10  vram_module[16];        // just for allocation, real number of blocks is in ucNumOfVRAMModule;
3386  };
3387  
3388  struct atom_vram_module_v11 {
3389  	// Design Specific Values
3390  	uint32_t  memory_size;                   // Total memory size in unit of MB for CONFIG_MEMSIZE zeros
3391  	uint32_t  channel_enable;                // bit vector, each bit indicate specific channel enable or not
3392  	uint16_t  mem_voltage;                   // mem_voltage
3393  	uint16_t  vram_module_size;              // Size of atom_vram_module_v9
3394  	uint8_t   ext_memory_id;                 // Current memory module ID
3395  	uint8_t   memory_type;                   // enum of atom_dgpu_vram_type
3396  	uint8_t   channel_num;                   // Number of mem. channels supported in this module
3397  	uint8_t   channel_width;                 // CHANNEL_16BIT/CHANNEL_32BIT/CHANNEL_64BIT
3398  	uint8_t   density;                       // _8Mx32, _16Mx32, _16Mx16, _32Mx16
3399  	uint8_t   tunningset_id;                 // MC phy registers set per.
3400  	uint16_t  reserved[4];                   // reserved
3401  	uint8_t   vender_rev_id;                 // [7:4] Revision, [3:0] Vendor code
3402  	uint8_t   refreshrate;			 // [1:0]=RefreshFactor (00=8ms, 01=16ms, 10=32ms,11=64ms)
3403  	uint8_t   vram_flags;			 // bit0= bankgroup enable
3404  	uint8_t   vram_rsd2;			 // reserved
3405  	uint16_t  gddr6_mr10;                    // gddr6 mode register10 value
3406  	uint16_t  gddr6_mr0;                     // gddr6 mode register0 value
3407  	uint16_t  gddr6_mr1;                     // gddr6 mode register1 value
3408  	uint16_t  gddr6_mr2;                     // gddr6 mode register2 value
3409  	uint16_t  gddr6_mr4;                     // gddr6 mode register4 value
3410  	uint16_t  gddr6_mr7;                     // gddr6 mode register7 value
3411  	uint16_t  gddr6_mr8;                     // gddr6 mode register8 value
3412  	char    dram_pnstring[40];               // part number end with '0'.
3413  };
3414  
3415  struct atom_gddr6_ac_timing_v2_5 {
3416  	uint32_t  u32umc_id_access;
3417  	uint8_t  RL;
3418  	uint8_t  WL;
3419  	uint8_t  tRAS;
3420  	uint8_t  tRC;
3421  
3422  	uint16_t  tREFI;
3423  	uint8_t  tRFC;
3424  	uint8_t  tRFCpb;
3425  
3426  	uint8_t  tRREFD;
3427  	uint8_t  tRCDRD;
3428  	uint8_t  tRCDWR;
3429  	uint8_t  tRP;
3430  
3431  	uint8_t  tRRDS;
3432  	uint8_t  tRRDL;
3433  	uint8_t  tWR;
3434  	uint8_t  tWTRS;
3435  
3436  	uint8_t  tWTRL;
3437  	uint8_t  tFAW;
3438  	uint8_t  tCCDS;
3439  	uint8_t  tCCDL;
3440  
3441  	uint8_t  tCRCRL;
3442  	uint8_t  tCRCWL;
3443  	uint8_t  tCKE;
3444  	uint8_t  tCKSRE;
3445  
3446  	uint8_t  tCKSRX;
3447  	uint8_t  tRTPS;
3448  	uint8_t  tRTPL;
3449  	uint8_t  tMRD;
3450  
3451  	uint8_t  tMOD;
3452  	uint8_t  tXS;
3453  	uint8_t  tXHP;
3454  	uint8_t  tXSMRS;
3455  
3456  	uint32_t  tXSH;
3457  
3458  	uint8_t  tPD;
3459  	uint8_t  tXP;
3460  	uint8_t  tCPDED;
3461  	uint8_t  tACTPDE;
3462  
3463  	uint8_t  tPREPDE;
3464  	uint8_t  tREFPDE;
3465  	uint8_t  tMRSPDEN;
3466  	uint8_t  tRDSRE;
3467  
3468  	uint8_t  tWRSRE;
3469  	uint8_t  tPPD;
3470  	uint8_t  tCCDMW;
3471  	uint8_t  tWTRTR;
3472  
3473  	uint8_t  tLTLTR;
3474  	uint8_t  tREFTR;
3475  	uint8_t  VNDR;
3476  	uint8_t  reserved[9];
3477  };
3478  
3479  struct atom_gddr6_bit_byte_remap {
3480  	uint32_t dphy_byteremap;    //mmUMC_DPHY_ByteRemap
3481  	uint32_t dphy_bitremap0;    //mmUMC_DPHY_BitRemap0
3482  	uint32_t dphy_bitremap1;    //mmUMC_DPHY_BitRemap1
3483  	uint32_t dphy_bitremap2;    //mmUMC_DPHY_BitRemap2
3484  	uint32_t aphy_bitremap0;    //mmUMC_APHY_BitRemap0
3485  	uint32_t aphy_bitremap1;    //mmUMC_APHY_BitRemap1
3486  	uint32_t phy_dram;          //mmUMC_PHY_DRAM
3487  };
3488  
3489  struct atom_gddr6_dram_data_remap {
3490  	uint32_t table_size;
3491  	uint8_t phyintf_ck_inverted[8];     //UMC_PHY_PHYINTF_CNTL.INV_CK
3492  	struct atom_gddr6_bit_byte_remap bit_byte_remap[16];
3493  };
3494  
3495  struct atom_vram_info_header_v2_5 {
3496  	struct   atom_common_table_header table_header;
3497  	uint16_t mem_adjust_tbloffset;                         // offset of atom_umc_init_reg_block structure for memory vendor specific UMC adjust settings
3498  	uint16_t gddr6_ac_timing_offset;                     // offset of atom_gddr6_ac_timing_v2_5 structure for memory clock specific UMC settings
3499  	uint16_t mc_adjust_pertile_tbloffset;                  // offset of atom_umc_init_reg_block structure for Per Byte Offset Preset Settings
3500  	uint16_t mc_phyinit_tbloffset;                         // offset of atom_umc_init_reg_block structure for MC phy init set
3501  	uint16_t dram_data_remap_tbloffset;                    // offset of atom_gddr6_dram_data_remap array to indicate DRAM data lane to GPU mapping
3502  	uint16_t reserved;                                     // offset of reserved
3503  	uint16_t post_ucode_init_offset;                       // offset of atom_umc_init_reg_block structure for MC phy init after MC uCode complete umc init
3504  	uint16_t strobe_mode_patch_tbloffset;                  // offset of atom_umc_init_reg_block structure for Strobe Mode memory clock specific UMC settings
3505  	uint8_t  vram_module_num;                              // indicate number of VRAM module
3506  	uint8_t  umcip_min_ver;
3507  	uint8_t  umcip_max_ver;
3508  	uint8_t  mc_phy_tile_num;                              // indicate the MCD tile number which use in DramDataRemapTbl and usMcAdjustPerTileTblOffset
3509  	struct   atom_vram_module_v11  vram_module[16];        // just for allocation, real number of blocks is in ucNumOfVRAMModule;
3510  };
3511  
3512  struct atom_vram_info_header_v2_6 {
3513  	struct atom_common_table_header table_header;
3514  	uint16_t mem_adjust_tbloffset;
3515  	uint16_t mem_clk_patch_tbloffset;
3516  	uint16_t mc_adjust_pertile_tbloffset;
3517  	uint16_t mc_phyinit_tbloffset;
3518  	uint16_t dram_data_remap_tbloffset;
3519  	uint16_t tmrs_seq_offset;
3520  	uint16_t post_ucode_init_offset;
3521  	uint16_t vram_rsd2;
3522  	uint8_t  vram_module_num;
3523  	uint8_t  umcip_min_ver;
3524  	uint8_t  umcip_max_ver;
3525  	uint8_t  mc_phy_tile_num;
3526  	struct atom_vram_module_v9 vram_module[16];
3527  };
3528  /*
3529    ***************************************************************************
3530      Data Table voltageobject_info  structure
3531    ***************************************************************************
3532  */
3533  struct  atom_i2c_data_entry
3534  {
3535    uint16_t  i2c_reg_index;               // i2c register address, can be up to 16bit
3536    uint16_t  i2c_reg_data;                // i2c register data, can be up to 16bit
3537  };
3538  
3539  struct atom_voltage_object_header_v4{
3540    uint8_t    voltage_type;                           //enum atom_voltage_type
3541    uint8_t    voltage_mode;                           //enum atom_voltage_object_mode
3542    uint16_t   object_size;                            //Size of Object
3543  };
3544  
3545  // atom_voltage_object_header_v4.voltage_mode
3546  enum atom_voltage_object_mode
3547  {
3548     VOLTAGE_OBJ_GPIO_LUT              =  0,        //VOLTAGE and GPIO Lookup table ->atom_gpio_voltage_object_v4
3549     VOLTAGE_OBJ_VR_I2C_INIT_SEQ       =  3,        //VOLTAGE REGULATOR INIT sequece through I2C -> atom_i2c_voltage_object_v4
3550     VOLTAGE_OBJ_PHASE_LUT             =  4,        //Set Vregulator Phase lookup table ->atom_gpio_voltage_object_v4
3551     VOLTAGE_OBJ_SVID2                 =  7,        //Indicate voltage control by SVID2 ->atom_svid2_voltage_object_v4
3552     VOLTAGE_OBJ_EVV                   =  8,
3553     VOLTAGE_OBJ_MERGED_POWER          =  9,
3554  };
3555  
3556  struct  atom_i2c_voltage_object_v4
3557  {
3558     struct atom_voltage_object_header_v4 header;  // voltage mode = VOLTAGE_OBJ_VR_I2C_INIT_SEQ
3559     uint8_t  regulator_id;                        //Indicate Voltage Regulator Id
3560     uint8_t  i2c_id;
3561     uint8_t  i2c_slave_addr;
3562     uint8_t  i2c_control_offset;
3563     uint8_t  i2c_flag;                            // Bit0: 0 - One byte data; 1 - Two byte data
3564     uint8_t  i2c_speed;                           // =0, use default i2c speed, otherwise use it in unit of kHz.
3565     uint8_t  reserved[2];
3566     struct atom_i2c_data_entry i2cdatalut[1];     // end with 0xff
3567  };
3568  
3569  // ATOM_I2C_VOLTAGE_OBJECT_V3.ucVoltageControlFlag
3570  enum atom_i2c_voltage_control_flag
3571  {
3572     VOLTAGE_DATA_ONE_BYTE = 0,
3573     VOLTAGE_DATA_TWO_BYTE = 1,
3574  };
3575  
3576  
3577  struct atom_voltage_gpio_map_lut
3578  {
3579    uint32_t  voltage_gpio_reg_val;              // The Voltage ID which is used to program GPIO register
3580    uint16_t  voltage_level_mv;                  // The corresponding Voltage Value, in mV
3581  };
3582  
3583  struct atom_gpio_voltage_object_v4
3584  {
3585     struct atom_voltage_object_header_v4 header;  // voltage mode = VOLTAGE_OBJ_GPIO_LUT or VOLTAGE_OBJ_PHASE_LUT
3586     uint8_t  gpio_control_id;                     // default is 0 which indicate control through CG VID mode
3587     uint8_t  gpio_entry_num;                      // indiate the entry numbers of Votlage/Gpio value Look up table
3588     uint8_t  phase_delay_us;                      // phase delay in unit of micro second
3589     uint8_t  reserved;
3590     uint32_t gpio_mask_val;                         // GPIO Mask value
3591     struct atom_voltage_gpio_map_lut voltage_gpio_lut[] __counted_by(gpio_entry_num);
3592  };
3593  
3594  struct  atom_svid2_voltage_object_v4
3595  {
3596     struct atom_voltage_object_header_v4 header;  // voltage mode = VOLTAGE_OBJ_SVID2
3597     uint8_t loadline_psi1;                        // bit4:0= loadline setting ( Core Loadline trim and offset trim ), bit5=0:PSI1_L disable =1: PSI1_L enable
3598     uint8_t psi0_l_vid_thresd;                    // VR PSI0_L VID threshold
3599     uint8_t psi0_enable;                          //
3600     uint8_t maxvstep;
3601     uint8_t telemetry_offset;
3602     uint8_t telemetry_gain;
3603     uint16_t reserved1;
3604  };
3605  
3606  struct atom_merged_voltage_object_v4
3607  {
3608    struct atom_voltage_object_header_v4 header;  // voltage mode = VOLTAGE_OBJ_MERGED_POWER
3609    uint8_t  merged_powerrail_type;               //enum atom_voltage_type
3610    uint8_t  reserved[3];
3611  };
3612  
3613  union atom_voltage_object_v4{
3614    struct atom_gpio_voltage_object_v4 gpio_voltage_obj;
3615    struct atom_i2c_voltage_object_v4 i2c_voltage_obj;
3616    struct atom_svid2_voltage_object_v4 svid2_voltage_obj;
3617    struct atom_merged_voltage_object_v4 merged_voltage_obj;
3618  };
3619  
3620  struct  atom_voltage_objects_info_v4_1
3621  {
3622    struct atom_common_table_header table_header;
3623    union atom_voltage_object_v4 voltage_object[1];   //Info for Voltage control
3624  };
3625  
3626  
3627  /*
3628    ***************************************************************************
3629                All Command Function structure definition
3630    ***************************************************************************
3631  */
3632  
3633  /*
3634    ***************************************************************************
3635                Structures used by asic_init
3636    ***************************************************************************
3637  */
3638  
3639  struct asic_init_engine_parameters
3640  {
3641    uint32_t sclkfreqin10khz:24;
3642    uint32_t engineflag:8;              /* enum atom_asic_init_engine_flag  */
3643  };
3644  
3645  struct asic_init_mem_parameters
3646  {
3647    uint32_t mclkfreqin10khz:24;
3648    uint32_t memflag:8;                 /* enum atom_asic_init_mem_flag  */
3649  };
3650  
3651  struct asic_init_parameters_v2_1
3652  {
3653    struct asic_init_engine_parameters engineparam;
3654    struct asic_init_mem_parameters memparam;
3655  };
3656  
3657  struct asic_init_ps_allocation_v2_1
3658  {
3659    struct asic_init_parameters_v2_1 param;
3660    uint32_t reserved[16];
3661  };
3662  
3663  
3664  enum atom_asic_init_engine_flag
3665  {
3666    b3NORMAL_ENGINE_INIT = 0,
3667    b3SRIOV_SKIP_ASIC_INIT = 0x02,
3668    b3SRIOV_LOAD_UCODE = 0x40,
3669  };
3670  
3671  enum atom_asic_init_mem_flag
3672  {
3673    b3NORMAL_MEM_INIT = 0,
3674    b3DRAM_SELF_REFRESH_EXIT =0x20,
3675  };
3676  
3677  /*
3678    ***************************************************************************
3679                Structures used by setengineclock
3680    ***************************************************************************
3681  */
3682  
3683  struct set_engine_clock_parameters_v2_1
3684  {
3685    uint32_t sclkfreqin10khz:24;
3686    uint32_t sclkflag:8;              /* enum atom_set_engine_mem_clock_flag,  */
3687    uint32_t reserved[10];
3688  };
3689  
3690  struct set_engine_clock_ps_allocation_v2_1
3691  {
3692    struct set_engine_clock_parameters_v2_1 clockinfo;
3693    uint32_t reserved[10];
3694  };
3695  
3696  
3697  enum atom_set_engine_mem_clock_flag
3698  {
3699    b3NORMAL_CHANGE_CLOCK = 0,
3700    b3FIRST_TIME_CHANGE_CLOCK = 0x08,
3701    b3STORE_DPM_TRAINGING = 0x40,         //Applicable to memory clock change,when set, it store specific DPM mode training result
3702  };
3703  
3704  /*
3705    ***************************************************************************
3706                Structures used by getengineclock
3707    ***************************************************************************
3708  */
3709  struct get_engine_clock_parameter
3710  {
3711    uint32_t sclk_10khz;          // current engine speed in 10KHz unit
3712    uint32_t reserved;
3713  };
3714  
3715  /*
3716    ***************************************************************************
3717                Structures used by setmemoryclock
3718    ***************************************************************************
3719  */
3720  struct set_memory_clock_parameters_v2_1
3721  {
3722    uint32_t mclkfreqin10khz:24;
3723    uint32_t mclkflag:8;              /* enum atom_set_engine_mem_clock_flag,  */
3724    uint32_t reserved[10];
3725  };
3726  
3727  struct set_memory_clock_ps_allocation_v2_1
3728  {
3729    struct set_memory_clock_parameters_v2_1 clockinfo;
3730    uint32_t reserved[10];
3731  };
3732  
3733  
3734  /*
3735    ***************************************************************************
3736                Structures used by getmemoryclock
3737    ***************************************************************************
3738  */
3739  struct get_memory_clock_parameter
3740  {
3741    uint32_t mclk_10khz;          // current engine speed in 10KHz unit
3742    uint32_t reserved;
3743  };
3744  
3745  
3746  
3747  /*
3748    ***************************************************************************
3749                Structures used by setvoltage
3750    ***************************************************************************
3751  */
3752  
3753  struct set_voltage_parameters_v1_4
3754  {
3755    uint8_t  voltagetype;                /* enum atom_voltage_type */
3756    uint8_t  command;                    /* Indicate action: Set voltage level, enum atom_set_voltage_command */
3757    uint16_t vlevel_mv;                  /* real voltage level in unit of mv or Voltage Phase (0, 1, 2, .. ) */
3758  };
3759  
3760  //set_voltage_parameters_v2_1.voltagemode
3761  enum atom_set_voltage_command{
3762    ATOM_SET_VOLTAGE  = 0,
3763    ATOM_INIT_VOLTAGE_REGULATOR = 3,
3764    ATOM_SET_VOLTAGE_PHASE = 4,
3765    ATOM_GET_LEAKAGE_ID    = 8,
3766  };
3767  
3768  struct set_voltage_ps_allocation_v1_4
3769  {
3770    struct set_voltage_parameters_v1_4 setvoltageparam;
3771    uint32_t reserved[10];
3772  };
3773  
3774  
3775  /*
3776    ***************************************************************************
3777                Structures used by computegpuclockparam
3778    ***************************************************************************
3779  */
3780  
3781  //ATOM_COMPUTE_CLOCK_FREQ.ulComputeClockFlag
3782  enum atom_gpu_clock_type
3783  {
3784    COMPUTE_GPUCLK_INPUT_FLAG_DEFAULT_GPUCLK =0x00,
3785    COMPUTE_GPUCLK_INPUT_FLAG_GFXCLK =0x01,
3786    COMPUTE_GPUCLK_INPUT_FLAG_UCLK =0x02,
3787  };
3788  
3789  struct compute_gpu_clock_input_parameter_v1_8
3790  {
3791    uint32_t  gpuclock_10khz:24;         //Input= target clock, output = actual clock
3792    uint32_t  gpu_clock_type:8;          //Input indicate clock type: enum atom_gpu_clock_type
3793    uint32_t  reserved[5];
3794  };
3795  
3796  
3797  struct compute_gpu_clock_output_parameter_v1_8
3798  {
3799    uint32_t  gpuclock_10khz:24;              //Input= target clock, output = actual clock
3800    uint32_t  dfs_did:8;                      //return parameter: DFS divider which is used to program to register directly
3801    uint32_t  pll_fb_mult;                    //Feedback Multiplier, bit 8:0 int, bit 15:12 post_div, bit 31:16 frac
3802    uint32_t  pll_ss_fbsmult;                 // Spread FB Mult: bit 8:0 int, bit 31:16 frac
3803    uint16_t  pll_ss_slew_frac;
3804    uint8_t   pll_ss_enable;
3805    uint8_t   reserved;
3806    uint32_t  reserved1[2];
3807  };
3808  
3809  
3810  
3811  /*
3812    ***************************************************************************
3813                Structures used by ReadEfuseValue
3814    ***************************************************************************
3815  */
3816  
3817  struct read_efuse_input_parameters_v3_1
3818  {
3819    uint16_t efuse_start_index;
3820    uint8_t  reserved;
3821    uint8_t  bitslen;
3822  };
3823  
3824  // ReadEfuseValue input/output parameter
3825  union read_efuse_value_parameters_v3_1
3826  {
3827    struct read_efuse_input_parameters_v3_1 efuse_info;
3828    uint32_t efusevalue;
3829  };
3830  
3831  
3832  /*
3833    ***************************************************************************
3834                Structures used by getsmuclockinfo
3835    ***************************************************************************
3836  */
3837  struct atom_get_smu_clock_info_parameters_v3_1
3838  {
3839    uint8_t syspll_id;          // 0= syspll0, 1=syspll1, 2=syspll2
3840    uint8_t clk_id;             // atom_smu9_syspll0_clock_id  (only valid when command == GET_SMU_CLOCK_INFO_V3_1_GET_CLOCK_FREQ )
3841    uint8_t command;            // enum of atom_get_smu_clock_info_command
3842    uint8_t dfsdid;             // =0: get DFS DID from register, >0, give DFS divider, (only valid when command == GET_SMU_CLOCK_INFO_V3_1_GET_CLOCK_FREQ )
3843  };
3844  
3845  enum atom_get_smu_clock_info_command
3846  {
3847    GET_SMU_CLOCK_INFO_V3_1_GET_CLOCK_FREQ       = 0,
3848    GET_SMU_CLOCK_INFO_V3_1_GET_PLLVCO_FREQ      = 1,
3849    GET_SMU_CLOCK_INFO_V3_1_GET_PLLREFCLK_FREQ   = 2,
3850  };
3851  
3852  enum atom_smu9_syspll0_clock_id
3853  {
3854    SMU9_SYSPLL0_SMNCLK_ID   = 0,       //  SMNCLK
3855    SMU9_SYSPLL0_SOCCLK_ID   = 1,       //	SOCCLK (FCLK)
3856    SMU9_SYSPLL0_MP0CLK_ID   = 2,       //	MP0CLK
3857    SMU9_SYSPLL0_MP1CLK_ID   = 3,       //	MP1CLK
3858    SMU9_SYSPLL0_LCLK_ID     = 4,       //	LCLK
3859    SMU9_SYSPLL0_DCLK_ID     = 5,       //	DCLK
3860    SMU9_SYSPLL0_VCLK_ID     = 6,       //	VCLK
3861    SMU9_SYSPLL0_ECLK_ID     = 7,       //	ECLK
3862    SMU9_SYSPLL0_DCEFCLK_ID  = 8,       //	DCEFCLK
3863    SMU9_SYSPLL0_DPREFCLK_ID = 10,      //	DPREFCLK
3864    SMU9_SYSPLL0_DISPCLK_ID  = 11,      //	DISPCLK
3865  };
3866  
3867  enum atom_smu11_syspll_id {
3868    SMU11_SYSPLL0_ID            = 0,
3869    SMU11_SYSPLL1_0_ID          = 1,
3870    SMU11_SYSPLL1_1_ID          = 2,
3871    SMU11_SYSPLL1_2_ID          = 3,
3872    SMU11_SYSPLL2_ID            = 4,
3873    SMU11_SYSPLL3_0_ID          = 5,
3874    SMU11_SYSPLL3_1_ID          = 6,
3875  };
3876  
3877  enum atom_smu11_syspll0_clock_id {
3878    SMU11_SYSPLL0_ECLK_ID     = 0,       //	ECLK
3879    SMU11_SYSPLL0_SOCCLK_ID   = 1,       //	SOCCLK
3880    SMU11_SYSPLL0_MP0CLK_ID   = 2,       //	MP0CLK
3881    SMU11_SYSPLL0_DCLK_ID     = 3,       //	DCLK
3882    SMU11_SYSPLL0_VCLK_ID     = 4,       //	VCLK
3883    SMU11_SYSPLL0_DCEFCLK_ID  = 5,       //	DCEFCLK
3884  };
3885  
3886  enum atom_smu11_syspll1_0_clock_id {
3887    SMU11_SYSPLL1_0_UCLKA_ID   = 0,       // UCLK_a
3888  };
3889  
3890  enum atom_smu11_syspll1_1_clock_id {
3891    SMU11_SYSPLL1_0_UCLKB_ID   = 0,       // UCLK_b
3892  };
3893  
3894  enum atom_smu11_syspll1_2_clock_id {
3895    SMU11_SYSPLL1_0_FCLK_ID   = 0,        // FCLK
3896  };
3897  
3898  enum atom_smu11_syspll2_clock_id {
3899    SMU11_SYSPLL2_GFXCLK_ID   = 0,        // GFXCLK
3900  };
3901  
3902  enum atom_smu11_syspll3_0_clock_id {
3903    SMU11_SYSPLL3_0_WAFCLK_ID = 0,       //	WAFCLK
3904    SMU11_SYSPLL3_0_DISPCLK_ID = 1,      //	DISPCLK
3905    SMU11_SYSPLL3_0_DPREFCLK_ID = 2,     //	DPREFCLK
3906  };
3907  
3908  enum atom_smu11_syspll3_1_clock_id {
3909    SMU11_SYSPLL3_1_MP1CLK_ID = 0,       //	MP1CLK
3910    SMU11_SYSPLL3_1_SMNCLK_ID = 1,       //	SMNCLK
3911    SMU11_SYSPLL3_1_LCLK_ID = 2,         //	LCLK
3912  };
3913  
3914  enum atom_smu12_syspll_id {
3915    SMU12_SYSPLL0_ID          = 0,
3916    SMU12_SYSPLL1_ID          = 1,
3917    SMU12_SYSPLL2_ID          = 2,
3918    SMU12_SYSPLL3_0_ID        = 3,
3919    SMU12_SYSPLL3_1_ID        = 4,
3920  };
3921  
3922  enum atom_smu12_syspll0_clock_id {
3923    SMU12_SYSPLL0_SMNCLK_ID   = 0,			//	SOCCLK
3924    SMU12_SYSPLL0_SOCCLK_ID   = 1,			//	SOCCLK
3925    SMU12_SYSPLL0_MP0CLK_ID   = 2,			//	MP0CLK
3926    SMU12_SYSPLL0_MP1CLK_ID   = 3,			//	MP1CLK
3927    SMU12_SYSPLL0_MP2CLK_ID   = 4,			//	MP2CLK
3928    SMU12_SYSPLL0_VCLK_ID     = 5,			//	VCLK
3929    SMU12_SYSPLL0_LCLK_ID     = 6,			//	LCLK
3930    SMU12_SYSPLL0_DCLK_ID     = 7,			//	DCLK
3931    SMU12_SYSPLL0_ACLK_ID     = 8,			//	ACLK
3932    SMU12_SYSPLL0_ISPCLK_ID   = 9,			//	ISPCLK
3933    SMU12_SYSPLL0_SHUBCLK_ID  = 10,			//	SHUBCLK
3934  };
3935  
3936  enum atom_smu12_syspll1_clock_id {
3937    SMU12_SYSPLL1_DISPCLK_ID  = 0,      //	DISPCLK
3938    SMU12_SYSPLL1_DPPCLK_ID   = 1,      //	DPPCLK
3939    SMU12_SYSPLL1_DPREFCLK_ID = 2,      //	DPREFCLK
3940    SMU12_SYSPLL1_DCFCLK_ID   = 3,      //	DCFCLK
3941  };
3942  
3943  enum atom_smu12_syspll2_clock_id {
3944    SMU12_SYSPLL2_Pre_GFXCLK_ID = 0,   // Pre_GFXCLK
3945  };
3946  
3947  enum atom_smu12_syspll3_0_clock_id {
3948    SMU12_SYSPLL3_0_FCLK_ID = 0,      //	FCLK
3949  };
3950  
3951  enum atom_smu12_syspll3_1_clock_id {
3952    SMU12_SYSPLL3_1_UMCCLK_ID = 0,    //	UMCCLK
3953  };
3954  
3955  struct  atom_get_smu_clock_info_output_parameters_v3_1
3956  {
3957    union {
3958      uint32_t smu_clock_freq_hz;
3959      uint32_t syspllvcofreq_10khz;
3960      uint32_t sysspllrefclk_10khz;
3961    }atom_smu_outputclkfreq;
3962  };
3963  
3964  
3965  
3966  /*
3967    ***************************************************************************
3968                Structures used by dynamicmemorysettings
3969    ***************************************************************************
3970  */
3971  
3972  enum atom_dynamic_memory_setting_command
3973  {
3974    COMPUTE_MEMORY_PLL_PARAM = 1,
3975    COMPUTE_ENGINE_PLL_PARAM = 2,
3976    ADJUST_MC_SETTING_PARAM = 3,
3977  };
3978  
3979  /* when command = COMPUTE_MEMORY_PLL_PARAM or ADJUST_MC_SETTING_PARAM */
3980  struct dynamic_mclk_settings_parameters_v2_1
3981  {
3982    uint32_t  mclk_10khz:24;         //Input= target mclk
3983    uint32_t  command:8;             //command enum of atom_dynamic_memory_setting_command
3984    uint32_t  reserved;
3985  };
3986  
3987  /* when command = COMPUTE_ENGINE_PLL_PARAM */
3988  struct dynamic_sclk_settings_parameters_v2_1
3989  {
3990    uint32_t  sclk_10khz:24;         //Input= target mclk
3991    uint32_t  command:8;             //command enum of atom_dynamic_memory_setting_command
3992    uint32_t  mclk_10khz;
3993    uint32_t  reserved;
3994  };
3995  
3996  union dynamic_memory_settings_parameters_v2_1
3997  {
3998    struct dynamic_mclk_settings_parameters_v2_1 mclk_setting;
3999    struct dynamic_sclk_settings_parameters_v2_1 sclk_setting;
4000  };
4001  
4002  
4003  
4004  /*
4005    ***************************************************************************
4006                Structures used by memorytraining
4007    ***************************************************************************
4008  */
4009  
4010  enum atom_umc6_0_ucode_function_call_enum_id
4011  {
4012    UMC60_UCODE_FUNC_ID_REINIT                 = 0,
4013    UMC60_UCODE_FUNC_ID_ENTER_SELFREFRESH      = 1,
4014    UMC60_UCODE_FUNC_ID_EXIT_SELFREFRESH       = 2,
4015  };
4016  
4017  
4018  struct memory_training_parameters_v2_1
4019  {
4020    uint8_t ucode_func_id;
4021    uint8_t ucode_reserved[3];
4022    uint32_t reserved[5];
4023  };
4024  
4025  
4026  /*
4027    ***************************************************************************
4028                Structures used by setpixelclock
4029    ***************************************************************************
4030  */
4031  
4032  struct set_pixel_clock_parameter_v1_7
4033  {
4034      uint32_t pixclk_100hz;               // target the pixel clock to drive the CRTC timing in unit of 100Hz.
4035  
4036      uint8_t  pll_id;                     // ATOM_PHY_PLL0/ATOM_PHY_PLL1/ATOM_PPLL0
4037      uint8_t  encoderobjid;               // ASIC encoder id defined in objectId.h,
4038                                           // indicate which graphic encoder will be used.
4039      uint8_t  encoder_mode;               // Encoder mode:
4040      uint8_t  miscinfo;                   // enum atom_set_pixel_clock_v1_7_misc_info
4041      uint8_t  crtc_id;                    // enum of atom_crtc_def
4042      uint8_t  deep_color_ratio;           // HDMI panel bit depth: enum atom_set_pixel_clock_v1_7_deepcolor_ratio
4043      uint8_t  reserved1[2];
4044      uint32_t reserved2;
4045  };
4046  
4047  //ucMiscInfo
4048  enum atom_set_pixel_clock_v1_7_misc_info
4049  {
4050    PIXEL_CLOCK_V7_MISC_FORCE_PROG_PPLL         = 0x01,
4051    PIXEL_CLOCK_V7_MISC_PROG_PHYPLL             = 0x02,
4052    PIXEL_CLOCK_V7_MISC_YUV420_MODE             = 0x04,
4053    PIXEL_CLOCK_V7_MISC_DVI_DUALLINK_EN         = 0x08,
4054    PIXEL_CLOCK_V7_MISC_REF_DIV_SRC             = 0x30,
4055    PIXEL_CLOCK_V7_MISC_REF_DIV_SRC_XTALIN      = 0x00,
4056    PIXEL_CLOCK_V7_MISC_REF_DIV_SRC_PCIE        = 0x10,
4057    PIXEL_CLOCK_V7_MISC_REF_DIV_SRC_GENLK       = 0x20,
4058    PIXEL_CLOCK_V7_MISC_REF_DIV_SRC_REFPAD      = 0x30,
4059    PIXEL_CLOCK_V7_MISC_ATOMIC_UPDATE           = 0x40,
4060    PIXEL_CLOCK_V7_MISC_FORCE_SS_DIS            = 0x80,
4061  };
4062  
4063  /* deep_color_ratio */
4064  enum atom_set_pixel_clock_v1_7_deepcolor_ratio
4065  {
4066    PIXEL_CLOCK_V7_DEEPCOLOR_RATIO_DIS          = 0x00,      //00 - DCCG_DEEP_COLOR_DTO_DISABLE: Disable Deep Color DTO
4067    PIXEL_CLOCK_V7_DEEPCOLOR_RATIO_5_4          = 0x01,      //01 - DCCG_DEEP_COLOR_DTO_5_4_RATIO: Set Deep Color DTO to 5:4
4068    PIXEL_CLOCK_V7_DEEPCOLOR_RATIO_3_2          = 0x02,      //02 - DCCG_DEEP_COLOR_DTO_3_2_RATIO: Set Deep Color DTO to 3:2
4069    PIXEL_CLOCK_V7_DEEPCOLOR_RATIO_2_1          = 0x03,      //03 - DCCG_DEEP_COLOR_DTO_2_1_RATIO: Set Deep Color DTO to 2:1
4070  };
4071  
4072  /*
4073    ***************************************************************************
4074                Structures used by setdceclock
4075    ***************************************************************************
4076  */
4077  
4078  // SetDCEClock input parameter for DCE11.2( ELM and BF ) and above
4079  struct set_dce_clock_parameters_v2_1
4080  {
4081    uint32_t dceclk_10khz;                               // target DCE frequency in unit of 10KHZ, return real DISPCLK/DPREFCLK frequency.
4082    uint8_t  dceclktype;                                 // =0: DISPCLK  =1: DPREFCLK  =2: PIXCLK
4083    uint8_t  dceclksrc;                                  // ATOM_PLL0 or ATOM_GCK_DFS or ATOM_FCH_CLK or ATOM_COMBOPHY_PLLx
4084    uint8_t  dceclkflag;                                 // Bit [1:0] = PPLL ref clock source ( when ucDCEClkSrc= ATOM_PPLL0 )
4085    uint8_t  crtc_id;                                    // ucDisp Pipe Id, ATOM_CRTC0/1/2/..., use only when ucDCEClkType = PIXCLK
4086  };
4087  
4088  //ucDCEClkType
4089  enum atom_set_dce_clock_clock_type
4090  {
4091    DCE_CLOCK_TYPE_DISPCLK                      = 0,
4092    DCE_CLOCK_TYPE_DPREFCLK                     = 1,
4093    DCE_CLOCK_TYPE_PIXELCLK                     = 2,        // used by VBIOS internally, called by SetPixelClock
4094  };
4095  
4096  //ucDCEClkFlag when ucDCEClkType == DPREFCLK
4097  enum atom_set_dce_clock_dprefclk_flag
4098  {
4099    DCE_CLOCK_FLAG_PLL_REFCLK_SRC_MASK          = 0x03,
4100    DCE_CLOCK_FLAG_PLL_REFCLK_SRC_GENERICA      = 0x00,
4101    DCE_CLOCK_FLAG_PLL_REFCLK_SRC_GENLK         = 0x01,
4102    DCE_CLOCK_FLAG_PLL_REFCLK_SRC_PCIE          = 0x02,
4103    DCE_CLOCK_FLAG_PLL_REFCLK_SRC_XTALIN        = 0x03,
4104  };
4105  
4106  //ucDCEClkFlag when ucDCEClkType == PIXCLK
4107  enum atom_set_dce_clock_pixclk_flag
4108  {
4109    DCE_CLOCK_FLAG_PCLK_DEEPCOLOR_RATIO_MASK    = 0x03,
4110    DCE_CLOCK_FLAG_PCLK_DEEPCOLOR_RATIO_DIS     = 0x00,      //00 - DCCG_DEEP_COLOR_DTO_DISABLE: Disable Deep Color DTO
4111    DCE_CLOCK_FLAG_PCLK_DEEPCOLOR_RATIO_5_4     = 0x01,      //01 - DCCG_DEEP_COLOR_DTO_5_4_RATIO: Set Deep Color DTO to 5:4
4112    DCE_CLOCK_FLAG_PCLK_DEEPCOLOR_RATIO_3_2     = 0x02,      //02 - DCCG_DEEP_COLOR_DTO_3_2_RATIO: Set Deep Color DTO to 3:2
4113    DCE_CLOCK_FLAG_PCLK_DEEPCOLOR_RATIO_2_1     = 0x03,      //03 - DCCG_DEEP_COLOR_DTO_2_1_RATIO: Set Deep Color DTO to 2:1
4114    DCE_CLOCK_FLAG_PIXCLK_YUV420_MODE           = 0x04,
4115  };
4116  
4117  struct set_dce_clock_ps_allocation_v2_1
4118  {
4119    struct set_dce_clock_parameters_v2_1 param;
4120    uint32_t ulReserved[2];
4121  };
4122  
4123  
4124  /****************************************************************************/
4125  // Structures used by BlankCRTC
4126  /****************************************************************************/
4127  struct blank_crtc_parameters
4128  {
4129    uint8_t  crtc_id;                   // enum atom_crtc_def
4130    uint8_t  blanking;                  // enum atom_blank_crtc_command
4131    uint16_t reserved;
4132    uint32_t reserved1;
4133  };
4134  
4135  enum atom_blank_crtc_command
4136  {
4137    ATOM_BLANKING         = 1,
4138    ATOM_BLANKING_OFF     = 0,
4139  };
4140  
4141  /****************************************************************************/
4142  // Structures used by enablecrtc
4143  /****************************************************************************/
4144  struct enable_crtc_parameters
4145  {
4146    uint8_t crtc_id;                    // enum atom_crtc_def
4147    uint8_t enable;                     // ATOM_ENABLE or ATOM_DISABLE
4148    uint8_t padding[2];
4149  };
4150  
4151  
4152  /****************************************************************************/
4153  // Structure used by EnableDispPowerGating
4154  /****************************************************************************/
4155  struct enable_disp_power_gating_parameters_v2_1
4156  {
4157    uint8_t disp_pipe_id;                // ATOM_CRTC1, ATOM_CRTC2, ...
4158    uint8_t enable;                     // ATOM_ENABLE or ATOM_DISABLE
4159    uint8_t padding[2];
4160  };
4161  
4162  struct enable_disp_power_gating_ps_allocation
4163  {
4164    struct enable_disp_power_gating_parameters_v2_1 param;
4165    uint32_t ulReserved[4];
4166  };
4167  
4168  /****************************************************************************/
4169  // Structure used in setcrtc_usingdtdtiming
4170  /****************************************************************************/
4171  struct set_crtc_using_dtd_timing_parameters
4172  {
4173    uint16_t  h_size;
4174    uint16_t  h_blanking_time;
4175    uint16_t  v_size;
4176    uint16_t  v_blanking_time;
4177    uint16_t  h_syncoffset;
4178    uint16_t  h_syncwidth;
4179    uint16_t  v_syncoffset;
4180    uint16_t  v_syncwidth;
4181    uint16_t  modemiscinfo;
4182    uint8_t   h_border;
4183    uint8_t   v_border;
4184    uint8_t   crtc_id;                   // enum atom_crtc_def
4185    uint8_t   encoder_mode;			   // atom_encode_mode_def
4186    uint8_t   padding[2];
4187  };
4188  
4189  
4190  /****************************************************************************/
4191  // Structures used by processi2cchanneltransaction
4192  /****************************************************************************/
4193  struct process_i2c_channel_transaction_parameters
4194  {
4195    uint8_t i2cspeed_khz;
4196    union {
4197      uint8_t regindex;
4198      uint8_t status;                  /* enum atom_process_i2c_flag */
4199    } regind_status;
4200    uint16_t  i2c_data_out;
4201    uint8_t   flag;                    /* enum atom_process_i2c_status */
4202    uint8_t   trans_bytes;
4203    uint8_t   slave_addr;
4204    uint8_t   i2c_id;
4205  };
4206  
4207  //ucFlag
4208  enum atom_process_i2c_flag
4209  {
4210    HW_I2C_WRITE          = 1,
4211    HW_I2C_READ           = 0,
4212    I2C_2BYTE_ADDR        = 0x02,
4213    HW_I2C_SMBUS_BYTE_WR  = 0x04,
4214  };
4215  
4216  //status
4217  enum atom_process_i2c_status
4218  {
4219    HW_ASSISTED_I2C_STATUS_FAILURE     =2,
4220    HW_ASSISTED_I2C_STATUS_SUCCESS     =1,
4221  };
4222  
4223  
4224  /****************************************************************************/
4225  // Structures used by processauxchanneltransaction
4226  /****************************************************************************/
4227  
4228  struct process_aux_channel_transaction_parameters_v1_2
4229  {
4230    uint16_t aux_request;
4231    uint16_t dataout;
4232    uint8_t  channelid;
4233    union {
4234      uint8_t   reply_status;
4235      uint8_t   aux_delay;
4236    } aux_status_delay;
4237    uint8_t   dataout_len;
4238    uint8_t   hpd_id;                                       //=0: HPD1, =1: HPD2, =2: HPD3, =3: HPD4, =4: HPD5, =5: HPD6
4239  };
4240  
4241  
4242  /****************************************************************************/
4243  // Structures used by selectcrtc_source
4244  /****************************************************************************/
4245  
4246  struct select_crtc_source_parameters_v2_3
4247  {
4248    uint8_t crtc_id;                        // enum atom_crtc_def
4249    uint8_t encoder_id;                     // enum atom_dig_def
4250    uint8_t encode_mode;                    // enum atom_encode_mode_def
4251    uint8_t dst_bpc;                        // enum atom_panel_bit_per_color
4252  };
4253  
4254  
4255  /****************************************************************************/
4256  // Structures used by digxencodercontrol
4257  /****************************************************************************/
4258  
4259  // ucAction:
4260  enum atom_dig_encoder_control_action
4261  {
4262    ATOM_ENCODER_CMD_DISABLE_DIG                  = 0,
4263    ATOM_ENCODER_CMD_ENABLE_DIG                   = 1,
4264    ATOM_ENCODER_CMD_DP_LINK_TRAINING_START       = 0x08,
4265    ATOM_ENCODER_CMD_DP_LINK_TRAINING_PATTERN1    = 0x09,
4266    ATOM_ENCODER_CMD_DP_LINK_TRAINING_PATTERN2    = 0x0a,
4267    ATOM_ENCODER_CMD_DP_LINK_TRAINING_PATTERN3    = 0x13,
4268    ATOM_ENCODER_CMD_DP_LINK_TRAINING_COMPLETE    = 0x0b,
4269    ATOM_ENCODER_CMD_DP_VIDEO_OFF                 = 0x0c,
4270    ATOM_ENCODER_CMD_DP_VIDEO_ON                  = 0x0d,
4271    ATOM_ENCODER_CMD_SETUP_PANEL_MODE             = 0x10,
4272    ATOM_ENCODER_CMD_DP_LINK_TRAINING_PATTERN4    = 0x14,
4273    ATOM_ENCODER_CMD_STREAM_SETUP                 = 0x0F,
4274    ATOM_ENCODER_CMD_LINK_SETUP                   = 0x11,
4275    ATOM_ENCODER_CMD_ENCODER_BLANK                = 0x12,
4276  };
4277  
4278  //define ucPanelMode
4279  enum atom_dig_encoder_control_panelmode
4280  {
4281    DP_PANEL_MODE_DISABLE                        = 0x00,
4282    DP_PANEL_MODE_ENABLE_eDP_MODE                = 0x01,
4283    DP_PANEL_MODE_ENABLE_LVLINK_MODE             = 0x11,
4284  };
4285  
4286  //ucDigId
4287  enum atom_dig_encoder_control_v5_digid
4288  {
4289    ATOM_ENCODER_CONFIG_V5_DIG0_ENCODER           = 0x00,
4290    ATOM_ENCODER_CONFIG_V5_DIG1_ENCODER           = 0x01,
4291    ATOM_ENCODER_CONFIG_V5_DIG2_ENCODER           = 0x02,
4292    ATOM_ENCODER_CONFIG_V5_DIG3_ENCODER           = 0x03,
4293    ATOM_ENCODER_CONFIG_V5_DIG4_ENCODER           = 0x04,
4294    ATOM_ENCODER_CONFIG_V5_DIG5_ENCODER           = 0x05,
4295    ATOM_ENCODER_CONFIG_V5_DIG6_ENCODER           = 0x06,
4296    ATOM_ENCODER_CONFIG_V5_DIG7_ENCODER           = 0x07,
4297  };
4298  
4299  struct dig_encoder_stream_setup_parameters_v1_5
4300  {
4301    uint8_t digid;            // 0~6 map to DIG0~DIG6 enum atom_dig_encoder_control_v5_digid
4302    uint8_t action;           // =  ATOM_ENOCODER_CMD_STREAM_SETUP
4303    uint8_t digmode;          // ATOM_ENCODER_MODE_DP/ATOM_ENCODER_MODE_DVI/ATOM_ENCODER_MODE_HDMI
4304    uint8_t lanenum;          // Lane number
4305    uint32_t pclk_10khz;      // Pixel Clock in 10Khz
4306    uint8_t bitpercolor;
4307    uint8_t dplinkrate_270mhz;//= DP link rate/270Mhz, =6: 1.62G  = 10: 2.7G, =20: 5.4Ghz, =30: 8.1Ghz etc
4308    uint8_t reserved[2];
4309  };
4310  
4311  struct dig_encoder_link_setup_parameters_v1_5
4312  {
4313    uint8_t digid;           // 0~6 map to DIG0~DIG6 enum atom_dig_encoder_control_v5_digid
4314    uint8_t action;          // =  ATOM_ENOCODER_CMD_LINK_SETUP
4315    uint8_t digmode;         // ATOM_ENCODER_MODE_DP/ATOM_ENCODER_MODE_DVI/ATOM_ENCODER_MODE_HDMI
4316    uint8_t lanenum;         // Lane number
4317    uint8_t symclk_10khz;    // Symbol Clock in 10Khz
4318    uint8_t hpd_sel;
4319    uint8_t digfe_sel;       // DIG stream( front-end ) selection, bit0 means DIG0 FE is enable,
4320    uint8_t reserved[2];
4321  };
4322  
4323  struct dp_panel_mode_set_parameters_v1_5
4324  {
4325    uint8_t digid;              // 0~6 map to DIG0~DIG6 enum atom_dig_encoder_control_v5_digid
4326    uint8_t action;             // = ATOM_ENCODER_CMD_DPLINK_SETUP
4327    uint8_t panelmode;      // enum atom_dig_encoder_control_panelmode
4328    uint8_t reserved1;
4329    uint32_t reserved2[2];
4330  };
4331  
4332  struct dig_encoder_generic_cmd_parameters_v1_5
4333  {
4334    uint8_t digid;           // 0~6 map to DIG0~DIG6 enum atom_dig_encoder_control_v5_digid
4335    uint8_t action;          // = rest of generic encoder command which does not carry any parameters
4336    uint8_t reserved1[2];
4337    uint32_t reserved2[2];
4338  };
4339  
4340  union dig_encoder_control_parameters_v1_5
4341  {
4342    struct dig_encoder_generic_cmd_parameters_v1_5  cmd_param;
4343    struct dig_encoder_stream_setup_parameters_v1_5 stream_param;
4344    struct dig_encoder_link_setup_parameters_v1_5   link_param;
4345    struct dp_panel_mode_set_parameters_v1_5 dppanel_param;
4346  };
4347  
4348  /*
4349    ***************************************************************************
4350                Structures used by dig1transmittercontrol
4351    ***************************************************************************
4352  */
4353  struct dig_transmitter_control_parameters_v1_6
4354  {
4355    uint8_t phyid;           // 0=UNIPHYA, 1=UNIPHYB, 2=UNIPHYC, 3=UNIPHYD, 4= UNIPHYE 5=UNIPHYF
4356    uint8_t action;          // define as ATOM_TRANSMITER_ACTION_xxx
4357    union {
4358      uint8_t digmode;        // enum atom_encode_mode_def
4359      uint8_t dplaneset;      // DP voltage swing and pre-emphasis value defined in DPCD DP_LANE_SET, "DP_LANE_SET__xDB_y_zV"
4360    } mode_laneset;
4361    uint8_t  lanenum;        // Lane number 1, 2, 4, 8
4362    uint32_t symclk_10khz;   // Symbol Clock in 10Khz
4363    uint8_t  hpdsel;         // =1: HPD1, =2: HPD2, .... =6: HPD6, =0: HPD is not assigned
4364    uint8_t  digfe_sel;      // DIG stream( front-end ) selection, bit0 means DIG0 FE is enable,
4365    uint8_t  connobj_id;     // Connector Object Id defined in ObjectId.h
4366    uint8_t  reserved;
4367    uint32_t reserved1;
4368  };
4369  
4370  struct dig_transmitter_control_ps_allocation_v1_6
4371  {
4372    struct dig_transmitter_control_parameters_v1_6 param;
4373    uint32_t reserved[4];
4374  };
4375  
4376  //ucAction
4377  enum atom_dig_transmitter_control_action
4378  {
4379    ATOM_TRANSMITTER_ACTION_DISABLE                 = 0,
4380    ATOM_TRANSMITTER_ACTION_ENABLE                  = 1,
4381    ATOM_TRANSMITTER_ACTION_LCD_BLOFF               = 2,
4382    ATOM_TRANSMITTER_ACTION_LCD_BLON                = 3,
4383    ATOM_TRANSMITTER_ACTION_BL_BRIGHTNESS_CONTROL   = 4,
4384    ATOM_TRANSMITTER_ACTION_LCD_SELFTEST_START      = 5,
4385    ATOM_TRANSMITTER_ACTION_LCD_SELFTEST_STOP       = 6,
4386    ATOM_TRANSMITTER_ACTION_INIT                    = 7,
4387    ATOM_TRANSMITTER_ACTION_DISABLE_OUTPUT          = 8,
4388    ATOM_TRANSMITTER_ACTION_ENABLE_OUTPUT           = 9,
4389    ATOM_TRANSMITTER_ACTION_SETUP                   = 10,
4390    ATOM_TRANSMITTER_ACTION_SETUP_VSEMPH            = 11,
4391    ATOM_TRANSMITTER_ACTION_POWER_ON                = 12,
4392    ATOM_TRANSMITTER_ACTION_POWER_OFF               = 13,
4393  };
4394  
4395  // digfe_sel
4396  enum atom_dig_transmitter_control_digfe_sel
4397  {
4398    ATOM_TRANMSITTER_V6__DIGA_SEL                   = 0x01,
4399    ATOM_TRANMSITTER_V6__DIGB_SEL                   = 0x02,
4400    ATOM_TRANMSITTER_V6__DIGC_SEL                   = 0x04,
4401    ATOM_TRANMSITTER_V6__DIGD_SEL                   = 0x08,
4402    ATOM_TRANMSITTER_V6__DIGE_SEL                   = 0x10,
4403    ATOM_TRANMSITTER_V6__DIGF_SEL                   = 0x20,
4404    ATOM_TRANMSITTER_V6__DIGG_SEL                   = 0x40,
4405  };
4406  
4407  
4408  //ucHPDSel
4409  enum atom_dig_transmitter_control_hpd_sel
4410  {
4411    ATOM_TRANSMITTER_V6_NO_HPD_SEL                  = 0x00,
4412    ATOM_TRANSMITTER_V6_HPD1_SEL                    = 0x01,
4413    ATOM_TRANSMITTER_V6_HPD2_SEL                    = 0x02,
4414    ATOM_TRANSMITTER_V6_HPD3_SEL                    = 0x03,
4415    ATOM_TRANSMITTER_V6_HPD4_SEL                    = 0x04,
4416    ATOM_TRANSMITTER_V6_HPD5_SEL                    = 0x05,
4417    ATOM_TRANSMITTER_V6_HPD6_SEL                    = 0x06,
4418  };
4419  
4420  // ucDPLaneSet
4421  enum atom_dig_transmitter_control_dplaneset
4422  {
4423    DP_LANE_SET__0DB_0_4V                           = 0x00,
4424    DP_LANE_SET__0DB_0_6V                           = 0x01,
4425    DP_LANE_SET__0DB_0_8V                           = 0x02,
4426    DP_LANE_SET__0DB_1_2V                           = 0x03,
4427    DP_LANE_SET__3_5DB_0_4V                         = 0x08,
4428    DP_LANE_SET__3_5DB_0_6V                         = 0x09,
4429    DP_LANE_SET__3_5DB_0_8V                         = 0x0a,
4430    DP_LANE_SET__6DB_0_4V                           = 0x10,
4431    DP_LANE_SET__6DB_0_6V                           = 0x11,
4432    DP_LANE_SET__9_5DB_0_4V                         = 0x18,
4433  };
4434  
4435  
4436  
4437  /****************************************************************************/
4438  // Structures used by ExternalEncoderControl V2.4
4439  /****************************************************************************/
4440  
4441  struct external_encoder_control_parameters_v2_4
4442  {
4443    uint16_t pixelclock_10khz;  // pixel clock in 10Khz, valid when ucAction=SETUP/ENABLE_OUTPUT
4444    uint8_t  config;            // indicate which encoder, and DP link rate when ucAction = SETUP/ENABLE_OUTPUT
4445    uint8_t  action;            //
4446    uint8_t  encodermode;       // encoder mode, only used when ucAction = SETUP/ENABLE_OUTPUT
4447    uint8_t  lanenum;           // lane number, only used when ucAction = SETUP/ENABLE_OUTPUT
4448    uint8_t  bitpercolor;       // output bit per color, only valid when ucAction = SETUP/ENABLE_OUTPUT and ucEncodeMode= DP
4449    uint8_t  hpd_id;
4450  };
4451  
4452  
4453  // ucAction
4454  enum external_encoder_control_action_def
4455  {
4456    EXTERNAL_ENCODER_ACTION_V3_DISABLE_OUTPUT           = 0x00,
4457    EXTERNAL_ENCODER_ACTION_V3_ENABLE_OUTPUT            = 0x01,
4458    EXTERNAL_ENCODER_ACTION_V3_ENCODER_INIT             = 0x07,
4459    EXTERNAL_ENCODER_ACTION_V3_ENCODER_SETUP            = 0x0f,
4460    EXTERNAL_ENCODER_ACTION_V3_ENCODER_BLANKING_OFF     = 0x10,
4461    EXTERNAL_ENCODER_ACTION_V3_ENCODER_BLANKING         = 0x11,
4462    EXTERNAL_ENCODER_ACTION_V3_DACLOAD_DETECTION        = 0x12,
4463    EXTERNAL_ENCODER_ACTION_V3_DDC_SETUP                = 0x14,
4464  };
4465  
4466  // ucConfig
4467  enum external_encoder_control_v2_4_config_def
4468  {
4469    EXTERNAL_ENCODER_CONFIG_V3_DPLINKRATE_MASK          = 0x03,
4470    EXTERNAL_ENCODER_CONFIG_V3_DPLINKRATE_1_62GHZ       = 0x00,
4471    EXTERNAL_ENCODER_CONFIG_V3_DPLINKRATE_2_70GHZ       = 0x01,
4472    EXTERNAL_ENCODER_CONFIG_V3_DPLINKRATE_5_40GHZ       = 0x02,
4473    EXTERNAL_ENCODER_CONFIG_V3_DPLINKRATE_3_24GHZ       = 0x03,
4474    EXTERNAL_ENCODER_CONFIG_V3_ENCODER_SEL_MAKS         = 0x70,
4475    EXTERNAL_ENCODER_CONFIG_V3_ENCODER1                 = 0x00,
4476    EXTERNAL_ENCODER_CONFIG_V3_ENCODER2                 = 0x10,
4477    EXTERNAL_ENCODER_CONFIG_V3_ENCODER3                 = 0x20,
4478  };
4479  
4480  struct external_encoder_control_ps_allocation_v2_4
4481  {
4482    struct external_encoder_control_parameters_v2_4 sExtEncoder;
4483    uint32_t reserved[2];
4484  };
4485  
4486  
4487  /*
4488    ***************************************************************************
4489                             AMD ACPI Table
4490  
4491    ***************************************************************************
4492  */
4493  
4494  struct amd_acpi_description_header{
4495    uint32_t signature;
4496    uint32_t tableLength;      //Length
4497    uint8_t  revision;
4498    uint8_t  checksum;
4499    uint8_t  oemId[6];
4500    uint8_t  oemTableId[8];    //UINT64  OemTableId;
4501    uint32_t oemRevision;
4502    uint32_t creatorId;
4503    uint32_t creatorRevision;
4504  };
4505  
4506  struct uefi_acpi_vfct{
4507    struct   amd_acpi_description_header sheader;
4508    uint8_t  tableUUID[16];    //0x24
4509    uint32_t vbiosimageoffset; //0x34. Offset to the first GOP_VBIOS_CONTENT block from the beginning of the stucture.
4510    uint32_t lib1Imageoffset;  //0x38. Offset to the first GOP_LIB1_CONTENT block from the beginning of the stucture.
4511    uint32_t reserved[4];      //0x3C
4512  };
4513  
4514  struct vfct_image_header{
4515    uint32_t  pcibus;          //0x4C
4516    uint32_t  pcidevice;       //0x50
4517    uint32_t  pcifunction;     //0x54
4518    uint16_t  vendorid;        //0x58
4519    uint16_t  deviceid;        //0x5A
4520    uint16_t  ssvid;           //0x5C
4521    uint16_t  ssid;            //0x5E
4522    uint32_t  revision;        //0x60
4523    uint32_t  imagelength;     //0x64
4524  };
4525  
4526  
4527  struct gop_vbios_content {
4528    struct vfct_image_header vbiosheader;
4529    uint8_t                  vbioscontent[1];
4530  };
4531  
4532  struct gop_lib1_content {
4533    struct vfct_image_header lib1header;
4534    uint8_t                  lib1content[1];
4535  };
4536  
4537  
4538  
4539  /*
4540    ***************************************************************************
4541                     Scratch Register definitions
4542    Each number below indicates which scratch regiser request, Active and
4543    Connect all share the same definitions as display_device_tag defines
4544    ***************************************************************************
4545  */
4546  
4547  enum scratch_register_def{
4548    ATOM_DEVICE_CONNECT_INFO_DEF      = 0,
4549    ATOM_BL_BRI_LEVEL_INFO_DEF        = 2,
4550    ATOM_ACTIVE_INFO_DEF              = 3,
4551    ATOM_LCD_INFO_DEF                 = 4,
4552    ATOM_DEVICE_REQ_INFO_DEF          = 5,
4553    ATOM_ACC_CHANGE_INFO_DEF          = 6,
4554    ATOM_PRE_OS_MODE_INFO_DEF         = 7,
4555    ATOM_PRE_OS_ASSERTION_DEF      = 8,    //For GOP to record a 32bit assertion code, this is enabled by default in prodution GOP drivers.
4556    ATOM_INTERNAL_TIMER_INFO_DEF      = 10,
4557  };
4558  
4559  enum scratch_device_connect_info_bit_def{
4560    ATOM_DISPLAY_LCD1_CONNECT           =0x0002,
4561    ATOM_DISPLAY_DFP1_CONNECT           =0x0008,
4562    ATOM_DISPLAY_DFP2_CONNECT           =0x0080,
4563    ATOM_DISPLAY_DFP3_CONNECT           =0x0200,
4564    ATOM_DISPLAY_DFP4_CONNECT           =0x0400,
4565    ATOM_DISPLAY_DFP5_CONNECT           =0x0800,
4566    ATOM_DISPLAY_DFP6_CONNECT           =0x0040,
4567    ATOM_DISPLAY_DFPx_CONNECT           =0x0ec8,
4568    ATOM_CONNECT_INFO_DEVICE_MASK       =0x0fff,
4569  };
4570  
4571  enum scratch_bl_bri_level_info_bit_def{
4572    ATOM_CURRENT_BL_LEVEL_SHIFT         =0x8,
4573  #ifndef _H2INC
4574    ATOM_CURRENT_BL_LEVEL_MASK          =0x0000ff00,
4575    ATOM_DEVICE_DPMS_STATE              =0x00010000,
4576  #endif
4577  };
4578  
4579  enum scratch_active_info_bits_def{
4580    ATOM_DISPLAY_LCD1_ACTIVE            =0x0002,
4581    ATOM_DISPLAY_DFP1_ACTIVE            =0x0008,
4582    ATOM_DISPLAY_DFP2_ACTIVE            =0x0080,
4583    ATOM_DISPLAY_DFP3_ACTIVE            =0x0200,
4584    ATOM_DISPLAY_DFP4_ACTIVE            =0x0400,
4585    ATOM_DISPLAY_DFP5_ACTIVE            =0x0800,
4586    ATOM_DISPLAY_DFP6_ACTIVE            =0x0040,
4587    ATOM_ACTIVE_INFO_DEVICE_MASK        =0x0fff,
4588  };
4589  
4590  enum scratch_device_req_info_bits_def{
4591    ATOM_DISPLAY_LCD1_REQ               =0x0002,
4592    ATOM_DISPLAY_DFP1_REQ               =0x0008,
4593    ATOM_DISPLAY_DFP2_REQ               =0x0080,
4594    ATOM_DISPLAY_DFP3_REQ               =0x0200,
4595    ATOM_DISPLAY_DFP4_REQ               =0x0400,
4596    ATOM_DISPLAY_DFP5_REQ               =0x0800,
4597    ATOM_DISPLAY_DFP6_REQ               =0x0040,
4598    ATOM_REQ_INFO_DEVICE_MASK           =0x0fff,
4599  };
4600  
4601  enum scratch_acc_change_info_bitshift_def{
4602    ATOM_ACC_CHANGE_ACC_MODE_SHIFT    =4,
4603    ATOM_ACC_CHANGE_LID_STATUS_SHIFT  =6,
4604  };
4605  
4606  enum scratch_acc_change_info_bits_def{
4607    ATOM_ACC_CHANGE_ACC_MODE          =0x00000010,
4608    ATOM_ACC_CHANGE_LID_STATUS        =0x00000040,
4609  };
4610  
4611  enum scratch_pre_os_mode_info_bits_def{
4612    ATOM_PRE_OS_MODE_MASK             =0x00000003,
4613    ATOM_PRE_OS_MODE_VGA              =0x00000000,
4614    ATOM_PRE_OS_MODE_VESA             =0x00000001,
4615    ATOM_PRE_OS_MODE_GOP              =0x00000002,
4616    ATOM_PRE_OS_MODE_PIXEL_DEPTH      =0x0000000C,
4617    ATOM_PRE_OS_MODE_PIXEL_FORMAT_MASK=0x000000F0,
4618    ATOM_PRE_OS_MODE_8BIT_PAL_EN      =0x00000100,
4619    ATOM_ASIC_INIT_COMPLETE           =0x00000200,
4620  #ifndef _H2INC
4621    ATOM_PRE_OS_MODE_NUMBER_MASK      =0xFFFF0000,
4622  #endif
4623  };
4624  
4625  
4626  
4627  /*
4628    ***************************************************************************
4629                         ATOM firmware ID header file
4630                !! Please keep it at end of the atomfirmware.h !!
4631    ***************************************************************************
4632  */
4633  #include "atomfirmwareid.h"
4634  #pragma pack()
4635  
4636  #endif
4637  
4638