Skip to content

Latest commit

 

History

History
102 lines (59 loc) · 4.22 KB

VS.md

File metadata and controls

102 lines (59 loc) · 4.22 KB
Raw

Using Visual Studio with the MXChip AZ3166 IoT DevKit

This guide describes how to use Visual Studio to build, flash, and debug with the MXChip AZ3166 IoT DevKit.

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

  1. Clone the repo for the quickstart.

  2. Create the cloud components.

  3. Configure Wi-Fi and 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

  1. Download and install Visual Studio.

    The Preview version of VS 2022 will have new embedded features.

  2. Download and install the ST-LINK Drivers. Restart your computer after installation is complete.

  3. Open an Administrator PowerShell terminal and enable execution of PowerShell scripts.

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

  4. Open a new PowerShell terminal and navigate to the following path in the repo:

    getting-started\MXChip\AZ3166

  5. Install vcpkg-ce.

    iex (iwr -useb aka.ms/vcpkg-init.ps1)

  6. Download, install, and activate developer tools.

    vcpkg activate

  7. Run the following code to confirm that CMake version 3.20 or later is installed.

    cmake --version

  8. Use this terminal to complete the remaining tasks in this guide.

Using Visual Studio

  1. Connect the Micro USB cable from the DevKit to your computer. If it is already connected, disconnect and reconnect it.

  2. Launch Visual Studio from a Powershell terminal.

    start devenv .

    Note that if you have more than one version of Visual Studio installed this may not launch the current preview. In that case you will need to use the full path to your preview installation. For example: "C:\Program Files\Microsoft Visual Studio\2022\Preview\Common7\IDE\devenv"

  3. Ensure that both the Configure Preset and the Build Preset are set to "arm-gcc-cortex-m4"

    configuration-choice

  4. Ensure that the "Launch" target is selected as the Debug Target.

    debug-target-choice

  5. Press F5 to start debugging the application.

    Visual Studio will build and flash the application to the device, then pause the debugger at the application entry point.

  6. Press F5 to resume execution. The debugger is now running and connected the device.

Restoring Your Development Environment

vcpkg-ce only modifies the path in the shell in which it is activated. If you close your shell and wish to restore the development environment in a future session:

  1. Open a new PowerShell terminal.

  2. Re-activate vcpkg-ce.

    . ~/.vcpkg/vcpkg activate

  3. Launch Visual Studio.

    start devenv .