c/JuiceVm
1
0
Fork 0
mirror of https://github.com/juiceRv/JuiceVm synced 2025-03-28 19:33:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1 from donny681/master

Browse Source 
Add english document
This commit is contained in:
juiceRv 2021-05-31 18:26:34 +08:00 committed by GitHub
commit 41ef4586b1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 811 additions and 264 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

538
README.md
View File

@ -1,265 +1,275 @@
![JUICE VM](./doc/assert/logo.png)
* [简介](#简介)
* [Juice Vm的特点](#juice-vm的特点)
* [Juice Vm的组成](#juice-vm的组成)
* [Juice Vm 代码统计](#Juice-Vm-代码统计)
* [Juice Vm的地址空间分布](#juice-vm的地址空间分布)
* [Juice Vm下的软件移植进度](#juice-vm下的软件移植进度)
* [快速安装](#快速安装)
* [<strong>快速上手</strong>](#快速上手)
* [运行freertos 截图](#运行freertos-截图)
* [运行rt-thread 截图](#运行rt-thread-截图)
* [运行linx 5.0.0 截图](#运行linx-500-截图)
* [<strong>软件参数使用说明</strong>](#软件参数使用说明)
* [社区支持](#社区支持)
* [<strong>CHANGE LOG</strong>](#change-log)
* [<strong>2021-05-25</strong>](#2021-05-25)
* [<strong>20210524进展公布，发布包发布juice_vm_release_for_Linux_c21682d3.zip：</strong>](#20210524进展公布发 布包发布juice_vm_release_for_linux_c21682d3zip)
* [<strong>20210508更新：</strong>](#20210508更新)
* [<strong>20210427更新：</strong>](#20210427更新)
* [<strong>20210424更新:</strong>](#20210424更新)
* [<strong>软件适配进度</strong>](#软件适配进度)
* [<strong>更新了支持的参数：</strong>](#更新了支持的参数)
* [<strong>202210306更新:</strong>](#202210306更新)
* [<strong>软件适配进度</strong>](#软件适配进度-1)
* [<strong>更新了支持的参数：</strong>](#更新了支持的参数-1)
* [<strong>提交日志</strong>](#提交日志)
* [以下 2021-03-06 更新:](#以下-2021-03-06-更新)
* [<strong>更新了支持的参数：</strong>](#更新了支持的参数-2)
* [<strong>软件适配进度</strong>](#软件适配进度-2)
* [鸣谢](#鸣谢)
* [联系作者](#联系作者)
## 简介
juice vm诞生于2020年，以实现可运行最新kernel主线的RISC-V最小虚拟机为目标而诞生的，设计之初秉承着可以在 **RAM** 只有 **百KB** 级别的平台上运行，不引入除了**c99**标准外的第三方依赖。
juice vm按照gcc所支持的C99标准编写，无第三方库依赖，浅显易懂，且具有方便移植的特性（可快速移植到多种主流 MCU 及支持c环境的所有平台上）。
juice vm去掉注释后展开所有的宏的代码行数仅**12523**行，仅**36104**字，足够的小巧。
## Juice Vm的特点
- 资源占用极低。
- 跨平台、可快速移植。
## Juice Vm的组成
- 指令集：RV64IMASU.
- 支持了M-mode,U-mode,S-mode下的mtime.
- 超级精简的uart，只有读和写两个外设寄存器.
- 超级精简的MMU SV39支持.
- 支持RISC-V官方标准的异常和中断托管
## Juice Vm 代码统计
![JUICE VM](./doc/assert/juicevm_size.png)
## Juice Vm的地址空间分布
| 虚拟机版本号 | 起始地址 | 大小(字节) | 寄存器名称 | 说明 | 所用宏名称 |
| :-----------: | :-------- | :------- | :------- | :------------| :------------ |
| c21682d3 | 0x80000000 | 0x12C00000 | SRAM | 内部存储 | RV_CPU_SIM_RAM_START_ADDR RV_CPU_SIM_RAM_SIZE |
| c21682d3 | 0x92C00000 | 0x1 | UART_WRITE | uart发送寄存器 | pdev_uart0_write_addr |
| c21682d3 | 0x92C00001 | 0x1 | UART_READ | uart接收寄存器 | pdev_uart0_read_addr |
| c21682d3 | 0x92C00002 | 0x1 | UART_STATE | uart状态寄存器 | pdev_uart0_state_addr pdev_uart0_free_state pdev_uart0_readbusy_state |
| c21682d3 | 0x92C00003 | 0x8 | mtime | mtime当前计数寄存器 | pdev_mtime_mtime_addr |
| c21682d3 | 0x92c00007 | 0x8 | mtimecmp | mtime当前比较寄存器 | pdev_mtime_mtimecmp_addr |
## Juice Vm下的软件移植进度
- 已经支持了c语言编程。
- 已完成freertos移植。
- 已完成mbedtls移植。
- 已完成mmu sv39测试。
- 已完成mtime测试。
- 已完成opensbi移植 [传送门](https://github.com/juiceRv/opensbi_juicevm_port)。
- 已完成rt-thread移植，感谢@熊大和@Andy Chen的支持 [传送门](https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm)。
- 已完成kernel主线5.0.0 [传送门](https://github.com/juiceRv/kernel_juicevm_port)。
- 上传Juice Vm下的GCC toolchain [传送门](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)。
- 适配 GDB 通用接口支持 **TODO**。
- 适配 RT-SMART **TODO**。
## 快速安装
- **UBUNTU/DEBIAN** APT安装
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O - http://xiaohui.mongoyun.com:3333/key/deb.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install juicevm
juicevm
```
- **CENTOS**
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O juice_vm_release_for_Linux_laster.zip https://github.com/juiceRv/JuiceVm/raw/master/juice_vm_release_for_Linux_laster.zip
unzip juice_vm_release_for_Linux_laster.zip
cd juice_vm_release_for_Linux_c21682d3/juice_vm_release_for_Linux
sudo chmod +x juice_vm_for_Linux.out
./juice_vm_for_Linux.out
```
- **WINDOW**
**编译中**
## **快速上手**
- [快速上手运行Hello world](./doc/get-started.md) **编写中**。
- [运行Free rtos](./doc/run-freertos.md) **编写中**。
- [运行mbedtls](./doc/run-mbedtls.md) **编写中**。
- [运行SV39 MMU测试](./doc/run-mmu_sv39.md) **编写中**。
- [运行mtime测试](./doc/run-mmu_sv39.md) **编写中**。
- [运行mtime测试](./doc/run-mtime.md) **编写中**。
- [运行 RT-thread](./doc/run-rtt.md) **编写中**。
- [运行 linux kernel](./doc/run-linux.md) **编写中**。
## 运行freertos 截图
![JUICE VM FreeRtos](./doc/assert/freertos.png)
## 运行rt-thread 截图
![JUICE VM RT-thread](./doc/assert/juicevm_rtt.jpg)
## 运行linx 5.0.0 截图
![JUICE VM linux kernel](./doc/assert/juicevm_kernel.png)
## **软件参数使用说明**
| 参数 | 参数名称 | 说明 |
| :------ | :------- | :-------|
| t | enable test mode | 进入固件测试模式<br>当出现下面的状态会结束运行并且打印出通过还是失败的字样,x3_gp寄存器的值为1 和 x17_a7寄存器的值为93时,进入了ecall异常就会触发。x10_a0 寄存器的值为 0时打印pass字样，否则打印fail字样 |
| **T** | enable trap debug mode | 使能异常调试模式，出现异常时会打印当前异常的调试信息 |
| d | enable debug mode | 打开虚拟机内所有的调试选项，输出最详细的调试信息，包括指令译码，处理执行，当前寄存器列表，csr列表等 |
| c | print cst operation msg | 打开虚拟机的csr寄存器读写调试信息。读写csr寄存器的时候都会打印对应的csr寄存器的值 |
| a | diable all debug msg | 关闭所有调试选项，译码调试默认打开 |
| x | enable test mode for exception | 打开异常测试模式，当出现异常时结束运行 |
| g | enable better readability printing | 使用可读性更好的方式打印信息 |
| e | disable all error msg | 关闭所有的错误信息打印 |
| i | enable all instr debug msg | 打开所有指令调试信息打印 |
| m | enable mmu debug msg | 打开mmu的遍历调试信息 |
| p | print mmu page 8 byte data | hexdump打印mmu页表里的8字节数据 |
| **P** | print mmu page 4K Byte data | hexdump打印mmu页表里的4K字节数据 |
| s | uart addr not use mmu translation | 启用mmu翻译时，忽略uart的外设地址，在启用了mmu的时候也可以直接通过uart原始物理地址来操作uart外设 |
| **S** | switch mode debug info | 打开切换mode时的调试信息，m-mode,s-mode和u-mode切换的时候都会打印调试信息 |
| **M** | disable mmu err msg | 关闭mmu缺页异常，访问异常，加载异常的错误信息 |
| r | enable trap debug msg | 打印更详细的进入中断的调试信息 |
| **A** | enable addr translation debug print | 打印地址转换的调试打印 |
| **L**(n) | log mode | output_mode_sel n = 0 -> stdout<br> 1 -> log_buf UNIX SYS ONLY(buf_size:(2900))<br> 2 -> none<br> 选择虚拟机输出的方式，1，直接标准输出。2，使用一个buf先缓存，退出的时候再输出bug大小2900Byte。3，不输出。<br> |
| l | enable endless loop check (RV_ENDLESS_LOOP_CHECK_EXIT_CNT:(3)) | 启用死循环监测机制，当有连续3次出现同样的指令执行流程(包括寄存器和csr寄存器的值都没有改变),结束虚拟机的运行。可以搭配-L参数使用，方便调试固件。一般assert都是直接死循环。|
# 社区支持
挖坑网首发 感谢晕哥一路的支持：[https://whycan.com/t_5844.html](https://whycan.com/t_5844.html)
## **CHANGE LOG**
### **2021-05-25**
- opensbi和kernel的代码已发布到github！！！
[https://github.com/juiceRv/kernel_juicevm_port](https://github.com/juiceRv/kernel_juicevm_port)
kernel的配置文件在arch/riscv/configs/juicevm_defconfig,make ARCH=riscv juicevm_defconfig
- 需要修改下arch/riscv/configs/juicevm_defconfig里的CONFIG_INITRAMFS_SOURCE="/mnt/ssd_prj/risc-v_sim/sim/test/opensbi/opensbi-master/rootfs"
修改为opensbi里的路径
opensbi仓库
[https://github.com/juiceRv/opensbi_juicevm_port](https://github.com/juiceRv/opensbi_juicevm_port)
toolchains
[https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)
***
### **20210524进展公布，发布包发布juice_vm_release_for_Linux_c21682d3.zip：**
1. 修复了mtime在m-mode,s-mode和u-mode下的中断处理漏洞。
2. 修复了ecall在s-mode下的漏洞。
3. 修复了在s-mode和u-mode下进入异常模式，更新csr寄存器的漏洞。
4. 移植了linux。
**juice_vm成功运行kernel主线5.0.0。**
**juice_vm成功运行kernel主线5.0.0。**
**juice_vm成功运行kernel主线5.0.0。**
***
### **20210508更新：**
1. 上传一个ubuntu20.04上可以正常运行的发布包,感谢@XBOOT大佬的反馈。
2. 添加了div指令支持。
3. 修复了divuw，divw，remu，remw，amomin.w，amoswap.w的指令错误。
***
### **20210427更新：**
提交了RT-Thread 的适配 到官方仓库：详情请点击https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm
***
### **20210424更新:**
#### **软件适配进度**
1.已完成rt-thread移植。
#### **更新了支持的参数：**
1. 新增-L参数用于指定打印日志方式。
2. 新增-l参数用于在出现死循环的时候结束运行。
3. 新增-r参数用于开启trap调试打印
4. 更新了Alive logo。
5. 新增-T参数用于执行过程输出反汇编调试打印。
6. 新增m模块支持。
7. 新增s-mode支持(u-mode支持中）。
***
### **202210306更新:**
#### **软件适配进度**
1. 已经支持了c语言编程。
2. 已完成freertos移植。
3. 已完成mebedtls移植。
4. 已完成mmu sv39测试。
5. 已完成mtimer测试。
6. 已完成opensbi移植。
#### **更新了支持的参数：**
- -m **参数用于开启mmu调试信息**
#### **提交日志**
- 1113e998 add sfence.vma instr
- f118d476 add print instr support
- 1e3e7204 add AMOSWAP.D LR.D and SC.D instr support
- 686741ea add AMOSWAP.D LR.D and SC.D instr support
- f2f699c0 add -i arg to enable instr print support
- 113f66da add misa csr support
- 19cf60d1 fix divu err
- ad512e54 add divu remw and remu instr
- 9abc0566 fix mem overflow
- 0ceb663e fix divw instr and add REMW instr
- 10a2ea78 fix divw instr
- 9c93c4ce add amoswap.w , mul and divw instr
- df10ad45 change the fireware start addr to 0x80000000
- d31b4ac1 add amoadd.w inst
***
### 以下 2021-03-06 更新:
无第三方库不到5000行C语言实现一个risc-v虚拟机，带mmu
基于指令集 rv64i
实现了mtime，超级精简的uart和mmu sv39.
#### **更新了支持的参数：**
- -a **关闭所有调试打印**
- -e **关闭错误打印**
- -g **用更好的方式来显示打印**
- -d **开启所有调试打印(包括寄存器和csr列表)**
- -i **开启指令解码调试信息**
- -m **开启mmu调试信息**
#### **软件适配进度**
1. 已经支持了c语言编程。
2. 已完成freertos移植。
3. 已完成mebedtls移植。
4. 已完成mmu sv39测试。
5. 已完成mtimer测试。
6. 已完成opensbi移植。
# 鸣谢
- [哇酷网](https://whycan.com/t_5844.html)
- [RT-thread](https://www.rt-thread.io/)
- [RISC-V](https://riscv.org/)
- [linux](https://www.kernel.org/)
- [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)
# 联系作者
[中文](./doc/assert/README_zh.md)
![JUICE VM](./doc/assert/logo.png)
* [Introduction](#introduction)
* [The Advantage of Juice Vm](#the-advantage-of-juice-vm)
* [The feature of Juice Vm](#the-feature-of--juice-vm)
* [Juice Vm's statistics](#juice-vms-statistics)
* [Juice Vm's address](#juice-vms-address)
* [The software process of Project](#the-software-process-of-project)
* [Get started](#get-started)
* [<strong>Example</strong>](#example)
* [The Shot of freertos](#the-shot-of-freertos)
* [The Shot of rt-thread](#the-shot-of-rt-thread)
* [The Shot of linx 5.0.0](#the-shot-of-linx-500)
* [<strong>Parameters Specification</strong>](#parameters-specification)
* [Community support](#community-support)
* [<strong>CHANGE LOG</strong>](#change-log)
* [<strong>2021-05-25</strong>](#2021-05-25)
* [<strong>20210524 juice_vm_release_for_Linux_c21682d3.zip：</strong>](#20210524-juice_vm_release_for_linux_c21682d3zip)
* [<strong>20210508：</strong>](#20210508)
* [<strong>20210427：</strong>](#20210427)
* [<strong>2021042:</strong>](#2021042)
* [<strong>software specification</strong>](#software-specification)
* [<strong>Update parameters：</strong>](#update-parameters)
* [<strong>202210306:</strong>](#202210306)
* [<strong>software specification</strong>](#software-specification-1)
* [<strong>Update parameters:</strong>](#update-parameters-1)
* [<strong>Issue</strong>](#issue)
* [2021-03-06 :](#2021-03-06-)
* [<strong>Update Parameters:</strong>](#update-parameters-2)
* [<em>Software Specification</em>*](#software-specification-2)
* [Thanks](#thanks)
* [Contact us](#contact-us)
## Introduction
The project began in 2020.Juice Vm is a small RISC-V virtual machine and run the latest kernel.The chip which contain hundreds of KB RAM can run this virtual machine,but it wouldn't contain any third-party libraries.
Juice Vm follow gcc C99 stardard,without any third-party library.Therefore,it is really easy to read and it support many platforms.
There is only **12523** lines and **36104** words in the project without any annotation .Therefore it is really small.
## The Advantage of Juice Vm
- Consume little memory
- Support some platforms easily.
## The feature of Juice Vm
- ISA(Instruction Set Architecture)：RV64IMASU.
- Suport mtime in M-mode,U-mode,S-mode
- Super small uart,only contain two Register:read and write
- Super samll MMU(support SV39)
- Support exception and interruption with official RISC-V stardard
## Juice Vm's statistics
![JUICE VM](./doc/assert/juicevm_size.png)
## Juice Vm's address
| Version | Start Address | Size(Byte) | Register | Statement | Macro definition |
| :-----------: | :-------- | :------- | :------- | :------------| :------------ |
| c21682d3 | 0x80000000 | 0x12C00000 | SRAM | internal storage | RV_CPU_SIM_RAM_START_ADDR RV_CPU_SIM_RAM_SIZE |
| c21682d3 | 0x92C00000 | 0x1 | UART_WRITE | uart send register | pdev_uart0_write_addr |
| c21682d3 | 0x92C00001 | 0x1 | UART_READ | uart recv register | pdev_uart0_read_addr |
| c21682d3 | 0x92C00002 | 0x1 | UART_STATE | uart state register | pdev_uart0_state_addr pdev_uart0_free_state pdev_uart0_readbusy_state |
| c21682d3 | 0x92C00003 | 0x8 | mtime | current count register | pdev_mtime_mtime_addr |
| c21682d3 | 0x92c00007 | 0x8 | mtimecmp | compare register | pdev_mtime_mtimecmp_addr |
## The software process of Project
- Support the C program
- Support freertos
- Support mbedtls
- Pass mmu sv39 test
- Pass mtime test
- Support opensbi [Link](https://github.com/juiceRv/opensbi_juicevm_port)
- Support rt-thread ,Thanks for @熊大和@Andy Chen [Link](https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm)
- Support kernel 5.0.0 [Link](https://github.com/juiceRv/kernel_juicevm_port)
- Upload GCC toolchain [Link](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)
- Support GDB **TODO**
- SUpport RT-SMART **TODO**
-
## Get started
- **UBUNTU/DEBIAN** APT install
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O - http://xiaohui.mongoyun.com:3333/key/deb.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install juicevm
juicevm
```
- **CENTOS**
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O juice_vm_release_for_Linux_laster.zip https://github.com/juiceRv/JuiceVm/raw/master/juice_vm_release_for_Linux_laster.zip
unzip juice_vm_release_for_Linux_laster.zip
cd juice_vm_release_for_Linux_c21682d3/juice_vm_release_for_Linux
sudo chmod +x juice_vm_for_Linux.out
./juice_vm_for_Linux.out
```
- **WINDOW**
**Compile**
## **Example**
- [Hello world](./doc/get-started.md) **todo**
- [Free rtos](./doc/run-freertos.md) **todo**
- [mbedtls](./doc/run-mbedtls.md) **todo**
- [SV39 MMU test](./doc/run-mmu_sv39.md) **todo**
- [mtime test](./doc/run-mmu_sv39.md) *todo**
- [mtime test](./doc/run-mtime.md) **todo**
- [RT-thread](./doc/run-rtt.md) **todo**
- [linux kernel](./doc/run-linux.md) **todo**
## The Shot of freertos
![JUICE VM FreeRtos](./doc/assert/freertos.png)
## The Shot of rt-thread
![JUICE VM RT-thread](./doc/assert/juicevm_rtt.jpg)
## The Shot of linx 5.0.0
![JUICE VM linux kernel](./doc/assert/juicevm_kernel.png)
## **Parameters Specification**
| Parm | Name | statement |
| :------ | :------- | :-------|
| t | enable test mode | Enter test mode<br>When appearing the following statement,the machine would end up,x3_gp register's value is **1** and x17_a7 register's vaule is 93时,it cause ecall exception。when x10_a0 register's value is 0 ,it print pass，otherwise it print "faile" |
| **T** | enable trap debug mode | enable exception mode and it will print current exception information |
| d | enable debug mode | Open all debug option in vitural machine and print debug ,include ISA,running process,register list ,csr list and etc. |
| c | print cst operation msg | enable debug csr register(read and write register) and print all the register values. |
| a | diable all debug msg | Disable all debug message |
| x | enable test mode for exception | It caused by exception |
| g | enable better readability printing | None |
| e | disable all error msg | None |
| i | enable all instr debug msg | None |
| m | enable mmu debug msg | None |
| p | print mmu page 8 byte data | None |
| **P** | print mmu page 4K Byte data | None |
| s | uart addr not use mmu translation | Enalbe mmu translation,and ignore uart address.Control the uart by read and write uart physical address when enble mmu |
| **S** | switch mode debug info | enable debug when switching the mode.It print debug information in m-mode,s-mode and u-mode |
| **M** | disable mmu err msg | Disable debug about Page missing,exception |
| r | enable trap debug msg | Print more detailed debug about interruption |
| **A** | enable addr translation debug print | None |
| **L**(n) | log mode | output_mode_sel n = 0 -> stdout<br> 1 -> log_buf UNIX SYS ONLY(buf_size:(2900))<br> 2 -> none<br> Choose output mode，1，stardard ouput. 2，Store in a buffer when the code is running.Ouput 2900Byte buffer when the code exit. 3，No ouput。<br> |
| l | enable endless loop check (RV_ENDLESS_LOOP_CHECK_EXIT_CNT:(3)) | Enable loop watcher,when it run the same introduction three times continuously(include registers and csr register value wouldn't change),end the vm.You can run the vm with -L in order to debug the fireware.It would be bad loop when show assert |
# Community support
Thanks for whycan ：[https://whycan.com/t_5844.html](https://whycan.com/t_5844.html)
## **CHANGE LOG**
### **2021-05-25**
- The codes of opensbi and kernel are published in github
[https://github.com/juiceRv/kernel_juicevm_port](https://github.com/juiceRv/kernel_juicevm_port)
kernel configuration :arch/riscv/configs/juicevm_defconfig,make ARCH=riscv juicevm_defconfig
- Please open file (arch/riscv/configs/juicevm_defconfig) and modify **CONFIG_INITRAMFS_SOURCE** (the real opensbi path )
opensbi
[https://github.com/juiceRv/opensbi_juicevm_port](https://github.com/juiceRv/opensbi_juicevm_port)
toolchains
[https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)
***
### **20210524 juice_vm_release_for_Linux_c21682d3.zip：**
1. fix mtime interruption bug in m-mode,s-mode and u-mode
2. fix ecall bug in s-mode
3. fix issue about interruption in s-mode and u-mode,fix the csr register.
4. support linux(5.0.0)
***
### **20210508：**
1. release the package in ubuntu20.04,thanks for @XBOOT
1. support div introduction set
3. fix divuw，divw，remu，remw，amomin.w，amoswap.w introduction error
***
### **20210427：**
Support RT-Thread OS ,please refer: https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm
***
### **2021042:**
#### **software specification**
1.Support rt-thread
#### **Update parameters：**
1. -L:Support different output mode with
2. -l:End the code when the machine enter bad loop
3. -r:enalbe trace debug
4. Add Alive logo
5. -T: Print compilation information when the code is running
6. support m-mode
7. support s-mode(u-mode **todo**)
***
### **202210306:**
#### **software specification**
1. Support c program
2. Supoort freertos
3. Support mbedtls
4. Support mmu sv39 test
5. Support mtimer test
6. Support opensbi
#### **Update parameters:**
- -m **enable mmu debug**
#### **Issue**
- 1113e998 add sfence.vma instr
- f118d476 add print instr support
- 1e3e7204 add AMOSWAP.D LR.D and SC.D instr support
- 686741ea add AMOSWAP.D LR.D and SC.D instr support
- f2f699c0 add -i arg to enable instr print support
- 113f66da add misa csr support
- 19cf60d1 fix divu err
- ad512e54 add divu remw and remu instr
- 9abc0566 fix mem overflow
- 0ceb663e fix divw instr and add REMW instr
- 10a2ea78 fix divw instr
- 9c93c4ce add amoswap.w , mul and divw instr
- df10ad45 change the fireware start addr to 0x80000000
- d31b4ac1 add amoadd.w inst
***
### 2021-03-06 :
finish risc-v vitual machine with muc and there is within 5000 lines c codes.
Base bu rv64i
Support mtime，small uart and mmu sv39.
#### **Update Parameters:**
- -a **close all debug**
- -e **close error debug**
- -g **format print**
- -d **enable all debug (include register and csr list)**
- -i **enalbe decode debug**
- -m **enable mmu debug**
#### *Software Specification**
1. Support c program
2. Supoort freertos
3. Support mbedtls
4. Support mmu sv39 test
5. Support mtimer test
6. Support opensbi
# Thanks
- [哇酷网](https://whycan.com/t_5844.html)
- [RT-thread](https://www.rt-thread.io/)
- [RISC-V](https://riscv.org/)
- [linux](https://www.kernel.org/)
- [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)
# Contact us
juicemail@163.com

265
doc/assert/README_zh.md Normal file
View File

@ -0,0 +1,265 @@
![JUICE VM](./doc/assert/logo.png)
* [简介](#简介)
* [Juice Vm的优点](#juice-vm的优点)
* [Juice Vm的组成](#juice-vm的组成)
* [Juice Vm 代码统计](#Juice-Vm-代码统计)
* [Juice Vm的地址空间分布](#juice-vm的地址空间分布)
* [Juice Vm下的软件移植进度](#juice-vm下的软件移植进度)
* [快速安装](#快速安装)
* [<strong>快速上手</strong>](#快速上手)
* [运行freertos 截图](#运行freertos-截图)
* [运行rt-thread 截图](#运行rt-thread-截图)
* [运行linx 5.0.0 截图](#运行linx-500-截图)
* [<strong>软件参数使用说明</strong>](#软件参数使用说明)
* [社区支持](#社区支持)
* [<strong>CHANGE LOG</strong>](#change-log)
* [<strong>2021-05-25</strong>](#2021-05-25)
* [<strong>20210524进展公布，发布包发布juice_vm_release_for_Linux_c21682d3.zip：</strong>](#20210524进展公布发 布包发布juice_vm_release_for_linux_c21682d3zip)
* [<strong>20210508更新：</strong>](#20210508更新)
* [<strong>20210427更新：</strong>](#20210427更新)
* [<strong>20210424更新:</strong>](#20210424更新)
* [<strong>软件适配进度</strong>](#软件适配进度)
* [<strong>更新了支持的参数：</strong>](#更新了支持的参数)
* [<strong>202210306更新:</strong>](#202210306更新)
* [<strong>软件适配进度</strong>](#软件适配进度-1)
* [<strong>更新了支持的参数：</strong>](#更新了支持的参数-1)
* [<strong>提交日志</strong>](#提交日志)
* [以下 2021-03-06 更新:](#以下-2021-03-06-更新)
* [<strong>更新了支持的参数：</strong>](#更新了支持的参数-2)
* [<strong>软件适配进度</strong>](#软件适配进度-2)
* [鸣谢](#鸣谢)
* [联系作者](#联系作者)
## 简介
juice vm诞生于2020年，以实现可运行最新kernel主线的RISC-V最小虚拟机为目标而诞生的，设计之初秉承着可以在 **RAM** 只有 **百KB** 级别的平台上运行，不引入除了**c99**标准外的第三方依赖。
juice vm按照gcc所支持的C99标准编写，无第三方库依赖，浅显易懂，且具有方便移植的特性（可快速移植到多种主流 MCU 及支持c环境的所有平台上）。
juice vm去掉注释后展开所有的宏的代码行数仅**12523**行，仅**36104**字，足够的小巧。
## Juice Vm的优点
- 资源占用极低。
- 跨平台、可快速移植。
## Juice Vm的组成
- 指令集：RV64IMASU.
- 支持了M-mode,U-mode,S-mode下的mtime.
- 超级精简的uart，只有读和写两个外设寄存器.
- 超级精简的MMU SV39支持.
- 支持RISC-V官方标准的异常和中断托管
## Juice Vm 代码统计
![JUICE VM](./doc/assert/juicevm_size.png)
## Juice Vm的地址空间分布
| 虚拟机版本号 | 起始地址 | 大小(字节) | 寄存器名称 | 说明 | 所用宏名称 |
| :-----------: | :-------- | :------- | :------- | :------------| :------------ |
| c21682d3 | 0x80000000 | 0x12C00000 | SRAM | 内部存储 | RV_CPU_SIM_RAM_START_ADDR RV_CPU_SIM_RAM_SIZE |
| c21682d3 | 0x92C00000 | 0x1 | UART_WRITE | uart发送寄存器 | pdev_uart0_write_addr |
| c21682d3 | 0x92C00001 | 0x1 | UART_READ | uart接收寄存器 | pdev_uart0_read_addr |
| c21682d3 | 0x92C00002 | 0x1 | UART_STATE | uart状态寄存器 | pdev_uart0_state_addr pdev_uart0_free_state pdev_uart0_readbusy_state |
| c21682d3 | 0x92C00003 | 0x8 | mtime | mtime当前计数寄存器 | pdev_mtime_mtime_addr |
| c21682d3 | 0x92c00007 | 0x8 | mtimecmp | mtime当前比较寄存器 | pdev_mtime_mtimecmp_addr |
## Juice Vm下的软件移植进度
- 已经支持了c语言编程。
- 已完成freertos移植。
- 已完成mbedtls移植。
- 已完成mmu sv39测试。
- 已完成mtime测试。
- 已完成opensbi移植 [传送门](https://github.com/juiceRv/opensbi_juicevm_port)。
- 已完成rt-thread移植，感谢@熊大和@Andy Chen的支持 [传送门](https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm)。
- 已完成kernel主线5.0.0 [传送门](https://github.com/juiceRv/kernel_juicevm_port)。
- 上传Juice Vm下的GCC toolchain [传送门](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)。
- 适配 GDB 通用接口支持 **TODO**。
- 适配 RT-SMART **TODO**。
## 快速安装
- **UBUNTU/DEBIAN** APT安装
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O - http://xiaohui.mongoyun.com:3333/key/deb.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install juicevm
juicevm
```
- **CENTOS**
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O juice_vm_release_for_Linux_laster.zip https://github.com/juiceRv/JuiceVm/raw/master/juice_vm_release_for_Linux_laster.zip
unzip juice_vm_release_for_Linux_laster.zip
cd juice_vm_release_for_Linux_c21682d3/juice_vm_release_for_Linux
sudo chmod +x juice_vm_for_Linux.out
./juice_vm_for_Linux.out
```
- **WINDOW**
**编译中**
## **快速上手**
- [快速上手运行Hello world](./doc/get-started.md) **编写中**。
- [运行Free rtos](./doc/run-freertos.md) **编写中**。
- [运行mbedtls](./doc/run-mbedtls.md) **编写中**。
- [运行SV39 MMU测试](./doc/run-mmu_sv39.md) **编写中**。
- [运行mtime测试](./doc/run-mmu_sv39.md) **编写中**。
- [运行mtime测试](./doc/run-mtime.md) **编写中**。
- [运行 RT-thread](./doc/run-rtt.md) **编写中**。
- [运行 linux kernel](./doc/run-linux.md) **编写中**。
## 运行freertos 截图
![JUICE VM FreeRtos](./doc/assert/freertos.png)
## 运行rt-thread 截图
![JUICE VM RT-thread](./doc/assert/juicevm_rtt.jpg)
## 运行linx 5.0.0 截图
![JUICE VM linux kernel](./doc/assert/juicevm_kernel.png)
## **软件参数使用说明**
| 参数 | 参数名称 | 说明 |
| :------ | :------- | :-------|
| t | enable test mode | 进入固件测试模式<br>当出现下面的状态会结束运行并且打印出通过还是失败的字样,x3_gp寄存器的值为1 和 x17_a7寄存器的值为93时,进入了ecall异常就会触发。x10_a0 寄存器的值为 0时打印pass字样，否则打印fail字样 |
| **T** | enable trap debug mode | 使能异常调试模式，出现异常时会打印当前异常的调试信息 |
| d | enable debug mode | 打开虚拟机内所有的调试选项，输出最详细的调试信息，包括指令译码，处理执行，当前寄存器列表，csr列表等 |
| c | print cst operation msg | 打开虚拟机的csr寄存器读写调试信息。读写csr寄存器的时候都会打印对应的csr寄存器的值 |
| a | diable all debug msg | 关闭所有调试选项，译码调试默认打开 |
| x | enable test mode for exception | 打开异常测试模式，当出现异常时结束运行 |
| g | enable better readability printing | 使用可读性更好的方式打印信息 |
| e | disable all error msg | 关闭所有的错误信息打印 |
| i | enable all instr debug msg | 打开所有指令调试信息打印 |
| m | enable mmu debug msg | 打开mmu的遍历调试信息 |
| p | print mmu page 8 byte data | hexdump打印mmu页表里的8字节数据 |
| **P** | print mmu page 4K Byte data | hexdump打印mmu页表里的4K字节数据 |
| s | uart addr not use mmu translation | 启用mmu翻译时，忽略uart的外设地址，在启用了mmu的时候也可以直接通过uart原始物理地址来操作uart外设 |
| **S** | switch mode debug info | 打开切换mode时的调试信息，m-mode,s-mode和u-mode切换的时候都会打印调试信息 |
| **M** | disable mmu err msg | 关闭mmu缺页异常，访问异常，加载异常的错误信息 |
| r | enable trap debug msg | 打印更详细的进入中断的调试信息 |
| **A** | enable addr translation debug print | 打印地址转换的调试打印 |
| **L**(n) | log mode | output_mode_sel n = 0 -> stdout<br> 1 -> log_buf UNIX SYS ONLY(buf_size:(2900))<br> 2 -> none<br> 选择虚拟机输出的方式，1，直接标准输出。2，使用一个buf先缓存，退出的时候再输出bug大小2900Byte。3，不输出。<br> |
| l | enable endless loop check (RV_ENDLESS_LOOP_CHECK_EXIT_CNT:(3)) | 启用死循环监测机制，当有连续3次出现同样的指令执行流程(包括寄存器和csr寄存器的值都没有改变),结束虚拟机的运行。可以搭配-L参数使用，方便调试固件。一般assert都是直接死循环。|
# 社区支持
挖坑网首发 感谢晕哥一路的支持：[https://whycan.com/t_5844.html](https://whycan.com/t_5844.html)
## **CHANGE LOG**
### **2021-05-25**
- opensbi和kernel的代码已发布到github！！！
[https://github.com/juiceRv/kernel_juicevm_port](https://github.com/juiceRv/kernel_juicevm_port)
kernel的配置文件在arch/riscv/configs/juicevm_defconfig,make ARCH=riscv juicevm_defconfig
- 需要修改下arch/riscv/configs/juicevm_defconfig里的CONFIG_INITRAMFS_SOURCE="/mnt/ssd_prj/risc-v_sim/sim/test/opensbi/opensbi-master/rootfs"
修改为opensbi里的路径
opensbi仓库
[https://github.com/juiceRv/opensbi_juicevm_port](https://github.com/juiceRv/opensbi_juicevm_port)
toolchains
[https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)
***
### **20210524进展公布，发布包发布juice_vm_release_for_Linux_c21682d3.zip：**
1. 修复了mtime在m-mode,s-mode和u-mode下的中断处理漏洞。
2. 修复了ecall在s-mode下的漏洞。
3. 修复了在s-mode和u-mode下进入异常模式，更新csr寄存器的漏洞。
4. 移植了linux。
**juice_vm成功运行kernel主线5.0.0。**
**juice_vm成功运行kernel主线5.0.0。**
**juice_vm成功运行kernel主线5.0.0。**
***
### **20210508更新：**
1. 上传一个ubuntu20.04上可以正常运行的发布包,感谢@XBOOT大佬的反馈。
2. 添加了div指令支持。
3. 修复了divuw，divw，remu，remw，amomin.w，amoswap.w的指令错误。
***
### **20210427更新：**
提交了RT-Thread 的适配 到官方仓库：详情请点击https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm
***
### **20210424更新:**
#### **软件适配进度**
1.已完成rt-thread移植。
#### **更新了支持的参数：**
1. 新增-L参数用于指定打印日志方式。
2. 新增-l参数用于在出现死循环的时候结束运行。
3. 新增-r参数用于开启trap调试打印
4. 更新了Alive logo。
5. 新增-T参数用于执行过程输出反汇编调试打印。
6. 新增m模块支持。
7. 新增s-mode支持(u-mode支持中）。
***
### **202210306更新:**
#### **软件适配进度**
1. 已经支持了c语言编程。
2. 已完成freertos移植。
3. 已完成mebedtls移植。
4. 已完成mmu sv39测试。
5. 已完成mtimer测试。
6. 已完成opensbi移植。
#### **更新了支持的参数：**
- -m **参数用于开启mmu调试信息**
#### **提交日志**
- 1113e998 add sfence.vma instr
- f118d476 add print instr support
- 1e3e7204 add AMOSWAP.D LR.D and SC.D instr support
- 686741ea add AMOSWAP.D LR.D and SC.D instr support
- f2f699c0 add -i arg to enable instr print support
- 113f66da add misa csr support
- 19cf60d1 fix divu err
- ad512e54 add divu remw and remu instr
- 9abc0566 fix mem overflow
- 0ceb663e fix divw instr and add REMW instr
- 10a2ea78 fix divw instr
- 9c93c4ce add amoswap.w , mul and divw instr
- df10ad45 change the fireware start addr to 0x80000000
- d31b4ac1 add amoadd.w inst
***
### 以下 2021-03-06 更新:
无第三方库不到5000行C语言实现一个risc-v虚拟机，带mmu
基于指令集 rv64i
实现了mtime，超级精简的uart和mmu sv39.
#### **更新了支持的参数：**
- -a **关闭所有调试打印**
- -e **关闭错误打印**
- -g **用更好的方式来显示打印**
- -d **开启所有调试打印(包括寄存器和csr列表)**
- -i **开启指令解码调试信息**
- -m **开启mmu调试信息**
#### **软件适配进度**
1. 已经支持了c语言编程。
2. 已完成freertos移植。
3. 已完成mebedtls移植。
4. 已完成mmu sv39测试。
5. 已完成mtimer测试。
6. 已完成opensbi移植。
# 鸣谢
- [哇酷网](https://whycan.com/t_5844.html)
- [RT-thread](https://www.rt-thread.io/)
- [RISC-V](https://riscv.org/)
- [linux](https://www.kernel.org/)
- [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)
# 联系作者
juicemail@163.com

272
doc/assert/en.md Normal file
View File

@ -0,0 +1,272 @@
![JUICE VM](./doc/assert/logo.png)
* [Introduction](#introduction)
* [The Advantage of Juice Vm](#the-advantage-of-juice-vm)
* [The feature of Juice Vm](#the-feature-of--juice-vm)
* [Juice Vm's statistics](#juice-vms-statistics)
* [Juice Vm's address](#juice-vms-address)
* [The software process of Project](#the-software-process-of-project)
* [Get started](#get-started)
* [<strong>Example</strong>](#example)
* [The Shot of freertos](#the-shot-of-freertos)
* [The Shot of rt-thread](#the-shot-of-rt-thread)
* [The Shot of linx 5.0.0](#the-shot-of-linx-500)
* [<strong>Parameters Specification</strong>](#parameters-specification)
* [Community support](#community-support)
* [<strong>CHANGE LOG</strong>](#change-log)
* [<strong>2021-05-25</strong>](#2021-05-25)
* [<strong>20210524 juice_vm_release_for_Linux_c21682d3.zip：</strong>](#20210524-juice_vm_release_for_linux_c21682d3zip)
* [<strong>20210508：</strong>](#20210508)
* [<strong>20210427：</strong>](#20210427)
* [<strong>2021042:</strong>](#2021042)
* [<strong>software specification</strong>](#software-specification)
* [<strong>Update parameters：</strong>](#update-parameters)
* [<strong>202210306:</strong>](#202210306)
* [<strong>software specification</strong>](#software-specification-1)
* [<strong>Update parameters:</strong>](#update-parameters-1)
* [<strong>Issue</strong>](#issue)
* [2021-03-06 :](#2021-03-06-)
* [<strong>Update Parameters:</strong>](#update-parameters-2)
* [<em>Software Specification</em>*](#software-specification-2)
* [Thanks](#thanks)
* [Contact us](#contact-us)
## Introduction
The project began in 2020.Juice Vm is a small RISC-V virtual machine and run the latest kernel.The chip which contain hundreds of KB RAM can run this virtual machine,but it wouldn't contain any third-party libraries.
Juice Vm follow gcc C99 stardard,without any third-party library.Therefore,it is really easy to read and it support many platforms.
There is only **12523** lines and **36104** words in the project without any annotation .Therefore it is really small.
## The Advantage of Juice Vm
- Consume little memory
- Support some platforms easily.
## The feature of Juice Vm
- ISA(Instruction Set Architecture)：RV64IMASU.
- Suport mtime in M-mode,U-mode,S-mode
- Super small uart,only contain two Register:read and write
- Super samll MMU(support SV39)
- Support exception and interruption with official RISC-V stardard
## Juice Vm's statistics
![JUICE VM](./doc/assert/juicevm_size.png)
## Juice Vm's address
| Version | Start Address | Size(Byte) | Register | Statement | Macro definition |
| :-----------: | :-------- | :------- | :------- | :------------| :------------ |
| c21682d3 | 0x80000000 | 0x12C00000 | SRAM | internal storage | RV_CPU_SIM_RAM_START_ADDR RV_CPU_SIM_RAM_SIZE |
| c21682d3 | 0x92C00000 | 0x1 | UART_WRITE | uart send register | pdev_uart0_write_addr |
| c21682d3 | 0x92C00001 | 0x1 | UART_READ | uart recv register | pdev_uart0_read_addr |
| c21682d3 | 0x92C00002 | 0x1 | UART_STATE | uart state register | pdev_uart0_state_addr pdev_uart0_free_state pdev_uart0_readbusy_state |
| c21682d3 | 0x92C00003 | 0x8 | mtime | current count register | pdev_mtime_mtime_addr |
| c21682d3 | 0x92c00007 | 0x8 | mtimecmp | compare register | pdev_mtime_mtimecmp_addr |
## The software process of Project
- Support the C program
- Support freertos
- Support mbedtls
- Pass mmu sv39 test
- Pass mtime test
- Support opensbi [Link](https://github.com/juiceRv/opensbi_juicevm_port)
- Support rt-thread ,Thanks for @熊大和@Andy Chen [Link](https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm)
- Support kernel 5.0.0 [Link](https://github.com/juiceRv/kernel_juicevm_port)
- Upload GCC toolchain [Link](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)
- Support GDB **TODO**
- SUpport RT-SMART **TODO**
-
## Get started
- **UBUNTU/DEBIAN** APT install
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O - http://xiaohui.mongoyun.com:3333/key/deb.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install juicevm
juicevm
```
- **CENTOS**
```
echo "deb http://xiaohui.mongoyun.com:3333/ trusty main" | sudo tee -a /etc/apt/sources.list
wget -O juice_vm_release_for_Linux_laster.zip https://github.com/juiceRv/JuiceVm/raw/master/juice_vm_release_for_Linux_laster.zip
unzip juice_vm_release_for_Linux_laster.zip
cd juice_vm_release_for_Linux_c21682d3/juice_vm_release_for_Linux
sudo chmod +x juice_vm_for_Linux.out
./juice_vm_for_Linux.out
```
- **WINDOW**
**Compile**
## **Example**
- [Hello world](./doc/get-started.md) **todo**
- [Free rtos](./doc/run-freertos.md) **todo**
- [mbedtls](./doc/run-mbedtls.md) **todo**
- [SV39 MMU test](./doc/run-mmu_sv39.md) **todo**
- [mtime test](./doc/run-mmu_sv39.md) *todo**
- [mtime test](./doc/run-mtime.md) **todo**
- [RT-thread](./doc/run-rtt.md) **todo**
- [linux kernel](./doc/run-linux.md) **todo**
## The Shot of freertos
![JUICE VM FreeRtos](./doc/assert/freertos.png)
## The Shot of rt-thread
![JUICE VM RT-thread](./doc/assert/juicevm_rtt.jpg)
## The Shot of linx 5.0.0
![JUICE VM linux kernel](./doc/assert/juicevm_kernel.png)
## **Parameters Specification**
| Parm | Name | statement |
| :------ | :------- | :-------|
| t | enable test mode | Enter test mode<br>When appearing the following statement,the machine would end up,x3_gp register's value is **1** and x17_a7 register's vaule is 93时,it cause ecall exception。when x10_a0 register's value is 0 ,it print pass，otherwise it print "faile" |
| **T** | enable trap debug mode | enable exception mode and it will print current exception information |
| d | enable debug mode | Open all debug option in vitural machine and print debug ,include ISA,running process,register list ,csr list and etc. |
| c | print cst operation msg | enable debug csr register(read and write register) and print all the register values. |
| a | diable all debug msg | Disable all debug message |
| x | enable test mode for exception | It caused by exception |
| g | enable better readability printing | None |
| e | disable all error msg | None |
| i | enable all instr debug msg | None |
| m | enable mmu debug msg | None |
| p | print mmu page 8 byte data | None |
| **P** | print mmu page 4K Byte data | None |
| s | uart addr not use mmu translation | Enalbe mmu translation,and ignore uart address.Control the uart by read and write uart physical address when enble mmu |
| **S** | switch mode debug info | enable debug when switching the mode.It print debug information in m-mode,s-mode and u-mode |
| **M** | disable mmu err msg | Disable debug about Page missing,exception |
| r | enable trap debug msg | Print more detailed debug about interruption |
| **A** | enable addr translation debug print | None |
| **L**(n) | log mode | output_mode_sel n = 0 -> stdout<br> 1 -> log_buf UNIX SYS ONLY(buf_size:(2900))<br> 2 -> none<br> Choose output mode，1，stardard ouput. 2，Store in a buffer when the code is running.Ouput 2900Byte buffer when the code exit. 3，No ouput。<br> |
| l | enable endless loop check (RV_ENDLESS_LOOP_CHECK_EXIT_CNT:(3)) | Enable loop watcher,when it run the same introduction three times continuously(include registers and csr register value wouldn't change),end the vm.You can run the vm with -L in order to debug the fireware.It would be bad loop when show assert |
# Community support
Thanks for whycan ：[https://whycan.com/t_5844.html](https://whycan.com/t_5844.html)
## **CHANGE LOG**
### **2021-05-25**
- The codes of opensbi and kernel are published in github
[https://github.com/juiceRv/kernel_juicevm_port](https://github.com/juiceRv/kernel_juicevm_port)
kernel configuration :arch/riscv/configs/juicevm_defconfig,make ARCH=riscv juicevm_defconfig
- Please open file (arch/riscv/configs/juicevm_defconfig) and modify **CONFIG_INITRAMFS_SOURCE** (the real opensbi path )
opensbi
[https://github.com/juiceRv/opensbi_juicevm_port](https://github.com/juiceRv/opensbi_juicevm_port)
toolchains
[https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm](https://github.com/juiceRv/gcc-gnu-toolchains-for-juicevm)
***
### **20210524 juice_vm_release_for_Linux_c21682d3.zip：**
1. fix mtime interruption bug in m-mode,s-mode and u-mode
2. fix ecall bug in s-mode
3. fix issue about interruption in s-mode and u-mode,fix the csr register.
4. support linux(5.0.0)
***
### **20210508：**
1. release the package in ubuntu20.04,thanks for @XBOOT
1. support div introduction set
3. fix divuw，divw，remu，remw，amomin.w，amoswap.w introduction error
***
### **20210427：**
Support RT-Thread OS ,please refer: https://github.com/RT-Thread/rt-thread/tree/master/bsp/juicevm
***
### **2021042:**
#### **software specification**
1.Support rt-thread
#### **Update parameters：**
1. -L:Support different output mode with
2. -l:End the code when the machine enter bad loop
3. -r:enalbe trace debug
4. Add Alive logo
5. -T: Print compilation information when the code is running
6. support m-mode
7. support s-mode(u-mode **todo**)
***
### **202210306:**
#### **software specification**
1. Support c program
2. Supoort freertos
3. Support mbedtls
4. Support mmu sv39 test
5. Support mtimer test
6. Support opensbi
#### **Update parameters:**
- -m **enable mmu debug**
#### **Issue**
- 1113e998 add sfence.vma instr
- f118d476 add print instr support
- 1e3e7204 add AMOSWAP.D LR.D and SC.D instr support
- 686741ea add AMOSWAP.D LR.D and SC.D instr support
- f2f699c0 add -i arg to enable instr print support
- 113f66da add misa csr support
- 19cf60d1 fix divu err
- ad512e54 add divu remw and remu instr
- 9abc0566 fix mem overflow
- 0ceb663e fix divw instr and add REMW instr
- 10a2ea78 fix divw instr
- 9c93c4ce add amoswap.w , mul and divw instr
- df10ad45 change the fireware start addr to 0x80000000
- d31b4ac1 add amoadd.w inst
***
### 2021-03-06 :
finish risc-v vitual machine with muc and there is within 5000 lines c codes.
Base bu rv64i
Support mtime，small uart and mmu sv39.
#### **Update Parameters:**
- -a **close all debug**
- -e **close error debug**
- -g **format print**
- -d **enable all debug (include register and csr list)**
- -i **enalbe decode debug**
- -m **enable mmu debug**
#### *Software Specification**
1. Support c program
2. Supoort freertos
3. Support mbedtls
4. Support mmu sv39 test
5. Support mtimer test
6. Support opensbi
# Thanks
- [哇酷网](https://whycan.com/t_5844.html)
- [RT-thread](https://www.rt-thread.io/)
- [RISC-V](https://riscv.org/)
- [linux](https://www.kernel.org/)
- [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)
# Contact us
juicemail@163.com