stk_arch_risc-v.h

Go to the documentation of this file.

/*
 * SuperTinyKernel(TM) RTOS: Lightweight High-Performance Deterministic C++ RTOS for Embedded Systems.
 *
 * Source: https://github.com/SuperTinyKernel-RTOS
 *
 * Copyright (c) 2022-2026 Neutron Code Limited <stk@neutroncode.com>. All Rights Reserved.
 * License: MIT License, see LICENSE for a full text.
 */
 
#ifndef STK_ARCH_RISC_V_H_
#define STK_ARCH_RISC_V_H_
 
#include "stk_common.h"

 
namespace stk {

class PlatformRiscV : public IPlatform
{
public:
    ~PlatformRiscV()
    {}

    class ISpecificEventHandler
    {
    public:
        virtual bool OnException(Word cause) = 0;
    };
 
    void Initialize(IEventHandler *event_handler, IKernelService *service, uint32_t resolution_us, Stack *exit_trap);
    void Start();
    void Stop();
    bool InitStack(EStackType stack_type, Stack *stack, IStackMemory *stack_memory, ITask *user_task);
    uint32_t GetTickResolution() const;
    void SwitchToNext();
    void Sleep(Timeout ticks);
    void SleepUntil(Ticks timestamp);
    IWaitObject *Wait(ISyncObject *sync_obj, IMutex *mutex, Timeout timeout);
    void ProcessTick();
    void ProcessHardFault();
    void SetEventOverrider(IEventOverrider *overrider);
    Word GetCallerSP() const;
    TId GetTid() const;
 
    void SetSpecificEventHandler(ISpecificEventHandler *handler);
};

typedef PlatformRiscV PlatformDefault;

__stk_forceinline Word GetTls()
{
    Word tp;
    __asm volatile("mv %0, tp" : "=r"(tp) : /* input: none */ : /* clobbers: none */);
    return tp;
}

__stk_forceinline void SetTls(Word tp)
{
    __asm volatile("mv tp, %0" : /* output: none */ : "r"(tp) : /* clobbers: none */);
}
 
// Notify stk_arch.h that we defined inline versions of GetTls/SetTls.
#define _STK_INLINE_TLS_DEFINED 1
 
} // namespace stk

#define __stk_dmb() __asm volatile("fence rw, rw" ::: "memory")

#ifndef STK_SUBMICORSECOND_PRECISION_TIMER
    #define STK_SUBMICORSECOND_PRECISION_TIMER 0
#endif

#ifndef STK_SYSTEM_CORE_CLOCK_VAR
    #define STK_SYSTEM_CORE_CLOCK_VAR SystemCoreClock
#endif

#ifndef STK_SYSTEM_CORE_CLOCK_FREQUENCY
    #define STK_SYSTEM_CORE_CLOCK_FREQUENCY 150000000U
#endif

extern "C" volatile uint32_t STK_SYSTEM_CORE_CLOCK_VAR;
 
#endif /* STK_ARCH_RISC_V_H_ */