sbi.h

Go to the documentation of this file.

/*
 * Copyright (c) 2026 Alexios Lyrakis <alexios.lyrakis@gmail.com>
 * Copyright (c) 2026 BeagleBoard.org Foundation
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef ZEPHYR_INCLUDE_ARCH_RISCV_SBI_H_
#define ZEPHYR_INCLUDE_ARCH_RISCV_SBI_H_
 
#ifndef _ASMLANGUAGE
#include <errno.h>
#endif /* _ASMLANGUAGE */

#define SBI_EXT_TIME                    0x54494D45

#define SBI_FUNC_SET_TIMER              0

#define SBI_EXT_SRST                    0x53525354

#define SBI_FUNC_SYSTEM_RESET           0

#define SBI_SRST_RESET_TYPE_SHUTDOWN    0
#define SBI_SRST_RESET_TYPE_COLD_REBOOT 1
#define SBI_SRST_RESET_TYPE_WARM_REBOOT 2

#define SBI_SRST_RESET_REASON_NONE      0

#define SBI_EXT_HSM 0x48534D

#define SBI_FUNC_HART_START 0
#define SBI_FUNC_HART_STOP  1

#define SBI_EXT_IPI 0x735049

#define SBI_FUNC_SEND_IPI 0

#define SBI_SUCCESS                     0
#define SBI_ERR_FAILED                  -1
#define SBI_ERR_NOT_SUPPORTED           -2
#define SBI_ERR_INVALID_PARAM           -3
#define SBI_ERR_DENIED                  -4
#define SBI_ERR_INVALID_ADDRESS         -5
#define SBI_ERR_ALREADY_AVAILABLE       -6
#define SBI_ERR_ALREADY_STARTED         -7
#define SBI_ERR_ALREADY_STOPPED         -8
#define SBI_ERR_NO_SHMEM                -9
#define SBI_ERR_INVALID_STATE           -10
#define SBI_ERR_BAD_RANGE               -11
#define SBI_ERR_TIMEOUT                 -12
#define SBI_ERR_IO                      -13
#define SBI_ERR_DENIED_LOCKED           -14
 
#ifndef _ASMLANGUAGE
static inline int sbi_err_to_errno(unsigned long err)
{
        switch ((long)err) {
        case SBI_SUCCESS:
                return 0;
        case SBI_ERR_FAILED:
                return -EIO;
        case SBI_ERR_INVALID_PARAM:
        case SBI_ERR_INVALID_STATE:
                return -EINVAL;
        case SBI_ERR_DENIED:
        case SBI_ERR_DENIED_LOCKED:
                return -EPERM;
        case SBI_ERR_INVALID_ADDRESS:
                return -EFAULT;
        case SBI_ERR_ALREADY_AVAILABLE:
        case SBI_ERR_ALREADY_STARTED:
        case SBI_ERR_ALREADY_STOPPED:
                return -EALREADY;
        case SBI_ERR_NO_SHMEM:
                return -ENOMEM;
        case SBI_ERR_BAD_RANGE:
                return -ERANGE;
        case SBI_ERR_TIMEOUT:
                return -ETIMEDOUT;
        case SBI_ERR_IO:
                return -EIO;
        case SBI_ERR_NOT_SUPPORTED:
        default:
                return -ENOTSUP;
        }
}
 
struct sbiret {
        long error;
        union {
                long value;
                unsigned long uvalue;
        };
};
 
static inline struct sbiret sbi_ecall(unsigned long arg0, unsigned long arg1, unsigned long arg2,
                                      unsigned long arg3, unsigned long arg4, unsigned long arg5,
                                      unsigned long fid, unsigned long ext)
{
        struct sbiret ret;
 
        register unsigned long a0 __asm__("a0") = (arg0);
        register unsigned long a1 __asm__("a1") = (arg1);
        register unsigned long a2 __asm__("a2") = (arg2);
        register unsigned long a3 __asm__("a3") = (arg3);
        register unsigned long a4 __asm__("a4") = (arg4);
        register unsigned long a5 __asm__("a5") = (arg5);
        register unsigned long a6 __asm__("a6") = (fid);
        register unsigned long a7 __asm__("a7") = (ext);
 
        __asm__ volatile("ecall"
                         : "+r"(a0), "+r"(a1)
                         : "r"(a2), "r"(a3), "r"(a4), "r"(a5), "r"(a6), "r"(a7)
                         : "memory");
 
        ret.error = a0;
        ret.value = a1;
 
        return ret;
}
#endif /* _ASMLANGUAGE */
 
#endif /* ZEPHYR_INCLUDE_ARCH_RISCV_SBI_H_ */