summaryrefslogtreecommitdiff
path: root/doc/buildWithVScode.md
diff options
context:
space:
mode:
authorKieran Cawthray <kieranc@gmail.com>2021-10-18 23:14:39 +0200
committerKieran Cawthray <kieranc@gmail.com>2021-10-18 23:14:39 +0200
commitff1fce18d6188d8b23374613f07e281173f228e7 (patch)
tree7d8bcf5448f86f31f092f4f554a8af167c225d7d /doc/buildWithVScode.md
parentc4ab17f58707771256c6fffd8db63d32e2831610 (diff)
parentab7c6e162f82674d176466d361b1f87a0d55cf4a (diff)
Merge remote-tracking branch 'upstream/develop' into pts-settings
Diffstat (limited to 'doc/buildWithVScode.md')
-rw-r--r--doc/buildWithVScode.md12
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.