cbDBitOut()

Sets the state of a single digital output bit.

This function treats all of the DIO ports of a particular type on a board as a single large port. It lets you set the state of any individual bit within this large port.

Most configurable ports require configuration before writing. Check board-specific information to determine if the port should be configured for your hardware. When configurable, use cbDConfigPort() to configure a port for output, and cbDConfigBit() to configure a bit for output.

Refer to the "Digital Input/Output Hardware" topic for additional information about the UL digital I/O functions.

Function Prototype

C/C++

int cbDBitOut(int BoardNum, int PortType, int BitNum, unsigned short BitValue)

Visual Basic

Function cbDBitOut(ByVal BoardNum&, ByVal PortType&, ByVal BitNum&, ByVal BitValue%) As Long

Arguments

BoardNum

The number associated with the board when it was installed with InstaCal or created with cbCreateDaqDevice(). BoardNum may be 0 to 99.

PortType

There are three general types of digital ports — ports that are programmable as input or output, ports that are fixed input or output, and ports for which each bit may be programmed as input or output. For the first of these types, set PortType to FIRSTPORTA. For the latter two types, set PortType to AUXPORT. For devices with both types of digital ports, set PortType to either FIRSTPORTA or AUXPORT, depending on which digital port you want to set.

BitNum

The bit number within the single large port. The specified bit must be in a port that is configured for output.

BitValue

The value to set the bit to. Value will be 0 (logic low) or 1 (logic high). Logic high does not necessarily mean 5 V – refer to the device hardware user guide for chip input specifications.

Returns