board: ti: cc1352p7_lp: Add complementary instructions about OpenOCD

Currently, OpenOCD doesn't support the cc1352p7.
There are two open PR adding its support to Zephyr's OpenOCD[1]
and upstream OpenOCD[2].
Until this gets merged, we need to use a downstream version of OpenOCD.
This updates the documentation to explain where to find it and how to
use it.

[1] zephyrproject-rtos/openocd#65
[2] https://review.openocd.org/q/owner:abailon%2540baylibre.com

(cherry picked from commit 02fb8fa)

Original-Signed-off-by: Alexandre Bailon <[email protected]>
GitOrigin-RevId: 02fb8fa
Cr-Build-Id: 8735195939382094625
Cr-Build-Url: https://cr-buildbucket.appspot.com/build/8735195939382094625
Copybot-Job-Name: zephyr-main-copybot-downstream
Change-Id: I873f7c059ffaa4d5ffcb57f1a921f85d81096c61
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/zephyr/+/5904819
Tested-by: ChromeOS Prod (Robot) <[email protected]>
Commit-Queue: Al Semjonovs <[email protected]>
Tested-by: Al Semjonovs <[email protected]>
Reviewed-by: Al Semjonovs <[email protected]>

Author: anobli

boards/ti/cc1352p7_launchpad/doc/index.rst

@@ -151,15 +151,20 @@ Prerequisites:
 
 #. Install OpenOCD
 
-   You can obtain OpenOCD by following these
-   :ref:`installing the latest Zephyr SDK instructions <toolchain_zephyr_sdk>`.
+   Currently, OpenOCD doesn't support the CC1352P7.
+   Until its support get merged, we have to builld a downstream version that could found `here <https://github.com/anobli/openocd>`_.
+   Please refer to OpenOCD documentation to build and install OpenOCD.
 
-   After the installation, add the directory containing the OpenOCD executable
-   to your environment's PATH variable. For example, use this command in Linux:
+   For your convenience, we provide a `prebuilt binary <https://github.com/anobli/openocd/actions/runs/10566225265>`_.
 
-   .. code-block:: console
+.. code-block:: console
+
+   $ unzip openocd-810cb5b21-x86_64-linux-gnu.zip
+   $ chmod +x openocd-x86_64-linux-gnu/bin/openocd
+   $ export OPENOCD_DIST=$PWD/openocd-x86_64-linux-gnu
 
-      export PATH=$ZEPHYR_SDK_INSTALL_DIR/sysroots/x86_64-pokysdk-linux/usr/bin/openocd:$PATH
+By default, zephyr will try to use the OpenOCD binary from SDK.
+You will have to define :code:`OPENOCD` and :code:`OPENOCD_DEFAULT_PATH` to use the custom OpenOCD binary.
 
 Flashing
 ========
@@ -185,6 +190,7 @@ Then build and flash the application in the usual way.
    :zephyr-app: samples/hello_world
    :board: cc1352p7_lp
    :goals: build flash
+   :gen-args: -DOPENOCD=$OPENOCD_DIST/bin/openocd -DOPENOCD_DEFAULT_PATH=$OPENOCD_DIST/share/openocd
 
 Debugging
 =========
@@ -197,6 +203,7 @@ You can debug an application in the usual way.  Here is an example for the
    :board: cc1352p7_lp
    :maybe-skip-config:
    :goals: debug
+   :gen-args: -DOPENOCD=$OPENOCD_DIST/bin/openocd -DOPENOCD_DEFAULT_PATH=$OPENOCD_DIST/share/openocd
 
 Bootloader
 ==========