Software Component Template V4.2.0 R4.0 Rev 3
Total Page:16
File Type:pdf, Size:1020Kb
Software Component Template V4.2.0 R4.0 Rev 3 Document Title Software Component Template Document Owner AUTOSAR Document Responsibility AUTOSAR Document Identification No 062 Document Classification Standard Document Version 4.2.0 Document Status Final Part of Release 4.0 Revision 3 Document Change History Date Version Changed by Description • Added CompuMethod categories SCALE_LINEAR_AND_ TEXTTABLE and SCALE_ RATIONAL_AND_TEXTTABLE (table 5.67) • Clarification concerning the usage of invalid values • Revised support for data filters • Support for partial networking • Support for the specification of AUTOSAR 2011-10-26 4.2.0 local connections between Administration software-components • Improved description of service needs • Change history of constraints and specification items • Miscellaneous improvements and clarifications • “Support for Standardization” moved to Standardization Template [1] 1 of 566 Document ID 062: AUTOSAR_TPS_SoftwareComponentTemplate — AUTOSAR CONFIDENTIAL — Software Component Template V4.2.0 R4.0 Rev 3 • Remove restriction on data type of inter-runnable variables • Rework end-to-end AUTOSAR 2010-10-14 4.1.0 communication protection Administration • Add more constraints on the usage of the meta-model • Various fixes and clarifications • New requirements tracing table • Support for fixed data exchange • Implementation of meta-model cleanup • Fundamental revision of the data type concept • Support for variant handling • Support for end-to-end communication protection • Support for documentation AUTOSAR • Support for stopping and 2009-09-15 4.0.0 Administration restarting of software-components • Support for triggered events • Support for explicit mapping of interface elements • Revised concept of mode management • Support for integrity and scaling at ports • Support for standardization within AUTOSAR • Improved support for on-board AUTOSAR 2008-07-02 3.1.0 diagnostics Administration • Small layout adaptations made 2 of 566 Document ID 062: AUTOSAR_TPS_SoftwareComponentTemplate — AUTOSAR CONFIDENTIAL — Software Component Template V4.2.0 R4.0 Rev 3 • Improved support for measurement and calibration • Improved semantics of delegation ports AUTOSAR 2007-11-13 3.0.0 • Introduction of abstract memory Administration classes • Document meta information extended • Small layout adaptations made • Harmonization of the document with other specifications (e.g. RTE) • Introduction of a new concept to support calibration and measurement - harmonized with RTE • Description of needs of the AUTOSAR 2007-01-31 2.1.0 Software Component Template Administration toward AUTOSAR services and of the interaction of the Software Component Template and services (on XML level) • Legal disclaimer revised • Release notes added • "‘Advice for users"’ added • "‘Revision information"’ added AUTOSAR 2006-05-18 2.0.0 Second Administration AUTOSAR 2005-05-09 1.0.0 Initial release Administration 3 of 566 Document ID 062: AUTOSAR_TPS_SoftwareComponentTemplate — AUTOSAR CONFIDENTIAL — Software Component Template V4.2.0 R4.0 Rev 3 4 of 566 Document ID 062: AUTOSAR_TPS_SoftwareComponentTemplate — AUTOSAR CONFIDENTIAL — Software Component Template V4.2.0 R4.0 Rev 3 Disclaimer This specification and the material contained in it, as released by AUTOSAR, is for the purpose of information only. AUTOSAR and the companies that have contributed to it shall not be liable for any use of the specification. The material contained in this specification is protected by copyright and other types of Intellectual Property Rights. The commercial exploitation of the material contained in this specification requires a license to such Intellectual Property Rights. This specification may be utilized or reproduced without any modification, in any form or by any means, for informational purposes only. For any other purpose, no part of the specification may be utilized or reproduced, in any form or by any means, without permission in writing from the publisher. The AUTOSAR specifications have been developed for automotive applications only. They have neither been developed, nor tested for non-automotive applications. The word AUTOSAR and the AUTOSAR logo are registered trademarks. Advice for users AUTOSAR specifications may contain exemplary items (exemplary reference models, "use cases", and/or references to exemplary technical solutions, devices, processes or software). Any such exemplary items are contained in the specifications for illustration purposes only, and they themselves are not part of the AUTOSAR Standard. Neither their pres- ence in such specifications, nor any later documentation of AUTOSAR conformance of products actually implementing such exemplary items, imply that intellectual property rights covering such exemplary items are licensed under the same rules as applicable to the AUTOSAR Standard. 5 of 566 Document ID 062: AUTOSAR_TPS_SoftwareComponentTemplate — AUTOSAR CONFIDENTIAL — Software Component Template V4.2.0 R4.0 Rev 3 Table of Contents 1 Introduction 16 1.1 Overview................................... 16 1.2 Scope..................................... 16 1.3 Organization of the Meta-Model....................... 17 1.4 Structure of the Template.......................... 19 1.4.1 Description of Software Components on VFB Level........ 19 1.4.2 Description of Software Components on RTE Level........ 20 1.4.3 Descriptions of Software Components on Implementation Level. 20 1.5 Document Conventions........................... 20 1.6 Requirements Tracing............................ 22 1.7 Comments regarding non-fulfilled requirements.............. 29 2 Conceptual Aspects 32 2.1 Introduction.................................. 32 2.2 Measurement and Calibration........................ 32 2.2.1 Basic Approach of Measurement and Calibration......... 32 2.2.2 Calibration Parameters Overview.................. 32 2.2.3 Using Calibration Parameters.................... 33 2.2.3.1 Sharing Calibration Parameters within Compositions.. 33 2.2.3.2 Sharing Calibration Parameters between SwCompo- nentPrototypes of the Same SwComponentType.... 36 2.2.3.3 Providing Instance Individual Characteristic Data.... 37 2.3 Runtime and Data Consistency Aspects.................. 38 2.3.1 Background: the Issues....................... 38 2.3.1.1 Mutual Exclusion with Semaphores........... 38 2.3.1.2 Interrupt Disabling..................... 39 2.3.1.3 Priority Ceiling....................... 39 2.3.1.4 Implicit Communication by Means of Variable Copies. 39 2.3.2 Data Consistency at Runtime.................... 40 2.3.3 Modeling Aspects of Data Consistency.............. 41 2.4 Variant Handling in the Software Component Template.......... 42 2.5 Communication Specification of Composition Component Types.... 43 2.5.1 Rationale............................... 44 3 Overview: Software Components, Ports, and Interfaces 46 3.1 Introduction.................................. 46 3.2 Software Component............................. 46 3.3 Composition................................. 54 3.4 Port Interface................................. 61 4 Details: Software Components, Ports, and Interfaces 67 4.1 Introduction.................................. 67 4.2 Port Interface Details............................. 67 4.2.1 Introduction.............................. 67 6 of 566 Document ID 062: AUTOSAR_TPS_SoftwareComponentTemplate — AUTOSAR CONFIDENTIAL — Software Component Template V4.2.0 R4.0 Rev 3 4.2.2 Sender Receiver Communication.................. 68 4.2.3 Client Server Communication.................... 70 4.2.3.1 Client Server Interface.................. 71 4.2.3.2 Error Handling in Client/Server Communication..... 76 4.2.4 External Trigger Event Communication............... 78 4.2.5 Communication of Modes...................... 80 4.3 PortInterface Mapping and Data Scaling.................. 86 4.3.1 PortInterface Mapping........................ 87 4.3.1.1 Mapping of Sender Receiver Interface, Parameter Inter- face and Non Volatile Data Interface Elements..... 88 4.3.1.2 Mapping of Client Server Interface Elements...... 91 4.3.1.3 Mapping of Mode Interface Elements.......... 92 4.3.1.4 Mapping of Trigger Interface Elements.......... 93 4.3.1.5 Mapping of Elements of a composite Data Type.... 94 4.3.2 Data Conversion........................... 99 4.3.2.1 Linear Data Scaling.................... 99 4.3.2.2 Table Conversion..................... 99 4.4 Port Annotation................................ 101 4.4.1 Introduction.............................. 101 4.4.2 SenderReceiverAnnotation..................... 103 4.4.3 ClientServerAnnotation....................... 107 4.4.4 Annotation for the I/O Hardware Abstraction Layer........ 108 4.4.5 Parameter Port Annotation..................... 110 4.4.6 Mode Port Annotation........................ 111 4.4.7 Trigger Port Annotation....................... 112 4.4.8 Non Volatile Data Port Annotation................. 113 4.4.9 Delegated Port Annotations..................... 114 4.4.10 General Annotation......................... 115 4.5 Communication Specification........................ 116 4.5.1 Communication Specification for Sender-Receiver Communication118 4.5.2 Communication Specification for Client-Server Communication. 127 4.5.3 Communication Specification for Mode Switch Communication. 130 4.5.4 Communication Specification for Parameters........... 132 4.5.5 Communication Specification for NV Data............. 134 4.6 Port Groups within Component Types................... 137 4.7 End to End Protection............................ 139 4.8 Partial Networking.............................. 147