1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * RISC-V SBI specific definitions 4 * 5 * Copyright (C) 2024 Rivos Inc. 6 */ 7 8 #ifndef SELFTEST_KVM_SBI_H 9 #define SELFTEST_KVM_SBI_H 10 11 /* SBI spec version fields */ 12 #define SBI_SPEC_VERSION_DEFAULT 0x1 13 #define SBI_SPEC_VERSION_MAJOR_SHIFT 24 14 #define SBI_SPEC_VERSION_MAJOR_MASK 0x7f 15 #define SBI_SPEC_VERSION_MINOR_MASK 0xffffff 16 17 /* SBI return error codes */ 18 #define SBI_SUCCESS 0 19 #define SBI_ERR_FAILURE -1 20 #define SBI_ERR_NOT_SUPPORTED -2 21 #define SBI_ERR_INVALID_PARAM -3 22 #define SBI_ERR_DENIED -4 23 #define SBI_ERR_INVALID_ADDRESS -5 24 #define SBI_ERR_ALREADY_AVAILABLE -6 25 #define SBI_ERR_ALREADY_STARTED -7 26 #define SBI_ERR_ALREADY_STOPPED -8 27 28 #define SBI_EXT_EXPERIMENTAL_START 0x08000000 29 #define SBI_EXT_EXPERIMENTAL_END 0x08FFFFFF 30 31 #define KVM_RISCV_SELFTESTS_SBI_EXT SBI_EXT_EXPERIMENTAL_END 32 #define KVM_RISCV_SELFTESTS_SBI_UCALL 0 33 #define KVM_RISCV_SELFTESTS_SBI_UNEXP 1 34 35 enum sbi_ext_id { 36 SBI_EXT_BASE = 0x10, 37 SBI_EXT_STA = 0x535441, 38 SBI_EXT_PMU = 0x504D55, 39 }; 40 41 enum sbi_ext_base_fid { 42 SBI_EXT_BASE_GET_SPEC_VERSION = 0, 43 SBI_EXT_BASE_GET_IMP_ID, 44 SBI_EXT_BASE_GET_IMP_VERSION, 45 SBI_EXT_BASE_PROBE_EXT = 3, 46 }; 47 enum sbi_ext_pmu_fid { 48 SBI_EXT_PMU_NUM_COUNTERS = 0, 49 SBI_EXT_PMU_COUNTER_GET_INFO, 50 SBI_EXT_PMU_COUNTER_CFG_MATCH, 51 SBI_EXT_PMU_COUNTER_START, 52 SBI_EXT_PMU_COUNTER_STOP, 53 SBI_EXT_PMU_COUNTER_FW_READ, 54 SBI_EXT_PMU_COUNTER_FW_READ_HI, 55 SBI_EXT_PMU_SNAPSHOT_SET_SHMEM, 56 }; 57 58 union sbi_pmu_ctr_info { 59 unsigned long value; 60 struct { 61 unsigned long csr:12; 62 unsigned long width:6; 63 #if __riscv_xlen == 32 64 unsigned long reserved:13; 65 #else 66 unsigned long reserved:45; 67 #endif 68 unsigned long type:1; 69 }; 70 }; 71 72 struct riscv_pmu_snapshot_data { 73 u64 ctr_overflow_mask; 74 u64 ctr_values[64]; 75 u64 reserved[447]; 76 }; 77 78 struct sbiret { 79 long error; 80 long value; 81 }; 82 83 /** General pmu event codes specified in SBI PMU extension */ 84 enum sbi_pmu_hw_generic_events_t { 85 SBI_PMU_HW_NO_EVENT = 0, 86 SBI_PMU_HW_CPU_CYCLES = 1, 87 SBI_PMU_HW_INSTRUCTIONS = 2, 88 SBI_PMU_HW_CACHE_REFERENCES = 3, 89 SBI_PMU_HW_CACHE_MISSES = 4, 90 SBI_PMU_HW_BRANCH_INSTRUCTIONS = 5, 91 SBI_PMU_HW_BRANCH_MISSES = 6, 92 SBI_PMU_HW_BUS_CYCLES = 7, 93 SBI_PMU_HW_STALLED_CYCLES_FRONTEND = 8, 94 SBI_PMU_HW_STALLED_CYCLES_BACKEND = 9, 95 SBI_PMU_HW_REF_CPU_CYCLES = 10, 96 97 SBI_PMU_HW_GENERAL_MAX, 98 }; 99 100 enum sbi_pmu_fw_generic_events_t { 101 SBI_PMU_FW_MISALIGNED_LOAD = 0, 102 SBI_PMU_FW_MISALIGNED_STORE = 1, 103 SBI_PMU_FW_ACCESS_LOAD = 2, 104 SBI_PMU_FW_ACCESS_STORE = 3, 105 SBI_PMU_FW_ILLEGAL_INSN = 4, 106 SBI_PMU_FW_SET_TIMER = 5, 107 SBI_PMU_FW_IPI_SENT = 6, 108 SBI_PMU_FW_IPI_RCVD = 7, 109 SBI_PMU_FW_FENCE_I_SENT = 8, 110 SBI_PMU_FW_FENCE_I_RCVD = 9, 111 SBI_PMU_FW_SFENCE_VMA_SENT = 10, 112 SBI_PMU_FW_SFENCE_VMA_RCVD = 11, 113 SBI_PMU_FW_SFENCE_VMA_ASID_SENT = 12, 114 SBI_PMU_FW_SFENCE_VMA_ASID_RCVD = 13, 115 116 SBI_PMU_FW_HFENCE_GVMA_SENT = 14, 117 SBI_PMU_FW_HFENCE_GVMA_RCVD = 15, 118 SBI_PMU_FW_HFENCE_GVMA_VMID_SENT = 16, 119 SBI_PMU_FW_HFENCE_GVMA_VMID_RCVD = 17, 120 121 SBI_PMU_FW_HFENCE_VVMA_SENT = 18, 122 SBI_PMU_FW_HFENCE_VVMA_RCVD = 19, 123 SBI_PMU_FW_HFENCE_VVMA_ASID_SENT = 20, 124 SBI_PMU_FW_HFENCE_VVMA_ASID_RCVD = 21, 125 SBI_PMU_FW_MAX, 126 }; 127 128 /* SBI PMU event types */ 129 enum sbi_pmu_event_type { 130 SBI_PMU_EVENT_TYPE_HW = 0x0, 131 SBI_PMU_EVENT_TYPE_CACHE = 0x1, 132 SBI_PMU_EVENT_TYPE_RAW = 0x2, 133 SBI_PMU_EVENT_TYPE_RAW_V2 = 0x3, 134 SBI_PMU_EVENT_TYPE_FW = 0xf, 135 }; 136 137 /* SBI PMU counter types */ 138 enum sbi_pmu_ctr_type { 139 SBI_PMU_CTR_TYPE_HW = 0x0, 140 SBI_PMU_CTR_TYPE_FW, 141 }; 142 143 /* Flags defined for config matching function */ 144 #define SBI_PMU_CFG_FLAG_SKIP_MATCH BIT(0) 145 #define SBI_PMU_CFG_FLAG_CLEAR_VALUE BIT(1) 146 #define SBI_PMU_CFG_FLAG_AUTO_START BIT(2) 147 #define SBI_PMU_CFG_FLAG_SET_VUINH BIT(3) 148 #define SBI_PMU_CFG_FLAG_SET_VSINH BIT(4) 149 #define SBI_PMU_CFG_FLAG_SET_UINH BIT(5) 150 #define SBI_PMU_CFG_FLAG_SET_SINH BIT(6) 151 #define SBI_PMU_CFG_FLAG_SET_MINH BIT(7) 152 153 /* Flags defined for counter start function */ 154 #define SBI_PMU_START_FLAG_SET_INIT_VALUE BIT(0) 155 #define SBI_PMU_START_FLAG_INIT_SNAPSHOT BIT(1) 156 157 /* Flags defined for counter stop function */ 158 #define SBI_PMU_STOP_FLAG_RESET BIT(0) 159 #define SBI_PMU_STOP_FLAG_TAKE_SNAPSHOT BIT(1) 160 161 struct sbiret sbi_ecall(int ext, int fid, unsigned long arg0, 162 unsigned long arg1, unsigned long arg2, 163 unsigned long arg3, unsigned long arg4, 164 unsigned long arg5); 165 166 bool guest_sbi_probe_extension(int extid, long *out_val); 167 168 /* Make SBI version */ 169 static inline unsigned long sbi_mk_version(unsigned long major, 170 unsigned long minor) 171 { 172 return ((major & SBI_SPEC_VERSION_MAJOR_MASK) << SBI_SPEC_VERSION_MAJOR_SHIFT) 173 | (minor & SBI_SPEC_VERSION_MINOR_MASK); 174 } 175 176 unsigned long get_host_sbi_spec_version(void); 177 178 #endif /* SELFTEST_KVM_SBI_H */ 179