/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ /* * Intel Speed Select Interface: OS to hardware Interface * Copyright (c) 2019, Intel Corporation. * All rights reserved. * * Author: Srinivas Pandruvada <[email protected]> */ #ifndef __ISST_IF_H #define __ISST_IF_H #include <linux/types.h> /** * struct isst_if_platform_info - Define platform information * @api_version: Version of the firmware document, which this driver * can communicate * @driver_version: Driver version, which will help user to send right * commands. Even if the firmware is capable, driver may * not be ready * @max_cmds_per_ioctl: Returns the maximum number of commands driver will * accept in a single ioctl * @mbox_supported: Support of mail box interface * @mmio_supported: Support of mmio interface for core-power feature * * Used to return output of IOCTL ISST_IF_GET_PLATFORM_INFO. This * information can be used by the user space, to get the driver, firmware * support and also number of commands to send in a single IOCTL request. */ struct isst_if_platform_info { … }; /** * struct isst_if_cpu_map - CPU mapping between logical and physical CPU * @logical_cpu: Linux logical CPU number * @physical_cpu: PUNIT CPU number * * Used to convert from Linux logical CPU to PUNIT CPU numbering scheme. * The PUNIT CPU number is different than APIC ID based CPU numbering. */ struct isst_if_cpu_map { … }; /** * struct isst_if_cpu_maps - structure for CPU map IOCTL * @cmd_count: Number of CPU mapping command in cpu_map[] * @cpu_map[]: Holds one or more CPU map data structure * * This structure used with ioctl ISST_IF_GET_PHY_ID to send * one or more CPU mapping commands. Here IOCTL return value indicates * number of commands sent or error number if no commands have been sent. */ struct isst_if_cpu_maps { … }; /** * struct isst_if_io_reg - Read write PUNIT IO register * @read_write: Value 0: Read, 1: Write * @logical_cpu: Logical CPU number to get target PCI device. * @reg: PUNIT register offset * @value: For write operation value to write and for * read placeholder read value * * Structure to specify read/write data to PUNIT registers. */ struct isst_if_io_reg { … }; /** * struct isst_if_io_regs - structure for IO register commands * @cmd_count: Number of io reg commands in io_reg[] * @io_reg[]: Holds one or more io_reg command structure * * This structure used with ioctl ISST_IF_IO_CMD to send * one or more read/write commands to PUNIT. Here IOCTL return value * indicates number of requests sent or error number if no requests have * been sent. */ struct isst_if_io_regs { … }; /** * struct isst_if_mbox_cmd - Structure to define mail box command * @logical_cpu: Logical CPU number to get target PCI device * @parameter: Mailbox parameter value * @req_data: Request data for the mailbox * @resp_data: Response data for mailbox command response * @command: Mailbox command value * @sub_command: Mailbox sub command value * @reserved: Unused, set to 0 * * Structure to specify mailbox command to be sent to PUNIT. */ struct isst_if_mbox_cmd { … }; /** * struct isst_if_mbox_cmds - structure for mailbox commands * @cmd_count: Number of mailbox commands in mbox_cmd[] * @mbox_cmd[]: Holds one or more mbox commands * * This structure used with ioctl ISST_IF_MBOX_COMMAND to send * one or more mailbox commands to PUNIT. Here IOCTL return value * indicates number of commands sent or error number if no commands have * been sent. */ struct isst_if_mbox_cmds { … }; /** * struct isst_if_msr_cmd - Structure to define msr command * @read_write: Value 0: Read, 1: Write * @logical_cpu: Logical CPU number * @msr: MSR number * @data: For write operation, data to write, for read * place holder * * Structure to specify MSR command related to PUNIT. */ struct isst_if_msr_cmd { … }; /** * struct isst_if_msr_cmds - structure for msr commands * @cmd_count: Number of mailbox commands in msr_cmd[] * @msr_cmd[]: Holds one or more msr commands * * This structure used with ioctl ISST_IF_MSR_COMMAND to send * one or more MSR commands. IOCTL return value indicates number of * commands sent or error number if no commands have been sent. */ struct isst_if_msr_cmds { … }; /** * struct isst_core_power - Structure to get/set core_power feature * @get_set: 0: Get, 1: Set * @socket_id: Socket/package id * @power_domain: Power Domain id * @enable: Feature enable status * @priority_type: Priority type for the feature (ordered/proportional) * * Structure to get/set core_power feature state using IOCTL * ISST_IF_CORE_POWER_STATE. */ struct isst_core_power { … }; /** * struct isst_clos_param - Structure to get/set clos praram * @get_set: 0: Get, 1: Set * @socket_id: Socket/package id * @power_domain: Power Domain id * clos: Clos ID for the parameters * min_freq_mhz: Minimum frequency in MHz * max_freq_mhz: Maximum frequency in MHz * prop_prio: Proportional priority from 0-15 * * Structure to get/set per clos property using IOCTL * ISST_IF_CLOS_PARAM. */ struct isst_clos_param { … }; /** * struct isst_if_clos_assoc - Structure to assign clos to a CPU * @socket_id: Socket/package id * @power_domain: Power Domain id * @logical_cpu: CPU number * @clos: Clos ID to assign to the logical CPU * * Structure to get/set core_power feature. */ struct isst_if_clos_assoc { … }; /** * struct isst_if_clos_assoc_cmds - Structure to assign clos to CPUs * @cmd_count: Number of cmds (cpus) in this request * @get_set: Request is for get or set * @punit_cpu_map: Set to 1 if the CPU number is punit numbering not * Linux CPU number * * Structure used to get/set associate CPUs to clos using IOCTL * ISST_IF_CLOS_ASSOC. */ struct isst_if_clos_assoc_cmds { … }; /** * struct isst_tpmi_instance_count - Get number of TPMI instances per socket * @socket_id: Socket/package id * @count: Number of instances * @valid_mask: Mask of instances as there can be holes * * Structure used to get TPMI instances information using * IOCTL ISST_IF_COUNT_TPMI_INSTANCES. */ struct isst_tpmi_instance_count { … }; /** * struct isst_perf_level_info - Structure to get information on SST-PP levels * @socket_id: Socket/package id * @power_domain: Power Domain id * @logical_cpu: CPU number * @clos: Clos ID to assign to the logical CPU * @max_level: Maximum performance level supported by the platform * @feature_rev: The feature revision for SST-PP supported by the platform * @level_mask: Mask of supported performance levels * @current_level: Current performance level * @feature_state: SST-BF and SST-TF (enabled/disabled) status at current level * @locked: SST-PP performance level change is locked/unlocked * @enabled: SST-PP feature is enabled or not * @sst-tf_support: SST-TF support status at this level * @sst-bf_support: SST-BF support status at this level * * Structure to get SST-PP details using IOCTL ISST_IF_PERF_LEVELS. */ struct isst_perf_level_info { … }; /** * struct isst_perf_level_control - Structure to set SST-PP level * @socket_id: Socket/package id * @power_domain: Power Domain id * @level: level to set * * Structure used change SST-PP level using IOCTL ISST_IF_PERF_SET_LEVEL. */ struct isst_perf_level_control { … }; /** * struct isst_perf_feature_control - Structure to activate SST-BF/SST-TF * @socket_id: Socket/package id * @power_domain: Power Domain id * @feature: bit 0 = SST-BF state, bit 1 = SST-TF state * * Structure used to enable SST-BF/SST-TF using IOCTL ISST_IF_PERF_SET_FEATURE. */ struct isst_perf_feature_control { … }; #define TRL_MAX_BUCKETS … #define TRL_MAX_LEVELS … /** * struct isst_perf_level_data_info - Structure to get SST-PP level details * @socket_id: Socket/package id * @power_domain: Power Domain id * @level: SST-PP level for which caller wants to get information * @tdp_ratio: TDP Ratio * @base_freq_mhz: Base frequency in MHz * @base_freq_avx2_mhz: AVX2 Base frequency in MHz * @base_freq_avx512_mhz: AVX512 base frequency in MHz * @base_freq_amx_mhz: AMX base frequency in MHz * @thermal_design_power_w: Thermal design (TDP) power * @tjunction_max_c: Max junction temperature * @max_memory_freq_mhz: Max memory frequency in MHz * @cooling_type: Type of cooling is used * @p0_freq_mhz: core maximum frequency * @p1_freq_mhz: Core TDP frequency * @pn_freq_mhz: Core maximum efficiency frequency * @pm_freq_mhz: Core minimum frequency * @p0_fabric_freq_mhz: Fabric (Uncore) maximum frequency * @p1_fabric_freq_mhz: Fabric (Uncore) TDP frequency * @pn_fabric_freq_mhz: Fabric (Uncore) minimum efficiency frequency * @pm_fabric_freq_mhz: Fabric (Uncore) minimum frequency * @max_buckets: Maximum trl buckets * @max_trl_levels: Maximum trl levels * @bucket_core_counts[TRL_MAX_BUCKETS]: Number of cores per bucket * @trl_freq_mhz[TRL_MAX_LEVELS][TRL_MAX_BUCKETS]: maximum frequency * for a bucket and trl level * * Structure used to get information on frequencies and TDP for a SST-PP * level using ISST_IF_GET_PERF_LEVEL_INFO. */ struct isst_perf_level_data_info { … }; /** * struct isst_perf_level_cpu_mask - Structure to get SST-PP level CPU mask * @socket_id: Socket/package id * @power_domain: Power Domain id * @level: SST-PP level for which caller wants to get information * @punit_cpu_map: Set to 1 if the CPU number is punit numbering not * Linux CPU number. If 0 CPU buffer is copied to user space * supplied cpu_buffer of size cpu_buffer_size. Punit * cpu mask is copied to "mask" field. * @mask: cpu mask for this PP level (punit CPU numbering) * @cpu_buffer_size: size of cpu_buffer also used to return the copied CPU * buffer size. * @cpu_buffer: Buffer to copy CPU mask when punit_cpu_map is 0 * * Structure used to get cpumask for a SST-PP level using * IOCTL ISST_IF_GET_PERF_LEVEL_CPU_MASK. Also used to get CPU mask for * IOCTL ISST_IF_GET_BASE_FREQ_CPU_MASK for SST-BF. */ struct isst_perf_level_cpu_mask { … }; /** * struct isst_base_freq_info - Structure to get SST-BF frequencies * @socket_id: Socket/package id * @power_domain: Power Domain id * @level: SST-PP level for which caller wants to get information * @high_base_freq_mhz: High priority CPU base frequency * @low_base_freq_mhz: Low priority CPU base frequency * @tjunction_max_c: Max junction temperature * @thermal_design_power_w: Thermal design power in watts * * Structure used to get SST-BF information using * IOCTL ISST_IF_GET_BASE_FREQ_INFO. */ struct isst_base_freq_info { … }; /** * struct isst_turbo_freq_info - Structure to get SST-TF frequencies * @socket_id: Socket/package id * @power_domain: Power Domain id * @level: SST-PP level for which caller wants to get information * @max_clip_freqs: Maximum number of low priority core clipping frequencies * @lp_clip_freq_mhz: Clip frequencies per trl level * @bucket_core_counts: Maximum number of cores for a bucket * @trl_freq_mhz: Frequencies per trl level for each bucket * * Structure used to get SST-TF information using * IOCTL ISST_IF_GET_TURBO_FREQ_INFO. */ struct isst_turbo_freq_info { … }; #define ISST_IF_MAGIC … #define ISST_IF_GET_PLATFORM_INFO … #define ISST_IF_GET_PHY_ID … #define ISST_IF_IO_CMD … #define ISST_IF_MBOX_COMMAND … #define ISST_IF_MSR_COMMAND … #define ISST_IF_COUNT_TPMI_INSTANCES … #define ISST_IF_CORE_POWER_STATE … #define ISST_IF_CLOS_PARAM … #define ISST_IF_CLOS_ASSOC … #define ISST_IF_PERF_LEVELS … #define ISST_IF_PERF_SET_LEVEL … #define ISST_IF_PERF_SET_FEATURE … #define ISST_IF_GET_PERF_LEVEL_INFO … #define ISST_IF_GET_PERF_LEVEL_CPU_MASK … #define ISST_IF_GET_BASE_FREQ_INFO … #define ISST_IF_GET_BASE_FREQ_CPU_MASK … #define ISST_IF_GET_TURBO_FREQ_INFO … #endif
Codebase Browser
linux