You are viewing an older revision! See the latest version

Interfacing with LabVIEW

Here are some building blocks to interface an mbed with LabVIEW, allowing LabVIEW programs to interact with the real world. This could be used for things like:

  • data acquisition in LabVIEW via sensors connected to mbed
  • controlling actuators connected to mbed from LabVIEW
  • LabVIEW programs with hardware-in-the-loop, where sensors and actuators are interfaced with mbed but calculations and control are in LabVIEW

We've created two ways for you to interface between LabVIEW and mbed.

  • LabVIEW RPC This allows you to directly control the mbed using the RPC. For many applications it wouldn't be necessary to write any custom code for the mbed.
  • Serial Communication These examples show how data can be transfered between the program running on mbed and your LabVIEW application.

LabVIEW Setup

To use mbed with LabVIEW, you need to have the NI-VISA drivers installed to give access to the USB serial port.

With LabVIEW and NI-VISA installed, you should be ready to go.

LabVIEW RPC

We've created a set of vi's that expose a lot of the mbed interface using RPC. The vi's we've created allow you to create and control new objects or control objects that are created in the mbed code.

The LabVIEW vi's

Here are the vi's that allow you to interface with the RPC and some examples of their use.

Relinking Files

When you download the files (especially the demos) they may not be in the same locations relative to the files they depend on as they were on the computer they were developed on. LabVIEW is very good at relinking files so just okay error messages or reconnect the files according to the locations in which you have saved them.

Using the LabVIEW RPC vi's

The LabVIEW vi's have been created to mirror the mbed api as closely as possible. They therefore take a similar object oriented approach. We create an mbed object and then using this create objects for each of the inputs and outputs. The vi's are contained in two folders:

  • The "mbed Interface" folder includes all the vi's for creating and controlling inputs and outputs on mbed.
  • The "Transport Mechanisms" folder contains the vi's for creating a connection to an mbed and then closing it.

We've provided the vi's as a zipped file which you can extract to any where on your computer. To make it a bit easier to access them we've also created a Library which might be a bit easier to develop with as you can drag vi's in from it. Just open the file mbed_LVlibrary from within LabVIEW.

Using the API

Information

To use these vi's your mbed needs to be running code which can receive and execute RPC commands. Information and examples of this, can be found on the Interfacing-Using-RPC page. Compile and run the program for RPC over serial to use the vi's on this page.

  • First create an mbed interface by using a transport mechanism. This can be either SerialRPC or HTTPRPC.

/media/uploads/MichaelW/ledserialsnippet.png /media/uploads/MichaelW/ledhttpsnippet.png

  • You can now create objects on mbed such as DigitalOut or AnalogIn. Wire up the input of a DigitalOut to the output from mbedSerial
    • To create an object connect controls or constants to the pin number. Pins are passed as a string eg "p21" or "LED1"
    • If you have an object created on mbed then you can tie to it by passings its name as a string into the existing object name.
  • You can now execute the methods that are defined in the mbed api. For example you can execute a write block on a DigitalOut to set the value of the pin. Wire the write block to the object you want to act on and then add a control to set the value of the pin.
  • Finally wire up the SerialRPC_delete method to the mbed wire so that the serial port is closed and is avaliable to other programs.

This is demonstrated in the LED flash example the block diagrams for which are displayed above. Note that only the write method is contained within the while loop as the object only needs to be created once at the start.

Using this approach you can connect multiple mbeds on different ports and control them from LabVIEW. The vi's have been designed to align as closely as possible with the api so looking in the Handbook should help explain what each method does. As its using the RPC the vi is directly calling the methods in the api.

Using RPC with Custom Code

The RPC-Interface-Library provides a mechanism for quickly adding RPC functionality to your own code. This LabVIEW library includes support for the RPCFunction and RPCVariable Objects. You can tie an RPCFunction or RPCVariable object to the corresponding object on mbed. You can then run the function or read and write to the variables which are attached. /media/uploads/MichaelW/rpcfunctionsnippet.png

The RPCVariable read and write blocks have both numeric and string inputs and outputs. You should wire to the appropriate one according to the type of variable it is corresponds with on mbed.

Serial Communication

Here are the mbed vi's we've created to communicate between mbed and LabVIEW:

  • mbed-ni.zip - mbed read and write VI's, plus Hello World examples

Download these and use them as components in your LabVIEW designs.

The Protocol

To keep things simple, we're assuming the communication between LabVIEW and mbed is a line-based text protocol. That means every "packet" between LabVIEW and mbed is a string followed by a newline character (\n). The mbed-read.vi returns a line read from mbed every time you run it, and the mbed-write.vi writes a string to the mbed every time you run it, so you can use this however you want.

Whilst the line string is the underlying data, there are also some common cases we've added support for such as sending single numbers, or comma separated value (csv) "packets". The inputs and outputs supported are:

  • A string (e.g. "hello" is transferred as "hello\n")
  • A number (e.g. 1 is transfered as "1.0000\n")
  • An array of strings (e.g. ["foo", "bar"] is transferred as "foo,bar\n")
  • An array of numbers (e.g. [1, 0.5] is transferred as "1.000,0.5000\n")

These make it easy to work in LabVIEW without having to do lots of packing/unpacking/conversion yourself.

mbed Read Hello World

A simple labview example is included that plots the state of an AnalogIn input, which looks like:

/media/uploads/simon/screen_shot_2010-07-29_at_22.45.23.png

And here is an example program to send some data:

Import program

00001 #include "mbed.h"
00002 
00003 DigitalOut myled(LED1);
00004 AnalogIn x(p20);
00005 
00006 int main() {
00007     while (1) {
00008         printf("%f\n", x.read());
00009         myled = !myled;
00010         wait(0.01);
00011     }
00012 }

The resulting output once the mbed COM port number has been selected in the VISA control, and when modifying AnalogIn, looks like:

/media/uploads/simon/screen_shot_2010-07-29_at_22.44.23.png

mbed Write Hello World

A simple labview example is included that controls the brightness of LED1 and LED2, which looks like:

/media/uploads/simon/mbed_write_example.png

And here is an example program that responds to the commands:

Import program

00001 #include "mbed.h"
00002 
00003 PwmOut myled(LED1);
00004 PwmOut myled2(LED2);
00005 
00006 int main() {
00007     while(1) {
00008         float brightness, brightness2;
00009         scanf("%f,%f", &brightness,&brightness2);
00010         myled = brightness;
00011         myled2 = brightness2;
00012     }
00013 }

The control panel looks like:

/media/uploads/simon/mbed-write_hello_world.png

Closed-Loop Example


All wikipages