include/linux/irqchip/arm-gic-v4.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright (C) 2016,2017 ARM Limited, All Rights Reserved.
   4  * Author: Marc Zyngier <marc.zyngier@arm.com>
   5  */
   6
   7 #ifndef __LINUX_IRQCHIP_ARM_GIC_V4_H
   8 #define __LINUX_IRQCHIP_ARM_GIC_V4_H
   9
  10 struct its_vpe;
  11
  12 /*
  13  * Maximum number of ITTs when GITS_TYPER.VMOVP == 0, using the
  14  * ITSList mechanism to perform inter-ITS synchronization.
  15  */
  16 #define GICv4_ITS_LIST_MAX              16
  17
  18 /* Embedded in kvm.arch */
  19 struct its_vm {
  20         struct fwnode_handle    *fwnode;
  21         struct irq_domain       *domain;
  22         struct page             *vprop_page;
  23         struct its_vpe          **vpes;
  24         int                     nr_vpes;
  25         irq_hw_number_t         db_lpi_base;
  26         unsigned long           *db_bitmap;
  27         int                     nr_db_lpis;
  28         u32                     vlpi_count[GICv4_ITS_LIST_MAX];
  29 };
  30
  31 /* Embedded in kvm_vcpu.arch */
  32 struct its_vpe {
  33         struct page             *vpt_page;
  34         struct its_vm           *its_vm;
  35         /* Doorbell interrupt */
  36         int                     irq;
  37         irq_hw_number_t         vpe_db_lpi;
  38         /* VPE proxy mapping */
  39         int                     vpe_proxy_event;
  40         /*
  41          * This collection ID is used to indirect the target
  42          * redistributor for this VPE. The ID itself isn't involved in
  43          * programming of the ITS.
  44          */
  45         u16                     col_idx;
  46         /* Unique (system-wide) VPE identifier */
  47         u16                     vpe_id;
  48         /* Implementation Defined Area Invalid */
  49         bool                    idai;
  50         /* Pending VLPIs on schedule out? */
  51         bool                    pending_last;
  52 };
  53
  54 /*
  55  * struct its_vlpi_map: structure describing the mapping of a
  56  * VLPI. Only to be interpreted in the context of a physical interrupt
  57  * it complements.  To be used as the vcpu_info passed to
  58  * irq_set_vcpu_affinity().
  59  *
  60  * @vm:         Pointer to the GICv4 notion of a VM
  61  * @vpe:        Pointer to the GICv4 notion of a virtual CPU (VPE)
  62  * @vintid:     Virtual LPI number
  63  * @properties: Priority and enable bits (as written in the prop table)
  64  * @db_enabled: Is the VPE doorbell to be generated?
  65  */
  66 struct its_vlpi_map {
  67         struct its_vm           *vm;
  68         struct its_vpe          *vpe;
  69         u32                     vintid;
  70         u8                      properties;
  71         bool                    db_enabled;
  72 };
  73
  74 enum its_vcpu_info_cmd_type {
  75         MAP_VLPI,
  76         GET_VLPI,
  77         PROP_UPDATE_VLPI,
  78         PROP_UPDATE_AND_INV_VLPI,
  79         SCHEDULE_VPE,
  80         DESCHEDULE_VPE,
  81         INVALL_VPE,
  82 };
  83
  84 struct its_cmd_info {
  85         enum its_vcpu_info_cmd_type     cmd_type;
  86         union {
  87                 struct its_vlpi_map     *map;
  88                 u8                      config;
  89         };
  90 };
  91
  92 int its_alloc_vcpu_irqs(struct its_vm *vm);
  93 void its_free_vcpu_irqs(struct its_vm *vm);
  94 int its_schedule_vpe(struct its_vpe *vpe, bool on);
  95 int its_invall_vpe(struct its_vpe *vpe);
  96 int its_map_vlpi(int irq, struct its_vlpi_map *map);
  97 int its_get_vlpi(int irq, struct its_vlpi_map *map);
  98 int its_unmap_vlpi(int irq);
  99 int its_prop_update_vlpi(int irq, u8 config, bool inv);
 100
 101 struct irq_domain_ops;
 102 int its_init_v4(struct irq_domain *domain, const struct irq_domain_ops *ops);
 103
 104 #endif