Update file(s) from Arm-Debug/vscode-cmsis-csolution

Author: JonatanAntoni

CHANGELOG.md

@@ -2,19 +2,30 @@
 
 ## [Unreleased]
 
+## 1.62.0
+
+- Updates:
+
+  - CMSIS-Toolbox v2.12.0 or higher is required by this version of the extension.
+  - The [**Manage Solution**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/manage_settings.html) dialog now manages `target sets`, a selection of images and debug configurations for the selected `target-type`.
+
+- Solved issues:
+
+  - Updating `launch.json` and `tasks.json` files does preserve comments.
+
 ## 1.60.0
 
 - Updates:
 
   - The [**Create Solution**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/create_app.html) dialog is reading board, device and example information from installed packs using the `csolution rpc daemon`.
-    Now information is also read from CMSIS Packs that are registered via the `local_repository.pidx`. The `CMSIS-Core-Tools` have been fully replaced and are therefore no longer distributed as part of the extension. 
+    Now information is also read from CMSIS Packs that are registered via the `local_repository.pidx`. The `CMSIS-Core-Tools` have been fully replaced and are therefore no longer distributed as part of the extension.
   - Using the [**CMSIS View**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/userinterface.html#4-main-area-icons) [+] button quick pick `Add From Component Code Template` now shows component instance index
     specific code templates.
-    
+
 - Solved issues:
 
   - Loading a CMSIS solution specifying a `target-set` without a corresponding `*.cbuild-set.yml` file present, now displays [**Software Components**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/manage_components.html#software-components-view) and enables the action buttons for
-   `Load & Run appliction` and `Load & Debug application` in the [**CMSIS-View**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/userinterface.html#3-actions-available-through-the-cmsis-view) [#306 ](https://github.com/ARM-software/vscode-cmsis-csolution/issues/306).
+   `Load & Run appliction` and `Load & Debug application` in the [**CMSIS-View**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/userinterface.html#3-actions-available-through-the-cmsis-view) [#306](https://github.com/ARM-software/vscode-cmsis-csolution/issues/306).
 
 - Known issues:
 

README.md

@@ -53,7 +53,7 @@ The **CMSIS** view displays the name of the current *csolution project* and offe
 | Load & Run / Stop | **Load & Run**: Download application image and start execution. Prepare GDB for target connection.<br>**Stop**: Terminate the current run or debug process. |
 | Load & Run / Attach | **Load & Run**: Download application image and start debugging.<br>**Attach**: Connect debugger to a running application. |
 | Open csolution.yml | Open the csolution.yml project file. |
-| [Manage Solution](#manage-solution-view) | Terminate the current program execution and start debugging again using the current run configuration. |
+| [Manage Solution](#manage-solution-view) | Select target and configure projects, images, and debug adapter. |
 | Menu | Offers more options such as [create new solution](#create-solution-view), rebuild, or get info about a connected target system. |
 | Clang active | Activates clang information for one `cproject.yml` part in a multi-project application. |
 | Open csolution.yml | Open the cproject.yml file. |
@@ -90,7 +90,7 @@ Select reusable software components for your application from this view.
 
 ![Manage Solution](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/ManageSolution.png)
 
-Select a [target set](https://open-cmsis-pack.github.io/cmsis-toolbox/build-overview/#working-with-context-set) from this view. For a given target type, a target set combines related projects and chooses the debug adapter used for the application. You might need to use different build types for projects, for example in cases where not all parts of an application require extra debug overhead. Refer also to [Run and Debug](#run-and-debug) below.
+Select the [target](https://open-cmsis-pack.github.io/cmsis-toolbox/build-overview/#target-production-hardware) and configure [related projects](https://open-cmsis-pack.github.io/cmsis-toolbox/build-overview/#configure-related-projects) for your application from this view. A Target Set stores settings for projects, images and debug adapter. You might need different build types or load settings, for example to reduce the debug overhead. Refer also to [Run and Debug](#run-and-debug) below.
 
 ## Configuration Wizard
 
@@ -106,9 +106,9 @@ The YML syntax support in the editor detects errors, provides auto completion, a
 
 ## Run and Debug
 
-Arm CMSIS Solution generates the [Run and Debug configuration](https://mdk-packs.github.io/vscode-cmsis-solution-docs/conf_debug.html) files (`launch.json` and `tasks.json`) for the [Arm CMSIS Debugger](https://marketplace.visualstudio.com/items?itemName=Arm.vscode-cmsis-debugger) and [pyOCD](https://pyocd.io/). It supports single-core and multi-core configurations for CMSIS-DAP, ULINK, JLink, and ST-Link debug adapters.
+Arm CMSIS Solution generates the [Run and Debug configuration](https://mdk-packs.github.io/vscode-cmsis-solution-docs/conf_debug.html) files including files `.vscode/launch.json` and `.vscode/tasks.json` for the [Arm CMSIS Debugger](https://marketplace.visualstudio.com/items?itemName=Arm.vscode-cmsis-debugger) and various debug adapters (such as CMSIS-DAP, ULINK, JLink, and ST-Link). The [Manage Solution view](#manage-solution-view) simplifies the setup and supports single-core and multi-core configurations.
 
-The [Run and Debug configuration](https://mdk-packs.github.io/vscode-cmsis-solution-docs/configuration.html#configure-run-and-debug) is enabled with the `target-set:` node and a `debugger:` setting as shown below:
+The [Run and Debug configuration](https://mdk-packs.github.io/vscode-cmsis-solution-docs/configuration.html#configure-run-and-debug) is stored in the `csolution.yml` file under `target-set:` as shown below:
 
 ```yml
   target-types:
@@ -119,13 +119,14 @@ The [Run and Debug configuration](https://mdk-packs.github.io/vscode-cmsis-solut
         - set:
           debugger:
             name: CMSIS-DAP
-            interface: swd
+            protocol: swd
 ```
 
 ## Related
 
 - [CMSIS Solution for VS Code Documentation](https://mdk-packs.github.io/vscode-cmsis-solution-docs/)
 - [Available Software Packs](https://www.keil.arm.com/packs/)
+- [Example projects](https://github.com/Arm-Examples)
 
 ## Submit feedback or report issues
 

docs/images/ManageSolution.png

@@ -229,5 +229,12 @@
         "spdx": "MIT",
         "url": "https://github.com/eta-dev/eta",
         "license": "https://github.com/eta-dev/eta/blob/main/LICENSE"
+    },
+    {
+        "name": "which",
+        "version": "5.0.0",
+        "spdx": "ISC",
+        "url": "https://github.com/npm/node-which",
+        "license": "https://github.com/npm/node-which/blob/main/LICENSE"
     }
 ]