Skip to content

Commit 3bae2f5

Browse files
v1.11.0 release (#1703)
* add 1.11.0 release changelog * fix walkthrough troubleshooting link * fix lint * add constraints to check py reqs functions * fix serial port detect * fix side nav header navigation * dispose confserver on kconfig menus changes * fix search by choice option menuconfig * fix menuconfig ui margins * fix build continue flag * fix vertical gap title size * mv articles fetch initArgs add buildFlashMonitor before debug option * fix lint * update padding for menuconfig sub items * rm axios ref navigator webpack * fix doc changes, clean blog console logs * add troubleshoot missing doc * fix erase flash task not running * clear task array for dispose end monitor after debug session * rm unused imports * add single task per task id * fix lint * try using resolveDebugConfigurationWithSubstitutedVariables * add erase flash jtag * rm closing openOCD after jtag flash * accept empty response for jtag erase flash * fix lint * Confserver v3 support (#1713) * add support for reset menus and configs also reset all * fix reset all validation menuconfig panel * silent idf size output spawn process
1 parent 52bb368 commit 3bae2f5

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

53 files changed

+1454
-685
lines changed

CHANGELOG.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,59 @@
88

99
All notable changes to the "Espressif IDF" extension will be documented in this file.
1010

11+
## [1.11.0](https://github.com/espressif/vscode-esp-idf-extension/releases/tag/v1.11.0)
12+
13+
## Features and enhancements
14+
15+
- [Add DevKits support](https://github.com/espressif/vscode-esp-idf-extension/pull/1557)
16+
- [Add gitignore on project creation](https://github.com/espressif/vscode-esp-idf-extension/pull/1578)
17+
- [Pre-Release branch docs](https://github.com/espressif/vscode-esp-idf-extension/pull/1599)
18+
- [Modify event activation for file types](https://github.com/espressif/vscode-esp-idf-extension/pull/1568)
19+
- [Add classic menuconfig in Editor Panel](https://github.com/espressif/vscode-esp-idf-extension/pull/1598)
20+
- [Update webviews to VS Code UI Style](https://github.com/espressif/vscode-esp-idf-extension/pull/1554)
21+
- [Allow customize Pytest glob pattern and unit test services](https://github.com/espressif/vscode-esp-idf-extension/pull/1593)
22+
- [CLang install prompt if not installed](https://github.com/espressif/vscode-esp-idf-extension/pull/1615)
23+
- [Allow additional files and directories for Full Clean commands](https://github.com/espressif/vscode-esp-idf-extension/pull/1613)
24+
- [Extend JTAG flash arguments as configuration setting](https://github.com/espressif/vscode-esp-idf-extension/pull/1583)
25+
- [Range support for downloads in Setup Wizard](https://github.com/espressif/vscode-esp-idf-extension/pull/1625)
26+
- [Check OpenOCD is running before debug is launched](https://github.com/espressif/vscode-esp-idf-extension/pull/1638)
27+
- [Add function names in Disassembly view](https://github.com/espressif/vscode-esp-idf-extension/pull/1634)
28+
- [OpenOCD Hints in Hints Viewer](https://github.com/espressif/vscode-esp-idf-extension/pull/1476)
29+
- [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)
30+
- [Pre-release campaign notification](https://github.com/espressif/vscode-esp-idf-extension/pull/1643)
31+
- [Prefer gdbinit prefix_map with fallback to prefix_map_gdbinit](https://github.com/espressif/vscode-esp-idf-extension/pull/1660)
32+
- [AI Integration with Copilot Chat using Language Tool API](https://github.com/espressif/vscode-esp-idf-extension/pull/1621)
33+
- [Allow customize PyPi Index URL in setup wizard](https://github.com/espressif/vscode-esp-idf-extension/pull/1692)
34+
- [Add create empty project command](https://github.com/espressif/vscode-esp-idf-extension/pull/1698)
35+
- [Add Unity Runner and Parser, Remove Pytest](https://github.com/espressif/vscode-esp-idf-extension/pull/1681)
36+
37+
38+
### Bug Fixes
39+
40+
- [Update disassemble screenshot](https://github.com/espressif/vscode-esp-idf-extension/pull/1588)
41+
- [JTAG acronym issues](https://github.com/espressif/vscode-esp-idf-extension/pull/1604)
42+
- [Fix IDF_TARGET in multiple project configuration profiles](https://github.com/espressif/vscode-esp-idf-extension/pull/1579)
43+
- [Fix Partial encryption in encrypted flashing](https://github.com/espressif/vscode-esp-idf-extension/pull/1373)
44+
- [Close OpenOCD after JTAG flash end](https://github.com/espressif/vscode-esp-idf-extension/pull/1601)
45+
- [NodeJS 20 in CI](https://github.com/espressif/vscode-esp-idf-extension/pull/1611)
46+
- [Update build message](https://github.com/espressif/vscode-esp-idf-extension/pull/1603)
47+
- [Fix append git and pigweed to PATH instead of prepend](https://github.com/espressif/vscode-esp-idf-extension/pull/1614)
48+
- [Use latest in master in docs](https://github.com/espressif/vscode-esp-idf-extension/pull/1636)
49+
- [Fix fileExists check in Setup panel](https://github.com/espressif/vscode-esp-idf-extension/pull/1609) Thanks @jonsambro !
50+
- [Use mon program_esp instead of load for Symbol loading in debug](https://github.com/espressif/vscode-esp-idf-extension/pull/1556) Thanks @wormyrocks !
51+
- [Move Status bar items to the left](https://github.com/espressif/vscode-esp-idf-extension/pull/1626)
52+
- [Fix set target preview targets](https://github.com/espressif/vscode-esp-idf-extension/pull/1652)
53+
- [Fix App trace and Heap Trace](https://github.com/espressif/vscode-esp-idf-extension/pull/1656)
54+
- [Setup wizard misleading idf.py not found message fix](https://github.com/espressif/vscode-esp-idf-extension/pull/1642)
55+
- [Clang and OpenOCD in PATH validation](https://github.com/espressif/vscode-esp-idf-extension/pull/1666)
56+
- [Telemetry issues bugfixes](https://github.com/espressif/vscode-esp-idf-extension/pull/1675)
57+
- [Fix openOCDRulesPath in addOpenOCDRules](https://github.com/espressif/vscode-esp-idf-extension/pull/1685)
58+
- [Add contrainsts in pytest install step](https://github.com/espressif/vscode-esp-idf-extension/pull/1686)
59+
- [Add double quoutes around gdbinit file path](https://github.com/espressif/vscode-esp-idf-extension/pull/1684)
60+
61+
62+
63+
1164
## [1.10.1](https://github.com/espressif/vscode-esp-idf-extension/releases/tag/v1.10.1)
1265

1366
## Features and enhancements

docs/TROUBLESHOOTING.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Documentation has moved to:
2+
3+
# [English](https://docs.espressif.com/projects/vscode-esp-idf-extension/en/latest/troubleshooting.html)
4+
5+
# 文档已移至
6+
7+
# [中文](https://docs.espressif.com/projects/vscode-esp-idf-extension/zh_CN/latest/troubleshooting.html)

docs_espressif/en/debugproject.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,7 @@ You can modify the configuration to suit your needs. Let's describe the configur
144144

145145
Some additional arguments you might use are:
146146

147+
- ``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``).
147148
- ``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.
148149
- ``runOpenOCD``: (Default: true). Run extension OpenOCD Server.
149150
- ``verifyAppBinBeforeDebug``: (Default: false) Verify that current ESP-IDF project binary is the same as binary in chip.

docs_espressif/zh_CN/debugproject.rst

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,110 @@
8989
9090
其中 ``0x20000`` 是分区表中使用的应用程序镜像偏移量。
9191

92+
调试配置
93+
--------
94+
95+
要配置调试会话,请打开项目的 ``.vscode/launch.json`` 文件。此文件包含调试会话的配置。默认配置如下:
96+
97+
.. code-block:: JSON
98+
99+
{
100+
"configurations": [
101+
{
102+
"type": "gdbtarget",
103+
"request": "attach",
104+
"name": "Eclipse CDT GDB Adapter"
105+
}
106+
]
107+
}
108+
109+
你可以根据需要修改配置。以下是配置选项的说明:
110+
111+
- ``type``: 调试配置的类型。应设置为 ``gdbtarget``。
112+
- ``program``: 项目构建目录中的 ELF 文件,用于执行调试会话。可以使用命令 ``${command:espIdf.getProjectName}`` 查询扩展以查找当前构建目录的项目名称。
113+
- ``initCommands``: 用于初始化 GDB 和目标设备的 GDB 命令。默认值为 ``["set remote hardware-watchpoint-limit IDF_TARGET_CPU_WATCHPOINT_NUM", "mon reset halt", "maintenance flush register-cache"]``。
114+
- ``initialBreakpoint``: 当未定义 ``initCommands`` 时,此命令将在默认 ``initCommands`` 中添加指定函数名的硬件断点。例如 app_main(默认值)将在默认 initCommands 中添加 ``thb app_main``。如果设置为 ""(空字符串),则不会设置初始断点;如果未定义,则使用默认值 thb app_main。
115+
- ``gdb``: 要使用的 GDB 可执行文件。默认情况下,"${command:espIdf.getToolchainGdb}" 将查询扩展以查找当前 ESP-IDF 项目的 IDF_TARGET(esp32、esp32c6 等)对应的 ESP-IDF 工具链 GDB。
116+
117+
.. note::
118+
**IDF_TARGET_CPU_WATCHPOINT_NUM** 由扩展根据当前 ESP-IDF 项目的 ``IDF_TARGET`` (esp32、esp32c6 等)解析。
119+
120+
你可能使用的其他参数包括:
121+
122+
- ``buildFlashMonitor``: (默认值:false)。在启动调试会话之前构建、烧录并启动 IDF Monitor。使用 ``idf.monitorDelay`` 设置启动监视器后的延迟时间(以毫秒为单位,默认值为 ``1000``)。
123+
- ``debugPort``: (默认值:43476)启动 Eclipse CDT GDB 调试适配器服务器的端口。如果未指定,将使用默认值 43476。
124+
- ``runOpenOCD``: (默认值:true)。运行扩展 OpenOCD 服务器。
125+
- ``verifyAppBinBeforeDebug``: (默认值:false)验证当前 ESP-IDF 项目二进制文件是否与芯片中的二进制文件相同。
126+
- ``logFile``: 用于记录与 gdb 交互的文件的绝对路径。示例:${workspaceFolder}/gdb.log。
127+
- ``verbose``: 生成详细的日志输出。
128+
- ``environment``: 应用于 ESP-IDF 调试适配器的环境变量。它将替换全局环境变量和扩展使用的环境变量。
129+
130+
.. code-block:: JSON
131+
132+
{
133+
"environment": {
134+
"VAR": "Value"
135+
}
136+
}
137+
138+
- ``imageAndSymbols`` :
139+
140+
.. code-block:: JSON
141+
142+
{
143+
"imageAndSymbols": {
144+
"symbolFileName": "如果指定,则在给定(可选)偏移量处加载的符号文件",
145+
"symbolOffset": "如果指定了 symbolFileName,则使用的偏移量",
146+
"imageFileName": "如果指定,则在给定(可选)偏移量处加载的镜像文件",
147+
"imageOffset": "如果指定了 imageFileName,则使用的偏移量"
148+
}
149+
}
150+
151+
- ``target``: 要附加的目标配置。指定如何连接到要调试的设备。通常 OpenOCD 将芯片作为端口 3333 上的远程目标公开。
152+
153+
.. code-block:: JSON
154+
155+
{
156+
"target": {
157+
"type": "要执行的目标调试类型。传递给 -target-select(默认为 remote)",
158+
"host": "要连接的目标主机(默认为 'localhost',如果设置了 parameters 则忽略)",
159+
"port": "要连接的目标端口(默认为 serverPortRegExp 捕获的值,如果设置了 parameters 则忽略)",
160+
"parameters": "目标类型的目标参数。通常是类似 localhost:12345 的内容。(默认为 `${host}:${port}`)",
161+
"connectCommands": "替换所有先前的参数,指定用于建立连接的命令数组"
162+
}
163+
}
164+
165+
下面显示了一个修改后的 launch.json 文件示例:
166+
167+
.. code-block:: JSON
168+
169+
{
170+
"configurations": [
171+
{
172+
"type": "gdbtarget",
173+
"request": "attach",
174+
"name": "Eclipse CDT GDB Adapter",
175+
"program": "${workspaceFolder}/build/${command:espIdf.getProjectName}.elf",
176+
"initCommands": [
177+
"set remote hardware-watchpoint-limit IDF_TARGET_CPU_WATCHPOINT_NUM",
178+
"mon reset halt",
179+
"maintenance flush register-cache"
180+
],
181+
"gdb": "${command:espIdf.getToolchainGdb}",
182+
"target": {
183+
"connectCommands": [
184+
"set remotetimeout 20",
185+
"-target-select extended-remote localhost:3333"
186+
]
187+
}
188+
}
189+
]
190+
}
191+
192+
虽然前面的示例明确使用了默认值,但可以根据需要进行自定义。
193+
194+
ESP-IDF VS Code 扩展的 package.json gdbtarget 调试器贡献中记录了其他较少使用的参数。
195+
92196
浏览代码、调用栈和线程
93197
----------------------
94198

l10n/bundle.l10n.es.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@
4242
"ESP-Matter Python Requirements have been installed": "Se han instalado los requisitos de ESP-Matter Python",
4343
"PyTest python packages are already installed.": "Los paquetes de Python de PyTest ya están instalados.",
4444
"ESP-IDF: Building unit test app and flashing": "ESP-IDF: aplicación de prueba unitaria de construcción y flasheo",
45+
"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.",
4546
"ESP-IDF vscode files have been added to the project.": "Se han agregado archivos ESP-IDF vscode al proyecto.",
4647
"ESP-IDF container files have been added to the project.": "Se han agregado archivos contenedores ESP-IDF al proyecto.",
4748
"Enter ESP-IDF component name": "Ingrese el nombre del componente ESP-IDF",
@@ -267,5 +268,6 @@
267268
"Learn More": "Más información",
268269
"Not Now": "Ahora no",
269270
"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'.",
270-
"Got it": "Entendido"
271+
"Got it": "Entendido",
272+
"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."
271273
}

l10n/bundle.l10n.pt.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@
4242
"ESP-Matter Python Requirements have been installed": "Os requisitos do ESP-Matter Python foram instalados",
4343
"PyTest python packages are already installed.": "Os pacotes PyTest python já estão instalados.",
4444
"ESP-IDF: Building unit test app and flashing": "ESP-IDF: Construindo aplicativo de teste de unidade e flashing",
45+
"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.",
4546
"ESP-IDF vscode files have been added to the project.": "Arquivos ESP-IDF vscode foram adicionados ao projeto.",
4647
"ESP-IDF container files have been added to the project.": "Arquivos contêiner ESP-IDF foram adicionados ao projeto.",
4748
"Enter ESP-IDF component name": "Insira o nome do componente ESP-IDF",
@@ -268,5 +269,6 @@
268269
"Learn More": "Saiba mais",
269270
"Not Now": "Agora não",
270271
"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'.",
271-
"Got it": "Entendi"
272+
"Got it": "Entendi",
273+
"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."
272274
}

l10n/bundle.l10n.ru.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@
4242
"ESP-Matter Python Requirements have been installed": "Требования Python ESP-Matter установлены",
4343
"PyTest python packages are already installed.": "Пакеты Python PyTest уже установлены.",
4444
"ESP-IDF: Building unit test app and flashing": "ESP-IDF: создание приложения модульного тестирования и перепрошивка",
45+
"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 включено шифрование флэш-памяти или безопасная загрузка. Стирание флэш-памяти приведет к безвозвратному удалению ключей шифрования и может сделать устройство непригодным для использования.",
4546
"ESP-IDF vscode files have been added to the project.": "В проект добавлены файлы ESP-IDF vscode.",
4647
"ESP-IDF container files have been added to the project.": "В проект добавлены файлы-контейнеры ESP-IDF.",
4748
"Enter ESP-IDF component name": "Введите имя компонента ESP-IDF",
@@ -268,5 +269,6 @@
268269
"Learn More": "Узнать больше",
269270
"Not Now": "Не сейчас",
270271
"To install the pre-release version, click the 'Switch to Pre-Release Version' button.": "Для установки предварительной версии нажмите кнопку 'Переключиться на предварительную версию'.",
271-
"Got it": "Понятно"
272+
"Got it": "Понятно",
273+
"Flash encryption or secure boot is enabled on the device. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "На устройстве включено шифрование флэш-памяти или безопасная загрузка. Стирание флэш-памяти приведет к безвозвратному удалению ключей шифрования и может сделать устройство непригодным для использования."
272274
}

l10n/bundle.l10n.zh-CN.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@
4242
"ESP-Matter Python Requirements have been installed": "已安装 ESP-Matter Python 依赖包",
4343
"PyTest python packages are already installed.": "已安装 PyTest Python 包。",
4444
"ESP-IDF: Building unit test app and flashing": "ESP-IDF:正在构建并烧录单元测试应用程序",
45+
"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 上已启用闪存加密或安全启动。擦除闪存将永久删除加密密钥,可能导致设备无法使用。",
4546
"ESP-IDF vscode files have been added to the project.": "ESP-IDF VS Code 文件已添加到项目中。",
4647
"ESP-IDF container files have been added to the project.": "ESP-IDF 容器文件已添加到项目中。",
4748
"Enter ESP-IDF component name": "输入 ESP-IDF 组件名称",
@@ -268,5 +269,6 @@
268269
"Learn More": "了解更多",
269270
"Not Now": "暂不使用",
270271
"To install the pre-release version, click the 'Switch to Pre-Release Version' button.": "要安装预发布版本,请点击\"切换到预发布版本\"按钮。",
271-
"Got it": "知道了"
272+
"Got it": "知道了",
273+
"Flash encryption or secure boot is enabled on the device. Erasing flash will permanently remove the encryption keys and may render the device unusable.": "设备上已启用闪存加密或安全启动。擦除闪存将永久删除加密密钥,可能导致设备无法使用。"
272274
}

package.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1949,6 +1949,11 @@
19491949
"description": "Port for Debug Adapter server. Default: 43476",
19501950
"default": 43476
19511951
},
1952+
"buildFlashMonitor": {
1953+
"type": "boolean",
1954+
"description": "Build, Flash and Monitor the device before debugging",
1955+
"default": false
1956+
},
19521957
"runOpenOCD": {
19531958
"type": "boolean",
19541959
"description": "Run OpenOCD Server",
@@ -2223,6 +2228,11 @@
22232228
"description": "Port for Debug Adapter server. Default: 43476",
22242229
"default": 43476
22252230
},
2231+
"buildFlashMonitor": {
2232+
"type": "boolean",
2233+
"description": "Build, Flash and Monitor the device before debugging",
2234+
"default": false
2235+
},
22262236
"runOpenOCD": {
22272237
"type": "boolean",
22282238
"description": "Run OpenOCD Server",

src/build/buildCmd.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -185,8 +185,8 @@ export async function buildCommand(
185185
false
186186
);
187187
}
188+
continueFlag = false;
188189
}
189-
continueFlag = false;
190190
return continueFlag;
191191
}
192192

0 commit comments

Comments
 (0)