quanser.hardware.monitor.read_interrupt

navigation bar

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

Syntax

[states, n, err] = monitor.read_interrupt

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 quanser.hardware.monitor.read_interrupt twice in a row will result in the second call blocking unless a second interrupt occurs between the two calls to quanser.hardware.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 instance returned by quanser.hardware.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 = board.monitor_create_interrupt_reader(0);
monitor.start;                         % Start the monitor
for i=1:10
    states = monitor.read_interrupt;   % Queries interrupt source 0. Does not return until the interrupt occurs.
    ...
end;
monitor.stop;  % Always good to call stop even if monitor stops itself
monitor.close;