myRIO Custom FPGA Project

The myRIO Custom FPGA Project template provides a starting point for you to create NI myRIO applications by using custom FPGA code. You use the LabVIEW FPGA Module to create the custom FPGA code, which runs in parallel with the code that you create with the myRIO VIs and the LabVIEW Real-Time Module. The design of this template makes it easy to modify the code of the NI myRIO FPGA shipping personality while still maintaining the ability to use the myRIO VIs.

You can learn more about NI FPGA at ni.com/fpga.

Example

Refer to the Voice Recorder sample project, available from the Create Project dialog box, for an example of adapting this template to an audio sampling application.

System Requirements

Development System

• LabVIEW Full or Professional Development System
• LabVIEW for myRIO Module
• LabVIEW Real-Time Module
• LabVIEW FPGA Module

Hardware

• NI myRIO

Use Cases

This template is suitable for applications that have the following characteristics:

• Contain multiple time-critical elements that need to run in parallel
• Require more precise timing than the timing that the NI myRIO RT controller can achieve
• Use a type of I/O that is not available with the NI myRIO FPGA shipping personality

The following are some example applications that can benefit from the use of this template:

• A Check Engine Auto Scanner that supports the CAN protocol
• An audio effects generator that analyzes an audio sample and generates multiple effects simultaneously

Overview

This template consists of the following VIs:

• myRIO-1900/1950 Customized FPGA.vi—Contains the NI myRIO FPGA shipping personality. This VI compiles and runs on the NI myRIO FPGA target. You can modify this VI to suit your application needs. National Instruments recommends that you only add new FPGA code to this VI and do not modify the existing code. This VI might not work correctly with the myRIO VIs if you modify the existing code.
• RT Main.vi—Contains the main NI myRIO application. This VI performs the following tasks:
  • Downloads the code in myRIO-1900/1950 Customized FPGA.vi to the NI myRIO FPGA target and runs the code
  • Sets the custom FPGA reference so that the myRIO VIs can still work with the custom FPGA code
  • Acquires and processes data from the onboard accelerometer and accesses any custom FPGA I/O

The following figure shows the block diagram of RT Main.vi.

This template uses a Flat Sequence structure that executes the following three frames from left to right:

1. Initialize—Initializes the application. Use this frame to open and set the custom FPGA bitfile that myRIO-1900/1950 Customized FPGA.vi generates. You can also use this frame to initialize variables and user interface elements like controls and indicators.
2. Acquire and process data—Acquires data from the NI myRIO and processes the data for presentation. The While Loop repeats the code until you click Stop or an error occurs. You can use the myRIO VIs or the LabVIEW FPGA host interface in this frame. Use the FPGA host interface for any custom elements that you add to myRIO-1900/1950 Customized FPGA.vi and use the myRIO VIs to access any default NI myRIO functionality.
3. Close—Closes and resets the custom FPGA code. You can also use this frame to clean up user interface elements and variables before the application exits.

Running This Template

1. In the Project Explorer window, open myRIO-1900/1950 Customized FPGA.vi.
2. Press the <Ctrl> key and click Run to generate the custom FPGA bitfile.
3. Open and run RT Main.vi.
4. Rotate or shake the NI myRIO to see the changes of the acceleration values.
5. Click Stop to stop the application.

Modifying This Template

Determining Your Needs

Before you customize this template for your own application, ask yourself the following questions:

• What kind of I/O channel will this application need to access? The answer to this question determines the myRIO VIs you need to use and whether you need to add custom FPGA code.
• Does this application contain any time-critical functions that need to run in parallel at a fast rate? The answer to this question determines the functions you need to add to the FPGA and the functions you run on the RT controller.
• What kind of data will this application need to access? The answer to this question determines what data you initialize in the Initialize frame.
• What are some errors that could occur, and how should the application respond to these errors? The answers to these questions determine the amount of error handling you need.

Controlling the Order of Execution

This template uses the Flat Sequence structure to execute frames from left to right when all data values wired to a frame are available. The data leaves each frame as the frame finishes executing. Use sequence structures sparingly when you modify this template. Rely on data dependency or flow-through parameters to control the order of execution.

Adding Initialization Code

In the Initialize frame, add code that initializes your application. For example, you may want to initialize the data to specific values, open a file for logging, and so on. You must open and set the custom FPGA bitfile in this frame. Otherwise, the NI myRIO uses the FPGA shipping personality.

Modifying the Data Acquisition and Processing Code

By default, this template uses the Accelerometer Express VI to acquire acceleration data from the onboard accelerometer and displays the acceleration values on a waveform chart. You can add your own code to acquire data from the NI myRIO and process the data based on your application needs. Use the myRIO VIs to access NI myRIO I/O channels and the onboard devices. Use the FPGA host interface to access the custom elements that you add to the FPGA code.

Adding Closing Code

In the Close frame, add code that executes after the data acquisition and processing is complete but before the application exits. Closing code commonly accomplishes the following tasks:

• Frees memory by closing any open references
• Flushes any buffers in use
• Resets the NI myRIO hardware

Note  You must close the custom FPGA reference in the Close frame so that the FPGA target is properly reset at the end of the application.

Modifying Error Handling

By default, this template stops if the Accelerometer Express VI returns an error or when you click the Stop button. When you customize this template, you can use the error in and error out clusters in each VI you use to pass the error information through the VI. If you want to ignore errors, you can remove the OR Function and wire the Stop button directly to the conditional terminal of the While Loop.

LabVIEW Features and Concepts Used

• Flat Sequence Structures
• Wait Functions
• Waveform Charts
• While Loops

Important Information

Copyright

© 2013 National Instruments. All rights reserved.

Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation.

National Instruments respects the intellectual property of others, and we ask our users to do the same. NI software is protected by copyright and other intellectual property laws. Where NI software may be used to reproduce software or other materials belonging to others, you may use NI software only to reproduce materials that you may reproduce in accordance with the terms of any applicable license or other legal restriction.

End-User License Agreements and Third-Party Legal Notices

You can find end-user license agreements (EULAs) and third-party legal notices in the following locations after installation:

• Notices are located in the <National Instruments>\_Legal Information and <National Instruments> directories.
• EULAs are located in the <National Instruments>\Shared\MDF\Legal\license directory.
• Review <National Instruments>\_Legal Information.txt for information on including legal information in installers built with NI products.

Trademarks

Refer to the NI Trademarks and Logo Guidelines at ni.com/trademarks for information on National Instruments trademarks. Other product and company names mentioned herein are trademarks or trade names of their respective companies.

Patents

For patents covering the National Instruments products/technology, refer to the appropriate location: Help»Patents in your software, the patents.txt file on your media, or the National Instruments Patent Notice at ni.com/patents.