ASCET-DEVELOPER 7.3 Getting Started Guide

Transcription

1 ASCET-DEVELOPER 7.3 Getting Started Guide

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 2017 ETAS GmbH, Stuttgart The names and designations used in this document are trademarks or brands belonging to the respective owners. Document EC V7.3 R01 EN

3 Contents Contents 1 Introduction Safety Advice Labeling of Safety Advice Correct Use Demands on the Technical State of the Product Definitions and Abbreviations Conventions About You Installation Preparation Delivery Scope System Prerequisites Installing ASCET-DEVELOPER Installation via Dialog Windows Command-Line Installation What is Installed? Post Installation Setup Changing the Installation Location after Installation Uninstalling ASCET-DEVELOPER Installation Experiment Environment Initial Installation Setting the Licensing Behavior Experiment Environment Command-Line Installation Installation VRTA OSEK Runtime for PC Licensing the Software Developing Software with ASCET-DEVELOPER Starting ASCET-DEVELOPER 7.3 for the First Time Installing the Examples How to Start My Own Project How to Create Models How to Run an Experiment Where is the Code Generated? Compiling and Linking in the Eclipse CDT Generating Code from the Command Line Finding Out More ETAS Contact Addresses ASCET-DEVELOPER 7.3 Getting Started Guide 3

4 Figures Figures Figure 1: ASCET-DEVELOPER 7.3 Setup Wizard...10 Figure 2: ASCET-DEVELOPER 7.3 Setup Choose Install Location...11 Figure 3: ASCET-DEVELOPER 7.3 Setup Choose Start Menu Folder...12 Figure 4: Completing the ASCET-DEVELOPER 7.3 Setup Wizard...13 Figure 5: "Workspace Launcher" window...28 Figure 6: ASCET-DEVELOPER Safety Advice...29 Figure 7: ASCET-DEVELOPER 7.3 Welcome page...30 Figure 8: ASCET-DEVELOPER 7.3 Workspace...30 Figure 9: "New Example" window...31 Figure 10: "New Project" window...32 Figure 11: "New ASCET Project" window...33 Figure 12: "Edit Configuration" window, "Main" tab...36 ASCET-DEVELOPER 7.3 Getting Started Guide 4

5 Introduction 1 Introduction ETAS ASCET-DEVELOPER 7.3 is a development tool to help you build object-based, realtime, high-performance, low-overhead, ultra-portable, safe and secure software for embedded hardware. ASCET-DEVELOPER 7.3 lets you build programs using graphical and textual notations and uses advanced, proven-in-use, code generation technology to automatically turn the model into C code. The code generator handles important but tedious jobs that you normally need to worry about when writing C code, for example under and overflow, division by zero, array boundary violations, etc. so you can concentrate on the important job of getting your job done while letting ASCET-DEVELOPER 7.3 handle the details. 1.1 Safety Advice Please adhere to the Product Liability Disclaimer (ASCET Safety Advice) and to the following safety instructions to avoid injury to yourself and others as well as damage to the device Labeling of Safety Advice 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 Correct Use ETAS GmbH cannot be made liable for damage which is caused by incorrect use and not adhering to the safety instructions. ASCET-DEVELOPER 7.3 Getting Started Guide 5

6 Introduction Tip This ETAS product fulfils standard quality management requirements. If requirements of specific safety standards (e.g. IEC 61508, ISO 26262, DO-178b, EN50128 and other similar standards) need to be fulfilled, these requirements must be explicitly defined and ordered by the customer. Before use of the product, customers must verify the compliance Demands on the Technical State of the Product The following special requirements are made to ensure safe operation: Take all information on environmental conditions into consideration before setup and operation (see the documentation of your computer, hardware, etc.). Further safety advice is given in the "ASCET Safety Advice" window that opens when you start the program, and in the ASCET Safety Advice.pdf file on the installation disk. 1.2 Definitions and Abbreviations IDE Integrated Development Environment ESDL Embedded Software Description Language MISRA Motor Industry Software Reliability Association Host PC The PC where you are running ASCET-DEVELOPER 7.3 Target Hardware The hardware for which you compile ASCET-DEVELOPER 7.3 generated C code. 1.3 Conventions The following typographical conventions are used in this document: OCI_CANTxMessage msg0 = Code snippets are presented on a gray background and in the Courier font. Meaning and usage of each command are explained by means of comments. The comments are enclosed by the usual syntax for comments. Select File Open. Click OK. Press <ENTER>. The "Open File" dialog box is displayed. Select the file setup.exe Menu commands are shown in blue boldface. Buttons are shown in blue boldface. Keyboard commands are shown in angled brackets and SMALL CAPS. Names of program windows, dialog windows, 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. ASCET-DEVELOPER 7.3 Getting Started Guide 6

7 Introduction A distribution is always a onedimensional table of sample points. The OSEK group (see has developed certain standards. General emphasis and new terms are set in italics. Links to internet documents are set in blue underlined font. Important notes for the user are presented as follows: Tip Important note for the users About You You are a trained embedded software engineer. You have knowledge of the C programming language, including the compilation, assembly and linking of C code for embedded applications with your chosen tool chain. You should also be familiar with common use of the Microsoft Windows operating system, including installing software, selecting menu items, clicking buttons, navigating files and folders. You should read this guide before you install ASCET-DEVELOPER 7.3 and before you read any other manuals. ASCET-DEVELOPER 7.3 Getting Started Guide 7

8 Installation 2 Installation ASCET-DEVELOPER provides an innovative solution for the functional and software development of modern embedded software systems. ASCET-DEVELOPER 7.3 supports every step of the development process with a new approach to modeling, code generation and simulation, thus making higher quality, shorter innovation cycles and cost reductions a reality. This manual supports the reader in getting to know ASCET-DEVELOPER 7.3, and quickly achieving results. It provides a step-by-step introduction to the system, while at the same time making all information easily accessible for reference. 2.1 Preparation ASCET-DEVELOPER is provided as a downloadable electronic installation image. You will have been provided with access to the download when the product was purchased. You may optionally have requested an installation disk which will have been shipped to you. The downloadable image and installation disk contain identical content Delivery Scope The delivery scope of ASCET-DEVELOPER 7.3 includes: ASCET-DEVELOPER 7.3 program files ETAS Experiment Environment Virtual RTA-OSEK operating system ASCET-DEVELOPER Getting Started manual in PDF format (Adobe Reader required) ASCET Safety Advice in PDF format (Adobe Reader required) Manual "Licensing End User Guide" in PDF format Information on open-source components used in ASCET-DEVELOPER 7.3 ASCET-DEVELOPER requires a license key to use all product features. You can obtain the license files required for licensing either from your system administrator or through a selfservice portal on the ETAS Internet Site; the URL is given in the entitlement letter. To request the license file you have to enter the activation number which you received from ETAS during the ordering process System Prerequisites The following minimum system prerequisites must be met: Required Hardware Required Operating System Required Free Disk Space Required Software 2 GHz Dual Core PC (64-bit) 8 GB RAM DVD-ROM drive Network adapter Graphics with a resolution of 1024 x 768, 32 MB RAM, 32-bit color, DirectX 7 Windows 7 (x86_64) 2 GB (not including the size for application data) Microsoft.NET Framework (or later) Microsoft Visual C++ Redistributable 2010 Microsoft Visual C++ Redistributable 2015 ASCET-DEVELOPER 7.3 Getting Started Guide 8

9 Installation The following system prerequisites are recommended: Recommended Hardware Recommended Operating System Recommended Free Disk Space Required Software 2,0 GHz Dual-Core PC (64-bit) or equivalent 16 GB RAM DVD-ROM drive Network adapter Graphics with a resolution of 1650 x 1080, 128 MB RAM, 32-bit color, DirectX 7 or higher, hardware acceleration Windows 7 (x86_64) 2 GB (not including the size for application data).net Framework (or later) Microsoft Visual C++ Redistributable 2010 Microsoft Visual C++ Redistributable Installing ASCET-DEVELOPER 7.3 The ASCET-DEVELOPER installer installs: The ASCET-DEVELOPER product The ETAS License Manager All 3 rd party libraries required to run ASCET-DEVELOPER 7.3 or the ETAS License Manager Installation via Dialog Windows This section describes the installation via dialog windows. Command-line installation is described in section 2.2.2, Command-Line Installation, on page 14. To start the ASCET-DEVELOPER installation: Insert the data carrier in the respective drive of your computer. An installation dialog opens. Follow the Installation link, then follow the Install ASCET- DEVELOPER link. The ASCET-DEVELOPER 7.3 Setup Wizard is launched. ASCET-DEVELOPER 7.3 Getting Started Guide 9

10 Installation Figure 1: ASCET-DEVELOPER 7.3 Setup Wizard Click on Next to continue. The "License Agreement" window opens. Read the license agreement carefully, then activate I accept the agreement. If you do not accept the license agreement, you cannot continue the installation. Click Next to continue. The Choose Install Location window opens. Tip As an alternative, you can select the disk drive in the Windows Explorer and run the setup.exe file. ASCET-DEVELOPER 7.3 Getting Started Guide 10

11 Installation To choose the installation path: In the "Choose Install Location" window, you are prompted to enter a destination directory for the installation (referred to as <installation>). In addition, the window lists the required and available disk space. Figure 2: ASCET-DEVELOPER 7.3 Setup Choose Install Location The default location for an ASCET-DEVELOPER 7.3 installation is: C:\ETAS\ASCET-DEVELOPER7.3 To change a preset directory, enter or select (via the Browse button) the new path. If you entered an invalid path, the Next button is deactivated. You have to correct the path before you can continue. If you used the Browse button, proceed as follows. In the "Browse for Folder" window, select an existing directory. Or ASCET-DEVELOPER 7.3 Getting Started Guide 11

12 Installation 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 to continue. If the installation directory already exists, you are asked if you want to uninstall first. Click Yes to uninstall (see also section 2.5 on page 16) or remove the existing content of the installation directory and then install ASCET-DEVELOPER 7.3. Click No to return to the "Choose Install Location" window and specify another installation directory. Tip To choose a folder in the Start menu: When you are installing ASCET-DEVELOPER 7.3, make sure that you select an installation directory that offers write access during ASCET-DEVELOPER 7.3 operation; ASCET- DEVELOPER 7.3 writes to files in the installation directory. It is recommended that you do not use the Program Files directory as installation directory. In the "Choose Start Menu Folder" window, you are prompted to enter or select a Start menu folder for ASCET-DEVELOPER 7.3. Figure 3: ASCET-DEVELOPER 7.3 Setup Choose Start Menu Folder Do one of the following: Accept the default folder name. ASCET-DEVELOPER 7.3 Getting Started Guide 12

13 Installation Enter or select another folder. Click Next to continue. The Installing window opens and the installation will be started together with the necessary prerequisites. Tip You cannot cancel the installation once it is running; the Cancel button is deactivated. To complete the installation: Once all components have been installed successfully, the Installation Complete window opens. Click Next to continue. You are prompted to complete the installation. Figure 4: Completing the ASCET-DEVELOPER 7.3 Setup Wizard Activate/deactivate the options according to your wishes. Click on Finish to complete the installation. The ASCET-DEVELOPER 7.3 Setup Wizard will be closed. In the Windows Start menu, the selected folder (see page 12) with the following entries is created in the ETAS program group: ASCET-DEVELOPER 7.3 Getting Started Opens the ASCET-DEVELOPER 7.3 Getting Started manual. ASCET-DEVELOPER 7.3 Release Notes Opens the ASCET-DEVELOPER 7.3 release notes. ASCET-DEVELOPER 7.3 The ASCET-DEVELOPER 7.3 program is started. ASCET-DEVELOPER 7.3 Getting Started Guide 13

14 Installation The ETAS License Manager has another separate folder License Management in the ETAS program group of the Start menu. The following icon is placed on the desktop of your computer Command-Line Installation This section describes the command-line installation. Installation via dialog windows is described in section 2.2.1, Installation via Dialog Windows, on page 9. When you start the ASCET-DEVELOPER installation from a command line, you can use several command-line parameters to customize the installation. Tip The command-line options are case-sensitive. For example, /S will cause a silent installation, but /s will not. Each execution of setup.exe writes a log file %appdata% 1 \ETAS\SETUP\<date_time> Setup.log. /? or /h Opens a window with the valid command line arguments. /S or /silent /NCRC /D Silent installation mode. With this installation mode, no dialog windows requiring user information open. Default values are used for all information normally requested in installation windows. Error messages are hidden, too. Tip /silent must be the first command line argument. If other arguments precede it, /silent has no effect. Skips CRC check of the installer (ignored if CRCCheck force is set in the installer) Sets the installation directory ($INSTDIR). /D must be the last parameter in the command line. /D must not contain any quotes. Syntax: Examples: without spaces with spaces setup.exe /S /D=C:\ETAS\ASCET-DEVELOPER7.3 /D=C:\Program Files\ASCET-DEVELOPER Triggers a silent installation with default installation path and CRC check. setup.exe /NCRC /D=C:\Tools\ASCET-DEVELOPER7.3 Triggers a non-silent installation without CRC check and with user-defined installation directory. 1 %appdata% = C:\Users\<username>\AppData\Roaming (Windows 7) ASCET-DEVELOPER 7.3 Getting Started Guide 14

15 Installation What is Installed? After installing completes, a number of new files and folders will be created in the installation directory. The following table describes the most important elements: File/Folder ASCET.exe ASCET.ini amd2esdl.bat ascet-cli.bat configuration documents features jre Description The ASCET-DEVELOPER 7.3 IDE executable Startup configuration options for ASCET-DEVELOPER 7.3 AUTOSAR AMD to ESDL translation tool The ASCET-DEVELOPER 7.3command line code generator driver Configuration files User documentation in PDF form Standard Eclipse Folder: Contains definitions of which plugins contribute to which feature Standard Eclipse Folder: Java SE Runtime Environment LicenseConfigurationInfo License features to which the ETAS License Manager needs to grant access. p2 plugins Standard Eclipse Folder: Plugin dependency management Standard Eclipse Folder: IDE plugins The ASCET-DEVELOPER 7.3 installation includes the Eclipse C/C++ Development tools (see so that you can work easily with generated C code. 2.3 Post Installation Setup It is recommended that you install the MinGW 2 PC hosted C compiler so that you can compile the code natively for the PC using the Eclipse CDT (e.g. so that you can test programs running on the host PC). ASCET-DEVELOPER 7.3 includes an installation of GCC in the <installation>\plugins\org.mingw.gcc.x86_win32_<a>.<b>.<c>.<d> 3 folder. To use this version with the Eclipse CDT version, add <installation>\plugins\ org.mingw.gcc.x86_win32_<a>.<b>.<c>.<d>\bin to the Windows path. 2.4 Changing the Installation Location after Installation The ASCET-DEVELOPER installation is self-contained. To change the installation location after installing, simply copy the entire ASCET-DEVELOPER folder to the required location. 2 See for more information. 3 <a>, <b>, <c> and <d> are parts of the compiler s version number ASCET-DEVELOPER 7.3 Getting Started Guide 15

16 Installation 2.5 Uninstalling ASCET-DEVELOPER 7.3 Use one of the following ways to start the uninstall process: The Programs and Features icon in the Windows Control Panel. The uninstall.exe file in the ASCET-DEVELOPER 7.3 installation directory. To uninstall ASCET-DEVELOPER 7.3 via dialog windows: Start the uninstall procedure. The uninstaller is launched. Tip The next step will start the uninstallation. You cannot cancel uninstallation once it is running; the Cancel button is deactivated. Click Next to uninstall ASCET-DEVELOPER 7.3. The uninstaller checks if your computer allows uninstallation of ASCET-DEVELOPER 7.3. If not, the Verifying conditions window opens. It lists the issues that disallow uninstallation. ASCET-DEVELOPER 7.3 Getting Started Guide 16

17 Installation Solve the issues listed in the Verifying conditions window. When all issues are solved, uninstallation starts. If yes, uninstallation starts immediately. 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. You can also use the uninstall.exe file in the ASCET-DEVELOPER 7.3 installation directory to uninstall ASCET-DEVELOPER 7.3 via command line. The command-line parameter /S (see also page 14) is also available for silent uninstallation. 2.6 Installation Experiment Environment Initial Installation You must install the ETAS Experiment Environment to create experiment projects. You cannot choose the installation path of the experiment environment. The experiment environment is installed in the Program Files (32 bit OS) or Program Files (x86) (64 bit OS) folder, Common Files\ETAS\Experiment Environment\<a>.<b> 4 subfolder, on your system drive. To start the experiment environment installation: Insert the data carrier in the respective drive on your computer. An installation dialog opens. Follow the Installation link, then follow the Install Experiment Environment V<a>.<b> 4 link. The ETAS Installer is launched. 4 <a>.<b> is the 2-digit version number of the ETAS Experiment Environment. ASCET-DEVELOPER 7.3 Getting Started Guide 17

18 Installation Click Next to continue. The installer checks if your computer meets the system requirements for installation of the experiment environment. The result is displayed in the "System Check" window. If your system meets the installation requirements, the installer proceeds automatically to the next window. ASCET-DEVELOPER 7.3 Getting Started Guide 18

19 Installation License Agreement: The next window shows the license agreement. To associate with INCA: Read the license agreement, then activate the I read and accept the terms in the license agreement option. If you do not accept the license agreement, you cannot continue the installation. Click Next to continue. The "Associate to INCA" window offers all INCA versions on your PC that can access the same target server as the experiment environment, as well as the selection Default (No INCA connection). ASCET-DEVELOPER 7.3 Getting Started Guide 19

20 Installation Select the INCA version you want to associate with the ETAS experiment environment. Do one of the following: Click Next to continue. To install the experiment environment: Click Proceed to Install to go to the "Ready to Install" window. The "Ready to install" window lists the components selected for installation. Tip The next step will start the installation. You cannot cancel installation once it is running; the Cancel button is deactivated. To complete the installation: In the "Ready to Install" window, click Install. The selected components (cf. page 20) are installed. A progress indicator shows how the installation is progressing. Once all components have been installed successfully, you are prompted to end the installation. Click on Finish to end the installation. A folder Experiment Environment <a>.<b> 5 is created in the ETAS program group of the Windows Start menu. This folder contains the following items: Experiment Environment V<a>.<b> 5 - Tools Opens a folder with the following shortcuts in the Windows Explorer: 5 <a>.<b> is the 2-digit version number of the ETAS Experiment Environment. ASCET-DEVELOPER 7.3 Getting Started Guide 20

21 Installation Associate to INCA Determines the INCA version that can be used with the experiment environment, and the version of the shared modules. Associate to RTA-TRACE Checks the installation of RTA-TRACE. If the check fails, hints for troubleshooting are given. Experiment Environment V<a>.<b> 5 Opens the experiment environment. INCA 7.2 Target Server Tools Opens a folder with the following shortcuts in the Windows Explorer: ETAS Network settings Starts the assistant for the configuration of the ETAS network. Search for connected hardware The Target server is started. A search for connected hardware is conducted. TargetServer<i> V<j>.<k> 6 - Tools Opens a folder with the following shortcuts in the Windows Explorer: ETAS Network settings Starts the assistant for the configuration of the ETAS network. Search for connected hardware The Target server is started. A search for connected hardware is conducted. Manuals and Tutorials Opens the ETAS Manuals folder in the Windows Explorer. The ETAS Manuals folder contains a shortcut Experiment Environment V<a>.<b>, which opens the Docs folder with the following online help files: EE.chm The Experiment Environment online help. InstrumentProgramming.chm A help file which offers assistance for programming and integrating user-defined instruments to the ETAS experiment environment. ScriptingAPI_EE.chm A help file that describes the scripting API of the experiment environment. The following icon is stored on the desktop of your workstation: The SMF editor has a separate folder in the ETAS program group of the Start menu; this folder contains the following items: SuT Mapping File Editor Opens the SMF editor. SMFE Online Help Opens the online help for the SMF editor. 6 <i>, <j> and <k> are parts of the target server s version number. ASCET-DEVELOPER 7.3 Getting Started Guide 21

22 Installation Setting the Licensing Behavior You can define the way in which the experiment environment (and other ETAS software programs) accesses the required licenses in the [Licensing] section of an *.ini file. The install\experimentenvironment_v<a>.<b>.<c> 7 \Packages\EE License* folder on your installation disk contains such an *.ini file, i.e. Licensing.ini. You can copy this file to a local directory and adapt it according to your needs. 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. 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., EE). If you enter more than one license, the license names must be separated by blanks. The experiment environment uses the following licenses: License name EE INT_VP_EE Functionality experiment environment Virtual Prototyping Package for the experiment environment 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 BorrowExpiryDate. 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. 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). 7 <a>.<b>.<c> is the 3-digit version number of the ETAS Experiment Environment. ASCET-DEVELOPER 7.3 Getting Started Guide 22

23 Installation 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. 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:\ProgramData\ETAS\FlexNet for Windows 7) 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 the experiment environment. The license will be borrowed when the experiment environment is started for the first time; by default the licenses expire after 100 days. [Licensing] LicenseFileName = d:\licenses\mylicense.lic LicensesToBorrow = 'EE LicensesToBorrow = 'INT_VP_EE BorrowExpiryMode = Interval BorrowExpiryInterval = 100 ImmediateBorrow = false Experiment Environment Command-Line Installation If you start the installation of the experiment environment 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% 8 \ETAS\SETUP\<date_time> Setup.log. The following command-line options exist: /silent Silent installation mode. With this installation mode, no dialog windows requiring user information open. 8 %appdata% = C:\Users\<username>\AppData\Roaming (Windows 7) ASCET-DEVELOPER 7.3 Getting Started Guide 23

24 Installation Tip To accept EULA (cf. page 19) during silent installation, you must use the command-line parameter /EULAAccepted. To deal with a possible request for a computer restart, you must use either the /NoRestart or the /AllowRestart command-line parameter. To automatically uninstall an existing older version of the experiment environment, you must use the /UninstallPreviousVersion command-line parameter. Default values are used for all information normally requested in installation dialog 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 experimentenvironment\eula 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. /UninstallPreviousVersion Uninstalls an existing older version of the experiment environment installed on your computer. Tip /Debug If you do not use this command-line parameter, setup.exe will abort with an error if a previous version of the experiment environment is found. /UninstallPreviousVersion is not used in combination with /Uninstall. Writes additional log files for *.msi packages. These files are stored in the %appdata% 8 \ETAS\SETUP folder. /DefaultSettings Allows to specify an own XML file with default settings (instead of using InstallationDefaultSettings.xml). 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 the experiment environment. Can be combined with /silent for uninstallation without user interaction. Use the setup.exe file provided in the C:\<programs> 9 \ETAS\ GENericSetup\EE EE Standalone\<a>.<b>.<c>.<d> 10 folder. 9 <programs> = Program Files (x86) (64 bit OS) or Program Files (32 bit OS) 10 <a>.<b>.<c>.<d> is the 4-digit version number of the ETAS Experiment Environment. ASCET-DEVELOPER 7.3 Getting Started Guide 24

25 Installation Examples: Setup.exe /silent /EULAAccepted Triggers a silent installation. "C:\Program Files\ETAS\GENericSetup\EE EE Standalone\ <a>.<b>.<c>.<d>\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.7 Installation VRTA OSEK Runtime for PC To start the VRTA OSEK Runtime for PC installation: Insert the data carrier in the respective drive on your computer. An installation dialog opens. Follow the Installation link, then follow the Install VRTA OSEK Runtime link. The VRTA OSEK Runtime Setup Wizard is launched. After installation you will be asked if you want to reboot. You must reboot before an experiment can be run. ASCET-DEVELOPER 7.3 Getting Started Guide 25

26 Installation ASCET-DEVELOPER 7.3 Getting Started Guide 26

27 Licensing the Software 3 Licensing the Software A valid license is required for using ASCET-DEVELOPER 7.3. You can obtain the license file required for licensing either from your tool coordinator or through a self-service portal on the ETAS Internet Site under To request the license file you have to enter the activation number which you received from ETAS during the ordering process. In the Windows Start menu, select Programs ETAS License Management ETAS License Manager. Follow the instructions given in the dialog. For further information about, for example, the ETAS license models and borrowing a license, press F1 in the ETAS License Manager. ASCET-DEVELOPER 7.3 Getting Started Guide 27

28 Developing Software with ASCET-DEVELOPER Developing Software with ASCET-DEVELOPER 7.3 ASCET-DEVELOPER is an Eclipse-based product if you are familiar with using the Eclipse environment then you should feel at home. If ASCET-DEVELOPER 7.3 is the first Eclipsebased application you have used, then section 4.1 provides some basic information to get you started. 4.1 Starting ASCET-DEVELOPER 7.3 for the First Time To start ASCET-DEVELOPER 7.3, run the program from the Start Menu, the desktop shortcut or by navigating to the installation directory and double-clicking on ASCET7.exe. When you start ASCET-DEVELOPER 7.3 for the first time, you are asked for a workspace location. A workspace is the root Windows folder where all your programs & generated code will be saved. Figure 5: "Workspace Launcher" window You can do the following: enter or select (via the Browse button) an existing folder enter or select a new folder activate Use this as the default to make the folder the default workspace and avoid further inquiries You can undo the activation in the "Preferences" window, "General\Startup and Shutdown\Workspaces" node. You can change the workspace later from within ASCET-DEVELOPER 7.3. Continue (OK) or cancel the procedure. Next, the "ASCET-DEVELOPER Safety Advice" window opens. It contains safety information in several languages. ASCET-DEVELOPER 7.3 Getting Started Guide 28

29 Developing Software with ASCET-DEVELOPER 7.3 Figure 6: ASCET-DEVELOPER Safety Advice Tip Read the Safety Advice carefully before you click Acknowledged to close the ASCET Safety Advice. You can open the Safety Advice in the ASCET window via Help Safety Advice. A PDF version, ASCET Safety Advice.pdf, is available in the ASCET-DEVELOPER 7.3 installation directory, documents subfolder. ASCET-DEVELOPER 7.3 Getting Started Guide 29

30 Developing Software with ASCET-DEVELOPER 7.3 The first time you run ASCET-DEVELOPER 7.3, you will be shown the "Welcome" page. Figure 7: ASCET-DEVELOPER 7.3 Welcome page The sections on this page provide links to entries in the help system. To enter the workbench, click the Workbench link in the upper right corner. Figure 8: ASCET-DEVELOPER 7.3 Workspace You can return to the "Welcome" page at any time using the menu item Help Welcome. ASCET-DEVELOPER 7.3 Getting Started Guide 30

31 Developing Software with ASCET-DEVELOPER Installing the Examples The best place to start is with the example applications. ASCET-DEVELOPER 7.3 ships with a number of examples that are extensively commented to show you the important features of the language. To install an example: Select the File New Example menu option. The "New Example" window opens. Figure 9: "New Example" window Select an example (e.g., start with "Block Diagrams") from the list. Click Next. The second page of the "New Example" window opens. It lists the example projects that will be created. Click Finish. The example you selected will be installed in the workspace, and you are ready to go. Each example project is installed into its own Eclipse project (the root folder) and the source code in a subfolder. All ASCET block diagram files have a.bd extension, all ESDL source files have an.esdl extension. The ASCET-DEVELOPER 7.3 editor provides context-sensitive editing features that you expect to find in Eclipse. If you do not know what to type, try pressing <CTRL>+<SPACE> to get suggestions. If you have typed something that is wrong, but cannot work out how to fix it, try pressing <CTRL>+<1> and we might have added a quick fix to help you. ASCET-DEVELOPER 7.3 Getting Started Guide 31

32 Developing Software with ASCET-DEVELOPER How to Start My Own Project To create your own project: If you are not working in the ASCET perspective, do the following: Select File New Project from the menu. The "New Project" window opens. Figure 10: "New Project" window Select ASCET ASCET Project. Click Next >. The "New ASCET Project" window (cf. Figure 11) opens. ASCET-DEVELOPER 7.3 Getting Started Guide 32

33 Developing Software with ASCET-DEVELOPER 7.3 Figure 11: "New ASCET Project" window If you are working in the ASCET perspective, do the following: Choose File New ASCET Project from the menu. The "New ASCET Project" window (cf. Figure 11) opens. In both cases, continue as follows: Enter a project name, for example myascetproject. By default, one ESDL package and one block diagram component will be created with the new project. If desired, change the package name and/or the component name. Click Finish. If necessary, agree to open the associated ASCET perspective by clicking Yes. Your new project is ready to go. 4.4 How to Create Models To create models, you need to create an ESDL Package and then an ASCET component. To create an ESDL package: Right-click on the project in the Project Explorer and select New ESDL Package from the context menu. The "New ESDL Package" window opens. In the New ESDL Package window, select the parent folder and enter the file name, for example myascetpackage. ASCET-DEVELOPER 7.3 Getting Started Guide 33

34 Developing Software with ASCET-DEVELOPER 7.3 Click Finish. To create an ASCET component: The ESDL Package will be created in the selected parent folder. Right-click on your new package and select New ASCET Block Diagram from the context menu. The "ASCET" window opens. In the "ASCET" window, select the parent folder and enter the file name, for example myascetclass from the context menu. Click Finish. The ASCET component will be created in the selected parent folder. You now have a basic ASCET graphical project and can start modelling. 4.5 How to Run an Experiment All good scientists know that you need to prepare the apparatus to do an experiment. ASCET-DEVELOPER 7.3 experiments are no different. Your "apparatus" is an experiment environment (EE), and "preparation" is making sure you have installed one. We recommend that you install the ETAS Experiment Environment. To experiment with a class, you have to create a static class for test purposes and an ASCET application. You start the experiment from the ASCET application; see To run an experiment with a class on page 34. For experiments with static classes, you do not need a test class; see To run an experiment with a static class: on page 37. To run an experiment with a class: In the Project Explorer, right-click on a class and select New ESDL Test Class from the context menu. The first page of the "New ESDL Test Class" window opens. It shows the class and input file you want to experiment with. ASCET-DEVELOPER 7.3 Getting Started Guide 34

35 Developing Software with ASCET-DEVELOPER 7.3 Click on Next to continue. The second page of the "New ESDL Class window" opens. The test class name <class>test and the creation of an ASCET Application file are preselected. If desired, change the name or target folder of the test class. Click on Finish to continue. A test class, by default named <class>test.esdl, and an ASCET application, by default named <class>test.app, are created. ASCET-DEVELOPER 7.3 Getting Started Guide 35

36 Developing Software with ASCET-DEVELOPER 7.3 Right-click on <class>test.app and select Run As ASCET PC Experiment from the context menu. If this is the first time you use this command on <class>test.app, the "Edit Configuration" window opens. Figure 12: "Edit Configuration" window, "Main" tab ASCET-DEVELOPER 7.3 Getting Started Guide 36

37 Developing Software with ASCET-DEVELOPER 7.3 You can use this window to set up the run configuration. For the purpose of this task, however, you will use the default settings. Click on Run to continue. Code is generated, linked and built. The ETAS Experiment Environment is started. An experiment workspace (<class>test.eew), an experiment system (<class>test.eex) and other necessary files are created and stored in your project, in the experiments folder. To run an experiment with a static class: You can now configure and perform the experiment. See the online help of the ETAS Experiment Environment for further information. In the Project Explorer, right-click on a static class and select New ASCET Application from the context menu. ASCET-DEVELOPER 7.3 Getting Started Guide 37

38 Developing Software with ASCET-DEVELOPER 7.3 The New ASCET Application window opens. If desired, enter or select a parent folder and a file name. Click on Finish to continue. An ASCET application, by default named <static_class>.app, is created. ASCET-DEVELOPER 7.3 Getting Started Guide 38

39 Developing Software with ASCET-DEVELOPER 7.3 Right-click on <static_class>.app and select Run As ASCET PC Experiment from the context menu. If this is the first time you use this command on <static_class>.app, the "Edit Configuration" window (see Figure 12 on page 36) opens. You can use this window to set up the run configuration. For the purpose of this task, however, you will use the default settings. Click on Run to continue. Code is generated, linked and built. The ETAS Experiment Environment is started. An experiment workspace (<static_class>.eew), an experiment system (<static_class>.eex) and other necessary files are created and stored in your project, in the experiments folder. You can now configure and perform the experiment. See the online help of the ETAS Experiment Environment for further information Where is the Code Generated? The *.a2l file, the executables and the C code are generated in a new Eclipse C/C++ project. By default, this project is called <your project name>_cgen. ASCET-DEVELOPER 7.3 Getting Started Guide 39

40 Developing Software with ASCET-DEVELOPER 7.3 You can open the generated files in the C/C++ Editor. The generated project has this content: File/Folder /Includes /include /src Content access to C standard include files standard ESDL support files the generated C source code for the ESDL project /l1 generated C source code to support communication with the ETAS experiment environment /lib /obj /platform _compiler.opt _linker.opt <name>.a2l.cod <name>.address interpolation functions library for 1- and 2-dimensional characteristic tables location for object files generated by compiling the C source files runtime platform C code and configuration for the experiment options for the C compiler options for the linker COD file for the experiment address information for measurements and characteristics in the executable ASCET-DEVELOPER 7.3 Getting Started Guide 40

41 Developing Software with ASCET-DEVELOPER 7.3 File/Folder <name>.exe <name>l1.a2l Makefile Content the executable program an ASAM-MCD-2MC (A2L) file to enable interaction between the executable and the experiment environment A makefile that can be used to compile and link the generated C code from the command line. 4.6 Compiling and Linking in the Eclipse CDT If you have installed a PC hosted C compiler, you can use the Eclipse C/C++ Development Tools (CDT) to run the build: Right-click on the C project and select Build Project from the context menu. The behavior of Build Project depends on the properties of the generated code as follows: ESDL includes "main" Yes No Build Behavior Compile & Link. An executable is generated. Compile only. No Link. Object files are generated. ASCET-DEVELOPER 7.3 Getting Started Guide 41

42 Developing Software with ASCET-DEVELOPER Generating Code from the Command Line ASCET-DEVELOPER can be run from the command line on an existing project. This allows you to easily integrate code generation with your existing build process. The command line syntax is as follows: ascet-cli.bat -w <path to ASCET workspace> -p <Project in workspace> [options] To get a complete list of options, run: ascet-cli.bat help It is recommended that the ASCET-DEVELOPER 7.3 install directory is added to the Windows path so that ASCET-DEVELOPER 7.3 can be run from anywhere. ASCET-DEVELOPER 7.3 Getting Started Guide 42

43 Finding Out More 5 Finding Out More ASCET-DEVELOPER ships with extensive online help. To view the help, select Help Help Contents from the menu. ETAS ASCET-DEVELOPER User Guide: This describes how to develop software in ASCET-DEVELOPER. ETAS ESDL User Guide: This describes how to develop software ESDL and provides the ESDL Language Reference. In addition, ASCET-DEVELOPER includes the standard documentation for the Eclipse platform & plugins shipped as part of ASCET-DEVELOPER: Workbench User Guide: This explains how to use the standard Eclipse workbench. C/C++ Development User Guide: This explains how to use the Eclipse C/C++ development tooling. There is extensive documentation on the internet about using Eclipse, and a good starting point is ASCET-DEVELOPER 7.3 Getting Started Guide 43

44 ETAS Contact Addresses 6 ETAS Contact Addresses ETAS HQ ETAS GmbH Borsigstraße 14 Phone: Stuttgart Fax: Germany WWW: ETAS Subsidiaries and Technical Support For details of your local sales office as well as your local technical support team and product hotlines, take a look at the ETAS website: ETAS subsidiaries WWW: ETAS technical support WWW: ASCET-DEVELOPER 7.3 Getting Started Guide 44

45 Index Index A Abbreviations 6 ASCET-DEVELOPER delivery scope 8 licensing 27 ASCET-DEVELOPER 7.3 build model 33 choose path 11 choose Start menu folder 12 first start 28 installation 9 post-installation setup 15 run an experiment 34 select workspace 28 silent installation 14 ASCET-DEVELOPER 7.3 uninstall 16 B Build model 33 ASCET Component - graphical 34 C code compile 41 generate via command line 42 link 41 command line generate code 42 install ASCET-DEVELOPER install experiment environment 23 uninstall 17 compiling 41 create own project 32 D Definitions 6 delivery scope 8 develop software compile/link 41 generate code via command line 42 install examples 31 start ASCET-DEVELOPER Documentation C/C++ Development User Guide 43 ETAS ESDL User Guide 43 Online Help 43 Workbench User Guide 43 E ESDL package 33 ETAS contact 44 examples 31 experiment environment install 17 install via command line 23 silent installation 23 F Finding Out More Documentation 43 G generate code via command line 42 I installation 8 15 ASCET-DEVELOPER choose path 11 choose Start menu folder 12 command line 14 content 15 experiment environment 17 silent 14, 23 start 9 system prerequisites 8 uninstall ASCET-DEVELOPER VRTA OSEK Runtime for PC 25 Installation license agreement 10 installation path change 15 select 11 ASCET-DEVELOPER 7.3 Getting Started Guide 45

46 Index L licensing 27 configure installation 22 set behavior 22 linking 41 P Product liability disclaimer 5 Project create 32 R Run an ASCET-DEVELOPER 7.3 experiment 34 S silent installation ASCET-DEVELOPER experiment environment 23 system prerequisites 8 U uninstallation 16 V VRTA OSEK Runtime for PC install 25 W workspace 28 safety advice 5 technical state 6 ASCET-DEVELOPER 7.3 Getting Started Guide 46