Install and test all software required for the program
|Platform||Test Tools||SAM3U2 Firmware||nRF51422 Firmware||Software|
EiE Dot Matrix
USB RS-232 Converter
ANT USB Stick
Board Test ASCII
Board Test Dot Matrix
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 preliminary tested ok. For more detailed instructions including information on lab installations, please reference this Software Installation Guide
Two archives with the software versions used in the program are available over FTP.
PLEASE USE THESE FOR ALL INSTALLATIONS!
The installation instructions provided on this page reference the archived versions, however for each program described below, a link to the current version is also provided.
All modules are currently using IAR 7.20.1 which is in the version archive, but if you need the latest version you can find it www.iar.com.
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.
When the IAR main program has installed, open it and select Help > License Manager (warning: it is a very slow program)
Select License > Get Evaluation License to bring up the License Wizard dialog and then click “Register”
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.
Once you have received your registration key, enter it to complete the installation.
This is a freeware programmer provided by Nordic Semiconductor to program the nRF51422 microcontroller. Please install the latest version.
A great terminal program for Windows. Please install the latest version.
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.
Firmware releases and other documentation are available via SVN. We recommend the Tortoise client which is context menu-driven in Windows.
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.
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.”
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.
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.
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.
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.
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
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.
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.
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.
The software and basic hardware environment is setup and ready to go now!
Flashing the nRF51422
Most EiE development boards will have the nRF51422 processor pre-loaded with the correct firmware to use. You can easily determine this by checking if the 4 LEDs next to the nRF51422 light up when the board resets, and also that the ANT channel is setup ok during initialization.
If not, or if you want to change the code running on the nRF51422, you can use nRFGo Studio to change the firmware.
IF NRFGO STUDIO ASKS TO UPDATE THE JLINK FIRMWARE CHOOSE NO. It will ask you many times — keep choosing NO whenever it asks.
To update the firmware on the nRF51422 do the following:
- Connect a USB cable to the programming USB connection on the board (J1 “JLINK”)
- Move the PROGRAMMING TARGET switch (S1) to the left “nRF51422 side”
- Launch nRFGo Studio. You should see a “Segger xxxxxxxxx” option under “nRF51 development boards”. Click this to connect to the processor. You know it works when the adjacent window shows you are connected with two code Regions. If it does not work, you may have to unplug the USB, hold the reset development board reset button down, and plug the USB back in. CONTINUE HOLDING THE RESET BUTTON while you program the nRF51422.
- Click “Erase all”
- Select the “Program SoftDevice” tab and Browse into the Razor_Atmel_nRF51422 repository.
- Select /hex/s210_nrf51422_3.0.0_softdevice.hex
- Click “Program” and watch the Log window for “success” message.
- Select the “Program Application” tab and Browse again to select ant_network_processor_mpg_iar.hex
- Click “Program” and watch the Log window for “success” message.
- UNPLUG the USB cable and set switch S1 back to the right (SAM3U2)
Now the nRF51422 should be ready to go.
2017-SEP-19: Update software download links and software installation guide to v1.11
2016-OCT-16: First release