17695d08fSVinay Belgaumkar /* SPDX-License-Identifier: MIT */ 27695d08fSVinay Belgaumkar /* 37695d08fSVinay Belgaumkar * Copyright © 2021 Intel Corporation 47695d08fSVinay Belgaumkar */ 57695d08fSVinay Belgaumkar 67695d08fSVinay Belgaumkar #ifndef _GUC_ACTIONS_SLPC_ABI_H_ 77695d08fSVinay Belgaumkar #define _GUC_ACTIONS_SLPC_ABI_H_ 87695d08fSVinay Belgaumkar 97695d08fSVinay Belgaumkar #include <linux/types.h> 107695d08fSVinay Belgaumkar 117695d08fSVinay Belgaumkar /** 127695d08fSVinay Belgaumkar * DOC: SLPC SHARED DATA STRUCTURE 137695d08fSVinay Belgaumkar * 147695d08fSVinay Belgaumkar * +----+------+--------------------------------------------------------------+ 157695d08fSVinay Belgaumkar * | CL | Bytes| Description | 167695d08fSVinay Belgaumkar * +====+======+==============================================================+ 177695d08fSVinay Belgaumkar * | 1 | 0-3 | SHARED DATA SIZE | 187695d08fSVinay Belgaumkar * | +------+--------------------------------------------------------------+ 197695d08fSVinay Belgaumkar * | | 4-7 | GLOBAL STATE | 207695d08fSVinay Belgaumkar * | +------+--------------------------------------------------------------+ 217695d08fSVinay Belgaumkar * | | 8-11 | DISPLAY DATA ADDRESS | 227695d08fSVinay Belgaumkar * | +------+--------------------------------------------------------------+ 237695d08fSVinay Belgaumkar * | | 12:63| PADDING | 247695d08fSVinay Belgaumkar * +----+------+--------------------------------------------------------------+ 257695d08fSVinay Belgaumkar * | | 0:63 | PADDING(PLATFORM INFO) | 267695d08fSVinay Belgaumkar * +----+------+--------------------------------------------------------------+ 277695d08fSVinay Belgaumkar * | 3 | 0-3 | TASK STATE DATA | 287695d08fSVinay Belgaumkar * + +------+--------------------------------------------------------------+ 297695d08fSVinay Belgaumkar * | | 4:63 | PADDING | 307695d08fSVinay Belgaumkar * +----+------+--------------------------------------------------------------+ 317695d08fSVinay Belgaumkar * |4-21|0:1087| OVERRIDE PARAMS AND BIT FIELDS | 327695d08fSVinay Belgaumkar * +----+------+--------------------------------------------------------------+ 337695d08fSVinay Belgaumkar * | | | PADDING + EXTRA RESERVED PAGE | 347695d08fSVinay Belgaumkar * +----+------+--------------------------------------------------------------+ 357695d08fSVinay Belgaumkar */ 367695d08fSVinay Belgaumkar 377695d08fSVinay Belgaumkar /* 387695d08fSVinay Belgaumkar * SLPC exposes certain parameters for global configuration by the host. 397695d08fSVinay Belgaumkar * These are referred to as override parameters, because in most cases 407695d08fSVinay Belgaumkar * the host will not need to modify the default values used by SLPC. 417695d08fSVinay Belgaumkar * SLPC remembers the default values which allows the host to easily restore 427695d08fSVinay Belgaumkar * them by simply unsetting the override. The host can set or unset override 437695d08fSVinay Belgaumkar * parameters during SLPC (re-)initialization using the SLPC Reset event. 447695d08fSVinay Belgaumkar * The host can also set or unset override parameters on the fly using the 457695d08fSVinay Belgaumkar * Parameter Set and Parameter Unset events 467695d08fSVinay Belgaumkar */ 477695d08fSVinay Belgaumkar 487695d08fSVinay Belgaumkar #define SLPC_MAX_OVERRIDE_PARAMETERS 256 497695d08fSVinay Belgaumkar #define SLPC_OVERRIDE_BITFIELD_SIZE \ 507695d08fSVinay Belgaumkar (SLPC_MAX_OVERRIDE_PARAMETERS / 32) 517695d08fSVinay Belgaumkar 527695d08fSVinay Belgaumkar #define SLPC_PAGE_SIZE_BYTES 4096 537695d08fSVinay Belgaumkar #define SLPC_CACHELINE_SIZE_BYTES 64 547695d08fSVinay Belgaumkar #define SLPC_SHARED_DATA_SIZE_BYTE_HEADER SLPC_CACHELINE_SIZE_BYTES 557695d08fSVinay Belgaumkar #define SLPC_SHARED_DATA_SIZE_BYTE_PLATFORM_INFO SLPC_CACHELINE_SIZE_BYTES 567695d08fSVinay Belgaumkar #define SLPC_SHARED_DATA_SIZE_BYTE_TASK_STATE SLPC_CACHELINE_SIZE_BYTES 577695d08fSVinay Belgaumkar #define SLPC_SHARED_DATA_MODE_DEFN_TABLE_SIZE SLPC_PAGE_SIZE_BYTES 587695d08fSVinay Belgaumkar #define SLPC_SHARED_DATA_SIZE_BYTE_MAX (2 * SLPC_PAGE_SIZE_BYTES) 597695d08fSVinay Belgaumkar 607695d08fSVinay Belgaumkar /* 617695d08fSVinay Belgaumkar * Cacheline size aligned (Total size needed for 627695d08fSVinay Belgaumkar * SLPM_KMD_MAX_OVERRIDE_PARAMETERS=256 is 1088 bytes) 637695d08fSVinay Belgaumkar */ 647695d08fSVinay Belgaumkar #define SLPC_OVERRIDE_PARAMS_TOTAL_BYTES (((((SLPC_MAX_OVERRIDE_PARAMETERS * 4) \ 657695d08fSVinay Belgaumkar + ((SLPC_MAX_OVERRIDE_PARAMETERS / 32) * 4)) \ 667695d08fSVinay Belgaumkar + (SLPC_CACHELINE_SIZE_BYTES - 1)) / SLPC_CACHELINE_SIZE_BYTES) * \ 677695d08fSVinay Belgaumkar SLPC_CACHELINE_SIZE_BYTES) 687695d08fSVinay Belgaumkar 697695d08fSVinay Belgaumkar #define SLPC_SHARED_DATA_SIZE_BYTE_OTHER (SLPC_SHARED_DATA_SIZE_BYTE_MAX - \ 707695d08fSVinay Belgaumkar (SLPC_SHARED_DATA_SIZE_BYTE_HEADER \ 717695d08fSVinay Belgaumkar + SLPC_SHARED_DATA_SIZE_BYTE_PLATFORM_INFO \ 727695d08fSVinay Belgaumkar + SLPC_SHARED_DATA_SIZE_BYTE_TASK_STATE \ 737695d08fSVinay Belgaumkar + SLPC_OVERRIDE_PARAMS_TOTAL_BYTES \ 747695d08fSVinay Belgaumkar + SLPC_SHARED_DATA_MODE_DEFN_TABLE_SIZE)) 757695d08fSVinay Belgaumkar 767695d08fSVinay Belgaumkar enum slpc_task_enable { 777695d08fSVinay Belgaumkar SLPC_PARAM_TASK_DEFAULT = 0, 787695d08fSVinay Belgaumkar SLPC_PARAM_TASK_ENABLED, 797695d08fSVinay Belgaumkar SLPC_PARAM_TASK_DISABLED, 807695d08fSVinay Belgaumkar SLPC_PARAM_TASK_UNKNOWN 817695d08fSVinay Belgaumkar }; 827695d08fSVinay Belgaumkar 837695d08fSVinay Belgaumkar enum slpc_global_state { 847695d08fSVinay Belgaumkar SLPC_GLOBAL_STATE_NOT_RUNNING = 0, 857695d08fSVinay Belgaumkar SLPC_GLOBAL_STATE_INITIALIZING = 1, 867695d08fSVinay Belgaumkar SLPC_GLOBAL_STATE_RESETTING = 2, 877695d08fSVinay Belgaumkar SLPC_GLOBAL_STATE_RUNNING = 3, 887695d08fSVinay Belgaumkar SLPC_GLOBAL_STATE_SHUTTING_DOWN = 4, 897695d08fSVinay Belgaumkar SLPC_GLOBAL_STATE_ERROR = 5 907695d08fSVinay Belgaumkar }; 917695d08fSVinay Belgaumkar 927695d08fSVinay Belgaumkar enum slpc_param_id { 937695d08fSVinay Belgaumkar SLPC_PARAM_TASK_ENABLE_GTPERF = 0, 947695d08fSVinay Belgaumkar SLPC_PARAM_TASK_DISABLE_GTPERF = 1, 957695d08fSVinay Belgaumkar SLPC_PARAM_TASK_ENABLE_BALANCER = 2, 967695d08fSVinay Belgaumkar SLPC_PARAM_TASK_DISABLE_BALANCER = 3, 977695d08fSVinay Belgaumkar SLPC_PARAM_TASK_ENABLE_DCC = 4, 987695d08fSVinay Belgaumkar SLPC_PARAM_TASK_DISABLE_DCC = 5, 997695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_MIN_GT_UNSLICE_FREQ_MHZ = 6, 1007695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_MAX_GT_UNSLICE_FREQ_MHZ = 7, 1017695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_MIN_GT_SLICE_FREQ_MHZ = 8, 1027695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_MAX_GT_SLICE_FREQ_MHZ = 9, 1037695d08fSVinay Belgaumkar SLPC_PARAM_GTPERF_THRESHOLD_MAX_FPS = 10, 1047695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_DISABLE_GT_FREQ_MANAGEMENT = 11, 1057695d08fSVinay Belgaumkar SLPC_PARAM_GTPERF_ENABLE_FRAMERATE_STALLING = 12, 1067695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_DISABLE_RC6_MODE_CHANGE = 13, 1077695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_OC_UNSLICE_FREQ_MHZ = 14, 1087695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_OC_SLICE_FREQ_MHZ = 15, 1097695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_ENABLE_IA_GT_BALANCING = 16, 1107695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_ENABLE_ADAPTIVE_BURST_TURBO = 17, 1117695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_ENABLE_EVAL_MODE = 18, 1127695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_ENABLE_BALANCER_IN_NON_GAMING_MODE = 19, 1137695d08fSVinay Belgaumkar SLPC_PARAM_GLOBAL_RT_MODE_TURBO_FREQ_DELTA_MHZ = 20, 1147695d08fSVinay Belgaumkar SLPC_PARAM_PWRGATE_RC_MODE = 21, 1157695d08fSVinay Belgaumkar SLPC_PARAM_EDR_MODE_COMPUTE_TIMEOUT_MS = 22, 1167695d08fSVinay Belgaumkar SLPC_PARAM_EDR_QOS_FREQ_MHZ = 23, 1177695d08fSVinay Belgaumkar SLPC_PARAM_MEDIA_FF_RATIO_MODE = 24, 1187695d08fSVinay Belgaumkar SLPC_PARAM_ENABLE_IA_FREQ_LIMITING = 25, 1197695d08fSVinay Belgaumkar SLPC_PARAM_STRATEGIES = 26, 1207695d08fSVinay Belgaumkar SLPC_PARAM_POWER_PROFILE = 27, 1217695d08fSVinay Belgaumkar SLPC_PARAM_IGNORE_EFFICIENT_FREQUENCY = 28, 1227695d08fSVinay Belgaumkar SLPC_MAX_PARAM = 32, 1237695d08fSVinay Belgaumkar }; 1247695d08fSVinay Belgaumkar 12526be7cd8SAshutosh Dixit enum slpc_media_ratio_mode { 12626be7cd8SAshutosh Dixit SLPC_MEDIA_RATIO_MODE_DYNAMIC_CONTROL = 0, 12726be7cd8SAshutosh Dixit SLPC_MEDIA_RATIO_MODE_FIXED_ONE_TO_ONE = 1, 12826be7cd8SAshutosh Dixit SLPC_MEDIA_RATIO_MODE_FIXED_ONE_TO_TWO = 2, 12926be7cd8SAshutosh Dixit }; 13026be7cd8SAshutosh Dixit 131*01e74274SVinay Belgaumkar enum slpc_gucrc_mode { 132*01e74274SVinay Belgaumkar SLPC_GUCRC_MODE_HW = 0, 133*01e74274SVinay Belgaumkar SLPC_GUCRC_MODE_GUCRC_NO_RC6 = 1, 134*01e74274SVinay Belgaumkar SLPC_GUCRC_MODE_GUCRC_STATIC_TIMEOUT = 2, 135*01e74274SVinay Belgaumkar SLPC_GUCRC_MODE_GUCRC_DYNAMIC_HYSTERESIS = 3, 136*01e74274SVinay Belgaumkar 137*01e74274SVinay Belgaumkar SLPC_GUCRC_MODE_MAX, 138*01e74274SVinay Belgaumkar }; 139*01e74274SVinay Belgaumkar 1407695d08fSVinay Belgaumkar enum slpc_event_id { 1417695d08fSVinay Belgaumkar SLPC_EVENT_RESET = 0, 1427695d08fSVinay Belgaumkar SLPC_EVENT_SHUTDOWN = 1, 1437695d08fSVinay Belgaumkar SLPC_EVENT_PLATFORM_INFO_CHANGE = 2, 1447695d08fSVinay Belgaumkar SLPC_EVENT_DISPLAY_MODE_CHANGE = 3, 1457695d08fSVinay Belgaumkar SLPC_EVENT_FLIP_COMPLETE = 4, 1467695d08fSVinay Belgaumkar SLPC_EVENT_QUERY_TASK_STATE = 5, 1477695d08fSVinay Belgaumkar SLPC_EVENT_PARAMETER_SET = 6, 1487695d08fSVinay Belgaumkar SLPC_EVENT_PARAMETER_UNSET = 7, 1497695d08fSVinay Belgaumkar }; 1507695d08fSVinay Belgaumkar 1517695d08fSVinay Belgaumkar struct slpc_task_state_data { 1527695d08fSVinay Belgaumkar union { 1537695d08fSVinay Belgaumkar u32 task_status_padding; 1547695d08fSVinay Belgaumkar struct { 1557695d08fSVinay Belgaumkar u32 status; 1567695d08fSVinay Belgaumkar #define SLPC_GTPERF_TASK_ENABLED REG_BIT(0) 1577695d08fSVinay Belgaumkar #define SLPC_DCC_TASK_ENABLED REG_BIT(11) 1587695d08fSVinay Belgaumkar #define SLPC_IN_DCC REG_BIT(12) 1597695d08fSVinay Belgaumkar #define SLPC_BALANCER_ENABLED REG_BIT(15) 1607695d08fSVinay Belgaumkar #define SLPC_IBC_TASK_ENABLED REG_BIT(16) 1617695d08fSVinay Belgaumkar #define SLPC_BALANCER_IA_LMT_ENABLED REG_BIT(17) 1627695d08fSVinay Belgaumkar #define SLPC_BALANCER_IA_LMT_ACTIVE REG_BIT(18) 1637695d08fSVinay Belgaumkar }; 1647695d08fSVinay Belgaumkar }; 1657695d08fSVinay Belgaumkar union { 1667695d08fSVinay Belgaumkar u32 freq_padding; 1677695d08fSVinay Belgaumkar struct { 1687695d08fSVinay Belgaumkar #define SLPC_MAX_UNSLICE_FREQ_MASK REG_GENMASK(7, 0) 1697695d08fSVinay Belgaumkar #define SLPC_MIN_UNSLICE_FREQ_MASK REG_GENMASK(15, 8) 1707695d08fSVinay Belgaumkar #define SLPC_MAX_SLICE_FREQ_MASK REG_GENMASK(23, 16) 1717695d08fSVinay Belgaumkar #define SLPC_MIN_SLICE_FREQ_MASK REG_GENMASK(31, 24) 1727695d08fSVinay Belgaumkar u32 freq; 1737695d08fSVinay Belgaumkar }; 1747695d08fSVinay Belgaumkar }; 1757695d08fSVinay Belgaumkar } __packed; 1767695d08fSVinay Belgaumkar 1777695d08fSVinay Belgaumkar struct slpc_shared_data_header { 1787695d08fSVinay Belgaumkar /* Total size in bytes of this shared buffer. */ 1797695d08fSVinay Belgaumkar u32 size; 1807695d08fSVinay Belgaumkar u32 global_state; 1817695d08fSVinay Belgaumkar u32 display_data_addr; 1827695d08fSVinay Belgaumkar } __packed; 1837695d08fSVinay Belgaumkar 1847695d08fSVinay Belgaumkar struct slpc_override_params { 1857695d08fSVinay Belgaumkar u32 bits[SLPC_OVERRIDE_BITFIELD_SIZE]; 1867695d08fSVinay Belgaumkar u32 values[SLPC_MAX_OVERRIDE_PARAMETERS]; 1877695d08fSVinay Belgaumkar } __packed; 1887695d08fSVinay Belgaumkar 1897695d08fSVinay Belgaumkar struct slpc_shared_data { 1907695d08fSVinay Belgaumkar struct slpc_shared_data_header header; 1917695d08fSVinay Belgaumkar u8 shared_data_header_pad[SLPC_SHARED_DATA_SIZE_BYTE_HEADER - 1927695d08fSVinay Belgaumkar sizeof(struct slpc_shared_data_header)]; 1937695d08fSVinay Belgaumkar 1947695d08fSVinay Belgaumkar u8 platform_info_pad[SLPC_SHARED_DATA_SIZE_BYTE_PLATFORM_INFO]; 1957695d08fSVinay Belgaumkar 1967695d08fSVinay Belgaumkar struct slpc_task_state_data task_state_data; 1977695d08fSVinay Belgaumkar u8 task_state_data_pad[SLPC_SHARED_DATA_SIZE_BYTE_TASK_STATE - 1987695d08fSVinay Belgaumkar sizeof(struct slpc_task_state_data)]; 1997695d08fSVinay Belgaumkar 2007695d08fSVinay Belgaumkar struct slpc_override_params override_params; 2017695d08fSVinay Belgaumkar u8 override_params_pad[SLPC_OVERRIDE_PARAMS_TOTAL_BYTES - 2027695d08fSVinay Belgaumkar sizeof(struct slpc_override_params)]; 2037695d08fSVinay Belgaumkar 2047695d08fSVinay Belgaumkar u8 shared_data_pad[SLPC_SHARED_DATA_SIZE_BYTE_OTHER]; 2057695d08fSVinay Belgaumkar 2067695d08fSVinay Belgaumkar /* PAGE 2 (4096 bytes), mode based parameter will be removed soon */ 2077695d08fSVinay Belgaumkar u8 reserved_mode_definition[4096]; 2087695d08fSVinay Belgaumkar } __packed; 2097695d08fSVinay Belgaumkar 2107695d08fSVinay Belgaumkar /** 2117695d08fSVinay Belgaumkar * DOC: SLPC H2G MESSAGE FORMAT 2127695d08fSVinay Belgaumkar * 2137695d08fSVinay Belgaumkar * +---+-------+--------------------------------------------------------------+ 2147695d08fSVinay Belgaumkar * | | Bits | Description | 2157695d08fSVinay Belgaumkar * +===+=======+==============================================================+ 2167695d08fSVinay Belgaumkar * | 0 | 31 | ORIGIN = GUC_HXG_ORIGIN_HOST_ | 2177695d08fSVinay Belgaumkar * | +-------+--------------------------------------------------------------+ 2187695d08fSVinay Belgaumkar * | | 30:28 | TYPE = GUC_HXG_TYPE_REQUEST_ | 2197695d08fSVinay Belgaumkar * | +-------+--------------------------------------------------------------+ 2207695d08fSVinay Belgaumkar * | | 27:16 | DATA0 = MBZ | 2217695d08fSVinay Belgaumkar * | +-------+--------------------------------------------------------------+ 2227695d08fSVinay Belgaumkar * | | 15:0 | ACTION = _`GUC_ACTION_HOST2GUC_PC_SLPM_REQUEST` = 0x3003 | 2237695d08fSVinay Belgaumkar * +---+-------+--------------------------------------------------------------+ 2247695d08fSVinay Belgaumkar * | 1 | 31:8 | **EVENT_ID** | 2257695d08fSVinay Belgaumkar * + +-------+--------------------------------------------------------------+ 2267695d08fSVinay Belgaumkar * | | 7:0 | **EVENT_ARGC** - number of data arguments | 2277695d08fSVinay Belgaumkar * +---+-------+--------------------------------------------------------------+ 2287695d08fSVinay Belgaumkar * | 2 | 31:0 | **EVENT_DATA1** | 2297695d08fSVinay Belgaumkar * +---+-------+--------------------------------------------------------------+ 2307695d08fSVinay Belgaumkar * |...| 31:0 | ... | 2317695d08fSVinay Belgaumkar * +---+-------+--------------------------------------------------------------+ 2327695d08fSVinay Belgaumkar * |2+n| 31:0 | **EVENT_DATAn** | 2337695d08fSVinay Belgaumkar * +---+-------+--------------------------------------------------------------+ 2347695d08fSVinay Belgaumkar */ 2357695d08fSVinay Belgaumkar 2367695d08fSVinay Belgaumkar #define GUC_ACTION_HOST2GUC_PC_SLPC_REQUEST 0x3003 2377695d08fSVinay Belgaumkar 2387695d08fSVinay Belgaumkar #define HOST2GUC_PC_SLPC_REQUEST_MSG_MIN_LEN \ 2397695d08fSVinay Belgaumkar (GUC_HXG_REQUEST_MSG_MIN_LEN + 1u) 2407695d08fSVinay Belgaumkar #define HOST2GUC_PC_SLPC_EVENT_MAX_INPUT_ARGS 9 2417695d08fSVinay Belgaumkar #define HOST2GUC_PC_SLPC_REQUEST_MSG_MAX_LEN \ 2427695d08fSVinay Belgaumkar (HOST2GUC_PC_SLPC_REQUEST_REQUEST_MSG_MIN_LEN + \ 2437695d08fSVinay Belgaumkar HOST2GUC_PC_SLPC_EVENT_MAX_INPUT_ARGS) 2447695d08fSVinay Belgaumkar #define HOST2GUC_PC_SLPC_REQUEST_MSG_0_MBZ GUC_HXG_REQUEST_MSG_0_DATA0 2457695d08fSVinay Belgaumkar #define HOST2GUC_PC_SLPC_REQUEST_MSG_1_EVENT_ID (0xff << 8) 2467695d08fSVinay Belgaumkar #define HOST2GUC_PC_SLPC_REQUEST_MSG_1_EVENT_ARGC (0xff << 0) 2477695d08fSVinay Belgaumkar #define HOST2GUC_PC_SLPC_REQUEST_MSG_N_EVENT_DATA_N GUC_HXG_REQUEST_MSG_n_DATAn 2487695d08fSVinay Belgaumkar 2497695d08fSVinay Belgaumkar #endif 250