hil_task_create_other_reader_other_writer

navigation bar

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.

Creates a task to read the specified other channels and write to the specified other channels.

Syntax

[task, err] = hil_task_create_other_reader_other_writer(board, samples_in_buffer, input_channels, output_channels)

Description

Creates a task to read the specified other channels and write to the specified other channels. The task must be deleted using the hil_task_delete or the hil_task_delete_all function. Tasks are used for operation such as data streaming and control. Tasks maintain an internal buffer into which samples are read or from which samples are written in the background once the task is started. Data may be written asynchronously to this buffer using the task_write functions or read from this buffer using the task_read functions.

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.

samples_in_buffer

The number of samples in the task's internal buffer. For double-buffering, make this parameter twice the size of the number of samples written using task_write_other.

input_channels

A vector of input channel numbers. Channel numbers are zero-based.

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

output_channels

A vector of output channel numbers. Channel numbers are zero-based.

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

Outputs

task

A task structure. Fields of the structure should never be modified.

err

A negative error code or zero on success.

Examples

% Creates a task to read other channel 5, and write to other channels 0 and 3, with an internal buffer of 1000 samples.
task = hil_task_create_other_reader_other_writer(board, 1000, [0 3], 5);