mirror of
https://source.denx.de/u-boot/u-boot.git
synced 2025-08-11 17:56:58 +02:00
doc: add DeepComputing FML13V01 documentation
Describe building U-Boot for the board and booting. Carve out common information for JH7110 boards into an include. Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com> Reviewed-by: E Shattow <e@freeshell.de>
This commit is contained in:
Heinrich Schuchardt
Leo Yu-Chi Liang
parent
26cd7afcce
commit
9b0a451b9e
80
doc/board/starfive/deepcomputing_fml13v01.rst
Normal file
80
doc/board/starfive/deepcomputing_fml13v01.rst
Normal file
@ -0,0 +1,80 @@
|
|||||||
|
.. SPDX-License-Identifier: GPL-2.0-or-later
|
||||||
|
|
||||||
|
DeepComputing Framework Motherboard (FLM13V01)
|
||||||
|
==============================================
|
||||||
|
|
||||||
|
The DeepComputing Framework motherboard (FLM13V01) can be combined with a
|
||||||
|
13 inch Framework laptop chassis to provide a complete laptop.
|
||||||
|
|
||||||
|
U-Boot for the board uses the same binaries as the VisionFive 2 board.
|
||||||
|
Currently only serial console output is supported by mainline U-Boot.
|
||||||
|
|
||||||
|
Building
|
||||||
|
--------
|
||||||
|
|
||||||
|
Setup the cross compilation environment variable:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
export CROSS_COMPILE=riscv64-linux-gnu-
|
||||||
|
|
||||||
|
The M-mode software OpenSBI provides the supervisor binary interface (SBI) and
|
||||||
|
is responsible for the switch to S-Mode. It is a prerequisite for building
|
||||||
|
U-Boot. Support for the JH7110 was introduced in OpenSBI 1.2. It is recommended
|
||||||
|
to use a current release.
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
git clone https://github.com/riscv/opensbi.git
|
||||||
|
cd opensbi
|
||||||
|
make PLATFORM=generic FW_TEXT_START=0x40000000 FW_OPTIONS=0
|
||||||
|
export OPENSBI="$(pwd)/build/platform/generic/firmware/fw_dynamic.bin"
|
||||||
|
|
||||||
|
Now build U-Boot SPL and main U-Boot.
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
cd <U-Boot-dir>
|
||||||
|
make starfive_visionfive2_defconfig
|
||||||
|
make
|
||||||
|
|
||||||
|
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, U-Boot, and device-trees.
|
||||||
|
|
||||||
|
Device-tree selection
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
The product ID stored in the board EEPROM is used by U-Boot SPL to select the
|
||||||
|
right configuration and device-tree from the u-boot.itb FIT image.
|
||||||
|
|
||||||
|
Furthermore if variable $fdtfile has not been saved in the environment it is
|
||||||
|
set based on the product ID to *starfive/jh7110-deepcomputing-fml13v01.dtb*.
|
||||||
|
|
||||||
|
To overrule this default the variable can be set manually and saved in the
|
||||||
|
environment
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
setenv fdtfile my_device-tree.dtb
|
||||||
|
env save
|
||||||
|
|
||||||
|
Power switch
|
||||||
|
------------
|
||||||
|
|
||||||
|
A tiny power switch is located in right upper corner of the board.
|
||||||
|
|
||||||
|
Open case detection
|
||||||
|
-------------------
|
||||||
|
|
||||||
|
The board has an open case detection switch. Red lights will flash and the
|
||||||
|
board will not boot if the switch is not held down.
|
||||||
|
|
||||||
|
UART
|
||||||
|
----
|
||||||
|
|
||||||
|
UART 0 is exposed via the side channel contacts SBU1 and SBU2 of the lower,
|
||||||
|
right USB C connector. A USB C cable and a breakout board are needed for
|
||||||
|
physical access. It depends on the cable orientation on which of SBU1 and SBU2
|
||||||
|
you will find RX and TX. The signal voltage is 3.3 V. The baud rate is 115200.
|
||||||
|
|
||||||
|
.. include:: jh7110_common.rst
|
||||||
@ -6,6 +6,7 @@ StarFive
|
|||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
|
||||||
|
deepcomputing_fml13v01
|
||||||
milk-v_mars
|
milk-v_mars
|
||||||
pine64_star64
|
pine64_star64
|
||||||
visionfive2
|
visionfive2
|
||||||
|
|||||||
89
doc/board/starfive/jh7110_common.rst
Normal file
89
doc/board/starfive/jh7110_common.rst
Normal file
@ -0,0 +1,89 @@
|
|||||||
|
.. SPDX-License-Identifier: GPL-2.0-or-later
|
||||||
|
|
||||||
|
Boot source selection
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
The board provides DIP switches to select the device for loading the boot
|
||||||
|
firmware.
|
||||||
|
|
||||||
|
=========== === ===
|
||||||
|
Boot source SW1 SW2
|
||||||
|
=========== === ===
|
||||||
|
UART OFF OFF
|
||||||
|
SD-card ON OFF
|
||||||
|
eMMC OFF ON
|
||||||
|
SPI flash ON ON
|
||||||
|
=========== === ===
|
||||||
|
|
||||||
|
Flashing a new U-Boot version
|
||||||
|
-----------------------------
|
||||||
|
|
||||||
|
U-Boot SPL is provided as file spl/u-boot-spl.bin.normal.out. Main U-Boot is
|
||||||
|
in file u-boot.itb.
|
||||||
|
|
||||||
|
Assuming your new U-Boot version is on partition 1 of an SD-card you could
|
||||||
|
install it to the SPI flash with:
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
sf probe
|
||||||
|
load mmc 1:1 $kernel_addr_r u-boot-spl.bin.normal.out
|
||||||
|
sf update $kernel_addr_r 0 $filesize
|
||||||
|
load mmc 1:1 $kernel_addr_r u-boot.itb
|
||||||
|
sf update $kernel_addr_r 0x100000 $filesize
|
||||||
|
|
||||||
|
For loading the files from a TFTP server refer to the dhcp and tftpboot
|
||||||
|
commands.
|
||||||
|
|
||||||
|
After updating U-Boot you may want to erase a saved environment and reboot.
|
||||||
|
|
||||||
|
.. code-block:: console
|
||||||
|
|
||||||
|
env erase
|
||||||
|
reset
|
||||||
|
|
||||||
|
Booting from SD-Card
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
The device boot ROM loads U-Boot SPL (u-boot-spl.bin.normal.out) from the
|
||||||
|
partition with type GUID 2E54B353-1271-4842-806F-E436D6AF6985. You are free
|
||||||
|
to choose any partition number.
|
||||||
|
|
||||||
|
With the default configuration U-Boot SPL loads the U-Boot FIT image
|
||||||
|
(u-boot.itb) from partition 2 (CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION=0x2).
|
||||||
|
When formatting it is recommended to use GUID
|
||||||
|
BC13C2FF-59E6-4262-A352-B275FD6F7172 for this partition.
|
||||||
|
|
||||||
|
Booting from eMMC
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
The device boot ROM tries to load U-Boot SPL (u-boot-spl.bin.normal.out) from
|
||||||
|
sector 0 of the eMMC's main hardware partition. But this conflicts with GPT
|
||||||
|
partitioning. Fortunately eMMC can alternatively load U-Boot SPL from a backup
|
||||||
|
position.
|
||||||
|
|
||||||
|
For U-Boot SPL (u-boot-spl.bin.normal.out) starting at sector 2048 (position
|
||||||
|
0x100000) write the following bytes to the eMMC device after GPT partitioning:
|
||||||
|
|
||||||
|
======= ========================
|
||||||
|
Address Bytes
|
||||||
|
======= ========================
|
||||||
|
0x0000 40 02 00 00 00 00 10 00
|
||||||
|
0x0290 40 02 00 00 00 00 10 00
|
||||||
|
======= ========================
|
||||||
|
|
||||||
|
With the default configuration U-Boot SPL loads the U-Boot FIT image
|
||||||
|
(u-boot.itb) from partition 2 (CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_PARTITION=0x2).
|
||||||
|
When formatting it is recommended to use GUID
|
||||||
|
BC13C2FF-59E6-4262-A352-B275FD6F7172 for this partition.
|
||||||
|
|
||||||
|
Booting from UART
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
The boot ROM supports the X-modem protocol to upload
|
||||||
|
spl/u-boot-spl.bin.normal.out. U-Boot SPL support loading the FIT image
|
||||||
|
u-boot.itb via the Y-modem protocol.
|
||||||
|
|
||||||
|
Due to restrictions of the boot ROM not all X-modem implementations are
|
||||||
|
compatible. The package tio (https://github.com/tio/tio) has been found to be
|
||||||
|
usable.
|
||||||
Loading…
Reference in New Issue
Block a user