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

Andrew Davis <[email protected]>
Newsgroups org.u-boot-project.lists.u-boot
Message-ID <[email protected]>
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
>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.