dSPACE Release 6.4 June 2009 TargetLink 3.0.1 Last-Minute Information ================================================================= Copyright (c) 2009 dSPACE GmbH, Germany Contents: 1. Welcome 2. Notes for Floating Network License Users 3. Compatibility with Non-dSPACE Software 4. Compatibility with dSPACE Software 5. dSPACE Installation Manager 6. Licenses 7. Available Setup Version 8. New Features of TargetLink 3.0.1 9. TargetLink Known Problem Reports List 10. Any Questions? ================================================================= 1. Welcome ----------------------------------------------------------------- Welcome to our new release, TargetLink 3.0.1. TargetLink 3.0.1 is a maintenance release for TargetLink Release 3.0 and also part of dSPACE Release 6.4. It aims to provide compatibility with MATLAB Release R2009a and R2008b, AUTOSAR 3.0, and introduces some new TargetLink features as well as selected bug fixes. Before you start the installation, please read this ReadMe file. We constantly strive to improve our products, so your input is crucial. We welcome any feedback you might have concerning this Release, the documentation, or dSPACE products in general. Just send an e-mail to feedback@dspace.de 2. Notes for Floating Network License Users ----------------------------------------------------------------- Floating Network License users have to update their existing Floating Network License Server at least to version 2.1. The most recent version can be obtained free of charge from http://www.dspace.com/goto?FNLServer The setup for License Server version 2.1 is located in the folder \LicServer on this DVD. NOTE: A Windows 2000, Windows XP or Windows Vista platform is required for the dSPACE Floating Network License Server. 3. Compatibility with Non-dSPACE Software ----------------------------------------------------------------- Before installing dSPACE software, check the following prerequisites for compatibility with non-dSPACE software. Prerequisites for TargetLink 3.0.1: - Supported Microsoft Operating Systems - Microsoft Windows 2000 Professional (with Service Pack 4) - Microsoft Windows XP Professional (32-bit version with Service Pack 2 or 3). Service Pack 3 is recommended. - Microsoft Windows Vista (32-bit version and 64-bit version with the latest Service Pack). Only the versions Windows Vista Business, Ultimate, and Enterprise are supported. The versions Windows Vista Home and Starter are not supported. The 64-bit operating systems are supported by 32-bit software running in WoW (Windows-On-Windows64). 64-bit MATLAB versions are not supported. - Supported MathWorks Releases - TMW Release R2009a - TMW Release R2008b - TMW Release R2008a+ - TMW Release R2007b+ - TMW Release R2007a+ - TMW Release R2006b - TMW Release R2006a+ - Supported MATLAB MEX Compiler for Host Simulation - Microsoft Visual C/C++ Ver. 6.0, 7.1, or Ver. 8.0 - LCC Compiler as shipped with the supported MATLAB versions Latest updates of compatibility information on this DVD and previous releases can be obtained from http://www.dspace.com/goto?compatibility 4. Compatibility with dSPACE Software ----------------------------------------------------------------- TargetLink 3.0.1 can be installed and used in combination with the following dSPACE releases: - dSPACE Release 6.4 - dSPACE Release 6.3 - dSPACE Release 6.2 - dSPACE Release 6.1 - dSPACE Release 6.0 - dSPACE Release 5.4 - dSPACE Release 5.3 For detailed information on how to use CalDesk, Model Compare and RCP and HIL software with TargetLink 3.0.1, refer to "Installing RCP and HIL, TargetLink, CalDesk, and Model Compare Software" in the "dSPACE Release Quick Software Installation Guide". 5. dSPACE Installation Manager ----------------------------------------------------------------- If you want to use software from this release and older releases at the same time and on the same PC, you have to switch between installations in different subfolders with the dSPACE Installation Manager (see below for details). The dSPACE Installation Manager is supplied with the dSPACE software package and installed on your PC during installation. To start the dSPACE Installation Manager, choose Programs -> dSPACE Installation Manager from the Start menu, and click dSPACE Installation Manager. For further information on how to use the tool, refer to \Tools\InstallManager\InstallManager.pdf on this DVD. 6. Licenses ----------------------------------------------------------------- To use TargetLink 3.0.1 together with MATLAB R2008b or R2009a, a separate license is required. This license is checked when R2008b or R2009a is detected and also enables you to work with former MATLAB releases. Apart from that, the same license protection systems are used as for TargetLink 3.0. |MATLAB < R2008b |MATLAB R2008b |MATLAB R2009a __________________|________________|______________|______________ MLCU License | OK | OK | OK available | | | | | | No MLCU License | OK | fault | fault available | | | To use the AUTOSAR 3.0 support in TargetLink 3.0.1, a separate AUTOSAR license (TL_AUTOSAR30) is required. The license is required upon AUTOSAR 3.0 Import/Export. 7. Available Setup Version ----------------------------------------------------------------- With TargetLink 3.0.1, only an update setup is available (via DVD and Internet download). The update setup requires an existing TargetLink 3.0 installation, on top of which TargetLink 3.0.1 is installed. 8. New Features of TargetLink 3.0.1 ----------------------------------------------------------------- - New Features of the TargetLink AUTOSAR Module TargetLink 3.0.1 comes with the following new features of the TargetLink AUTOSAR Module: * TargetLink Support for AUTOSAR Release 3.0.2 The TargetLink AUTOSAR Blockset supports AUTOSAR Release 3.0.2, AUTOSAR Release 2.1.4 and 2.0 SP3. For these standards, an AUTOSAR-compliant XML file can be imported, code for the software component can be generated, a simulation can be carried out, and an AUTOSAR-compliant XML file can be exported. TargetLink lets you select between AUTOSAR Release 3.0.2, 2.1.4 and 2.0 SP3 during export and import. By default, AUTOSAR Release 2.1.4 is assumed. Note: TargetLink does not support all the features specified in AUTOSAR Release 3.0.2. * Using the Stand-Alone Model Manager for AUTOSAR Models The Stand-Alone Model Manager, which can be used to wrap TargetLink code in an S-Function, now also supports models with TargetLink AUTOSAR blocks. There is a limitation: the build processes, whether for TargetLink S-functions or RTW code generation, can involve only one TargetLink subsystem or S-function at a time. * Generating a TargetLink Subsytem from an SWC Description File with Client-Server Communication TargetLink now supports client-server communication (unidirectional and bidirectional) when generating a TargetLink subsystem from an SWC description file. Runnable Inport and Outport blocks and Client Port blocks are added to the generated runnable subsystem and configured accordingly. The following new properties are available: - ForceClientPortUsage [{'off'},'on'] Lets you specify which kind of TargetLink AUTOSAR blocks are to be used to model client-server communication within a runnable subsystem. If this property is set to 'on', Client Port blocks are always used independently of the operation and of the number and kind of operation arguments. If it is set to 'off' (default), the following applies: * The operation is unidirectional and has ARGIN arguments only, a Runnable Outport Block is used. * The operation is unidirectional and has ARGOUT arguments only, a Runnable Inport block is used. - ModelClientServerPorts ['off',{'on'}] Lets you specify if SWC ReceiverPort and SWC SenderPort blocks are to be added to the SWC subsystem ('on') or not ('off') for client ports and server ports of the modeled software component. - TerminateInOutPorts ['off',{'on'}] Lets you specify if the inports of added Runnable Outport and Client Port blocks, and the outports of added Runnable Inport and Client Port blocks, are to be connected to the Simulink Ground or Simulink Terminator block ('on') or remain unconnected ('off'). TIP: To retrieve information on all the available options, type help tl_generate_swc_model in the MATLAB Command Window. * Merging SWC Descriptions with the Data Dictionary The AUTOSAR SWC-D Merge Explorer, which can be used to merge AUTOSAR software component descriptions with the current Data Dictionary and is available under the View menu of the Data Dictionary Manager, now allows the specification of import options for AUTOSAR XML import. Import options are stored as individual properties under /config/Autosar in the Data Dictionary. The property names are identical to those used in the API import function. If the DD node is missing, it is automatically created with default options upon first use of the AUTOSAR SWC-D Merge Explorer (recommended way to create the Data Dictionary node). Set the properties of the /config/Autosar node to specify AUTOSAR import options for the tool. The AUTOSAR SWC-D Merge Explorer now also supports the selection of multiple files in a single AUTOSAR XML import step. * Defining an AUTOSAR-Compliant Type Structure You can suppress the generation of tl_basetypes.h when generating AUTOSAR software components. The advantage of this approach is that from the SWCs' point of view, the types are defined according to the AUTOSAR standard at the right point (definition reference /AUTOSAR). An easy way to suppress the generation of tl_basetypes.h is to load the AUTOSAR template dsdd_master_autosar.dd from dspaceroot/dsdd/config/ using the DD Merge Explorer. Then right-click the DD object (MT_tl_basetypes) that you want to merge into the open DD project file and select "Copy left (overwrite)" command from the context menu. As a result, the generation of tl_basetype.h is suppressed. - Stateflow Expressions with TargetLink Data Types Stateflow expressions that have at least one operand whose TargetLink data type is different from its Stateflow data type are now the subject of TargetLink's Stateflow expression autoscale mechanism. To be able to apply the code generation rules TargetLink uses for Simulink code, the Stateflow expression autoscale mechanism calculates a result type and a result scaling for each scaled operation specified in a Stateflow chart. A scaled operation is an operation that has at least one operand with an LSB unequal 1.0 and/or an offset unequal 0.0. In previous versions of TargetLink, all unscaled Stateflow expressions were regarded as custom code, i.e., the code specified in the chart was copied to the generated code. In this version of TargetLink, however, unscaled operations with at least one operand that has different TargetLink and Stateflow data types are now also included in the Stateflow expression autoscale mechanism. This changed behavior usually results in an additional cast operation in the code generated for Stateflow charts. Example: Int32 Out; /* with LSB: 2^0 OFF: 0 and Stateflow data type: double UInt16 In1; /* with LSB: 2^0 OFF: 0 and Stateflow data type: double UInt16 In2; /* with LSB: 2^0 OFF: 0 and Stateflow data type: double The expression Out = In1 - In2; specified in a Stateflow chart will now result in Out = (Int32) (((UInt32) In1) - ((UInt32) In2)); In previous TargetLink versions, it resulted in the expression Out = In1 - In2; which is dangerous on 16-bit platforms. The behavior of previous TargetLink versions can be restored by setting the Code Generator option 'HandleUnscaledStateflowExpressionsWithTlType' to 'off'. - New Combinations of Microcontrollers and Target Compilers Board Name | Supported Target Compiler ________________|________________________________________ Freescale | Wind River Diab PowerPC Family C Compiler MPC5561EVB | version 5.6 (Diab56) | | Green Hills MPC55xx C Compiler | version 5.0 (GHS50) | | Metrowerks MPC55xx Family C Compiler | CodeWarrior version 2.3 (Met23) For a detailed list of supported C compilers for TargetLink 3.0.1, refer to the chapter Third-Party Software in the appendix of the Software Installation and Management Guide. 9. TargetLink Known Problem Reports List ----------------------------------------------------------------- For a list of open problems in TargetLink 3.0.1, refer to the Known Problem Reports List on our Web site at http://www.dspace.com/goto?Problems_tl Please check the Web support page regularly for the latest TargetLink news. 10. Any Questions? ----------------------------------------------------------------- If you encounter any problems when using TargetLink - Have a look at the respective product manuals and online help. - Then visit the Support section of our Web site at http://www.dspace.com/goto?support. - Contact your distributor, or send us an e-mail at support.tl@dspace.de. ----------------------------------------------------------------- End of File