This repository contains a project example that can be developed from within a Dev Container using Visual Studio Code with its remote development extensions.
A Dev Container provides a pre-configured development environment. It allows you to work in a development environment that has been specifically configured for your repository. It will have all the tools, scripts and configurations you need to work on that project. Everyone who works on that repository will have the same environment, reducing the ocurrence of environment-related problems. Each repository can have settings that will give contributors a ready-to-use, fit-for-purpose environment, and the environment on your local machine will be unchanged.
The target is set to work with the IAR STM32F429II-ACA board although can be modified for working with other boards.
This project example makes use of one of the IAR public container images for Arm with ST device support.
Perform the following:
- Launch Visual Studio Code.
- If running from Windows, connect to WSL.
- Clone and open this repository.
Tip
This functionality depends on having Git installed. You might need to sudo apt install git or equivalent on your Linux distribution.
- A toaster notification in the lower right corner will offer to reopen the folder to develop in a container.
Tip
The toaster nofitication only appears for a short while. If you miss it, you can use the pallete (CTRL+SHIFT+P) and use, for example, "Dev Containers: reopen in container".
-
Install the recommended extensions from IAR and Microsoft.
-
The CMake Tools extension will offer to select a preset for configuring the project. A drop-down selection box will offer cxarm-linux as an option for building with the IAR Build Tools.
The IAR Build Tools require an user license to operate and, for that reason, the project will not build at first. Choose one of the following methods:
This method uses the Microsoft Entra ID technology and it requires your user mail account associated to this service.
-
Choose Terminal/Run task.../IAR Cloud login.
-
Select the authentication code and copy it to the clipboard (CTRL+C).
-
CTRL+Click on the provided link, enter with the provided code, click "Connect" and then "Continue".
- Go back to Visual Studio Code and build the project using the IAR Build Tools.
Alternatively, it is possible to use a time-limited Evaluation Token provided by IAR.
- Inside the Dev Container, choose Terminal/New Terminal and enter the following:
export IAR_LMS_BEARER_TOKEN=<the-evaluation-token-you-received>- It should now be possible to build the project using the IAR Build Tools.
Dev Containers simplify bootstrapping the whole development environment with the IAR Build Tools in Visual Studio Code.