mirror of
https://github.com/thead-yocto-mirror/meta-riscv
synced 2026-06-21 08:52:24 +02:00
f4d336cb7e
Based on Nezha D1 machine config with addjusterd DTB configuration and added wifi module driver. Tested with core-image-(base|weston) on MangoPi MQ Pro rev 1.3: - HDMI output/weston and wifi are working. USB-C ethernet detected but not tested due to lack of HW. Signed-off-by: Pavel Zhukov <pavel@zhukoff.net>
157 lines
4.7 KiB
Markdown
157 lines
4.7 KiB
Markdown
# meta-riscv
|
|
RISC-V Architecture Layer for OpenEmbedded/Yocto
|
|
|
|
[](https://github.com/riscv/meta-riscv/blob/kraj/master/COPYRIGHT)
|
|
[](https://travis-ci.org/riscv/meta-riscv)
|
|
|
|
## Description
|
|
|
|
This is the general hardware-specific BSP overlay for the RISC-V based devices.
|
|
|
|
More information can be found at: <https://riscv.org/> (Official Site)
|
|
|
|
The core BSP part of meta-riscv should work with different
|
|
OpenEmbedded/Yocto distributions and layer stacks, such as:
|
|
|
|
* Distro-less (only with OE-Core).
|
|
* Yoe Distro.
|
|
* Yocto/Poky.
|
|
|
|
## Dependencies
|
|
|
|
This layer depends on:
|
|
|
|
* URI: https://github.com/openembedded/openembedded-core
|
|
* branch: master
|
|
* revision: HEAD
|
|
* URI: https://github.com/openembedded/bitbake
|
|
* branch: master
|
|
* revision: HEAD
|
|
|
|
## Quick Start
|
|
|
|
**Note: You only need this if you do not have an existing Yocto Project build environment.**
|
|
|
|
Make sure to [install the `repo` command by Google](https://source.android.com/setup/downloading#installing-repo) first.
|
|
|
|
### Create workspace
|
|
```text
|
|
mkdir riscv-yocto && cd riscv-yocto
|
|
repo init -u https://github.com/riscv/meta-riscv -b master -m tools/manifests/riscv-yocto.xml
|
|
repo sync
|
|
repo start work --all
|
|
```
|
|
### Update existing workspace
|
|
|
|
In order to bring all the layers up to date with upstream
|
|
|
|
```text
|
|
cd riscv-yocto
|
|
repo sync
|
|
repo rebase
|
|
```
|
|
|
|
### Setup Build Environment
|
|
```text
|
|
. ./meta-riscv/setup.sh
|
|
```
|
|
|
|
## Available Machines
|
|
|
|
The different machines you can build for are:
|
|
|
|
* freedom-u540: The SiFive HiFive Unleashed board
|
|
* beaglev-starlight-jh7100: BeagleV - Based on Starlight JH7100 SOC
|
|
* mangopi-mq-pro: MangoPi MQ Pro - Based on Allwinner D1 SOC
|
|
|
|
Note that this layer also provides improvements and features for the
|
|
upstream qemuriscv32 and qemuriscv64 machines.
|
|
|
|
Additional beagleV notes on bringup are [here](https://github.com/riscv/meta-riscv/blob/master/docs/BeagleV.md)
|
|
## Build Images
|
|
|
|
A console-only image for the 64-bit QEMU machine
|
|
```text
|
|
MACHINE=qemuriscv64 bitbake core-image-full-cmdline
|
|
MACHINE=beaglev-starlight-jh7100 bitbake core-image-full-cmdline
|
|
```
|
|
|
|
To build an image to run on the HiFive Unleashed using Wayland run the following
|
|
|
|
```text
|
|
MACHINE=freedom-u540 bitbake core-image-weston
|
|
```
|
|
|
|
To build an image to run on the BeagleV using Wayland run the following
|
|
```text
|
|
MACHINE=beaglev-starlight-jh7100 bitbake core-image-weston
|
|
```
|
|
|
|
To build an image to run on the MangoPi MQ Pro (console only has been tested so far) run the following:
|
|
```text
|
|
MACHINE=mangopi-mq-pro bitbake core-image-base
|
|
```
|
|
|
|
To build a full GUI equipped image running Plasma Mobile see the in-tree documentation [here](https://github.com/riscv/meta-riscv/blob/master/docs/Plasma-Mobile-on-Unleashed.md).
|
|
|
|
## Running in QEMU
|
|
|
|
Run the 64-bit machine in QEMU using the following command:
|
|
|
|
```text
|
|
MACHINE=qemuriscv64 runqemu nographic
|
|
```
|
|
|
|
Run the 32-bit machine in QEMU using the following command:
|
|
|
|
```text
|
|
MACHINE=qemuriscv32 runqemu nographic
|
|
```
|
|
|
|
## Running on hardware
|
|
|
|
### Setting up a TFTP server
|
|
|
|
If you would like to boot the images from a TFTP server (optional) you should set your TFTP server address in your local.conf with the following line. Change ```127.0.0.1``` to the IP address of your TFTP server and copy the uImage to the server.
|
|
|
|
```text
|
|
TFTP_SERVER_IP = "127.0.0.1"
|
|
```
|
|
|
|
### Running with the Microsemi Expansion board
|
|
|
|
To use the Microsemi expansion board with your HiFive Unleased add the following line to your local.conf. This tells the Unleashed to use a device tree with the PCIe device described:
|
|
|
|
```text
|
|
RISCV_SBI_FDT:freedom-u540 = "hifive-unleashed-a00-microsemi.dtb"
|
|
```
|
|
|
|
### Sparse Image Creation
|
|
|
|
The output of the build can also be written to an SD card using bmaptool, the steps to do this are below:
|
|
|
|
```text
|
|
$ MACHINE=freedom-u540 wic create freedom-u540-opensbi -e core-image-minimal
|
|
$ bmaptool create ./freedom-u540-opensbi-201812181337-mmcblk.direct > image.bmap
|
|
$ sudo bmaptool copy --bmap image.bmap ./freedom-u540-opensbi-201812181337-mmcblk.direct /dev/sdX
|
|
```
|
|
|
|
### dding wic.gz
|
|
|
|
The output of a ```freedom-u540```, ```beaglev-starlight-jh7100``` or ```mangopi-mq-pro``` build will be a ```<image>.wic.gz``` file. You can write this file to an sd card using:
|
|
|
|
```text
|
|
$ zcat <image>-<machine>.wic.gz | sudo dd of=/dev/sdX bs=4M iflag=fullblock oflag=direct conv=fsync status=progress
|
|
```
|
|
|
|
### Using bmaptoop to write the image
|
|
|
|
Instead of dding wic.gz image ```bmaptool``` (available in most Linux distributions and/or pip) can be used for more reliable and faster flashing. You can write this file to an sd card using:
|
|
```text
|
|
$ sudo bmaptool copy <image>-<machine>.wic.gz /dev/sdX
|
|
```
|
|
|
|
## Maintainer(s)
|
|
|
|
* Khem Raj `<raj dot khem at gmail.com>`
|