843e19887f64dde75055cf8842fc4db2171eff45johnlev/******************************************************************************
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Hardware platform operations. Intended for use by domain-0 kernel.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Permission is hereby granted, free of charge, to any person obtaining a copy
843e19887f64dde75055cf8842fc4db2171eff45johnlev * of this software and associated documentation files (the "Software"), to
843e19887f64dde75055cf8842fc4db2171eff45johnlev * deal in the Software without restriction, including without limitation the
843e19887f64dde75055cf8842fc4db2171eff45johnlev * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
843e19887f64dde75055cf8842fc4db2171eff45johnlev * sell copies of the Software, and to permit persons to whom the Software is
843e19887f64dde75055cf8842fc4db2171eff45johnlev * furnished to do so, subject to the following conditions:
843e19887f64dde75055cf8842fc4db2171eff45johnlev * The above copyright notice and this permission notice shall be included in
843e19887f64dde75055cf8842fc4db2171eff45johnlev * all copies or substantial portions of the Software.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
843e19887f64dde75055cf8842fc4db2171eff45johnlev * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
843e19887f64dde75055cf8842fc4db2171eff45johnlev * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
843e19887f64dde75055cf8842fc4db2171eff45johnlev * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
843e19887f64dde75055cf8842fc4db2171eff45johnlev * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
843e19887f64dde75055cf8842fc4db2171eff45johnlev * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
843e19887f64dde75055cf8842fc4db2171eff45johnlev * DEALINGS IN THE SOFTWARE.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Copyright (c) 2002-2006, K Fraser
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Set clock such that it would read <secs,nsecs> after 00:00:00 UTC,
843e19887f64dde75055cf8842fc4db2171eff45johnlev * 1 January, 1970 if the current system time was <system_time>.
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Request memory range (@mfn, @mfn+@nr_mfns-1) to have type @type.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * On x86, @type is an architecture-defined MTRR memory type.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * On success, returns the MTRR that was used (@reg) and a handle that can
843e19887f64dde75055cf8842fc4db2171eff45johnlev * be passed to XENPF_DEL_MEMTYPE to accurately tear down the new setting.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * (x86-specific).
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* OUT variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xenpf_add_memtype xenpf_add_memtype_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Tear down an existing memory-range type. If @handle is remembered then it
843e19887f64dde75055cf8842fc4db2171eff45johnlev * should be passed in to accurately tear down the correct setting (in case
843e19887f64dde75055cf8842fc4db2171eff45johnlev * of overlapping memory regions with differing types). If it is not known
843e19887f64dde75055cf8842fc4db2171eff45johnlev * then @handle should be set to zero. In all cases @reg must be set.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * (x86-specific).
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xenpf_del_memtype xenpf_del_memtype_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev/* Read current type of an MTRR (x86-specific). */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* OUT variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xenpf_read_memtype xenpf_read_memtype_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee XEN_GUEST_HANDLE(const_void) data;/* Pointer to microcode data */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xenpf_microcode_update xenpf_microcode_update_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev#define QUIRK_NOIRQBALANCING 1 /* Do not restrict IO-APIC RTE targets */
843e19887f64dde75055cf8842fc4db2171eff45johnlev#define QUIRK_IOAPIC_BAD_REGSEL 2 /* IO-APIC REGSEL forgets its value */
843e19887f64dde75055cf8842fc4db2171eff45johnlev#define QUIRK_IOAPIC_GOOD_REGSEL 3 /* IO-APIC REGSEL behaves properly */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xenpf_platform_quirk xenpf_platform_quirk_t;
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab#define XEN_FW_DISK_MBR_SIGNATURE 2 /* from MBR offset 0x1b8 */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* IN variables. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* OUT variables. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* Int13, Fn48: Check Extensions Present. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* Int13, Fn08: Legacy Get Device Parameters. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab uint16_t legacy_max_cylinder; /* %cl[7:6]:%ch: max cyl # */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab uint8_t legacy_sectors_per_track; /* %cl[5:0]: max sector # */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* Int13, Fn41: Get Device Parameters (as filled into %ds:%esi). */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* NB. First uint16_t of buffer must be set to buffer size. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* Int10, AX=4F15: Get EDID info. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* must refer to 128-byte buffer */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rabtypedef struct xenpf_firmware_info xenpf_firmware_info_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN variables */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint16_t pm1a_cnt_val; /* PM1a control value. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint16_t pm1b_cnt_val; /* PM1b control value. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t sleep_state; /* Which state to enter (Sn). */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xenpf_enter_acpi_sleep xenpf_enter_acpi_sleep_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart MaybeeDEFINE_XEN_GUEST_HANDLE(xenpf_enter_acpi_sleep_t);
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN variables */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xenpf_change_freq xenpf_change_freq_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * Get idle times (nanoseconds since boot) for physical CPUs specified in the
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * @cpumap_bitmap with range [0..@cpumap_nr_cpus-1]. The @idletime array is
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * indexed by CPU number; only entries with the corresponding @cpumap_bitmap
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * bit set are written to. On return, @cpumap_bitmap is modified so that any
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * non-existent CPUs are cleared. Such CPUs have their @idletime array entry
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN/OUT variables */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN: CPUs to interrogate; OUT: subset of IN which are present */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN variables */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* Size of cpumap bitmap. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* Must be indexable for every cpu in cpumap_bitmap. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* OUT variables */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* System time when the idletime snapshots were taken. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xenpf_getidletime xenpf_getidletime_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee/* ability bits */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee/* cmd type */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee/* Px sub info type */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t domain; /* domain number of one dependent group */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t num; /* number of processors in same domain */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xen_processor_csd xen_processor_csd_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee struct xen_power_register reg; /* GAS for Cx trigger register */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint8_t type; /* cstate value, c0: 0, c1: 1, ... */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t latency; /* worst latency (ms) to enter/exit this cstate */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t power; /* average power consumption(mW) */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t dpcnt; /* number of dependency entries */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee XEN_GUEST_HANDLE(xen_processor_csd_t) dp; /* NULL if no dependency */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xen_processor_cx xen_processor_cx_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t count; /* number of C state entries in array below */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee struct xen_processor_flags flags; /* global flags of this processor */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee XEN_GUEST_HANDLE(xen_processor_cx_t) states; /* supported c states */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint64_t transition_latency; /* microseconds */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint64_t bus_master_latency; /* microseconds */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xen_processor_px xen_processor_px_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t flags; /* flag for Px sub info type */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson uint32_t platform_limit; /* Platform limitation on freq usage */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t state_count; /* total available performance states */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t shared_type; /* coordination type of this processor */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xen_processor_performance xen_processor_performance_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart MaybeeDEFINE_XEN_GUEST_HANDLE(xen_processor_performance_t);
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN variables */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee struct xen_processor_power power;/* Cx: _CST/_CSD */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee struct xen_processor_performance perf; /* Px: _PPC/_PCT/_PSS/_PSD */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xenpf_set_processor_pminfo xenpf_set_processor_pminfo_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart MaybeeDEFINE_XEN_GUEST_HANDLE(xenpf_set_processor_pminfo_t);
843e19887f64dde75055cf8842fc4db2171eff45johnlev uint32_t interface_version; /* XENPF_INTERFACE_VERSION */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee struct xenpf_enter_acpi_sleep enter_acpi_sleep;
843e19887f64dde75055cf8842fc4db2171eff45johnlev#endif /* __XEN_PUBLIC_PLATFORM_H__ */
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Local variables:
843e19887f64dde75055cf8842fc4db2171eff45johnlev * c-set-style: "BSD"
843e19887f64dde75055cf8842fc4db2171eff45johnlev * c-basic-offset: 4
843e19887f64dde75055cf8842fc4db2171eff45johnlev * tab-width: 4
843e19887f64dde75055cf8842fc4db2171eff45johnlev * indent-tabs-mode: nil