204 lines · 5.9 KB · C
RawDownload
/* SPDX-License-Identifier: GPL-2.0-or-later WITH Linux-syscall-note *//* * AMD Platform Management Framework (PMF) UAPI Header * * Copyright (c) 2026, Advanced Micro Devices, Inc. * All Rights Reserved. * * This file defines the user-space API for interacting with the AMD PMF * driver. It provides ioctl interfaces to query platform-specific metrics * such as power source, slider position, platform type, laptop placement, * and various BIOS input/output parameters. */ #ifndef _UAPI_LINUX_AMD_PMF_H#define _UAPI_LINUX_AMD_PMF_H #include <linux/bits.h>#include <linux/ioctl.h>#include <linux/types.h> /** * AMD_PMF_IOC_MAGIC - Magic number for AMD PMF ioctl commands * * This magic number uniquely identifies AMD PMF ioctl operations. */#define AMD_PMF_IOC_MAGIC	'p' /** * IOCTL_AMD_PMF_POPULATE_DATA - ioctl command to retrieve PMF metrics data * * This ioctl command is used to populate the amd_pmf_info structure * with the requested PMF metrics information. */#define IOCTL_AMD_PMF_POPULATE_DATA		_IOWR(AMD_PMF_IOC_MAGIC, 0x00, __u64) #define AMD_PMF_BIOS_PARAMS_MAX		10 /* AMD PMF feature flags - bitmask indicating supported features */#define AMD_PMF_FEAT_AUTO_MODE			BIT(0)#define AMD_PMF_FEAT_STATIC_POWER_SLIDER	BIT(1)#define AMD_PMF_FEAT_POLICY_BUILDER		BIT(2)#define AMD_PMF_FEAT_DYNAMIC_POWER_SLIDER_AC	BIT(3)#define AMD_PMF_FEAT_DYNAMIC_POWER_SLIDER_DC	BIT(4) /** * enum amd_pmf_laptop_placement - Describes the physical placement of the laptop * @AMD_PMF_LP_UNKNOWN: Placement cannot be determined * @AMD_PMF_ON_TABLE: Laptop is placed on a stable surface like a table or desk * @AMD_PMF_ON_LAP_MOTION: Laptop is on a lap with detected motion * @AMD_PMF_IN_BAG: Laptop is detected to be inside a bag or case * @AMD_PMF_OUT_OF_BAG: Laptop has been removed from bag or case * @AMD_PMF_LP_UNDEFINED: Placement state is undefined * * This enumeration represents the physical placement state of the laptop * as detected by platform sensors. Used for adaptive power management * and thermal policies. */enum amd_pmf_laptop_placement {	AMD_PMF_LP_UNKNOWN,	AMD_PMF_ON_TABLE,	AMD_PMF_ON_LAP_MOTION,	AMD_PMF_IN_BAG,	AMD_PMF_OUT_OF_BAG,	AMD_PMF_LP_UNDEFINED,}; /** * enum amd_pmf_ta_slider - Trusted Application power slider positions * @AMD_PMF_TA_BEST_BATTERY: Maximum battery savings, minimal performance * @AMD_PMF_TA_BETTER_BATTERY: Balanced towards battery life * @AMD_PMF_TA_BETTER_PERFORMANCE: Balanced towards performance * @AMD_PMF_TA_BEST_PERFORMANCE: Maximum performance, higher power consumption * @AMD_PMF_TA_MAX: Sentinel value indicating maximum enum value * * This enumeration defines the power slider positions used by the * AMD PMF Trusted Application for dynamic power management decisions. * These correspond to the Windows power slider UI positions. */enum amd_pmf_ta_slider {	AMD_PMF_TA_BEST_BATTERY,	AMD_PMF_TA_BETTER_BATTERY,	AMD_PMF_TA_BETTER_PERFORMANCE,	AMD_PMF_TA_BEST_PERFORMANCE,	AMD_PMF_TA_MAX,}; /** * enum amd_pmf_platform_type - Describes the physical form factor orientation * @AMD_PMF_PTYPE_UNKNOWN: Platform type cannot be determined * @AMD_PMF_LID_CLOSE: Laptop lid is closed * @AMD_PMF_CLAMSHELL: Traditional laptop mode with keyboard and screen * @AMD_PMF_FLAT: Device is lying flat on a surface * @AMD_PMF_TENT: Device is in tent mode (keyboard folded back, standing) * @AMD_PMF_STAND: Device is propped up in stand orientation * @AMD_PMF_TABLET: Device is in tablet mode with keyboard hidden * @AMD_PMF_BOOK: Device is in book reading orientation * @AMD_PMF_PRESENTATION: Device is in presentation mode * @AMD_PMF_PULL_FWD: Screen is pulled forward towards user * @AMD_PMF_PTYPE_INVALID: Invalid platform type marker * * This enumeration describes the current physical orientation or form * factor of convertible/2-in-1 devices. Used for optimizing power and * thermal management based on device posture. */enum amd_pmf_platform_type {	AMD_PMF_PTYPE_UNKNOWN,	AMD_PMF_LID_CLOSE,	AMD_PMF_CLAMSHELL,	AMD_PMF_FLAT,	AMD_PMF_TENT,	AMD_PMF_STAND,	AMD_PMF_TABLET,	AMD_PMF_BOOK,	AMD_PMF_PRESENTATION,	AMD_PMF_PULL_FWD,	AMD_PMF_PTYPE_INVALID = 0xf,}; static inline const char *amd_pmf_get_platform_type(unsigned int platform_type){	switch (platform_type) {	case AMD_PMF_CLAMSHELL:		return "CLAMSHELL";	case AMD_PMF_LID_CLOSE:		return "LID_CLOSE";	case AMD_PMF_FLAT:		return "FLAT";	case AMD_PMF_TENT:		return "TENT";	case AMD_PMF_STAND:		return "STAND";	case AMD_PMF_TABLET:		return "TABLET";	case AMD_PMF_BOOK:		return "BOOK";	case AMD_PMF_PRESENTATION:		return "PRESENTATION";	case AMD_PMF_PULL_FWD:		return "PULL_FWD";	default:		return "UNKNOWN";	}} static inline const char *amd_pmf_get_laptop_placement(unsigned int device_state){	switch (device_state) {	case AMD_PMF_ON_TABLE:		return "ON_TABLE";	case AMD_PMF_ON_LAP_MOTION:		return "ON_LAP_MOTION";	case AMD_PMF_IN_BAG:		return "IN_BAG";	case AMD_PMF_OUT_OF_BAG:		return "OUT_OF_BAG";	default:		return "UNKNOWN";	}} static inline const char *amd_pmf_get_slider_position(unsigned int state){	switch (state) {	case AMD_PMF_TA_BEST_PERFORMANCE:		return "PERFORMANCE";	case AMD_PMF_TA_BETTER_PERFORMANCE:		return "BALANCED";	case AMD_PMF_TA_BEST_BATTERY:		return "POWER_SAVER";	case AMD_PMF_TA_BETTER_BATTERY:		return "BALANCED_BATTERY";	default:		return "Unknown TA Slider State";	}} struct amd_pmf_info {	__u64 size; 	/* Feature info */	__u32 features_supported; 	/* Power and state info */	__u32 platform_type;	__u32 power_source;	__u32 laptop_placement;	__u32 lid_state;	__u32 user_presence;	__u32 slider_position; 	/* Thermal and power metrics */	__s32 skin_temp;	__u32 gfx_busy;	__s32 ambient_light;	__u32 avg_c0_residency;	__u32 max_c0_residency;	__u32 socket_power; 	/* BIOS parameters */	__u32 bios_input[AMD_PMF_BIOS_PARAMS_MAX];	__u32 bios_output[AMD_PMF_BIOS_PARAMS_MAX];}; #endif /* _UAPI_LINUX_AMD_PMF_H */

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t