[PATCH v2] doc: spacemit: add K1 SPL build and test guide

[Vincent Legoll]

Hi Heinrich, Guodong Xu,

On 3/27/26 10:32, Heinrich Schuchardt wrote:
> Thanks a lot for providing this documentation. 

Yes, I also add my thanks. This is very useful to 
help passing-by random-joe-testers.

>> +Hardware Setup
>> +~~~~~~~~~~~~~~
>> +
>> +**1. UART Connection**
>> +
>> +Connect a 3.3V USB-to-UART cable to the **J25** header on the BPI-F3.
>
> Isn't this documentation meant to apply to all K1 boards?
>
> How about:
>
> Connect a 3.3V USB-to-UART cable to the board's UART header (J25 on 
> the BPI-F3). 


I'd even go a step further, i.e. keep this doc completely board-agnostic

and keep board-specific parts for their own pages. That would mean moving

the "Deploying via USB Fastboot" section out of this document.


This is only IMHO, don't take my personal preference as the maintainers one.


>> +Deploying via USB Fastboot
>> +~~~~~~~~~~~~~~~~~~~~~~~~~~~
>> +
>> +To enter BootROM fastboot mode:
>> +
>> +1. Disconnect USB Type-C cable from J15 (power off)
>
> J15 is only the designation on the BPI-F3. A more generic term may be 
> needed.
>
> How about:
>
> Power of the board by disconnecting the OTG port (J15 on BPI-F3) and 
> any additional power supply (12 V on BPI-F3). 


Maybe just: "Power off the board by unplugging its power supply."


>> +2. **Press and hold** the FDL button (see board layout above)


The FDL button is also probably BPI-F3 specific information, I see picture

of the OrangePi RV2 having a "Boot Key", which may be the equivalent one.


>> +.. note::
>> +
>> +   After DDR init succeeds, SPL proceeds to load U-Boot proper. Since
>> +   SPI NOR storage driver support is not yet available, SPL cannot
>> +   transition into U-Boot proper. When U-Boot stage support is ready,
>> +   this document will be updated.
>
> Please, move the note to the top of the document so that reader does 
> not discover at the end of the process that their board does not boot 
> anymore.


Yes, I agree. I missed it, probably out of haste, but still.

Thanks again