|
|
|
| R2012a Documentation → Data Acquisition Toolbox | |
Learn more about Data Acquisition Toolbox |
|
| Contents | Index |
AO = analogoutput('adaptor')
AO = analogoutput('adaptor',ID)Note You cannot use the legacy interface on 64–bit MATLAB. Use the session-based interface to acquire and generate data. |
'adaptor' | The hardware driver adaptor name. The supported adaptors are advantech, mcc, nidaq, and winsound. |
ID | The hardware device identifier. ID is optional if the device object is associated with a sound card having an ID of 0. |
AO | The analog output object. |
AO = analogoutput('adaptor') creates the analog output object AO for a sound card having an ID of 0 (adaptor must be winsound). This is the only case where ID is not required.
AO = analogoutput('adaptor',ID) creates the analog output object AO for the specified adaptor and for the hardware device with device identifier ID. ID can be specified as an integer or a string.
Note The Traditional NI-DAQ adaptor will be deprecated in a future version of the toolbox. If you create a Data Acquisition Toolbox™ object for Traditional NI-DAQ adaptor beginning in R2008b, you will receive a warning stating that this adaptor will be removed in a future release. See the supported hardware page at www.mathworks.com/products/daq/supportedio.html for more information. |
When an analog output object is created, it does not contain any hardware channels. To execute the device object, hardware channels must be added with the addchannel function.
You can create multiple analog output objects that are associated with a particular analog output subsystem. However, you can typically execute only one object at a time.
The analog output object exists in the data acquisition engine and in the MATLAB workspace. If you create a copy of the device object, it references the original device object in the engine.
If ID is a numeric value, then you can specify it as an integer or a string. If ID contains any nonnumeric characters, then you must specify it as a string.
The Name property is automatically assigned a descriptive name that is produced by concatenating adaptor, ID, and -AO. You can change this name at any time.
Notes When you create an analog output object, it consumes system resources. To avoid this issue, make sure that you do not create objects in a loop. If you must create objects in a loop, make sure you delete them within the loop. |
When data acquisition devices are installed, they are assigned a unique number which identifies the device in software. The device identifier is typically assigned automatically and can usually be manually changed using a vendor-supplied device configuration utility. National Instruments refers to this number as the device number.
For sound cards, the device identifier is typically not exposed to you through the Microsoft Windows environment. However, Data Acquisition Toolbox software automatically associates each sound card with an integer ID value. There are two cases to consider:
If you have one sound card installed, then ID is 0. You are not required to specify ID when creating an analog output object associated with this device.
If you have multiple sound cards installed, the first one installed has an ID of 0, the second one installed has an ID of 1, and so on. You must specify ID when creating analog output objects associated with devices not having an ID of 0.
There are two ways you can determine the ID for a particular device:
Type daqhwinfo('adaptor').
Execute the vendor-supplied device configuration utility.
| SampleRate | Specify per-channel rate at which analog data is converted to digital data, or vice versa |
| TriggerType | Specify type of trigger to execute |
| ChannelName | Specify descriptive channel name |
| DefaultChannelValue | Specify value held by analog output subsystem |
| HwChannel | Specify hardware channel ID |
| Index | MATLAB index of hardware channel or line |
| NativeOffset | Indicate offset to use when converting between native data format and doubles |
| NativeScaling | Indicate scaling to use when converting between native data format and doubles |
| OutputRange | Specify range of analog output hardware subsystem |
| Parent | Indicate parent (device object) of channel or line |
| Type | Indicate device object type, channel, or line |
| Units | Specify engineering units label |
| UnitsRange | Specify range of data as engineering units |
| InitialTriggerTime | Absolute time of first trigger |
| TriggerFcn | Specify callback function to execute when trigger occurs |
| TriggersExecuted | Indicate number of triggers that execute |
| TriggerType | Specify type of trigger to execute |
| Running | Indicate whether device object is running |
| SamplesAvailable | Indicate number of samples available per channel in engine |
| SamplesOutput | Indicate number of samples output per channel from engine |
| Sending | Indicate whether data is being sent to hardware device |
| ClockSource | Specify clock that governs hardware conversion rate |
| SampleRate | Specify per-channel rate at which analog data is converted to digital data, or vice versa |
| MaxSamplesQueued | Indicate maximum number of samples that can be queued in engine |
| RepeatOutput | Specify number of additional times queued data is output |
| Timeout | Specify additional waiting time to extract or queue data |
| RuntimeErrorFcn | Specify callback function to execute when run-time error occurs |
| SamplesOutputFcn | Specify callback function to execute when predefined number of samples is output for each channel group member |
| SamplesOutputFcnCount | Specify number of samples to output for each channel group member before samples output event is generated |
| StartFcn | Specify callback function to execute before device object runs |
| StopFcn | Specify callback function to execute after device object runs |
| TimerFcn | Specify callback function to execute when predefined time period passes |
| TimerPeriod | Specify time period between timer events |
| TriggerFcn | Specify callback function to execute when trigger occurs |
| BufferingConfig | Specify per-channel allocated memory |
| BufferingMode | Specify how memory is allocated |
| Channel | Contain hardware channels added to device object |
| EventLog | Store information for specific events |
| Name | Specify descriptive name for the channel |
| OutOfDataMode | Specify how value held by analog output subsystem is determined |
| Tag | Specify device object label |
| Type | Indicate device object type, channel, or line |
| UserData | Store data to associate with device object |
To create an analog output object for a National Instruments device defined as 'Dev1':
AO = analogoutput('nidaq','Dev1');To create an analog output object for a Measurement Computing device defined as '1':
AO = analogoutput('mcc','1');addchannel | daqhwinfo | Name
Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.
| © 1984-2012- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |
