StarFive RISC-V SoC Support
VisionFive v2 / JH7110
Currently, there is only partial support for this SoC in FreeBSD CURRENT. Some efforts are in progress. Support for SD card and Ethernet makes it possible to boot to a login prompt.
Quick Start
- Download a copy of the GENERICSD image from FreeBSD's Download Page.
Copy the installer to a micro-SD card, e.g. dd if=FreeBSD-15.0-CURRENT-riscv-riscv64-GENERICSD-20250515-cb205f5ed808-277278.img of=/dev/da0 bs=1m status=progress
Mount the EFI partition of the micro-SD card, e.g. mount -t msdosfs /dev/da0p3 /mnt/tmp
Copy the relevant DTB file into the EFI partition, e.g. mkdir -p /mnt/tmp/starfive ; cp jh7110-starfive-visionfive-2-v1.3b.dtb /mnt/tmp/starfive/starfive_visionfive2.dtb
Unmount the SD card and insert it into the VisionFive v2 board.
- Power on the board.
Firmware
A u-boot port is available as sysutils/u-boot-starfive-visionfive2.
Support Status
Device/Feature |
Status |
Commits |
Notes |
UART |
Done |
|
|
clk/reset |
Done |
STG clock grouping not implemented; might be needed for future drivers |
|
MMC |
Done |
|
|
Ethernet |
Done |
Some remaining issues discussed in https://reviews.freebsd.org/D45600 |
|
GPIO |
In-progress |
|
|
USB |
Needs work |
|
|
VisionFive v1 / JH7100
The first iteration of the VisionFive SoC, also known as the JH7100. There was a limited run of boards produced for this model, and hardware quirks/errata made supporting it difficult. The I/O coherence problems are not present in v2.
Support for this hardware was experimental, and never upstreamed to FreeBSD.
Original Beagle-V
A prototype of the VisionFive SoC, this board was the result of a partnership between StarFive and the Beagle Foundation. It was intended for wider production, but the partnership was dissolved. It has no relation to later "Beagle-V" products, such as the Beagle-V Ahead, which were not produced by StarFive.
Support for this hardware in FreeBSD was never finished.