power: add get capabilities API

New API added, rte_power_get_capabilities(), that allows the
application to query the power and performance capabilities
of the CPU cores.

Signed-off-by: Radu Nicolau <radu.nicolau@intel.com>
Acked-by: David Hunt <david.hunt@intel.com>
This commit is contained in:
Radu Nicolau 2018-06-11 11:03:21 +01:00 committed by Thomas Monjalon
parent f68a1d3f2c
commit 185109906b
7 changed files with 105 additions and 1 deletions

View File

@ -623,3 +623,24 @@ power_acpi_disable_turbo(unsigned int lcore_id)
return 0;
}
int power_acpi_get_capabilities(unsigned int lcore_id,
struct rte_power_core_capabilities *caps)
{
struct rte_power_info *pi;
if (lcore_id >= RTE_MAX_LCORE) {
RTE_LOG(ERR, POWER, "Invalid lcore ID\n");
return -1;
}
if (caps == NULL) {
RTE_LOG(ERR, POWER, "Invalid argument\n");
return -1;
}
pi = &lcore_power_info[lcore_id];
caps->capabilities = 0;
caps->turbo = !!(pi->turbo_available);
return 0;
}

View File

@ -14,6 +14,7 @@
#include <rte_byteorder.h>
#include <rte_log.h>
#include <rte_string_fns.h>
#include "rte_power.h"
#ifdef __cplusplus
extern "C" {
@ -196,6 +197,21 @@ int power_acpi_enable_turbo(unsigned int lcore_id);
*/
int power_acpi_disable_turbo(unsigned int lcore_id);
/**
* Returns power capabilities for a specific lcore.
*
* @param lcore_id
* lcore id.
* @param caps
* pointer to rte_power_core_capabilities object.
*
* @return
* - 0 on success.
* - Negative on error.
*/
int power_acpi_get_capabilities(unsigned int lcore_id,
struct rte_power_core_capabilities *caps);
#ifdef __cplusplus
}
#endif

View File

@ -124,3 +124,11 @@ power_kvm_vm_disable_turbo(unsigned int lcore_id)
{
return send_msg(lcore_id, CPU_POWER_DISABLE_TURBO);
}
struct rte_power_core_capabilities;
int power_kvm_vm_get_capabilities(__rte_unused unsigned int lcore_id,
__rte_unused struct rte_power_core_capabilities *caps)
{
RTE_LOG(ERR, POWER, "rte_power_get_capabilities is not implemented for Virtual Machine Power Management\n");
return -ENOTSUP;
}

View File

@ -14,6 +14,7 @@
#include <rte_byteorder.h>
#include <rte_log.h>
#include <rte_string_fns.h>
#include "rte_power.h"
#ifdef __cplusplus
extern "C" {
@ -177,6 +178,22 @@ int power_kvm_vm_enable_turbo(unsigned int lcore_id);
* - Negative on error.
*/
int power_kvm_vm_disable_turbo(unsigned int lcore_id);
/**
* Returns power capabilities for a specific lcore.
*
* @param lcore_id
* lcore id.
* @param caps
* pointer to rte_power_core_capabilities object.
*
* @return
* - 0 on success.
* - Negative on error.
*/
int power_kvm_vm_get_capabilities(unsigned int lcore_id,
struct rte_power_core_capabilities *caps);
#ifdef __cplusplus
}
#endif

View File

@ -24,6 +24,7 @@ rte_power_freq_change_t rte_power_freq_min = NULL;
rte_power_freq_change_t rte_power_turbo_status;
rte_power_freq_change_t rte_power_freq_enable_turbo;
rte_power_freq_change_t rte_power_freq_disable_turbo;
rte_power_get_capabilities_t rte_power_get_capabilities;
int
rte_power_set_env(enum power_management_env env)
@ -42,6 +43,7 @@ rte_power_set_env(enum power_management_env env)
rte_power_turbo_status = power_acpi_turbo_status;
rte_power_freq_enable_turbo = power_acpi_enable_turbo;
rte_power_freq_disable_turbo = power_acpi_disable_turbo;
rte_power_get_capabilities = power_acpi_get_capabilities;
} else if (env == PM_ENV_KVM_VM) {
rte_power_freqs = power_kvm_vm_freqs;
rte_power_get_freq = power_kvm_vm_get_freq;
@ -53,6 +55,7 @@ rte_power_set_env(enum power_management_env env)
rte_power_turbo_status = power_kvm_vm_turbo_status;
rte_power_freq_enable_turbo = power_kvm_vm_enable_turbo;
rte_power_freq_disable_turbo = power_kvm_vm_disable_turbo;
rte_power_get_capabilities = power_kvm_vm_get_capabilities;
} else {
RTE_LOG(ERR, POWER, "Invalid Power Management Environment(%d) set\n",
env);

View File

@ -247,6 +247,38 @@ extern rte_power_freq_change_t rte_power_freq_enable_turbo;
*/
extern rte_power_freq_change_t rte_power_freq_disable_turbo;
/**
* Power capabilities summary.
*/
struct rte_power_core_capabilities {
RTE_STD_C11
union {
uint64_t capabilities;
RTE_STD_C11
struct {
uint64_t turbo:1; /**< Turbo can be enabled. */
};
};
};
/**
* Returns power capabilities for a specific lcore.
* Function pointer definition. Review each environments
* specific documentation for usage.
*
* @param lcore_id
* lcore id.
* @param caps
* pointer to rte_power_core_capabilities object.
*
* @return
* - 0 on success.
* - Negative on error.
*/
typedef int (*rte_power_get_capabilities_t)(unsigned int lcore_id,
struct rte_power_core_capabilities *caps);
extern rte_power_get_capabilities_t rte_power_get_capabilities;
#ifdef __cplusplus
}

View File

@ -26,3 +26,10 @@ DPDK_17.11 {
rte_power_turbo_status;
} DPDK_2.0;
DPDK_18.08 {
global:
rte_power_get_capabilities;
} DPDK_17.11;