hil_write_digital :: Quanser C Functions

navigation bar

hil_write_digital

Writes to digital outputs immediately.

Description

The hil_write_digital function writes to the specified digital output channels immediately. The function does not return until the data has been written.

Warning Many cards allow the digital I/O lines to be programmed as inputs or outputs. The digital I/O lines are configured as inputs or outputs using the hil_set_digital_directions function. All the channels which will be used as digital outputs must be configured as outputs using this function. Failure to configure the digital I/O may result in the hil_write_digital function failing to write those outputs.

Prototype

t_error
hil_write_digital(t_card card, const t_uint32 digital_channels[], t_uint32 num_channels, const t_boolean buffer[]);

Parameters

t_card card

A handle to the board, as returned by hil_open .

const t_uint32 [] digital_channels

An array containing the channel numbers of the digital outputs to be written.

Select a board type from the list for board-specific details: .

t_uint32 num_channels

The number of channels specified in the digital_channels array.

const t_boolean [] buffer

An array containing the binary values to write to the digital outputs. The array must contain num_channels elements. Each element in the buffer array corresponds to the same element in the digital_channels array.

Return value

The return value is 0 if the digital outputs are written successfully. Otherwise a negative error code is returned. Error codes are defined in quanser_errors.h. A suitable error message may be retrieved using msg_get_error_message .

Error codes

QERR_HIL_WRITE_DIGITAL_NOT_SUPPORTED

This function is not supported by the board-specific HIL driver for this board type.

QERR_INVALID_CARD_HANDLE

An invalid card handle was passed as an argument. Once a card has been closed using hil_close the card handle is invalid.

QERR_MISSING_DIGITAL_OUTPUTS

The digital_channels argument is NULL. If the number of channels is greater than zero then a channel vector must be provided.

QERR_MISSING_DIGITAL_OUTPUT_BUFFER

The buffer argument is NULL. If the number of channels is greater than zero then a buffer must be provided.

QERR_TOO_MANY_DIGITAL_OUTPUT_CHANNELS

Too many digital output channels were specified.

QERR_INVALID_DIGITAL_OUTPUT_CHANNEL

One of the digital output channels that was specified is not a valid channel number. Channel numbers range from 0 to one less than the number of channels.

QERR_DRIVER_INCOMPATIBLE_WITH_BOARD_DLL

The board-specific HIL driver passed an invalid parameter to the operating system specific kernel-level driver for the board. The board-specific HIL driver is likely not compatible with the operating system specific kernel-level driver for the board. Make sure both are up-to-date and compatible versions.

QERR_INTERNAL_BUFFER_TOO_SMALL

The board-specific HIL driver used an internal buffer that was too small for the operating system specific kernel-level driver for the board. The board-specific HIL driver is likely not compatible with the operating system specific kernel-level driver for the board. Make sure both are up-to-date and compatible versions.

QERR_OUT_OF_REQUIRED_SYSTEM_RESOURCES

There are not enough system resources to perform the requested operation. Try rebooting, requesting fewer samples, or adding more memory to your machine.

Requirements

Include Files	Libraries
hil.h	hil.lib;quanser_runtime.lib;quanser_common.lib

Examples


/*
* Write to the first four digital output channels.
*/

t_uint32  channels[] = { 0, 1, 2, 3 };
t_boolean buffer[]   = { 0, 1, 1, 0 };
t_error result = hil_write_digital(board, channels, ARRAY_LENGTH(channels), buffer);

navigation bar