CL HIL Read Timebase (Mixed)

Parent Polymorphic VI: CL HIL Read Timebase

Requirements: Quanser Rapid Control Prototyping Toolkit, LabVIEW 2020 or newer, Control Design and Simulation Module

Description

Reads from analog, digital, encoder and/or other channels of a HIL board while establishing the timing of the simulation loop via a hardware timebase.

Required Inputs All required inputs must be wired. They always appear as terminals on the VI palette. They also appear in bold text in the context help window for the VI.

board in is a reference to a HIL Board instance that represents the open HIL board. This input must be wired to a valid HIL Board signal, as generated by a HIL Initialize VI.

Recommended Inputs or Dialog Box Options Recommended inputs need not to be wired. They may be selected to appear as terminals or dialog parameters, but show up as terminals by default. They appear in simple text in the context help window for the VI.

analog channels is an array of channel numbers indicating the analog input channels to be read. The voltages (or currents) read will appear at the analog voltages output.

encoder channels is an array of channel numbers indicating the encoder input channels to be read. The values read will appear at the encoder counts output.

digital channels is an array of channel numbers indicating the digital input channels to be read. The quantities read will appear at the digital states output.

other channels is an array of channel numbers indicating the other input channels to be read. The values read will appear at the other values output.

clock indicates which hardware timer on the HIL board is to be used as the timebase for the Simulation loop. For most applications, the default clock of zero is appropriate. Refer to the documentation for a specific HIL board for more details on the clocks available on that board.

samples in buffer determines the size of the hardware interrupt queue. Hardware interrupts generated by the timer on the HIL board are queued until they are processed by the application. This parameter dictates the size of that queue. Many cards only support a buffer size of one. Large buffer sizes are useful on soft real-time systems to allow the occasional sample to be lost if the application can tolerate it (particularly at startup).

Outputs

	board out is a copy of the HIL Board instance passed to the board in input.
	analog voltages is the analog voltages (or currents) read from the specified analog channels.
	encoder counts is the encoder counts read from the specified encoder channels.
	digital states is the states read from the specified digital channels.
	other values is the values read from the specified other channels.

Details

If any of the channels arrays are empty then those channels are not read. This VI allows a combination of different types of channels to be read at the same time. When mixed I/O operations are being performed, it is more efficient to use this VI than to include multiple VIs specific to each type of channel.

This VI employs a hardware timebase on the data acquisition card to drive the timing of the Simulation loop. The clock parameter determines which timebase on the board is used. The Simulation loop should be configured so that it is not synchronized to a timing source. Also, the priority of the application VI should be set to time-critical. The priority is found in the VI Properties under the Execution category.

Feedthrough Behaviour

All input/output pairs of this function have direct feedthrough behaviour.

Examples

RCP CL HIL Read Timebase Example

Targets

Target	Supported	Comments
RCP Windows (64-bit) Target	Yes	Fully supported.

navigation bar