hil_monitor_read_interrupt :: QUARC MATLAB Functions

navigation bar

hil_monitor_read_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.

Reads the current state of the interrupt sources associated with the monitor.

Syntax

[states, n, err] = hil_monitor_read_interrupt(monitor)

Description

Reads the current state of the interrupt sources associated with the monitor. This function will block until the requested number of samples has been read or the monitor is stopped. Any interrupts that are detected are acknowledged. Hence, calling hil_monitor_read_interrupt twice in a row will result in the second call blocking unless a second interrupt occurs between the two calls to hil_monitor_read_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

monitor

The monitor handle returned by hil_monitor_create_interrupt_reader.

Outputs

states

A vector of interrupt states, as int8s. There is one element for each channel, indicating whether the interrupt occurred or not.

The number of interrupts which actually occurred. This value will be equal to the number of non-zero elements in the states output.

err

A negative error code or zero on success.

Examples

monitor = hil_monitor_create_interrupt_reader(board, 0);
hil_monitor_start(monitor);                         % Start the monitor
for i=1:10
    states = hil_monitor_read_interrupt(monitor);   % Queries interrupt source 0. Does not return until the interrupt occurs.
    ...
end;
hil_monitor_stop(monitor);  % Always good to call hil_monitor_stop even if monitor stops itself
hil_monitor_delete(monitor);