quanser.hardware.monitor.start :: QUARC MATLAB Functions

navigation bar

quanser.hardware.monitor.start

Starts a monitor.

Syntax

err = monitor.start

Description

Starts a monitor. The monitor will begin querying the status of the interrupt sources associated with the monitor. The monitor may be stopped using the stop function. Since the read_interrupt function blocks and MATLAB is not multi-threaded, it is often preferable to use the quanser.hardware.hil.poll_interrupt function instead of monitors.

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

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 hil_monitor_stop even if monitor stops itself
monitor.close;