[PATCH v2] doc: board: ti: Add J742S2 support

[PATCH v2] doc: board: ti: Add J742S2 support

[Udit Kumar]

J742S2 SOC is derivative of J784S4, most of build infra of j784s4 is used
to build u-boot for J742S2 EVM board.

Add guide users on how to build for that board.

Signed-off-by: Udit Kumar <u-kumar1@ti.com>
---
Test logs
https://gist.github.com/uditkumarti/b2e23151728628805a680b6eab528e7c

Changelog:
Changes in v2:
- Removed extra =
- link to v1:
https://lore.kernel.org/all/20251204142451.834404-1-u-kumar1@ti.com/

 doc/board/ti/j784s4_evm.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/doc/board/ti/j784s4_evm.rst b/doc/board/ti/j784s4_evm.rst
index 22442874110..69deeee1076 100644
--- a/doc/board/ti/j784s4_evm.rst
+++ b/doc/board/ti/j784s4_evm.rst
@@ -1,8 +1,8 @@
 .. SPDX-License-Identifier: GPL-2.0-or-later OR BSD-3-Clause
 .. sectionauthor:: Apurva Nandan <a-nandan@ti.com>
 
-J784S4 and AM69 Platforms
-=========================
+J742S2, J784S4 and AM69 Platforms
+=================================
 
 Introduction
 ------------
@@ -37,6 +37,11 @@ Platform information:
 * https://www.ti.com/tool/J784S4XEVM
 * https://www.ti.com/tool/SK-AM69
 
+J742S2 is derivative of J784S24 SOC, More info can be found in
+
+* TRM : https://www.ti.com/lit/ug/spruje3/spruje3.pdf
+* Platform Information : https://www.ti.com/tool/J742S2XH01EVM
+
 Boot Flow
 ---------
 Below is the pictorial representation of boot flow:
@@ -99,6 +104,15 @@ Set the variables corresponding to this platform:
       export UBOOT_CFG_CORTEXR=am69_sk_r5_defconfig
       export UBOOT_CFG_CORTEXA=am69_sk_a72_defconfig
 
+.. note::
+
+   For J742S2-EVM, use the following U_BOOT_CFG instead:
+
+   .. prompt:: bash
+
+      export UBOOT_CFG_CORTEXR=j742s2_evm_r5_defconfig
+      export UBOOT_CFG_CORTEXA=j742s2_evm_a72_defconfig
+
 .. j784s4_evm_rst_include_start_build_steps
 
 1. Trusted Firmware-A
@@ -146,13 +160,19 @@ variant (GP, HS-FS, HS-SE) requires a different source for these files.
  - HS-FS
 
     * tiboot3-j784s4-hs-fs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
+    * tiboot3-j742s2-hs-fs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
     * tispl.bin, u-boot.img from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
 
  - HS-SE
 
     * tiboot3-j784s4-hs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
+    * tiboot3-j742s2-hs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
     * tispl.bin, u-boot.img from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
 
+.. note::
+
+   For J742S2, GP variant is not available.
+
 Image formats
 -------------
 
-- 
2.34.1

Re: [PATCH v2] doc: board: ti: Add J742S2 support

[Mattijs Korpershoek]

Hi Udit,

Thank you for the patch.

On Fri, Dec 05, 2025 at 10:06, Udit Kumar <u-kumar1@ti.com> wrote:

> J742S2 SOC is derivative of J784S4, most of build infra of j784s4 is used
> to build u-boot for J742S2 EVM board.
>
> Add guide users on how to build for that board.
>
> Signed-off-by: Udit Kumar <u-kumar1@ti.com>
> ---
> Test logs
> https://gist.github.com/uditkumarti/b2e23151728628805a680b6eab528e7c
>
> Changelog:
> Changes in v2:
> - Removed extra =
> - link to v1:
> https://lore.kernel.org/all/20251204142451.834404-1-u-kumar1@ti.com/
>
>  doc/board/ti/j784s4_evm.rst | 24 ++++++++++++++++++++++--
>  1 file changed, 22 insertions(+), 2 deletions(-)
>
> diff --git a/doc/board/ti/j784s4_evm.rst b/doc/board/ti/j784s4_evm.rst
> index 22442874110..69deeee1076 100644
> --- a/doc/board/ti/j784s4_evm.rst
> +++ b/doc/board/ti/j784s4_evm.rst
> @@ -1,8 +1,8 @@
>  .. SPDX-License-Identifier: GPL-2.0-or-later OR BSD-3-Clause
>  .. sectionauthor:: Apurva Nandan <a-nandan@ti.com>
>  
> -J784S4 and AM69 Platforms
> -=========================
> +J742S2, J784S4 and AM69 Platforms
> +=================================
>  
>  Introduction
>  ------------
> @@ -37,6 +37,11 @@ Platform information:
>  * https://www.ti.com/tool/J784S4XEVM
>  * https://www.ti.com/tool/SK-AM69
>  
> +J742S2 is derivative of J784S24 SOC, More info can be found in
> +
> +* TRM : https://www.ti.com/lit/ug/spruje3/spruje3.pdf
> +* Platform Information : https://www.ti.com/tool/J742S2XH01EVM
> +
>  Boot Flow
>  ---------
>  Below is the pictorial representation of boot flow:
> @@ -99,6 +104,15 @@ Set the variables corresponding to this platform:
>        export UBOOT_CFG_CORTEXR=am69_sk_r5_defconfig
>        export UBOOT_CFG_CORTEXA=am69_sk_a72_defconfig
>  
> +.. note::
> +
> +   For J742S2-EVM, use the following U_BOOT_CFG instead:
> +
> +   .. prompt:: bash
> +
> +      export UBOOT_CFG_CORTEXR=j742s2_evm_r5_defconfig
> +      export UBOOT_CFG_CORTEXA=j742s2_evm_a72_defconfig
> +

nitpick: Can't this be grouped in the same .. note:: block as for AM69
defconfigs ?

I tend to dislike multiple notes blocks one after another.
It is fine if you don't want to change this as it's a "personal preference".

>  .. j784s4_evm_rst_include_start_build_steps
>  
>  1. Trusted Firmware-A
> @@ -146,13 +160,19 @@ variant (GP, HS-FS, HS-SE) requires a different source for these files.
>   - HS-FS
>  
>      * tiboot3-j784s4-hs-fs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
> +    * tiboot3-j742s2-hs-fs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
>      * tispl.bin, u-boot.img from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
>  
>   - HS-SE
>  
>      * tiboot3-j784s4-hs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
> +    * tiboot3-j742s2-hs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
>      * tispl.bin, u-boot.img from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
>  
> +.. note::
> +
> +   For J742S2, GP variant is not available.
> +

Can't this note be in the - GP section?
Just after:
"""
    * tispl.bin_unsigned, u-boot.img_unsigned from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
"""

In my opinion, it would make more sense than at the end of the
Target Images section.

>  Image formats
>  -------------
>  
> -- 
> 2.34.1

Re: [PATCH v2] doc: board: ti: Add J742S2 support

[Kumar, Udit]

Thanks Mattijs

On 12/5/2025 7:22 PM, Mattijs Korpershoek wrote:
> Hi Udit,
>
> Thank you for the patch.
>
> On Fri, Dec 05, 2025 at 10:06, Udit Kumar <u-kumar1@ti.com> wrote:
>
>> J742S2 SOC is derivative of J784S4, most of build infra of j784s4 is used
>> to build u-boot for J742S2 EVM board.
>>
>> Add guide users on how to build for that board.
>>
>> Signed-off-by: Udit Kumar <u-kumar1@ti.com>
>> ---
>> Test logs
>> https://gist.github.com/uditkumarti/b2e23151728628805a680b6eab528e7c
>>
>> Changelog:
>> Changes in v2:
>> - Removed extra =
>> - link to v1:
>> https://lore.kernel.org/all/20251204142451.834404-1-u-kumar1@ti.com/
>>
>>   doc/board/ti/j784s4_evm.rst | 24 ++++++++++++++++++++++--
>>   1 file changed, 22 insertions(+), 2 deletions(-)
>>
>> diff --git a/doc/board/ti/j784s4_evm.rst b/doc/board/ti/j784s4_evm.rst
>> index 22442874110..69deeee1076 100644
>> --- a/doc/board/ti/j784s4_evm.rst
>> +++ b/doc/board/ti/j784s4_evm.rst
>> @@ -1,8 +1,8 @@
>>   .. SPDX-License-Identifier: GPL-2.0-or-later OR BSD-3-Clause
>>   .. sectionauthor:: Apurva Nandan <a-nandan@ti.com>
>>   
>> -J784S4 and AM69 Platforms
>> -=========================
>> +J742S2, J784S4 and AM69 Platforms
>> +=================================
>>   
>>   Introduction
>>   ------------
>> @@ -37,6 +37,11 @@ Platform information:
>>   * https://www.ti.com/tool/J784S4XEVM
>>   * https://www.ti.com/tool/SK-AM69
>>   
>> +J742S2 is derivative of J784S24 SOC, More info can be found in
>> +
>> +* TRM : https://www.ti.com/lit/ug/spruje3/spruje3.pdf
>> +* Platform Information : https://www.ti.com/tool/J742S2XH01EVM
>> +
>>   Boot Flow
>>   ---------
>>   Below is the pictorial representation of boot flow:
>> @@ -99,6 +104,15 @@ Set the variables corresponding to this platform:
>>         export UBOOT_CFG_CORTEXR=am69_sk_r5_defconfig
>>         export UBOOT_CFG_CORTEXA=am69_sk_a72_defconfig
>>   
>> +.. note::
>> +
>> +   For J742S2-EVM, use the following U_BOOT_CFG instead:
>> +
>> +   .. prompt:: bash
>> +
>> +      export UBOOT_CFG_CORTEXR=j742s2_evm_r5_defconfig
>> +      export UBOOT_CFG_CORTEXA=j742s2_evm_a72_defconfig
>> +
> nitpick: Can't this be grouped in the same .. note:: block as for AM69
> defconfigs ?
>
> I tend to dislike multiple notes blocks one after another.
> It is fine if you don't want to change this as it's a "personal preference".

Sure, will merge alone with AM69 section


>
>>   .. j784s4_evm_rst_include_start_build_steps
>>   
>>   1. Trusted Firmware-A
>> @@ -146,13 +160,19 @@ variant (GP, HS-FS, HS-SE) requires a different source for these files.
>>    - HS-FS
>>   
>>       * tiboot3-j784s4-hs-fs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
>> +    * tiboot3-j742s2-hs-fs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
>>       * tispl.bin, u-boot.img from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
>>   
>>    - HS-SE
>>   
>>       * tiboot3-j784s4-hs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
>> +    * tiboot3-j742s2-hs-evm.bin from :ref:`step 3.1 <j784s4_evm_rst_u_boot_r5>`
>>       * tispl.bin, u-boot.img from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
>>   
>> +.. note::
>> +
>> +   For J742S2, GP variant is not available.
>> +
> Can't this note be in the - GP section?
> Just after:
> """
>      * tispl.bin_unsigned, u-boot.img_unsigned from :ref:`step 3.2 <j784s4_evm_rst_u_boot_a72>`
> """
>
> In my opinion, it would make more sense than at the end of the
> Target Images section.


Sure, will do this change in v3


>
>>   Image formats
>>   -------------
>>   
>> -- 
>> 2.34.1