Notice: This page contains information for the legacy Phidget21 Library. Phidget21 does not support VINT Phidgets, and will not support any new Phidgets. Phidget21 will be maintained until 2020. We recommend that new projects be developed against the Phidget22 Library.
Language - LabVIEW
|LabVIEW, developed by National Instruments is dataflow programming language for data processing.|
- 1 Introduction
- 2 Quick Downloads
- 3 Getting started with LabVIEW
- 4 Windows (XP/Vista/7/8)
- 5 Follow the Examples
- 6 LabVIEW Error Codes
- 7 Common Problems and Solutions/Workarounds
If this is your first time working with a Phidget, we suggest starting with the Getting Started page for your specific device. This can be found in the user guide for your device. That page will walk you through installing drivers and libraries for your operating system, and will then bring you back here to use LabVIEW specifically.
LabVIEW is capable of using the complete Phidget API, including events. We also provide example code in LabVIEW for all Phidget devices.
LabVIEW can be developed with Windows. A minimum version of LabVIEW 2009 is required. OS X and Linux are unsupported as the Labview/Phidgets combination has not been tested on those systems..
You can compare LabVIEW with our other supported languages.
Note that with LabVIEW you can install a 32-bit version on a 64-bit computer without any issues, but the 64-bit version cannot obviously be installed on a 32-bit computer. The reason this is relevant is that the respective versions cannot create executables that the other can run. I.E. 64-bit LabVIEW cannot generate a 32-bit executable. The upshot of this is that if you need your executable to be compatible with older machines (such as Windows XP machines) then you will need to use a 32-bit version of LabVIEW to create your program.
Just need the LabVIEW documentation, drivers, libraries, and examples? Here they are:
- Example Code (32 bit Windows - same file as LabVIEW library)
- Example Code (64 bit Windows - same file as LabVIEW library)
Libraries and Drivers
- LabVIEW Libraries (32 bit Windows - same file as LabVIEW Examples)
- LabVIEW Libraries (64 bit Windows - same file as LabVIEW Examples)
- 32-bit Windows Drivers Installer
- 64-bit Windows Drivers Installer
- Windows Driver and Library Files (Zipped)
Please note that the x64 examples are only compatible with LabVIEW 9 and newer.
Getting started with LabVIEW
If you are new to writing code for Phidgets, we recommend starting by running, then modifying existing examples. This will allow you to:
- Make sure your libraries are properly linked
- Go from source code to a test application as quickly as possible
- Ensure your Phidget is hooked up properly
Description of Library Files
LabVIEW programs on Windows depend on the following two items, The installers in the Quick Downloads section put only the
phidget21.dll into your system. You will need to manually put the Phidget LabVIEW library onto your system:
phidget21.dllcontains the actual Phidget library, which is used at run-time. By default, it is placed in
Phidgets LabVIEW librarycontains the Phidget library for LabVIEW. You need to place the library into your LabVIEW functions palette. Instructions are explained in the Write Your Own Code section.
Use Our Examples
To run the examples, you first download the examples found in the Quick Downloads section and unpack them into a folder. Here, you will find the
examples folder, which contains
vi programs for all the devices. Each
vi example demonstrate the usage of a few of the device's properties. To get a broader understanding of the device, you should take a look at all the
vi examples inside the directory for your device. The source file will be named the same as the software object for your device. If you are not sure what the software object for your device is, find your Phidget on our webpage, and then check the API documentation for it.
1. Inside the
examples folder, navigate to the directory for your device.
2. Open up any
.vi of your choice in LabVIEW. In this section, the
Sensor to Output Example.vi of the PhidgetInterfaceKit examples will be used.
You will see the front panel of the example. The front panel shows the user interface of the
3. Next, let us take a look at the block diagram by navigating to
Window → Show Block Diagram.
The block diagram shows the logic of the application.
4. The only thing left to do is to run the examples! Navigate to
Operate → Run.
5. The application will run.
You can determine that your device is connected to your application if you see the indicator for
attached turn green and the correct serial number is displayed. These features are available in most of the example
vis we provide.
6. When you are ready to terminate the application, click on the button to release the hold on the device. Please keep in mind that the application may not terminate properly if you stop it by clicking on
Operate → Stop.
Once you have the LabVIEW examples running, we have a teaching section below to help you follow them.
Write Your Own Code
When you are building a project from scratch, or adding Phidget function calls to an existing project, you'll need to add the Phidget LabVIEW library to your development environment. To begin:
1. Navigate to
Tools → Advanced → Edit Palette Set to modify the functions palette.
2. The functions palette will show up. Right click an empty area, and select
Insert → Subpalette.
3. Next, select
Link to a directory.
4. Make sure you have the Phidget LabVIEW library and examples in the Quick Downloads section downloaded and extracted. After extracting, you will find the
Phidgets folder. In LabVIEW, browse to the
Phidgets folder, and select
This will load the Phidget LabVIEW library into the functions palette. You can find all the functions that pertain to Phidgets inside the
5. Click on
Save Changes in the
Edit Controls and Functions Palette Set window.
The project now has access to the Phidget function calls and you are ready to begin coding.
The same teaching section which describes the examples also has further resources for programming your Phidget.
Follow the Examples
By following the instructions for your operating system and compiler above, you probably now have a working example and want to understand it better so you can change it to do what you want.
Since LabVIEW is a graphical language, the best way to get the 'code snippets' you need is to take them from our examples. The best way to find what blocks exist and how to use them is probably to switch between the block diagram view and the GUI view between examples that apply to you. This will allow you to use pieces from our examples to create your own LabVIEW application.
Your main reference for writing LabVIEW code will be our LabVIEW API information, with syntax for all of our functions:
- API Manual (This is the complete set of functions you have available for all Phidgets)
- Device Specific APIs - The one for your Phidget can be found in its user guide.
To learn the details behind opening, configuring, using, and closing your Phidget, try the General Phidget Programming page. That page also describes using the Phidget in an event-driven manner and in a traditional manner, both of which are available in LabVIEW.
If you are really getting in to using Phidgets, you probably want our more general programming resources as well. Although these are focused on the text-based languages that we support (C++, Java, etc), the concepts remain the same on how Phidgets are used within code. Our General Phidget Programming page gives more information about:
- Using Multiple Phidgets (or a Phidget other than the Interface Kit)
- Catching exceptions and errors and using logging
- Event catching versus direct polling
- And more....
Of course, most of these concepts are covered using block flow within LabVIEW, but knowing the general order of operations can help you structure your code.
LabVIEW Error Codes
LabVIEW uses a number of Phidget specific error codes which are not always well described when they pop up. If you are debugging your application and are running into one that you cannot figure out you can get more information from the Phidget Error Codes list under "Software Errors". The LabVIEW error codes are just the Phidget error codes + 7000.
Common Problems and Solutions/Workarounds
Issue: Events can occasionally cause issues, especially when there are multiple of the same type of event
In other words, if you open 2 Interface Kits and have a sensor change event for each one your system can behave unpredictably. This problem is a quirk in the way that LabVIEW handles passing pointers to C. There are a few solutions to this issue, either:
- Stop using events and simply poll the device. Events work similarly to polling in LabVIEW anyway and should not cause substantial performance changes to your application.
- Implement a simple fix to the events which are causing the problem. The pointer is identical in the case where two events of the same type are passed from a single function. This causes the events in C to output to the same event in LabVIEW. To get around this you would need to copy the offending subVI, then change the name of the cluster object in it from "Event" to something else (your choice), change the name of the .vi to something else and then use those two different subVIs in your program. You would need to repeat this for each subsequent event of the same type you wish to have.
Either solution will work and while the first is a bit cleaner the second will work just as well.
Issue: I cannot attach to an object any more after running my program once
What this means is you probably halted the VI instead of using the stop button. Halting operation will not release the Phidget device properly and will consequently make it unusable until LabVIEW has been exited and restarted. In order to prevent this from happening you should always use the stop button instead of simply halting operation. That way the close subVI gets called and the Phidget will be released.