|
@@ -1,36 +1,79 @@
|
|
|
-# StarFiveTech Freedom Unleashed SDK
|
|
|
+# Freelight U SDK #
|
|
|
|
|
|
-This builds a complete RISC-V cross-compile toolchain for the StarFiveTech Freedom
|
|
|
-JH7100 SoC. It also builds U-boot and a flattened image tree (FIT)
|
|
|
-image with a Opensbi binary, linux kernel, device tree, ramdisk and rootdisk for the
|
|
|
-Starlight development board.
|
|
|
+StarFiveTech Freelight U SDK
|
|
|
+This builds a complete RISC-V cross-compile toolchain for the StarFiveTech JH7100 SoC. It also builds U-boot and a flattened image tree (FIT)
|
|
|
+image with a OpenSBI binary, linux kernel, device tree, ramdisk and rootdisk for the BeagleV development board.
|
|
|
|
|
|
-## Tested Configurations
|
|
|
+## Prerequisites ##
|
|
|
|
|
|
-### Ubuntu 16.04/18.04 x86_64 host
|
|
|
+Recommend OS: Ubuntu 16.04/18.04
|
|
|
|
|
|
-- Status: Working
|
|
|
-- Build dependencies: `build-essential git autotools texinfo bison flex
|
|
|
- libgmp-dev libmpfr-dev libmpc-dev gawk libz-dev libssl-dev`
|
|
|
-- Additional build deps for QEMU: `libglib2.0-dev libpixman-1-dev`
|
|
|
-- Additional build deps for Spike: `device-tree-compiler`
|
|
|
-- tools require for 'format-boot-loader' target: mtools
|
|
|
+After installing the operating system.
|
|
|
+Do not forget updating all packages
|
|
|
|
|
|
-## Build Instructions
|
|
|
+ $sudo apt update
|
|
|
+ $sudo apt upgrade
|
|
|
+
|
|
|
+Install required additional packages.
|
|
|
+
|
|
|
+ $sudo apt-get install autoconf automake autotools-dev bc bison \
|
|
|
+ build-essential curl flex gawk gdisk git gperf libgmp-dev \
|
|
|
+ libmpc-dev libmpfr-dev libncurses-dev libssl-dev libtool \
|
|
|
+ patchutils python screen texinfo unzip zlib1g-dev device-tree-compiler
|
|
|
+
|
|
|
+## Build Instructions ##
|
|
|
|
|
|
Checkout this repository and checkout to vic_starlight branch. Then you will need to checkout all of the linked
|
|
|
submodules using:
|
|
|
|
|
|
-`git submodule update --recursive --init`
|
|
|
+ $ git submodule update --init --recursive
|
|
|
|
|
|
This will take some time and require around 7GB of disk space. Some modules may
|
|
|
-fail because certain dependencies don't have the best git hosting. The only
|
|
|
-solution is to wait and try again later (or ask someone for a copy of that
|
|
|
-source repository).
|
|
|
+fail because certain dependencies don't have the best git hosting.
|
|
|
+
|
|
|
+Once the submodules are initialized, 4 modules`buildroot`,`HiFive_U-boot`,`linux` and `opensbi` need checkout to vic_starlight branch manually.
|
|
|
|
|
|
-Once the submodules are initialized, 4 modules buildroot, HiFive_U-Boot, linux and opensbi will checkout to vic_starlight branch.
|
|
|
After update submodules, run `make` or `make -jx` and the complete toolchain and
|
|
|
fw_payload.bin.out & image.fit will be built. The completed build tree will consume about 14G of
|
|
|
disk space.
|
|
|
|
|
|
+Copy file fw_payload.bin.out and image.fit to installation path to use
|
|
|
+
|
|
|
+ Path:
|
|
|
+ /sft-riscvpi-freedom-u-sdk/work/image.fit
|
|
|
+ /sft-riscvpi-freedom-u-sdk/work/opensbi/platform/starfive/vic7100/firmware/fw_payload.bin.out
|
|
|
+
|
|
|
+## Running on BeagleV ##
|
|
|
+
|
|
|
+After the BeagleV™ is properly connected to the serial port cable, network cable and power cord,turn on the power from the wall power socket to power on the BeagleV™ and you will see the startup information as follows:
|
|
|
+
|
|
|
+ bootloader version: 210209-4547a8d
|
|
|
+ ddr 0x00000000, 1M test
|
|
|
+ ddr 0x00100000, 2M test
|
|
|
+ DDR clk 2133M,Version: 210302-5aea32f
|
|
|
+ 2
|
|
|
+Press any key as soon as it starts up to enter the **upgrade menu**. In this menu, you can update uboot
|
|
|
+
|
|
|
+ bootloader version: 210209-4547a8d
|
|
|
+ ddr 0x00000000, 1M test
|
|
|
+ ddr 0x00100000, 2M test
|
|
|
+ DDR clk 2133M,Version: 210302-5aea32f
|
|
|
+ 0
|
|
|
+ xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
|
+ xxxxxxxxxxxFLASH PROGRAMMINGxxxxxxxxx
|
|
|
+ xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
|
|
|
+
|
|
|
+ 0:update boot
|
|
|
+ 1: quit
|
|
|
+ select the function:
|
|
|
+
|
|
|
+Type **"0"** to update the uboot file fw_payload.bin.out via Xmodem mode, and then Type **"1"** to exit Flash Programming.
|
|
|
+
|
|
|
+After you will see the information `StarFive #`,select the installation path and install image.fit through TFTP:
|
|
|
+
|
|
|
+ setenv fileaddr a0000000; setenv serverip 192.168.xxx.xxx;tftpboot ${fileaddr} ${serverip}:image.fit;bootm start ${fileaddr};bootm loados ${fileaddr};booti 0x80200000 0x86100000:${filesize} 0x86000000
|
|
|
+
|
|
|
+When you see the `buildroot login:` message, then congratulations, the launch was successful
|
|
|
|
|
|
+ buildroot login:root
|
|
|
+ Password: sifive
|