Skip to content
charmOS docs

ACPI CPU

include/acpi/cpu.h View source View on GitHub

Structs

Section titled “Structs”

acpi_power_reg

Section titled “acpi_power_reg”
struct acpi_power_reg {
    uint8_t   descriptor;
    uint16_t  length;
    uint8_t   space_id;
    uint8_t   bit_width;
    uint8_t   bit_offset;
    uint8_t   access_size;
    uint64_t  addr;
};

acpi_cpu_context

Section titled “acpi_cpu_context”
struct acpi_cpu_context {
    bool      valid;
    uint8_t   type;
    uint32_t  addr;
    uint8_t   entry_method;
    uint8_t   index;
    uint32_t  latency;
    uint8_t   bm_status_skip;
    char      desc[ACPI_CONTEXT_DESCRIPTOR_LENGTH];
};

acpi_lpi_state

Section titled “acpi_lpi_state”
struct acpi_lpi_state {
    uint32_t  min_residency;
    uint32_t  wake_latency;
    uint32_t  flags;
    uint32_t  resolution_counter_frequency;
    uint32_t  enable_parent_state;
    uint64_t  addr;
    uint8_t   index;
    uint8_t   entry_method;
    char      desc[ACPI_CONTEXT_DESCRIPTOR_LENGTH];
};

acpi_cpu_power

Section titled “acpi_cpu_power”
struct acpi_cpu_power {
    size_t  count;
    union {
        struct acpi_cpu_context  states[ACPI_CPU_MAX_POWER];
        struct acpi_lpi_state    lpi_states[ACPI_CPU_MAX_POWER];
    };
    size_t  timer_broadcast_on_state;
};

acpi_psd_pkg

Section titled “acpi_psd_pkg”
struct acpi_psd_pkg {
    uint64_t  num_entries;
    uint64_t  revision;
    uint64_t  domain;
    uint64_t  coord_type;
    uint64_t  num_cpus;
};

acpi_pct_reg

Section titled “acpi_pct_reg”
struct acpi_pct_reg {
    uint8_t   desc;
    uint16_t  len;
    uint8_t   space_id;
    uint8_t   bit_width;
    uint8_t   bit_offset;
    uint8_t   reserved0;
    uint64_t  addr;
};

acpi_cpu_px

Section titled “acpi_cpu_px”
struct acpi_cpu_px {
    uint64_t  frequency;
    uint64_t  power;
    uint64_t  transition_latency_us;
    uint64_t  bus_master_latency_us;
    uint64_t  control;
    uint64_t  status;
};

acpi_cpu_perf

Section titled “acpi_cpu_perf”
struct acpi_cpu_perf {
    uint32_t             state;
    uint32_t             platform_limit;
    struct acpi_pct_reg  control_reg;
    struct acpi_pct_reg  status_reg;
    uint32_t             state_count;
    struct acpi_cpu_px   *states;
    struct acpi_psd_pkg  domain_info;
    uint32_t             type;
};

acpi_tsd_pkg

Section titled “acpi_tsd_pkg”
struct acpi_tsd_pkg {
    uint64_t  num_entries;
    uint64_t  revision;
    uint64_t  domain;
    uint64_t  coord_type;
    uint64_t  num_cpus;
};

acpi_ptc_reg

Section titled “acpi_ptc_reg”
struct acpi_ptc_reg {
    uint8_t   desc;
    uint16_t  len;
    uint8_t   space_id;
    uint8_t   bit_width;
    uint8_t   bit_offset;
    uint8_t   reserved0;
    uint64_t  addr;
};

acpi_cpu_tx_tss

Section titled “acpi_cpu_tx_tss”
struct acpi_cpu_tx_tss {
    uint64_t  freq_pct;
    uint64_t  power;
    uint64_t  transition_latency_us;
    uint64_t  control;
    uint64_t  status;
};

acpi_cpu_tx

Section titled “acpi_cpu_tx”
struct acpi_cpu_tx {
    uint16_t  power;
    uint16_t  performance;
};

acpi_cpu_throttling

Section titled “acpi_cpu_throttling”
struct acpi_cpu_throttling {
    uint32_t                state;
    uint32_t                platform_limit;
    struct acpi_pct_reg     control_reg;
    struct acpi_pct_reg     status_reg;
    uint32_t                state_count;
    struct acpi_cpu_tx_tss  *states_tss;
    struct acpi_tsd_pkg     domain_info;
    int32_t                 (*get_throttling)(struct acpi_cpu *);
    int32_t                 (*set_throttling)(struct acpi_cpu *, int32_t);
    uint32_t                addr;
    uint8_t                 duty_offset;
    uint8_t                 duty_width;
    uint8_t                 tsd_valid_flag;
    uint32_t                shared_type;
    struct acpi_cpu_tx      states[ACPI_CPU_MAX_THROTTLING];
};

acpi_cpu_lx

Section titled “acpi_cpu_lx”
struct acpi_cpu_lx {
    int32_t  px;
    int32_t  tx;
};

acpi_cpu_limit

Section titled “acpi_cpu_limit”
struct acpi_cpu_limit {
    struct acpi_cpu_lx  state;
    struct acpi_cpu_lx  thermal;
    struct acpi_cpu_lx  user;
};

acpi_cpu_flags

Section titled “acpi_cpu_flags”
struct acpi_cpu_flags {
    uint8_t  power : 1;
    uint8_t  perf : 1;
    uint8_t  throttling : 1;
    uint8_t  limit : 1;
    uint8_t  has_cst : 1;
    uint8_t  has_lpi : 1;
    uint8_t  setup : 1;
};

acpi_cpu

Section titled “acpi_cpu”
struct acpi_cpu {
    cpu_id_t                    id;
    int32_t                     perf_throttle_limit;
    int32_t                     throttle_platform_limit;
    struct acpi_cpu_flags       flags;
    struct acpi_cpu_power       power;
    struct acpi_cpu_perf        *performance;
    struct acpi_cpu_throttling  throttling;
    struct acpi_cpu_limit       limit;
};

Macros

Section titled “Macros”

ACPI_CPU_BUSY_METRIC

Section titled “ACPI_CPU_BUSY_METRIC”
#define ACPI_CPU_BUSY_METRIC 10

ACPI_CPU_MAX_POWER

Section titled “ACPI_CPU_MAX_POWER”
#define ACPI_CPU_MAX_POWER 8

ACPI_CPU_MAX_C2_LATENCY

Section titled “ACPI_CPU_MAX_C2_LATENCY”
#define ACPI_CPU_MAX_C2_LATENCY 100

ACPI_CPU_MAX_C3_LATENCY

Section titled “ACPI_CPU_MAX_C3_LATENCY”
#define ACPI_CPU_MAX_C3_LATENCY 1000

ACPI_CPU_MAX_THROTTLING

Section titled “ACPI_CPU_MAX_THROTTLING”
#define ACPI_CPU_MAX_THROTTLING 16

ACPI_CPU_MAX_THROTTLE

Section titled “ACPI_CPU_MAX_THROTTLE”
#define ACPI_CPU_MAX_THROTTLE 100 /* 10% */

ACPI_CPU_MAX_DUTY_WIDTH

Section titled “ACPI_CPU_MAX_DUTY_WIDTH”
#define ACPI_CPU_MAX_DUTY_WIDTH 4

ACPI_PDC_REVISION_ID

Section titled “ACPI_PDC_REVISION_ID”
#define ACPI_PDC_REVISION_ID 0x1

ACPI_PSD_REV0_REVISION

Section titled “ACPI_PSD_REV0_REVISION”
#define ACPI_PSD_REV0_REVISION 0

ACPI_PSD_REV0_ENTRIES

Section titled “ACPI_PSD_REV0_ENTRIES”
#define ACPI_PSD_REV0_ENTRIES 5

ACPI_TSD_REV0_REVISION

Section titled “ACPI_TSD_REV0_REVISION”
#define ACPI_TSD_REV0_REVISION 0

ACPI_TSD_REV0_ENTRIES

Section titled “ACPI_TSD_REV0_ENTRIES”
#define ACPI_TSD_REV0_ENTRIES 5

ACPI_CONTEXT_DESCRIPTOR_LENGTH

Section titled “ACPI_CONTEXT_DESCRIPTOR_LENGTH”
#define ACPI_CONTEXT_DESCRIPTOR_LENGTH 32