mirror of
https://github.com/lukstep/raspberry-pi-pico-docker-sdk.git
synced 2025-12-22 18:45:56 +03:00
Dev container tutorial
This commit is contained in:
lukstep
94
docs/vscode_manual_setup.md
Normal file
94
docs/vscode_manual_setup.md
Normal file
@@ -0,0 +1,94 @@
|
||||
|
||||
# Manual configuration of VSCode as Pico IDE
|
||||
|
||||
## Prerequisites
|
||||
|
||||
You need to Visual Studio Code and Docker installed.
|
||||
|
||||
## Attaching VSCode to SDK Docker container
|
||||
|
||||
Follow the instruction below to set up VSCode:
|
||||
|
||||
- Install [Visual Studio Code](https://code.visualstudio.com) and next [Remote Development](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) extensions.
|
||||
|
||||
|
||||
|
||||
- Open the terminal and go to the projects you want to open in VSCode.
|
||||
|
||||
- Pull SDK image from Docker HUB and run SDK container via the following command. The container must be running while you attach to it via VSCode.
|
||||
|
||||
```
|
||||
docker run -d -it --name pico-sdk --mount type=bind,source=${PWD},target=/home/dev lukstep/raspberry-pi-pico-sdk:latest
|
||||
docker exec -it pico-sdk /bin/sh
|
||||
```
|
||||
|
||||
- When the container is launched, go to VSCode, click the green button in the lower left corner of VSCode and select options: Attach to Running Container...
|
||||
|
||||
|
||||
|
||||
- Select the SDK container.
|
||||
|
||||
|
||||
|
||||
- Then a new VSCode window will open. At the bottom window, you can see that it is attached to the SDK container.
|
||||
|
||||
|
||||
|
||||
- Now, there is needed to open project files. Your project is mounted to `/home/dev` in the container. Go to EXPLORE tab in VSCode and click Open Folder. In opened window write `/home/dev` and click the OK button.
|
||||
|
||||
|
||||
|
||||
- Now You can explore, develop and build your Raspberry Pi Pico project via Visual Studio Code!
|
||||
|
||||
|
||||
|
||||
## Pico SDK aware Intellisense
|
||||
|
||||
For an IntelliSense that will be aware of Raspberry Pi Pico SDK dependencies, we will use [Clangd](https://clangd.llvm.org). Clangd is a C/C++ language server provided by the LLVM project. To Setup Clang as Intellisense engine follow instruction below:
|
||||
|
||||
- To begin with, you need to install the server itself (Clangd is not installed by default in the SDK container image), to do this in the terminal call the command:
|
||||
|
||||
```
|
||||
apk add clang-extra-tools
|
||||
```
|
||||
|
||||
- Next is needed to install the Visual Studio Code [Clangd extension](https://marketplace.visualstudio.com/items?itemName=llvm-vs-code-extensions.vscode-clangd).
|
||||
|
||||
|
||||
|
||||
- To set-up The Clangd extension, in the project root directory, create folder .vcode with file settings.json. To settings.json past configuration from the snippet below:
|
||||
|
||||
```json
|
||||
{
|
||||
"C_Cpp.intelliSenseEngine": "Disabled",
|
||||
"clangd.path": "/usr/bin/clangd",
|
||||
"clangd.checkUpdates": false,
|
||||
"clangd.restartAfterCrash": true,
|
||||
"clangd.detectExtensionConflicts": true,
|
||||
"clangd.arguments": ["-log=verbose",
|
||||
"-pretty",
|
||||
"--background-index",
|
||||
"--query-driver=/usr/bin/arm-none-eabi-gcc",
|
||||
"--compile-commands-dir=/home/dev/build"]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
- For clangd to work, it needs a `compile_commands.json` file. This file contains the compilation and dependency information of each file in the project. To create it you need to add to the CMake command, `-DCMAKE_EXPORT_COMPILE_COMMANDS=1`. So You need to build your project with the command:
|
||||
|
||||
```
|
||||
mkdir build
|
||||
cd build
|
||||
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=1 ..
|
||||
make
|
||||
```
|
||||
|
||||
- Now IntelliSense should work!. Now you should see a prompt when you start typing. If you hover your cursor over a function from the SDK you should see its documentation, You can go to the function definition by pressing F12.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user