Development Software Suite

Install and test all software required for the program[VIDEO]

Platform Test Tools SAM3U2 Firmware nRF51422 Firmware Software
MPG1
MPG2
USB RS-232 Converter
ANT USB Stick
MPG1 Board Test
MPG2 Board Test
AP2 Emulator IAR 7.20.1
nRFGo Studio
ANTware II
Tera Term

Start

This module describes the software installation required for the EiE Firmware 1 and Firmware 2 programs. All software packages are either freeware or have free versions with some limitations that will not impact the program. All software is industry-grade and proven stable on Windows 7 PCs (standalone and networked). Windows 8 and 10 have been preliminarily tested ok. For more detailed instructions including information on lab installations, please reference this Software Installation Guide

Two archives are available with the software versions used in the program:

Software Installation

The installation instructions provided on this page reference the archived versions. For each program described below, a link to the current version is also provided.

IAR Embedded Workbench for ARM
All modules are currently using IAR 7.20.1 which is in the version archive.

Launch the installer and be sure to install both IAR Embedded Workbench and the drivers. To install the drivers, select “Install Drivers” to bring up a Windows Explorer window. Open the J-Link directory and run InstallDrivers.exe. This will execute very quickly as it just copies the drivers into the correct windows folder. Later we will plug in a development board to complete the driver installation.
IAR

When the IAR main program has installed, open it and select Help > License Manager (it is a very slow program)
IARLicenseManager

Select License > Get Evaluation License to bring up the License Wizard dialog and then click “Register”
IARRegister

Complete the form as follows:

  • Be sure to choose the “Code size limited” version.
  • If you are an individual user, please use “EiE” for the Company.
  • The email address you use must be accessible as you will have to click a registration confirmation link.
  • Suggest clicking the “I’m already a customer of IAR Systems” box.
  • All optional fields can be left blank. There are a few questions that must be answered about the application – choose “none” or “not applicable” for all of them.

IarRegisterForm

Once you have received your registration key, enter it to complete the installation.

nRFGo Studio
This is a freeware programmer provided by Nordic Semiconductor to program the nRF51422 microcontroller. Please install the latest version.


Tera Term
A great terminal program for Windows. Please install the latest version.



ANTware II
ANTware II is a radio test software application that will be used extensively throughout the program. A user account is required to access the latest version of this software. Sign-up is free. Downloading the archived software is a faster approach. Dynastream has approved that this is ok by their licensing terms, but if you have any issues with using the software, please register and obtain the latest version for any support.

Be sure to install the USB drivers! Complete the installation by plugging in an ANT USB stick or ANT USB-M module.


Tortoise SVN
Firmware releases and other documentation are available via SVN. We recommend the Tortoise client which is context menu-driven in Windows.


GitHub Desktop
GitHub is a firmware community that is built on active users contributing code. Current firmware for each module referenced in the program is maintained here. Using the GitHub desktop application simplifies the process of interacting to the online repository.

Install the current version of GitHub Desktop at the link above. Individuals are encouraged to create a GitHub account and subscribe to Engenuics to ensure that your GitHub efforts are credited to you.


FTDI USB-Serial Drivers
The USB RS-232 to UART serial port converter used in the program is based on an FTDI chipset. Some installations of Windows already have these drivers but to ensure full compatibility, it is recommended that the provided driver be installed. Simply run autorun.exe to initiate the installation.


Windows Program Menu
To facilitate easy access to the installed software, a program group called “EiE” should be created in the Windows Start Menu with links to each of the above applications. A link to the EiE home page (www.embeddedinembedded.com) should also be added using the default browser.

EiEStartMenu


Firmware Download

Create a directory on your computer called Embedded\Firmware and select the Boardtest SAM3U2 Firmware package that matches your development board shown at the top of this page. The ASCII LCD board is “MPG1” and the dot matrix LCD board is “MPG2.”
DownloadBoardTest

The link opens to the version control portal that will be used throughout the program. For now, just download a copy of the firmware package using the “Download ZIP” button shown.
DownloadBoardTestGithub

Do the same for the nRF51422 firmware by selecting the “AP2 Emulator” code. This code is used for both versions of the development board. Unzip both archives. It is suggested that you delete the .zip archives. If you need to access them again, get fresh copies from the Github website to ensure you have the latest versions.

DownloadedFilesDirectory

Open IAR and select File > Open > Workspace. Navigate to the project directory for the development board you are using and choose the .eww file shown.

OpenProject

Note: if Windows is not showing file extensions, be sure to disable “Hide extensions for known file types” as it is awkward to work without them visible.

FolderOptions

As a final configuration step in IAR, choose Tools > Options and select the “Editor” top level options. Do the following:

  • Set “Tab size” to 2
  • Ensure “Tab Key Function” is set to “Indent with spaces”
  • Check “Show line numbers”
  • Optional: if you do not like the editor feature that allows expanding and hiding sections of code, uncheck this box

IAROptions


Connecting Hardware and Testing Installations

Connect the USB to Serial adapter to the board and ensure the switch is in the “STRAIGHT” position. Attach your target board via USB (use the “J-Link” connector on the outside edge of the board) and wait for the green J-LINK STATUS LED to stop blinking which indicates the J-Link driver is connected. The board’s RESET button is also indicated on this image.

HardwareConnect

Open Tera Term and do the following configurations:

  • Setup > Terminal… and set New-line:Receive to “CR” and make sure “Local echo” is NOT checked.
  • Setup > Serial port… and set the COM port that the USB to Serial device, Baud rate: 115200, Data: 8 bit, Parity: none, Stop: 1 bit, and Flow control: none
  • Setup > Save setup… and overwrite the default file unless you want to save this configuration as something specific.

TeraTermSetup

Press “Ctrl-d” to build and download the code to the development board. Once the download is complete, press “Ctrl-Shift-D” to close the debugger. The code should start running and you can observe the startup sequence in Tera Term. If you miss it or it is not working, press the “RESET” button on the development board. Once it is working, Type “en+c00” and press enter: the dev board will display its debug menu.

mpg1_startup_debug

The software and basic hardware environment is setup and ready to go now!

[STATUS: RELEASED. LAST UPDATE: 2016-MAR-04]