Create a new motherboard with a set of components

Create zero-initialied registers

Create a new CPU using an existing mapped memory (must be the same one the motherboard this CPU will be connected to uses).

Create a new mapped memory using an hardware bridge

Create a number display. The handler can is supposed to display the provided number, but this is not required. The parameters are the number to displa

Create a buffered display component. The provided capacity must be a multiple of 4, and 4 bytes will be substracted for handling the action code. This

Create a character display component.

Create a new RAM component Returns an error message if the capacity is 0, not a multiple or 4 bytes or too large for the running CPU architecture.

Create a new flash memory component Returns an error message if the capacity is 0, not a multiple or 4 bytes or too large for the running CPU architec

Create a new BootROM component Returns an error message if the capacity is too large for the running CPU architecture.

Create a new Basic Debug Interface (BDI). The debugger is a function that takes an information to debug, see [`DebugInfo`] for more details.

Create a synchronous character keyboard component.

Create a synchronous keyboard component. The provided capacity must be a multiple of 4, and 4 bytes will be substracted for handling the action code.

Create an empty program

Get the default division mode: - Perform unsigned division - Forbid division by zero (results in exception) - Forbid overflowing division (results in

Create a default runner configuration. Prints exceptions and the cycle and instruction address when the VM halts.

Create a number display which print! the numbers

Create a print!-based buffered display component, converting invalid UTF-8 strings to lossy ones

Create a println!-based character display component, tolerating invalid UTF-8 characters ('�' displayed instead)

Create a new Basic Debug Interface (BDI) with a println!-backed debugger

(Internal) open the provided path file in read-only or writable mode

Prepend an instruction at the beginning of the program

Prepend a set of instructions at the beginning of the program

Prettify an exception with mode

Prettify a stop state

Create a quiet runner configuration. Displays nothing.

Send a READ signal to a component. If the `ex` reference contains a non-zero value when this function returns, the component raised an exception with

Create a new read-only persistent memory component

Create a new writable persistent memory component with a custom size

Emulate a hard reset button on the motherboard. All components will receive a reset signal through their [`Bus`] interface. The CPU will also be reset

Send a RESET signal to a component

Reset all registers

Get the sign mode

Get the RAM's size

Get the flash memory's size

Get the BootROM's size

Get the number of words in the program

Encode the program to folded bytes (list of 4-bytes slices)

Convert the extended instruction to a LASM source code

Convert the hardware information code to its LASM representation

Convert the condition to its LASM representation

Convert the flag to its LASM representation

Convert the register to a register-or-1-byte-literal parameter

Convert the register to a register-or-2-bytes-literal parameter

Convert the mode to a register-or-literal value

Create a verbose runner configuration. Prints a message on each CPU cycle, as well as exceptions and the cycle number and instruction address when the

Set if the VM should be stopped after a given number of CPU cycles.

Set if the runner should print a newline when the VM halts.

Set the overflow mode

Set if the runner should display a message on each CPU cycle. Only for debugging purpose, as LRVM usually runs several hundred thousand cycles per sec

Set if the runner should display a warning when an exception occurrs.

Set the sign mode

Create a new BootROM component larger than its storage Returns an error message in case of fail

Set the zero mode

Create a new writable persistent memory component

Create a new writable persistent memory component with a custom size

Write an address inside the component This is not allowed inside our component, which is read-only

Send a WRITE signal to a component. If the `ex` reference contains a non-zero value when this function returns, the component raised an exception with