Using Visual Studio Code with the NXP MIMXRT1060-EVK Evaluation Kit

This guide describes how to use Visual Studio Code to build, flash, and debug with the NXP MIMXRT1060-EVK Evaluation Kit.

This is a companion to the Quickstart Guide. Please ensure you have completed the following steps of the Quickstart Guide before continuing.

Clone the repo for the quickstart.
Create the cloud components.
Configure Azure IoT connection settings.

Note: It is not necessary to install the tools described in the quickstart guide. Tool installation will be covered in the next section below.

Configure Your Development Environment with `vcpkg-ce`

This section shows how to configure your development environment with the new vcpkg-ce, short for "configure environment", bootstraps project dependencies from a manifest file, vcpkg-configuration.json. This makes it easy to express which compilers and build tools are required by a project. Upon activation, the tools specified by the manifest are added to the path of the current shell. If the tools are not present, vcpkg-ce acquires them and installs them to a common location. The vcpkg-ce tool runs in user mode without elevation.

vcpkg-ce is in early preview. To report problems or provide feedback, please open issues at https://github.com/microsoft/vcpkg-ce.

Windows 10

Download and install Visual Studio Code.
Download and install the SEGGER J-Link Software and Documentation Pack V7.00 or greater. Note: Version V7.00 or greater is required to support the on-board DAPLink probe.
Open an Administrator PowerShell terminal and enable execution of PowerShell scripts.
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
```
Add the J-Link installation directory to the Path environment variable. Assuming you have chosen the default installation directory, you can do so by running the following command:
```
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files (x86)\SEGGER\JLink", "Machine")
```
Open a new PowerShell terminal and navigate to the following path in the repo.

getting-started\NXP\MIMXRT1060-EVK
Install vcpkg-ce.
```
iex (iwr -useb aka.ms/vcpkg-init.ps1)
```
Download, install, and activate developer tools.
```
vcpkg activate
```
Run the following code to confirm that CMake version 3.20 or later is installed.
```
cmake --version
```
Use this terminal to complete the remaining tasks in this guide.

Ubuntu 20.04

Download and install Visual Studio Code.
Download and install the SEGGER J-Link Software and Documentation Pack V7.00 or greater. Choose the installer as appropriate for your Linux distribution. Note: Version V7.00 or greater is required to support the on-board DAPLink probe.
Open a new bash terminal and navigate to the following path in the repo.

getting-started\NXP\MIMXRT1060-EVK
Install curl and libncurses5 using your package manager.
```
sudo apt install curl libncurses5
```
Install vcpkg-ce.
```
. <(curl aka.ms/vcpkg-init.sh -L)
```
Download, install, and activate developer tools.
```
vcpkg activate
```

Ensure the following lines in getting-started\NXP\MIMXRT1060-EVK.vscode\tasks.json have been commented out.

// This must be commented out to run on Linux.
// "options": {
//     "shell": {
//         "executable": "cmd.exe",
//         "args": [ "/c" ]
//     }
// }

Run the following code to confirm that CMake version 3.20 or later is installed.
```
cmake --version
```
Use this terminal to complete the remaining tasks in this guide.