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