On 11/18/25 11:29, Yao Zi wrote:
On Tue, Nov 18, 2025 at 08:08:12AM +0100, Heinrich Schuchardt wrote:
Am 18. November 2025 00:35:51 MEZ schrieb E Shattow <[email protected]>:
Updates to the JH7110 common description:
- add detailed overview of JH-7110 SoC and boot process
- revise descriptions of deprecated StarFive loader modes
- refresh build directions grouped with SPL debug advice
- reduce usage instructions into common methods shared by supported boards
- cite starfive_visionfive2 board maintainer description of StarFive loader
- cite published datasheets for ambient operating temperature data
Redundant/deprecated sections of each board doc are dropped accordingly:
- deepcomputing fml13v01
- milk-v mars
- pine64 star64 (also add inclusion of JH7110 common description)
- visionfive2
Signed-off-by: E Shattow <[email protected]>
---
Changes since v1:
By popular request I have expanded on the topic of deprecated boot modes.
For those users that rely on this it is now more descriptive about
factors contributing to the feature deprecation and naming the U-Boot
release version when this change is in effect. Re-introducing these modes
is out of scope for this documentation series, however.
- reST needs a space between numeric and the substitution
- add comment identifying where U-Boot SPL again reads state of [RGPIO1:RGPIO0]
useful to refer to for boards with button+transistors instead of MSEL DIP
- cite reference to JH-7110 Boot User Guide BootROM description of StarFive
loader
- expand on topic of supported and deprecated U-Boot SPL boot modes
- cite from published datasheets for ambient operating temperature data
- drop not-yet-published OpenSBI version recommendation
---
...
diff --git a/doc/board/starfive/jh7110_common.rst
b/doc/board/starfive/jh7110_common.rst
index 4a8058ee5da..2f049b4c327 100644
--- a/doc/board/starfive/jh7110_common.rst
+++ b/doc/board/starfive/jh7110_common.rst
@@ -1,103 +1,560 @@
...
+There are additional unexplained GUID references in the JH-7110 MaskROM so the
+description given is not complete. Attribution and modifications to the GPL2.0+
+source code used in StarFive loader have not been published as of this writing.
+Due to the lack of verifiable documentation the upstream Linux devicetree does
+not contain hints for mmc0 and mmc1 interfaces to be included in U-Boot SPL. As
+of U-Boot release v2025.10 and newer the U-Boot specific devicetree override of
+hints for mmc0 and mmc1 interfaces that are required for the deprecated modes
+have been dropped marking the deprecation of these boot modes in U-Boot.
Do you mean upstream U-Boot will fail to boot from SD-card, which is the
Ubuntu default?
This would need to be fixed urgently.
U-Boot master has failed to boot from SD-Card on VisionFive 2 for some
time, see my previous report[1] in Octorber.
Best regards,
Yao Zi
[1]: https://lore.kernel.org/u-boot/aPYUlyni65Ux8xpq@pie/
Hello Yao,
Thank you for pointing to your former communication.
E's commit 27f617019dd0 ("riscv: dts: starfive: prune redundant
jh7110-common overrides") removed bootph-pre-ram properties - in
contradiction to the commit message - removed bootph-pre-ram properties
which were not provided by upstream device-trees.
I sent a mail to point to the issue on the kernel mailing list:
Re: [PATCH v2 4/8] riscv: dts: starfive: Split jh7110-common.dtsi and
move opp table to it
https://lore.kernel.org/all/[email protected]/
With that additional bootph-pre-ram I am able to boot from SD-card again.
I have not yet checked if something is missing to boot from eMMC.
Best regards
Heinrich
