This example shows how to acquire analog input data using non-blocking commands. This allows you to continue working in the MATLAB command window during the acquisition. This is called background acquisition. Use foreground acquisition to cause MATLAB to wait for the entire acquisition to complete before you can execute your next command. Learn more about foreground acquisition in Acquire Data Using NI devices.
|On this page…|
Use the daq.createSession command to create a session.
Add channel 0 from our NI 9205 with the ID of cDAQ1Mod1.
Acquire 2000 scans per second for 5 seconds worth of data.
s = daq.createSession('ni'); s.addAnalogInputChannel('cDAQ1Mod1', 0, 'Voltage'); s.Rate = 2000; s.DurationInSeconds = 5; s
s = Data acquisition session using National Instruments hardware: Will run for 5 seconds (10000 scans) at 2000 scans/second. Number of channels: 1 index Type Device Channel MeasurementType Range Name ----- ---- --------- ------- --------------- ---------------- ---- 1 ai cDAQ1Mod1 ai0 Voltage (Diff) -10 to +10 Volts
When you acquire data in the background, you can provide the acquisition session directions to handle the incoming data, using listeners and events. A DataAvailable event occurs when a specific amount of data is available to the session. A listener can respond to that event and initiate specified function.
Use addlistener to add an anonymous function to the session. This function is called every time the DataAvailable event occurs, and plots the acquired data against time. By default this listener is called 10 times per second.
When you add a listener, a handle to the listener is returned. Save the handle in the variable lh and delete it later.
lh = s.addlistener('DataAvailable', @(src,event) plot(event.TimeStamps, event.Data));
The default rate that the listener is called is 10 times a second. However, you can change this my modifying the NotifyWhenDataAvailableExceeds property. The listener will be called when the number of points accumulated exceeds this value. In this case, we set it to 2000, which results in a frequency of once per second.
s.NotifyWhenDataAvailableExceeds = 2000;
After you add the listener, start the background acquisition. When you run this example in MATLAB a plot updates 10 times a second. In the published version of the example you see two snapshots of the plot: one, after the pause completes and the other at end of the acquisition.
There are no other calculations to perform and the acquisition is set to run for the entire 5 seconds. Wait for the acquisition to complete. Call wait with no argument, which defaults to an infinite wait time. The wait command returns as soon as the background acquisition completes.
Delete the listener so that it does not run with the next acquisition.
In some cases there is no fixed time or number of scans to acquire. You may want to acquire continuously until a specific condition is met. In this example, acquire until the signal exceeds 1V.
Reset the rate at which the listener is called to the default of ten times per second by setting the IsNotifyWhenDataAvailableExceedsAuto property to true.
s.IsNotifyWhenDataAvailableExceedsAuto = true;
Configure a new listener to process the incoming data.
lh = s.addlistener('DataAvailable', @stopWhenExceedOneV);
stopWhenExceedOneV is a multi-line function, stored in a separate MATLAB file.
function stopWhenExceedOneV(src, event) if any(event.Data > 1.0) disp('Event listener: Detected voltage exceeds 1, stopping acquisition') % Continuous acquisitions need to be stopped explicitly. src.stop() plot(event.TimeStamps, event.Data) else disp('Event listener: Continuing to acquire') end end
Configure the session to acquire continuously. The listener detects the 1V event and calls stop.
s.IsContinuous = true; s.startBackground()
Use pause in a loop to monitor the number of scans acquired for the duration of the acquisition. Note that the output is mixed in with output from the event listener.
while s.IsRunning pause(0.5) fprintf('While loop: Scans acquired = %d\n', s.ScansAcquired) end fprintf('Acquisition has terminated with %d scans acquired\n', s.ScansAcquired);
Event listener: Continuing to acquire Event listener: Continuing to acquire Event listener: Continuing to acquire Event listener: Continuing to acquire Event listener: Continuing to acquire While loop: Scans acquired = 1005 Event listener: Detected voltage exceeds 1, stopping acquisition While loop: Scans acquired = 1205 Acquisition has terminated with 1205 scans acquired
Delete the listener.