kumquat-buildroot/board/visionfive2
Lukasz Tekieli 517f032992 board/visionfive2: add spi-nor image
Builds the spi-nor.img together with the sdcard.img.
Readme is extended with SPI NOR flash writing instructions
and recovery.

The spi-nor.img layout is based on the following document:

https://doc-en.rvspace.org/VisionFive2/Boot_UG/JH7110_SDK/boot_address_allocation.html

Signed-off-by: Lukasz Tekieli <tekieli.lukasz@gmail.com>
[Arnout: extend readme.txt with paragraph that either boot mode works.]
Signed-off-by: Arnout Vandecappelle <arnout@mind.be>
2024-04-28 20:19:14 +02:00
..
overlay/boot/extlinux configs/visionfive2: update kernel to upstream 6.8.2 2024-04-28 20:14:36 +02:00
genimage_spi-nor.cfg board/visionfive2: add spi-nor image 2024-04-28 20:19:14 +02:00
genimage.cfg board/visionfive2: enable u-boot 2024-03-24 08:58:42 +01:00
linux_defconfig configs/visionfive2: update kernel to upstream 6.8.2 2024-04-28 20:14:36 +02:00
post-image.sh board/visionfive2: add spi-nor image 2024-04-28 20:19:14 +02:00
readme.txt board/visionfive2: add spi-nor image 2024-04-28 20:19:14 +02:00

Starfive VisionFive2
====================

The VisionFive2 is a low-cost RISC-V 64-bit based platform, powered by a
Starfive JH7110 processor.

https://doc-en.rvspace.org/Doc_Center/visionfive_2.html

How to build
============

$ make visionfive2_defconfig
$ make

Once the build process is finished you will have two images
in the output/images/ directory:
- sdcard.img
- spi-nor.img

How to write the SPI NOR flash
=============================

If you have a booting device use u-boot and tftp:

  # tftpboot 0x82000000 spi-nor.img
  # sf probe
  # sf update 0x82000000 0x0 {filesize}

Otherwise, follow the recovery instruction:

https://doc-en.rvspace.org/VisionFive2/Quick_Start_Guide/VisionFive2_SDK_QSG/recovering_bootloader%20-%20vf2.html

How to write the SD card
========================

Copy the bootable "sdcard.img" onto an SD card with "dd":

  $ sudo dd if=output/images/sdcard.img of=/dev/sdX

Preparing the board
===================

Connect a TTL UART cable to pin 6 (GND), 8 (TX) and 10 (RX).

Use the correct mode for booting:
- SD card RGPIO_0=1, GRPIO_1=0
- SPI NOR flash RGPIO_0=1, GRPIO_1=1

Note that Buildroot puts the bootloader both in SPI NOR and on the SD card,
so after flashing as instructed above, either boot mode should work.

https://doc-en.rvspace.org/VisionFive2/Quick_Start_Guide/VisionFive2_SDK_QSG/boot_mode_settings.html

Insert your SD card.

Power-up the board using an USB-C cable.