Data Acquisition Toolbox™

digitalio - Create digital I/O object

Syntax

DIO = digitalio('adaptor',ID)

Arguments

`'``adaptor``'`	The hardware driver adaptor name. The supported adaptors are `advantech`, `keithley`, `mcc`, `nidaq`, and `parallel`.
`ID`	The hardware device identifier.
`DIO`	The digital I/O object.

Description

DIO = digitalio('adaptor',ID) creates the digital I/O object DIO for the specified adaptor and for the hardware device with device identifier ID. ID can be specified as an integer or a string.

Remarks

More About Creating Digital I/O Objects

When a digital I/O object is created, it does not contain any hardware lines. To execute the device object, hardware lines must be added with the addline function.
You can create multiple digital I/O objects that are associated with a particular digital I/O subsystem. However, you can execute only one of these digital I/O objects at a time for the generation of timing events.
The digital I/O 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.
The Name property is automatically assigned a descriptive name that is produced by concatenating adaptor, ID, and -DIO. You can change this name at any time.

The Parallel Port Adaptor

The toolbox provides basic DIO capabilities through the parallel port. The PC supports up to three parallel ports that are assigned the labels LPT1, LPT2, and LPT3. You can use only these ports. If you add additional ports to your system, or if the standard ports do not use the default memory resources, they will not be accessible by the toolbox. For more information about the parallel port, refer to Parallel Port Characteristics.

More About the Hardware Device Identifier

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.

There are two ways you can determine the ID for a particular device:

Type daqhwinfo('adaptor').
Open the vendor-supplied device configuration utility.

Examples

Create a digital I/O object for a National Instruments device defined as device number 1.

DIO = digitalio('nidaq','Dev1');

Create a digital I/O object for parallel port LPT1.

DIO = digitalio('parallel','LPT1');