Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 3fb4f7cd authored by Srinivas Pandruvada's avatar Srinivas Pandruvada Committed by Andy Shevchenko
Browse files

tools/power/x86: A tool to validate Intel Speed Select commands 



The Intel(R) Speed select technologies contains four features.

Performance profile:An non architectural mechanism that allows multiple
optimized performance profiles per system via static and/or dynamic
adjustment of core count, workload, Tjmax, and TDP, etc. aka ISS
in the documentation.

Base Frequency: Enables users to increase guaranteed base frequency on
certain cores (high priority cores) in exchange for lower base frequency
on remaining cores (low priority cores). aka PBF in the documenation.

Turbo frequency: Enables the ability to set different turbo ratio limits
to cores based on priority. aka FACT in the documentation.

Core power: An Interface that allows user to define per core/tile
priority.

There is a multi level help for commands and options. This can be used
to check required arguments for each feature and commands for the
feature.

To start navigating the features start with

$sudo intel-speed-select --help

For help on a specific feature for example
$sudo intel-speed-select perf-profile --help

To get help for a command for a feature for example
$sudo intel-speed-select perf-profile get-lock-status --help

Signed-off-by: default avatarSrinivas Pandruvada <srinivas.pandruvada@linux.intel.com>
Acked-by: default avatarLen Brown <len.brown@intel.com>
Acked-by: default avatarRafael J. Wysocki <rafael.j.wysocki@intel.com>
Signed-off-by: default avatarAndy Shevchenko <andriy.shevchenko@linux.intel.com>
parent f607874f

tools/Makefile

+7 −5
Original line number Diff line number Diff line
@@ -19,6 +19,7 @@ help: 
	@echo '  gpio                   - GPIO tools'

	@echo '  hv                     - tools used when in Hyper-V clients'

	@echo '  iio                    - IIO tools'

	@echo '  intel-speed-select     - Intel Speed Select tool'

	@echo '  kvm_stat               - top-like utility for displaying kvm statistics'

	@echo '  leds                   - LEDs  tools'

	@echo '  liblockdep             - user-space wrapper for kernel locking-validator'
@@ -82,7 +83,7 @@ perf: FORCE 
selftests: FORCE

	$(call descend,testing/$@)



turbostat x86_energy_perf_policy: FORCE

turbostat x86_energy_perf_policy intel-speed-select: FORCE

	$(call descend,power/x86/$@)



tmon: FORCE
@@ -115,7 +116,7 @@ liblockdep_install: 
selftests_install:

	$(call descend,testing/$(@:_install=),install)



turbostat_install x86_energy_perf_policy_install:

turbostat_install x86_energy_perf_policy_install intel-speed-select_install:

	$(call descend,power/x86/$(@:_install=),install)



tmon_install:
@@ -132,7 +133,7 @@ install: acpi_install cgroup_install cpupower_install gpio_install \ 
		perf_install selftests_install turbostat_install usb_install \

		virtio_install vm_install bpf_install x86_energy_perf_policy_install \

		tmon_install freefall_install objtool_install kvm_stat_install \

		wmi_install pci_install debugging_install

		wmi_install pci_install debugging_install intel-speed-select_install



acpi_clean:

	$(call descend,power/acpi,clean)
@@ -162,7 +163,7 @@ perf_clean: 
selftests_clean:

	$(call descend,testing/$(@:_clean=),clean)



turbostat_clean x86_energy_perf_policy_clean:

turbostat_clean x86_energy_perf_policy_clean intel-speed-select_clean:

	$(call descend,power/x86/$(@:_clean=),clean)



tmon_clean:
@@ -178,6 +179,7 @@ clean: acpi_clean cgroup_clean cpupower_clean hv_clean firewire_clean \ 
		perf_clean selftests_clean turbostat_clean spi_clean usb_clean virtio_clean \

		vm_clean bpf_clean iio_clean x86_energy_perf_policy_clean tmon_clean \

		freefall_clean build_clean libbpf_clean libsubcmd_clean liblockdep_clean \

		gpio_clean objtool_clean leds_clean wmi_clean pci_clean firmware_clean debugging_clean

		gpio_clean objtool_clean leds_clean wmi_clean pci_clean firmware_clean debugging_clean \

		intel-speed-select_clean



.PHONY: FORCE

tools/power/x86/intel-speed-select/Build

0 → 100644
+1 −0
Original line number Diff line number Diff line 
intel-speed-select-y +=  isst-config.o isst-core.o isst-display.o

tools/power/x86/intel-speed-select/Makefile

0 → 100644
+56 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0

include ../../../scripts/Makefile.include



bindir ?= /usr/bin



ifeq ($(srctree),)

srctree := $(patsubst %/,%,$(dir $(CURDIR)))

srctree := $(patsubst %/,%,$(dir $(srctree)))

srctree := $(patsubst %/,%,$(dir $(srctree)))

srctree := $(patsubst %/,%,$(dir $(srctree)))

endif



# Do not use make's built-in rules

# (this improves performance and avoids hard-to-debug behaviour);

MAKEFLAGS += -r



override CFLAGS += -O2 -Wall -g -D_GNU_SOURCE -I$(OUTPUT)include



ALL_TARGETS := intel-speed-select

ALL_PROGRAMS := $(patsubst %,$(OUTPUT)%,$(ALL_TARGETS))



all: $(ALL_PROGRAMS)



export srctree OUTPUT CC LD CFLAGS

include $(srctree)/tools/build/Makefile.include



#

# We need the following to be outside of kernel tree

#

$(OUTPUT)include/linux/isst_if.h: ../../../../include/uapi/linux/isst_if.h

	mkdir -p $(OUTPUT)include/linux 2>&1 || true

	ln -sf $(CURDIR)/../../../../include/uapi/linux/isst_if.h $@



prepare: $(OUTPUT)include/linux/isst_if.h



ISST_IN := $(OUTPUT)intel-speed-select-in.o



$(ISST_IN): prepare FORCE

	$(Q)$(MAKE) $(build)=intel-speed-select

$(OUTPUT)intel-speed-select: $(ISST_IN)

	$(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $< -o $@



clean:

	rm -f $(ALL_PROGRAMS)

	rm -rf $(OUTPUT)include/linux/isst_if.h

	find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.d' -delete



install: $(ALL_PROGRAMS)

	install -d -m 755 $(DESTDIR)$(bindir);		\

	for program in $(ALL_PROGRAMS); do		\

		install $$program $(DESTDIR)$(bindir);	\

	done



FORCE:



.PHONY: all install clean FORCE prepare