Quanser Qube-Servo 3

The Quanser Qube-Servo 3 is an integrated DC-servo motor experiment. It is designed to help teach fundamental control concepts and theories on an easy-to-use and intuitive platform. For more information, visit Quanser Qube-Servo3

The QUARC driver name for this card is qube_servo3_usb.

• 1 single-ended analog input channel, 12-bit, ±3A
• 2 single-ended encoder input channels, 5V
• 1 single-ended analog output, ±15V to control the motor
• 1 PWM output, ±1 to control the motor when enabled with board-specific options
• 3 digital inputs for stall and fault conditions
• 1 digital output for amplifier enable
• 2 other inputs for digital tachometers
• 3 other outputs to drive the RGB LED strip
• Integrated with MATLAB/Simulink/Simulink Coder via Quanser QUARC

To select the Quanser Qube-Servo 3 HIL board, pass qube_servo3_usb as the card type argument to the hil_open function.

The Quanser Qube-Servo 3 I/O channels are described below.

Clocks

There are currently no configuration options for the Quanser Qube-Servo 3 clocks.

Analog Inputs

The Quanser Qube-Servo 3 supports one analog input, which is channel zero. The analog input measures the current to the motor in Amperes. Its maximum range is ±3A.

Analog Outputs

The Quanser Qube-Servo 3 supports one analog output, which is channel zero. The analog output drives the motor voltage. Its maximum range is ±15V. The pwm_en board specific option must not be set in order to use analog output on this card.

Digital Inputs

The Quanser Qube-Servo 3 supports three digital inputs, which are used for diagnostics. The digital inputs are enumerated in the table below.

Digital Outputs

The Quanser Qube-Servo 3 supports one digital output, which is channel zero. The digital output acts as an enable for the motor drive circuitry. When this output is low, the motor amplifier is disabled. When it is high, the motor amplifier is enabled.

The Quanser Qube-Servo 3 has internal stall detection and once a stall error is asserted, the amplifier is automatically disables itself. The card can be re-enabled by setting the output low then high again.

Encoder Inputs

The Quanser Qube-Servo 3 supports two encoder inputs. Both channels provide 24-bit count values. These two channels only support 4X quadrature mode. The encoder channels are enumerated in the table below:

In order to set the encoder counters to a particular count value use the hil_set_encoder_counts function.

The first two encoder inputs are sampled simultaneously when measured using a single HIL Read block.

PWM Outputs

The Quanser Qube-Servo 3 driver supports one PWM output channel, which is channel 0. Its maximum range is ±1 mapping to ±24V. Note, however, that the Quanser Qube-Servo 3 internally limits the output voltage to 15V or a corresponding PWM value of 0.625. The pwm_en board specific option must be set in order to use PWM output on this card.

The PWM mode, frequency or configurations are fixed and cannot be modified.

Other Inputs

The Quanser Qube-Servo 3 supports two other input channels, which are 32-bit digital tachometer readings based on a 72MHz counter. The other input channels are enumberated in the table below:

The units are counts/s.

Other Outputs

The Quanser Qube-Servo 3 supports three other output channels, allowing the color of the LED panel to be controlled. Note that each channel supports fractional values between 0 and 1, allowing full RGB color. Refer to the table below for a list of the channels:

Interrupts

The Quanser Qube-Servo 3 card, or its driver, does not support any interrupt sources.

Watchdog

The Quanser Qube-Servo 3 supports a watchdog timer for resetting the outputs on watchdog expiry. Namely, the analog, digital and other output channels will be reset to the user-defined values on watchdog expiry. Resetting of the outputs occurs without software intervention, and therefore may be used as a safety mechanism in the event of software failure.

To enable the watchdog, use the hil_watchdog_start function. Be sure to reload the watchdog periodically using the hil_watchdog_reload function to prevent the watchdog from expiring.

To configure the values to which the output channels are reset on watchdog expiry, use the hil_watchdog_set_analog_expiration_state, hil_watchdog_set_digital_expiration_state and hil_watchdog_set_other_expiration_state functions to set the analog, digital and other output values on watchdog expiration respectively.

Once the watchdog has expired, further I/O on the outputs is disabled until the watchdog state is cleared.

Use the hil_watchdog_clear function to clear the watchdog state. Note that stopping the watchdog does not clear the watchdog state. The watchdog state must be cleared explicitly.

Board-Specific Options

The Quanser Qube-Servo 3 has a number of board-specific options to control specialized functionality of the card.

pwm_en

Set this option to "yes", "y", or "1" to enable control of the motor using PWM command.

deadband_compensation

This option offsets the motor command by the specified voltage to compensate for amplifier deadband. The default value is deadband_compensation=0.65. This option is only available for analog outputs and will be ignored if the pwm_en option is used.

Properties

The Quanser Qube-Servo 3 driver currently supports the following read-only properties:

Targets

See Also

• Supported Quanser Cards

Copyright ©2023 Quanser Inc. This page was generated Thu 05/04/2023. Submit feedback to Quanser about this page.