1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
|
/** @file
Instance of the SBI ecall library.
It allows calling an SBI function via an ecall from S-Mode.
Copyright (c) 2021-2022, Hewlett Packard Development LP. All rights reserved.<BR>
SPDX-License-Identifier: BSD-2-Clause-Patent
**/
#include <Library/BaseLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/DebugLib.h>
#include <Library/BaseRiscVSbiLib.h>
//
// Maximum arguments for SBI ecall
#define SBI_CALL_MAX_ARGS 6
/**
Call SBI call using ecall instruction.
Asserts when NumArgs exceeds SBI_CALL_MAX_ARGS.
@param[in] ExtId SBI extension ID.
@param[in] FuncId SBI function ID.
@param[in] NumArgs Number of arguments to pass to the ecall.
@param[in] ... Argument list for the ecall.
@retval Returns SBI_RET structure with value and error code.
**/
STATIC
SBI_RET
EFIAPI
SbiCall (
IN UINTN ExtId,
IN UINTN FuncId,
IN UINTN NumArgs,
...
)
{
UINTN I;
SBI_RET Ret;
UINTN Args[SBI_CALL_MAX_ARGS];
VA_LIST ArgList;
VA_START (ArgList, NumArgs);
if (NumArgs > SBI_CALL_MAX_ARGS) {
Ret.Error = SBI_ERR_INVALID_PARAM;
Ret.Value = -1;
return Ret;
}
for (I = 0; I < SBI_CALL_MAX_ARGS; I++) {
if (I < NumArgs) {
Args[I] = VA_ARG (ArgList, UINTN);
} else {
// Default to 0 for all arguments that are not given
Args[I] = 0;
}
}
VA_END (ArgList);
// ECALL updates the a0 and a1 registers as return values.
RiscVSbiEcall (
&Args[0],
&Args[1],
Args[2],
Args[3],
Args[4],
Args[5],
(UINTN)(FuncId),
(UINTN)(ExtId)
);
Ret.Error = Args[0];
Ret.Value = Args[1];
return Ret;
}
/**
Translate SBI error code to EFI status.
@param[in] SbiError SBI error code
@retval EFI_STATUS
**/
STATIC
EFI_STATUS
EFIAPI
TranslateError (
IN UINTN SbiError
)
{
switch (SbiError) {
case SBI_SUCCESS:
return EFI_SUCCESS;
case SBI_ERR_FAILED:
return EFI_DEVICE_ERROR;
break;
case SBI_ERR_NOT_SUPPORTED:
return EFI_UNSUPPORTED;
break;
case SBI_ERR_INVALID_PARAM:
return EFI_INVALID_PARAMETER;
break;
case SBI_ERR_DENIED:
return EFI_ACCESS_DENIED;
break;
case SBI_ERR_INVALID_ADDRESS:
return EFI_LOAD_ERROR;
break;
case SBI_ERR_ALREADY_AVAILABLE:
return EFI_ALREADY_STARTED;
break;
default:
//
// Reaches here only if SBI has defined a new error type
//
ASSERT (FALSE);
return EFI_UNSUPPORTED;
break;
}
}
/**
Clear pending timer interrupt bit and set timer for next event after Time.
To clear the timer without scheduling a timer event, set Time to a
practically infinite value or mask the timer interrupt by clearing sie.STIE.
@param[in] Time The time offset to the next scheduled timer interrupt.
**/
VOID
EFIAPI
SbiSetTimer (
IN UINT64 Time
)
{
SbiCall (SBI_EXT_TIME, SBI_EXT_TIME_SET_TIMER, 1, Time);
}
/**
Reset the system using SRST SBI extenion
@param[in] ResetType The SRST System Reset Type.
@param[in] ResetReason The SRST System Reset Reason.
**/
EFI_STATUS
EFIAPI
SbiSystemReset (
IN UINTN ResetType,
IN UINTN ResetReason
)
{
SBI_RET Ret;
Ret = SbiCall (
SBI_EXT_SRST,
SBI_EXT_SRST_RESET,
2,
ResetType,
ResetReason
);
return TranslateError (Ret.Error);
}
/**
Get firmware context of the calling hart.
@param[out] FirmwareContext The firmware context pointer.
**/
VOID
EFIAPI
GetFirmwareContext (
OUT EFI_RISCV_FIRMWARE_CONTEXT **FirmwareContext
)
{
*FirmwareContext = (EFI_RISCV_FIRMWARE_CONTEXT *)RiscVGetSupervisorScratch ();
}
/**
Set firmware context of the calling hart.
@param[in] FirmwareContext The firmware context pointer.
**/
VOID
EFIAPI
SetFirmwareContext (
IN EFI_RISCV_FIRMWARE_CONTEXT *FirmwareContext
)
{
RiscVSetSupervisorScratch ((UINT64)FirmwareContext);
}
/**
Get pointer to OpenSBI Firmware Context
Get the pointer of firmware context through OpenSBI FW Extension SBI.
@param FirmwareContextPtr Pointer to retrieve pointer to the
Firmware Context.
**/
VOID
EFIAPI
GetFirmwareContextPointer (
IN OUT EFI_RISCV_FIRMWARE_CONTEXT **FirmwareContextPtr
)
{
GetFirmwareContext (FirmwareContextPtr);
}
/**
Set the pointer to OpenSBI Firmware Context
Set the pointer of firmware context through OpenSBI FW Extension SBI.
@param FirmwareContextPtr Pointer to Firmware Context.
**/
VOID
EFIAPI
SetFirmwareContextPointer (
IN EFI_RISCV_FIRMWARE_CONTEXT *FirmwareContextPtr
)
{
SetFirmwareContext (FirmwareContextPtr);
}
|
