daqhwinfo (Data Acquisition Toolbox)

Data Acquisition Toolbox

Search Help Desk

daqhwinfo

Examples

Display data acquisition hardware information.

Syntax

hwinfo = daqhwinfo

hwinfo = daqhwinfo('adaptor')

hwinfo = daqhwinfo(obj)

hwinfo = daqhwinfo(obj,'Field')

Description

hwinfo = daqhwinfo returns general hardware-related information as a structure to hwinfo. The information is contained in the fields shown below.


Field	Description
`ToolboxName`	Toolbox name
`ToolboxVersion`	Toolbox version
`MatlabVersion`	MATLAB version
`InstalledAdaptors`	Installed adaptors. For example, `winsound`, `nidaq`

hwinfo = daqhwinfo('adaptor') returns hardware-related information for adaptor as a structure to hwinfo. The information is contained in the fields shown below.


Field	Description
`AdaptorDllName`	Adaptor DLL name. For example, `mwwinsound.dll`
`AdaptorDllVersion`	Adaptor DLL version
`AdaptorName`	Adaptor name. For example, `winsound`
`BoardNames`	Board names. For example, `Sound Blaster Record`
`InstalledBoardIds`	Installed board hardware identifier.
`ObjectConstructorName`	Object constructor name. For example `subsystem('winsound')`

hwinfo = daqhwinfo(obj) returns hardware-related information for the device object obj as a structure to hwinfo. The information is contained in the fields shown below

hwinfo = daqhwinfo(obj, 'Field') returns the specified hardware-related information for the device object obj as a structure to hwinfo. Field can be a single field or a cell array of fields. The valid fields are shown below.


Field	Description
`AutoCalibrate`	Possible values are `On` or `Off`
`Bits`	Number of bits of resolution
ConversionOffset	Offset used by the engine when converting from binary values to volts (usually 0 except for 8-bit sound cards or 16-bit sound cards configured for 8 bit conversions)
`Coupling`	Possible values are `DC` or `AC Coupled`
`DeviceName`	Device name
`DifferentialChannels`	Number of differential channels (AI-only)
`DriverName`	Driver name
`Gains`	Gains (AI-only)
`ID`	Hardware identifier
`InputRanges`	Input ranges (AI-only)
`MaxSampleRate`	Maximum sample rate
`MinSampleRate`	Minimum sample rate
`NativeDataType`	Native data type
`OutputRanges`	Output ranges in volts (AO-only)
`Polarity`	Can be `Unipolar` or `Bipolar`
`SampleType`	Can be `SimultaneousSample` or `Scanning`
`SingleEndedChannels`	Number of single-ended channels (AI-only)
`SubsystemType`	Possible values are `AnalogInput`, `AnalogOutput`, or `DigitalIO`
`TotalChannels`	Total number of channels
VendorDriverDescription	Vendor driver description
VendorDriverVersion	Vendor driver version

Example

To display all the installed adaptors

hwinfo = daqhwinfo;
hwinfo.InstalledAdaptors
ans = 
    'winsound'
    'nidaq'

To display the subsystems for all installed winsound devices

hwinfo = daqhwinfo('winsound');
hwinfo.Subsystems
ans = 
    'AnalogInput AnalogOutput'

To display the input ranges for an analog input object created for a sound card

ai = analoginput('winsound');
hwinfo = daqhwinfo(ai);
hwinfo.InputRanges
ans = 
    '[-1 1]'

[ Previous | Help Desk | Next ]