Specification of Memory Mapping V1.4.0 R4.0 Rev 3 Document Title Specification of Memory Mapping Document Owner AUTOSAR Document Responsibility AUTOSAR Document Identification No 128 Document Classification Standard Document Version 1.4.0 Document Status Final Part of Release 4.0 Revision 3 Document Change History Date Version Changed by Change Description 01.12.2011 1.4.0 AUTOSAR • Consistent naming pattern for memory Administration allocation keywords is introduced • Refine definition the <PREFIX> part in memory allocation keywords 03.11.2010 1.3.0 AUTOSAR • ECU Configuration Parameters for Administration MemMap defined • Define generation of MemMap header files • New standardised Memory Allocation Keywords for new initialisation policy CLEARED added • Refinement of <SIZE> suffix of Memory Allocation Keywords to <ALIGNMENT> suffix, • Clarify link MetaModel attribute values, o Define MemorySectionType and SectionInitializationPolicy for the standardised Memory Allocation Keywords o Define that <NAME> used for Memory Allocation Keywords is the MemorySection shortName • Application hint for usage of INLINE and LOCAL_INLINE added • Handling structs, arrays and unions redefined 1 of 63 Document ID 128: AUTOSAR_SWS_MemoryMapping - AUTOSAR confidential - Specification of Memory Mapping V1.4.0 R4.0 Rev 3 Document Change History Date Version Changed by Change Description 04.12.2009 1.2.0 AUTOSAR • Typo errors are corrected throughout the Administration document • Memory Mapping section has been extended for application SWC • Common Published information has been updated • Legal disclaimer revised 23.06.2008 1.1.1 AUTOSAR Legal disclaimer revised Administration 12.12.2007 1.1.0 AUTOSAR • In MEMMAP004,all size postfixes for Administration memory segment names were listed, the keyword 'BOOLEAN was added, taking into account the particular cases where boolean data need to be mapped in a particular segment. • In MEMMAP004 and MEMMAP021,tables are defining the mapping segments associated to #pragmas instructions, adding some new segments to take into account some implementation cases • Document meta information extended • Small layout adaptations made 13.02.2006 1.0.0 AUTOSAR Initial release Administration 2 of 63 Document ID 128: AUTOSAR_SWS_MemoryMapping - AUTOSAR confidential - Specification of Memory Mapping V1.4.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 Specification Documents 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 Specification Documents for illustration purposes only, and they themselves are not part of the AUTOSAR Standard. Neither their presence in such Specification Documents, 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. 3 of 63 Document ID 128: AUTOSAR_SWS_MemoryMapping - AUTOSAR confidential - Specification of Memory Mapping V1.4.0 R4.0 Rev 3 Table of Contents 1 Introduction and functional overview ................................................................... 6 2 Acronyms and abbreviations ............................................................................... 8 3 Related documentation........................................................................................ 9 3.1 Input documents ........................................................................................... 9 3.2 Related standards and norms .................................................................... 10 4 Constraints and assumptions ............................................................................ 11 4.1 Limitations .................................................................................................. 11 4.2 Applicability to car domains ........................................................................ 11 4.3 Applicability to safety related environments ............................................... 11 5 Dependencies to other modules ........................................................................ 12 5.1 File structure .............................................................................................. 12 5.1.1 Code file structure ............................................................................... 12 5.1.2 Header file structure ............................................................................ 12 6 Requirements traceability .................................................................................. 14 7 Analysis ............................................................................................................. 23 7.1 Memory allocation of variables ................................................................... 23 7.2 Memory allocation of constant variables .................................................... 24 7.3 Memory allocation of code ......................................................................... 25 8 Functional specification ..................................................................................... 27 8.1 General issues ........................................................................................... 27 8.2 Mapping of variables and code .................................................................. 28 8.2.1 Requirements on implementations using memory mapping header files for BSW Modules and Software Components ................................................... 28 8.2.2 Requirements on memory mapping header files ................................. 35 8.3 Examples ................................................................................................... 39 8.3.1 Code Section ....................................................................................... 39 8.3.2 Fast Variable Section .......................................................................... 42 8.3.3 Code Section in ICC2 cluster .............................................................. 47 9 API specification ................................................................................................ 50 10 Sequence diagrams ....................................................................................... 51 11 Configuration specification ............................................................................. 52 11.1 How to read this chapter ............................................................................ 52 11.1.1 Configuration and configuration parameters ....................................... 52 11.1.2 Variants ............................................................................................... 52 11.1.3 Containers ........................................................................................... 53 11.1.4 Specification template for configuration parameters ........................... 53 11.2 Containers and configuration parameters .................................................. 55 11.2.1 Variants ............................................................................................... 55 11.2.1.1 VARIANT-PRE-COMPILE ............................................................ 55 11.2.2 MemMap ............................................................................................. 55 4 of 63 Document ID 128: AUTOSAR_SWS_MemoryMapping - AUTOSAR confidential - Specification of Memory Mapping V1.4.0 R4.0 Rev 3 11.2.3 MemMapAddressingModeSet ............................................................. 55 11.2.4 MemMapAddressingMode .................................................................. 58 11.2.5 MemMapAllocation .............................................................................. 59 11.2.6 MemMapGenericMapping ................................................................... 60 11.2.7 MemMapSectionSpecificMapping ....................................................... 61 11.3 Published Information ................................................................................. 62 12 Not applicable requirements .......................................................................... 63 5 of 63 Document ID 128: AUTOSAR_SWS_MemoryMapping - AUTOSAR confidential - Specification of Memory Mapping V1.4.0 R4.0 Rev 3 1 Introduction and functional overview This document specifies mechanisms for the mapping of code and data to specific memory sections via memory mapping files. For