https://github.com/tvlad1234/linux-ch32v003

Linux on a $0.15 RISC-V microcontroller
https://github.com/tvlad1234/linux-ch32v003

ch32v003 ch32v003fun linux mini-rv32ima psram risc-v

Last synced: 6 days ago
JSON representation

Linux on a $0.15 RISC-V microcontroller

• Host: GitHub
• URL: https://github.com/tvlad1234/linux-ch32v003
• Owner: tvlad1234
• License: mit
• Created: 2024-02-17T20:41:55.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2024-02-25T19:18:03.000Z (10 months ago)
• Last Synced: 2024-12-18T02:12:24.338Z (14 days ago)
• Topics: ch32v003, ch32v003fun, linux, mini-rv32ima, psram, risc-v
• Language: C
• Homepage:
• Size: 993 KB
• Stars: 232
• Watchers: 9
• Forks: 21
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# linux-ch32v003

Linux on a $0.15 RISC-V microcontroller

This project enables the CH32V003 microcontroller to run Linux. It achieves this by using an 8 megabyte SPI PSRAM chip and a RISC-V emulator (the very nice [mini-rv32ima by cnlohr](https://github.com/cnlohr/mini-rv32ima)). The emulation is needed because the PSRAM cannot be mapped into the address space of the microcontroler. The Linux kernel and rootfs is loaded into PSRAM at boot from an SD card. FAT filesystem access is provided by the [Petit FatFs](http://elm-chan.org/fsw/ff/00index_p.html) library.

## How to use

This project uses the [ch32v003fun](https://github.com/cnlohr/ch32v003fun) SDK, which must reside in the same folder where this repository was cloned.

The PSRAM and SD card are connected to the hardware SPI interface of the CH32V003. The chip select pins can be set in the [thing_config.h](thing_config.h) file. The console can be accessed over the UART pins. The SD card containing the [Linux image file](Image) must be formatted as FAT32 or FAT16, and the file must be placed in the root. 

A suggested schematic and corresponding single-layer PCB design can be found in the [hardware](hardware) folder (it's a KiCad 7 project).

Boot time is around 5 minutes. The Linux image includes the coremark benchmark in the `/root/` folder.

## Building the Linux image

If you wish to build your own Linux image, you can do so by running `make linux`. The resulting image will be located in `linux/buildroot/output/images/`.