bsp.h

Go to the documentation of this file.

// Copyright (C) 2013-2026 Efinix Inc. All rights reserved.
//
#ifndef BSP_H
#define BSP_H

 
/* --- Board & Peripheral Drivers --- */
#include "boards/rv64_platform.h"
#include "clint/clint.h"
#include "uart/uart.h"
#include "debug.h"
#include "soc.h"
 
#ifdef __cplusplus
extern "C" {
#endif

 
/* ========================================================================== */
/* DEFAULT MAIN PERIPHERALS FOR SOC                                     */
/* ========================================================================== */
 //
    #define BSP_PLIC                    SYSTEM_PLIC_CTRL        
    #define BSP_PLIC_CPU_0              SYSTEM_PLIC_CPU_0_MEI   
    #define BSP_CLINT                   SYSTEM_CLINT_CTRL       
    #define BSP_CLINT_HZ                SYSTEM_CLINT_HZ         
    #define BSP_UART_BAUDRATE           115200                  
    #define BSP_UART_DATA_LEN           8                       
    #define ENABLE_SEMIHOSTING_PRINT    0                       
 
    #if (SYSTEM_UART_0_IO_CTRL || defined(__DOXYGEN__))
        /* Hardware UART is enabled in Efinix Sapphire Soc */
        extern uart_instance_t uart0;       
        #define BSP_UART_TERMINAL   SYSTEM_UART_0_IO_CTRL   
    #else
    // No Hardware UART present. Provide safe dummy macros. 
        #define BSP_UART_TERMINAL   0 
    #endif
 //


        void bsp_init();

        #define bsp_uDelay(usec)    clint_uDelay(usec, SYSTEM_CLINT_HZ)
 
        #if (SYSTEM_UART_0_IO_CTRL || defined(__DOXYGEN__))
            /* Hardware UART is enabled in Efinix Sapphire Soc */
            #define bsp_putChar(c)      uart_write(&uart0, c)
            #define bsp_getChar()       uart_read(&uart0) 
        #else
            /* No Hardware UART present. Provide safe dummy macros. */
            #define bsp_putChar(c)      ((void)0) 
            #define bsp_getChar()       (0) 
        #endif //
 
/* ========================================================================== */
/* Internal Module Inclusion Logic (SemiHosting)              */
/* ========================================================================== */
 
    #if (ENABLE_SEMIHOSTING_PRINT == 1)
        #include "semihosting.h"
    #endif
 
/* ========================================================================== */
/* TINY PRINTF CONFIG (USELIB == 0, NEWLIB=NOSTD)               */
/* ========================================================================== */
 
#if(USELIB == 0)
    static int bsp_printf(const char *format, ...);
     
    #define printf(...) (bsp_printf(__VA_ARGS__))
    
        #define ENABLE_BSP_PRINTF               1
        
        #define ENABLE_BSP_PRINTF_FULL          1
        
        #define ENABLE_BRIDGE_FULL_TO_LITE      1
        
        #define ENABLE_PRINTF_WARNING           1

        #define ENABLE_FLOATING_POINT_SUPPORT   0  
        #define ENABLE_FP_EXPONENTIAL_SUPPORT   0  
        #define ENABLE_PTRDIFF_SUPPORT          0  
        #define ENABLE_LONG_LONG_SUPPORT        1  
 
 
    /* ========================================================================== */
    /* Internal Module Inclusion Logic (SemiHosting)              */
    /* ========================================================================== */
    #if (ENABLE_BSP_PRINTF)
        #include "print.h"
    #endif
 
    #if (ENABLE_BSP_PRINTF_FULL)
        
        #if (!ENABLE_FLOATING_POINT_SUPPORT)
            #define PRINTF_DISABLE_SUPPORT_FLOAT 1
        #endif 
 
        #if (!ENABLE_FP_EXPONENTIAL_SUPPORT)
            #define PRINTF_DISABLE_SUPPORT_EXPONENTIAL 1
        #endif 
 
        #if (!ENABLE_PTRDIFF_SUPPORT)
            #define PRINTF_DISABLE_SUPPORT_PTRDIFF_T 1
        #endif 
 
        #if (!ENABLE_LONG_LONG_SUPPORT)
            #define PRINTF_DISABLE_SUPPORT_LONG_LONG 1
        #endif 
 
        #if (ENABLE_BRIDGE_FULL_TO_LITE)
            #if (!ENABLE_BSP_PRINTF)
                #define bsp_printf bsp_printf_full
            #endif 
        #endif 
 
        #include "print_full.h"
    #endif 
#endif // USELIB == 0
 //
#ifdef __cplusplus
}
#endif
 
#endif // BSP_H