mirror of
				https://github.com/projectacrn/acrn-hypervisor.git
				synced 2025-11-04 03:28:59 +00:00 
			
		
		
		
	This commit adds ops to vlapic structure, and add an *ops parameter to vlapic_reset(). At vlapic reset, the ops is set to the global apicv_ops, and may be assigned to other ops later. Tracked-On: #3227 Signed-off-by: Yan, Like <like.yan@intel.com> Acked-by: Eddie Dong <eddie.dong@intel.com>
		
			
				
	
	
		
			217 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			217 lines
		
	
	
		
			6.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*-
 | 
						|
 * Copyright (c) 2011 NetApp, Inc.
 | 
						|
 * Copyright (c) 2017 Intel Corporation
 | 
						|
 * All rights reserved.
 | 
						|
 *
 | 
						|
 * Redistribution and use in source and binary forms, with or without
 | 
						|
 * modification, are permitted provided that the following conditions
 | 
						|
 * are met:
 | 
						|
 * 1. Redistributions of source code must retain the above copyright
 | 
						|
 *    notice, this list of conditions and the following disclaimer.
 | 
						|
 * 2. Redistributions in binary form must reproduce the above copyright
 | 
						|
 *    notice, this list of conditions and the following disclaimer in the
 | 
						|
 *    documentation and/or other materials provided with the distribution.
 | 
						|
 *
 | 
						|
 * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND
 | 
						|
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 | 
						|
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 | 
						|
 * ARE DISCLAIMED.  IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE
 | 
						|
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 | 
						|
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 | 
						|
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 | 
						|
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 | 
						|
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 | 
						|
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 | 
						|
 * SUCH DAMAGE.
 | 
						|
 *
 | 
						|
 * $FreeBSD$
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef VLAPIC_H
 | 
						|
#define VLAPIC_H
 | 
						|
 | 
						|
#include <page.h>
 | 
						|
#include <timer.h>
 | 
						|
#include <apicreg.h>
 | 
						|
 | 
						|
/**
 | 
						|
 * @file vlapic.h
 | 
						|
 *
 | 
						|
 * @brief public APIs for virtual LAPIC
 | 
						|
 */
 | 
						|
 | 
						|
 | 
						|
#define VLAPIC_MAXLVT_INDEX	APIC_LVT_CMCI
 | 
						|
 | 
						|
struct vlapic_pir_desc {
 | 
						|
	uint64_t pir[4];
 | 
						|
	uint64_t pending;
 | 
						|
	uint64_t unused[3];
 | 
						|
} __aligned(64);
 | 
						|
 | 
						|
struct vlapic_timer {
 | 
						|
	struct hv_timer timer;
 | 
						|
	uint32_t mode;
 | 
						|
	uint32_t tmicr;
 | 
						|
	uint32_t divisor_shift;
 | 
						|
};
 | 
						|
 | 
						|
struct acrn_vlapic {
 | 
						|
	/*
 | 
						|
	 * Please keep 'apic_page' and 'pir_desc' be the first two fields in
 | 
						|
	 * current structure, as below alignment restrictions are mandatory
 | 
						|
	 * to support APICv features:
 | 
						|
	 * - 'apic_page' MUST be 4KB aligned.
 | 
						|
	 * - 'pir_desc' MUST be 64 bytes aligned.
 | 
						|
	 * IRR, TMR and PIR could be accessed by other vCPUs when deliver
 | 
						|
	 * an interrupt to vLAPIC.
 | 
						|
	 */
 | 
						|
	struct lapic_regs	apic_page;
 | 
						|
	struct vlapic_pir_desc	pir_desc;
 | 
						|
 | 
						|
	struct acrn_vm		*vm;
 | 
						|
	struct acrn_vcpu	*vcpu;
 | 
						|
 | 
						|
	uint32_t		esr_pending;
 | 
						|
	int32_t			esr_firing;
 | 
						|
 | 
						|
	struct vlapic_timer	vtimer;
 | 
						|
 | 
						|
	/*
 | 
						|
	 * isrv: vector number for the highest priority bit that is set in the ISR
 | 
						|
	 */
 | 
						|
	uint32_t	isrv;
 | 
						|
 | 
						|
	uint64_t	msr_apicbase;
 | 
						|
 | 
						|
	const struct acrn_apicv_ops *ops;
 | 
						|
 | 
						|
	/*
 | 
						|
	 * Copies of some registers in the virtual APIC page. We do this for
 | 
						|
	 * a couple of different reasons:
 | 
						|
	 * - to be able to detect what changed (e.g. svr_last)
 | 
						|
	 * - to maintain a coherent snapshot of the register (e.g. lvt_last)
 | 
						|
	 */
 | 
						|
	uint32_t	svr_last;
 | 
						|
	uint32_t	lvt_last[VLAPIC_MAXLVT_INDEX + 1];
 | 
						|
} __aligned(PAGE_SIZE);
 | 
						|
 | 
						|
struct acrn_apicv_ops {
 | 
						|
	void (*accept_intr)(struct acrn_vlapic *vlapic, uint32_t vector, bool level);
 | 
						|
	bool (*inject_intr)(struct acrn_vlapic *vlapic, bool guest_irq_enabled, bool injected);
 | 
						|
	bool (*has_pending_delivery_intr)(struct acrn_vcpu *vcpu);
 | 
						|
	bool (*apic_read_access_may_valid)(uint32_t offset);
 | 
						|
	bool (*apic_write_access_may_valid)(uint32_t offset);
 | 
						|
	bool (*x2apic_read_msr_may_valid)(uint32_t offset);
 | 
						|
	bool (*x2apic_write_msr_may_valid)(uint32_t offset);
 | 
						|
};
 | 
						|
 | 
						|
extern const struct acrn_apicv_ops *apicv_ops;
 | 
						|
void vlapic_set_apicv_ops(void);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief virtual LAPIC
 | 
						|
 *
 | 
						|
 * @addtogroup acrn_vlapic ACRN vLAPIC
 | 
						|
 * @{
 | 
						|
 */
 | 
						|
 | 
						|
bool vlapic_inject_intr(struct acrn_vlapic *vlapic, bool guest_irq_enabled, bool injected);
 | 
						|
bool vlapic_has_pending_delivery_intr(struct acrn_vcpu *vcpu);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief Get physical address to PIR description.
 | 
						|
 *
 | 
						|
 * If APICv Posted-interrupt is supported, this address will be configured
 | 
						|
 * to VMCS "Posted-interrupt descriptor address" field.
 | 
						|
 *
 | 
						|
 * @param[in] vcpu Target vCPU
 | 
						|
 *
 | 
						|
 * @return physicall address to PIR
 | 
						|
 *
 | 
						|
 * @pre vcpu != NULL
 | 
						|
 */
 | 
						|
uint64_t apicv_get_pir_desc_paddr(struct acrn_vcpu *vcpu);
 | 
						|
 | 
						|
uint64_t vlapic_get_tsc_deadline_msr(const struct acrn_vlapic *vlapic);
 | 
						|
void vlapic_set_tsc_deadline_msr(struct acrn_vlapic *vlapic, uint64_t val_arg);
 | 
						|
uint64_t vlapic_get_apicbase(const struct acrn_vlapic *vlapic);
 | 
						|
int32_t vlapic_set_apicbase(struct acrn_vlapic *vlapic, uint64_t new);
 | 
						|
int32_t vlapic_x2apic_read(struct acrn_vcpu *vcpu, uint32_t msr, uint64_t *val);
 | 
						|
int32_t vlapic_x2apic_write(struct acrn_vcpu *vcpu, uint32_t msr, uint64_t val);
 | 
						|
 | 
						|
/*
 | 
						|
 * Signals to the LAPIC that an interrupt at 'vector' needs to be generated
 | 
						|
 * to the 'cpu', the state is recorded in IRR.
 | 
						|
 *  @pre vcpu != NULL
 | 
						|
 *  @pre vector <= 255U
 | 
						|
 */
 | 
						|
void vlapic_set_intr(struct acrn_vcpu *vcpu, uint32_t vector, bool level);
 | 
						|
 | 
						|
#define	LAPIC_TRIG_LEVEL	true
 | 
						|
#define	LAPIC_TRIG_EDGE		false
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief Triggers LAPIC local interrupt(LVT).
 | 
						|
 *
 | 
						|
 * @param[in] vm           Pointer to VM data structure
 | 
						|
 * @param[in] vcpu_id_arg  ID of vCPU, BROADCAST_CPU_ID means triggering
 | 
						|
 *			   interrupt to all vCPUs.
 | 
						|
 * @param[in] lvt_index    The index which LVT would to be fired.
 | 
						|
 *
 | 
						|
 * @retval 0 on success.
 | 
						|
 * @retval -EINVAL on error that vcpu_id_arg or vector of the LVT is invalid.
 | 
						|
 *
 | 
						|
 * @pre vm != NULL
 | 
						|
 */
 | 
						|
int32_t vlapic_set_local_intr(struct acrn_vm *vm, uint16_t vcpu_id_arg, uint32_t lvt_index);
 | 
						|
 | 
						|
/**
 | 
						|
 * @brief Inject MSI to target VM.
 | 
						|
 *
 | 
						|
 * @param[in] vm   Pointer to VM data structure
 | 
						|
 * @param[in] addr MSI address.
 | 
						|
 * @param[in] msg  MSI data.
 | 
						|
 *
 | 
						|
 * @retval 0 on success.
 | 
						|
 * @retval -1 on error that addr is invalid.
 | 
						|
 *
 | 
						|
 * @pre vm != NULL
 | 
						|
 */
 | 
						|
int32_t vlapic_intr_msi(struct acrn_vm *vm, uint64_t addr, uint64_t msg);
 | 
						|
 | 
						|
void vlapic_receive_intr(struct acrn_vm *vm, bool level, uint32_t dest,
 | 
						|
		bool phys, uint32_t delmode, uint32_t vec, bool rh);
 | 
						|
 | 
						|
uint32_t vlapic_get_apicid(const struct acrn_vlapic *vlapic);
 | 
						|
int32_t vlapic_create(struct acrn_vcpu *vcpu);
 | 
						|
/*
 | 
						|
 *  @pre vcpu != NULL
 | 
						|
 */
 | 
						|
void vlapic_free(struct acrn_vcpu *vcpu);
 | 
						|
/**
 | 
						|
 * @pre vlapic->vm != NULL
 | 
						|
 * @pre vlapic->vcpu->vcpu_id < CONFIG_MAX_VCPUS_PER_VM
 | 
						|
 */
 | 
						|
void vlapic_init(struct acrn_vlapic *vlapic);
 | 
						|
void vlapic_reset(struct acrn_vlapic *vlapic, const struct acrn_apicv_ops *ops);
 | 
						|
void vlapic_restore(struct acrn_vlapic *vlapic, const struct lapic_regs *regs);
 | 
						|
uint64_t vlapic_apicv_get_apic_access_addr(void);
 | 
						|
uint64_t vlapic_apicv_get_apic_page_addr(struct acrn_vlapic *vlapic);
 | 
						|
int32_t apic_access_vmexit_handler(struct acrn_vcpu *vcpu);
 | 
						|
int32_t apic_write_vmexit_handler(struct acrn_vcpu *vcpu);
 | 
						|
int32_t veoi_vmexit_handler(struct acrn_vcpu *vcpu);
 | 
						|
void vlapic_update_tpr_threshold(const struct acrn_vlapic *vlapic);
 | 
						|
int32_t tpr_below_threshold_vmexit_handler(struct acrn_vcpu *vcpu);
 | 
						|
void vlapic_calc_dest(struct acrn_vm *vm, uint64_t *dmask, bool is_broadcast,
 | 
						|
		uint32_t dest, bool phys, bool lowprio);
 | 
						|
void vlapic_calc_dest_lapic_pt(struct acrn_vm *vm, uint64_t *dmask, bool is_broadcast,
 | 
						|
		uint32_t dest, bool phys);
 | 
						|
bool is_x2apic_enabled(const struct acrn_vlapic *vlapic);
 | 
						|
bool is_xapic_enabled(const struct acrn_vlapic *vlapic);
 | 
						|
/**
 | 
						|
 * @}
 | 
						|
 */
 | 
						|
/* End of acrn_vlapic */
 | 
						|
#endif /* VLAPIC_H */
 |