sbi.h 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (C) 2015 Regents of the University of California
  4. * Copyright (c) 2020 Western Digital Corporation or its affiliates.
  5. */
  6. #ifndef _ASM_RISCV_SBI_H
  7. #define _ASM_RISCV_SBI_H
  8. #include <linux/types.h>
  9. #include <linux/cpumask.h>
  10. #ifdef CONFIG_RISCV_SBI
  11. enum sbi_ext_id {
  12. #ifdef CONFIG_RISCV_SBI_V01
  13. SBI_EXT_0_1_SET_TIMER = 0x0,
  14. SBI_EXT_0_1_CONSOLE_PUTCHAR = 0x1,
  15. SBI_EXT_0_1_CONSOLE_GETCHAR = 0x2,
  16. SBI_EXT_0_1_CLEAR_IPI = 0x3,
  17. SBI_EXT_0_1_SEND_IPI = 0x4,
  18. SBI_EXT_0_1_REMOTE_FENCE_I = 0x5,
  19. SBI_EXT_0_1_REMOTE_SFENCE_VMA = 0x6,
  20. SBI_EXT_0_1_REMOTE_SFENCE_VMA_ASID = 0x7,
  21. SBI_EXT_0_1_SHUTDOWN = 0x8,
  22. #endif
  23. SBI_EXT_BASE = 0x10,
  24. SBI_EXT_TIME = 0x54494D45,
  25. SBI_EXT_IPI = 0x735049,
  26. SBI_EXT_RFENCE = 0x52464E43,
  27. SBI_EXT_HSM = 0x48534D,
  28. SBI_EXT_SRST = 0x53525354,
  29. SBI_EXT_PMU = 0x504D55,
  30. /* Experimentals extensions must lie within this range */
  31. SBI_EXT_EXPERIMENTAL_START = 0x08000000,
  32. SBI_EXT_EXPERIMENTAL_END = 0x08FFFFFF,
  33. /* Vendor extensions must lie within this range */
  34. SBI_EXT_VENDOR_START = 0x09000000,
  35. SBI_EXT_VENDOR_END = 0x09FFFFFF,
  36. };
  37. enum sbi_ext_base_fid {
  38. SBI_EXT_BASE_GET_SPEC_VERSION = 0,
  39. SBI_EXT_BASE_GET_IMP_ID,
  40. SBI_EXT_BASE_GET_IMP_VERSION,
  41. SBI_EXT_BASE_PROBE_EXT,
  42. SBI_EXT_BASE_GET_MVENDORID,
  43. SBI_EXT_BASE_GET_MARCHID,
  44. SBI_EXT_BASE_GET_MIMPID,
  45. };
  46. enum sbi_ext_time_fid {
  47. SBI_EXT_TIME_SET_TIMER = 0,
  48. };
  49. enum sbi_ext_ipi_fid {
  50. SBI_EXT_IPI_SEND_IPI = 0,
  51. };
  52. enum sbi_ext_rfence_fid {
  53. SBI_EXT_RFENCE_REMOTE_FENCE_I = 0,
  54. SBI_EXT_RFENCE_REMOTE_SFENCE_VMA,
  55. SBI_EXT_RFENCE_REMOTE_SFENCE_VMA_ASID,
  56. SBI_EXT_RFENCE_REMOTE_HFENCE_GVMA_VMID,
  57. SBI_EXT_RFENCE_REMOTE_HFENCE_GVMA,
  58. SBI_EXT_RFENCE_REMOTE_HFENCE_VVMA_ASID,
  59. SBI_EXT_RFENCE_REMOTE_HFENCE_VVMA,
  60. };
  61. enum sbi_ext_hsm_fid {
  62. SBI_EXT_HSM_HART_START = 0,
  63. SBI_EXT_HSM_HART_STOP,
  64. SBI_EXT_HSM_HART_STATUS,
  65. SBI_EXT_HSM_HART_SUSPEND,
  66. };
  67. enum sbi_hsm_hart_state {
  68. SBI_HSM_STATE_STARTED = 0,
  69. SBI_HSM_STATE_STOPPED,
  70. SBI_HSM_STATE_START_PENDING,
  71. SBI_HSM_STATE_STOP_PENDING,
  72. SBI_HSM_STATE_SUSPENDED,
  73. SBI_HSM_STATE_SUSPEND_PENDING,
  74. SBI_HSM_STATE_RESUME_PENDING,
  75. };
  76. #define SBI_HSM_SUSP_BASE_MASK 0x7fffffff
  77. #define SBI_HSM_SUSP_NON_RET_BIT 0x80000000
  78. #define SBI_HSM_SUSP_PLAT_BASE 0x10000000
  79. #define SBI_HSM_SUSPEND_RET_DEFAULT 0x00000000
  80. #define SBI_HSM_SUSPEND_RET_PLATFORM SBI_HSM_SUSP_PLAT_BASE
  81. #define SBI_HSM_SUSPEND_RET_LAST SBI_HSM_SUSP_BASE_MASK
  82. #define SBI_HSM_SUSPEND_NON_RET_DEFAULT SBI_HSM_SUSP_NON_RET_BIT
  83. #define SBI_HSM_SUSPEND_NON_RET_PLATFORM (SBI_HSM_SUSP_NON_RET_BIT | \
  84. SBI_HSM_SUSP_PLAT_BASE)
  85. #define SBI_HSM_SUSPEND_NON_RET_LAST (SBI_HSM_SUSP_NON_RET_BIT | \
  86. SBI_HSM_SUSP_BASE_MASK)
  87. enum sbi_ext_srst_fid {
  88. SBI_EXT_SRST_RESET = 0,
  89. };
  90. enum sbi_srst_reset_type {
  91. SBI_SRST_RESET_TYPE_SHUTDOWN = 0,
  92. SBI_SRST_RESET_TYPE_COLD_REBOOT,
  93. SBI_SRST_RESET_TYPE_WARM_REBOOT,
  94. };
  95. enum sbi_srst_reset_reason {
  96. SBI_SRST_RESET_REASON_NONE = 0,
  97. SBI_SRST_RESET_REASON_SYS_FAILURE,
  98. };
  99. enum sbi_ext_pmu_fid {
  100. SBI_EXT_PMU_NUM_COUNTERS = 0,
  101. SBI_EXT_PMU_COUNTER_GET_INFO,
  102. SBI_EXT_PMU_COUNTER_CFG_MATCH,
  103. SBI_EXT_PMU_COUNTER_START,
  104. SBI_EXT_PMU_COUNTER_STOP,
  105. SBI_EXT_PMU_COUNTER_FW_READ,
  106. };
  107. union sbi_pmu_ctr_info {
  108. unsigned long value;
  109. struct {
  110. unsigned long csr:12;
  111. unsigned long width:6;
  112. #if __riscv_xlen == 32
  113. unsigned long reserved:13;
  114. #else
  115. unsigned long reserved:45;
  116. #endif
  117. unsigned long type:1;
  118. };
  119. };
  120. #define RISCV_PMU_RAW_EVENT_MASK GENMASK_ULL(47, 0)
  121. #define RISCV_PMU_RAW_EVENT_IDX 0x20000
  122. /** General pmu event codes specified in SBI PMU extension */
  123. enum sbi_pmu_hw_generic_events_t {
  124. SBI_PMU_HW_NO_EVENT = 0,
  125. SBI_PMU_HW_CPU_CYCLES = 1,
  126. SBI_PMU_HW_INSTRUCTIONS = 2,
  127. SBI_PMU_HW_CACHE_REFERENCES = 3,
  128. SBI_PMU_HW_CACHE_MISSES = 4,
  129. SBI_PMU_HW_BRANCH_INSTRUCTIONS = 5,
  130. SBI_PMU_HW_BRANCH_MISSES = 6,
  131. SBI_PMU_HW_BUS_CYCLES = 7,
  132. SBI_PMU_HW_STALLED_CYCLES_FRONTEND = 8,
  133. SBI_PMU_HW_STALLED_CYCLES_BACKEND = 9,
  134. SBI_PMU_HW_REF_CPU_CYCLES = 10,
  135. SBI_PMU_HW_GENERAL_MAX,
  136. };
  137. /**
  138. * Special "firmware" events provided by the firmware, even if the hardware
  139. * does not support performance events. These events are encoded as a raw
  140. * event type in Linux kernel perf framework.
  141. */
  142. enum sbi_pmu_fw_generic_events_t {
  143. SBI_PMU_FW_MISALIGNED_LOAD = 0,
  144. SBI_PMU_FW_MISALIGNED_STORE = 1,
  145. SBI_PMU_FW_ACCESS_LOAD = 2,
  146. SBI_PMU_FW_ACCESS_STORE = 3,
  147. SBI_PMU_FW_ILLEGAL_INSN = 4,
  148. SBI_PMU_FW_SET_TIMER = 5,
  149. SBI_PMU_FW_IPI_SENT = 6,
  150. SBI_PMU_FW_IPI_RECVD = 7,
  151. SBI_PMU_FW_FENCE_I_SENT = 8,
  152. SBI_PMU_FW_FENCE_I_RECVD = 9,
  153. SBI_PMU_FW_SFENCE_VMA_SENT = 10,
  154. SBI_PMU_FW_SFENCE_VMA_RCVD = 11,
  155. SBI_PMU_FW_SFENCE_VMA_ASID_SENT = 12,
  156. SBI_PMU_FW_SFENCE_VMA_ASID_RCVD = 13,
  157. SBI_PMU_FW_HFENCE_GVMA_SENT = 14,
  158. SBI_PMU_FW_HFENCE_GVMA_RCVD = 15,
  159. SBI_PMU_FW_HFENCE_GVMA_VMID_SENT = 16,
  160. SBI_PMU_FW_HFENCE_GVMA_VMID_RCVD = 17,
  161. SBI_PMU_FW_HFENCE_VVMA_SENT = 18,
  162. SBI_PMU_FW_HFENCE_VVMA_RCVD = 19,
  163. SBI_PMU_FW_HFENCE_VVMA_ASID_SENT = 20,
  164. SBI_PMU_FW_HFENCE_VVMA_ASID_RCVD = 21,
  165. SBI_PMU_FW_MAX,
  166. };
  167. /* SBI PMU event types */
  168. enum sbi_pmu_event_type {
  169. SBI_PMU_EVENT_TYPE_HW = 0x0,
  170. SBI_PMU_EVENT_TYPE_CACHE = 0x1,
  171. SBI_PMU_EVENT_TYPE_RAW = 0x2,
  172. SBI_PMU_EVENT_TYPE_FW = 0xf,
  173. };
  174. /* SBI PMU event types */
  175. enum sbi_pmu_ctr_type {
  176. SBI_PMU_CTR_TYPE_HW = 0x0,
  177. SBI_PMU_CTR_TYPE_FW,
  178. };
  179. /* Helper macros to decode event idx */
  180. #define SBI_PMU_EVENT_IDX_OFFSET 20
  181. #define SBI_PMU_EVENT_IDX_MASK 0xFFFFF
  182. #define SBI_PMU_EVENT_IDX_CODE_MASK 0xFFFF
  183. #define SBI_PMU_EVENT_IDX_TYPE_MASK 0xF0000
  184. #define SBI_PMU_EVENT_RAW_IDX 0x20000
  185. #define SBI_PMU_FIXED_CTR_MASK 0x07
  186. #define SBI_PMU_EVENT_CACHE_ID_CODE_MASK 0xFFF8
  187. #define SBI_PMU_EVENT_CACHE_OP_ID_CODE_MASK 0x06
  188. #define SBI_PMU_EVENT_CACHE_RESULT_ID_CODE_MASK 0x01
  189. #define SBI_PMU_EVENT_IDX_INVALID 0xFFFFFFFF
  190. /* Flags defined for config matching function */
  191. #define SBI_PMU_CFG_FLAG_SKIP_MATCH (1 << 0)
  192. #define SBI_PMU_CFG_FLAG_CLEAR_VALUE (1 << 1)
  193. #define SBI_PMU_CFG_FLAG_AUTO_START (1 << 2)
  194. #define SBI_PMU_CFG_FLAG_SET_VUINH (1 << 3)
  195. #define SBI_PMU_CFG_FLAG_SET_VSINH (1 << 4)
  196. #define SBI_PMU_CFG_FLAG_SET_UINH (1 << 5)
  197. #define SBI_PMU_CFG_FLAG_SET_SINH (1 << 6)
  198. #define SBI_PMU_CFG_FLAG_SET_MINH (1 << 7)
  199. /* Flags defined for counter start function */
  200. #define SBI_PMU_START_FLAG_SET_INIT_VALUE (1 << 0)
  201. /* Flags defined for counter stop function */
  202. #define SBI_PMU_STOP_FLAG_RESET (1 << 0)
  203. #define SBI_SPEC_VERSION_DEFAULT 0x1
  204. #define SBI_SPEC_VERSION_MAJOR_SHIFT 24
  205. #define SBI_SPEC_VERSION_MAJOR_MASK 0x7f
  206. #define SBI_SPEC_VERSION_MINOR_MASK 0xffffff
  207. /* SBI return error codes */
  208. #define SBI_SUCCESS 0
  209. #define SBI_ERR_FAILURE -1
  210. #define SBI_ERR_NOT_SUPPORTED -2
  211. #define SBI_ERR_INVALID_PARAM -3
  212. #define SBI_ERR_DENIED -4
  213. #define SBI_ERR_INVALID_ADDRESS -5
  214. #define SBI_ERR_ALREADY_AVAILABLE -6
  215. #define SBI_ERR_ALREADY_STARTED -7
  216. #define SBI_ERR_ALREADY_STOPPED -8
  217. extern unsigned long sbi_spec_version;
  218. struct sbiret {
  219. long error;
  220. long value;
  221. };
  222. void sbi_init(void);
  223. struct sbiret sbi_ecall(int ext, int fid, unsigned long arg0,
  224. unsigned long arg1, unsigned long arg2,
  225. unsigned long arg3, unsigned long arg4,
  226. unsigned long arg5);
  227. void sbi_console_putchar(int ch);
  228. int sbi_console_getchar(void);
  229. long sbi_get_mvendorid(void);
  230. long sbi_get_marchid(void);
  231. long sbi_get_mimpid(void);
  232. void sbi_set_timer(uint64_t stime_value);
  233. void sbi_shutdown(void);
  234. void sbi_clear_ipi(void);
  235. int sbi_send_ipi(const struct cpumask *cpu_mask);
  236. int sbi_remote_fence_i(const struct cpumask *cpu_mask);
  237. int sbi_remote_sfence_vma(const struct cpumask *cpu_mask,
  238. unsigned long start,
  239. unsigned long size);
  240. int sbi_remote_sfence_vma_asid(const struct cpumask *cpu_mask,
  241. unsigned long start,
  242. unsigned long size,
  243. unsigned long asid);
  244. int sbi_remote_hfence_gvma(const struct cpumask *cpu_mask,
  245. unsigned long start,
  246. unsigned long size);
  247. int sbi_remote_hfence_gvma_vmid(const struct cpumask *cpu_mask,
  248. unsigned long start,
  249. unsigned long size,
  250. unsigned long vmid);
  251. int sbi_remote_hfence_vvma(const struct cpumask *cpu_mask,
  252. unsigned long start,
  253. unsigned long size);
  254. int sbi_remote_hfence_vvma_asid(const struct cpumask *cpu_mask,
  255. unsigned long start,
  256. unsigned long size,
  257. unsigned long asid);
  258. long sbi_probe_extension(int ext);
  259. /* Check if current SBI specification version is 0.1 or not */
  260. static inline int sbi_spec_is_0_1(void)
  261. {
  262. return (sbi_spec_version == SBI_SPEC_VERSION_DEFAULT) ? 1 : 0;
  263. }
  264. /* Get the major version of SBI */
  265. static inline unsigned long sbi_major_version(void)
  266. {
  267. return (sbi_spec_version >> SBI_SPEC_VERSION_MAJOR_SHIFT) &
  268. SBI_SPEC_VERSION_MAJOR_MASK;
  269. }
  270. /* Get the minor version of SBI */
  271. static inline unsigned long sbi_minor_version(void)
  272. {
  273. return sbi_spec_version & SBI_SPEC_VERSION_MINOR_MASK;
  274. }
  275. /* Make SBI version */
  276. static inline unsigned long sbi_mk_version(unsigned long major,
  277. unsigned long minor)
  278. {
  279. return ((major & SBI_SPEC_VERSION_MAJOR_MASK) <<
  280. SBI_SPEC_VERSION_MAJOR_SHIFT) | minor;
  281. }
  282. int sbi_err_map_linux_errno(int err);
  283. #else /* CONFIG_RISCV_SBI */
  284. static inline int sbi_remote_fence_i(const struct cpumask *cpu_mask) { return -1; }
  285. static inline void sbi_init(void) {}
  286. #endif /* CONFIG_RISCV_SBI */
  287. #endif /* _ASM_RISCV_SBI_H */