embive 0.7.1

Embive is an interpreter/virtual-machine that leverages RISC-V bytecode, enabling sandboxed code execution on tiny devices (e.g. microcontrollers).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! Interpreter Error Module

use core::fmt::{Display, Formatter, Result};

/// Embive Interpreter Error
#[derive(Debug, PartialEq)]
pub enum Error {
    /// Memory address is out of bounds. The memory address is provided.
    InvalidMemoryAddress(u32),
    /// Memory access length is invalid. The length is provided.
    InvalidMemoryAccessLength(usize),
    /// Program counter is out of bounds. The program counter is provided.
    InvalidProgramCounter(u32),
    /// Instruction is invalid. The program counter is provided.
    InvalidInstruction(u32),
    /// Control and Status Register is invalid or not supported. The CSR address is provided.
    InvalidCSRegister(u16),
    /// CPU Register is out of bounds. The register index is provided.
    InvalidCPURegister(u8),
    /// Instruction is illegal. The program counter is provided.
    IllegalInstruction(u32),
    /// Interrupt not enabled by interpreted code (CSR `mie` bit [`crate::interpreter::EMBIVE_INTERRUPT_CODE`]).
    InterruptNotEnabled,
    /// No syscall function is set.
    NoSyscallFunction,
}

impl core::error::Error for Error {}

impl Display for Error {
    fn fmt(&self, f: &mut Formatter<'_>) -> Result {
        write!(f, "{self:?}")
    }
}