[PATCH v2] doc: board: starfive: update jh7110 common description

[Yao Zi]

On Tue, Nov 18, 2025 at 08:08:12AM +0100, Heinrich Schuchardt wrote:
> Am 18. November 2025 00:35:51 MEZ schrieb E Shattow <e at freeshell.de>:
> >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 <e at freeshell.de>
> >---
> >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/