doc: starfive: use consistent formatting
Always use ---- for the H2 level. Reviewed-by: E Shattow <e@freeshell.de> Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
This commit is contained in:
@@ -8,7 +8,7 @@ board. In U-Boot SPL the actual board is detected and the device-tree patched
|
|||||||
accordingly.
|
accordingly.
|
||||||
|
|
||||||
Building
|
Building
|
||||||
~~~~~~~~
|
--------
|
||||||
|
|
||||||
1. Add the RISC-V toolchain to your PATH.
|
1. Add the RISC-V toolchain to your PATH.
|
||||||
2. Setup ARCH & cross compilation environment variable:
|
2. Setup ARCH & cross compilation environment variable:
|
||||||
@@ -40,7 +40,7 @@ This will generate the U-Boot SPL image (spl/u-boot-spl.bin.normal.out) as well
|
|||||||
as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
|
as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
|
||||||
|
|
||||||
Device-tree selection
|
Device-tree selection
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
---------------------
|
||||||
|
|
||||||
Depending on the board version U-Boot set variable $fdtfile to either
|
Depending on the board version U-Boot set variable $fdtfile to either
|
||||||
starfive/jh7110-starfive-visionfive-2-v1.2a.dtb or
|
starfive/jh7110-starfive-visionfive-2-v1.2a.dtb or
|
||||||
@@ -58,14 +58,14 @@ or the configuration variable CONFIG_DEFAULT_FDT_FILE can be used to set to
|
|||||||
provide a default value.
|
provide a default value.
|
||||||
|
|
||||||
Boot source selection
|
Boot source selection
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
---------------------
|
||||||
|
|
||||||
The board provides the DIP switches MSEL[1:0] to select the boot device out of
|
The board provides the DIP switches MSEL[1:0] to select the boot device out of
|
||||||
SPI flash, eMMC, SD-card, UART. To select booting from SD-card set the DIP
|
SPI flash, eMMC, SD-card, UART. To select booting from SD-card set the DIP
|
||||||
switches MSEL[1:0] to 10.
|
switches MSEL[1:0] to 10.
|
||||||
|
|
||||||
Preparing the SD-Card
|
Preparing the SD-Card
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
---------------------
|
||||||
|
|
||||||
The device firmware loads U-Boot SPL (u-boot-spl.bin.normal.out) from the
|
The device firmware loads U-Boot SPL (u-boot-spl.bin.normal.out) from the
|
||||||
partition with type GUID 2E54B353-1271-4842-806F-E436D6AF6985. You are free
|
partition with type GUID 2E54B353-1271-4842-806F-E436D6AF6985. You are free
|
||||||
@@ -106,6 +106,6 @@ Copy U-Boot to the SD card
|
|||||||
sudo umount /mnt
|
sudo umount /mnt
|
||||||
|
|
||||||
Booting
|
Booting
|
||||||
~~~~~~~
|
-------
|
||||||
|
|
||||||
Once you plugin the sdcard and power up, you should see the U-Boot prompt.
|
Once you plugin the sdcard and power up, you should see the U-Boot prompt.
|
||||||
|
@@ -8,7 +8,7 @@ In U-Boot SPL the actual board is detected and the device-tree patched
|
|||||||
accordingly.
|
accordingly.
|
||||||
|
|
||||||
Building
|
Building
|
||||||
~~~~~~~~
|
--------
|
||||||
|
|
||||||
1. Add the RISC-V toolchain to your PATH.
|
1. Add the RISC-V toolchain to your PATH.
|
||||||
2. Setup ARCH & cross compilation environment variable:
|
2. Setup ARCH & cross compilation environment variable:
|
||||||
@@ -40,7 +40,7 @@ This will generate the U-Boot SPL image (spl/u-boot-spl.bin.normal.out) as well
|
|||||||
as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
|
as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
|
||||||
|
|
||||||
Device-tree selection
|
Device-tree selection
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
---------------------
|
||||||
|
|
||||||
U-Boot will set variable $fdtfile to starfive/jh7110-pine64-star64.dtb.
|
U-Boot will set variable $fdtfile to starfive/jh7110-pine64-star64.dtb.
|
||||||
|
|
||||||
@@ -56,7 +56,7 @@ or the configuration variable CONFIG_DEFAULT_FDT_FILE can be used to set to
|
|||||||
provide a default value.
|
provide a default value.
|
||||||
|
|
||||||
Boot source selection
|
Boot source selection
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
---------------------
|
||||||
|
|
||||||
Boot mode is selected by an MSEL-DIP marked S1804 and GPIO_0 position adjacent
|
Boot mode is selected by an MSEL-DIP marked S1804 and GPIO_0 position adjacent
|
||||||
to the 40pin GPIO header. ON/ONKE and number markings of the MSEL-DIP are
|
to the 40pin GPIO header. ON/ONKE and number markings of the MSEL-DIP are
|
||||||
@@ -69,7 +69,7 @@ accurate selection.
|
|||||||
+ UART: 11
|
+ UART: 11
|
||||||
|
|
||||||
Preparing the SD-Card
|
Preparing the SD-Card
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
---------------------
|
||||||
|
|
||||||
The device firmware loads U-Boot SPL (u-boot-spl.bin.normal.out) from the
|
The device firmware loads U-Boot SPL (u-boot-spl.bin.normal.out) from the
|
||||||
partition with type GUID 2E54B353-1271-4842-806F-E436D6AF6985. You are free
|
partition with type GUID 2E54B353-1271-4842-806F-E436D6AF6985. You are free
|
||||||
@@ -110,12 +110,12 @@ Copy U-Boot to the SD card
|
|||||||
sudo umount /mnt
|
sudo umount /mnt
|
||||||
|
|
||||||
Booting
|
Booting
|
||||||
~~~~~~~
|
-------
|
||||||
|
|
||||||
Once you plugin the sdcard and power up, you should see the U-Boot prompt.
|
Once you plugin the sdcard and power up, you should see the U-Boot prompt.
|
||||||
|
|
||||||
Serial Number and MAC address issues
|
Serial Number and MAC address issues
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
------------------------------------
|
||||||
|
|
||||||
U-Boot requires valid EEPROM data to determine which board-specific fix-up to
|
U-Boot requires valid EEPROM data to determine which board-specific fix-up to
|
||||||
apply at runtime. This affects the size of memory initialized, network mac
|
apply at runtime. This affects the size of memory initialized, network mac
|
||||||
|
@@ -36,7 +36,7 @@ Currently, the u-boot.itb is used as a dynamic of the OpenSBI FW_DYNAMIC
|
|||||||
firmware with the latest.
|
firmware with the latest.
|
||||||
|
|
||||||
Building
|
Building
|
||||||
~~~~~~~~
|
--------
|
||||||
|
|
||||||
1. Add the RISC-V toolchain to your PATH.
|
1. Add the RISC-V toolchain to your PATH.
|
||||||
2. Setup ARCH & cross compilation environment variable:
|
2. Setup ARCH & cross compilation environment variable:
|
||||||
@@ -72,7 +72,7 @@ This will generate the U-Boot SPL image (spl/u-boot-spl.bin.normal.out) as well
|
|||||||
as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
|
as the FIT image (u-boot.itb) with OpenSBI and U-Boot.
|
||||||
|
|
||||||
Device-tree selection
|
Device-tree selection
|
||||||
~~~~~~~~~~~~~~~~~~~~~
|
---------------------
|
||||||
|
|
||||||
Depending on the board version U-Boot set variable $fdtfile to either
|
Depending on the board version U-Boot set variable $fdtfile to either
|
||||||
starfive/jh7110-starfive-visionfive-2-v1.2a.dtb or
|
starfive/jh7110-starfive-visionfive-2-v1.2a.dtb or
|
||||||
@@ -90,7 +90,7 @@ or the configuration variable CONFIG_DEFAULT_FDT_FILE can be used to provide
|
|||||||
a default value.
|
a default value.
|
||||||
|
|
||||||
Flashing
|
Flashing
|
||||||
~~~~~~~~
|
--------
|
||||||
|
|
||||||
The device firmware loads U-Boot SPL (u-boot-spl.bin.normal.out) from the
|
The device firmware loads U-Boot SPL (u-boot-spl.bin.normal.out) from the
|
||||||
partition with type GUID 2E54B353-1271-4842-806F-E436D6AF6985. You are free
|
partition with type GUID 2E54B353-1271-4842-806F-E436D6AF6985. You are free
|
||||||
@@ -133,7 +133,7 @@ Program the SD card
|
|||||||
sudo umount /mnt
|
sudo umount /mnt
|
||||||
|
|
||||||
Booting
|
Booting
|
||||||
~~~~~~~
|
-------
|
||||||
|
|
||||||
The board provides the DIP switches MSEL[1:0] to select the boot device.
|
The board provides the DIP switches MSEL[1:0] to select the boot device.
|
||||||
To select booting from SD-card set the DIP switches MSEL[1:0] to 10.
|
To select booting from SD-card set the DIP switches MSEL[1:0] to 10.
|
||||||
@@ -141,7 +141,7 @@ To select booting from SD-card set the DIP switches MSEL[1:0] to 10.
|
|||||||
Once you plugin the sdcard and power up, you should see the U-Boot prompt.
|
Once you plugin the sdcard and power up, you should see the U-Boot prompt.
|
||||||
|
|
||||||
Sample boot log from StarFive VisionFive2 board
|
Sample boot log from StarFive VisionFive2 board
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
-----------------------------------------------
|
||||||
|
|
||||||
.. code-block:: none
|
.. code-block:: none
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user