MICROSAR Fee
Technical Reference
Small Sector
Version 4.0.0
Authors
virgmi, virbka, virsrl
Status
Released
Technical Reference MICROSAR Fee
© 2020 Vector Informatik GmbH Version 4.0.0 2
based on template version 6.0.1
Document Information
History
Author
Date
Version
Remarks
virgmi
2016-06-22
1.00.00
Initial version
virgmi
2016-08-23
2016-09-21
1.01.00
Chapter ‘Requirements and
Recommendations’ was added.
Reference to ProductInformation of
SmallSectorFee was added.
virbka
2018-04-04
2.00.00
Chapter ‘Incompatibility between
SmallSectorFee Version 1.xx.xx and
2.xx.xx’ was added.
Chapter ‘Overhead Calculation’ was
adapted
New note box in chapter ‘Configuring Flash
API Services’
Chapter ‘Block Configuration’ was
extended
virbka
2020-01-31
2.00.01
Updated chapter 2.4.2 and 4.2.7 regarding
job result for erased blocks
(ESCAN102838)
virsrl
2020-05-05
2.01.00
Added chapter 1.2 (Small Sector Fee
usage)
virbka
2020-07-27
3.00.00
Updated Component History: Optimization
of Fee job processing: Reduction of
necessary Main Function cycles.
virbka
2020-12-17
4.00.00
Update to new template (e.g. deleted
Component History)
Added chapter 1.3 about Flash Layout
Compatibility.
Reference Documents
No.
Source
Title
Version
[1]
AUTOSAR
Specification of Flash EEPROM Emulation
V2.0.0
[2]
AUTOSAR
Specification of Development Error Tracer
V3.2.0
[3]
AUTOSAR
List of Basic Software Modules
V1.0.0
[4]
Vector
MICROSAR SmallSectorFee Product Information
V1.0.0
[5]
Vector
Specification of NVRAM Manager
V3.2.0
[6]
Vector
Updating a Block Configuration Using the SmallSectorFee
(KnowledgeBase article at vector.com)
-
Technical Reference MICROSAR Fee
© 2020 Vector Informatik GmbH Version 4.0.0 3
based on template version 6.0.1
Caution
We have configured the programs in accordance with your specifications in the
questionnaire. Whereas the programs do support other configurations than the one
specified in your questionnaire, Vector´s release of the programs delivered to your
company is expressly restricted to the configuration you have specified in the
questionnaire.
Technical Reference MICROSAR Fee
© 2020 Vector Informatik GmbH Version 4.0.0 4
based on template version 6.0.1
Contents
1 Introduction................................................................................................................... 7
1.1 Architecture Overview ........................................................................................ 8
1.2 Determine intended (SmallSector) FEE usage ................................................. 10
1.3 Flash layout compatibility ................................................................................. 11
2 Functional Description ............................................................................................... 12
2.1 Features .......................................................................................................... 12
2.1.1 Deviations from AUTOSAR R4.0.3 ................................................... 13
2.1.2 Additions/ Extensions ....................................................................... 13
2.2 Recommendations ........................................................................................... 13
2.3 Initialization ...................................................................................................... 14
2.4 States .............................................................................................................. 14
2.4.1 Module States .................................................................................. 14
2.4.2 Job States ........................................................................................ 14
2.5 Main Functions ................................................................................................ 15
2.5.1 Processing of a Read Job ................................................................ 15
2.5.2 Processing of a Write Job ................................................................ 16
2.5.3 Processing of an InvalidateBlock Job ............................................... 16
2.5.4 Processing of an EraseImmediateBlock Job .................................... 16
2.6 Error Handling .................................................................................................. 16
2.6.1 Development Error Reporting ........................................................... 16
2.6.2 Production Code Error Reporting ..................................................... 18
2.7 Partitions .......................................................................................................... 18
2.8 Service for handling under-voltage situations ................................................... 18
2.9 MainFunction Triggering ................................................................................... 19
3 Integration ................................................................................................................... 20
3.1 Scope of Delivery ............................................................................................. 20
3.1.1 Static Files ....................................................................................... 20
3.1.2 Dynamic Files .................................................................................. 21
3.2 Incompatibility between SmallSectorFee 1.xx.xx and following major
versions ........................................................................................................... 21
3.3 Migration from FEE to SmallSectorFEE ........................................................... 22
4 API Description ........................................................................................................... 25
4.1 Type Definitions ............................................................................................... 25
4.2 Services provided by FEE ................................................................................ 25
4.2.1 Fee_30_SmallSector_Init ................................................................. 25
4.2.2 Fee_30_SmallSector_SetMode ....................................................... 25
Technical Reference MICROSAR Fee
© 2020 Vector Informatik GmbH Version 4.0.0 5
based on template version 6.0.1
4.2.3 Fee_30_SmallSector_Read ............................................................. 26
4.2.4 Fee_30_SmallSector_Write ............................................................. 27
4.2.5 Fee_30_SmallSector_Cancel ........................................................... 28
4.2.6 Fee_30_SmallSector_GetStatus ...................................................... 28
4.2.7 Fee_30_SmallSector_GetJobResult ................................................ 29
4.2.8 Fee_30_SmallSector_InvalidateBlock .............................................. 30
4.2.9 Fee_30_SmallSector_GetVersionInfo .............................................. 30
4.2.10 Fee_30_SmallSector_EraseImmediateBlock ................................... 31
4.2.11 Fee_30_SmallSector_MainFunction ................................................ 32
4.2.12 Fee_30_SmallSector_SuspendWrites .............................................. 32
4.2.13 Fee_30_SmallSector_ResumeWrites ............................................... 33
4.3 Services used by FEE ...................................................................................... 33
4.4 Callback Functions ........................................................................................... 34
4.4.1 Fee_30_SmallSector_JobEndNotification ........................................ 34
4.4.2 Fee_30_SmallSector_JobErrorNotification ....................................... 35
4.5 Configurable Interfaces .................................................................................... 35
5 Configuration .............................................................................................................. 36
5.1 Configuration Variants ...................................................................................... 36
5.2 Configuration with DaVinci Configurator ........................................................... 36
5.2.1 Configuring Flash API Services ........................................................ 36
5.2.2 Partition Configuration ...................................................................... 37
5.2.3 Block Configuration .......................................................................... 38
5.3 Overhead Calculation ...................................................................................... 39
6 Requirements and Recommendations ...................................................................... 41
6.1 Requirements for the User System .................................................................. 41
6.1.1 General Requirements ..................................................................... 41
6.1.2 Write-Related ................................................................................... 41
6.1.3 Read/Compare-Related ................................................................... 41
6.1.4 Erase-Related .................................................................................. 41
6.1.5 BlankCheck-Related ........................................................................ 41
6.2 Recommendations ........................................................................................... 41
7 Abbreviations .............................................................................................................. 43
8 Contact ........................................................................................................................ 44