v1.11.0 release

CHANGELOG.md

@@ -8,6 +8,59 @@
 
 All notable changes to the "Espressif IDF" extension will be documented in this file.
 
+## [1.11.0](https://github.com/espressif/vscode-esp-idf-extension/releases/tag/v1.11.0)
+
+## Features and enhancements
+
+- [Add DevKits support](https://github.com/espressif/vscode-esp-idf-extension/pull/1557)
+- [Add gitignore on project creation](https://github.com/espressif/vscode-esp-idf-extension/pull/1578)
+- [Pre-Release branch docs](https://github.com/espressif/vscode-esp-idf-extension/pull/1599)
+- [Modify event activation for file types](https://github.com/espressif/vscode-esp-idf-extension/pull/1568)
+- [Add classic menuconfig in Editor Panel](https://github.com/espressif/vscode-esp-idf-extension/pull/1598)
+- [Update webviews to VS Code UI Style](https://github.com/espressif/vscode-esp-idf-extension/pull/1554)
+- [Allow customize Pytest glob pattern and unit test services](https://github.com/espressif/vscode-esp-idf-extension/pull/1593)
+- [CLang install prompt if not installed](https://github.com/espressif/vscode-esp-idf-extension/pull/1615)
+- [Allow additional files and directories for Full Clean commands](https://github.com/espressif/vscode-esp-idf-extension/pull/1613)
+- [Extend JTAG flash arguments as configuration setting](https://github.com/espressif/vscode-esp-idf-extension/pull/1583)
+- [Range support for downloads in Setup Wizard](https://github.com/espressif/vscode-esp-idf-extension/pull/1625)
+- [Check OpenOCD is running before debug is launched](https://github.com/espressif/vscode-esp-idf-extension/pull/1638)
+- [Add function names in Disassembly view](https://github.com/espressif/vscode-esp-idf-extension/pull/1634)
+- [OpenOCD Hints in Hints Viewer](https://github.com/espressif/vscode-esp-idf-extension/pull/1476)
+- [Add detect as default serial port option and use esptool.py to find serial port](https://github.com/espressif/vscode-esp-idf-extension/pull/1632)
+- [Pre-release campaign notification](https://github.com/espressif/vscode-esp-idf-extension/pull/1643)
+- [Prefer gdbinit prefix_map with fallback to prefix_map_gdbinit](https://github.com/espressif/vscode-esp-idf-extension/pull/1660)
+- [AI Integration with Copilot Chat using Language Tool API](https://github.com/espressif/vscode-esp-idf-extension/pull/1621)
+- [Allow customize PyPi Index URL in setup wizard](https://github.com/espressif/vscode-esp-idf-extension/pull/1692)
+- [Add create empty project command](https://github.com/espressif/vscode-esp-idf-extension/pull/1698)
+- [Add Unity Runner and Parser, Remove Pytest](https://github.com/espressif/vscode-esp-idf-extension/pull/1681)
+
+
+### Bug Fixes
+
+- [Update disassemble screenshot](https://github.com/espressif/vscode-esp-idf-extension/pull/1588)
+- [JTAG acronym issues](https://github.com/espressif/vscode-esp-idf-extension/pull/1604)
+- [Fix IDF_TARGET in multiple project configuration profiles](https://github.com/espressif/vscode-esp-idf-extension/pull/1579)
+- [Fix Partial encryption in encrypted flashing](https://github.com/espressif/vscode-esp-idf-extension/pull/1373)
+- [Close OpenOCD after JTAG flash end](https://github.com/espressif/vscode-esp-idf-extension/pull/1601)
+- [NodeJS 20 in CI](https://github.com/espressif/vscode-esp-idf-extension/pull/1611)
+- [Update build message](https://github.com/espressif/vscode-esp-idf-extension/pull/1603)
+- [Fix append git and pigweed to PATH instead of prepend](https://github.com/espressif/vscode-esp-idf-extension/pull/1614)
+- [Use latest in master in docs](https://github.com/espressif/vscode-esp-idf-extension/pull/1636)
+- [Fix fileExists check in Setup panel](https://github.com/espressif/vscode-esp-idf-extension/pull/1609) Thanks @jonsambro !
+- [Use mon program_esp instead of load for Symbol loading in debug](https://github.com/espressif/vscode-esp-idf-extension/pull/1556) Thanks @wormyrocks !
+- [Move Status bar items to the left](https://github.com/espressif/vscode-esp-idf-extension/pull/1626)
+- [Fix set target preview targets](https://github.com/espressif/vscode-esp-idf-extension/pull/1652)
+- [Fix App trace and Heap Trace](https://github.com/espressif/vscode-esp-idf-extension/pull/1656)
+- [Setup wizard  misleading idf.py not found message fix](https://github.com/espressif/vscode-esp-idf-extension/pull/1642)
+- [Clang and OpenOCD in PATH validation](https://github.com/espressif/vscode-esp-idf-extension/pull/1666)
+- [Telemetry issues bugfixes](https://github.com/espressif/vscode-esp-idf-extension/pull/1675)
+- [Fix openOCDRulesPath in addOpenOCDRules](https://github.com/espressif/vscode-esp-idf-extension/pull/1685)
+- [Add contrainsts in pytest install step](https://github.com/espressif/vscode-esp-idf-extension/pull/1686)
+- [Add double quoutes around gdbinit file path](https://github.com/espressif/vscode-esp-idf-extension/pull/1684)
+
+
+
+
 ## [1.10.1](https://github.com/espressif/vscode-esp-idf-extension/releases/tag/v1.10.1)
 
 ## Features and enhancements

docs/TROUBLESHOOTING.md

@@ -0,0 +1,7 @@
+# Documentation has moved to:
+
+# [English](https://docs.espressif.com/projects/vscode-esp-idf-extension/en/latest/troubleshooting.html)
+
+# 文档已移至
+
+# [中文](https://docs.espressif.com/projects/vscode-esp-idf-extension/zh_CN/latest/troubleshooting.html)

docs_espressif/en/debugproject.rst

@@ -144,6 +144,7 @@ You can modify the configuration to suit your needs. Let's describe the configur
 
 Some additional arguments you might use are:
 
+- ``buildFlashMonitor``: (Default: false). Build, flash and launch IDF Monitor before starting the debug session. Use ``idf.monitorDelay`` to set a delay, in milliseconds, after starting the monitor (Default is ``1000``).
 - ``debugPort``: (Default: 43476) The port to launch the Eclipse CDT GDB Debug Adapter server. If not specified, it will use the default value of 43476.
 - ``runOpenOCD``: (Default: true). Run extension OpenOCD Server.
 - ``verifyAppBinBeforeDebug``: (Default: false) Verify that current ESP-IDF project binary is the same as binary in chip.

docs_espressif/zh_CN/debugproject.rst

@@ -89,6 +89,110 @@
 
 其中 ``0x20000`` 是分区表中使用的应用程序镜像偏移量。
 
+调试配置
+--------
+
+要配置调试会话，请打开项目的 ``.vscode/launch.json`` 文件。此文件包含调试会话的配置。默认配置如下：
+
+.. code-block:: JSON
+
+    {
+        "configurations": [
+            {
+                "type": "gdbtarget",
+                "request": "attach",
+                "name": "Eclipse CDT GDB Adapter"
+            }
+        ]
+    }
+
+你可以根据需要修改配置。以下是配置选项的说明：
+
+- ``type``: 调试配置的类型。应设置为 ``gdbtarget``。
+- ``program``: 项目构建目录中的 ELF 文件，用于执行调试会话。可以使用命令 ``${command:espIdf.getProjectName}`` 查询扩展以查找当前构建目录的项目名称。
+- ``initCommands``: 用于初始化 GDB 和目标设备的 GDB 命令。默认值为 ``["set remote hardware-watchpoint-limit IDF_TARGET_CPU_WATCHPOINT_NUM", "mon reset halt", "maintenance flush register-cache"]``。
+- ``initialBreakpoint``: 当未定义 ``initCommands`` 时，此命令将在默认 ``initCommands`` 中添加指定函数名的硬件断点。例如 app_main（默认值）将在默认 initCommands 中添加 ``thb app_main``。如果设置为 ""（空字符串），则不会设置初始断点；如果未定义，则使用默认值 thb app_main。
+- ``gdb``: 要使用的 GDB 可执行文件。默认情况下，"${command:espIdf.getToolchainGdb}" 将查询扩展以查找当前 ESP-IDF 项目的 IDF_TARGET（esp32、esp32c6 等）对应的 ESP-IDF 工具链 GDB。
+
+.. note::
+     **IDF_TARGET_CPU_WATCHPOINT_NUM** 由扩展根据当前 ESP-IDF 项目的 ``IDF_TARGET`` （esp32、esp32c6 等）解析。
+
+你可能使用的其他参数包括：
+
+- ``buildFlashMonitor``: （默认值：false）。在启动调试会话之前构建、烧录并启动 IDF Monitor。使用 ``idf.monitorDelay`` 设置启动监视器后的延迟时间（以毫秒为单位，默认值为 ``1000``）。
+- ``debugPort``: （默认值：43476）启动 Eclipse CDT GDB 调试适配器服务器的端口。如果未指定，将使用默认值 43476。
+- ``runOpenOCD``: （默认值：true）。运行扩展 OpenOCD 服务器。
+- ``verifyAppBinBeforeDebug``: （默认值：false）验证当前 ESP-IDF 项目二进制文件是否与芯片中的二进制文件相同。
+- ``logFile``: 用于记录与 gdb 交互的文件的绝对路径。示例：${workspaceFolder}/gdb.log。
+- ``verbose``: 生成详细的日志输出。
+- ``environment``: 应用于 ESP-IDF 调试适配器的环境变量。它将替换全局环境变量和扩展使用的环境变量。
+
+.. code-block:: JSON
+
+    {
+        "environment": {
+            "VAR": "Value"
+        }
+    }
+
+- ``imageAndSymbols`` :
+
+.. code-block:: JSON
+
+    {
+        "imageAndSymbols": {
+            "symbolFileName": "如果指定，则在给定（可选）偏移量处加载的符号文件",
+            "symbolOffset": "如果指定了 symbolFileName，则使用的偏移量",
+            "imageFileName": "如果指定，则在给定（可选）偏移量处加载的镜像文件",
+            "imageOffset": "如果指定了 imageFileName，则使用的偏移量"
+        }
+    }
+
+- ``target``: 要附加的目标配置。指定如何连接到要调试的设备。通常 OpenOCD 将芯片作为端口 3333 上的远程目标公开。
+
+.. code-block:: JSON
+
+    {
+        "target": {
+            "type": "要执行的目标调试类型。传递给 -target-select（默认为 remote）",
+            "host": "要连接的目标主机（默认为 'localhost'，如果设置了 parameters 则忽略）",
+            "port": "要连接的目标端口（默认为 serverPortRegExp 捕获的值，如果设置了 parameters 则忽略）",
+            "parameters": "目标类型的目标参数。通常是类似 localhost:12345 的内容。（默认为 `${host}:${port}`）",
+            "connectCommands": "替换所有先前的参数，指定用于建立连接的命令数组"
+        }
+    }
+
+下面显示了一个修改后的 launch.json 文件示例：
+
+.. code-block:: JSON
+
+    {
+        "configurations": [
+            {
+                "type": "gdbtarget",
+                "request": "attach",
+                "name": "Eclipse CDT GDB Adapter",
+                "program": "${workspaceFolder}/build/${command:espIdf.getProjectName}.elf",
+                "initCommands": [
+                    "set remote hardware-watchpoint-limit IDF_TARGET_CPU_WATCHPOINT_NUM",
+                    "mon reset halt",
+                    "maintenance flush register-cache"
+                ],
+                "gdb": "${command:espIdf.getToolchainGdb}",
+                "target": {
+                    "connectCommands": [
+                        "set remotetimeout 20",
+                        "-target-select extended-remote localhost:3333"
+                    ]
+                }
+            }
+        ]
+    }
+
+虽然前面的示例明确使用了默认值，但可以根据需要进行自定义。
+
+ESP-IDF VS Code 扩展的 package.json gdbtarget 调试器贡献中记录了其他较少使用的参数。
+
 浏览代码、调用栈和线程
 ----------------------
 

l10n/bundle.l10n.es.json

@@ -39,6 +39,7 @@
   "ESP-Matter Python Requirements have been installed": "Se han instalado los requisitos de ESP-Matter Python",
   "PyTest python packages are already installed.": "Los paquetes de Python de PyTest ya están instalados.",
   "ESP-IDF: Building unit test app and flashing": "ESP-IDF: aplicación de prueba unitaria de construcción y flasheo",
+  "Flash encryption or secure boot is enabled on the sdkconfig. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "El cifrado de flash o el arranque seguro está habilitado en el sdkconfig. Borrar el flash eliminará permanentemente las claves de cifrado y puede inutilizar el dispositivo.",
   "ESP-IDF vscode files have been added to the project.": "Se han agregado archivos ESP-IDF vscode al proyecto.",
   "ESP-IDF container files have been added to the project.": "Se han agregado archivos contenedores ESP-IDF al proyecto.",
   "Enter ESP-IDF component name": "Ingrese el nombre del componente ESP-IDF",
@@ -264,5 +265,6 @@
   "Learn More": "Más información",
   "Not Now": "Ahora no",
   "To install the pre-release version, click the 'Switch to Pre-Release Version' button.": "Para instalar la versión preliminar, haga clic en el botón 'Cambiar a versión preliminar'.",
-  "Got it": "Entendido"
+  "Got it": "Entendido",
+  "Flash encryption or secure boot is enabled on the device. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "El cifrado de flash o el arranque seguro está habilitado en el dispositivo. Borrar el flash eliminará permanentemente las claves de cifrado y puede inutilizar el dispositivo."
 }

l10n/bundle.l10n.pt.json

@@ -39,6 +39,7 @@
   "ESP-Matter Python Requirements have been installed": "Os requisitos do ESP-Matter Python foram instalados",
   "PyTest python packages are already installed.": "Os pacotes PyTest python já estão instalados.",
   "ESP-IDF: Building unit test app and flashing": "ESP-IDF: Construindo aplicativo de teste de unidade e flashing",
+  "Flash encryption or secure boot is enabled on the sdkconfig. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "A criptografia de flash ou inicialização segura está ativada no sdkconfig. Apagar o flash removerá permanentemente as chaves de criptografia e pode tornar o dispositivo inutilizável.",
   "ESP-IDF vscode files have been added to the project.": "Arquivos ESP-IDF vscode foram adicionados ao projeto.",
   "ESP-IDF container files have been added to the project.": "Arquivos contêiner ESP-IDF foram adicionados ao projeto.",
   "Enter ESP-IDF component name": "Insira o nome do componente ESP-IDF",
@@ -265,5 +266,6 @@
   "Learn More": "Saiba mais",
   "Not Now": "Agora não",
   "To install the pre-release version, click the 'Switch to Pre-Release Version' button.": "Para instalar a versão pré-lançamento, clique no botão 'Alternar para versão pré-lançamento'.",
-  "Got it": "Entendi"
+  "Got it": "Entendi",
+  "Flash encryption or secure boot is enabled on the device. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "A criptografia de flash ou inicialização segura está ativada no dispositivo. Apagar o flash removerá permanentemente as chaves de criptografia e pode tornar o dispositivo inutilizável."
 }

l10n/bundle.l10n.ru.json

@@ -39,6 +39,7 @@
   "ESP-Matter Python Requirements have been installed": "Требования Python ESP-Matter установлены",
   "PyTest python packages are already installed.": "Пакеты Python PyTest уже установлены.",
   "ESP-IDF: Building unit test app and flashing": "ESP-IDF: создание приложения модульного тестирования и перепрошивка",
+  "Flash encryption or secure boot is enabled on the sdkconfig. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "На sdkconfig включено шифрование флэш-памяти или безопасная загрузка. Стирание флэш-памяти приведет к безвозвратному удалению ключей шифрования и может сделать устройство непригодным для использования.",
   "ESP-IDF vscode files have been added to the project.": "В проект добавлены файлы ESP-IDF vscode.",
   "ESP-IDF container files have been added to the project.": "В проект добавлены файлы-контейнеры ESP-IDF.",
   "Enter ESP-IDF component name": "Введите имя компонента ESP-IDF",
@@ -265,5 +266,6 @@
   "Learn More": "Узнать больше",
   "Not Now": "Не сейчас",
   "To install the pre-release version, click the 'Switch to Pre-Release Version' button.": "Для установки предварительной версии нажмите кнопку 'Переключиться на предварительную версию'.",
-  "Got it": "Понятно"
+  "Got it": "Понятно",
+  "Flash encryption or secure boot is enabled on the device. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "На устройстве включено шифрование флэш-памяти или безопасная загрузка. Стирание флэш-памяти приведет к безвозвратному удалению ключей шифрования и может сделать устройство непригодным для использования."
 }

l10n/bundle.l10n.zh-CN.json

@@ -39,6 +39,7 @@
   "ESP-Matter Python Requirements have been installed": "已安装 ESP-Matter Python 依赖包",
   "PyTest python packages are already installed.": "已安装 PyTest Python 包。",
   "ESP-IDF: Building unit test app and flashing": "ESP-IDF：正在构建并烧录单元测试应用程序",
+  "Flash encryption or secure boot is enabled on the sdkconfig. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "sdkconfig 上已启用闪存加密或安全启动。擦除闪存将永久删除加密密钥，可能导致设备无法使用。",
   "ESP-IDF vscode files have been added to the project.": "ESP-IDF VS Code 文件已添加到项目中。",
   "ESP-IDF container files have been added to the project.": "ESP-IDF 容器文件已添加到项目中。",
   "Enter ESP-IDF component name": "输入 ESP-IDF 组件名称",
@@ -265,5 +266,6 @@
   "Learn More": "了解更多",
   "Not Now": "暂不使用",
   "To install the pre-release version, click the 'Switch to Pre-Release Version' button.": "要安装预发布版本，请点击\"切换到预发布版本\"按钮。",
-  "Got it": "知道了"
+  "Got it": "知道了",
+  "Flash encryption or secure boot is enabled on the device. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "设备上已启用闪存加密或安全启动。擦除闪存将永久删除加密密钥，可能导致设备无法使用。"
 }

package.json

@@ -1943,6 +1943,11 @@
                 "description": "Port for Debug Adapter server. Default: 43476",
                 "default": 43476
               },
+              "buildFlashMonitor": {
+                "type": "boolean",
+                "description": "Build, Flash and Monitor the device before debugging",
+                "default": false
+              },
               "runOpenOCD": {
                 "type": "boolean",
                 "description": "Run OpenOCD Server",
@@ -2217,6 +2222,11 @@
                 "description": "Port for Debug Adapter server. Default: 43476",
                 "default": 43476
               },
+              "buildFlashMonitor": {
+                "type": "boolean",
+                "description": "Build, Flash and Monitor the device before debugging",
+                "default": false
+              },
               "runOpenOCD": {
                 "type": "boolean",
                 "description": "Run OpenOCD Server",

src/build/buildCmd.ts

@@ -185,8 +185,8 @@ export async function buildCommand(
         false
       );
     }
+    continueFlag = false;
   }
-  continueFlag = false;
   return continueFlag;
 }