avr-vm

Crates.ioavr-vm
lib.rsavr-vm
version0.1.1
sourcesrc
created_at2017-02-22 20:08:31.742196
updated_at2018-10-28 11:57:51.4307
descriptionVM with JIT-compiler for ATMega32
homepagehttps://github.com/MackieLoeffel/avr-vm
repositoryhttps://github.com/MackieLoeffel/avr-vm
max_upload_size
id8638
size234,171
(MackieLoeffel)

documentation

README

AVR-VM

Build Status

This is a VM for the AVR ATmega32 microcontroller written in Rust. It can handle most of the instructions and has support for I/O, ADC, timer and button interrupts. It also features a JIT compiler, which compiles the AVR bytecode to x64 machinecode at runtime. It is quite fast, about 5x faster than the real microcontroller.

This VM was built as part of an university course, so it is not under current development. But if you want to use it and have a problem, feel free to open an issue or a PR.

Some test programs can be found in ./test. The VM is only tested to work with these programs. Only the instructions of these programs are currently implemented (which are quite a few, but not all).

It includes a GUI with some LEDs, buttons, two potentiometers and two seven segment digits. There are diffent testprograms, which use these peripherals. The wiring is roughly the one here (JTAG, ISP and USB is missing): Wiring. It can be changed by tweaking main.rs.

An example, how the GUI looks with the boardtest program running: boardtest

All characters, which are written to UDR by the microcontroller, are displayed in the console.

Installation

For using this VM you need to do the following steps:

  1. Clone this repository.

  2. If you want to use the GUI, you need to have at least gtk 3.4 installed.

  3. ONLY FOR JIT-COMPILATION: This project uses Dynasm-rs for the JIT-compiler, which is a compiler plugin and needs a nightly version of the Rust compiler. A working version can be installed using Rustup: rustup override set nightly-2018-10-09 Furthermore the JIT-Compiler needs to be enabled using the feature "jit", see below.

  4. For running the tests and compiling C-Code and assembler to AVR bytecode, gcc-avr is needed. It can be installed either from http://www.atmel.com/tools/ATMELAVRTOOLCHAINFORLINUX.aspx or on Ubuntu / Debian / BashOnWindows using sudo apt-get install gcc-avr binutils-avr avr-libc If you are using a different distribution, you can probably find an equivalent packages there.

Usage

You can execute the VM using the following command: cargo run --release -- ./test/boardtest/boardtest.bin

You can exucute a different binary by changing ./test/boardtest/boardtest.bin.

Without GUI

The GUI can be disabled using cargo run --release --no-default-features -- ./test/jump/jump.bin

Only the output on the console is visible then and the program stops on the first NOP. This is useful for benchmarking the compiler, see ./tests/jump/jump-time for an example program used for benchmarking.

Use the JIT compiler

The JIT-Compiler can be enabled with the following flags: cargo run --release --features jit -- ./test/jump/jump.bin

You need to make sure, that you are using a nightly version of the Rust compiler, if you want to use the JIT-compiler. For instructions, which version to use, see above.

Material

Commit count: 29

cargo fmt