Table of Contents

• Table of Contents
• Installation Instructions
  • Setting up the Software Environment
  • Starting Eclipse
  • Connecting to the NI ELVIS III
  • Importing C Support File for NI ELVIS III to Eclipse
  • Installing Bitfiles
  • Building and Installing Executable
• Examples Overview
  • AIO
  • AIO N Sample
  • DIO
  • DIO N Sample
  • PWM
  • Encoder
  • I2C
  • SPI
  • UART
  • AIIRQ
  • DIIRQ
  • ButtonIRQ
  • TimerIRQ
• Function Select Register
• NI ELVIS III Shipping Personality Reference

Installation Instructions

This document guides you through configuring the development environment of Eclipse to debugging or running C example projects on the NI ELVIS III with Eclipse.

Setting up the Software Environment

1. Install 32-bit Java SE 8 (x86), which you can download at http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html.
2. Install C/C++ Development Tools for NI Linux Real-Time, Eclipse Edition 2017-2018, which you can download at http://www.ni.com/download/labview-real-time-module-2017/6731/en/.

3. Add the compiler path to the system environment variables

   a. In the Windows Control Panel, select System and Security » System » Advanced system settings to display the System Properties dialog box.
   b. Click Environment Variables to display the Environment Variables dialog box.
   c. Select PATH in the User variables group box and click Edit. If PATH does not exist, click New to create one.
   d. Append the compiler path to Variable value. Delimit paths with semicolons.
   C:\build\17.0\arm\sysroots\i686-nilrtsdk-mingw32\usr\bin\arm-nilrt-linux-gnueabi
   e. Click OK to close the dialog boxes and save changes.
   

4. Add the library path to the system environment variables

   a. Click New in the User variable group box to display the New User Variable dialog box.
   b. In the Variable name, enter LIB_PATH.
   c. In the Variable value box, enter: C:\build\17.0\arm\sysroots\cortexa9-vfpv3-nilrt-linux-gnueabi
   d. Click OK to close the dialog boxes and save changes.
   

   e. Click New in the User variable group box to display the New User Variable dialog box.
   f. In the Variable name, enter C_INCLUDE_PATH.
   g. In the Variable value box, enter: %LIB_PATH%/usr/include
   h. Click OK to close the dialog boxes and save changes.
   

NOTE: If you use other versions of Eclipse, update the paths accordingly.

Starting Eclipse

1. Run Eclipse from the location where it is installed.
2. The Select a Workspace dialog box shows. Click OK.
3. On the Welcome screen, click the arrow to launch the Eclipse Workbench (C/C++ Editor).

Connecting to the NI ELVIS III

1. Select Window > Open Perspective > Other to display the Open Perspective dialog box.
2. Select Remote System Explorer and click OK.

3. On the Remote Systems pane's toolbar, click the Define a new connection to a remote system icon to launch the New Connection dialog box.

4. Select Linux and click Next to display the Remote Linux System Connection page.
5. Enter the NI ELVIS III wireless IP address in the Host name textbox and click Next to display the Files page.

6. Enable the ssh.files checkbox and click Next to display the Processes page.

7. Enable the processes.shell.linux checkbox and click Next to display the Shells page.
8. Select ssh.shells and click Next to display the SSH Terminals page.
9. Click Finish. The remote system shows in the Remote Systems pane.
10. In the Remote Systems pane, right-click the target and select Connect. The Enter Password dialog box shows.

11. Enter the user ID and the password of the NI ELVIS III. Click OK.

NOTE: Leave the Password textbox blank if you have not set one. There is no password by default.

12. The Info dialog box shows. Click OK. You have successfully connected to the NI ELVIS III.

Importing C Support File for NI ELVIS III to Eclipse

   Use the C examples to learn how to run a project on the NI ELVIS III with Eclipse.

1. Download the C Support archive file from github repository. Click Clone or download and then click Download ZIP.

2. Select Window > Open Perspective > Other to display the Open Perspective dialog box.
3. Select C/C++ (default) and click OK.
4. Select File > Import The Import dialog box shows.
5. Select General > Existing Projects into Workspace and click Next to display the Import Projects page.
6. Select Select archive file, click Browse and select the latest build C support archive file.
7. Select the C Support file and the example to import and click Finish.

Installing Bitfiles

Bitfiles contain information about the interfaces and registers of the hardware. Before using the NI ELVIS III, you need to install bitfiles on the NI ELVIS III. You can download bitfiles from github repository.

1. Select Window > Open Perspective > Other to display the Open Perspective dialog box.
2. Select Remote System Explorer. Click OK.
3. In the Remote Systems pane's toolbar, expand Sftp Files. Right-click Root, and select New > Folder. The New Folder dialog box shows.

4. Enter the folder name in the New folder name textbox: /var/local/natinst/bitfiles and click Finish. Ignore the error if the folder already exists.
5. In the Remote Systems pane, right-click the newly created folder and select Export From Project from the shortcut menu to display the Export dialog box.
6. Expand the project and select NiFpga_ELVISIIIv10FPGA.lvbitx (the bitfile name may vary depending on the hardware you are using). Click Finish.

Building and Installing Executable

1. Select Window > Open Perspective > Other to display the Open Perspective dialog box.
2. Select C/C++ (default). Click OK.
3. In the Project Explorer pane, right-click an example and select Build Project from the shortcut menu to build the example. Wait until the project finishes building.
4. In the Project Explorer pane, select the project and select Run As -> Run Configurations from the toolbar.
5. Right-click C/C++ Remote Application and select New to display the Run Configurations dialog box.

6. Select the IP address of the NI ELVIS III from the Connection pull-down menu.
7. Click Search Project... to select the built binary (Debug or Releae) you want to run on the NI ELVIS III device.

8. Click Browse to the right of the Remote Absolute File Path for C/C++ Application textbox.
9. Right-click My Home and select New -> Folder.
10. Enter the new folder name and click Finish.
11. Select the folder you have just created and click OK. In the textbox, append / after /home/admin and add the project name to the end of the path.
12. Click Apply to save the settings.

12. Click Run to build and install the executables.

Examples Overview

NI provides the following examples for using the NI ELVIS III. Refer to the main.c file in each example for more information.

AIO

Demonstrates using the analog input and output (AIO). This example writes an initial value to AO0 on bank A and reads this value from AI0 on bank A.This example also reads the difference of the initial values on AI1 and AI5 on bank B. This example prints the values to the console.

AIO N Sample

Demonstrates using th analog input and output of N Sample (AIO - N Sample). This example reads a group of values from AI0 on bank A and writes a group of initial values to AO0 on bank B.This example prints the group of read values to the console.

DIO

Demonstrates using the digital input and output (DIO). This example writes an initial value to DIO1 on bank A and reads this value from DIO0 on bank A.This example also reads an initial value from DIO0 on bank B.This example prints the values to the console.

DIO N Sample

Demonstrates using th digital input and output of N Sample (AIO - N Sample). This example reads a group of values from DIO0 on bank A and writes a group of initial values to DIO0 on bank B.This example prints the group of read values to the console.

PWM

Demonstrates using pulse-width modulation (PWM). This example generates a PWM signal from PWM 0 on bank A.

Encoder

Demonstrates using the encoder. This example reads a step and direction signal from the encoder on bank A and prints the values to the console.

I2C

Demonstrates using the I²C. This example reads the temperature from a connected TMP102 digital temperature sensor and writes the response to the console.

SPI

Demonstrates using the serial peripheral interface bus (SPI). This example writes a message to the SPI bus and then prints any returned bytes to the console.

UART

Demonstrates using the universal asynchronous receiver/transmitter (UART). This example writes a character to the UART bus and then prints any returned character to the console.

AIIRQ

Demonstrates using the analog input interrupt request (IRQ). This example registers an IRQ on analog input AI0 on bank A and creates a new thread that waits for the interrupt to occur.

DIIRQ

Demonstrates using the digital input interrupt request. This example registers an IRQ on digital input DIO0 on connector A and creates a new thread that waits for the interrupt to occur.

ButtonIRQ

Demonstrates using the button interrupt request. This example registers an IRQ on the user button of the NI ELVIS III and creates a new thread that waits for the interrupt to occur.

TimerIRQ

Demonstrates using the timer interrupt request. This example registers an IRQ on software timer and creates a new thread that waits for the interrupt to occur.

Function Select Register

Some examples need extra devices to connect to NI ELVIS III.Here are the input and output interfaces of these examples:

• DIO: DIO [0:19] on bank A and bank B
• PWM: DIO [0:19] on bank A and bank B
• Encoder: DIO [0:1], DIO [2:3], …, DIO [18:19] on bank A and bank B
• SPI: DIO [5:7] on bank A and bank B
• I2C: DIO [14:15] on bank A and bank B
• UART: DIO [16:17] on bank A and bank B

NI ELVIS III	DIO example	PWM example	Encoder example	SPI example	I2C example	UART example
DIO 0	DIO 0	PWM 0	ENC.A 0
DIO 1	DIO 1	PWM 1	ENC.B 0
DIO 2	DIO 2	PWM 2	ENC.A 1
DIO 3	DIO 3	PWM 3	ENC.B 1
DIO 4	DIO 4	PWM 4	ENC.A 2
DIO 5	DIO 5	PWM 5	ENC.B 2	SPI.CLK
DIO 6	DIO 6	PWM 6	ENC.A 3	SPI.MISO
DIO 7	DIO 7	PWM 7	ENC.B 3	SPI.MOSI
DIO 8	DIO 8	PWM 8	ENC.A 4
DIO 9	DIO 9	PWM 9	ENC.B 4
DIO 10	DIO 10	PWM 10	ENC.A 5
DIO 11	DIO 11	PWM 11	ENC.B 5
DIO 12	DIO 12	PWM 12	ENC.A 6
DIO 13	DIO 13	PWM 13	ENC.B 6
DIO 14	DIO 14	PWM 14	ENC.A 7		I2C.SCL
DIO 15	DIO 15	PWM 15	ENC.B 7		I2C.SDA
DIO 16	DIO 16	PWM 16	ENC.A 8			UART.RX
DIO 17	DIO 17	PWM 17	ENC.B 8			UART.TX
DIO 18	DIO 18	PWM 18	ENC.A 9
DIO 19	DIO 19	PWM 19	ENC.B 9

NI ELVIS III Shipping Personality Reference

This document contains reference information about the NI ELVIS III shipping personality. The reference includes information about the registers used to control the peripherals of NI ELVIS III.

You can find NI ELVIS III Shipping Personality Reference here.