| 1 |
2 |
zero_gravi |
// #################################################################################################
|
| 2 |
|
|
// # << NEORV32: neorv32_rte.h - NEORV32 Runtime Environment >> #
|
| 3 |
|
|
// # ********************************************************************************************* #
|
| 4 |
|
|
// # BSD 3-Clause License #
|
| 5 |
|
|
// # #
|
| 6 |
44 |
zero_gravi |
// # Copyright (c) 2021, Stephan Nolting. All rights reserved. #
|
| 7 |
2 |
zero_gravi |
// # #
|
| 8 |
|
|
// # Redistribution and use in source and binary forms, with or without modification, are #
|
| 9 |
|
|
// # permitted provided that the following conditions are met: #
|
| 10 |
|
|
// # #
|
| 11 |
|
|
// # 1. Redistributions of source code must retain the above copyright notice, this list of #
|
| 12 |
|
|
// # conditions and the following disclaimer. #
|
| 13 |
|
|
// # #
|
| 14 |
|
|
// # 2. Redistributions in binary form must reproduce the above copyright notice, this list of #
|
| 15 |
|
|
// # conditions and the following disclaimer in the documentation and/or other materials #
|
| 16 |
|
|
// # provided with the distribution. #
|
| 17 |
|
|
// # #
|
| 18 |
|
|
// # 3. Neither the name of the copyright holder nor the names of its contributors may be used to #
|
| 19 |
|
|
// # endorse or promote products derived from this software without specific prior written #
|
| 20 |
|
|
// # permission. #
|
| 21 |
|
|
// # #
|
| 22 |
|
|
// # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS #
|
| 23 |
|
|
// # OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF #
|
| 24 |
|
|
// # MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE #
|
| 25 |
|
|
// # COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, #
|
| 26 |
|
|
// # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE #
|
| 27 |
|
|
// # GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED #
|
| 28 |
|
|
// # AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING #
|
| 29 |
|
|
// # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED #
|
| 30 |
|
|
// # OF THE POSSIBILITY OF SUCH DAMAGE. #
|
| 31 |
|
|
// # ********************************************************************************************* #
|
| 32 |
|
|
// # The NEORV32 Processor - https://github.com/stnolting/neorv32 (c) Stephan Nolting #
|
| 33 |
|
|
// #################################################################################################
|
| 34 |
|
|
|
| 35 |
|
|
|
| 36 |
|
|
/**********************************************************************//**
|
| 37 |
|
|
* @file neorv32_rte.h
|
| 38 |
|
|
* @author Stephan Nolting
|
| 39 |
|
|
* @brief NEORV32 Runtime Environment.
|
| 40 |
|
|
**************************************************************************/
|
| 41 |
|
|
|
| 42 |
|
|
#ifndef neorv32_rte_h
|
| 43 |
|
|
#define neorv32_rte_h
|
| 44 |
|
|
|
| 45 |
14 |
zero_gravi |
/**********************************************************************//**
|
| 46 |
44 |
zero_gravi |
* NEORV32 runtime environment trap IDs.
|
| 47 |
14 |
zero_gravi |
**************************************************************************/
|
| 48 |
|
|
enum NEORV32_RTE_TRAP_enum {
|
| 49 |
|
|
RTE_TRAP_I_MISALIGNED = 0, /**< Instruction address misaligned */
|
| 50 |
|
|
RTE_TRAP_I_ACCESS = 1, /**< Instruction (bus) access fault */
|
| 51 |
|
|
RTE_TRAP_I_ILLEGAL = 2, /**< Illegal instruction */
|
| 52 |
|
|
RTE_TRAP_BREAKPOINT = 3, /**< Breakpoint (EBREAK instruction) */
|
| 53 |
|
|
RTE_TRAP_L_MISALIGNED = 4, /**< Load address misaligned */
|
| 54 |
|
|
RTE_TRAP_L_ACCESS = 5, /**< Load (bus) access fault */
|
| 55 |
|
|
RTE_TRAP_S_MISALIGNED = 6, /**< Store address misaligned */
|
| 56 |
|
|
RTE_TRAP_S_ACCESS = 7, /**< Store (bus) access fault */
|
| 57 |
40 |
zero_gravi |
RTE_TRAP_UENV_CALL = 8, /**< Environment call from user mode (ECALL instruction) */
|
| 58 |
|
|
RTE_TRAP_MENV_CALL = 9, /**< Environment call from machine mode (ECALL instruction) */
|
| 59 |
58 |
zero_gravi |
RTE_TRAP_NMI = 10, /**< Non-maskable interrupt */
|
| 60 |
|
|
RTE_TRAP_MSI = 11, /**< Machine software interrupt */
|
| 61 |
|
|
RTE_TRAP_MTI = 12, /**< Machine timer interrupt */
|
| 62 |
|
|
RTE_TRAP_MEI = 13, /**< Machine external interrupt */
|
| 63 |
|
|
RTE_TRAP_FIRQ_0 = 14, /**< Fast interrupt channel 0 */
|
| 64 |
|
|
RTE_TRAP_FIRQ_1 = 15, /**< Fast interrupt channel 1 */
|
| 65 |
|
|
RTE_TRAP_FIRQ_2 = 16, /**< Fast interrupt channel 2 */
|
| 66 |
|
|
RTE_TRAP_FIRQ_3 = 17, /**< Fast interrupt channel 3 */
|
| 67 |
|
|
RTE_TRAP_FIRQ_4 = 18, /**< Fast interrupt channel 4 */
|
| 68 |
|
|
RTE_TRAP_FIRQ_5 = 19, /**< Fast interrupt channel 5 */
|
| 69 |
|
|
RTE_TRAP_FIRQ_6 = 20, /**< Fast interrupt channel 6 */
|
| 70 |
|
|
RTE_TRAP_FIRQ_7 = 21, /**< Fast interrupt channel 7 */
|
| 71 |
|
|
RTE_TRAP_FIRQ_8 = 22, /**< Fast interrupt channel 8 */
|
| 72 |
|
|
RTE_TRAP_FIRQ_9 = 23, /**< Fast interrupt channel 9 */
|
| 73 |
|
|
RTE_TRAP_FIRQ_10 = 24, /**< Fast interrupt channel 10 */
|
| 74 |
|
|
RTE_TRAP_FIRQ_11 = 25, /**< Fast interrupt channel 11 */
|
| 75 |
|
|
RTE_TRAP_FIRQ_12 = 26, /**< Fast interrupt channel 12 */
|
| 76 |
|
|
RTE_TRAP_FIRQ_13 = 27, /**< Fast interrupt channel 13 */
|
| 77 |
|
|
RTE_TRAP_FIRQ_14 = 28, /**< Fast interrupt channel 14 */
|
| 78 |
|
|
RTE_TRAP_FIRQ_15 = 29 /**< Fast interrupt channel 15 */
|
| 79 |
14 |
zero_gravi |
};
|
| 80 |
|
|
|
| 81 |
48 |
zero_gravi |
|
| 82 |
|
|
/**********************************************************************//**
|
| 83 |
|
|
* NEORV32 runtime environment: Number of available traps.
|
| 84 |
|
|
**************************************************************************/
|
| 85 |
58 |
zero_gravi |
#define NEORV32_RTE_NUM_TRAPS 30
|
| 86 |
48 |
zero_gravi |
|
| 87 |
|
|
|
| 88 |
2 |
zero_gravi |
// prototypes
|
| 89 |
14 |
zero_gravi |
void neorv32_rte_setup(void);
|
| 90 |
|
|
int neorv32_rte_exception_install(uint8_t id, void (*handler)(void));
|
| 91 |
|
|
int neorv32_rte_exception_uninstall(uint8_t id);
|
| 92 |
11 |
zero_gravi |
|
| 93 |
6 |
zero_gravi |
void neorv32_rte_print_hw_config(void);
|
| 94 |
12 |
zero_gravi |
void neorv32_rte_print_hw_version(void);
|
| 95 |
11 |
zero_gravi |
void neorv32_rte_print_credits(void);
|
| 96 |
37 |
zero_gravi |
void neorv32_rte_print_logo(void);
|
| 97 |
22 |
zero_gravi |
void neorv32_rte_print_license(void);
|
| 98 |
2 |
zero_gravi |
|
| 99 |
44 |
zero_gravi |
uint32_t neorv32_rte_get_compiler_isa(void);
|
| 100 |
|
|
int neorv32_rte_check_isa(int silent);
|
| 101 |
|
|
|
| 102 |
2 |
zero_gravi |
#endif // neorv32_rte_h
|
