Quanser QCar 2

The Quanser QCar 2 is a scale-model car built and sold by Quanser Inc. The QUARC Target associated with the Quanser QCar 2 is the QUARC Linux QCar 2 Target. The QCar 2 driver provides access to the hardware I/O available on the QCar 2 platform. The QCar 2 includes an NVIDIA Jetson AGX Orin board with an ARM Cortex-A78AE processor (2.2 GHz, eight core, 64 bit) as well as an NVidia GPU (930 MHz, 1792 CPU cores, 56 Tensor cores, Ampere architecture) with CUDA support, 360 degree camera view via four wide-angle 8MP cameras, an Intel D435 RGBD camera and additional I/O supplied by Quanser. There is also a Pi connector for an additional IMX219, IMX477 or OV9281 camera. The additional I/O includes:

• 2 user PWM output channels. Standard PWM, RC, OneShot and Multishot are all supported.
• Motor throttle control
• Steering control
• 2 unipolar user analog input channels, 12-bit, +3.3V
• Battery level, electronics current and motor current analog inputs
• 3 encoder channels (motor position plus up to two additional encoders).
• 11 reconfigurable digital I/O
• 3 user buttons
• 16 LEDs with intensity control for car headlights and signals
• 33 individually programmable RGB LEDs for bottom lighting
• 3-axis 16-bit accelerometer, range configurable for ±2g to ±16g.
• 3-axis gyroscope, range configurable for ±15.625 deg/s to ±2000 deg/s.
• temperature sensor
• 2 general purpose 3.3V high-speed serial ports*
• 1 high-speed 3.3V SPI port (up to 25 MHz)*
• 1 1.8V I2C port (up to 1 MHz)*
• 1 3.3V I2C port (up to 1 MHz)*
• 2 CAN bus interfaces (supporting CAN FD)
• 1 USB port
• 1 USB-C host port
• 1 USB-C On-the-Go port (host or device)
• LCD display (black & white, 400x240 pixels)
• 4 microphones
• 1 speaker
• Integrated with MATLAB/Simulink/Simulink Coder via the NVIDIA Jetson AGX Orin board and Quanser QUARC

* Communications channels are accessed through the Stream API blocks, see Serial protocol, SPI protocol and I2C protocol.

The QUARC driver name for this card is qcar2. The latest operating system installed on the Quanser QCar 2 is a customized version of Linux for Tegra from JetPack 5.1.4.

The Quanser QCar 2 uses the Quanser standard reference frame for unmanned vehicles, as shown below:

To select the Quanser QCar 2 board, select the QUARC qcar2 board type from the drop-down list on the Main tab of the HIL Initialize block. Please note that only one QCar 2 card can be connected to a Quanser QCar 2 and is supported in the system. The QUARC controller runs on the NVIDIA Jetson AGX Orin board.

The Quanser QCar 2 supports three different means of communicating with it as a target. It supports wireless (WiFi) communications, which are most readily configured initially by connecting a monitor, mouse and keyboard and using the Ubuntu desktop to connect to the WiFi router. If a wireless connection is used then its IP address will show up on the LCD display with a WiFi symbol beside it. Once configured, it should reconnect automatically whenever the WiFi signal is available.

The Quanser QCar 2 also supports a 10/100/1000 Mbps wired LAN connection. If the LAN connection is used, its IP address will show up on the LCD display with a LAN symbol beside it. In the case of WiFi or LAN the IP address is determined by the adapter settings. Typically, the IP address is assigned dynamically by a DHCP server on the network.

Finally, the USB-C On-the-Go port acts as an Ethernet connection when it is connected to a PC. In this case, the IP address will not be shown on the LCD display but the address is always the same and will be 192.168.55.1. The PC to which it is connected will also be assigned an IP address on this "network", such as 192.168.55.100.

Configuration

The Quanser QCar 2 is configured for the 3S battery supplied with the vehicle. The car does not support using a 4S battery. The car will shut down if a 4S battery is used.

Display

The LCD display normally displays the battery voltage, disk usage, CPU usage, hostname, WiFi SSID, WiFi IP address, LAN IP address and QUARC version on the QCar. It also shows the current WiFi signal strength. The following table shows some of the different status messages that may be displayed by the QUARC Power Monitor daemon on the LCD display. The power monitor only updates the display every ten seconds by default.

The LCD display on Quanser QCar 2 is a graphical black and white LCD display. QUARC supports writing text or graphics to the display using the LCD Display block. To use the LCD Display block, set the LCD to LS027B7DH01 and the URI to spi://localhost:1?word=8,baud=45000000,polarity=on,phase=on,memsize=8192,frame=0. The display supports normal mode or dark mode, as well as an image or text. It can also rotate the display. To format text for the display, use the String Print block, which supports a superset of standard C format strings. The display currently supports the Basic Latin character set as well as the Latin-1 Supplement. For images, the resolution of the display is 400 x 240 pixels. Greyscale images will be thresholded at mid-luminance to produce the black and white output. For optimal display of images, use the Image transform block with the Dither (1-bit) algorithm to convert grayscale images to black and white.

Cameras

The QCar supports four onboard 8MP wide-angle cameras and one Intel RealSense D435 camera. While these are accessed using the Video3D Capture and Video Capture blocks, they are listed here for convenience:

The CSI cameras are 8MP cameras with up to 3280x2464 resolution. The frame rates achievable at each resolution are listed for convenience in the table below:

Other resolutions are achievable but will be scaled versions of the resolutions in the above table. Hence, resolutions with a different aspect ratio may appear distorted. Camera resolutions were designed to always provide the full horizontal field of view of the camera rather than provide common video resolutions.

The Intel RealSense D435 camera is a 2MP camera with up to 1920x1080 resolution for the RGB camera and up to 1280x720 resolution on the depth and infrared cameras. The frame rates achievable at each resolution are listed for convenience in the table below. The maximum frame rate of the RGB camera is 60 FPS and of the depth and infrared cameras is 100 FPS, if the appropriate resolution is selected.

The maximum frame rates at each resolution are:

The Intel RealSense Viewer application is provided on the Quanser QCar 2 for testing the RGBD camera. It may also be used for calibration and firmware updates of the RealSense camera. To run the Intel RealSense Viewer, run the realsense-viewer from a Terminal on the QCar. Turn on the Stereo Module and RGB Camera to see the depth and RGB output from the camera. To update the firmware or calibrate the camera, see the options under the More hamburger menu. Note that the images can be viewed in 2D or 3D mode using the "2D | 3D" options in the top, right. Options for the Stereo Module and RGB Camera may be adjusted by expanding the respective item.

The Quanser QCar 2 also supports three different cameras on its Pi connector: the IMX219 (Pi RGB camera), the IMX477 (high-quality Pi RGB camera) and the OV9281 (greyscale global-shutter). To select the camera to use, the jetson-io tool is provided. Run the jetson-io tool by opening a terminal on the Quanser QCar 2 and running the following command:

sudo /opt/nvidia/jetson-io/jetson-io.py

The following page will be presented:

Select the Configure Jetson AGX CSI Connector option using the cursor keys and then press Enter to open the connector page, shown below.

Then select the Configure for compatible hardware option using the cursor keys and press Enter to open the compatible hardware page, illustrated below.

Choose the relevant camera with the cursor keys and press Enter. The camera will be selected and the menu will return to the compatible hardware page. However, this time there will be options to discard the changes or save the changes:

Save the changes by selecting Save pin changes using the cursor keys and pressing Enter. To discard the changes, select Discard pin changes instead. When saving the changes, the following page will appear:

Choose the Save and exit without rebooting option using the cursor keys and then press Enter to complete the operation. The final exit page will be shown:

Press Enter to exit the Jetson I/O application. Then shut down the Quanser QCar 2 using the user interface or by issuing a shutdown command:

sudo shutdown now

Connect the selected camera to the Pi connector and power-up the car. The camera should now be available for use.

Communications

The communications ports provided on the QCar board can be utilized through the QUARC Communications blockset and the Quanser Stream API (see QUARC Communications Protocols).

SPI

For SPI communications, a sample URI for communications would be:

spi://localhost:0?baud='1000000',polarity='off',phase='off',lsb='off',frame='0'

where the frame option selects the SPI SS line to frame the SPI bus transaction (0 or 1).

I2C

For I2C communications, a sample URI for communications would be:

i2c://localhost:1?baud='400000',address=0x69

where the address option specifies the I2C slave address. Valid ports are 1 or 7 for I2C1 and IC27 respectively. Note that I2C1 is 3.3V while I2C7 is 1.8V.

Serial

For serial communications, a sample URI for communications would be:

serial://localhost:0?baud='115200',word='8',parity='none',stop='1'

where the port determines whether UART 0 (port 0), UART 1 (port 1) or UART 2 (port 2) is being used. UART 0 is recommended for generic serial devices. It supports baud rates up to 12.5 MBaud. UART2 is more CPU intensive. UART1 is used for the LIDAR, but if the LIDAR is unplugged then its UART may be used as a general-purpose serial port (for GPS or sonar, for example).

The Ranging Sensor block is typically used to talk to the LIDAR rather than using the serial port directly.

CAN Bus

For CAN bus communications, a sample URI for communications would be:

can://localhost:0?flexible='1'

where the port determines whether CAN 0 (port 0) or CAN 1 (port 1) is being used. However, before using CAN bus, the CAN bus network interfaces must be configured. To configure CAN bus, first load the necessary kernel drivers using the commands:

sudo modprobe can
sudo modprobe can_raw
sudo modprobe mttcan
        

Then to bring up CAN 0 for CAN FD with a 500 kHz standard rate and 2 MHz data rate, use the commands:

sudo ip link set can0 type can bitrate 500000 sjw 4 dbitrate 2000000 dsjw 4 fd on berr-reporting on restart-ms 100
sudo ip link set up can0
        

Likewise for CAN 1:

sudo ip link set can1 type can bitrate 500000 sjw 4 dbitrate 2000000 dsjw 4 fd on berr-reporting on restart-ms 100
sudo ip link set up can1
        

The CAN interfaces will now be visible when using the ifconfig command, just like other network interfaces.

Summary

The communications channels are summarized in the table below:

Audio

The Quanser QCar 2 provides one speaker and four microphones. The microphones are located at the four corners of the car and marked with a microphone symbol for easy identification. The microphones are intended for applications such as user interaction or sound localization, such as detecting the direction from which a honk is heard. If the microphone samples are streamed to a stereo headset on the host PC, the stereo effect is readily apparent.

The two rear microphones are configured as left and right channels of a rear stereo microphone. The device identifier for this rear stereo microphone is "plughw:1,0". Note that only one block or model may open the rear stereo microphone at one time.

The two front microphones are configured as left and right channels of a front stereo microphone. The device identifier for this front stereo microphone is "plughw:1,1". Note that only one block or model may open the front stereo microphone at one time.

To read all four microphones as a single quadraphonic microphone, use the device identifier "plughw:1,2". The purpose of this quadraphonic microphone configuration is to open up the potential for 3D sound localization, such as tracking an overhead drone. Note that only one block or model may open the quadraphonic microphone at one time.

The recommended device identifier for the speaker is "demixer". The demixer device is dynamically assigned based on whether an HDMI monitor with audio support is connected to the car. When an HDMI monitor with audio support is connected, the demixer output will go to the monitor. If the monitor has stereo speakers then stereo sound can be produced. If no HDMI monitor is connected, then the demixer device will output to the car speaker. In this case, the two channels will be mixed as the speaker is monophonic. The demixer device has the additional advantage that it allows the output device to be shared by multiple blocks or models.

The speaker may be used for honking, engine noises or even user interaction.

Clocks

There are currently no QCar clocks.

Analog Inputs

The QCar driver supports 5 analog inputs. Hence, analog input channel numbers range from 0 to 4. The analog input range is 0 to +3.3V and is not configurable. Exceeding this range may damage the board. Channels 0-1 are user analog inputs available on the J11 connector.

The battery level in Volts is reported at analog input channel 2. This signal should be monitored to ensure the battery does not degrade below safe levels, particularly for LiPo batteries. For the 3S battery, the voltage should not go below 10.5V. Note that the QCar contains emergency shutdown logic that will attempt to shut down the operating system and turn off the car if the battery voltage falls below 10V.

The current in Amperes used by the electronics is reported on analog input channel 3. This signal indicates how much of the battery current is being used to power the electronics.

The current in Amperes used by the motor is reported on analog input channel 4. This signal indicates how much of the battery current is being used to power the motor.

Analog Outputs

The Quanser QCar 2 card does not support analog outputs.

Digital Inputs

The Quanser QCar 2 supports 11 bidirectional digital I/O lines, as well as three user buttons and an overcurrent condition indicator which act as digital inputs. Hence digital input channel numbers range from 0 to 14. Digital lines 0-4 are available on the J10 connector while lines 5-10 are on the J11 connector. A digital I/O line cannot be used as an input and output at the same time.

The first 11 digital I/O lines may be individually programmed as inputs or outputs on the Quanser QCar 2. All of those 11 channels which will be used for digital inputs should be configured on the HIL Initialize block's Digital Inputs tab. Set the Digital input channels field to all the digital I/O channels that will be used as digital inputs on the board for the current diagram. For example, enter 0:3 to designate channels 0 through 3 as digital inputs. Specify [0, 4, 5] to indicate that channels 0, 4 and 5 are to be configured as digital inputs.

Digital Outputs

The Quanser QCar 2 supports 11 bidirectional digital I/O lines and sixteen LEDs for lights and turn signals. Hence digital output channel numbers range from 0 to 26. Digital lines 0-4 are available on the J10 connector while lines 5-10 are on the J11 connector. A digital I/O line cannot be used as an input and output at the same time.

Since the first 11 digital I/O lines may be individually programmed as inputs or outputs on the Quanser QCar 2, all the channels which will be used for digital outputs should be configured on the HIL Initialize block's Digital Outputs tab. Set the Digital output channels field to all the bidirectional digital I/O channels that will be used as digital outputs on the board for the current diagram. For example, enter 0:3 to designate channels 0 through 3 as digital outputs. Specify [0, 4, 5] to indicate that channels 0, 4 and 5 are to be configured as digital outputs.

To set the digital output values when the model is loaded or unloaded, set the Initial digital outputs and Final digital outputs to the desired values respectively. If the vectors specified in these fields are shorter than the channel vector, the value of the last element in the vector will be used for the rest of the channels. Hence, a scalar value will apply to all channels specified in the Digital output channels field.

Encoder Inputs

The Quanser QCar 2 supports three quadrature encoder inputs with 24-bit count values. Hence encoder channel numbers range from 0 to 2. Channel 0 is the motor encoder on connector J24. Channels 1-2 are user encoder channels available on connector J11.

In order to set the encoder counters to a particular count or to change the default quadrature when the model is loaded, the encoder inputs must be configured on the HIL Initialize block's Encoder Inputs tab. Set the Encoder input channels field to all the encoder channels that will be used on the board for the current diagram. For example, enter 0:2 to indicate channels 0 through 2 are used as encoder inputs. Specify [0, 2] to indicate that channels 0 and 2 are used as encoder inputs.

The Quanser QCar 2 supports 2x-quadrature and 4X quadrature. Since the Quanser QCar 2 has 24-bit counters, valid initial count values range from -8,388,608 to +8,388,607. If the vectors specified in these fields are shorter than the channel vector, the value of the last element in the vector will be used for the rest of the channels. Hence, a scalar value will apply to all channels specified in the Encoder input channels field.

The Quanser QCar 2 default sign convention in quadrature (4X) mode increments the encoder counter value when the B channel signal leads the A channel signal. Conversely, the encoder counter value is decreased when A leads B. This sign convention can be changed in the Board-Specific Options, with the enc0_dir option, for encoder channel 0, and with the enc1_dir and enc2_dir options for encoder channels 1 through 2, respectively. See the Board-Specific Options section below for more details.

PWM Outputs

The QCar driver supports 2 PWM output channels. Hence, PWM output channels range from 0 to 1. The PWM channels must share the same PWM frequency. However, each channel can have its own duty cycle. PWM channels available on connector J11.

In order to configure the PWM mode or frequency, or to set the value of the PWM outputs when the model is loaded or unloaded, the PWM outputs must be configured on the HIL Initialize block's PWM Outputs tab. Set the PWM output channels field to all the PWM output channels that will be used on the board for the current diagram. For example, enter 0:1 to indicate channels 0 and 1. Specify 1 to indicate channel 1 alone.

The PWM outputs are generic PWM outputs that are capable of producing conventional PWM, as well as the standard analog ESC protocols, namely standard PWM (1000us to 2000us), Oneshot125 (125us to 250us), Oneshot42 (42us to 84us) and Multishot (5us to 25us).

The ESC Output block is recommended for constructing the input to the PWM output channel since it allows a 0% to 100% throttle value to be used, and it will output the appropriate pulse time (for PWM-based protocols). Note that when using the ESC Output block, the PWM mode should be PWM_TIME_MODE (4) for PWM-based protocols.

The PWM parameters for each of these ESC protocols are tabulated below:

The PWM outputs are not restricted to these parameter values as they are generic PWM outputs. The maximum output frequency is 180 MHz. The number of bits of resolution decreases with increasing PWM output frequency.

Set the PWM output frequency (a.k.a., pulse rate) in the "Frequencies in Hz or duty cycle" field. The PWM output mode is typically set to duty cycle mode (0) or time mode (4) when driving ESCs or R/C servos. Set the Initial PWM outputs and Final PWM outputs fields to the desired initial and final output values respectively. The interpretation of these output values depends on the PWM mode selected. If the vectors specified in these fields are shorter than the channel vector, the value of the last element in the vector will be used for the rest of the channels. Hence, a scalar value will apply to all channels specified in the PWM output channels field. Likewise, for the PWM output mode for example, the default value is [0 0] so that the first '0' applies to the motor PWM, which must be duty cycle mode (0), and the second '0' applies to the rest of the PWM channels.

Other Inputs

The specific Other Input channels of the Quanser QCar 2 board are described in the table below. SI units are used.

As a reference, the generic table for the Other Inputs channels for any HIL Data Acquisition Card is reproduced below. SI units are used.

Note that the IMU may be read at any time, but measurements are updated internally at a fixed 32 kHz rate. The gyroscope and accelerometer can produce new values at this rate. The output data rate for the different IMU components may be set in the board-specific options (see below).

Other Outputs

The specific Other Output channels of the Quanser QCar 2 board are described in the table below. SI units are used.

The steering angle is tranlated into an RC servo command that is sent to the steering servomotor connected to J25.

Interrupts

The Quanser QCar 2 card, or its driver, does not support any interrupt sources.

Watchdog

The Quanser QCar 2 contains a programmable 16-bit watchdog timer. The timer may be programmed with any interval between 81.88 microseconds and 2.684 seconds. The board will reset digital outputs 5-10, PWM outputs 0 and 1, and other outputs to the user-configured values when the watchdog expires. Resetting of the outputs occurs without software intervention, and therefore may be used as a safety mechanism in the event of software failure. Note that digital outputs 0-4 cannot be reset on watchdog expiration and the steering analog and motor throttle may only be reset to zero.

Place a HIL Watchdog block in the diagram to program the 16-bit watchdog timer. This block also reloads the watchdog each time it is executed.

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

Hence, in Simulink models, the outputs will remain reset after watchdog expiration even after the model is stopped, unless a HIL Watchdog Clear block is used to clear the watchdog state. Restarting the model also causes the watchdog state to be cleared, allowing the outputs to be used once more. These semantics make the watchdog useful for ensuring product safety.

Board-Specific Options

The Quanser QCar 2 has a number of board-specific options to control specialized functionality of the Quanser QCar 2. These options configure the IMU and set the encoder directions.

gyro_fs

This option sets the full-scale range of the gyroscope sensor. Valid values range from 15.625 to 2000. The units are degrees per second.

gyro_rate

This option sets the gyroscope sensor's sampling rate. Valid values range from 12.5 to 32000. The units are Hz.

gyro_ord

This option sets the gyroscope sensor's filter order. Valid values range from 1 to 3.

gyro_bw

This option sets the gyroscope sensor's filter bandwidth. Valid values range from 10 to 16000. The units are Hz.

accel_fs

This option configures the full-scale range of the accelerometer. Valid values are 2 to 16. The units are g's.

accel_rate

This option sets the accelerometer's sampling rate. Valid values range from 12.5 to 32000. The units are Hz.

accel_ord

This option sets the accelerometer sensor's filter order. Valid values range from 1 to 3.

accel_bw

This option sets the accelerometer sensor's filter bandwidth. Valid values range from 10 to 16000. The units are Hz.

enc0_dir

Set this option to "yes", "y" or "1" to reverse the direction of encoder 0. This feature makes it easier to migrate to the Quanser QCar 2 hardware from another data acquisition card. It also allows models to be more portable to other cards.

Similar options exist for the other encoder channels i.e., enc1_dir and enc2_dir.

steer_bias

The QCar 2 chassis sometimes has a bias in the steering so that driving the steering output with zero does not produce a zero angle on the wheels i.e., the car may not drive in a straight line when the steering output is set to zero. To adjust for this bias, the steer_bias option may be used to add a small offset to the steering output to eliminate this bias. The value specified should be in radians and may be positive or negative as appropriate. Suitable values are typically between 0.03 and 0.09.

temp_bw

This option sets the temperature sensor's filter bandwidth. Valid values range from 5 to 4000. The units are Hz.

Properties

The Quanser QCar 2 supports the following integer properties:

Connectors

The Quanser QCar 2 board has a number of connectors for expansion I/O. These connectors and their pinouts are listed below.

J10 Connector (I2C)

J11 Connector (GPIO, ENCs, PWMs and ADCs)

⁵ 5V tolerant input pins

J19 Connector (CAN)

J24 Connector (Motor Encoder)

⁵ 5V tolerant input pins

J25 Connector (Steering)

J26 Connector (LIDAR)

Legend

Software

The following table lists particularly relevant software that has been installed and its associated version, in the event that the software gets upgraded accidentally and it is necessary to recover working versions. If a version is highlighted in red then it is highly recommended that it not be updated as it is likely optimized specifically for the target platform.

Targets

Copyright ©2024 Quanser Inc. This page was generated 2024-10-17. Submit feedback to Quanser about this page.

Link to this page.