Setting up the Dev environment

Installation

To setup your development environment you'll need to download the following tools installed:

• Visual Studio Code - https://code.visualstudio.com/
  • With the C/C++ extension
• Arduino IDE - https://www.arduino.cc/en/Main/Software
• MinGW (with msys-base-bin package) - https://osdn.net/projects/mingw

Cloning the repository

Because this project requires the use of symbolic links, you will need to use the command line to clone the repository. Visual Studio Code can do it, but it does not permit symbolic links by default.

git clone -c core.symlinks=true https://github.com/jeff-winn/nemesis-mod.git

Setting up VS Code

You will also need to install some extensions within VS Code to edit and work with the Arduino toolset.

1. Open one of the sketch workspaces.
2. You will be prompted to install any suggested extensions.
3. Reload VS Code (if prompted).
4. From the command palette search for Arduino Board Manager
   • Install the board manager packages listed in the README.md document on the project home page.
5. From the command palette search for Arduino Library Manager
   • Install the libraries listed in the Dependencies section of the README.md document on the project home page.

Workstation specific changes

The project was built on Windows 10, as such there are a couple settings that will need to be updated for Mac and Linux workstations for the C++ language server to find the header files for the Arduino variant being used.

• Depending on your workstation, you may have to setup the symbolic link from the shared folder within the workspace to the shared folder under sketches.

Debugging

A Segger JLink may be used with the SWD protocol to connect to both mainboards used by the project.

• Use the standard SWD 10 pin header for the nRF52840 device.
• For the M4 express, the following pins will need to be connected:
  • VRef
  • Gnd
  • Rst
  • Swclk (on back of board)
  • Swdio (on back of board)