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
7 #ifndef _ASM_RISCV_SBI_H
8 #define _ASM_RISCV_SBI_H
9
10 #include <linux/types.h>
11
12 #ifdef CONFIG_RISCV_SBI
13 enum sbi_ext_id {
14 #ifdef CONFIG_RISCV_SBI_V01
15 SBI_EXT_0_1_SET_TIMER = 0x0,
16 SBI_EXT_0_1_CONSOLE_PUTCHAR = 0x1,
17 SBI_EXT_0_1_CONSOLE_GETCHAR = 0x2,
18 SBI_EXT_0_1_CLEAR_IPI = 0x3,
19 SBI_EXT_0_1_SEND_IPI = 0x4,
20 SBI_EXT_0_1_REMOTE_FENCE_I = 0x5,
21 SBI_EXT_0_1_REMOTE_SFENCE_VMA = 0x6,
22 SBI_EXT_0_1_REMOTE_SFENCE_VMA_ASID = 0x7,
23 SBI_EXT_0_1_SHUTDOWN = 0x8,
24 #endif
25 SBI_EXT_BASE = 0x10,
26 SBI_EXT_TIME = 0x54494D45,
27 SBI_EXT_IPI = 0x735049,
28 SBI_EXT_RFENCE = 0x52464E43,
29 SBI_EXT_HSM = 0x48534D,
30 };
31
32 enum sbi_ext_base_fid {
33 SBI_EXT_BASE_GET_SPEC_VERSION = 0,
34 SBI_EXT_BASE_GET_IMP_ID,
35 SBI_EXT_BASE_GET_IMP_VERSION,
36 SBI_EXT_BASE_PROBE_EXT,
37 SBI_EXT_BASE_GET_MVENDORID,
38 SBI_EXT_BASE_GET_MARCHID,
39 SBI_EXT_BASE_GET_MIMPID,
40 };
41
42 enum sbi_ext_time_fid {
43 SBI_EXT_TIME_SET_TIMER = 0,
44 };
45
46 enum sbi_ext_ipi_fid {
47 SBI_EXT_IPI_SEND_IPI = 0,
48 };
49
50 enum sbi_ext_rfence_fid {
51 SBI_EXT_RFENCE_REMOTE_FENCE_I = 0,
52 SBI_EXT_RFENCE_REMOTE_SFENCE_VMA,
53 SBI_EXT_RFENCE_REMOTE_SFENCE_VMA_ASID,
54 SBI_EXT_RFENCE_REMOTE_HFENCE_GVMA_VMID,
55 SBI_EXT_RFENCE_REMOTE_HFENCE_GVMA,
56 SBI_EXT_RFENCE_REMOTE_HFENCE_VVMA_ASID,
57 SBI_EXT_RFENCE_REMOTE_HFENCE_VVMA,
58 };
59
60 enum sbi_ext_hsm_fid {
61 SBI_EXT_HSM_HART_START = 0,
62 SBI_EXT_HSM_HART_STOP,
63 SBI_EXT_HSM_HART_STATUS,
64 };
65
66 enum sbi_hsm_hart_status {
67 SBI_HSM_HART_STATUS_STARTED = 0,
68 SBI_HSM_HART_STATUS_STOPPED,
69 SBI_HSM_HART_STATUS_START_PENDING,
70 SBI_HSM_HART_STATUS_STOP_PENDING,
71 };
72
73 #define SBI_SPEC_VERSION_DEFAULT 0x1
74 #define SBI_SPEC_VERSION_MAJOR_SHIFT 24
75 #define SBI_SPEC_VERSION_MAJOR_MASK 0x7f
76 #define SBI_SPEC_VERSION_MINOR_MASK 0xffffff
77
78 /* SBI return error codes */
79 #define SBI_SUCCESS 0
80 #define SBI_ERR_FAILURE -1
81 #define SBI_ERR_NOT_SUPPORTED -2
82 #define SBI_ERR_INVALID_PARAM -3
83 #define SBI_ERR_DENIED -4
84 #define SBI_ERR_INVALID_ADDRESS -5
85
86 extern unsigned long sbi_spec_version;
87 struct sbiret {
88 long error;
89 long value;
90 };
91
92 int sbi_init(void);
93 struct sbiret sbi_ecall(int ext, int fid, unsigned long arg0,
94 unsigned long arg1, unsigned long arg2,
95 unsigned long arg3, unsigned long arg4,
96 unsigned long arg5);
97
98 void sbi_console_putchar(int ch);
99 int sbi_console_getchar(void);
100 void sbi_set_timer(uint64_t stime_value);
101 void sbi_shutdown(void);
102 void sbi_clear_ipi(void);
103 void sbi_send_ipi(const unsigned long *hart_mask);
104 void sbi_remote_fence_i(const unsigned long *hart_mask);
105 void sbi_remote_sfence_vma(const unsigned long *hart_mask,
106 unsigned long start,
107 unsigned long size);
108
109 void sbi_remote_sfence_vma_asid(const unsigned long *hart_mask,
110 unsigned long start,
111 unsigned long size,
112 unsigned long asid);
113 int sbi_remote_hfence_gvma(const unsigned long *hart_mask,
114 unsigned long start,
115 unsigned long size);
116 int sbi_remote_hfence_gvma_vmid(const unsigned long *hart_mask,
117 unsigned long start,
118 unsigned long size,
119 unsigned long vmid);
120 int sbi_remote_hfence_vvma(const unsigned long *hart_mask,
121 unsigned long start,
122 unsigned long size);
123 int sbi_remote_hfence_vvma_asid(const unsigned long *hart_mask,
124 unsigned long start,
125 unsigned long size,
126 unsigned long asid);
127 int sbi_probe_extension(int ext);
128
129 /* Check if current SBI specification version is 0.1 or not */
sbi_spec_is_0_1(void)130 static inline int sbi_spec_is_0_1(void)
131 {
132 return (sbi_spec_version == SBI_SPEC_VERSION_DEFAULT) ? 1 : 0;
133 }
134
135 /* Get the major version of SBI */
sbi_major_version(void)136 static inline unsigned long sbi_major_version(void)
137 {
138 return (sbi_spec_version >> SBI_SPEC_VERSION_MAJOR_SHIFT) &
139 SBI_SPEC_VERSION_MAJOR_MASK;
140 }
141
142 /* Get the minor version of SBI */
sbi_minor_version(void)143 static inline unsigned long sbi_minor_version(void)
144 {
145 return sbi_spec_version & SBI_SPEC_VERSION_MINOR_MASK;
146 }
147
148 int sbi_err_map_linux_errno(int err);
149 #else /* CONFIG_RISCV_SBI */
150 /* stubs for code that is only reachable under IS_ENABLED(CONFIG_RISCV_SBI): */
151 void sbi_set_timer(uint64_t stime_value);
152 void sbi_clear_ipi(void);
153 void sbi_send_ipi(const unsigned long *hart_mask);
154 void sbi_remote_fence_i(const unsigned long *hart_mask);
155 void sbi_init(void);
156 #endif /* CONFIG_RISCV_SBI */
157 #endif /* _ASM_RISCV_SBI_H */
158