forked from Mirrors/opensbi
3284bea833
Some of the upcoming SBI extensions (such as SSE) will directly update register state so improve the prototype of ecall handler to accommodate this. Further, this flexibility allows us to push the trap redirection from sbi_ecall_handler() to the sbi_ecall_legacy_handler(). Signed-off-by: Anup Patel <apatel@ventanamicro.com>
95 lines
2.7 KiB
C
95 lines
2.7 KiB
C
/*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*
|
|
* Copyright (c) 2019 Western Digital Corporation or its affiliates.
|
|
*
|
|
* Authors:
|
|
* Anup Patel <anup.patel@wdc.com>
|
|
*/
|
|
|
|
#ifndef __SBI_ECALL_H__
|
|
#define __SBI_ECALL_H__
|
|
|
|
#include <sbi/sbi_types.h>
|
|
#include <sbi/sbi_list.h>
|
|
|
|
#define SBI_ECALL_VERSION_MAJOR 2
|
|
#define SBI_ECALL_VERSION_MINOR 0
|
|
#define SBI_OPENSBI_IMPID 1
|
|
|
|
struct sbi_trap_regs;
|
|
struct sbi_trap_info;
|
|
|
|
struct sbi_ecall_return {
|
|
/* Return flag to skip register update */
|
|
bool skip_regs_update;
|
|
/* Return value */
|
|
unsigned long value;
|
|
};
|
|
|
|
struct sbi_ecall_extension {
|
|
/* head is used by the extension list */
|
|
struct sbi_dlist head;
|
|
/*
|
|
* extid_start and extid_end specify the range for this extension. As
|
|
* the initial range may be wider than the valid runtime range, the
|
|
* register_extensions callback is responsible for narrowing the range
|
|
* before other callbacks may be invoked.
|
|
*/
|
|
unsigned long extid_start;
|
|
unsigned long extid_end;
|
|
/*
|
|
* register_extensions
|
|
*
|
|
* Calls sbi_ecall_register_extension() one or more times to register
|
|
* extension ID range(s) which should be handled by this extension.
|
|
* More than one sbi_ecall_extension struct and
|
|
* sbi_ecall_register_extension() call is necessary when the supported
|
|
* extension ID ranges have gaps. Additionally, extension availability
|
|
* must be checked before registering, which means, when this callback
|
|
* returns, only valid extension IDs from the initial range, which are
|
|
* also available, have been registered.
|
|
*/
|
|
int (* register_extensions)(void);
|
|
/*
|
|
* probe
|
|
*
|
|
* Implements the Base extension's probe function for the extension. As
|
|
* the register_extensions callback ensures that no other extension
|
|
* callbacks will be invoked when the extension is not available, then
|
|
* probe can never fail. However, an extension may choose to set
|
|
* out_val to a nonzero value other than one. In those cases, it should
|
|
* implement this callback.
|
|
*/
|
|
int (* probe)(unsigned long extid, unsigned long *out_val);
|
|
/*
|
|
* handle
|
|
*
|
|
* This is the extension handler. register_extensions ensures it is
|
|
* never invoked with an invalid or unavailable extension ID.
|
|
*/
|
|
int (* handle)(unsigned long extid, unsigned long funcid,
|
|
struct sbi_trap_regs *regs,
|
|
struct sbi_ecall_return *out);
|
|
};
|
|
|
|
u16 sbi_ecall_version_major(void);
|
|
|
|
u16 sbi_ecall_version_minor(void);
|
|
|
|
unsigned long sbi_ecall_get_impid(void);
|
|
|
|
void sbi_ecall_set_impid(unsigned long impid);
|
|
|
|
struct sbi_ecall_extension *sbi_ecall_find_extension(unsigned long extid);
|
|
|
|
int sbi_ecall_register_extension(struct sbi_ecall_extension *ext);
|
|
|
|
void sbi_ecall_unregister_extension(struct sbi_ecall_extension *ext);
|
|
|
|
int sbi_ecall_handler(struct sbi_trap_regs *regs);
|
|
|
|
int sbi_ecall_init(void);
|
|
|
|
#endif
|