diff options
| author | JF <JF002@users.noreply.github.com> | 2021-10-09 19:59:29 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-09 19:59:29 +0200 |
| commit | 5689898a5a01f98090f03671f0bf85bbf03478bd (patch) | |
| tree | 6084c1e31d283a30caa93b92ea502d845eb38cb8 | |
| parent | 0ca018b30925a40e0d58d4793734d67801a31081 (diff) | |
| parent | 516f9de3e4926149d0cdae0d6e320b4bbbd072e2 (diff) | |
Merge pull request #730 from coxtor/patch-1
Add configuration instructions for Ubuntu devcontainers
| -rw-r--r-- | doc/buildWithVScode.md | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/buildWithVScode.md b/doc/buildWithVScode.md index c1df17b7..23c97145 100644 --- a/doc/buildWithVScode.md +++ b/doc/buildWithVScode.md @@ -36,7 +36,17 @@ Using the [Remote-Containers](https://marketplace.visualstudio.com/items?itemNam More documentation is available in the [readme in .devcontainer](.devcontainer/readme.md) - +### DevContainer on Ubuntu +To use the DevContainer configuration on Ubuntu based systems two changes need to be made: + +1. Modify the file ``.devcontainer/devcontainer.json`` and add the argument ``"--net=host"`` to the ``"runArgs"`` parameter making the line look like this: +`` "runArgs": [ "--cap-add=SYS_PTRACE", "--security-opt", "seccomp=unconfined", "--net=host"], +`` +2. Modify the file ``.vscode/launch.json`` and change the argument of ``"gdbTarget"`` to ``"127.0.0.1:3333"``, making the line look like: +``"gdbTarget": "127.0.0.1:3333",`` +3. To start debugging launch openocd on your host system with the appropriate configuration, for example with a stlink-v2 the command is: +``openocd -f interface/stlink.cfg -f target/nrf52.cfg``. This launches openocd with the default ports ``3333``, ``4444`` and ``6666``. +4. In VsCode go to the Debug pane on the left of the screen and select the configuration ``Debug - Openocd docker Remote`` and hit the play button on the left. |