hil_poll_interrupt :: QUARC MATLAB Functions

navigation bar

hil_poll_interrupt

Deprecated

The HIL API MATLAB functions have been deprecated in favour of the new quanser.hardware.hil class, which has support for code generation for Quanser targets. Hence, with the new hil class it is possible to run MATLAB scripts in real-time on Quanser targets, while making use of the Quanser hardware.

Polls the specified interrupt sources.

Syntax

states = hil_poll_interrupt(board, channels)

Description

Polls the specified interrupt sources. It does not block but returns immediately. Any interrupts detected are acknowledged. Hence, polling an interrupt source twice in a row will only indicate that an interrupt occurred the first time hil_poll_interrupt is called unless another interrupt occurs between the two calls to hil_poll_interrupt.

If no err output is provided then it throws an exception if an error occurs. In generated code it prints the error message. Use hil_get_error_message to get the message associated with an error code.

Parameters

board

The board handle returned by hil_open.

channels

A vector of channel numbers corresponding to interrupt sources. Channel numbers are zero-based.

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

Outputs

states

A logical vector indicating whether the interrupts occurred. There is one element for each channel.

err

A negative error code or zero on success.

Examples

% Polls interrupt sources 0, 3 and 5
states = hil_poll_interrupt(board, [0 3 5]);