Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/inindev/visionfive2
stock debian riscv64 linux for the starfive visionfive v2
https://github.com/inindev/visionfive2
debian debian-linux device-tree linux risc-v riscv64 starfive u-boot visionfive visionfive-v2
Last synced: about 1 month ago
JSON representation
stock debian riscv64 linux for the starfive visionfive v2
- Host: GitHub
- URL: https://github.com/inindev/visionfive2
- Owner: inindev
- License: gpl-3.0
- Created: 2023-10-17T08:23:37.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-25T03:24:40.000Z (about 2 months ago)
- Last Synced: 2024-09-30T02:24:25.005Z (about 2 months ago)
- Topics: debian, debian-linux, device-tree, linux, risc-v, riscv64, starfive, u-boot, visionfive, visionfive-v2
- Language: Shell
- Homepage:
- Size: 1.27 MB
- Stars: 4
- Watchers: 6
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# visionfive2
#### *Debian riscv64 Linux for the StarFive VisionFive 2*
This Debian riscv64 Linux image is built directly from official packages using the Debian [debootstrap](https://wiki.debian.org/Debootstrap) utility, see: https://github.com/inindev/visionfive2/blob/main/debian/make_debian_img.sh#L132
Most patches are directly available from the Debian repos using the built-in apt package manager, see: https://github.com/inindev/visionfive2/blob/main/debian/make_debian_img.sh#L354-L361
Note: The kernel in this bundle is from kernel.org and will not get updates from debian.
---
### debian trixie setup
**1. download image**
```
wget https://github.com/inindev/visionfive2/releases/download/v13-6.6.5/visionfive2_trixie-v13-6.6.5.img.xz
```
**2. determine the location of the target micro sd card**
* before plugging-in device
```
ls -l /dev/sd*
ls: cannot access '/dev/sd*': No such file or directory
```
* after plugging-in device
```
ls -l /dev/sd*
brw-rw---- 1 root disk 8, 0 Apr 10 15:56 /dev/sda
```
* note: for mac, the device is ```/dev/rdiskX```
**3. in the case above, substitute 'a' for 'X' in the command below (for /dev/sda)**
```
sudo su
xzcat visionfive2_trixie-v13-6.6.5.img.xz > /dev/sdX
sync
```
#### when the micro sd has finished imaging, eject and use it to boot the visionfive2 to finish setup
#### Note the [boot switch configuration setting](https://github.com/inindev/visionfive2/blob/main/misc/vf2_mmc.jpg) needed to select mmc boot.
**4. login account**
```
login id: debian
password: debian
```
**5. take updates**
```
sudo apt update
sudo apt upgrade
```
**6. create account & login as new user**
```
sudo adduser youruserid
echo ' ALL=(ALL) NOPASSWD: ALL' | sudo tee /etc/sudoers.d/
sudo chmod 440 /etc/sudoers.d/
```
**7. lockout and/or delete debian account**
```
sudo passwd -l debain
sudo chsh -s /usr/sbin/nologin debian
```
```
sudo deluser --remove-home debian
sudo rm /etc/sudoers.d/debian
```
**8. change hostname (optional)**
```
sudo nano /etc/hostname
sudo nano /etc/hosts
```
---
### installing on m.2 nvme media
**1. boot from removable mmc**
[Follow the instructions](https://github.com/inindev/visionfive2#debian-trixie-setup) for creating bootable mmc media.
**2. download and copy the image file on to the nvme media**
```
wget https://github.com/inindev/visionfive2/releases/download/v13-6.6.5/visionfive2_trixie-v13-6.6.5.img.xz
sudo su
xzcat visionfive2_trixie-v13-6.6.5.img.xz > /dev/nvme0n1
sync
```
**3. the u-boot partitions are not used on nvme media and can be removed**
```
sfdisk --delete /dev/nvme0n1 1
sfdisk --delete /dev/nvme0n1 2
sfdisk -r /dev/nvme0n1
```
**4. remove mmc media and reboot**
---
### booting from spi nor flash
**1. boot from removable mmc**
[Follow the instructions](https://github.com/inindev/visionfive2#debian-trixie-setup) for creating bootable mmc media.
Note: Configure the [boot switch setting](https://github.com/inindev/visionfive2/blob/main/misc/vf2_mmc.jpg) needed to select mmc boot.
**2. install mtd-utils**
once linux is booted from the removable mmc, install mtd-utils
```
sudo apt update
sudo apt -y install mtd-utils
```
**3. erase spi flash**
```
sudo flash_erase /dev/mtd0 0 0
sudo flash_erase /dev/mtd1 0 0
sudo flash_erase /dev/mtd2 0 0
sudo flash_erase /dev/mtd3 0 0
```
**4. write u-boot to spi flash**
```
wget https://github.com/inindev/visionfive2/releases/download/v13-6.6.5/u-boot-spl.bin.normal.out
wget https://github.com/inindev/visionfive2/releases/download/v13-6.6.5/u-boot.itb
sudo flashcp -v u-boot-spl.bin.normal.out /dev/mtd0
sudo flashcp -v u-boot.itb /dev/mtd2
```
Once the spi flash has been written, the boot sequence should prefer removable mmc media if present, then boot m.2 nvme ssd.
Note: Configure the [boot switch setting](https://github.com/inindev/visionfive2/blob/main/misc/vf2_spi.jpg) needed to select spi boot.
---
### building debian trixie riscv64 for the visionfive2 from scratch
The build script builds native riscv64 binaries, and thus needs to be run from an riscv64 device such as visionfive2 running
a 64 bit risc-v linux.
**1. clone the repo**
```
git clone https://github.com/inindev/visionfive2.git
cd visionfive2
```
**2. run the debian build script**
```
cd debian
sudo sh make_debian_img.sh
```
* note: edit the build script to change various options: ```nano make_debian_img.sh```
**3. the output if the build completes successfully**
```
mmc_2g.img.xz
```