chore: add openocd support

.env.sample

@@ -3,3 +3,6 @@ ESPTOOL_CHIP=esp32c3
 ESPTOOL_PORT=/dev/ttyACM0
 ESPTOOL_BAUD=460800
 ESPTOOL_FF=80m
+OPENOCD=/usr/bin/openocd-esp32openocd
+OPENOCD_DEFAULT_PATH=/usr/share/openocd-esp32/scripts
+

.vscode/settings.json

@@ -16,10 +16,14 @@
     "ESPTOOL_PORT": "/dev/ttyACM0",
     "ESPTOOL_BAUD": "460800",
     "ESPTOOL_FF": "80m",
-    "ZEPHYR_EXTRA_MODULES": "${workspaceFolder}"
+    "ZEPHYR_EXTRA_MODULES": "${workspaceFolder}",
+    "OPENOCD": "/usr/bin/openocd-esp32openocd",
+    "OPENOCD_DEFAULT_PATH": "/usr/share/openocd-esp32/scripts"
   },
   "cmake.configureArgs": [
-    "-DZEPHYR_EXTRA_MODULES=${workspaceFolder}"
+    "-DZEPHYR_EXTRA_MODULES=${workspaceFolder}",
+    "-DOPENOCD=/usr/bin/openocd-esp32openocd",
+    "-DOPENOCD_DEFAULT_PATH=/usr/share/openocd-esp32/scripts"
   ],
   "cmake.configureEnvironment": {
     "BOARD": "wemos_c3_mini"

.vscode/tasks.json

@@ -24,9 +24,9 @@
       "group": "test"
     },
     {
-      "label": "Debug",
+      "label": "Debug Server",
       "type": "shell",
-      "command": "cd app && west debug",
+      "command": "cd app && west debugserver",
       "group": "test"
     },
     {

boards/riscv/wemos_c3_mini/support/openocd.cfg

@@ -2,5 +2,9 @@ set ESP_RTOS none
 
 source [find interface/esp_usb_jtag.cfg]
 
+## To use external JTAG programmer as ESP-Prog,
+## comment the line above, and uncomment the line below:
+# source [find interface/ftdi/esp32_devkitj_v1.cfg]
+
 source [find target/esp32c3.cfg]
-adapter_khz 5000
+adapter speed 5000

dev-build.sh

@@ -1,10 +1,15 @@
 #!/bin/sh
 set -e
 PROJECT_ROOT="$(cd "$(dirname "$0")"; pwd)"
+export DEBUG
 source "${PROJECT_ROOT}/.env.sh"
 cd "${PROJECT_ROOT}/app"
-# FIXME Find out why fixing BOARD_ROOT in the app/CMakeLists.txt doesn't work.
-west build -- \
-  -DBOARD_ROOT="${PROJECT_ROOT}" \
-  -DDTS_ROOT="${PROJECT_ROOT}" \
-  -DZEPHYR_EXTRA_MODULES="${PROJECT_ROOT}"
+if [ ! -z "${OPENOCD}" ]; then
+  west build -- \
+    -DOPENOCD="${OPENOCD}" \
+    -DOPENOCD_DEFAULT_PATH="${OPENOCD_DEFAULT_PATH}" \
+    -DZEPHYR_EXTRA_MODULES="${PROJECT_ROOT}"
+else
+  west build -- \
+    -DZEPHYR_EXTRA_MODULES="${PROJECT_ROOT}"
+fi

dev-flash.sh

@@ -1,5 +1,6 @@
 #!/bin/sh
 set -e
+export DEBUG
 PROJECT_ROOT="$(cd "$(dirname "$0")"; pwd)"
 source "${PROJECT_ROOT}/.env.sh"
 if [ ! -e "${PROJECT_ROOT}/app/build" ]; then

dev-init.sh

@@ -1,5 +1,6 @@
 #!/bin/sh
 set -e
+export DEBUG
 PROJECT_ROOT="$(cd "$(dirname "$0")"; pwd)"
 source "${PROJECT_ROOT}/.env.sh"
 cd "${PROJECT_ROOT}"