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 Signed-off-by: Alexandre Bailon <[email protected]>
zephyrproject-rtos · Oct 2, 2024 · 02fb8fa · 02fb8fa
1 parent 5a0775b
commit 02fb8fa
Showing 1 changed file with 13 additions and 6 deletions.
diff --git a/boards/ti/cc1352p7_launchpad/doc/index.rst b/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
 ==========