[VSC-1721] add detect option auto assign serial port, show current selected port (#1632)

* add detect option auto assing serial port, show current selected port

* add missing chip arg to detect option

* add readSerialPort function to read serial port and detect

* fix convertMacOSPortName

* fix serial port not updated in settings

* update only on flash related tasks add update

* add setting to configure detection timeout

* remove await to not block calling function progress

Author: brianignacio5

docs_espressif/en/settings.rst

@@ -120,6 +120,8 @@ These settings are specific to the ESP32 Chip/Board.
       - Enable use of ``idf.usbSerialPortFilters`` list to filter serial port devices list. Scope can only be **Global (User Settings)**.
     * - **idf.usbSerialPortFilters**
       - USB productID and vendorID list to filter known Espressif devices. Scope can only be **Global (User Settings)**.
+    * - **idf.serialPortDetectionTimeout**
+      - Timeout in seconds for serial port detection using esptool.py (Default: 60)
     * - **openocd.jtag.command.force_unix_path_separator**
       - Forced to use ``/`` instead of ``\\`` as path separator for Win32 based OS
     * - **idf.svdFilePath**
@@ -136,6 +138,7 @@ This is how the extension uses them:
 5. **idf.openOcdDebugLevel** is the log level for OpenOCD server output from 0 (error messages only) to 4 (Verbose low-level debug message).
 6. **idf.openOcdLaunchArgs** is the launch arguments string array for OpenOCD. If not defined, the resulting OpenOCD launch command looks like this: ``openocd -d${idf.openOcdDebugLevel} -f ${idf.openOcdConfigs}``.
 7. **idf.jtagFlashCommandExtraArgs** is used for OpenOCD JTAG flash task. Please review `Upload application for debugging <https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/jtag-debugging/index.html#upload-application-for-debugging>`.
+8. **idf.serialPortDetectionTimeout** is the timeout value in seconds used for the **ESP-IDF: Select Port** command when auto-detecting serial ports using esptool.py. This setting allows users to configure how long the extension should wait when scanning for compatible devices on available serial ports.
 
 .. note::
 

docs_espressif/zh_CN/settings.rst

@@ -108,6 +108,8 @@ ESP-IDF 相关设置
       - 启用 ``idf.usbSerialPortFilters`` 列表以过滤串口设备列表
     * - **idf.usbSerialPortFilters**
       - 用于过滤已知乐鑫设备的 USB productID 和 vendorID 列表
+    * - **idf.serialPortDetectionTimeout**
+      - 使用 esptool.py 检测串口时的超时时间（秒）（默认值：60）
     * - **openocd.jtag.command.force_unix_path_separator**
       - 强制在 Windows 操作系统中使用 ``/`` 作为路径分隔符，而不是 ``\\``
     * - **idf.svdFilePath**
@@ -124,6 +126,7 @@ ESP-IDF 相关设置
 5. **idf.openOcdDebugLevel** 是 OpenOCD 服务器输出的日志级别，范围为 0 到 4。
 6. **idf.openOcdLaunchArgs** 是用于配置 OpenOCD 启动的参数字符串数组。生成的 OpenOCD 启动命令格式如下：``openocd -d${idf.openOcdDebugLevel} -f ${idf.openOcdConfigs} ${idf.openOcdLaunchArgs}``。
 7. **idf.jtagFlashCommandExtraArgs** 用于OpenCD JTAG闪存任务。请查看 `上传待调试的应用程序 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/api-guides/jtag-debugging/index.html#jtag-upload-app-debug>`.
+8. **idf.serialPortDetectionTimeout** 是用于 **ESP-IDF：选择端口** 命令的超时值（秒），当使用 esptool.py 自动检测串口时使用。此设置允许用户配置扩展在扫描可用串口上的兼容设备时应等待多长时间。
 
 .. note::
 

l10n/bundle.l10n.es.json

@@ -135,6 +135,9 @@
   "Error encountered while calling idf_size.py": "Error encontrado al llamar a idf_size.py",
   "Select the available serial port where your device is connected.": "Seleccione el puerto serie disponible donde está conectado su dispositivo.",
   "Port has been updated to ": "El puerto ha sido actualizado a ",
+  "No serial port found for current IDF_TARGET: {0}": "No se encontró puerto serie para el IDF_TARGET actual: {0}",
+  "Detecting Espressif device serial port...": "Detectando puerto serie del dispositivo Espressif...",
+  "Auto-detect port (let esptool.py find the device automatically)": "Detección automática de puerto (deja que esptool.py encuentre el dispositivo automáticamente)",
   "{buildFile} doesn't exist. Build first.": "{buildFile} no existe. Compile primero.",
   "SDK Configuration editor": "Editor de configuración del SDK",
   "Save": "Ahorrar",
@@ -201,6 +204,7 @@
   "{0} settings will be removed.": "{0} configuraciones serán eliminadas.",
   "Yes": "Sí",
   "No": "No",
+  "Detect": "Detectar",
   "Starting ESP-IDF settings cleanup...": "Iniciando limpieza de configuraciones ESP-IDF...",
   "Removed {0} setting: {1}": "Configuración {0} eliminada: {1}",
   "Warning: Could not fully remove setting {0}: {1}": "Advertencia: No se pudo eliminar completamente la configuración {0}: {1}",

l10n/bundle.l10n.pt.json

@@ -135,6 +135,9 @@
   "Error encountered while calling idf_size.py": "Erro encontrado ao chamar idf_size.py",
   "Select the available serial port where your device is connected.": "Selecione a porta serial disponível onde seu dispositivo está conectado.",
   "Port has been updated to ": "A porta foi atualizada para ",
+  "No serial port found for current IDF_TARGET: {0}": "Nenhuma porta serial encontrada para o IDF_TARGET atual: {0}",
+  "Detecting Espressif device serial port...": "Detectando porta serial do dispositivo Espressif...",
+  "Auto-detect port (let esptool.py find the device automatically)": "Detectar porta automaticamente (deixe o esptool.py encontrar o dispositivo automaticamente)",
   "{buildFile} doesn't exist. Build first.": "{buildFile} {buildFile} não existe. Crie primeiro.",
   "SDK Configuration editor": "Editor de configuração do SDK",
   "Save": "Salvar",
@@ -202,6 +205,7 @@
   "{0} settings will be removed.": "{0} configurações serão removidas.",
   "Yes": "Sim",
   "No": "Não",
+  "Detect": "Detectar",
   "Starting ESP-IDF settings cleanup...": "Iniciando limpeza das configurações ESP-IDF...",
   "Removed {0} setting: {1}": "Configuração ${0} removida: {1}",
   "Warning: Could not fully remove setting {0}: {1}": "Aviso: Não foi possível remover completamente a configuração {0}: {1}",

l10n/bundle.l10n.ru.json

@@ -135,6 +135,9 @@
   "Error encountered while calling idf_size.py": "Ошибка при вызове idf_size.py",
   "Select the available serial port where your device is connected.": "Выберите доступный последовательный порт, к которому подключено ваше устройство.",
   "Port has been updated to ": "Порт обновлен до ",
+  "No serial port found for current IDF_TARGET: {0}": "Последовательный порт не найден для текущего IDF_TARGET: {0}",
+  "Detecting Espressif device serial port...": "Обнаружение последовательного порта устройства Espressif...",
+  "Auto-detect port (let esptool.py find the device automatically)": "Автоматически определить порт (пусть esptool.py найдет устройство)",
   "{buildFile} doesn't exist. Build first.": "{buildFile} не существует. Сначала выполните сборку.",
   "SDK Configuration editor": "Редактор конфигурации SDK",
   "Save": "Сохранить",
@@ -202,6 +205,7 @@
   "{0} settings will be removed.": "{0} настроек будет удалено.",
   "Yes": "Да",
   "No": "Нет",
+  "Detect": "Обнаружить",
   "Starting ESP-IDF settings cleanup...": "Начинается очистка настроек ESP-IDF...",
   "Removed {0} setting: {1}": "Удалена {0} настройка: {1}",
   "Warning: Could not fully remove setting {0}: {1}": "Предупреждение: Не удалось полностью удалить настройку {0}: {1}",

l10n/bundle.l10n.zh-CN.json

@@ -135,6 +135,9 @@
   "Error encountered while calling idf_size.py": "调用 idf_size.py 时出错",
   "Select the available serial port where your device is connected.": "为设备选择可用的串口。",
   "Port has been updated to ": "端口已更新为 ",
+  "No serial port found for current IDF_TARGET: {0}": "未找到当前 IDF_TARGET 的串口：{0}",
+  "Detecting Espressif device serial port...": "正在检测 Espressif 设备串口...",
+  "Auto-detect port (let esptool.py find the device automatically)": "自动检测端口（让 esptool.py 自动查找设备）",
   "{buildFile} doesn't exist. Build first.": "{buildFile}不存在，请先进行生成。",
   "SDK Configuration editor": "SDK 配置编辑器",
   "Save": "保存",
@@ -202,6 +205,7 @@
   "{0} settings will be removed.": "{0}个设置将被删除。",
   "Yes": "是",
   "No": "否",
+  "Detect": "检测",
   "Starting ESP-IDF settings cleanup...": "正在开始清理ESP-IDF设置...",
   "Removed {0} setting: {1}": "已删除 {0} 设置：{1}",
   "Warning: Could not fully remove setting {0}: {1}": "警告：无法完全删除设置 {0}：{1}",

package.json

@@ -701,13 +701,13 @@
           },
           "idf.port": {
             "type": "string",
-            "default": "/dev/ttyUSB1",
+            "default": "detect",
             "description": "%param.port%",
             "scope": "resource"
           },
           "idf.portWin": {
             "type": "string",
-            "default": "COM1",
+            "default": "detect",
             "description": "%param.port%",
             "scope": "resource"
           },
@@ -1289,6 +1289,12 @@
             "items": {
               "type": "string"
             }
+          },
+          "idf.serialPortDetectionTimeout": {
+            "type": "number",
+            "default": 60,
+            "scope": "resource",
+            "description": "%param.serialPortDetectionTimeout%"
           }
         }
       }
@@ -1384,6 +1390,12 @@
         "category": "ESP-IDF",
         "when": "!isWeb"
       },
+      {
+        "command": "espIdf.detectSerialPort",
+        "title": "%espIdf.detectSerialPort.title%",
+        "category": "ESP-IDF",
+        "when": "!isWeb"
+      },
       {
         "command": "espIdf.buildDevice",
         "title": "%espIdf.buildDevice.title%",

package.nls.es.json

@@ -84,7 +84,8 @@
 	"espIdf.selectNotificationMode.title": "Seleccionar modo de notificación y salida",
 	"espIdf.selectOpenOcdConfigFiles.title": "Seleccionar archivos de configuración de placa OpenOCD",
 	"espIdf.selectPort.title": "Seleccionar puerto a usar (COM, tty, usbserial)",
-  	"espIdf.setClangSettings.title": "Configurar el proyecto para usar ESP-Clang",
+	"espIdf.detectSerialPort.title": "Detectar puerto serie",
+  "espIdf.setClangSettings.title": "Configurar el proyecto para usar ESP-Clang",
 	"espIdf.setGcovConfig.title": "Configurar SDKConfig del proyecto para cobertura",
 	"espIdf.setMatterDevicePath.title": "Establecer Ruta del Dispositivo ESP-MATTER (ESP_MATTER_DEVICE_PATH)",
 	"espIdf.setTarget.title": "Establecer Objetivo del Dispositivo Espressif",
@@ -186,6 +187,7 @@
 	"param.hasWalkthroughBeenShown": "Indica si se ha mostrado el recorrido de bienvenida",
 	"param.unitTestFilePattern.title": "Patrón glob para descubrir archivos de prueba unitaria",
 	"param.pyTestEmbeddedServices.title": "Lista de servicios integrados para la ejecución de pytest",
+	"param.serialPortDetectionTimeout": "Tiempo de espera en segundos para la detección del puerto serie usando esptool.py",
 	"trace.poll_period.description": "poll_period se establecerá para el rastreo de la aplicación",
 	"trace.skip_size.description": "skip_size se establecerá para el rastreo de la aplicación",
 	"trace.stop_tmo.description": "stop_tmo se establecerá para el rastreo de la aplicación",

package.nls.json

@@ -84,6 +84,7 @@
   "espIdf.selectNotificationMode.title": "Select Output and Notification Mode",
   "espIdf.selectOpenOcdConfigFiles.title": "Select OpenOCD Board Configuration",
   "espIdf.selectPort.title": "Select Port to Use (COM, tty, usbserial)",
+  "espIdf.detectSerialPort.title": "Detect Serial Port",
   "espIdf.setClangSettings.title": "Configure project for ESP-Clang",
   "espIdf.setGcovConfig.title": "Configure Project SDKConfig for Coverage",
   "espIdf.setMatterDevicePath.title": "Set ESP-MATTER Device Path (ESP_MATTER_DEVICE_PATH)",
@@ -187,6 +188,7 @@
   "param.hasWalkthroughBeenShown": "Has the walkthrough been shown",
   "param.unitTestFilePattern.title": "Glob pattern for unit test files to discover",
   "param.pyTestEmbeddedServices.title": "List of embedded services for pytest execution",
+  "param.serialPortDetectionTimeout": "Timeout in seconds for serial port detection using esptool.py",
   "trace.poll_period.description": "poll_period will be set for the apptrace",
   "trace.skip_size.description": "skip_size will be set for the apptrace",
   "trace.stop_tmo.description": "stop_tmo will be set for the apptrace",

package.nls.pt.json

@@ -84,7 +84,8 @@
 	"espIdf.selectNotificationMode.title": "Selecione o modo de saída e notificação",
 	"espIdf.selectOpenOcdConfigFiles.title": "Selecione a configuração da placa OpenOCD",
 	"espIdf.selectPort.title": "Selecione a porta a ser usada (COM, tty, usbserial)",
-  	"espIdf.setClangSettings.title": "Configurar o projeto para ESP-Clang",
+	"espIdf.detectSerialPort.title": "Detectar porta serial",
+  "espIdf.setClangSettings.title": "Configurar o projeto para ESP-Clang",
 	"espIdf.setGcovConfig.title": "Configurar o projeto SDKConfig para cobertura",
 	"espIdf.setMatterDevicePath.title": "Definir caminho do dispositivo ESP-MATTER (ESP_MATTER_DEVICE_PATH)",
 	"espIdf.setTarget.title": "Definir destino do dispositivo Espressif",
@@ -185,6 +186,7 @@
 	"param.hasWalkthroughBeenShown": "Mostrar o guia de introdução na inicialização da extensão",
 	"param.unitTestFilePattern.title": "Padrão glob para descobrir arquivos de teste unitário",
 	"param.pyTestEmbeddedServices.title": "Lista de serviços incorporados para execução do pytest",
+	"param.serialPortDetectionTimeout": "Tempo limite em segundos para detecção de porta serial usando esptool.py",
 	"trace.poll_period.description": "poll_period será definido para o apptrace",
 	"trace.skip_size.description": "skip_size será definido para o apptrace",
 	"trace.stop_tmo.description": "stop_tmo será definido para o apptrace",