vgic-mmio.h 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (C) 2015, 2016 ARM Ltd.
  4. */
  5. #ifndef __KVM_ARM_VGIC_MMIO_H__
  6. #define __KVM_ARM_VGIC_MMIO_H__
  7. struct vgic_register_region {
  8. unsigned int reg_offset;
  9. unsigned int len;
  10. unsigned int bits_per_irq;
  11. unsigned int access_flags;
  12. union {
  13. unsigned long (*read)(struct kvm_vcpu *vcpu, gpa_t addr,
  14. unsigned int len);
  15. unsigned long (*its_read)(struct kvm *kvm, struct vgic_its *its,
  16. gpa_t addr, unsigned int len);
  17. };
  18. union {
  19. void (*write)(struct kvm_vcpu *vcpu, gpa_t addr,
  20. unsigned int len, unsigned long val);
  21. void (*its_write)(struct kvm *kvm, struct vgic_its *its,
  22. gpa_t addr, unsigned int len,
  23. unsigned long val);
  24. };
  25. unsigned long (*uaccess_read)(struct kvm_vcpu *vcpu, gpa_t addr,
  26. unsigned int len);
  27. union {
  28. int (*uaccess_write)(struct kvm_vcpu *vcpu, gpa_t addr,
  29. unsigned int len, unsigned long val);
  30. int (*uaccess_its_write)(struct kvm *kvm, struct vgic_its *its,
  31. gpa_t addr, unsigned int len,
  32. unsigned long val);
  33. };
  34. };
  35. extern const struct kvm_io_device_ops kvm_io_gic_ops;
  36. #define VGIC_ACCESS_8bit 1
  37. #define VGIC_ACCESS_32bit 2
  38. #define VGIC_ACCESS_64bit 4
  39. /*
  40. * Generate a mask that covers the number of bytes required to address
  41. * up to 1024 interrupts, each represented by <bits> bits. This assumes
  42. * that <bits> is a power of two.
  43. */
  44. #define VGIC_ADDR_IRQ_MASK(bits) (((bits) * 1024 / 8) - 1)
  45. /*
  46. * (addr & mask) gives us the _byte_ offset for the INT ID.
  47. * We multiply this by 8 the get the _bit_ offset, then divide this by
  48. * the number of bits to learn the actual INT ID.
  49. * But instead of a division (which requires a "long long div" implementation),
  50. * we shift by the binary logarithm of <bits>.
  51. * This assumes that <bits> is a power of two.
  52. */
  53. #define VGIC_ADDR_TO_INTID(addr, bits) (((addr) & VGIC_ADDR_IRQ_MASK(bits)) * \
  54. 8 >> ilog2(bits))
  55. /*
  56. * Some VGIC registers store per-IRQ information, with a different number
  57. * of bits per IRQ. For those registers this macro is used.
  58. * The _WITH_LENGTH version instantiates registers with a fixed length
  59. * and is mutually exclusive with the _PER_IRQ version.
  60. */
  61. #define REGISTER_DESC_WITH_BITS_PER_IRQ(off, rd, wr, ur, uw, bpi, acc) \
  62. { \
  63. .reg_offset = off, \
  64. .bits_per_irq = bpi, \
  65. .len = bpi * 1024 / 8, \
  66. .access_flags = acc, \
  67. .read = rd, \
  68. .write = wr, \
  69. .uaccess_read = ur, \
  70. .uaccess_write = uw, \
  71. }
  72. #define REGISTER_DESC_WITH_LENGTH(off, rd, wr, length, acc) \
  73. { \
  74. .reg_offset = off, \
  75. .bits_per_irq = 0, \
  76. .len = length, \
  77. .access_flags = acc, \
  78. .read = rd, \
  79. .write = wr, \
  80. }
  81. #define REGISTER_DESC_WITH_LENGTH_UACCESS(off, rd, wr, urd, uwr, length, acc) \
  82. { \
  83. .reg_offset = off, \
  84. .bits_per_irq = 0, \
  85. .len = length, \
  86. .access_flags = acc, \
  87. .read = rd, \
  88. .write = wr, \
  89. .uaccess_read = urd, \
  90. .uaccess_write = uwr, \
  91. }
  92. unsigned long vgic_data_mmio_bus_to_host(const void *val, unsigned int len);
  93. void vgic_data_host_to_mmio_bus(void *buf, unsigned int len,
  94. unsigned long data);
  95. unsigned long extract_bytes(u64 data, unsigned int offset,
  96. unsigned int num);
  97. u64 update_64bit_reg(u64 reg, unsigned int offset, unsigned int len,
  98. unsigned long val);
  99. unsigned long vgic_mmio_read_raz(struct kvm_vcpu *vcpu,
  100. gpa_t addr, unsigned int len);
  101. unsigned long vgic_mmio_read_rao(struct kvm_vcpu *vcpu,
  102. gpa_t addr, unsigned int len);
  103. void vgic_mmio_write_wi(struct kvm_vcpu *vcpu, gpa_t addr,
  104. unsigned int len, unsigned long val);
  105. int vgic_mmio_uaccess_write_wi(struct kvm_vcpu *vcpu, gpa_t addr,
  106. unsigned int len, unsigned long val);
  107. unsigned long vgic_mmio_read_group(struct kvm_vcpu *vcpu, gpa_t addr,
  108. unsigned int len);
  109. void vgic_mmio_write_group(struct kvm_vcpu *vcpu, gpa_t addr,
  110. unsigned int len, unsigned long val);
  111. unsigned long vgic_mmio_read_enable(struct kvm_vcpu *vcpu,
  112. gpa_t addr, unsigned int len);
  113. void vgic_mmio_write_senable(struct kvm_vcpu *vcpu,
  114. gpa_t addr, unsigned int len,
  115. unsigned long val);
  116. void vgic_mmio_write_cenable(struct kvm_vcpu *vcpu,
  117. gpa_t addr, unsigned int len,
  118. unsigned long val);
  119. int vgic_uaccess_write_senable(struct kvm_vcpu *vcpu,
  120. gpa_t addr, unsigned int len,
  121. unsigned long val);
  122. int vgic_uaccess_write_cenable(struct kvm_vcpu *vcpu,
  123. gpa_t addr, unsigned int len,
  124. unsigned long val);
  125. unsigned long vgic_mmio_read_pending(struct kvm_vcpu *vcpu,
  126. gpa_t addr, unsigned int len);
  127. unsigned long vgic_uaccess_read_pending(struct kvm_vcpu *vcpu,
  128. gpa_t addr, unsigned int len);
  129. void vgic_mmio_write_spending(struct kvm_vcpu *vcpu,
  130. gpa_t addr, unsigned int len,
  131. unsigned long val);
  132. void vgic_mmio_write_cpending(struct kvm_vcpu *vcpu,
  133. gpa_t addr, unsigned int len,
  134. unsigned long val);
  135. int vgic_uaccess_write_spending(struct kvm_vcpu *vcpu,
  136. gpa_t addr, unsigned int len,
  137. unsigned long val);
  138. int vgic_uaccess_write_cpending(struct kvm_vcpu *vcpu,
  139. gpa_t addr, unsigned int len,
  140. unsigned long val);
  141. unsigned long vgic_mmio_read_active(struct kvm_vcpu *vcpu,
  142. gpa_t addr, unsigned int len);
  143. unsigned long vgic_uaccess_read_active(struct kvm_vcpu *vcpu,
  144. gpa_t addr, unsigned int len);
  145. void vgic_mmio_write_cactive(struct kvm_vcpu *vcpu,
  146. gpa_t addr, unsigned int len,
  147. unsigned long val);
  148. void vgic_mmio_write_sactive(struct kvm_vcpu *vcpu,
  149. gpa_t addr, unsigned int len,
  150. unsigned long val);
  151. int vgic_mmio_uaccess_write_cactive(struct kvm_vcpu *vcpu,
  152. gpa_t addr, unsigned int len,
  153. unsigned long val);
  154. int vgic_mmio_uaccess_write_sactive(struct kvm_vcpu *vcpu,
  155. gpa_t addr, unsigned int len,
  156. unsigned long val);
  157. unsigned long vgic_mmio_read_priority(struct kvm_vcpu *vcpu,
  158. gpa_t addr, unsigned int len);
  159. void vgic_mmio_write_priority(struct kvm_vcpu *vcpu,
  160. gpa_t addr, unsigned int len,
  161. unsigned long val);
  162. unsigned long vgic_mmio_read_config(struct kvm_vcpu *vcpu,
  163. gpa_t addr, unsigned int len);
  164. void vgic_mmio_write_config(struct kvm_vcpu *vcpu,
  165. gpa_t addr, unsigned int len,
  166. unsigned long val);
  167. int vgic_uaccess(struct kvm_vcpu *vcpu, struct vgic_io_device *dev,
  168. bool is_write, int offset, u32 *val);
  169. u32 vgic_read_irq_line_level_info(struct kvm_vcpu *vcpu, u32 intid);
  170. void vgic_write_irq_line_level_info(struct kvm_vcpu *vcpu, u32 intid,
  171. const u32 val);
  172. unsigned int vgic_v2_init_dist_iodev(struct vgic_io_device *dev);
  173. unsigned int vgic_v3_init_dist_iodev(struct vgic_io_device *dev);
  174. u64 vgic_sanitise_outer_cacheability(u64 reg);
  175. u64 vgic_sanitise_inner_cacheability(u64 reg);
  176. u64 vgic_sanitise_shareability(u64 reg);
  177. u64 vgic_sanitise_field(u64 reg, u64 field_mask, int field_shift,
  178. u64 (*sanitise_fn)(u64));
  179. /* Find the proper register handler entry given a certain address offset */
  180. const struct vgic_register_region *
  181. vgic_find_mmio_region(const struct vgic_register_region *regions,
  182. int nr_regions, unsigned int offset);
  183. #endif