Archived: Programming Data Acquisition for Linux with NI-DAQmx Base

For a comprehensive explanation of driver installation, supported platforms, supported hardware and known issues, please refer to the most recent version of the respective readme file.

General Installation Instructions for NI-DAQmx and NI-DAQmx Base:

1. Login to your Linux shell as root
2. Create a temporary folder on your local hard drive
3. Download the image of the latest version of NI-DAQmx for Linux or NI-DAQmx Base for Linux
4. Create a CD using the downloaded image or mount the image on your system
5. Install your hardware first before installing the driver software
6. Run “./INSTALL” from the CD or the mount created in step 4. The installer will:
   
   
   • Prompt you to read and respond to the terms of the NI software license
   • Automatically build and install the driver software kernel module
   • Install shared tools for device detection and configuration
   • Install LabVIEW and/or C API support

There are three ways to configure tasks in NI-DAQmx Base.

The first method, which is preferred, involves dynamically creating the task using DAQmx Base Create Task VI followed by the DAQmx Base Create Virtual Channel VI.  The steps to do this are listed below with the resulting block diagram in figure 1:

1. Create empty task using DAQmxBase Create Task.vi
2. Create a Thermocouple (TC) temperature measurement channel using DAQmxBase Create Virtual Channel.vi.
3. Specify the hardware timing parameters using DAQmxBase Timing.vi
4. Start the acquisition using DAQmxBase Start Task.vi
5. Read N samples using DAQmxBase Read.vi and Plot it. By default, the Read VI reads all available samples, but you can specify how many samples to read at a time and the timeout value. Continue reading data until the stop button is pressed or an error occurs.
6. Stop the task using DAQmxBase Stop Task.vi
7. Clear the Task using DAQmxBase Clear Task.vi
8. Use the pop up dialog box to display an error if any.

Figure 1:  DAQmx Base Thermocouple Example

Programming data acquisition with NI-DAQmx Base for Linux is analogous to NI-DAQmx. The NI-DAQmx Base VIs have all the same input and output terminals. The user can open each VI and tunnel down to the lowest level which leads to the RLP node. These RLP nodes call into chip objects for the hardware used. These RLP nodes are closed source. If personal modifications happen to break the driver, NI recommends reinstalling the driver as it is not possible to support personal modifications.

The second and third methods both use the NI-DAQmx Base Configuration Utility; the difference between the second and third method is how the utility is launched and used.

To use the second method, launch the NI-DAQmx Base Task Configuration Utility from the Tools menu in LabVIEW. Launching the utility from the Tools menu in LabVIEW includes any other tasks that may be in memory in LabVIEW at the time the utility is launched. Any changes made with the LabVIEW launched utility immediately takes effect in LabVIEW and on any C program launched after the utility is exited.

The third method involves running 'mxbaseconfig' from the command line. The 'mxbaseconfig' command opens the NI-DAQmx Base Task Configuration Utility. The utility saves its data to the same configuration file as the LabVIEW launched version, but changes made with this version are only be seen in LabVIEW if LabVIEW is restarted.

Figure 2: NI-DAQmx Base Task Configuration Utility

The NI-DAQmx Base installer includes example programs designed to demonstrate the correct use of the API for each measurement type.

LabVIEW Examples for LabVIEW are located in <LabVIEW>/examples/daqmxbase and are not indexed in the NI Example Finder.

C examples are installed by default to /usr/local/natinst/nidaqmxbase/examples. The make files create the links to the necessary libraries. Run the device configuration utility (lsdaq) before running the examples. An example that is shipped with NI-DAQmx Base is 'Acquire N Scans'. To compile and run this example:

1. cd /usr/local/natinst/nidaqmxbase/examples/ai
2. make
3. ./acquireNScans

LabVIEW help files are accessible from the LabVIEW Help menu.

Documentation is located in /usr/local/natinst/nidaqmxbase/documentation and includes the NI-DAQmx Base C Function Reference, the hardware references, and supporting PDFs.

For more information, please refer to the readme file available for download along with NI-DAQmx Base for Linux.

• Frequently Asked Questions About NI-DAQmx for Linux