terminus

KO | EN

gitlite — search

#javascript #react #golang #android #machine-learning #linux #windows #awesome #cli #awesome-list #pytorch #security #ios #open-source

(★ 66)

A riscv isa simulator in rust.

terminus Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# terminus
A RISC-V instruction set simulator in Rust.

## Rust Version Requirement
```
>= 1.56(edition2021)
```
2018 edition is move to 'eidtion2018' branch

## Boot Linux in 20s
![Boot Linux in 20s](https://raw.githubusercontent.com/shady831213/terminus/master/video/linux_boot.gif)

## Getting Started

```
  git clone https://github.com/shady831213/terminus
  cd terminus
  cargo update -p terminus-spaceport
  cargo update -p terminus-vault
  cargo install --path .
  terminus examples/linux/image/br-5-4
  //or
  cd examples/linux/image
  tar -zxvf rootfs.ext4.gz
  cd -
  terminus examples/linux/image/br-5-4.disk --image=examples/linux/image/rootfs.ext4
```

### Multi-core Support

Specify the `-p` option to configure the number of RISC-V HARTs (HARdware Threads):

```
  terminus examples/linux/image/br-5-4 -p 4
  //booting...
  //booting...
  //booting...
  //...
  buildroot login: root
  //password is terminus
  Password:
  # cat /proc/cpuinfo

processor	: 0
  hart		: 0
  mmu		: sv48

processor	: 1
  hart		: 1
  mmu		: sv48

processor	: 2
  hart		: 2
  mmu		: sv48

processor	: 3
  hart		: 3
  mmu		: sv48

```
### Networking Support

Run the `setup_tuntap.sh` script to create a simulated network interface and networking bridge.

```
  terminus examples/linux/image/br-5-4.disk --image=examples/linux/image/rootfs.ext4 --net=tap0
  //booting...
  //booting...
  //booting...
  //...
  buildroot login: root
  //password is terminus
  Password:
  //config guset according to help message.
  # ping -c 1 www.baidu.com
```
then you will see:
```
PING www.baidu.com (103.235.47.103): 56 data bytes
64 bytes from 103.235.47.103: seq=0 ttl=46 time=17.685 ms

--- www.baidu.com ping statistics ---
1 packets transmitted, 1 packets received, 0% packet loss
round-trip min/avg/max = 17.685/17.685/17.685 ms
```

### Display Support

Terminus with display supported needs the "sdl" operating system packages and related dependencies.

```
  // Example for  Ubuntu
  sudo apt-get install libsdl2-dev
  git clone https://github.com/shady831213/terminus
  cd terminus
  cargo update -p terminus-spaceport
  cargo install --features="sdl" --path .

cd examples/linux/image
  tar -zxvf rootfs.ext4.gz
  cd -
  terminus examples/linux/image/br-5-4.disk --image=examples/linux/image/rootfs.ext4 --boot_args="root=/dev/vda console=tty0 earlycon=sbi" --display
```

### Cosimulation with HDL
Please refer to [terminus_cosim](https://github.com/shady831213/terminus_cosim/tree/master/terminus_cluster).

## RoadMap
- [x] RV32/64I
- [x] MADFC
- [x] M/S/U privilege
- [x] Pass all riscv_tests
- [x] CLINT and Timer
- [x] HTIF console
- [x] FDT generation
- [x] Multi Cores
- [x] Boot Linux
- [x] Emu mode binary
- [x] Boot Linux(smp)
- [ ] Publish to crate.io
- [x] PLIC
- [x] VirtIO console
- [x] VirtIO disk
- [x] VirtIO network
- [x] framebuffer
- [x] VirtIO keyboard
- [x] VirtIO mouse
- [x] Cosimulation with HDL
- [ ] debug mode
- [ ] other extensions(b, v ...)

## GDB Debugging(implemented by [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent))

Terminus supports GDB remote debugging via the `--gdb-port` option (RV64, single-core only).

Start the simulator with a GDB port:

```
  terminus examples/linux/image/br-5-4 --gdb-port 1234
  // Waiting for GDB connection on port 1234...
```

Connect with GDB in another terminal:

```
  riscv64-unknown-elf-gdb
  (gdb) target remote localhost:1234
  (gdb) info registers
  (gdb) x/4i $pc
  (gdb) stepi
  (gdb) break *0x80000000
  (gdb) continue
```

**Requirements:**
- Single core only (`-p 1`, which is the default)
- RV64 only (`-l 64`, which is the default)
- Software breakpoints only (`break *<addr>`)

terminus

terminus Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

terminus

terminus Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README