INCA-VLINK V1.3 Getting Started

Transcription

1 INCA-VLINK V1.3 Getting Started

2 Copyright The data in this document may not be altered or amended without special notification from ETAS GmbH. ETAS GmbH undertakes no further obligation in relation to this document. The software described in it can only be used if the customer is in possession of a general license agreement or single license. Using and copying is only allowed in concurrence with the specifications stipulated in the contract. Under no circumstances may any part of this document be copied, reproduced, transmitted, stored in a retrieval system or translated into another language without the express written permission of ETAS GmbH. Copyright 2014 ETAS GmbH, Stuttgart The names and designations used in this document are trademarks or brands belonging to the respective owners. The name INTECRIO is a registered trademark of ETAS GmbH. MATLAB and Simulink are registered trademarks of The MathWorks, Inc. Document AM V1.3 R01 EN

3 ETAS Contents Contents 1 General Information Safety Advice Correct Use Labeling of Safety Instructions Demands on the Technical State of the Product System Information User Information What You Need to Know Structure of the Documentation INCA-VLINK: Online Help INCA-VLINK: Hardware Configurator Online Help Working with this Manual Installation Preparations Delivery Scope INCA-VLINK License System Prerequisites Required User Privileges for Installation Installation Initial Installation Manual Association with MATLAB/Simulink Prerequisites for Calibration on a Windows PC Command-Line Installation Setting the Licensing Behavior Uninstalling INCA-VLINK or the ETAS Virtual OS Execution Platform Licensing the Software ETAS License Models INCA-VLINK V1.3 - Installation Guide 3

4 Contents ETAS 3.2 How to Get a License The License File Grace Mode The "Expiration Warning" Window Borrowing a License INCA-VLINK Quick Guide Introduction Preparing the Model Creating and Configuring a Hardware System Importing a Hardware System Specifying the Model Adding Activation Task Blocks Adding the System Time Block Stimuli Signal Configuration Stimuli Signal Configuration Block Stimuli Signal Group Receive Block Exporting the Model and Experimenting Export / Experiment INCA Export / Experiment INTECRIO Glossary Appendix: Troubleshooting General Problems Problems and Solutions Network Adapter cannot be selected via Network Manager Search for Ethernet Hardware fails Personal Firewall blocks Communication ETAS Contact Addresses Index INCA-VLINK V1.3 - Installation Guide

5 ETAS General Information 1 General Information The ETAS INCA-VLINK Blockset for Measurement and Calibration on Windows allows the deployment of Simulink models as executable programs running on standard Windows PCs. Through the use of INCA-VLINK, tasks can be shifted from the vehicle and the test bench to the desktop computer, saving time and money. 1.1 Safety Advice Please adhere to the Product Liability Disclaimer (ETAS Safety Advice) and to the following safety instructions to avoid injury to yourself and others as well as damage to the device Correct Use ETAS GmbH cannot be made liable for damage which is caused by incorrect use and not adhering to the safety instructions Labeling of Safety Instructions The safety instructions contained in this manual are shown with the standard danger symbol shown below: The following safety instructions are used. They provide extremely important information. Read this information carefully. WARNING Indicates a possible medium-risk danger which could lead to serious or even fatal injuries if not avoided. CAUTION Indicates a low-risk danger which could result in minor or less serious injury or damage if not avoided. NOTICE Indicates behavior which could result in damage to property Demands on the Technical State of the Product The following special requirements are made to ensure safe operation: INCA-VLINK V1.3 - Installation Guide 5

6 General Information ETAS Take all information on environmental conditions into consideration before setup and operation (see the documentation of your computer, hardware, etc.). 1.2 System Information INCA-VLINK supports the following versions of MATLAB/Simulink: 32 bit: R2009a R2014b 64 bit: R2009a R2014b INCA-VLINK supports the following MATLAB/Simulink components: R2009a R2010b Simulink Real-Time Workshop Real-Time Workshop Embedded Coder Stateflow Stateflow Coder Simulink Fixed Point Fixed Point Toolbox R2011a and higher Simulink MATLAB Coder Simulink Coder Embedded Coder Stateflow Simulink Fixed Point Fixed Point Toolbox INCA-VLINK supports experiments with the following tools: INCA / INCA-EIP V7.0 or higher INCA-VLINK can be installed and used independent of other ETAS software (INTECRIO, ASCET-RP, EHOOKS, etc.). 1.3 User Information What You Need to Know This manual is intended for trained personnel specializing in the area of function and software development for embedded electronic systems. A good working knowledge of MATLAB /Simulink, and INCA/INCA-EIP is required. In addition, INCA-VLINK users should be familiar with the operating systems Microsoft Windows XP, Windows Vista, Windows 7, Windows 8 or Windows 8.1. All users should be capable of executing menu functions, activating buttons etc. Users should also be acquainted with the Windows file storage system, particularly the relations between files and directories. Users must know about and have mastered the basic functions of the Windows File and Program Manager and Windows Explorer. Users should also be familiar with "Drag & Drop". All users who are not familiar with the basic techniques of Microsoft Windows should familiarize themselves with them before using INCA-VLINK. Details of working with Windows are contained in the relevant manuals by Microsoft Corporation. Knowledge of a programming language, preferably ANSI-C, can be helpful to advanced users. 6 INCA-VLINK V1.3 - Installation Guide

7 ETAS General Information Structure of the Documentation The INCA-VLINK documentation consists of the following parts: this installation guide an online help that describes the Simulink blocks provided by INCA-VLINK (cf. section 1.3.3) an online help that describes how to use the hardware configurator (cf. section 1.3.4) The INCA-VLINK installation guide consists of the following chapters: "General Information" (this chapter) This chapter gives an initial overview of INCA-VLINK. Furthermore, it contains general information such as user and system information. "Installation" This chapter is intended for all users who install, maintain and uninstall INCA-VLINK. It provides important information on the delivery scope, hardware and software requirements. The sequence of both the installation and uninstallation of INCA-VLINK is described. "Licensing the Software" This chapter contains information on licensing the software. "INCA-VLINK Quick Guide" This chapter is a quick introduction to the program concept of INCA-VLINK. The working examples, displayed in the form of flowcharts, provide you with an overview of the program functionality and operating mode. "Glossary" All the abbreviations and specialist terms which occur in this manual are described in the Glossary. The terms are listed in alphabetical orders. "Appendix: Troubleshooting General Problems" This troubleshooting chapter gives some information of what you can do when problems arise that are not specific to an individual software or hardware product. "ETAS Contact Addresses" This chapter contains ETAS contact addresses. INCA-VLINK V1.3 - Installation Guide 7

8 General Information ETAS INCA-VLINK: Online Help The INCA-VLINK online help is integrated in the MATLAB/Simulink online help INCA-VLINK: Hardware Configurator Online Help Use the Help Help menu option or the button to invoke the general help function. Press the <F1> function key to call context-sensitive help. The tabs of the help window provide you with the following options: The "Contents" tab allows you to browse the help topics by categories. The "Index" tab lists all index entries. Browse the entire list, or enter a search term to limit the scope of listing. The "Search" tab allows you to search for individual words or terms included in a help topic. Type a search string and let the help function list the entries it has found related to this term. The "Favorites" tab allows you to bookmark topics. The "Glossary" tab contains special terms and their definitions. 8 INCA-VLINK V1.3 - Installation Guide

9 ETAS General Information Working with this Manual When INCA-VLINK is installed (cf. section 2.2.1), the INCA-VLINK installation guide, as well as the INCA-VLINK release notes and the safety advice, can be accessed from the Windows file system at <installation>\manuals. Presentation of Information All actions to be performed by the user are presented in a so-called "Use-Case" format. This means that the objective to be reached is first briefly defined in the title, and the steps required to reach the objective are then provided in a list. This presentation appears as follows: To attain a goal: Any preliminary information... Step 1 Explanations are given underneath an action. Step 2 Any explanation for Step 2... Step 3 Any explanation for Step 3... Any concluding remarks... Typographic Conventions The following typographic conventions are used in this manual: Select File Open. Click OK. Press <ENTER>. The "Open File" dialog window opens. Select the file setup.exe. A distribution is always a onedimensional table of sample points. The OSEK group (see has developed certain standards. Menu commands are shown in blue boldface. Buttons are shown in blue boldface. Keyboard commands are shown in angled brackets and CAPITALS. Names of program windows, dialog boxes, fields, etc. are shown in quotation marks. Text in drop-down lists on the screen, program code, as well as path- and file names are shown in the Courier font. General emphasis and new terms are set in italics. Links to internet documents are set in blue, underlined font. Important notes for the users are presented as follows: Tip Important note for users. INCA-VLINK V1.3 - Installation Guide 9

10 Installation ETAS 2 Installation This chapter is for all users who install, maintain, or uninstall INCA-VLINK. This chapter provides information on the delivery scope, hardware and software requirements for the installation, and the preparation required for installation. The chapter also describes the procedures used to install and uninstall INCA-VLINK. 2.1 Preparations Check the delivery package to make sure it is complete and make sure your system corresponds to the system requirements. Make sure that you have the necessary user privileges Delivery Scope The delivery scope of INCA-VLINK includes installation disk INCA-VLINK program files i.e. program files for virtual prototyping ETAS Virtual OS Execution Platform program files required for virtual prototyping INCA-VLINK installation guide in PDF format INCA-VLINK release notes, product overview etc. in PDF format Safety hints in PDF format Manual "Licensing End User Guide" in PDF format RTA-TRACE program files INCA-VLINK License You require a valid license for INCA-VLINK if you want to use the tool for hardware configuration or the generation of executable code. You obtain the license file required for licensing either from your tool coordinator or through a selfservice portal on the ETAS internet site at To request the license file you have to enter the activation number which you received from ETAS during the ordering process. To run a virtual prototype with XCP, you need one of the following licenses: ETAS Virtual OS Execution Platform (license name: INCA-VIP) INCA-EIP (license name: ASCET_INCA-EIP) For further information on licensing, see "Licensing the Software" on page System Prerequisites The system prerequisites are listed in the release notes of INCA-VLINK Required User Privileges for Installation In order to install INCA-VLINK on a computer, you need the user privileges of an administrator. Please contact your system administrator, if necessary. Using INCA-VLINK does not require user privileges of an administrator. 10 INCA-VLINK V1.3 - Installation Guide

11 ETAS Installation 2.2 Installation The following components will be installed during installation: INCA-VLINK Hardware Configurator Simulink blocks to access the Hardware Configurator Simulink blocks for real-time OS configuration Simulink blocks for project transfer to INTECRIO and INCA Simulink blocks for stimuli signal configuration Section describes the installation of INCA-VLINK, section describes manual association with MATLAB/Simulink, section contains special installation features for virtual prototyping, and section lists the options for command-line installation Initial Installation Windows XP (32 bit) + SP3, Windows XP (64 bit) + SP2, Windows 7 (32 bit or 64 bit) + SP1, Windows 8 (32 bit or 64 bit) or Windows 8.1 (32 bit or 64 bit) is required to install INCA-VLINK. If you try to install INCA-VLINK on a PC with Windows XP without appropriate SP, or an earlier OS, an error message opens and the installation is aborted. To start the installation: Insert the disk in the respective drive on your PC. An installation window opens. Follow the Main link, then follow the INCA-VLINK V1.3 Installation link (A in Fig. 2-1). A B Fig. 2-1 Installation window main page INCA-VLINK V1.3 - Installation Guide 11

12 Installation ETAS Alternatively, select the drive in the Windows Explorer and run the respective Setup.exe file. The ETAS Installer is launched. You can use the Next button to get to the next installation window; Back to get to the previous window, and Cancel to cancel installation. The installer checks if your computer meets the system requirements for INCA-VLINK installation. The result is displayed in the "System Check" window. If your system meets the requirements, the installation continues automatically. 12 INCA-VLINK V1.3 - Installation Guide

13 ETAS Installation License Agreement and Safety Hints: The following two windows show license agreement and safety hints in several languages. Read the license agreement, then activate the I read and accept the license agreement option. If you do not accept the license agreement, you cannot continue the installation. Click Next to continue. Read the safety hints carefully, then activate the I read and accept the safety hints option. If you do not accept the safety hints, you cannot continue the installation. Do one of the following: Click Next to continue. Click Proceed to Install to go to the "Ready to install" window immediately, with default settings for components to be installed, installation paths, etc. Continue reading in section "To install INCA-VLINK:" on page 16. INCA-VLINK V1.3 - Installation Guide 13

14 Installation ETAS To select components: The component selection window lists the necessary prerequisites and the components of INCA-VLINK. Prerequisites and components already present on your PC are marked accordingly. Components whose names appear in black font can be selected or deselected for installation. Thus, you specify the functional scope of the installed software. The text field on the right displays information on the highlighted component. To select/deselect a component for installation, activate/deactivate the respective option. Do one of the following: Click Next to continue. Click Proceed to Install to go to the "Ready to install" window immediately, with default settings for installation paths. Continue reading in section "To install INCA-VLINK:" on page INCA-VLINK V1.3 - Installation Guide

15 ETAS Installation To define path settings: In the "Installation directory" window, you are prompted to enter destination directories for the installation (referred to as <installation>) and for project data files. To change a preset directory, enter or select (via the Browse button) the new path. If you entered an invalid path, that path is displayed in red, and a warning appears. If you used the Browse button, proceed as follows. In the "Browse for Folder" window, select an existing directory. Or INCA-VLINK V1.3 - Installation Guide 15

16 Installation ETAS Use the tree structure and the Make New Folder button to create a new folder. Click OK to close the "Browse for Folder" window and accept your selection. Click Next or Proceed to Install to continue. To install INCA-VLINK: The "Ready to install" window lists the components selected for installation. You cannot change the selection here; to do so, you must go back to the "Installation" window (cf. page 14). Tip The next step will start the installation. You cannot cancel the installation once it is running; the Cancel button is deactivated. In the "Ready to install" window, click Install. The selected components (cf. page 14) are installed. Components already present on your PC are skipped. A progress indicator shows how the installation is progressing. 16 INCA-VLINK V1.3 - Installation Guide

17 ETAS Installation To connect INCA-VLINK and MATLAB/Simulink: After the installation is completed, the "Association with MATLAB" window opens. It offers all supported MATLAB/Simulink installations (R2009a and higher) available on your system for selection (A in the screenshot below). Even if no MATLAB/Simulink installation is found, the "Association with MATLAB" window opens (B in the screenshot). (A) (B) Tip If you want to use a network installation of MATLAB/Simulink, click on the Help button and follow the instructions given in the message window. In the "Association with Matlab" window, select one of the existing MATLAB/Simulink installations. You can select none, one, or several installations. Cancel closes the window without establishing an association to MATLAB/Simulink. INCA-VLINK is installed nevertheless, but you must associate the program to MATLAB/Simulink manually before you can use it. See section for details. Click OK. If at least one selected MATLAB/Simulink installation is R2011a or later, a message window opens and informs you that the legacy ASAM-MCD-2MC generation is only partly compatible with R2011a and higher and cannot be used with R2013b and above. Read the message text carefully, then click OK. INCA-VLINK is associated with the selected MATLAB/ Simulink installation(s). You can change the MATLAB/Simulink version associated with INCA-VLINK later; the procedure is described in section INCA-VLINK V1.3 - Installation Guide 17

18 Installation ETAS To complete the installation: Once all components have been installed successfully, you are prompted to end the installation. It is recommended that you activate the Show readme when setup is closed option Click on Finish to end the installation. In the Windows Start menu, the INCA-VLINK 1.3 folder with the following entries is created in the ETAS program group: Associate to Matlab Connects a selectable MATLAB/Simulink installation with INCA-VLINK (see section 2.2.2). This is necessary if MATLAB/Simulink is newly installed without INCA-VLINK being newly installed at the same time. Associate to RTA-OSEK Connects RTA-OSEK with INCA-VLINK. INCA-VLINK Manuals Opens the INCA-VLINK documentation directory. Uninstall INCA-VLINK The uninstall routine is started (see section 2.4). The ETAS License Manager has another separate folder License Management in the ETAS program group of the Start menu Manual Association with MATLAB/Simulink If MATLAB/Simulink was not present during INCA-VLINK installation, or if a new version of MATLAB/Simulink is installed after INCA-VLINK, you must associate INCA-VLINK and MATLAB/Simulink manually. To associate INCA-VLINK and MATLAB/Simulink manually: Tip If you want to use a network installation of MATLAB/Simulink, click on the Help button and follow the instructions given in the message window. Install MATLAB/Simulink as described in the relevant installation instructions. To associate INCA-VLINK with MATLAB/Simulink, open the Windows Start menu, go to the INCA-VLINK 1.3 folder and select Associate to Matlab. 18 INCA-VLINK V1.3 - Installation Guide

19 ETAS Installation The "Association with Matlab" window opens. It offers all supported MATLAB/Simulink installations available on your system for selection. In the "Association with Matlab" window, select one or more MATLAB/Simulink installations. Click OK to continue. If at least one selected MATLAB/Simulink installation is R2011a or later, a message window opens and informs you that the legacy ASAM-MCD-2MC generation is only partly compatible with R2011a and higher and cannot be used with R2013b and above. Read the message text carefully, then click OK. INCA-VLINK and the selected MATLAB/Simulink installation are connected Prerequisites for Calibration on a Windows PC Calibration on the Windows PC with INCA-VLINK requires RTA-OSEK Tools and RTA-OSEK for PC. These products will be installed as a part of the ETAS Virtual OS Execution Platform installation (B in Fig. 2-1 on page 11) on the product DVD. In addition, the installation contains the configurator and the generator for stimuli signals, the stimuli editor. The installation routine installs the RTA-OSEK Tools and RTA-OSEK for PC to the C:\RTA directory on your computer. The stimuli editor is installed to a customizable location. In the Windows Start menu, the ETAS Virtual OS Execution Platform 1.3 folder with the following entries entry is created in the ETAS program group. Signal Configuration Editor Opens the signal configuration editor where you can configure stimuli signals. Uninstall ETAS Virtual OS Execution Platform The uninstallation routine is started (see section 2.4). INCA-VLINK V1.3 - Installation Guide 19

20 Installation ETAS Virtual Prototyping Checks the installations of RTA-OSEK for PC and RTA-OSEK tools, and installs/starts the VRTA server service. If the check fails, hints for troubleshooting are given Command-Line Installation When you start the INCA-VLINK installation from a command line, you can use several command-line parameters to customize the installation. Each execution of Setup.exe writes a log file %appdata% 1 \ETAS\SETUP\ <date_time> Setup.log. /silent Silent installation mode. With this installation mode, no dialog windows requiring user information open. Tip To accept EULA and safety hints (cf. page 13) during silent installation, you must use the command-line parameters /EULAAccepted and /SafetyHintsAccepted. To deal with a possible request for a computer restart, you must use either the /NoRestart or the /AllowRestart command-line parameter. Default values are used for all information normally requested in installation windows. Error messages are hidden, too. /EULAAccepted Accepts the license agreement. The text of the license agreement is provided on the installation disk, in the EULA subfolders. /SafetyHintsAccepted Accepts the safety hints. The text of the safety hints is provided on the installation disk, in the SafetyHints subfolders. /NoRestart Suppresses a computer restart that may be required at the end of the installation. If a reboot is suppressed, a log message is issued. /AllowRestart Allows a computer reboot restart that may be required at the end of the installation. A restart is performed without further notice. /Debug Writes additional log files for *.msi packages. These files are stored in the %appdata% 2 \ETAS\SETUP folder. 1. %appdata% = C:\Documents and Settings\<username>\Application Data\ (Windows XP) C:\Users\<username>\AppData\Roaming (Windows 7) 20 INCA-VLINK V1.3 - Installation Guide

21 ETAS Installation /DefaultSettings Allows to specify an own XML file with default settings (instead of using InstallationDefaultSettings.xml), e.g., the following: Variable Meaning See also PRODINSTDIR installation directory PRODUSERDOCUMENTSDIR data directory page 15 COMPILERDIR compiler directory You can specify a relative path if the file is relative to Setup.exe, otherwise you have to specify an absolute path. Syntax: /DefaultSettings:"<path>\<filename>.xml" /uninstall Uninstalls INCA-VLINK. Can be combined with /silent for uninstallation without user interaction. /Repair In combination with /Silent, the repair process is triggered. Otherwise, the maintenance mode is triggered. Tip /Uninstall and /Repair cannot be used with setup.exe in the installation location. You must use the setup.exe file provided in the C:\<programs>\ETAS\GENericSetup\Blockset INCA-VLINK\1.3.<x>.<y> folder. <programs> = Program Files (x86) (64 bit OS) or Program Files (32 bit OS) Examples: Setup.exe /silent /EULAAccepted /SafetyHintsAccepted Triggers a silent installation. "C:\Program Files\ETAS\GENericSetup\Blockset INCA-VLINK\1.3.<x>.<y>\Setup.exe" /uninstall /Debug Triggers a non-silent uninstallation and writes additional logs. Setup.exe /DefaultSettings: D:\myOwnSettings.xml Triggers a non-silent installation that uses your own default settings for the installation. 2. %appdata% = C:\Documents and Settings\<username>\Application Data\ (Windows XP) C:\Users\<username>\AppData\Roaming (Windows 7) INCA-VLINK V1.3 - Installation Guide 21

22 Installation ETAS 2.3 Setting the Licensing Behavior The INCA-VLINK installation includes an installation of the ETAS license manager. You can define the way in which INCA-VLINK (and other ETAS software programs) accesses the required licenses in the [Licensing] section of an *.ini file. The folder Installation\INCA-VLINK\Packages\Blockset INCA-VLINK_Licensing* on your installation disk contains such an *.ini file, i.e. Licensing.ini. General Procedure The procedure to edit the Licensing.ini file and start the installation depends on the original location of the installation files. The installation files are placed in a directory where you cannot edit them: Use one of the following procedures. Copy all installation files to a directory where you can edit the files. There, edit Licensing.ini (cf. page 22), then start the installation via double-click on Autostart.exe or Setup.exe (cf. section 2.2.1) or via command line (cf. section 2.2.4). Copy only Licensing.ini to a directory where you can edit the file. There, edit Licensing.ini (cf. page 22). Create your own XML file with default settings (cf. page 21) and enter the location of your edited Licensing.ini file in the LIMA_INFILE variable: <Variable name="lima_inifile" defaultvalue="<path>\licensing.ini" validation="fileexists" /> Start the installation via command line (cf. section 2.2.4). and use /DefaultSettings:"<path>\<filename>.xml" to add your own XML file and with that your License.ini file. The installation files are placed in a directory where you can edit them: Edit the Licensing.ini file (cf. page 22) and start the installation. Editing Licensing.ini To define the access to the required licenses: Open the Licensing.ini file with a text editor. Modify the settings in the [Licensing] section as desired. The parameters and their settings are described below. Save your changes. The following parameters may be used: LicenseFileName Defines the absolute path and file name of the license file which is to be added. 22 INCA-VLINK V1.3 - Installation Guide

23 ETAS Installation LicensesToBorrow You can use this setting if licenses can be borrowed from a license server. To enable the borrow mechanism, you must enter the name of the product or features license (e.g., INCA-VLINK). If you enter more than one license, the license names must be separated by blanks. INCA-VLINK uses the following licenses: License name BLOCKSET_PC BLOCKSET INCA-VIP functionality target connector for virtual prototyping base functionality ETAS virtual OS execution platform BorrowExpiryMode Defines the way in which the expiration of the borrow status is given. Possible values are: Date If the BorrowExpiryMode is set to Date, the borrow period will expire at a certain date which is specified under BorrowExpiry- Date. Interval If the BorrowExpiryMode is set to Interval, the borrow period will expire after a certain number of days which is specified under BorrowExpiryInterval. BorrowExpiryDate If the BorrowExpiryMode is set to Date, this parameter specifies the date when the borrow period expires. The format is yyyy-mm-dd. BorrowExpiryInterval If the BorrowExpiryMode is set to Interval, this parameter specifies the length of the borrow period in days. ExecuteBorrowAutomaticExtensionInterval Defines at what point of time the borrow period will be automatically extended. This parameter specifies the number of days before the expiration of the current borrow period. When this time is reached, the borrow period is automatically extended to the interval specified under BorrowAutomaticExtensionInterval. BorrowAutomaticExtensionInterval This parameter specifies the borrow interval in days that is applied when an automatic extension of the borrow period is executed (as defined under ExecuteBorrowAutomaticExtensionInterval). INCA-VLINK V1.3 - Installation Guide 23

24 Installation ETAS ImmediateBorrow You can define that a license is automatically borrowed. Possible values are: True The license is borrowed automatically at installation time. Tip ImmediateBorrow= True works only for the user who performs the installation. Other users who work on the same computer do not own the borrowed license. False The license will be borrowed at the first time when the program connects to the license server. CustomLicenseFolder Due to the fact that the default location for added license files (e.g., C:\Documents and Settings\All Users\Application Data\ETAS\FlexNet for Windows XP) is only writeable for users with admin rights, a different path for the license file folder may be specified with this parameter. The following example defines that borrowing is enabled for all INCA-VLINK parts. The licenses will be borrowed when INCA-VLINK is started for the first time; by default the licenses expire after 100 days. [Licensing] LicenseFileName = d:\licenses\mylicense.lic LicensesToBorrow = BLOCKSET BLOCKSET_PC BorrowExpiryMode = Interval BorrowExpiryInterval = 100 ImmediateBorrow = false 2.4 Uninstalling INCA-VLINK or the ETAS Virtual OS Execution Platform If you uninstall INCA-VLINK or the ETAS Virtual OS Execution Platform, all components are uninstalled automatically. Use one of the following ways to start the uninstall process: 1. The Uninstall INCA-VLINK function in the INCA-VLINK program group in the Windows Start menu. 2. The Uninstall ETAS Virtual OS Execution Platform function in the ETAS Virtual OS Execution Platform program group In the Windows Start menu. 3. The Add/Remove Programs or Programs and Features icon in the Windows Control Panel. 24 INCA-VLINK V1.3 - Installation Guide

25 ETAS Installation To uninstall INCA-VLINK or the ETAS Virtual OS Execution Platform: Start the uninstall procedure. The ETAS installer is launched. You can use the Next button to get to the next uninstallation window; Back to get to the previous window, and Cancel to cancel uninstallation. Click Next to check if your computer meets the system requirements for INCA-VLINK or ETAS Virtual OS Execution Platform uninstallation. The result is displayed in the "System Check" window. If the system requirements for uninstallation are met, the "Ready to uninstall" window opens. It lists the components that will be uninstalled. You can- INCA-VLINK V1.3 - Installation Guide 25

26 Installation ETAS not change the selection. Tip The next step will start the uninstallation. You cannot cancel uninstallation once it is running; the Cancel button is deactivated. Click Uninstall to actually uninstall INCA-VLINK or the ETAS Virtual OS Execution Platform. A progress indicator shows how the uninstallation is progressing. Once all components have been uninstalled, a success window opens. Click Finish to end the uninstallation. 26 INCA-VLINK V1.3 - Installation Guide

27 ETAS Licensing the Software 3 Licensing the Software To be able to work with an ETAS software product, you require a license. This section contains basic details on this subject. "ETAS License Models" on page 27 "How to Get a License" on page 27 "The License File" on page 29 "Grace Mode" on page 31 "The "Expiration Warning" Window" on page 31 "Borrowing a License" on page 32 Details concerning the scope of the licenses and other legal aspects can be found in "Terms and Conditions". 3.1 ETAS License Models There are three different license models available for licensing your ETAS software: Machine-Named License, Local A license of this type is managed by the user him/herself. As it is linked to a particular PC (better: to the MAC address of the Ethernet adapter), it is valid wherever the PC is used. When you change your PC, you require a new license. User-Named License, Server-Based The licenses (of a department or company) are managed centrally on a server by a designated person. The license is linked to the MAC address of the server and to the user name with which the user is registered in the network. If the relevant PC is disconnected from the network, the license can be "borrowed." Concurrent (or Floating) License, Server-Based Most of what is true of the user-named license applies to this type of license. The difference is that here several users share a limited number of licenses. 3.2 How to Get a License If your company has a tool coordinator and server-based license management for ETAS software, contact this person. Otherwise (in the case of a machine-named license) you obtain your license from the ETAS license portal (the URL is shown on your Entitlement Certificate). INCA-VLINK V1.3 - Installation Guide 27

28 Licensing the Software ETAS There are three ways of logging in on the welcome page: Activation ID Once you have logged in, a specific activation 1 is visible and can be managed the activation ID is shown on your Entitlement Certificate. Entitlement ID All activations of the entitlement 2 are visible and can be managed (e.g. for a company with just one entitlement). and password All activations of the entitlements assigned to the user account are visible and can be managed (e.g. for a tool coordinator responsible for several entitlements). If you need help in the portal, click the Help link. What Information is Required? Information on the hosts must be entered to activate licenses: Machine-named license The MAC address of the Ethernet adapter to which the license is to be bound is required here User-named license Here, you need a server host or a server triad as well as a user name. Concurrent (floating) license Here, you need a server host or a server triad. Tip If this data changes (e.g. due to changes in the hardware or a change of user), the license must be given a "rehost". This procedure is also described in the portal help file. License File The result of your activities is the provision of a file <name>.lic with which you can license your software in the ETAS License Manager. 1. The activations refer to a specific product, its license conditions, the available number of licenses and other details required for generating a license. Activations are identified uniquely with activation IDs. 2. An entitlement shows the authorizations you have as a user; it stands for the right to own one or more licenses for a product. It is a kind of account of rights of use for software from which you can take licenses as you need to. 28 INCA-VLINK V1.3 - Installation Guide

29 ETAS Licensing the Software 3.3 The License File To check the license status: In the Windows Start menu, select Programs ETAS License Management ETAS License Manager. Click Continue. The ETAS License Manager contains one entry for each installed product. The symbol at the beginning of the entry and the "Status" column entry indicate whether a valid license has already been obtained or not. INCA-VLINK V1.3 - Installation Guide 29

30 Licensing the Software ETAS To add a license file: Open the ETAS License Manager (cf. page 29) and select File Add Licensing File. The "Install License" dialog window opens. Next to the "Select License File" field click the... button. In the file selection window, select the license file and click Open. The "Install License" dialog window shows information on the selected license. Tip The "Version" column shows the version number of the license, not the version number of the software. Confirm with OK. The license just added is now listed in the ETAS License Manager. A green symbol before the entry shows that the license is valid. Close the ETAS License Manager. 30 INCA-VLINK V1.3 - Installation Guide

31 ETAS Licensing the Software 3.4 Grace Mode If you have not yet installed a license, you can still operate the software for a limited amount of time it then runs in what is referred to as grace mode. The window shows you how long you can continue to operate the software in this mode. 3.5 The "Expiration Warning" Window If your installed license runs out in the next 30 days, a warning is shown when you open the ETAS software. The "Expiration Warning" window contains a list of licenses that expire in the next 30 days. The expiration date is shown for each license; in the case of borrowed licenses (see "Borrowing a License" on page 32) it also shows when the borrowing period expires (i.e. the date when borrow mode runs out). Click Manage Licenses to open the ETAS License Manager and install a valid license file. As soon as you have installed a valid license, you can continue to operate the ETAS software in normal operating mode. Click Ignore to close the dialog window and start the ETAS software. This is only possible during the grace period; as soon as the grace period has expired, you can only continue to use the ETAS software once you have installed a valid license file. As soon as the expiration date has been reached, you can continue to use the ETAS software for a further 14 days in what is referred to as limited mode (see "Grace Mode" on page 31). Once this phase is over, the ETAS software can only be used when a new or updated license file has been installed. INCA-VLINK V1.3 - Installation Guide 31

32 Licensing the Software ETAS 3.6 Borrowing a License The borrowing mechanism makes it possible to work offline even when using a server-based license (i.e. without being connected to the license server). Tip You can only borrow a license if a server-based license is being used! To borrow a license, proceed as follows: To borrow a license Make sure that the ETAS software the license of which you want to borrow is not open. Select the license you want to borrow in the "License Listing" table of the ETAS License Manager. Right-click the license and select Borrow License from the context menu The "Select Borrow end date" dialog window opens. 32 INCA-VLINK V1.3 - Installation Guide

33 ETAS Licensing the Software Select the date until which you want to borrow the license from the calendar displayed and click OK. The text in the "Source" column of the ETAS License Manager changes from SERVER to BOR- ROW, and the expiration date of the borrowed license is displayed. You can now use the relevant ETAS software offline until the expiration date of the borrowed license has been reached. If you want to use the ETAS software longer than you had originally planned, you can borrow the license again. If you stop using the ETAS software earlier than planned, you can return the license to the license server early (Return License from a license s context menu). A borrowed license can only be returned by the person that borrowed it; it cannot be returned by another person. INCA-VLINK V1.3 - Installation Guide 33

34 INCA-VLINK Quick Guide ETAS 4 INCA-VLINK Quick Guide 4.1 Introduction This chapter is intended to provide a quick guide to the most important features of INCA-VLINK V1.3. The examples, displayed in the form of flowcharts, provide you with an overview of the program functionality and operating mode. This chapter does not explain how to work with Simulink in general. Below, you find a short explanation of the most important abbreviations used here. DB Database EE Experiment Environment HC Hardware Configurator HW Hardware HWS Hardware System OS Operating system VP Virtual Prototyping WS Workspace 34 INCA-VLINK V1.3 - Installation Guide

35 ETAS INCA-VLINK Quick Guide 4.2 Preparing the Model INCA-VLINK models require a special system target and a fixed-step solver. 1 2 Preparing the Simulink Model Create and save Simulink model MATLAB or Simulink: select File New Model Simulink: File Save Select system target file Simulink: press <CTRL> + <E> select System target file open "Real-Time Workshop" 1. / "Code Generation" 2. node matching template makefile set automatically Select solver open "Solver" node select Fixed-step solver Fig. 4-1 Preparing the Simulink Model 1. MATLAB/Simulink R2010b or older 2. MATLAB/Simulink R2011a or newer INCA-VLINK V1.3 - Installation Guide 35

36 INCA-VLINK Quick Guide ETAS 4.3 Creating and Configuring a Hardware System You can add a hardware system to a new Simulink model or to an existing model. Before you can open the Hardware Configurator, you must save a new model so that its path is determined. Use the Hardware Configurator to configure the hardware system. The "Insert New Item" window contains the elements available on every hierarchical level. You can make various settings (e.g., channel settings for measure hardware etc.) for every hardware component using the relevant dialogs. The Hardware Systems folder is the folder for hardware systems (HWS) in the workspace. Create/Configure VP Hardware System Add configuration block Simulink: open library browser, then open ETAS Virtual Prototyping\Configuration library drag HW block to Simulink model Save Save model Open Hardware Configurator Simulink: double-click HW block Enable Ethernet controller HW Configurator, WS browser: select Ethernet_Controller, Enabled context menu Change hardware configuration (optional) WS Browser: Double-click an object Set values and enter comments (columns sortable) Fig. 4-2 Creating and Configuring a VP Hardware Configuration 36 INCA-VLINK V1.3 - Installation Guide

37 ETAS INCA-VLINK Quick Guide Importing a Hardware System As an alternative to manual creation and setup of a HWS, you can import a hardware description, *.hwx, created with INTECRIO, INTECRIO-RLINK, INCA-VLINK or ASCET-RP into a new, or an existing, hardware system. The file extension *.hwx is used for two description formats (HWX1 and HWX2). The HWX1 format can only be imported in an RP hardware configuration, it is not possible to import an HWX1 file in a VP hardware configuration. INCA-VLINK recognizes the format automatically and starts (HWX2) or aborts (HWX1) the import. After import file selection, HWX2 import is aided by a wizard (see Fig. 4-3). Import HWX2 hardware description Select *.hwx file WS Browser: select start node, i.e. Hardware Systems folder or existing hardware system or existing target (ES113x/ ES910/X86) or existing board/controller/device, Import context menu Windows file selection window: select *.hwx file, Open Set import options select import type, Finish Perform import HW description is imported; information, warnings, errors are shown in "Message" tab of "Log Window" Fig. 4-3 Importing a HWX2 hardware description (*.hwx file) 4.4 Specifying the Model This section focuses on how to use the blocks and features provided by INCA-VLINK. For information on standard MATLAB/Simulink functionality, refer to the MATLAB/ Simulink documentation. INCA-VLINK V1.3 - Installation Guide 37

38 INCA-VLINK Quick Guide ETAS Adding Activation Task Blocks The activation task blocks are provided in the "ETAS Virtual Prototyping" library, "Activation" sub-library. Adding / Configuring Activation Task Blocks Add task block Simulink: open Simulink Library Browser, go to ETAS * Prototyping\Activation add OS Exit Task or OS Init Task or OS Timer Task to model optional: Configure task block Simulink: doubleclick OS * Task block "Source Block Parameters: OS * Task" window: set parameters C identifier; mapped to associated task (see online help for additional information) defines point in task sequence when this task runs execution period, delay and priority (no. prio. ) of timer task Connect task block to trigger input Simulink: use standard means to connect task block to trigger input of function-call subsystem Fig. 4-4 Adding and configuring activation task blocks 38 INCA-VLINK V1.3 - Installation Guide

39 ETAS INCA-VLINK Quick Guide Adding the System Time Block The OS System Time block provides a data output port for the target system time to be read. The block is provided in the "ETAS Virtual Prototyping" library, "Activation" sub-library. Adding / Configuring OS System Time Block Simulink: open Simulink Library Browser, go to ETAS * Prototyping\Activation add OS System Time to model Add system time block optional: Connect system time block to model Simulink: use standard means to connect OS System Time block to the model. Fig. 4-5 Adding and configuring an OS System Time block 4.5 Stimuli Signal Configuration INCA-VLINK enables you to define a stimuli signal configuration for use with your controller function. INCA-VLINK V1.3 - Installation Guide 39

40 INCA-VLINK Quick Guide ETAS Stimuli Signal Configuration Block Add Stimuli Signal Configuration Block + MDF File MATLAB/Simulink: open model Open VP model Add 1 Stimuli Signal Configuration block Open Signal Configuration Editor Simulink: open library browser, go to ETAS Virtual Prototyping\ Configuration add Stimuli Signal Configuration to model Simulink: double-click Stimuli Signal Configuration Fig. 4-6 Add MDF file Signal Configuration Editor: select File Add MDF File file selection window: select MDF file(s), Open "Channel Groups" field shows (a) MDF files (b) channels (signal groups) per MDF file Adding a Signal Configuration block and MDF file(s) (a) (b) 40 INCA-VLINK V1.3 - Installation Guide

41 ETAS INCA-VLINK Quick Guide Managing MDF Files open Signal Configuration Editor Removing MDF files Select File Remove MDF File select file(s) to be removed, Remove Replacing MDF files Select File Replace MDF File b) file selection dialog: select replacing MDF file, Open a) select file to be replaced, click if desired, repeat a) and b) decide: keep mapping? OK Signal Configuration Editor: click Save and Close Fig. 4-7 Managing MDF files INCA-VLINK V1.3 - Installation Guide 41

42 INCA-VLINK Quick Guide ETAS Selecting Signals for Stimuli Configuration open Signal Configuration Editor Select channel group (= signal group) select channel group Set channel group parameters set parameters Select / deselect signals select: filter "Available Signals" list (opt.), select signal(s), click on >> deselect: select signal in "Signal Assignment" pane, << Set up signals "Value" column: double-click cell, enter value, <RETURN> entered value shown during measurement "Convert" column: activate option implementation value is converted to physical value Rename model labels Signal Configuration Editor: click Save and Close "Model" column: double-click cell to be renamed enter new model label name, <RETURN> old label now unmapped Fig. 4-8 Signals for stimuli configuration Stimuli Signal Group Receive Block The Stimuli Signal Group Receive block enables you to create ports by mapping signals defined in existing MDF files to the block. You can route signals via these ports to objects within the control function. 42 INCA-VLINK V1.3 - Installation Guide

43 ETAS INCA-VLINK Quick Guide Add Stimuli Signal Group Receive Block MATLAB/Simulink: open model Open VP model Fig. 4-9 Add Stimuli Signal Group Receive block Simulink: open library browser, go to ETAS Virtual Prototyping\ Signal Routing add Stimuli Signal Group Receive to model Adding a Stimuli Signal Group Receive block Add Ports to Stimuli Signal Group Receive Block Simulink: double-click Stimuli Signal Group Receive block Open signal selection dialog select 1 channel group, Next Select signals activate/deactivate signals, Finish Connect signals to model 1 signal group port (= trigger port, 1 st port) and selected signal ports are created resize Stimuli Signal Group Receive block, if necessary Fig connect signal group port (e.g., to terminator or trigger input of function-call subsystem) connect signal ports to model elements Adding ports to a Stimuli Signal Group Receive block INCA-VLINK V1.3 - Installation Guide 43

44 INCA-VLINK Quick Guide ETAS Further mapping of signals to ports is done in the Signal Configuration Editor. Mapping Signals to Ports: Automatically open Signal Configuration Editor Use carefully; may destroy existing mappings Open Signal Configuration Editor Auto Mapping Settings select Options Auto Mapping Settings select mapping rule activate and set up prefix/suffix treatment (see help for details) OK Auto Mapping Preview select Options Auto Mapping preview or "Log Window" lists expected automapping failures Auto Map Channels select Options Auto Map Channels or if possible, signals are mapped to ports; "Log Window" lists automapping ambiguities and failures Signal Configuration Editor: click Save and Close Fig Mapping signals to ports automatically 44 INCA-VLINK V1.3 - Installation Guide

45 ETAS INCA-VLINK Quick Guide Mapping Signals to Ports: Manually open Signal Configuration Editor Open Signal Configuration Editor Select signal to be remapped Signal Configuration Editor, "Signal Assignment" pane: select signal to be mapped, Select new model label select new model label, Edit Mapping (a) (b) formerly mapped model port is now unmapped (a), selected signal is mapped to new model label (b) Signal Configuration Editor: click Save and Close Fig Mapping signals to ports manually 4.6 Exporting the Model and Experimenting Once your model is complete, you can export it to INCA (chapter 4.6.1) or INTEC- RIO (chapter 4.6.2), and then perform an experiment. To do so, you need the following software versions, in combination with valid licenses: INCA V7.0 or higher / INCA-EIP V7.0.1 or higher / ETAS Virtual OS Execution Platform INTECRIO V4.4.1 or higher INCA-VLINK V1.3 - Installation Guide 45

46 INCA-VLINK Quick Guide ETAS Export / Experiment INCA Exporting to INCA Add INCA Experiment Transfer block Simulink: open Simulink Library Browser, go to ETAS * Prototyping\Configuration (* = Rapid or Virtual) add block INCA Experiment Transfer to model Build model Start INCA transfer Select INCA database Simulink: press <CTRL> + <B> or select menu option: Tools Realtime Workshop Build Model ( R2010b) Tools Code Generation Build Model (R2011a 12a) Code C/C++ Code Build ( R2012b) Simulink: double-click INCA Experiment Transfer block "INCA Project Transfer" window: Browse button (a) (a) (b) (c) select folder of existing INCA DB or use Make New Folder to create new DB click OK INCA opens with selected DB; DB listed in "INCA Project Transfer" window Select INCA workspace "INCA Project Transfer" window: click Browse button (b) WS listed in "INCA Project Transfer" window select existing INCA WS or New Workspace / New Folder to create WS click OK Select INCA project Perform transfer "INCA Project Transfer" window: click Browse button (c) select existing INCA project or New INCA Project / New Folder to create project click OK Fig "INCA Project Transfer" window: Start Project Transfer Exporting the model to INCA 46 INCA-VLINK V1.3 - Installation Guide

47 ETAS INCA-VLINK Quick Guide VP Experiment in INCA (with XCP) INCA: select DB folder, open Edit menu or folder context menu, Add Experiment Create and define experiment select workspace in "1 Database" list, Experiment Change Experiment experiment added to WS select experiment OK Set up hardware device select Device Configure hardware remove ( ) existing hardware devices add ( ) Ethernet-System\XCP hardware device and select transferred project (see also INCA online help) Run <model>.bat file Open experiment / initialize hardware Windows Explorer: go to folder with Simulink model, run <model name>.bat virtual ECU is started INCA: Experiment Run Experiment INCA EE opens INCA EE: Hardware Initialize hardware Hardware Manage memory pages Perform upload (b) (a) (c) go to "Enhanced" tab (a), select action Upload (b), Do it (c), Close Experiment in INCA set up and perform INCA experiment (cf. INCA online help) Fig VP Experiment in INCA (with XCP) INCA-VLINK V1.3 - Installation Guide 47

48 INCA-VLINK Quick Guide ETAS VP Experiment in INCA (without XCP) INCA: select DB folder, open Edit menu or folder context menu, Add Experiment Create and define experiment select workspace in "1 Database" list, Experiment Change Experiment experiment added to WS select experiment OK Set up hardware device select Device Configure hardware add ( ) PC/Simulation System\ Virtual prototyping HW device and select transferred project (see also INCA online help) Open experiment / initialize hardware INCA: Experiment Run Experiment INCA EE opens INCA EE: Hardware Initialize hardware Experiment in INCA Fig set up and perform INCA experiment (cf. INCA online help) VP Experiment in INCA / INCA-EIP (without XCP) 48 INCA-VLINK V1.3 - Installation Guide

49 ETAS INCA-VLINK Quick Guide Export / Experiment INTECRIO Export to / Experiment in INTECRIO Add INTECRIO Integration Platform Transfer block Simulink: open Simulink Library Browser, go to ETAS * Prototyping\Configuration (* = Rapid or Virtual) add block INTECRIO Integration Platform Transfer to model Build model (optional) Start INTECRIO transfer Select workspace directory Simulink: press <CTRL> + <B> or select menu option: Tools Realtime Workshop Build Model ( R2010b) Tools Code Generation Build Model (R2011a 12a) Code C/C++ Code Build ( R2012b) Simulink: double-click INTECRIO Integration Platform Transfer block "INTECRIO Integration Platform" window: enter or select (via Browse) an empty directory for the INTECRIO WS Perform transfer click Start transfer INTECRIO WS created model imported and built WS opens in INTEC- RIO Experiment in INTECRIO INTECRIO: optional: adjust INTECRIO system project (see INTECRIO online help) start experiment (see EE online help) Fig Exporting the model to INTECRIO, experimenting in INTECRIO INCA-VLINK V1.3 - Installation Guide 49

50 Glossary ETAS 5 Glossary This glossary contains explanations of the technical terms and abbreviations used in the INCA-VLINK documentation. While some terms are also used in a more general sense, this glossary specifically addresses the meaning of those terms as they are applied to calibration on Windows with INCA-VLINK. The terms are listed in alphabetical order. ASAM-MCD Working Group for Standardizing Automation and Measuring Systems, including the Working Groups Measuring, Calibrating, and Diagnostics (German: Arbeitskreis zur Standardisierung von Automations- und Messsystemen, mit den Arbeitsgruppen Messen, Calibrieren und Diagnose) ASAM-MCD-2MC A file format used to describe the calibration variables and measured signals contained in the control unit software, and additional specific information designed to parameterize the experiment interface. ASAM-MCD- 2MC is used to import the information required for this into an experiment (A2L file). For further information, refer to CAN Controller area network CANdb CAN database; CAN description file created with the CANdb data management program made by the company Vector Informatik. CPU Central processing unit ECU Electronic control unit; a small embedded computer system that consists of a CPU and the associated periphery, where everything is usually located in the same housing. ETK emulator test probe (German: Emulator-Tastkopf) Event An event is an (external) trigger that initiates an action of the operating system, such as a task. EVPT_ERT ETAS virtual prototyping realtime target for embedded coder (RTW Embedded Coder or Embedded Coder real-time target) EVPT_GRT ETAS virtual prototyping realtime target (RTW or Simulink Coder real-time target) HW Hardware 50 INCA-VLINK V1.3 - Installation Guide

51 ETAS Glossary INCA ETAS measuring, calibration and diagnostics system (Integrated Calibration and Acquisition Systems) INCA-EIP INCA add-on; allows access to the simulation node and other experimental targets for INCA. INCA-VLINK V1.3 requires INCA-EIP V7.0.1 or higher. INCA-VLINK INCA-VLINK is a tool that allows users to configure a virtual prototyping experiment from within MATLAB/Simulink and use it in experiments with INCA/INCA-EIP. INTECRIO Integrated Prototyping Environment The INTECRIO Integrated Prototyping Environment offers an integration platform that is able to combine, i.e. integrate, control algorithms whose parts have been created with different function modeling tools. It allows for creating and configuring hardware systems and the connections of these hardware systems with the control algorithms. INTECRIO-RLINK V1.3, INCA-VLINK V1.3 and INTECRIO V4.4 share the same technical basis. INTECRIO-RLINK and INCA-VLINK provide an automated transfer of their models to workspaces for the INTECRIO Integrated Prototyping Environment. INTECRIO-RLINK INTECRIO-RLINK is a tool that allows users to configure a rapid-prototyping or virtual-prototyping experiment from within MATLAB/Simulink and use it in experiments with INCA/INCA-EIP. LSB and lsb Least Significant Byte (capital letters) or bit (small letters) MATLAB High-performance language for technical calculations; contains mathematical calculations, visualization and programming in one environment. MSB and msb Most Significant Byte (capital letters) or bit (small letters) NVRAM Non-volatile RAM OS Operating system OSEK Working group for Open Systems for Electronics in Motor Vehicles (German: Offene Systeme für die Elektronik im Kraftfahrzeug) Process A process is a simultaneously executable functionality that is activated by the operating system. Processes are specified in modules and do not feature any arguments/inputs or result values/outputs. INCA-VLINK V1.3 - Installation Guide 51

52 Glossary ETAS Processor see CPU Prototype Completely executable file for an experimental target system. Such a prototype shows the software functions in practical use entirely with different goal directions and in a different appropriation. RTA-OSEK ETAS real-time operating system; implements the AUTOSAR-OS V1.0 (SC-1) and OSEK/VDX OS V2.2.3 standards and is fully MISRA compliant. RTA-OS ETAS real-time operating system; implements the AUTOSAR R3.0 OS and OSEK/VDX OS V2.2.3 standards and is fully MISRA compliant. RTA-RTE AUTOSAR runtime environment by ETAS RTIO Real-time Input-Output RTOS Real-time operating system SCOOP-IX SCOOP Interface Exchange language. INCA-VLINK V1.3 supports the SCOOP-IX versions V1.0, V1.1 and V1.2. Simulink Tool for modeling, simulation and analysis of dynamic systems. INCA-VLINK adds the possibility to configure virtual prototyping experiments and run them on ETAS hardware using INCA and INCA-EIP. SP service point SW software Task A task is an ordered collection of processes that can be activated by the operating system. Attributes of a task are its application modes, activation trigger, priority and modes of its scheduling. Upon activation, the processes of the task are executed in the specified order. UDP User datagram protocol Virtual prototyping Function developers create virtual prototypes of electronic vehicle functions and test them on the PC. 52 INCA-VLINK V1.3 - Installation Guide

53 ETAS Glossary XCP Universal measurement and calibration protocol; the x generalizes the various transportation layers that can be used. INCA-VLINK V1.3 supports XCP version V1.0. XETK emulator test probe (ETK) with ethernet interface XML Extensible Markup Language INCA-VLINK V1.3 - Installation Guide 53

54 Appendix: Troubleshooting General Problems ETAS 6 Appendix: Troubleshooting General Problems This chapter gives some information of what you can do when problems arise that are not specific to an individual software or hardware product. 6.1 Problems and Solutions Network Adapter cannot be selected via Network Manager Cause: APIPA is disabled The alternative mechanism for IP addressing (APIPA) is usually enabled on all Windows systems. Network security policies, however, may request the APIPA mechanism to be disabled. In this case, you cannot use a network adapter which is configured for DHCP to access ETAS hardware. The ETAS Network Manager displays a warning message. The APIPA mechanism can be enabled by editing the Windows registry. This is permitted only to users who have administrator privileges. It should be done only in coordination with your network administrator. To enable the APIPA mechanism: Open the Registry Editor: Windows XP and Windows 7: Click Start and then click Run. Enter regedit and click OK. Windows Vista: Click Start, enter regedit in the entry field, and push <ENTER>. The registry editor is displayed. Open the folder HKEY_LOCAL_MACHINE\ SYSTEM\CurrentControlSet\Services\ Tcpic\Parameters\ Click Edit Find to search for the key IPAutoconfigurationEnabled. If you cannot find any instances of the registry key mentioned, the APIPA mechanism has not been disabled on your system, i.e. there is no need to enable it. Otherwise proceed with the following steps. Set the value of the key IPAutoconfigurationEnabled to 1 to enable the APIPA mechanism. You may find several instances of this key in the Windows registry which either apply to the TCP/IP service in general or to a specific network adapter. You only need to change the value for the corresponding network adapter. Close the registry editor. Restart your workstation in order to make your changes take effect. 54 INCA-VLINK V1.3 - Installation Guide

55 ETAS Appendix: Troubleshooting General Problems Search for Ethernet Hardware fails Cause: The versions of the Hardware and the ETAS MC Software are not compatible If you are using ETAS hardware with ETAS MC software, you can use the ETAS HSP Update Tool to check the firmware version of your hardware: Make sure you use the ETAS HSP Update Tool with the latest HSP (Hardware Service Pack) version. Also use the HSP Update Tool to check whether the hardware is compatible with the MC software used. Make sure any additional drivers for that hardware are installed correctly. You can get the required HSP from the ETAS internet pages under If you still cannot find the hardware using the HSP Update Tool, check whether the hardware offers a Web interface and whether you can find using this interface. Otherwise check whether one of the following causes and solutions might apply. Cause: Personal Firewall blocks Communication For a detailed description on problems caused by personal firewalls and possible solutions see "Personal Firewall blocks Communication" on page 57. Cause: Client Software for Remote Access blocks Communication PCs or notebooks which are used outside the ETAS hardware network sometimes use a client software for remote access which might block communication to the ETAS hardware. This can have the following causes: A firewall which is blocking Ethernet messages is being used (see Cause: Personal Firewall blocks Communication on page 55) By mistake, the VPN client software used for tunneling filters messages. As an example, Cisco VPN clients with versions before V4.0.x in some cases erroneously filtered certain UDP broadcasts. If this might be the case, please update the software of your VPN client. Cause: ETAS Hardware hangs Occasionally the ETAS hardware might hang. In this case switch the hardware off, then switch it on again to re-initialize it. Cause: ETAS Hardware went into Sleep Mode In order to save power, some ETAS devices will go to sleep mode if they do not see that they are connected to another device/computer. To solve that, connect your Ethernet cable from your computer to the "HOST"/ "Sync In" port on the device. After the device turns on, connect to the device using the web interface and change the settings so that the device stays always on. Consult the device's manual for details on how to do that. INCA-VLINK V1.3 - Installation Guide 55

56 Appendix: Troubleshooting General Problems ETAS Cause: Network Adapter temporarily has no IP Address Whenever you switch from a DHCP company LAN to the ETAS hardware network, it takes at least 60 seconds until ETAS hardware can be found. This is caused by the operating system s switching from the DHCP protocol to APIPA, which is being used by the ETAS hardware. Cause: ETAS Hardware had been connected to another Logical Network If you use more than one PC or notebook for accessing the same ETAS hardware, the network adapters used must be configured to use the same logical network. If this is not possible, it is necessary to switch the ETAS hardware off and on again between different sessions (repowering). Cause: Device driver for network card not in operation It is possible that the device driver of a network card is not running. In this case you will have to deactivate and then reactivate the network card. To deactivate and reactivate the network card (Win XP, Win Vista): To deactivate the network card, select the following item from the Windows start menu: Windows XP: Control Panel Network Connections Windows Vista: Control Panel Network and Internet Network and Sharing Center Right click on the used network adapter and select Disable in the context menu. In order to reactivate the network adapter right click on it again and select Enable. To deactivate and reactivate the network card (Win 7): To deactivate the network card, select Control Panel Device Manager from the Windows start menu. In the Device Manager, open the tree structure of the entry Network Adapters. Click on the used connection to open its "<connection name> Status" dialog window. Right-click on the used network adapter and select Disable in the context menu. In order to reactivate the network adapter rightclick on it again and select Enable. Cause: Laptop power management deactivates the network card The power management of a laptop computer can deactivate the network card. Therefore you should turn off power monitoring on the laptop. 56 INCA-VLINK V1.3 - Installation Guide

57 ETAS Appendix: Troubleshooting General Problems To switch off power monitoring on the laptop: From the Windows Start Menu, select Windows XP: Control Panel System. Then select the Hardware tab and click on Device Manager. Windows 7: Control Panel Device Manager. In the Device Manager open the tree structure of the entry Network Adapters. Right click on the used network adapter and select Properties in the context menu. Select the Power Management tab and deactivate the Allow the computer to turn off this device to save power option. Select the Advanced tab. If the property Autosense is included, deactivate it also. Click OK to apply the settings. Cause: Automatic disruption of network connection It is possible after a certain period of time without data traffic that the network card automatically interrupts the Ethernet connection. This can be prevented by setting the registry key autodisconnect. To set the registry key autodisconnect: Personal Firewall blocks Communication Open the Registry Editor. Select under HKEY_LOCAL_MACHINE\SYSTEM\ ControlSet001\Services\lanmanserver\ parameters the Registry Key autodisconnect and change its value to 0xffffffff. Cause: Permissions given through the firewall block ETAS hardware Personal firewalls may interfere with access to ETAS Ethernet hardware. The automatic search for hardware typically cannot find any Ethernet hardware at all, although the configuration parameters are correct. Certain actions in ETAS products may lead to some trouble if the firewall is not properly parameterized, e.g. upon opening an experiment in ASCET or searching for hardware from within INCA or HSP. If a firewall is blocking communication to ETAS hardware, you must either disable the firewall software while working with ETAS software, or the firewall must be configured to give the following permissions: Outgoing limited IP broadcasts via UDP (destination address ) for destination ports or INCA-VLINK V1.3 - Installation Guide 57

58 Appendix: Troubleshooting General Problems ETAS Incoming limited IP broadcasts via UDP (destination IP , originating from source IP ) for destination port Directed IP broadcasts via UDP to the network configured for the ETAS application, destination ports or Outgoing IP unicasts via UDP to any IP in network configured for the ETAS application, destination ports through Incoming IP unicasts via UDP originating from any IP in the network configured for the ETAS application, source ports through 18020, destination ports through Outgoing TCP/IP connections to the network configured for the ETAS application, destination ports through Tip The ports that have to be used in concrete use cases depend on the hardware used. For more precise information on the port numbers that can be used please refer to your hardware documentation. The Windows operating systems come with a built-in personal firewall. In addition, it is very common to have personal firewall software from third party vendors, such as Symantec, McAffee or BlackIce installed. The proceedings in configuring the ports might differ for each personal firewall software used. Therefore please refer to the user documentation of your personal firewall software for further details. As an example for a firewall configuration, you will find below a description on how to configure the widely used Windows XP firewall if the hardware access is prohibited under Windows XP with Service Pack 2. Solution for Windows XP Firewall, Users with Administrator Privileges If you have administrator privileges on your PC, the following dialog window opens if the firewall blocks an ETAS product. 58 INCA-VLINK V1.3 - Installation Guide

59 ETAS Appendix: Troubleshooting General Problems To unblock a product: In the "Windows Security Alert" dialog window, click on Unblock. The firewall no longer blocks the ETAS product in question (in the example: ASCET). This decision survives a restart of the program, or even the PC. Instead of waiting for the "Windows Security Alert" dialog window, you can unblock ETAS products in advance. To unblock ETAS products in the firewall control: From the Windows Start Menu, select Settings Control Panel. In the control panel, double-click the Windows Firewall icon to open the "Windows Firewall" dialog window. INCA-VLINK V1.3 - Installation Guide 59

60 Appendix: Troubleshooting General Problems ETAS In the "Windows Firewall" dialog window, open the "Exceptions" tab. This tab lists the exceptions not blocked by the firewall. Use Add Program or Edit to add new programs, or edit existing ones. Make sure that the ETAS products and services you want to use are properly configured exceptions. Open the "Change Setup" window. To ensure proper ETAS hardware access, make sure that at least the IP addresses xxx are unblocked. Close the "Change Setup" window with OK. Close the "Windows Firewall" dialog window with OK. The firewall no longer blocks the ETAS product in question. This decision survives a restart of the PC. 60 INCA-VLINK V1.3 - Installation Guide

61 ETAS Appendix: Troubleshooting General Problems Solution for Windows XP Firewall, Users without Administrator Privileges This section addresses users with restricted privileges, e.g., no system changes, write restrictions, local login. Working with an ETAS software product requires "Write" and "Modify" privileges within the ETAS, ETASData, and ETAS temporary directories. Otherwise, an error message opens if the product is started, and a database is opened. In that case, no correct operation of the ETAS product is possible because the database file and some *.ini files are modified during operation. The ETAS software has to be installed by an administrator anyway. It is recommended that the administrator assures that the ETAS program/processes are added to the list of the Windows XP firewall exceptions, and selected in that list, after the installation. If this is omitted, the following will happen: The "Window Security Alert" window opens when one of the actions conflicting with a restrictive firewall configuration is executed. To unblock a program (no Admin privileges): In the "Windows Security Alert" dialog window, activate the option For this program, don t show this message again. Click OK to close the window. An administrator has to select the respective ETAS software in the "Exceptions" tab of the "Windows Firewall" dialog window to avoid further problems regarding hardware access with that ETAS product. INCA-VLINK V1.3 - Installation Guide 61