Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/luojia65/emu6

Multi-arch instruction set simulator that is 6666. Contributions welcomed!
https://github.com/luojia65/emu6

Last synced: 2 days ago
JSON representation

Multi-arch instruction set simulator that is 6666. Contributions welcomed!

Awesome Lists containing this project

README

        

# emu6

Very simple RISC-V emulator. Reads ELF file and execute in emulator.

## Usage

Basic usage with an interactive debug console:

```bash
emu6 -d
```

Currently the CPU configuration is generated from ELF files.

Use `emu6 --help` for further usage instructions.

## Features

The target of this project is to support emulating heterogeneous CPUs and several common SoC peripherals in all mainstream host operating systems.
For example on heterogeneous SoC, it's expected to support debugging one Cortex-M and one RISC-V core sharing same memory region running at the same time.

Software features:

- [x] Load one ELF file
- [ ] Interactive debug shell
- [ ] A friendly plugin system
- [ ] DTB support
- [ ] Support multiple ELF files
- [ ] RISC-V ISA support
- [ ] Thumb-2 ISA support
- [ ] GDB server
- [ ] Cache model

RISC-V instruction set and features:

- [x] RV32I
- [x] RV64I
- [ ] RV128I
- [ ] Extension M
- [ ] Extension A
- [ ] Extension F
- [ ] Extension D
- [x] Extension C
- [ ] Extension V
- [x] Zicsr
- [ ] Zifencei
- [ ] User mode
- [ ] Supervisor mode
- [ ] Sv32
- [ ] Sv39
- [ ] Sv48
- [ ] PLIC
- [ ] CLINT

## Build

This project is written in Rust. You need to [have Rust toolchain installed] before all the processes.

[have Rust toolchain installed](https://rustup.rs)

### Run from soruce

```
git clone https://github.com/luojia65/emu6
cd emu6
cargo run
```

## Contribution Q&A

### Write into plugins or into project itself

If the target feature is defined in the ISA's official manual, write into project
itself. If it's vendor defined, write as plugins.