QUARC ARCHITECTURE AND INSTALLATION OVERVIEW

QUARC is Quanser's state-of-the-art rapid prototyping and production system for real-time control. QUARC integrates seamlessly with Simulink to allow Simulink models to be run in real-time on a variety of targets, including 32-bit and 64-bit Windows, and various embedded platforms (please refer to the list of supported targets on the QUARC website).

QUARC Components

The following is a list of QUARC's installation components:

• QUARC Simulink Development Environment (SDE): This component is required to generate/build code from MATLAB and Simulink models.

• QUARC Targets: QUARC supports 32-bit and 64-bit Windows, and various embedded targets. The QUARC Target Manager runs the generated real-time code on the selected target. The target can be local (same machine as where the SDE is) or remote.

• Quanser License Manager: Manages licenses for Quanser products.

The above list includes the QUARC "installation components". Another term that will be used extensively in the upcoming sections of this document is "installation features" and needs to be clearly distinguished from "installation components" in order to avoid confusion. During the QUARC installation process, you will be asked to select the features you wish to install in one of the installation windows. Depending on the installation type you are performing, you might have to select specific features to be installed or not installed. You should refer to the appropriate section of this document for specific instructions for each installation type.

Figure 1.1 shows a snapshot of the installation window on the host machine in which you have to select the features you would like to install (note that the feature tree of the installation window on the target machine would be slightly different). As you can see from the figure, the QUARC hierarchy tree view item is divided into Host, Targets and Quanser License Manager.

Feature Selection Window

Note that the installation window groups different features under the hierarchy tree. Each branch is categorized for easier organization, but each leaf itself is the feature that needs to be selected for installation. The following table provides a brief summary of each feature and whether they can be installed on a host or target machine.

Caution: If any of the above feature becomes grey and disabled, it is either because you are not entitled to use this feature from the license or because you don't have the software required for this feature.

Another important distinction that needs to be made to avoid possible confusion is between the terms host, target, server and client. QUARC Host is the machine on which code is generated from MATLAB/Simulink models. QUARC Target is the machine on which the generated code runs. License Server is the machine on which the Quanser License Manager is installed in a network installation. A QUARC Host and a QUARC Target may both use the License Server to configure their product licensing. Client is a machine that uses the license server to configure its licensing and may either be a host or a target as noted. Throughout this document, the terms server and client are only used to specify a server/client relationship in the licensing sense and do not indicate the host/target relationship in any means.

There are two installation modes associated with QUARC, namely single-user installation and network installation. Depending on the license type you have purchased (i.e., single-user license or network license), you must follow the respective installation instructions found in the upcoming sections of this document. However, in order to familiarize the user with both modes and their overall architecture, a brief description of each is given below.

Single-User Mode

In the single-user mode (also referred as local mode), all of the above components are installed on a single machine and both the license manager and the QUARC product itself will be configured on this machine after the installation. A detailed description of this procedure is given in the Single-User Installation sections of this document and you should follow these instructions if you have purchased a single-user license.

Network Mode

In this mode the QUARC SDE and other QUARC Target components will be installed on every client machine and only the Quanser License Manager component is installed on the license server machine. In addition after the installation has completed, the license configuration tool will be used to configure the QUARC product on client machines and the License Manager on the server machine. Again, a detailed description of this procedure will be presented in the Network Installation sections of this document and you should follow these instructions if you have purchased a network license. Please note that, it is also possible to only install the QUARC Target component on your client machines. In this case, since QUARC SDE is not installed, you will not be able to generate/build code from your Simulink models. However you can still run previously generated QUARC executable files on your intended target provided that:

• You have met QUARC Target's software/hardware requirements. Refer to the Software Requirements and Hardware Requirements sections in this document.

• Your intended target is included in the license you have purchased. (For example if you have only purchased the Windows Target License, you will not be able to run code on other embedded targets).

QUARC allows you to run the real-time code generated from your Simulink models on both local and remote targets. Figure 1.2 illustrates QUARC's architecture and its components when the host and target are on the same machine:

Local Configuration With QUARC Host And Target On The Same Machine

Figure 1.3 below illustrates QUARC's architecture and its components when the code runs on a remote target (or multiple remote targets).

Remote Configuration With QUARC Host And Target On Different Machines

SOFTWARE REQUIREMENTS

In this section software requirements for proper operation of each of the QUARC installation components discussed above are presented.

Host

The software requirements for the QUARC Simulink Development Environment (SDE) component running on the Windows host PC include:

• 64-bit MATLAB

• Simulink

• Simulink Coder

• MATLAB Coder

• Optional but highly recommended: Control System Toolbox. QUARC does not actually require the Control System Toolbox to operate. However, the Control System Toolbox is used by most of Quanser's controls laboratories.

* For the specific MATLAB versions supported, please refer to the QUARC Compatibility Table. There are also additional requirements for the QUARC SDE component that depend on the target type for which you need to build code. Those requirements are also listed in the compatibility table.

QUARC Targets

The software requirements for the installation of the QUARC runtime Target component depend on the target type on which you need to run the QUARC model/code:

• QUARC Target for Windows requires Microsoft Windows 7 SP1, Microsoft Windows 10 or Microsoft Windows 11.

  Caution: When running a QUARC model on a Microsoft Windows remote target, the remote target PC must have the C runtime library installed on the target e.g., msvcr140.dll. The C runtime library version must correspond to the version of the compiler used on the host to build the model e.g., Microsoft Visual C++ 2019 Redistributable.

  Due to changes made by Microsoft to digital signature requirements for drivers, Windows 7 and Windows Server 2008 R2 may no longer recognize Quanser drivers as signed unless Windows updates have been applied. In particular, hotfix KB3033929 needs to be applied to these operating systems so that they recognize SHA256 digital signatures, which are now required by Microsoft. This hotfix should be applied automatically if required updates are installed via Windows Update. See Appendix A for details.

• For other embedded targets, please refer to the corresponding target installation guide.

Quanser License Manager

The software requirements to install the Quanser License Manager are:

• Microsoft Windows 7 SP1, Microsoft Windows 10 or Windows 11.

• Microsoft Windows Server 2016 or Microsoft Windows Server 2019.

Note: It is possible to install Quanser License Manager on a Linux machine. Contact Quanser's technical support for further information.

Compiler Configuration

This chapter describes the various compilers for Windows targets that are supported by QUARC and key details on how they should be installed and/or configured to work with QUARC.

Microsoft Visual Studio 2019 Professional/Community Edition with Visual C++

Microsoft Visual Studio 2019 Professional/Community Edition with Visual C++ can be used by versions of QUARC-supported MATLAB/Simulink indicated in the QUARC Compatibility Table.

Note that Microsoft Visual Studio 2019 Community Edition are available for free from here.

When installing Visual Studio, make sure that on the Visual Studio Installation Options page, shown in Figure 3.6 (Professional Edition) and Figure 3.7 (Community Edition), that the "Desktop development with C++" workload under "Desktop & Mobile" or "Windows" groupings is checked.

Visual Studio 2019 Professional Edition Installer Options Page

Visual Studio 2019 Community Edition Installer Options Page

Once Microsoft Visual Studio 2019 Professional/Community Edition with Visual C++ is installed, launch MATLAB and type:

mex -setup

in the MATLAB Command Window. Follow the instructions to select Microsoft Visual C++ 2019 as the default MATLAB compiler. This is illustrated in Figure 3.8.

Visual C++ 2019 Compiler Selection

Microsoft Visual Studio 2022 Professional/Community Edition with Visual C++

Microsoft Visual Studio 2022 Professional/Community Edition with Visual C++ can be used by versions of QUARC-supported MATLAB/Simulink indicated in the QUARC Compatibility Table.

Note that Microsoft Visual Studio 2022 Community Edition are available for free from here.

When installing Visual Studio, make sure that on the Visual Studio Installation Options page, shown in Figure 3.9 (Professional Edition) and Figure 3.10 (Community Edition), that the "Desktop development with C++" workload under "Desktop & Mobile" or "Windows" groupings is checked.

Visual Studio 2022 Professional Edition Installer Options Page

Visual Studio 2022 Community Edition Installer Options Page

Once Microsoft Visual Studio 2022 Professional/Community Edition with Visual C++ is installed, launch MATLAB and type:

mex -setup

in the MATLAB Command Window. Follow the instructions to select Microsoft Visual C++ 2022 as the default MATLAB compiler. This is illustrated in Figure 3.11.

Visual C++ 2022 Compiler Selection

Hardware Requirements

In this section hardware requirements for proper operation of the installation components discussed earlier are presented. Note that the disk space and RAM requirements listed below are only for the QUARC component being installed. The disk space and RAM requirements for any other third party software, such as MATLAB and compilers, should be obtained from their appropriate documentation and added separately.

Caution: QUARC will neither install nor run on any type of virtual machines.

QUARC Windows Host

The following indicates the hardware requirements of the intended Windows host (SDE) machine.

• Processor: An Intel, or AMD, 64-bit (x64) processor with eight logical cores.

• RAM: 16 GB.

• Disk Space: 10 GB.

QUARC Windows Target

The following indicates the hardware requirements of the intended Windows target machine. If the target system is the same as the host system, the QUARC SDE hardware requirements should be used.

• Processor: Dual-core or higher Intel or AMD CPU.

• RAM: 1 GB.

• Disk Space: 100 MB.

Windows Setup

This chapter describes how to install QUARC and configure the QUARC license for both a single-user and network installation.

Note that the instructions in this section refer to online QUARC installation, which assumes an Internet connection exist on the setup PC. It is possible to first download QUARC and then install QUARC later. Please refer to Appendix C for more information.

Single-User

ALL software MUST be installed using the Administrator account or an account with administrator privileges. This ensures that all paths are available to all User Accounts.

Please follow these instructions if you have purchased a single-user license and would like to install QUARC on a Windows machine. If you have purchased a network license, please follow the corresponding installation instructions found in other sections of this document.

Caution: It is extremely important to follow the instructions in Appendix C Windows Power Management Settings to change the system power setting in order to prevent the system from losing control of the hardware.

Caution: Ensure that the person installing QUARC is logged in as Administrator or has Administrator privileges.

To check privileges for a user, click on Start, then type Computer Management and select it. Under Computer Management, in the System Tools section, expand Local Users and Groups and open the Groups section. Then double-click on the Administrators name and see if the login name that you are using is displayed (with the correct domain name, if applicable) in the Members list. If your username is not displayed in the list, then you do not have Administrator privileges. If the Administrators group does not appear, then you do not have Administrator privileges. Even if you are logged in as Administrator, it may still prompt you to elevate your privileges to full Administrator privileges when you run the Configure Licensing tool.

Caution: Ensure that the version of QUARC that you are planning to install is compatible with your QUARC license file. The installer itself will check compatibility. Also make sure the license file is located on the same drive as where you're planning to install QUARC.

To check the QUARC license manually, open the QUARC license file. This is a text file (with a .qlic file extension) that can be opened, for example, with Wordpad. The version of QUARC that you are planning to install should be included within the version range indicated by the Minimum version: and Maximum version: fields of the QUARC license file.

Caution: If you already have an earlier version of QUARC installed on your machine it must be removed prior to installing the newer version. Furthermore, if you have the QUBE-SERVO-USB, Q2-USB, or Q8-USB devices, you need to unplug them from the computer before uninstalling the earlier version of QUARC.

In order to uninstall an earlier installation of QUARC please follow the Remove instructions in Section 6.

It should be mentioned that the appropriate version of MATLAB should be installed prior to installing QUARC, since QUARC automatically adds itself to the MATLAB path. However it is also possible to add QUARC manually to the MATLAB path if QUARC is installed prior to installing MATLAB. This can be done by running the quarc_setup script found in %QUARC_DIR%\quarc, where %QUARC_DIR% denotes the installation directory of QUARC (typically C:\Program Files\Quanser\QUARC).

Caution: If you have already installed the Quanser HIL SDK or Quanser SDK, you should remove it before installing QUARC. QUARC contains the complete Quanser SDK and conflicts can arise if an incompatible version of the HIL SDK or Quanser SDK is installed at the same time as QUARC.

Make sure MATLAB and Microsoft Visual Studio are closed before beginning the installation.

Turn off any antivirus software prior to installing QUARC. Your antivirus software can be turned back on at the end of this Section, once the QUARC installation is complete.

The QUARC installation steps are as follows:

1. Download the QUARC web installer executable using the link provided in the confirmation email that you received.

2. Run the QUARC web installer install_quarc.exe.

3. The installer window should show up and start the installation process. First it will go online to check if there is a newer version available for you to update, as shown in Figure 5.1. Therefore we highly recommend having an Internet connection during installation.

   Checking for Updates

   Caution: Check tips for each installation window by hovering the mouse cursor over the blue information icon on the lower left corner or click the question mark icon on the upper right corner for more details, as shown in Figure 5.2.

   Tips

4. The installer will notify you if there is a newer version available as shown in Figure 5.3. Either click Update to have the newer version installed or click Skip to keep your current version.

   New Update Available

5. The next page is the License Agreement page, as illustrated in Figure 5.4. To install QUARC, please click "I Agree" to continue.

   License Agreement Page

6. Figure 5.5 will then show up for you to provide the license file from Quanser. Click "Next" button to continue.

   License File Page

7. As shown in Figure 5.6, the installer will perform a compatibility check before starting the installation. This check scans your PC to ensure the required software is present. Please refer to the Compatibility Table for more details. Click "Install" button to install QUARC using the default settings, or click "Options" to customize.

   Compatibility Checking

   Note that the C compiler versions are verified against the installed MATLAB versions on the host PC. Hence, a C compiler version will be marked as incompatible if it is not supported by any of the MATLAB versions installed.

   Note that depending on the intended targets that you want to use, you might not need to have all the third party software installed. For example, if you do not intend to use NI targets (e.g. myRIO or ELVIS III), you can continue installing QUARC even without NI Software.

8. If "Options" is clicked, provide the destination folder where QUARC will be installed in the Figure 5.7 window and click "Next" to continue.

   Installation Location Page

   Caution: If the desired install location is not on the system drive (normally C:), it is recommended to enable short path name support. Refer to Appendix D for more information.

9. Please refer to the Important Notes below before configuring the features on the Feature Selection page depicted in Figure 5.8.

   Feature Selection Page

   Important Notes:

   1. The features are automatically selected based on the license file you provided to the installer.

   2. If you are not licensed for a feature, the feature will be disabled and grey in the tree hierarchy.

   3. If you don't have the software required by a feature, the feature will be disabled and grey in the tree hierarchy.

   4. In order to use QUARC with certain embedded targets, the appropriate Cross-Compilers feature must be installed (please refer to the corresponding target installation guide).

   5. QUARC provides a variety of external interfaces or APIs with which the user can communicate with the real-time code or access hardware. In order to use these external interfaces, the appropriate features must be selected.

      The following summarizes the feature that is required for each supported external interfaces:

• .NET:

  .NET Feature Selection Page

• Java:

  Java Feature Selection Page

• Python:

  Python Feature Selection Page

6. As mentioned earlier in this document, the Simulink Development Environment component is required to generate/build the real-time code to be run on a selected target. It should be noted that if you select to install the QUARC Target for Windows component, but not to install QUARC SDE, you will not be able to generate/build code from your Simulink models. However you can still run previously generated QUARC executable files on your intended target provided that:

   • The QUARC Target's software/hardware requirements discussed earlier have been met.

   • The intended target is included in the license purchased. For example if you have only purchased the QUARC Target for Windows License, you will not be able to run code on other embedded targets.

10. Since you have purchased a single-user license, please install QUARC and Quanser License Manager on the same computer. In the Feature Selection window, make sure that QUARC and Quanser License Manager are both selected to be installed.

11. Click "Install" to start the installation process. During the installation, there will be video clips introducing QUARC and its functionalities as shown in Figure 5.12. You can pause, resume or replay the video as well as adjust the volume by using the toolbar that appears when the mouse is moved over the video.

Installation Progress Page

12. Once the installation is complete, you can click the links on Figure 5.13, or click "Close" to finish the installation.

    Installation Finished Page

Important Note: To resolve any possible broken links in the Simulink diagram that might be caused by upgrading from an earlier version of QUARC, please use the "Upgrade blocks" option in the QUARC "Utilities" menu. To do this, simply select the QUARC Simulink Toolstrip, click on the "Utilities" menu item of the Simulink model and select "Upgrade blocks". Please refer to the "Upgrading QUARC" section in QUARC documentation for more information on this issue.

Important Note: Due to limitation of MATLAB help system support for Supplemental Software, after the QUARC installation is complete, an additional step is required to enable QUARC help to function properly. Launch MATLAB and open "MATLAB Preferences", go to the "Help" section. In the "Documentation Location" panel, click on the "Installed locally" radio button. For some versions of MATLAB, you might need to click the "Install Documentation" button as well. After that, press "OK", and then restart MATLAB.

MATLAB Help Preferences

MATLAB Help Preferences (New)

Network

ALL software MUST be installed using the Administrator account or an account with administrator privileges. This ensures that all paths are available to all User Accounts.

Please follow these instructions if you have purchased a network license and would like to install QUARC on a Windows machine. If you have purchased a single-user license, please follow the corresponding installation instructions found in other sections of this document.

Caution: It is extremely important to follow the instructions in Appendix C Windows Power Management Settings to change the system power setting in order to prevent the system from losing control of the hardware.

Caution: Ensure that the person installing QUARC is logged in as Administrator or has Administrator privileges.

To check privileges for a user, click on Start, then type Computer Management and select it. Under Computer Management, in the System Tools section, expand Local Users and Groups and open the Groups section. Then double-click on the Administrators name and see if the login name that you are using is displayed (with the correct domain name, if applicable) in the Members list. If your username is not displayed in the list, then you do not have Administrator privileges. If the Administrators group does not appear, then you do not have Administrator privileges. Even if you are logged in as Administrator, it may still prompt you to elevate your privileges to full Administrator privileges when you run the Configure Licensing tool.

Caution: Ensure that the version of QUARC that you are planning to install is compatible with your QUARC license file. The installer itself will check compatibility. Also make sure the license file is located on the same drive as where you're planning to install QUARC.

To check the QUARC license manually, open the QUARC license file. This is a text file (with a .qlic file extension) that can be opened, for example, with Wordpad. The version of QUARC that you are planning to install should be included within the version range indicated by the Minimum version: and Maximum version: fields of the QUARC license file.

Caution: If you already have an earlier version of QUARC installed on your machine it must be removed prior to installing the newer version. Furthermore, if you have the QUBE-SERVO-USB, Q2-USB, or Q8-USB devices, you need to unplug them from the computer before uninstalling the earlier versions of QUARC.

In order to uninstall an earlier installation of QUARC please follow the Remove instructions in Section 6.

It should be mentioned that the appropriate version of MATLAB should be installed prior to installing QUARC, since QUARC automatically adds itself to the MATLAB path. However it is also possible to add QUARC manually to the MATLAB path if QUARC is installed prior to installing MATLAB. This can be done by running the quarc_setup script found in %QUARC_DIR%\quarc, where %QUARC_DIR% denotes the installation directory of QUARC (typically C:\Program Files\Quanser\QUARC).

Caution: If you have already installed the Quanser HIL SDK or Quanser SDK, you should remove it before installing QUARC. QUARC contains the complete Quanser SDK and conflicts can arise if an incompatible version of the HIL SDK or Quanser SDK is installed at the same time as QUARC.

The network licensing setup consists of two separate installations using two different QUARC license files. Please install the Quanser License Manager on the License server machine using the "{UserName} Network-Server.qlic" QUARC license file, and only the QUARC SDE and/or Windows Target components on every client machine on the network using the "{UserName} Network-Client.qlic" QUARC license file. There are also separate procedures for configuring the license on the server and client machines which will be outlined in this section.

License Server

To install the Quanser License Manager on the license server machine follow the instructions listed below. Also ensure that MATLAB and Microsoft Visual Studio are closed before beginning the installation.

1. Download the QUARC web installer executable using the link provided in the confirmation email that you received.

2. Run the QUARC web installer install_quarc.exe.

3. The installer window should show up and start the installation process. First it will go online to check if there is a newer version available for you to update, as shown in Figure 5.14. Therefore we highly recommend having an Internet connection during installation.

   Checking for Updates

   Caution: Check tips for each installation window by hovering the mouse cursor over the blue information icon on the lower left corner or click the question mark icon on the upper right corner for more details, as shown in Figure 5.15.

   Tips

4. The installer will notify you if there is a newer version available as shown in Figure 5.16. Either click Update to have the newer version installed or click Skip to keep your current version.

   New Update Available

5. The next page is the License Agreement page, as illustrated in Figure 5.17. To install QUARC, please click "I Agree" to continue.

   License Agreement Page

6. Figure 5.18 will then show up for you to provide the license file from Quanser. Since you are using a network license, the installer will ask you to provide license server information. Be sure to set the host name or IP address to localhost and the port to the desired port. The default port used by the Quanser License Manager is port 16999, and is the recommended value.

   Click "Next" button to continue.

   Caution: If the License Server computer is equipped with a Firewall, please ensure that the port (by default: 16999) configured to be used by the Quanser License Manager is allowed (i.e., not blocked) by the active Firewall.

   License File Page

7. As shown in Figure 5.19, the installer will perform a compatibility check before starting the installation. This check scans your PC to ensure the required software is present. Please refer to the Compatibility Table for more details. Use the dropdown button next to "Install" and select "License Server" to install Quanser License Manager using the default settings, or click "Options" to customize.

   Compatibility Checking

   Note that the C compiler versions are verified against the installed MATLAB versions on the host PC. Hence, a C compiler version will be marked as incompatible if it is not supported by any of the MATLAB versions installed.

   Note that depending on the intended targets that you want to use, you might not need to have all the third party software installed. For example, if you do not intend to use NI targets (e.g. myRIO or ELVIS III), you can continue installing QUARC even without NI Software.

8. If "Options" is clicked, provide the destination folder where QUARC will be installed in the Figure 5.20 window and click "Next" to continue.

   Installation Location Page

   Caution: If the desired install location is not on the system drive (normally C:), it is recommended to enable short path name support. Refer to Appendix D for more information.

9. Use the dropdown button next to "Default" and select "License Server" to select the Quanser License Manager only as illustrated in Figure 5.21. It is not necessary to install any other features on the license server.

   Feature Selection Page

10. Click "Install" to start the installation process. During the installation, there will be video clips introducing QUARC and its functionalities as shown in Figure 5.22. You can pause, resume or replay the video as well as adjust the volume by using the toolbar that appears when the mouse is moved over the video.

    Installation Progress Page

11. Once the installation is complete, you can click the links on Figure 5.23, or click "Close" to finish the installation.

    Installation Finished Page

License Client

There are different instructions on how to install QUARC and configure the license on client machines, which follow next.

Make sure MATLAB and Microsoft Visual Studio are both closed before beginning the installation.

Turn off any antivirus software prior to installing QUARC. Your antivirus software can be turned back on at the end of this Section, once the QUARC installation is complete.

Please perform the following installation steps for each client machine on the network:

1. Download the QUARC web installer executable using the link provided in the confirmation email that you received.

2. Run the QUARC web installer install_quarc.exe.

3. The installer window should show up and start the installation process. First it will go online to check if there is a newer version available for you to update, as shown in Figure 5.24. Therefore we highly recommend having an Internet connection during installation.

   Checking for Updates

   Caution: Check tips for each installation window by hovering the mouse cursor over the blue information icon on the lower left corner or click the question mark icon on the upper right corner for more details, as shown in Figure 5.25.

   Tips

4. The installer will notify you if there is a newer version available as shown in Figure 5.26. Either click Update to have the newer version installed or click Skip to keep your current version.

   New Update Available

5. Click the Next button to see the License Agreement page, as illustrated in Figure 5.27. To install QUARC, please click "I Agree" to continue.

   License Agreement Page

6. Figure 5.28 will then show up for you to provide the license file from Quanser. Since you are using a network license, the installer will ask you to provide license server information. Be sure to set the host name or IP address to the location of the license server and the port. The default port used by the Quanser License Manager is port 16999.

   Click "Next" button to continue.

   Caution: If the License Server computer is equipped with a Firewall, please ensure that the port (by default: 16999) configured to be used by the Quanser License Manager is allowed (i.e., not blocked) by the active Firewall.

   License File Page

7. As shown in Figure 5.29, the installer will perform a compatibility check before starting the installation. This check scans your PC to ensure the required software is present. Please refer to the Compatibility Table for more details. Use the dropdown button next to "Install" and select "License Client" to install QUARC using the default settings for a license client (Quanser License Manager not installed), or click "Options" to customize.

   Compatibility Checking

   Note that the C compiler versions are verified against the installed MATLAB versions on the host PC. Hence, a C compiler version will be marked as incompatible if it is not supported by any of the MATLAB versions installed.

   Note that depending on the intended targets that you want to use, you might not need to have all the third party software installed. For example, if you do not intend to use NI targets (e.g. myRIO or ELVIS III), you can continue installing QUARC even without NI Software.

8. If "Options" is clicked, provide the destination folder where QUARC will be installed in the Figure 5.30 window and click "Next" to continue.

   Installation Location Page

   Caution: If the desired install location is not on the system drive (normally C:), it is recommended to enable short path name support. Refer to Appendix D for more information.

9. Please refer to the Important Notes below before configuring the features on the Feature Selection page depicted in Figure 5.31.

   Use the dropdown button next to "Default" and select "License Client" to select the typical QUARC features for which you are licensed (but not the Quanser License Manager).

   Feature Selection Page

   Important Notes:

   • The features are automatically selected based on the license file you provided to the installer.

   • If you are not licensed for a feature, the feature will be disabled and grey in the tree hierarchy.

   • If you don't have the software required by a feature, the feature will be disabled and grey in the tree hierarchy.

   • In order to use QUARC with certain embedded targets, the appropriate Cross-Compilers feature must be installed (please refer to the corresponding target installation guide).

5. As mentioned earlier in this document, the Simulink Development Environment component is required to generate/build the real-time code to be run on a selected target. It should be noted that if you select to install the QUARC Target for Windows component, but not to install QUARC SDE, you will not be able to generate/build code from your Simulink models. However you can still run previously generated QUARC executable files on your intended target provided that:

   • The QUARC Target's software/hardware requirements discussed earlier have been met.

   • The intended target is included in the license purchased. For example if you have only purchased the QUARC Target for Windows License, you will not be able to run code on other target types.

10. Click "Install" to start the installation process. During the installation, there will be video clips introducing QUARC and its functionalities as shown in Figure 5.32. You can pause, resume or replay the video as well as adjust the volume by using the toolbar that appears when the mouse is moved over the video.

    Installation Progress Page

11. Once the installation is complete, you can click the links on Figure 5.33, or click "Close" to finish the installation.

    Installation Finished Page

Important Note: To resolve any possible broken links in the Simulink diagram that might be caused by upgrading from an earlier version of QUARC, please use the "Upgrade blocks" option in the QUARC "Utilities" menu. To do this, simply select the QUARC Simulink Toolstrip, click on the "Utilities" menu item of the Simulink model and select "Upgrade blocks". Please refer to the "Upgrading QUARC" section in QUARC documentation for more information on this issue.

Important Note: Due to limitation of MATLAB help system support for Supplemental Software, after the QUARC installation is complete, an additional step is required to enable QUARC help to function properly. Launch MATLAB and open "MATLAB Preferences", go to the "Help" section. In the "Documentation Location" panel, click on the "Installed locally" radio button. For some versions of MATLAB, you might need to click the "Install Documentation" button as well. After that, press "OK", and then restart MATLAB.

MATLAB Help Preferences

MATLAB Help Preferences (New)

Quiet Installation

ALL software MUST be installed using the Administrator account or an account with administrator privileges. This ensures that all paths are available to all User Accounts.

QUARC provides a quiet installation option for system administrators who need to install QUARC on multiple machines without the need for user interactions. This works for both single-user or network setups. The quiet installation option makes use of the licensed features in the license file when selecting which features to be installed. If you want to have full control of the features to be installed, please follow the single-user or network installation instructions found in other sections of this document.

Caution: It is extremely important to follow the instructions in Appendix C Windows Power Management Settings to change the system power setting in order to prevent the system from losing control of the hardware.

Caution: Ensure that the person installing QUARC is logged in as Administrator or has Administrator privileges.

To check privileges for a user, click on Start, then type Computer Management and select it. Under Computer Management, in the System Tools section, expand Local Users and Groups and open the Groups section. Then double-click on the Administrators name and see if the login name that you are using is displayed (with the correct domain name, if applicable) in the Members list. If your username is not displayed in the list, then you do not have Administrator privileges. If the Administrators group does not appear, then you do not have Administrator privileges. Even if you are logged in as Administrator, it may still prompt you to elevate your privileges to full Administrator privileges when you run the Configure Licensing tool.

Caution: Ensure that the version of QUARC that you are planning to install is compatible with your QUARC license file. The installer itself will check compatibility. Also make sure the license file is located on the same drive as where you're planning to install QUARC.

To check the QUARC license manually, open the QUARC license file. This is a text file (with a .qlic file extension) that can be opened, for example, with Wordpad. The version of QUARC that you are planning to install should be included within the version range indicated by the Minimum version: and Maximum version: fields of the QUARC license file.

Caution: If you already have an earlier version of QUARC installed on your machine it must be removed prior to installing the newer version. Furthermore, if you have the QUBE-SERVO-USB, Q2-USB, or Q8-USB devices, you need to unplug them from the computer before uninstalling the earlier versions of QUARC.

In order to uninstall an earlier installation of QUARC please follow the Remove instructions in Section 6.

It should be mentioned that the appropriate version of MATLAB should be installed prior to installing QUARC, since QUARC automatically adds itself to the MATLAB path. However it is also possible to add QUARC manually to the MATLAB path if QUARC is installed prior to installing MATLAB. This can be done by running the quarc_setup script found in %QUARC_DIR%\quarc, where %QUARC_DIR% denotes the installation directory of QUARC (typically C:\Program Files\Quanser\QUARC).

Caution: If you have already installed the Quanser HIL SDK or Quanser SDK, you should remove it before installing QUARC. QUARC contains the complete Quanser SDK and conflicts can arise if an incompatible version of the HIL SDK or Quanser SDK is installed at the same time as QUARC.

Make sure MATLAB and Microsoft Visual Studio are closed before beginning the installation.

Turn off any antivirus software prior to installing QUARC. Your antivirus software can be turned back on at the end of this Section, once the QUARC installation is complete.

The QUARC installation steps are as follows:

1. Download the QUARC web installer executable using the link provided in the confirmation email that you received.

2. Locate the license file that you receive from Quanser. You'll need to provide the full path of the license file to install QUARC silently. It is recommended that you put the license file in the same directory as the QUARC web installer install_quarc.exe.

3. Open a command prompt as an Administrator. You can do so by right-clicking the command prompt icon on the taskbar and choose "Run as Administrator". The User Account Control window would popup, click "Yes" to allow the command prompt to be opened.

4. In the resulting command prompt, change to the directory where the QUARC web installer install_quarc.exe is located, and type the following (assuming the license file is called license.qlic, modify the license filename accordingly if it's different):

   install_quarc.exe /passive LICENSEFILE="license.qlic"

   • It is highly recommended to use the /passive flag to perform silent install, as this would still ensure that no more user ineraction is needed during installation, but the progress of the installation would still be visible. However, if you really want no visibility of the installation, you can replace the /passive flag with /q. However in doing so, you would need to monitor the Task Manager in order to see when the QUARC installer is finished.

5. The QUARC installation progress window would show up, giving you an indication of the QUARC installation has started. When the installation is finished, the installation finished window would show up, as shown Figure 5.34. Click "Close" to finish the installation.

   Installation Finished Page

Change, Repair, or Remove QUARC

This chapter describes how to modify an existing QUARC installation, once QUARC has been installed as described in the previous chapters.

To make modifications to an existing QUARC installation, click on the Windows Start menu, and then type Add or remove programs and select it. In the list of installed applications, look for QUARC and click on the ... button, and select Modify.

A dialog window similar to the one displayed in Figure 6.1 will show up and allow a choice between Change, Repair, or Remove as the operation on the QUARC installation.

Modifying existing QUARC installation

Change allows you to change the QUARC license file and/or the QUARC features to be installed. This is useful, for example, if you purchased a new and upgraded license (that entitles you to more features than your existing license) and need to update your QUARC installation with the new features (as well as register the new license).

Repair should be used to repair the QUARC installation if it became corrupted (e.g., accidental deletion/modification of QUARC files).

Remove uninstalls the current QUARC installation.

Testing QUARC

QUARC comes with example models that can be accessed by typing

qc_show_examples

in the MATLAB command prompt window.

The QUARC Sine & Scope Demo in particular is a test that everyone is encouraged to run. It is universal, meaning that it is not dependant on the hardware type you are using (e.g., data acquisition card). However running this test can ensure that correct installation and configuration has been done for QUARC while familiarizing first time users with basic QUARC operation principles. To run this test type:

qc_show_examples

in the MATLAB command prompt and click on "QUARC Sine & Scope Demo", which can be found under Basic Features and follow the instructions. The demo window is depicted in Figure 7.1.

Running the QUARC Sine Scope Demo in MATLAB

There are more demos available on this page that might require specific hardware, such as Quanser's Q2-USB or Q8-USB HIL boards. You are encouraged to run these demos as well provided that the required hardware is present.

Be sure to check out the other examples as well, since they highlight many useful features of QUARC!

Troubleshooting

Review the following recommendations before contacting Quanser's technical support engineers.

Licensing Errors

Getting an 'Error configuring license' message from the Configure Licensing tool.

• Open the Quanser-provided QUARC license file with Microsoft WordPad.

• Ensure your QUARC version is included within the range indicated by the license file Minimum version: and Maximum version: fields.

• Close Microsoft WordPad.

• From the Windows Start menu, browse to the All Programs/Quanser/QUARC sub-menu and run the Configure Licensing tool using a QUARC license file, valid for your version of QUARC.

The QUARC license file has been registered successfully, but you get a 'Error configuring license' message when trying to run a QUARC model.

• Run the QUARC Sine and Scope Demo, as described in Section 7.

• If the QUARC Sine and Scope Demo runs as expected, then your QUARC license file does not allow some of the features used by your QUARC model. Contact Quanser's technical support for further information.

• Otherwise, if the same error message remains, first disable any antivirus software and Windows Firewall. Then browse to the Start/All Programs/Quanser/QUARC menu and run the Configure Licensing tool, using a valid QUARC license file.

Building Errors

Getting an error when trying to build the QUARC Sine and Scope Demo

• Type ver in the MATLAB Command Window. QUARC should appear in the displayed list.

• Depending on the compiler used, refer to Section 3 and review your compiler installation steps.

• Run mex -setup in the MATLAB Command Window, as described in Section 3.

• If the following error message is received when the current user is a non-administrator:

  ...: fatal error C1083: Cannot open include file: "...": No such file or directory

  Ensure the non-admin account has read access to the registry (it might require your institution's IT department to enable that).

Getting an error when the model is being downloaded

If the following error message is received:

??? Model ... failed to download to target 'shmem://quarc-target:1'. The code being downloaded or run is not compatible with the type of target referenced by the target URI. For example, 32-bit code cannot be downloaded to a 64-bit target or vice-versa. In Simulink, make sure the system target file selected in the model's active configuration is compatible with the target referred to by the target URI.

then attempt to resolve the problem using the following steps:

• Select the QUARC/Options... menu item from the QUARC diagram.

• Under Code Generation, click on the Browse... button.

• Select the system target file corresponding to your target computer (e.g., QUARC Win64 Target).

• Click on the OK buttons to close the dialogs, and save the diagram.

Runtime Errors

Getting an error about a card or driver not being installed

If the following error is received when attempting to run a model:

Error occurred while executing External Mode MEX-file 'quarc comm': An operating system specific kernel-level driver for the specified card could not be found. The card or driver may not be installed.

then attempt to resolve the error using the following procedure:

• If using a USB device, ensure the USB cable is properly connected, and try a different USB port on the computer.

• Verify the data acquisition device is properly connected to the computer.

• If this is a National Instruments (NI) data acquisition device, ensure the NI DAQmx drivers are installed. The NI DAQmx installer is on a DVD that comes with the NI hardware; it can also be downloaded from http://www.ni.com/drivers/.

• Verify that the card shows up in Device Manager. If the card indicates that there is an error with the driver, and the operating system is Windows 7 or Windows Server 2008 R2, then it may be necessary to install hotfix KB3033929. Microsoft has changed the requirements for driver signing to enforce SHA256 digital signatures. For Windows 7 and Windows 2008 R2 to recognize drivers signed with these digital signatures, the hotfix must be applied. This hotfix should be applied automatically if required updates are installed via Windows Update.