Specification of Flash EEPROM Emulation AUTOSAR Release 4.2.2 Document Title Specification of Flash EEPROM Emulation Document Owner AUTOSAR Document Responsibility AUTOSAR Document Identification No 286 Document Classification Standard Document Status Final Part of AUTOSAR Release 4.2.2 Document Change History Release Changed by Change Description 4.2.2 AUTOSAR Behaviour during FEE_BUSY_INTERNAL Release reworked Management Error classification reworked Debugging support marked as obsolete Job result clarified if requested block can’t be found 4.2.1 AUTOSAR Requirement for blank checking added Release Requirements linked to features, general and Management module specific requirements 4.1.3 AUTOSAR Editorial changes Release Management 4.1.2 AUTOSAR Timing requirement removed from module’s Release main function Management “const” qualifier added to prototype of function Fee_Write New configuration parameter FeeMainFunctionPeriod Editorial changes Removed chapter(s) on change documentation 4.1.1 AUTOSAR Reworked according to the new Administration SWS_BSWGeneral Scope attribute in tables in chapter 10 added Published parameter FeeMaximumBlockingTime deprecated Configuration parameter FeeIndex deprecated 4.0.3 AUTOSAR DET errors added / removed Administration Handling of internal management operations detailed Module short name changed Consistency checking reformulated 1 of 54 Document ID 286: AUTOSAR_SWS_FlashEEPROMEmulation - AUTOSAR confidential - Specification of Flash EEPROM Emulation AUTOSAR Release 4.2.2 Document Change History Release Changed by Change Description 3.1.5 AUTOSAR Inter-module checks clarified Administration (SWS_Fee_00013) Sequence diagram for Fee_Cancel replaced for generated one Naming in ECUC_Fee_00150 corrected to NVM_DATASET_SELECTION_BITS Sequence diagram for Fee_Init extended Handling of internal management operations refined (SWS_Fee_00022, SWS_Fee_00025, SWS_Fee_00173, SWS_Fee_00174, SWS_Fee_00183) Inter module checks detailed (SWS_Fee_00013) NvM_Cbk.h added to file include structure (SWS_Fee_00002) Ranges for FeeBlockNumber (ECUC_Fee_00150) and FeeBlockSize (ECUC_Fee_00148) adjusted Initialization might not be finished within Fee_Init, state machine adapted accordingly (SWS_Fee_00120, SWS_Fee_00168, SWS_Fee_00169) Handling of internal management operations refined (SWS_Fee_00170 .. SWS_Fee_00182 e.a.) 3.1.4 AUTOSAR Configuration variants clarified Administration Job result handling re-formulated Range of configuration parameters restricted Legal disclaimer revised 3.1.1 AUTOSAR Legal disclaimer revised Administration 3.0.1 AUTOSAR Small reformulations resulting from table Administration generation Tables in chapters 8 and 10 generated from UML model Document meta information extended Small layout adaptations made 2.1.15 AUTOSAR File include structure updated Administration API of initialization function adapted Range of FEE block numbers adapted Various API descriptions enhanced Legal disclaimer revised Release Notes added “Advice for users” revised “Revision Information” added 2 of 54 Document ID 286: AUTOSAR_SWS_FlashEEPROMEmulation - AUTOSAR confidential - Specification of Flash EEPROM Emulation AUTOSAR Release 4.2.2 Document Change History Release Changed by Change Description 2.0 AUTOSAR Initial release Administration 3 of 54 Document ID 286: AUTOSAR_SWS_FlashEEPROMEmulation - AUTOSAR confidential - Specification of Flash EEPROM Emulation AUTOSAR Release 4.2.2 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 presence 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. 4 of 54 Document ID 286: AUTOSAR_SWS_FlashEEPROMEmulation - AUTOSAR confidential - Specification of Flash EEPROM Emulation AUTOSAR Release 4.2.2 Table of Contents 1 Introduction and functional overview ................................................................... 7 2 Acronyms and abbreviations ............................................................................... 8 3 Related documentation........................................................................................ 9 3.1 Input documents ........................................................................................... 9 3.2 Related standards and norms ...................................................................... 9 3.3 Related specification .................................................................................. 10 4 Constraints and assumptions ............................................................................ 11 4.1 Limitations .................................................................................................. 11 4.2 Applicability to car domains ........................................................................ 11 5 Dependencies to other modules ........................................................................ 12 5.1 Header file structure ................................................................................... 12 6 Requirements traceability .................................................................................. 13 7 Functional specification ..................................................................................... 19 7.1 General behavior ........................................................................................ 19 7.1.1 Addressing scheme and segmentation ............................................... 19 7.1.2 Address calculation ............................................................................. 20 7.1.3 Limitation of erase cycles .................................................................... 21 7.1.4 Handling of “immediate” data .............................................................. 22 7.1.5 Managing block correctness information ............................................. 23 7.2 Error classification ...................................................................................... 23 7.2.1 Development Errors ............................................................................ 23 7.2.2 Runtime Errors .................................................................................... 24 7.2.3 Transient Faults .................................................................................. 24 7.2.4 Production Errors ................................................................................ 24 7.2.5 Extended Production Errors ................................................................ 24 7.3 Support for Debugging ............................................................................... 24 8 API specification ................................................................................................ 25 8.1 Imported Types .......................................................................................... 25 8.2 Type definitions .......................................................................................... 25 8.3 Function definitions .................................................................................... 25 8.3.1 Fee_Init ............................................................................................... 25 8.3.2 Fee_SetMode ...................................................................................... 26 8.3.3 Fee_Read ........................................................................................... 27 8.3.4 Fee_Write............................................................................................ 29 8.3.5 Fee_Cancel ......................................................................................... 30 8.3.6 Fee_GetStatus .................................................................................... 32 8.3.7 Fee_GetJobResult .............................................................................. 33 8.3.8 Fee_InvalidateBlock ............................................................................ 34 8.3.9 Fee_GetVersionInfo ............................................................................ 35 8.3.10 Fee_EraseImmediateBlock