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

[Heinrich Schuchardt]

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 <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/

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/ffdfc550-559b-4c59-9873-3f040fc3bb0e@canonical.com/

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