blob: d8511d3fd14153518d2bb9306077faaeb4fc37f5 [file] [log] [blame]
BeagleV
=======
BeagleV is a low-cost RISC-V 64-bit based platform, powered by a
Starfive JH7100 processor. The current defconfig in Buildroot has been
tested with the JH7100 chip used on the beta version of the BeagleV
board.
How to build
============
$ make beaglev_defconfig
$ make
Build results
=============
After building, output/images contains:
+ Image
+ fw_payload.bin
+ fw_payload.bin.out
+ fw_payload.elf
+ rootfs.ext2
+ rootfs.ext4
+ sdcard.img
+ u-boot.bin
The two important files are:
- fw_payload.bin.out, which is the bootloader image, containing
both OpenSBI and U-Boot.
- sdcard.img, the SD card image, which contains the root filesystem,
kernel image and Device Tree.
Flashing the SD card image
==========================
$ sudo dd if=output/images/sdcard.img of=/dev/sdX
Preparing the board
===================
Connect the Beagle-V fan to the 5V supply (pin 2 or 4 of the GPIO
connector) and GND (pin 6 of the GPIO connector).
Connect a TTL UART cable to pin 8 (TX), 10 (RX) and 14 (GND).
Insert your SD card.
Power-up the board using an USB-C cable.
Flashing the bootloader
=======================
The bootloader pre-flashed on the Beagle-V has a non-working
fdt_addr_r environment variable value, so it won't work
as-is. Reflashing the bootloader with the bootloader image produced by
Buildroot is necessary.
When the board starts up, a pre-loader shows a count down of 2
seconds, interrupt by pressing any key. You should reach a menu like
this:
--------8<----------
bootloader version:210209-4547a8d
ddr 0x00000000, 1M test
ddr 0x00100000, 2M test
DDR clk 2133M,Version: 210302-5aea32f
0
***************************************************
*************** FLASH PROGRAMMING *****************
***************************************************
0:update uboot
1:quit
select the function:
--------8<----------
Press 0 and Enter. You will now see "C" characters being
displayed. Ask your serial port communication program to send
fw_payload.bin.out using the Xmodem protocol.
After reflashing is complete, restart the board, it will automatically
start the system from the SD card, and reach the login prompt.