[NOT-FOR-UPSTREAM] Add readmeJH7110_VisionFive2_upstream

Signed-off-by: Hal Feng <hal.feng@starfivetech.com>

1 files changed, 95 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 000000000000..fc9d5042f3fd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,95 @@
+## JH7110 Upstream Status ##
+
+To get the latest status of each upstreaming patch series, please visit
+our RVspace.
+
+https://rvspace.org/en/project/JH7110_Upstream_Plan
+
+## Test Status ##
+
+| Component | Test Result | Note |
+| :---------| :-----------| :----|
+| Clock tree / Reset | Pass |  |
+| Pinctrl | Pass |  |
+| Watchdog | Pass |  |
+| Timer | Pass |  |
+| PLL clock | Pass |  |
+| Temperature sensor | Pass |  |
+| DMA | Pass |  |
+| PWM | Pass |  |
+| GMAC | Pass |  |
+| SDIO / EMMC | Pass |  |
+| I2C | Pass |  |
+| SPI | Pass |  |
+| QSPI | Pass |  |
+| USB | Pass |  |
+| PCIe | Pass | Please use a power supply with strong driving capability |
+| PMU | Pass |  |
+| Hibernation | Pass |  |
+| PMIC | Pass |  |
+| CPU freq scaling | Pass |  |
+| Crypto | Fail | Report trace errors at startup |
+| TRNG | Pass |  |
+| PWMDAC | Pass |  |
+| I2S | Pass |  |
+| TDM | Pass |  |
+| HDMI / DC8200 | Pass | But you need to boot Linux with the U-Boot in the mainline |
+| MIPI CSI | Pass |  |
+| ISP | Pass |  |
+| MIPI CSI PHY | Pass |  |
+
+## Build Instructions ##
+
+1. Configure Kconfig options
+
+```shell
+# Use the modified riscv default defconfig
+make ARCH=riscv CROSS_COMPILE=riscv64-linux-gnu- defconfig
+```
+
+or
+
+```shell
+# Select options manually
+make ARCH=riscv CROSS_COMPILE=riscv64-linux-gnu- nconfig
+```
+
+To boot up the VisionFive 2 board, please make sure **SOC_STARFIVE**, 
+**CLK_STARFIVE_JH7110_SYS**, **PINCTRL_STARFIVE_JH7110_SYS**, 
+**SERIAL_8250_DW** are selected.
+> If you need MMC and GMAC drivers, you should also select
+**MMC_DW_STARFIVE** and **DWMAC_STARFIVE**.
+
+2. Build
+```shell
+make ARCH=riscv CROSS_COMPILE=riscv64-linux-gnu-
+```
+
+## How to Run on VisionFive 2 Board via Network ##
+
+1. Power on, enter u-boot and set enviroment parameters
+```
+setenv fdt_high 0xffffffffffffffff; setenv initrd_high 0xffffffffffffffff;
+setenv scriptaddr 0x88100000; setenv script_offset_f 0x1fff000; setenv script_size_f 0x1000;
+setenv kernel_addr_r 0x84000000; setenv kernel_comp_addr_r 0x90000000; setenv kernel_comp_size 0x10000000;
+setenv fdt_addr_r 0x88000000; setenv ramdisk_addr_r 0x88300000;
+```
+2. Set IP addresses for the board and your tftp server
+```
+setenv serverip 192.168.w.x; setenv gatewayip 192.168.w.y; setenv ipaddr 192.168.w.z; setenv hostname starfive; setenv netdev eth0;
+```
+3. Download dtb, image and ramdisk to DDR from your tftp server
+```
+tftpboot ${fdt_addr_r} jh7110-starfive-visionfive-2-v1.3b.dtb; tftpboot ${kernel_addr_r} Image.gz; tftpboot ${ramdisk_addr_r} initramfs.cpio.gz;
+```
+> If your VisionFive 2 is v1.2A, you should download jh7110-starfive-visionfive-2-v1.2a.dtb instead.
+4. Load and boot the kernel
+```
+booti ${kernel_addr_r} ${ramdisk_addr_r}:${filesize} ${fdt_addr_r};
+```
+When you see the message "buildroot login:", the launch was successful.
+You can just input the following accout and password, then continue.
+```
+buildroot login: root
+Password: starfive
+```