root/sys/arch/riscv64/riscv64/sbi.c
/*      $OpenBSD: sbi.c,v 1.8 2024/03/29 22:11:34 kettenis Exp $        */

/*-
 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
 *
 * Copyright (c) 2019 Mitchell Horne <mhorne@FreeBSD.org>
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/types.h>

#include <machine/sbi.h>

#include <dev/cons.h>

extern void (*cpuresetfn)(void);
extern void (*powerdownfn)(void);

/* SBI Implementation-Specific Definitions */
#define OPENSBI_VERSION_MAJOR_OFFSET    16
#define OPENSBI_VERSION_MINOR_MASK      0xFFFF

u_long sbi_spec_version;
u_long sbi_impl_id;
u_long sbi_impl_version;

static struct sbi_ret
sbi_get_spec_version(void)
{
        return (SBI_CALL0(SBI_EXT_ID_BASE, SBI_BASE_GET_SPEC_VERSION));
}

static struct sbi_ret
sbi_get_impl_id(void)
{
        return (SBI_CALL0(SBI_EXT_ID_BASE, SBI_BASE_GET_IMPL_ID));
}

static struct sbi_ret
sbi_get_impl_version(void)
{
        return (SBI_CALL0(SBI_EXT_ID_BASE, SBI_BASE_GET_IMPL_VERSION));
}

void
sbi_print_version(void)
{
        u_int major;
        u_int minor;

        /* For legacy SBI implementations. */
        if (sbi_spec_version == 0) {
                printf("SBI: Unknown (Legacy) Implementation\n");
                printf("SBI Specification Version: 0.1\n");
                return;
        }

        switch (sbi_impl_id) {
        case (SBI_IMPL_ID_BBL):
                printf("SBI: Berkely Boot Loader %lu", sbi_impl_version);
                break;
        case (SBI_IMPL_ID_OPENSBI):
                major = sbi_impl_version >> OPENSBI_VERSION_MAJOR_OFFSET;
                minor = sbi_impl_version & OPENSBI_VERSION_MINOR_MASK;
                printf("SBI: OpenSBI v%u.%u", major, minor);
                break;
        default:
                printf("SBI: Unrecognized Implementation: %lu", sbi_impl_id);
                break;
        }

        major = (sbi_spec_version & SBI_SPEC_VERS_MAJOR_MASK) >>
            SBI_SPEC_VERS_MAJOR_OFFSET;
        minor = (sbi_spec_version & SBI_SPEC_VERS_MINOR_MASK);
        printf(", SBI Specification Version %u.%u\n", major, minor);
}

#ifdef MULTIPROCESSOR

int
sbi_hsm_hart_start(u_long hart, u_long start_addr, u_long priv)
{
        struct sbi_ret ret;

        ret = SBI_CALL3(SBI_EXT_ID_HSM, SBI_HSM_HART_START, hart, start_addr,
            priv);
        return (ret.error != 0 ? (int)ret.error : 0);
}

void
sbi_hsm_hart_stop(void)
{
        (void)SBI_CALL0(SBI_EXT_ID_HSM, SBI_HSM_HART_STOP);
}

int
sbi_hsm_hart_status(u_long hart)
{
        struct sbi_ret ret;

        ret = SBI_CALL1(SBI_EXT_ID_HSM, SBI_HSM_HART_STATUS, hart);

        return (ret.error != 0 ? (int)ret.error : (int)ret.value);
}

#endif

void
sbi_reset(void)
{
        SBI_CALL2(SBI_EXT_ID_SRST, SBI_SRST_RESET,
            SBI_SRST_RESET_WARM_REBOOT, 0);
}

void
sbi_powerdown(void)
{
        SBI_CALL2(SBI_EXT_ID_SRST, SBI_SRST_RESET,
            SBI_SRST_RESET_SHUTDOWN, 0);
}

void
sbi_init(void)
{
        struct sbi_ret sret;

        /*
         * Get the spec version. For legacy SBI implementations this will
         * return an error, otherwise it is guaranteed to succeed.
         */
        sret = sbi_get_spec_version();
        if (sret.error != 0) {
                /* We are running a legacy SBI implementation. */
                sbi_spec_version = 0;
                return;
        }

        /* Set the SBI implementation info. */
        sbi_spec_version = sret.value;
        sbi_impl_id = sbi_get_impl_id().value;
        sbi_impl_version = sbi_get_impl_version().value;

        /*
         * Probe for legacy extensions. Currently we rely on all of them
         * to be implemented, but this is not guaranteed by the spec.
         */
        KASSERTMSG(sbi_probe_extension(SBI_SET_TIMER) != 0,
            "SBI doesn't implement sbi_set_timer()");
        KASSERTMSG(sbi_probe_extension(SBI_CONSOLE_PUTCHAR) != 0,
            "SBI doesn't implement sbi_console_putchar()");
        KASSERTMSG(sbi_probe_extension(SBI_CONSOLE_GETCHAR) != 0,
            "SBI doesn't implement sbi_console_getchar()");
        KASSERTMSG(sbi_probe_extension(SBI_CLEAR_IPI) != 0,
            "SBI doesn't implement sbi_clear_ipi()");
        KASSERTMSG(sbi_probe_extension(SBI_SEND_IPI) != 0,
            "SBI doesn't implement sbi_send_ipi()");
        KASSERTMSG(sbi_probe_extension(SBI_REMOTE_FENCE_I) != 0,
            "SBI doesn't implement sbi_remote_fence_i()");
        KASSERTMSG(sbi_probe_extension(SBI_REMOTE_SFENCE_VMA) != 0,
            "SBI doesn't implement sbi_remote_sfence_vma()");
        KASSERTMSG(sbi_probe_extension(SBI_REMOTE_SFENCE_VMA_ASID) != 0,
            "SBI doesn't implement sbi_remote_sfence_vma_asid()");
        KASSERTMSG(sbi_probe_extension(SBI_SHUTDOWN) != 0,
            "SBI doesn't implement sbi_shutdown()");

        /*
         * Implement reboot and power down if the System Reset
         * Extension is implemented.
         */
        if (sbi_probe_extension(SBI_EXT_ID_SRST) != 0) {
                cpuresetfn = sbi_reset;
                powerdownfn = sbi_powerdown;
        }
}

/*
 * Early console implementation based on the Console Putchar and
 * Console Getchar legacy extensions.  These extensions are deprecated
 * but extremely useful for bringing up new boards.
 */

void
sbi_cnprobe(struct consdev *cd)
{
}

void
sbi_cninit(struct consdev *cd)
{
}

int
sbi_cngetc(dev_t dev)
{
        int c;

        for (;;) {
                c = sbi_console_getchar();
                if (c != -1)
                        return c;
        }
}

void
sbi_cnputc(dev_t dev, int c)
{
        sbi_console_putchar(c);
}

void
sbi_cnpollc(dev_t dev, int on)
{
}

struct consdev sbi_consdev = {
        .cn_probe = sbi_cnprobe,
        .cn_init = sbi_cninit,
        .cn_getc = sbi_cngetc,
        .cn_putc = sbi_cnputc,
        .cn_pollc = sbi_cnpollc,
};

struct consdev *cn_tab = &sbi_consdev;