INCA-VLINK V1.3 Getting Started Copyright The data in this document may not be altered or amended without special noti- fication from ETAS GmbH. ETAS GmbH undertakes no further obligation in rela- tion 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 AM019910 V1.3 R01 EN - 11.2014 2 ETAS Contents Contents 1 General Information . 5 1.1 Safety Advice . 5 1.1.1 Correct Use . 5 1.1.2 Labeling of Safety Instructions . 5 1.1.3 Demands on the Technical State of the Product. 5 1.2 System Information . 6 1.3 User Information . 6 1.3.1 What You Need to Know . 6 1.3.2 Structure of the Documentation . 7 1.3.3 INCA-VLINK: Online Help. 8 1.3.4 INCA-VLINK: Hardware Configurator Online Help . 8 1.3.5 Working with this Manual . 9 2 Installation . 10 2.1 Preparations . 10 2.1.1 Delivery Scope. 10 2.1.2 INCA-VLINK License. 10 2.1.3 System Prerequisites . 10 2.1.4 Required User Privileges for Installation . 10 2.2 Installation . 11 2.2.1 Initial Installation . 11 2.2.2 Manual Association with MATLAB/Simulink. 18 2.2.3 Prerequisites for Calibration on a Windows PC . 19 2.2.4 Command-Line Installation . 20 2.3 Setting the Licensing Behavior . 22 2.4 Uninstalling INCA-VLINK or the ETAS Virtual OS Execution Platform . 24 3 Licensing the Software . 27 3.1 ETAS License Models . 27 INCA-VLINK V1.3 - Installation Guide 3 Contents ETAS 3.2 How to Get a License . 27 3.3 The License File . 29 3.4 Grace Mode . 31 3.5 The "Expiration Warning" Window . 31 3.6 Borrowing a License . 32 4 INCA-VLINK Quick Guide . 34 4.1 Introduction . 34 4.2 Preparing the Model . 35 4.3 Creating and Configuring a Hardware System . 36 4.3.1 Importing a Hardware System . 37 4.4 Specifying the Model . 37 4.4.1 Adding Activation Task Blocks . 38 4.4.2 Adding the System Time Block. 39 4.5 Stimuli Signal Configuration . 39 4.5.1 Stimuli Signal Configuration Block . 40 4.5.2 Stimuli Signal Group Receive Block . 42 4.6 Exporting the Model and Experimenting . 45 4.6.1 Export / Experiment – INCA . 46 4.6.2 Export / Experiment – INTECRIO. 49 5 Glossary . 50 6 Appendix: Troubleshooting General Problems . 54 6.1 Problems and Solutions . 54 6.1.1 Network Adapter cannot be selected via Network Manager. 54 6.1.2 Search for Ethernet Hardware fails. 55 6.1.3 Personal Firewall blocks Communication . 57 7 ETAS Contact Addresses . 62 Index . 63 4 INCA-VLINK V1.3 - Installation Guide 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 dam- age to the device. 1.1.1 Correct Use ETAS GmbH cannot be made liable for damage which is caused by incorrect use and not adhering to the safety instructions. 1.1.2 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. 1.1.3 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 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 R2011a and higher • Simulink® • Simulink® • Real-Time Workshop® •MATLAB® Coder™ • Real-Time Workshop® Embedded Coder™ • Simulink® Coder™ • Stateflow® • Embedded Coder™ • Stateflow® Coder™ • Stateflow® • Simulink® Fixed Point™ • Simulink® Fixed Point™ • Fixed Point Toolbox™ • 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 1.3.1 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 Win- ® dows 8.1. All users should be capable of executing menu functions, activating buttons etc. Users should also be acquainted with the Windows file storage sys- tem, 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 Cor- poration. Knowledge of a programming language, preferably ANSI-C, can be helpful to advanced users. 6 INCA-VLINK V1.3 - Installation Guide ETAS General Information 1.3.2 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 con- tains 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 installa- tion 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 General Information ETAS 1.3.3 INCA-VLINK: Online Help The INCA-VLINK online help is integrated in the MATLAB/Simulink online help. 1.3.4 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 ETAS General Information 1.3.5 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.