Skip to content

Commit 7b127f2

Browse files
committed
Add CodeClimate badges
1 parent 6c6761b commit 7b127f2

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

README.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,12 @@
1+
[![Maintainability](https://api.codeclimate.com/v1/badges/0f12a7e73736f8bbfb9d/maintainability)](https://codeclimate.com/github/Open-CMSIS-Pack/vscode-cmsis-debugger/maintainability)
2+
[![Test Coverage](https://api.codeclimate.com/v1/badges/0f12a7e73736f8bbfb9d/test_coverage)](https://codeclimate.com/github/Open-CMSIS-Pack/vscode-cmsis-debugger/test_coverage)
3+
14
# Arm CMSIS Debugger Extension for Visual Studio Code (In Progress)
25

3-
The Arm CMSIS Debugger extension for Visual Studio Code is an extension pack demonstrating how to combine technologies from various open source projects to create a comprehensive debug platform for Arm based IoT solutions.
6+
The Arm CMSIS Debugger extension for Visual Studio Code is an extension pack demonstrating how to combine technologies from various open source projects to create a comprehensive debug platform for Arm based IoT solutions.
47

58
Related open source projects are
9+
610
- [Open-CMSIS-Pack](https://www.open-cmsis-pack.org/) of which this extension is part of.
711
- [Eclipse CDT Cloud](https://eclipse.dev/cdt-cloud/), an open-source project that hosts a number of components and best practices for building customizable web-based C/C++ tools.
812
- [pyOCD](https://pyocd.io/), a Python based tool and API for debugging, programming, and exploring Arm Cortex microcontrollers.
@@ -15,6 +19,7 @@ The Arm CMSIS Debugger extension is actually an [extension pack](https://code.vi
1519
## Included Extensions
1620

1721
The following extensions are included in this extension pack:
22+
1823
- [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.
1924
- [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.
2025
- [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.
@@ -23,10 +28,11 @@ The following extensions are included in this extension pack:
2328
## pyOCD Debug Setup
2429

2530
- Install `GCC compiler for ARM CPUs` with the `Arm Tools Environment Manager` to get access to a GDB (`arm-none-eabi-gdb`).
26-
- **Temporary** - should become obsolete with full `*.cbuild-run.yml` support in pyOCD:<br>
31+
- **Temporary** - should become obsolete with full `*.cbuild-run.yml` support in pyOCD:<br>
2732
Make sure to set up your CMSIS Pack installation root folder by one of the following methods:
2833
- Set your system environment variable `CMSIS_PACK_ROOT`.
2934
- Add the following to your debug launch configuration
35+
3036
```
3137
"environment": {
3238
"CMSIS_PACK_ROOT": "</path/to/your/pack/cache>"
@@ -41,6 +47,7 @@ The following extensions are included in this extension pack:
4147
## Additional Extension Functionality
4248
4349
This extension contributes additional functionality to more seamlessly integrate the included extensions:
50+
4451
- The pseudo debugger types `cmsis-debug-pyocd` and `cmsis-debug-jlink`. These types allow a more seamless integration into the VS Code IDE. However, these are not full debug adapters but generate debug configurations of type `gdbtarget` which comes with the [CDT GDB Debug Adapter Extension](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.cdt-gdb-vscode).
4552
- A [debug configuration provider](https://code.visualstudio.com/api/references/vscode-api#DebugConfigurationProvider) for the type `gdbtarget` which comes with the [CDT GDB Debug Adapter Extension](https://marketplace.visualstudio.com/items?itemName=eclipse-cdt.cdt-gdb-vscode). This provider automatically fills in default values for known remote GDB servers when launching a debug session.
4653
- CMSIS specific launch configuration items for the `*` debugger type, i.e. visible for all debugger types. It depends on the actually used debug adapter type if this information is known and utilized.
@@ -54,6 +61,7 @@ This section describes the contributed pseudo debugger types and their support t
5461
The `cmsis-debug-pyocd` debugger type allows to add default debug configurations to the workspace's `launch.json` file to debug via GDB and pyOCD. The actually used debugger type is `gdbtarget`.
5562
5663
In addition this extension contributes a debug configuration resolver which automatically fills the following gaps during debug launch:
64+
5765
- If option `target`.`server` is set to `pyocd`, then it expands this option to the absolute path of the built-in pyOCD distribution.
5866
- Adds/extends the `target`.`serverParameters` list of `pyocd` command line arguments:
5967
- Prepends `gdbserver` if not present.
@@ -69,12 +77,15 @@ The `cmsis-debug-jlink` debugger type allows to add default debug configurations
6977
**Note**: The generated default debug configuration uses `JLinkGDBServer` as `target`.`server` setting. The executable with this name has slightly differing behavior depending on your host platform. It launches a GUI-less server on Linux and MacOS. Whereas a GDB server with GUI is launched on Windows. Please change the value to `JLinkGDBServerCL` to suppress the GUI on Windows.
7078
7179
In addition this extension contributes a debug configuration resolver which automatically fills the following gaps during debug launch:
80+
7281
- Adds/extends the `target`.`serverParameters` list of `JLinkGDBServer`/`JLinkGDBServerCL` command line arguments:
7382
- Appends `--port` and the corresponding `port` value if `target`.`port` is set.
7483
7584
## Known Limitations
85+
7686
- Requires ELF files built with GCC and DWARF5 debug information to operate seamlessly.
7787
- The shipped pyOCD version accepts the new command line option `--cbuild-run`. But only extracts device and DFP names.
7888
7989
## Trademarks
90+
8091
Visual Studio is a trademark of the Microsoft group of companies.

0 commit comments

Comments
 (0)