Skip to content

Commit 2445970

Browse files
authored
Some random usability fixes (#71)
* remove Arm Tools Environment Manager * recommend Arm extensions through README * further simplify default initCommand sequences * replace ${workspace} with ${workspaceFolder} in default configs --------- Signed-off-by: Jens Reinecke <[email protected]>
1 parent 6f37e4e commit 2445970

File tree

2 files changed

+16
-17
lines changed

2 files changed

+16
-17
lines changed

README.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,14 +20,20 @@ The Arm CMSIS Debugger extension is actually an [extension pack](https://code.vi
2020

2121
The following extensions are included in this extension pack:
2222

23-
- [Arm Tools Environment Manager](https://marketplace.visualstudio.com/items?itemName=Arm.environment-manager), an extension that allows to download, install, and manage software development tools using [Microsoft vcpkg](https://vcpkg.io/en/index.html) artifacts.
2423
- [CDT GDB Debug Adapter Extension](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.cdt-gdb-vscode), an Eclipse CDT Cloud extension that supports debugging using gdb and any other debuggers that supports the MI protocol.
2524
- [Memory Inspector](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.memory-inspector), an Eclipse CDT Cloud extension that provides a powerful and configurable memory viewer that works with debug adapters.
2625
- [Peripheral Inspector](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.peripheral-inspector), an Eclipse CDT Cloud extension that provides a CMSIS SVD viewer and works with debug adapters.
2726

27+
## Recommended Extensions
28+
29+
We recommend to install the following extensions to simplify the user experience:
30+
31+
- [Arm Tools Environment Manager](https://marketplace.visualstudio.com/items?itemName=Arm.environment-manager), an extension that allows to download, install, and manage software development tools using [Microsoft vcpkg](https://vcpkg.io/en/index.html) artifacts. Use this extension to for example install the `GCC compiler for ARM CPUs` which comes with a GDB variant for Arm CPUs.
32+
- [Arm CMSIS Solution](https://marketplace.visualstudio.com/items?itemName=Arm.cmsis-csolution), an extension that is a graphical user interface for csolution projects that use the [CMSIS-Toolbox](https://open-cmsis-pack.github.io/cmsis-toolbox/). Use this extension to build your csolution projects, to generate `*.cbuild-run.yml` debug configuration files, and to make use of contributed commands in your debug launch configurations.
33+
2834
## pyOCD Debug Setup
2935

30-
- Install `GCC compiler for ARM CPUs` with the `Arm Tools Environment Manager` to get access to a GDB (`arm-none-eabi-gdb`).
36+
- Install `GCC compiler for ARM CPUs` with the `Arm Tools Environment Manager` extension to get access to a GDB (`arm-none-eabi-gdb`).
3137
- **Temporary** - should become obsolete with full `*.cbuild-run.yml` support in pyOCD:<br>
3238
Make sure to set up your CMSIS Pack installation root folder by one of the following methods:
3339
- Set your system environment variable `CMSIS_PACK_ROOT`.

package.json

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,6 @@
3434
"CMSIS"
3535
],
3636
"extensionPack": [
37-
"arm.environment-manager",
3837
"eclipse-cdt.cdt-gdb-vscode",
3938
"eclipse-cdt.memory-inspector",
4039
"eclipse-cdt.peripheral-inspector"
@@ -55,13 +54,12 @@
5554
"name": "CMSIS Debugger: pyOCD",
5655
"type": "gdbtarget",
5756
"request": "launch",
58-
"cwd": "${workspace}",
57+
"cwd": "${workspaceFolder}",
5958
"program": "${command:cmsis-csolution.getBinaryFile}",
6059
"gdb": "arm-none-eabi-gdb",
6160
"initCommands": [
6261
"load",
63-
"break main",
64-
"continue"
62+
"break main"
6563
],
6664
"target": {
6765
"server": "pyocd",
@@ -80,13 +78,12 @@
8078
"name": "CMSIS Debugger: pyOCD",
8179
"type": "gdbtarget",
8280
"request": "launch",
83-
"cwd": "^\"\\${workspace}\"",
81+
"cwd": "^\"\\${workspaceFolder}\"",
8482
"program": "^\"\\${command:cmsis-csolution.getBinaryFile}\"",
8583
"gdb": "arm-none-eabi-gdb",
8684
"initCommands": [
8785
"load",
88-
"break main",
89-
"continue"
86+
"break main"
9087
],
9188
"target": {
9289
"server": "pyocd",
@@ -107,14 +104,12 @@
107104
"name": "CMSIS Debugger: J-Link",
108105
"type": "gdbtarget",
109106
"request": "launch",
110-
"cwd": "${workspace}",
107+
"cwd": "${workspaceFolder}",
111108
"program": "${command:cmsis-csolution.getBinaryFile}",
112109
"gdb": "arm-none-eabi-gdb",
113110
"initCommands": [
114-
"monitor reset",
115111
"load",
116-
"break main",
117-
"continue"
112+
"break main"
118113
],
119114
"target": {
120115
"server": "JLinkGDBServer",
@@ -144,14 +139,12 @@
144139
"name": "CMSIS Debugger: J-Link",
145140
"type": "gdbtarget",
146141
"request": "launch",
147-
"cwd": "^\"\\${workspace}\"",
142+
"cwd": "^\"\\${workspaceFolder}\"",
148143
"program": "^\"\\${command:cmsis-csolution.getBinaryFile}\"",
149144
"gdb": "arm-none-eabi-gdb",
150145
"initCommands": [
151-
"monitor reset",
152146
"load",
153-
"break main",
154-
"continue"
147+
"break main"
155148
],
156149
"target": {
157150
"server": "JLinkGDBServer",

0 commit comments

Comments
 (0)