MICROSAR FiM
Technical Reference
Function Inhibition Manager
Version 9.0.0
Authors
vistne
Status
Released
Technical Reference MICROSAR FiM
© 2021 Vector Informatik GmbH Version 9.0.0 2
based on template version 5.2.0
Document Information
History
Author
Date
Version
Remarks
vistne
2012-10-19
1.0.0
first version of FiM according AR4
vistne
2013-03-15
1.1.0
added calibration section, added OBD support, removed
restriction regarding cyclic event evaluation
vistne
2013-06-28
1.2.0
changed include structure
vistne
2013-10-18
2.0.0
added info to FiM_DemTriggerOnEventStatus
vistne
2014-03-07
2.1.0
added Post-Build Loadable description, some smaller changes
vistne
2014-10-31
3.0.0
described format of version info numbers
added section for integration in AR 3 stack
vistne
2015-03-20
3.1.0
described new 3.1.0 features
vistne
2016-01-08
4.0.0
removed calibration section and descriptions related to cyclic
event evaluation
vistne
2016-11-18
4.2.0
added …VAR_INIT… for compiler abstraction / memory
mapping
vistne
2017-10-27
5.0.0
rework for AR4.3
vistne
2017-11-24
5.1.0
small changes
vistne
2018-03-16
5.2.0
added description for calibration using vPblCalib
vistne
2018-08-24
6.0.0
changes for Multicore
vistne
2018-09-28
6.1.0
added FiM_PostInit
vistne
2018-11-23
6.2.0
small changes
vistne
2019-03-15
6.4.0
production version
vistne
2020-04-09
7.0.0
fixes regarding inter core synchronization and communication
(ESCAN00103546 and ESCAN00103578),
fix regarding memory sections (ESCAN00103001),
new Exclusive Area,
changes for memory sections
vistne
2021-02-12
9.0.0
added affected FIDs identification
several smaller improvements
Technical Reference MICROSAR FiM
© 2021 Vector Informatik GmbH Version 9.0.0 3
based on template version 5.2.0
Reference Documents
No.
Source
Title
Version
[1]
AUTOSAR
Specification of Function Inhibition Manager
4.3.0
[2]
AUTOSAR
Specification of Default Error Tracer
4.3.0
[3]
AUTOSAR
List of Basic Software Modules
4.3.0
[4]
Vector
MICROSAR Diagnostic Event Manager (DEM) for OBD,
Technical Reference Addendum
see delivery
[5]
Vector
MICROSAR Post-Build Loadable, Technical Reference
see delivery
[6]
Vector
vPblCalib, Technical Reference
see delivery
Scope of the Document
This technical reference describes the general use of the Function Inhibition Manager
Basic Software Module.
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.
Caution
This symbol calls your attention to warnings.
Technical Reference MICROSAR FiM
© 2021 Vector Informatik GmbH Version 9.0.0 4
based on template version 5.2.0
Contents
1 Introduction................................................................................................................... 9
1.1 Architecture Overview ........................................................................................ 9
2 Functional Description ............................................................................................... 11
2.1 Features .......................................................................................................... 11
2.2 Major Changes between FiM versions ............................................................. 12
2.2.1 Major Changes in FiM version 9.x compared to FiM version 8.x ....... 12
2.2.2 Major Changes in FiM version 8.x compared to FiM version 7.x ....... 12
2.2.3 Major Changes in FiM version 7.x compared to FiM version 6.x ....... 12
2.2.3.1 Changes in Support of Multiple Partitions ...................... 12
2.2.4 Major Changes in FiM version 6.x compared to FiM version 5.x ....... 13
2.2.4.1 Support of Multiple Partitions ......................................... 13
2.2.5 Major Changes in FiM version 5.x compared to FiM version 4.x ....... 13
2.2.5.1 Usage of Monitor Status ................................................ 13
2.2.5.2 FiM_GetPendingStatus .................................................. 13
2.2.5.3 Initialization .................................................................... 14
2.2.5.4 Runtime ......................................................................... 14
2.3 FiM Module Architecture .................................................................................. 15
2.3.1 FiM Satellite(s) ................................................................................. 16
2.3.2 FiM Master ....................................................................................... 16
2.3.3 Communication Constraints ............................................................. 17
2.3.3.1 FiM Master and All Satellites Running on Untrusted
Partitions ........................................................................ 17
2.3.3.2 FiM Master and All Satellites Running on Trusted
Partitions ........................................................................ 18
2.3.3.3 FiM Master and Some Satellites Running on Trusted
Partitions, Some Satellites Running on Untrusted
Partitions ........................................................................ 19
2.3.3.4 FiM Master and Some Satellites Running on Untrusted
Partitions, Some Satellites Running on Trusted
Partitions ........................................................................ 20
2.4 Initialization ...................................................................................................... 21
2.4.1 Multi Partition Use Case ................................................................... 21
2.4.2 Single Partition Use Case ................................................................ 22
2.5 States .............................................................................................................. 24
2.5.1 Initialization States ........................................................................... 24
2.6 Main Function .................................................................................................. 26
2.7 Error Handling .................................................................................................. 27
2.7.1 Development Error Reporting ........................................................... 27
Technical Reference MICROSAR FiM
© 2021 Vector Informatik GmbH Version 9.0.0 5
based on template version 5.2.0
2.7.2 Production Code Error Reporting ..................................................... 27
3 Integration ................................................................................................................... 28
3.1 Scope of Delivery ............................................................................................. 28
3.2 Compiler Abstraction and Memory Mapping ..................................................... 29
3.2.1 Constant Sections (Memory Section Group “Constant”) ................... 29
3.2.2 Variable Sections for FiM Master (Memory Section Group “Master”) 30
3.2.3 Variable Sections for FiM Master and all Satellites (Memory
Section Group “MasterSatAll”).......................................................... 31
3.2.4 Variable Sections with Restricted Write Access (Memory Section
Group “Restricted”) .......................................................................... 32
3.2.5 Variable Sections for FiM Satellites and FiM Master (Memory
Section Group “MasterSat<OS_APPLICATION_NAME>”) ............... 33
3.2.6 Variable Sections for FiM Satellites (Memory Section Group
“Sat<OS_APPLICATION_NAME>”) ................................................. 34
3.2.7 Memory Map with multiple partitions ................................................ 34
3.3 Synchronization ............................................................................................... 35
3.3.1 Atomic Compare/Exchange .............................................................. 35
3.3.2 Critical Sections ............................................................................... 35
3.3.2.1 FIM_EXCLUSIVE_AREA_0 ........................................... 35
3.3.2.2 FIM_EXCLUSIVE_AREA_1 ........................................... 35
3.4 Integration into AUTOSAR 3 Stack................................................................... 36
3.4.1 RTE.................................................................................................. 36
3.4.2 SchM................................................................................................ 36
3.4.2.1 Geny .............................................................................. 36
3.4.2.2 DaVinci Configurator Pro 5 ............................................ 36
4 API Description ........................................................................................................... 37
4.1 Type Definitions ............................................................................................... 37
4.2 Services provided by FiM ................................................................................. 38
4.2.1 FiM_Init() .......................................................................................... 38
4.2.2 FiM_DemInitMaster() ....................................................................... 39
4.2.3 FiM_DemInitSatellite() ...................................................................... 40
4.2.4 FiM_DemInit() .................................................................................. 41
4.2.5 FiM_PostInit() ................................................................................... 42
4.2.6 FiM_DemTriggerOnMonitorStatus() ................................................. 43
4.2.7 FiM_DemTriggerOnEventStatus() .................................................... 44
4.2.8 FiM_GetFunctionPermission() .......................................................... 45
4.2.9 FiM_GetFunctionPendingStatus() .................................................... 46
4.2.10 FiM_GetVersionInfo() ....................................................................... 47
4.2.11 FiM_InitMemory() ............................................................................. 48
4.2.12 FiM_MainFunction() ......................................................................... 49