Manual update for pre-release 1.55.1

Author: JonatanAntoni

CHANGELOG.md

@@ -1,6 +1,26 @@
 # Change Log
 
-## [Unreleased]
+## 1.55.1
+
+- New features:
+
+  - The [**Software Components**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/manage_components.html) view has been redesigned and uses the csolution tool
+    from the CMSIS-Toolbox included in the extension for consistency with the command line.
+  - The [**Manage Solution**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/manage_settings.html) view adds the selection of a debug adapter supported by the
+    [**Arm CMSIS Debugger**](https://marketplace.visualstudio.com/items?itemName=Arm.vscode-cmsis-debugger) extension.
+    - The selection is stored in the active `*.csolution.yml` as default [`target-set`](https://open-cmsis-pack.github.io/cmsis-toolbox/YML-Input-Format/#target-set) for the active `target-type`.
+    - If no `debugger:` is specified for the default `target-set` but the selected board specifies an [on-board debug adapter](https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/pdsc_boards_pg.html#element_board_debugProbe),
+      this information is taken from `.cbuild-run.yml`. and a default `target-set` is used.
+  - The **Views and More Actions...** menu available from the [**CMSIS-View**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/debug.html#cmsis-view) has now a **Target information** entry.
+    Click [**Target information**](https://mdk-packs.github.io/vscode-cmsis-solution-docs/create_app.html#check-target-information) to display information about the connected hardware.
+
+- Info:
+
+  - The location of `*.cbuild-run.yml` and `*.cbuild.yml` files is now consistently retrieved from the `*.cbuild-idx.yml` file for the commands `getCbuildRunFile` and `getBinaryFile(s)` which used hard-coded paths previously.
+
+- Known issues:
+
+  - Updating `launch.json` and `tasks.json` files does not preserve comments.
 
 ## 1.54.0
 
@@ -13,7 +33,7 @@
     - If a debug adapter is specified by the `*.cbuild-run.yml`, configurations are generated in `launch.json` and `tasks.json` based on the debug adapter templates specified in the [debug adapter registry](https://github.com/Open-CMSIS-Pack/debug-adapter-registry).
   - **Manage Solution** no longer supports the configuration of context specific "Run" and "Debug" actions. Corresponding options are deprecated in the user settings of the workspace.
   - [Device configuration files](https://open-cmsis-pack.github.io/cmsis-toolbox/build-overview/#device-configuration) (*.dbgconf) are moved and renamed. The files can be accessed from group "Device: ..." in **CMSIS-View**.
-  
+
 - Solved issues:
 
   - The YAML parser for the CMSIS solution input files ensures that all specified numeric, hexadecimal and boolean

README.md

@@ -41,6 +41,24 @@ The **CMSIS** view gives you access to the source code of your application. The
 
 Action buttons allow you to build, run, and debug your application, [edit *csolution project files*](#yml-editor-support) or [manage the solution configuration](#manage-solution-view). The [Configuration Wizard](#configuration-wizard) offers a graphical view to configuration file options.
 
+## Action buttons
+
+The **CMSIS** view displays the name of the current *csolution project* and offers several action buttons.
+
+![Action buttons](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/ActionButtons.png)
+
+| Action | Description |
+|--------|-------------|
+| Build / Stop | **Build**: Translate the source code into a application image.<br>**Stop**: Terminate the current build process. |
+| 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. |
+| 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. |
+| [Select components](#software-components-view) | View and modify the software components used for the application. |
+
 ## Create Solution view
 
 ![Create Solution](https://github.com/ARM-software/vscode-cmsis-csolution/raw/main/docs/images/CreateNewSolution.png)
@@ -72,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 [context set](https://open-cmsis-pack.github.io/cmsis-toolbox/build-overview/#working-with-context-set) from this view. For a given target type, a context set combines related projects which you can build for an 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.
+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.
 
 ## Configuration Wizard
 

docs/images/ActionButtons.png

@@ -41,12 +41,14 @@ <h1>CMSIS Solution Extension Third Party IP</h1>
 </pre>
 
     <h2>Quick Links</h2>
+        <div><a href="#@ant-design/icons">@ant-design/icons</a></div>
         <div><a href="#@eclipse-cdt-cloud/clangd-contexts">@eclipse-cdt-cloud/clangd-contexts</a></div>
         <div><a href="#@fortawesome/fontawesome-free">@fortawesome/fontawesome-free</a></div>
         <div><a href="#@grpc/grpc-js">@grpc/grpc-js</a></div>
         <div><a href="#@vscode/codicons">@vscode/codicons</a></div>
         <div><a href="#@vscode/extension-telemetry">@vscode/extension-telemetry</a></div>
         <div><a href="#@vscode/webview-ui-toolkit">@vscode/webview-ui-toolkit</a></div>
+        <div><a href="#antd">antd</a></div>
         <div><a href="#async-mutex">async-mutex</a></div>
         <div><a href="#buffer">buffer</a></div>
         <div><a href="#eta">eta</a></div>
@@ -65,11 +67,39 @@ <h2>Quick Links</h2>
         <div><a href="#react-window">react-window</a></div>
         <div><a href="#semver">semver</a></div>
         <div><a href="#vscode-cpptools">vscode-cpptools</a></div>
+        <div><a href="#vscode-jsonrpc">vscode-jsonrpc</a></div>
         <div><a href="#vscode-messenger">vscode-messenger</a></div>
         <div><a href="#vscode-messenger-common">vscode-messenger-common</a></div>
         <div><a href="#vscode-messenger-webview">vscode-messenger-webview</a></div>
         <div><a href="#yaml">yaml</a></div>
         <div><a href="#yargs-parser">yargs-parser</a></div>
+        <h2><a name="@ant-design/icons">@ant-design/icons</a></strong></h2>
+        <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
+        <p><strong>Version:</strong> 5.6.1</p>
+        <p class="source"><strong>Source:</strong> <a href="https://github.com/ant-design/ant-design-icons">https://github.com/ant-design/ant-design-icons</a></p>
+        <pre class="license">MIT LICENSE
+
+Copyright (c) 2018-present Ant UED, https://xtech.antfin.com/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+&quot;Software&quot;), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+</pre>
         <h2><a name="@eclipse-cdt-cloud/clangd-contexts">@eclipse-cdt-cloud/clangd-contexts</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/EPL-2.0.html">EPL-2.0</a></p>
         <p><strong>Version:</strong> 0.9.0-next.c7c35a6.0</p>
@@ -524,7 +554,7 @@ <h2><a name="@fortawesome/fontawesome-free">@fortawesome/fontawesome-free</a></s
 </pre>
         <h2><a name="@grpc/grpc-js">@grpc/grpc-js</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/Apache-2.0.html">Apache-2.0</a></p>
-        <p><strong>Version:</strong> 1.12.4</p>
+        <p><strong>Version:</strong> 1.13.4</p>
         <p class="source"><strong>Source:</strong> <a href="https://github.com/grpc/grpc-node">https://github.com/grpc/grpc-node</a></p>
         <pre class="license">                                 Apache License
                            Version 2.0, January 2004
@@ -1179,6 +1209,33 @@ <h2><a name="@vscode/webview-ui-toolkit">@vscode/webview-ui-toolkit</a></strong>
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.</pre>
+        <h2><a name="antd">antd</a></strong></h2>
+        <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
+        <p><strong>Version:</strong> 5.26.2</p>
+        <p class="source"><strong>Source:</strong> <a href="https://ant.design">https://ant.design</a></p>
+        <pre class="license">MIT LICENSE
+
+Copyright (c) 2015-present Ant UED, https://xtech.antfin.com/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+&quot;Software&quot;), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+</pre>
         <h2><a name="async-mutex">async-mutex</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
         <p><strong>Version:</strong> 0.5.0</p>
@@ -1540,7 +1597,7 @@ <h2><a name="path-browserify">path-browserify</a></strong></h2>
 </pre>
         <h2><a name="primereact">primereact</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
-        <p><strong>Version:</strong> 10.9.4</p>
+        <p><strong>Version:</strong> 10.9.6</p>
         <p class="source"><strong>Source:</strong> <a href="https://github.com/primefaces/primereact">https://github.com/primefaces/primereact</a></p>
         <pre class="license">The MIT License (MIT)
 
@@ -1644,7 +1701,7 @@ <h2><a name="react-window">react-window</a></strong></h2>
 </pre>
         <h2><a name="semver">semver</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/ISC.html">ISC</a></p>
-        <p><strong>Version:</strong> 7.7.1</p>
+        <p><strong>Version:</strong> 7.7.2</p>
         <p class="source"><strong>Source:</strong> <a href="https://github.com/npm/node-semver">https://github.com/npm/node-semver</a></p>
         <pre class="license">The ISC License
 
@@ -1664,7 +1721,7 @@ <h2><a name="semver">semver</a></strong></h2>
 </pre>
         <h2><a name="vscode-cpptools">vscode-cpptools</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
-        <p><strong>Version:</strong> 6.1.0</p>
+        <p><strong>Version:</strong> 7.0.4</p>
         <p class="source"><strong>Source:</strong> <a href="https://github.com/Microsoft/vscode-cpptools-api">https://github.com/Microsoft/vscode-cpptools-api</a></p>
         <pre class="license">vscode-cpptools-api 
 
@@ -1679,6 +1736,28 @@ <h2><a name="vscode-cpptools">vscode-cpptools</a></strong></h2>
 
 THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 </pre>
+        <h2><a name="vscode-jsonrpc">vscode-jsonrpc</a></strong></h2>
+        <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
+        <p><strong>Version:</strong> 8.2.1</p>
+        <p class="source"><strong>Source:</strong> <a href="https://github.com/Microsoft/vscode-languageserver-node">https://github.com/Microsoft/vscode-languageserver-node</a></p>
+        <pre class="license">
+Copyright (c) Microsoft Corporation
+
+All rights reserved.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation
+files (the &quot;Software&quot;), to deal in the Software without restriction, including without limitation the rights to use, copy,
+modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</pre>
         <h2><a name="vscode-messenger">vscode-messenger</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
         <p><strong>Version:</strong> 0.5.1</p>
@@ -1723,7 +1802,7 @@ <h2><a name="vscode-messenger-common">vscode-messenger-common</a></strong></h2>
 </pre>
         <h2><a name="vscode-messenger-webview">vscode-messenger-webview</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/MIT.html">MIT</a></p>
-        <p><strong>Version:</strong> 0.4.5</p>
+        <p><strong>Version:</strong> 0.5.1</p>
         <p class="source"><strong>Source:</strong> <a href="https://github.com/TypeFox/vscode-messenger">https://github.com/TypeFox/vscode-messenger</a></p>
         <pre class="license">Copyright 2022 TypeFox GmbH
 
@@ -1744,7 +1823,7 @@ <h2><a name="vscode-messenger-webview">vscode-messenger-webview</a></strong></h2
 </pre>
         <h2><a name="yaml">yaml</a></strong></h2>
         <p><strong>License:</strong> <a href="https://spdx.org/licenses/ISC.html">ISC</a></p>
-        <p><strong>Version:</strong> 2.7.0</p>
+        <p><strong>Version:</strong> 2.8.0</p>
         <p class="source"><strong>Source:</strong> <a href="https://github.com/eemeli/yaml">https://github.com/eemeli/yaml</a></p>
         <pre class="license">Copyright Eemeli Aro &lt;[email protected]&gt;
 

docs/images/ManageSolution.png

@@ -1,7 +1,7 @@
 [
     {
         "name": "@grpc/grpc-js",
-        "version": "1.12.4",
+        "version": "1.13.4",
         "spdx": "Apache-2.0",
         "url": "https://github.com/grpc/grpc-node",
         "license": "https://github.com/grpc/grpc-node/blob/master/LICENSE"
@@ -120,7 +120,7 @@
     },
     {
         "name": "primereact",
-        "version": "10.9.4",
+        "version": "10.9.6",
         "spdx": "MIT",
         "url": "https://github.com/primefaces/primereact",
         "license": "https://github.com/primefaces/primereact/blob/master/LICENSE.md"
@@ -148,14 +148,14 @@
     },
     {
         "name": "semver",
-        "version": "7.7.1",
+        "version": "7.7.2",
         "spdx": "ISC",
         "url": "https://github.com/npm/node-semver",
         "license": "https://github.com/npm/node-semver/blob/main/LICENSE"
     },
     {
         "name": "vscode-cpptools",
-        "version": "6.1.0",
+        "version": "7.0.4",
         "spdx": "MIT",
         "url": "https://github.com/Microsoft/vscode-cpptools-api",
         "license": "https://github.com/microsoft/vscode-cpptools-api/blob/main/LICENSE"
@@ -165,7 +165,7 @@
         "version": "0.5.1",
         "spdx": "MIT",
         "url": "https://github.com/TypeFox/vscode-messenger",
-        "license": "https://github.com/TypeFox/vscode-messenger/blob/v0.4.5/LICENSE"
+        "license": "https://github.com/TypeFox/vscode-messenger/blob/main/LICENSE"
     },
     {
         "name": "vscode-messenger-common",
@@ -179,11 +179,11 @@
         "version": "0.5.1",
         "spdx": "MIT",
         "url": "https://github.com/TypeFox/vscode-messenger",
-        "license": "https://github.com/TypeFox/vscode-messenger/blob/v0.4.5/LICENSE"
+        "license": "https://github.com/TypeFox/vscode-messenger/blob/main/LICENSE"
     },
     {
         "name": "yaml",
-        "version": "2.7.0",
+        "version": "2.8.0",
         "spdx": "ISC",
         "url": "https://github.com/eemeli/yaml",
         "license": "https://github.com/eemeli/yaml/blob/main/LICENSE"
@@ -195,6 +195,27 @@
         "url": "https://github.com/yargs/yargs-parser",
         "license": "https://github.com/yargs/yargs-parser/blob/main/LICENSE.txt"
     },
+    {
+        "name": "@ant-design/icons",
+        "version": "5.6.1",
+        "spdx": "MIT",
+        "url": "https://github.com/ant-design/ant-design-icons",
+        "license": "https://github.com/ant-design/ant-design-icons/blob/master/LICENSE"
+    },
+    {
+        "name": "antd",
+        "version": "5.26.2",
+        "spdx": "MIT",
+        "url": "https://ant.design",
+        "license": "https://github.com/ant-design/ant-design/blob/master/LICENSE"
+    },
+    {
+        "name": "vscode-jsonrpc",
+        "version": "8.2.1",
+        "spdx": "MIT",
+        "url": "https://github.com/Microsoft/vscode-languageserver-node",
+        "license": "https://github.com/Microsoft/vscode-languageserver-node/blob/main/License.txt"
+    },
     {
         "name": "eta",
         "version": "3.5.0",