Re: [PATCH v3 10/11] doc: board: ti: correct path to tcl scripts

On 8/3/26 7:09 PM, Bryan Brattlof wrote:
> OpenOCD has moved where it has placed the tcl scripts for TI's reference
> boards. Update their paths to the new locations.
> 
> Tested-by: Anshul Dalal <[email protected]>
> Signed-off-by: Bryan Brattlof <[email protected]>
> ---
> Changes in v3:
> - Kept warning about which versions of OpenOCD have the tcl scripts
> - Link to v2: https://lore.kernel.org/r/[email protected]
> ---
>   doc/board/ti/am6254atl_sk.rst |  2 +-
>   doc/board/ti/am62ax_sk.rst    |  2 +-
>   doc/board/ti/am62dx_evm.rst   | 11 ++++++-----
>   doc/board/ti/am62px_sk.rst    | 12 +++++-------
>   doc/board/ti/am62x_sk.rst     |  2 +-
>   doc/board/ti/am64x_evm.rst    | 24 ++++++++++++++++++++++++
>   doc/board/ti/am65x_evm.rst    |  2 +-
>   doc/board/ti/j7200_evm.rst    |  2 +-
>   doc/board/ti/j721e_evm.rst    |  2 +-
>   doc/board/ti/j722s_evm.rst    |  2 +-
>   doc/board/ti/j784s4_evm.rst   |  2 +-
>   11 files changed, 43 insertions(+), 20 deletions(-)
> 
> diff --git a/doc/board/ti/am6254atl_sk.rst b/doc/board/ti/am6254atl_sk.rst
> index 18a3520b39c7..0df058aee157 100644
> --- a/doc/board/ti/am6254atl_sk.rst
> +++ b/doc/board/ti/am6254atl_sk.rst
> @@ -305,4 +305,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash $
>   
> -  openocd -f board/ti_am625evm.cfg
> +   openocd -f board/ti/am625evm.cfg
> diff --git a/doc/board/ti/am62ax_sk.rst b/doc/board/ti/am62ax_sk.rst
> index 3453ed339e7f..b04bfc991ea0 100644
> --- a/doc/board/ti/am62ax_sk.rst
> +++ b/doc/board/ti/am62ax_sk.rst
> @@ -435,4 +435,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash
>   
> -  openocd -f board/ti_am62a7evm.cfg
> +   openocd -f board/ti/am62a7evm.cfg
> diff --git a/doc/board/ti/am62dx_evm.rst b/doc/board/ti/am62dx_evm.rst
> index 0d12e3ec1476..88071b3e69d9 100644
> --- a/doc/board/ti/am62dx_evm.rst
> +++ b/doc/board/ti/am62dx_evm.rst
> @@ -237,10 +237,6 @@ detailed setup information.
>   
>   .. warning::
>   
> -  **AM62A**: OpenOCD support since August 2023 (git master)
> -
> -  **AM62D**: Uses AM62A configuration (compatible due to same core architecture)
> -
>     Until the next stable release of OpenOCD is available in your development
>     environment's distribution, it might be necessary to build OpenOCD `from the
>     source <https://github.com/openocd-org/openocd>`_.
> @@ -253,4 +249,9 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash
>   
> -  openocd -f board/ti/am62a7evm.cfg
> +   openocd -f board/ti/am62a7evm.cfg
> +
> +.. note::
> +
> +   The AM62D-EVM uses the same tcl configuration as the AM62A-SK due to
> +   same core architecture.
> diff --git a/doc/board/ti/am62px_sk.rst b/doc/board/ti/am62px_sk.rst
> index 44dae4afc870..9d8b5ebf38fb 100644
> --- a/doc/board/ti/am62px_sk.rst
> +++ b/doc/board/ti/am62px_sk.rst
> @@ -331,13 +331,11 @@ detailed setup information.
>   
>   .. warning::
>   
> -  **OpenOCD support after**: v0.12.0
> +   **OpenOCD support after**: v0.12.0
>   
> -  While support for the entire K3 generation including the am62xxx
> -  extended family was added before v0.12.0, the tcl scripts for the
> -  am62px have been accepted and will be available in the next release of
> -  OpenOCD. It may be necessary to build OpenOCD from source depending on
> -  the version your distribution has packaged.
> +   Until the next stable release of OpenOCD is available in your development
> +   environment's distribution, it might be necissary to build OpenOCD `from the

s/necissary/necessary

Otherwise everything else looks good,

Acked-by: Andrew Davis <[email protected]>

> +   source <https://github.com/openocd-org/open ocd>`_.
>   
>   .. include::  k3.rst
>       :start-after: .. k3_rst_include_start_openocd_connect_XDS110
> @@ -347,4 +345,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash
>   
> -  openocd -f board/ti_am62pevm.cfg
> +   openocd -f board/ti/am62pevm.cfg
> diff --git a/doc/board/ti/am62x_sk.rst b/doc/board/ti/am62x_sk.rst
> index ef9425035cb8..2e4923f7a7a1 100644
> --- a/doc/board/ti/am62x_sk.rst
> +++ b/doc/board/ti/am62x_sk.rst
> @@ -867,4 +867,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash $
>   
> -  openocd -f board/ti_am625evm.cfg
> +   openocd -f board/ti/am625evm.cfg
> diff --git a/doc/board/ti/am64x_evm.rst b/doc/board/ti/am64x_evm.rst
> index 65c4c456528c..6f02a1eef883 100644
> --- a/doc/board/ti/am64x_evm.rst
> +++ b/doc/board/ti/am64x_evm.rst
> @@ -227,3 +227,27 @@ https://www.ti.com/lit/pdf/spruim2 under the `Boot Mode Pins` section.
>   
>     For SW2 and SW3, the switch state in the "ON" position = 1.
>     Boot bits on SK is reversed bits to the bootmode signals
> +
> +Debugging U-Boot
> +----------------
> +
> +See :ref:`Common Debugging environment - OpenOCD<k3_rst_refer_openocd>`: for
> +detailed setup information.
> +
> +.. warning::
> +
> +   **OpenOCD support after**: v0.12.0
> +
> +   Until the next stable release of OpenOCD is available in your development
> +   environment's distribution, it might be necissary to build OpenOCD `from the
> +   source <https://github.com/openocd-org/open ocd>`_.
> +
> +.. include::  k3.rst
> +    :start-after: .. k3_rst_include_start_openocd_connect_XDS110
> +    :end-before: .. k3_rst_include_end_openocd_connect_XDS110
> +
> +To start OpenOCD and connect to the board
> +
> +.. prompt:: bash
> +
> +   openocd -f board/ti/am642evm.cfg
> diff --git a/doc/board/ti/am65x_evm.rst b/doc/board/ti/am65x_evm.rst
> index 73ceef2e531c..5f75c01ec65a 100644
> --- a/doc/board/ti/am65x_evm.rst
> +++ b/doc/board/ti/am65x_evm.rst
> @@ -321,4 +321,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash $
>   
> -  openocd -f board/ti_am654evm.cfg
> +   openocd -f board/ti/am654evm.cfg
> diff --git a/doc/board/ti/j7200_evm.rst b/doc/board/ti/j7200_evm.rst
> index 4fd2aff83547..e5c29c2bbb7b 100644
> --- a/doc/board/ti/j7200_evm.rst
> +++ b/doc/board/ti/j7200_evm.rst
> @@ -232,4 +232,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash $
>   
> -  openocd -f board/ti_j7200evm.cfg
> +   openocd -f board/ti/j7200evm.cfg
> diff --git a/doc/board/ti/j721e_evm.rst b/doc/board/ti/j721e_evm.rst
> index 41c8d4c72a8d..c3f3736e625a 100644
> --- a/doc/board/ti/j721e_evm.rst
> +++ b/doc/board/ti/j721e_evm.rst
> @@ -261,4 +261,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash $
>   
> -  openocd -f board/ti_j721eevm.cfg
> +   openocd -f board/ti/j721evm.cfg
> diff --git a/doc/board/ti/j722s_evm.rst b/doc/board/ti/j722s_evm.rst
> index 4b5cf0275940..3d11271613c7 100644
> --- a/doc/board/ti/j722s_evm.rst
> +++ b/doc/board/ti/j722s_evm.rst
> @@ -255,4 +255,4 @@ To start OpenOCD and connect to the board
>   
>   .. prompt:: bash
>   
> -  openocd -f board/ti_j722sevm.cfg
> +   openocd -f board/ti/j722sevm.cfg
> diff --git a/doc/board/ti/j784s4_evm.rst b/doc/board/ti/j784s4_evm.rst
> index ec82228ab908..54b4b6031f0c 100644
> --- a/doc/board/ti/j784s4_evm.rst
> +++ b/doc/board/ti/j784s4_evm.rst
> @@ -663,4 +663,4 @@ following.
>   
>   .. prompt:: bash
>   
> -  openocd -f board/ti_j784s4evm.cfg
> +   openocd -f board/ti/j784s4evm.cfg
>