Veethree Extension

Overview

• Install development environment.
• Create template application.
• Build and run the application.

Prerequisites

Prerequisites for the Veethree VS Code extension:

1. Windows 11
2. WSL2 with default Linux distribution Install
3. USBIPD-WIN project Download and Install
4. Docker Desktop Download and Install
5. WSL2 Enabled on Docker Desktop Set up

Get Started

1. Install the Docker Environment

Click on the 'Install Enviroment' button to start development environment installation and setup

NOTE: Please make sure Docker Desktop (Docker Engine) is running before installing the environment

2. Grant device permissions

Before connecting to the ennvironment and using it for development allow the docker environment to access the device by clicking on the 'Allow Access to Device' button. This requires Admin permissions.

NOTE: Please make sure the device is plugged in and the environment is installed before granting permissions

3. Connect Device to Environment

Once the device access has been granted, the device can be connected to the development environment by clicking on the 'Connect Device to Environment' button

4. Connect to Environment

Click on the 'Connect to Environment' button to start developing

Developing on the Environment

Once connected to the environment, start development by creating a new application from a template or by opening an existing project

Build, Run and Flash

Predefined commands are available to build the application for Native Posix emulator and to flash and run on the device.

Test on Emulator

1. Run the West BuildNative Posix to generate build files
2. Start running the application using the Run command
3. Open the VNC viewer using the Open VNC Viewer button to view the virtual display

Test on Device

1. Run the West BuildVeethree to generate build files
2. Connect the device to the environment and and run the Flash command

Debug using GDB

1. Run the Debug BuildNative Posix to generate debug build files
2. Start a new debug session using Start DebugGDB

Debug using JLink using Cortex Debug

1. Run the Debug Build and FlashVeethree to generate debug build files and flash them onto the device
2. Start a new debug session using Start DebugCortex Debug

Generate Release Package

1. Generate a signed package using the default RSA-2048 PEM file using Generate Signed PackageDefault Key or using a custom PEM file with the command Generate Signed PackageCustom Key
2. Download the signed packages to local desktop environment using Download command