Specification of Manifest AUTOSAR AP Release 18-03
Total Page:16
File Type:pdf, Size:1020Kb
Specification of Manifest AUTOSAR AP Release 18-03 Document Title Specification of Manifest Document Owner AUTOSAR Document Responsibility AUTOSAR Document Identification No 713 Document Status Final Part of AUTOSAR Standard Adaptive Platform Part of Standard Release 18-03 Document Change History Date Release Changed by Description AUTOSAR 2018-03-29 18-03 Release • Time Synchronization Management • DDS Deployment • Optional elements in Service Interfaces • Interaction with web services AUTOSAR • Secure Communication 2017-10-27 17-10 Release • Support for interaction with crypto Management and persistency • Signal-to-Service translation • Support for E2E communication • Platform Health Management • Uploadable Software Package AUTOSAR 2017-03-31 17-03 Release • Initial release Management 1 of 602 Document ID 713: AUTOSAR_TPS_ManifestSpecification — AUTOSAR CONFIDENTIAL — Specification of Manifest AUTOSAR AP Release 18-03 2 of 602 Document ID 713: AUTOSAR_TPS_ManifestSpecification — AUTOSAR CONFIDENTIAL — Specification of Manifest AUTOSAR AP Release 18-03 Disclaimer This work (specification and/or software implementation) 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 work. The material contained in this work is protected by copyright and other types of intel- lectual property rights. The commercial exploitation of the material contained in this work requires a license to such intellectual property rights. This work 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 work may be utilized or reproduced, in any form or by any means, without permission in writing from the publisher. The work has been developed for automotive applications only. It has neither been developed, nor tested for non-automotive applications. The word AUTOSAR and the AUTOSAR logo are registered trademarks. 3 of 602 Document ID 713: AUTOSAR_TPS_ManifestSpecification — AUTOSAR CONFIDENTIAL — Specification of Manifest AUTOSAR AP Release 18-03 Table of Contents 1 Introduction 12 1.1 Modeling Approach............................. 13 1.2 The Term Service.............................. 14 1.3 Abbreviations................................ 15 1.4 Document Conventions........................... 17 1.5 Requirements Tracing........................... 19 1.6 Known Limitations............................. 24 2 Big Picture of Manifest Definition 25 2.1 Design vs. Deployment........................... 25 2.2 About Manifest............................... 25 2.3 Serialization Format............................ 25 2.4 Scope.................................... 26 2.5 Manifests described in this Document.................. 27 3 Application Design 29 3.1 Overview................................... 29 3.2 Software Component............................ 29 3.3 Data Type.................................. 31 3.3.1 Overview............................. 31 3.3.2 ApplicationDataType....................... 31 3.3.2.1 String Data Type.................... 32 3.3.2.2 Associative Map Data Type.............. 35 3.3.2.3 Attributes of SwDataDefProps............. 40 3.3.3 ImplementationDataType.................... 42 3.3.3.1 String Data Type.................... 44 3.3.3.2 Vector Data Type.................... 47 3.3.3.3 Associative Map Data Type.............. 56 3.3.3.4 Attributes of SwDataDefProps............. 60 3.3.4 CppImplementationDataType.................. 62 3.3.4.1 Disclaimer........................ 62 3.3.4.2 Overview........................ 62 3.3.4.3 Attributes of SwDataDefProps............. 72 3.3.4.4 Fundamental Data Types............... 74 3.3.4.5 String Data Type.................... 74 3.3.4.6 Array Data Type..................... 76 3.3.4.7 Vector Data Type.................... 79 3.3.4.8 Struct Data Type.................... 82 3.3.4.9 Enumeration Data Type................ 83 3.3.4.10 Map Data Type..................... 84 3.3.4.11 Variant Data Type.................... 86 3.3.5 BaseType............................. 86 3.3.5.1 Bitfield.......................... 88 3.3.5.2 Enumeration...................... 89 4 of 602 Document ID 713: AUTOSAR_TPS_ManifestSpecification — AUTOSAR CONFIDENTIAL — Specification of Manifest AUTOSAR AP Release 18-03 3.4 Service Interface.............................. 90 3.4.1 Overview............................. 90 3.4.2 Event............................... 93 3.4.3 Field................................ 94 3.4.4 Method.............................. 94 3.4.4.1 Fire and Forget Method................ 95 3.4.5 Compatibility of Service Interfaces............... 96 3.4.6 Namespace........................... 98 3.4.7 Error Handling.......................... 101 3.4.8 Service Interface Data Type Mapping............. 103 3.5 Service Interface Mapping......................... 106 3.6 Service Interface Element Mapping.................... 111 3.6.1 Overview............................. 111 3.6.2 Service Interface Event Mapping................ 114 3.6.3 Service Interface Field Mapping................ 116 3.6.4 Service Interface Method Mapping............... 118 3.6.5 Service Interface Application Error Mapping......... 120 3.7 Persistency Interface............................ 122 3.7.1 Overview............................. 122 3.7.2 Persistency Key Value Database Interface.......... 124 3.7.3 Persistency File Proxy Interface................ 127 3.8 Time Synchronization Interface...................... 129 3.9 Platform Health Management Interface.................. 133 3.9.1 Overview............................. 133 3.9.2 Supervised Entities and Checkpoints............. 134 3.9.3 Health Channels......................... 136 3.10 Interaction Endpoint for Application.................... 138 3.10.1 Service-oriented Communication................ 138 3.10.2 Interaction with Crypto Software................ 139 3.10.3 Interaction with Persistent Key-Value Storage......... 141 3.10.4 Interaction with Persistent File-Based Storage........ 142 3.10.5 Port Prototype Props...................... 142 3.10.6 Port Prototype ComSpec.................... 145 3.10.6.1 Port Prototypes typed by Service Interfaces..... 145 3.10.6.2 Port Prototypes typed by Persistency Data Interfaces 153 3.11 Executable Group.............................. 157 3.12 Optional Members in complex Data Structures.............. 165 3.12.1 Background........................... 165 3.12.2 Definition of Optionality..................... 166 3.13 Serialization Properties........................... 173 3.13.1 Default Values for Serialization Properties........... 174 3.13.2 Individual Definition of Serialization Properties........ 179 3.13.3 Assignment of TLV Data IDs for Data Structures with optional Members............................. 186 4 Diagnostic Mapping 190 5 of 602 Document ID 713: AUTOSAR_TPS_ManifestSpecification — AUTOSAR CONFIDENTIAL — Specification of Manifest AUTOSAR AP Release 18-03 4.1 Overview................................... 190 4.2 Diagnostic Data Mapping......................... 194 4.3 Diagnostic Software Mapping....................... 197 4.4 Diagnostic Event to Port Mapping..................... 202 4.5 Diagnostic Operation Cycle to Port Mapping............... 204 4.6 Diagnostic Enable Condition to Port Mapping.............. 207 4.7 Diagnostic Storage Condition to Port Mapping.............. 210 5 REST Design 212 5.1 Overview................................... 212 5.2 REST Service Interface.......................... 215 5.3 REST Resource............................... 215 5.4 REST Element............................... 220 6 Application Manifest 229 6.1 Overview................................... 229 6.2 Startup Configuration............................ 231 6.2.1 Mode-dependent Startup Configuration............ 232 6.2.2 Scheduling............................ 235 6.2.3 Startup Options......................... 236 6.2.4 Resources............................ 239 6.2.5 Execution Dependency..................... 240 6.2.6 Assignment of Processes to Function Group states..... 241 7 Service Instance Manifest 242 7.1 Service Interface Deployment....................... 242 7.1.1 SOME/IP Service Interface Deployment............ 245 7.1.2 DDS Service Interface Deployment.............. 255 7.1.3 User Defined Service Interface................. 257 7.2 Service Instance Deployment....................... 261 7.2.1 SOME/IP Service Instance Deployment............ 267 7.2.1.1 Provided Service Instance............... 268 7.2.1.2 Required Service Instance............... 287 7.2.2 DDS Service Instance Deployment............... 297 7.2.2.1 Provided DDS Service Instance............ 298 7.2.2.2 Required DDS Service Instance............ 300 7.2.2.3 DDS Service Instance to Machine mapping..... 301 7.2.3 User Defined Service Instance Deployment.......... 302 7.3 EndToEndProtection............................ 304 7.4 Secure Communication.......................... 309 7.4.1 Secure Communication over TLS............... 312 7.4.2 Secure Communication over SecOC.............. 316 7.5 Log and Trace................................ 318 8 Machine Manifest 322 8.1 Hardware Resources............................ 325 8.2 Machine States............................... 329 6 of 602 Document ID 713: AUTOSAR_TPS_ManifestSpecification — AUTOSAR CONFIDENTIAL — Specification of Manifest AUTOSAR AP Release 18-03 8.3 Function Groups.............................. 331 8.4 State Timeouts..............................