AUTOSAR EXP ModeManagementGuide
AUTOSAR EXP ModeManagementGuide
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.
Table of Contents
1 Introduction 8
1.1 Further Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2 Overall mechanisms and concepts 9
2.1 Declaration of modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2 Mode managers and mode users . . . . . . . . . . . . . . . . . . . . . 11
2.3 Modes in the RTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.4 Modes in the Basic Software Scheduler . . . . . . . . . . . . . . . . . 12
2.5 Communication of modes . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.5.1 Mode switch . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.5.2 Mode request . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.5.3 Conformance of mode switches and mode requests . . . . . 14
2.5.4 Mode proxies . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.5.5 Mode communication on multi core ECUs . . . . . . . . . . . 15
3 Configuration of the Basic Software Modemanager 18
3.1 Process how to configure and integrate a BswM . . . . . . . . . . . . . 18
3.2 Semantics of BswM Configuration: Interfaces and behavioral aspects . 19
3.2.1 Interface of the BswM . . . . . . . . . . . . . . . . . . . . . . 19
3.2.1.1 Mode Requests . . . . . . . . . . . . . . . . . . . . . 19
3.2.1.2 Available Actions . . . . . . . . . . . . . . . . . . . . 20
3.2.2 Definition of the interface in pseudo code . . . . . . . . . . . 21
3.2.2.1 Mode switch and mode request interfaces . . . . . . 21
3.2.2.2 ModeRequestPorts defined by the standardized in-
terface of the BswM . . . . . . . . . . . . . . . . . . 23
3.2.2.3 Configurable ModeRequestPorts . . . . . . . . . . . 30
3.2.2.4 Configurable ModeSwitchPorts . . . . . . . . . . . . 31
3.2.3 Configuration of the BswM behavior . . . . . . . . . . . . . . 32
3.3 ECU state management . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.3.1 ECU Mode Handling . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.1.1 Startup . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.1.2 Running . . . . . . . . . . . . . . . . . . . . . . . . . 35
3.3.1.3 Shutdown and Sleep . . . . . . . . . . . . . . . . . . 35
3.3.2 Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.3.3 Run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.3.4 Shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.3.5 Sleep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.3.6 Wakeup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.3.7 Reset of partitions . . . . . . . . . . . . . . . . . . . . . . . . 39
3.4 Communication Management . . . . . . . . . . . . . . . . . . . . . . . 40
3.4.1 Startup and Shutdown . . . . . . . . . . . . . . . . . . . . . . 41
3.4.2 I-PDU Group Switching . . . . . . . . . . . . . . . . . . . . . 41
3.4.3 J1939 Networkmanagement . . . . . . . . . . . . . . . . . . 45
3.4.4 J1939 diagnostic mode management . . . . . . . . . . . . . 47
Bibliography
[1] Specification of ECU State Manager with fixed state machine
AUTOSAR_SWS_ECUStateManagerFixed
[2] Software Component Template
AUTOSAR_TPS_SoftwareComponentTemplate
[3] Meta Model
AUTOSAR_MMOD_MetaModel
[4] Basic Software Module Description Template
AUTOSAR_TPS_BSWModuleDescriptionTemplate
[5] Specification of Basic Software Mode Manager
AUTOSAR_SWS_BSWModeManager
[6] Specification of Diagnostic Communication Manager
AUTOSAR_SWS_DiagnosticCommunicationManager
[7] Glossary
AUTOSAR_TR_Glossary
1 Introduction
This document is a general introduction to AUTOSAR mode management for the Re-
lease 4.0.3 onwards. Its main purpose is to give users as well as developers of
AUTOSAR an detailed overview of the different aspects of AUTOSAR mode manage-
ment based on examples, which are explained in context. The code listings in this
document together form the configuration of a sample ECU.
Chapter 2 explains the basic mode management concepts e.g. modes in general, how
mode switches are implemented, roles of mode managers and mode users etc. It sec-
ondly gives an introduction to Application Mode management and the dependencies to
Basic Software Mode management, which are closely related.
The Basic Software Modemanager is the central mode management module in
AUTOSAR R4.0. It is configurable to a high degree. How this configuration can be
achieved is the topic of chapter 3.
Chapter 4 than deals with migration strategies from fixed ECU Management as it was
used in AUTOSAR R3.1 1 to the new approach of ECU management of AUTOSAR 4.0
1
and in R4.0 with the ECU Statemanager with fixed state machine[1]
AbstractProvidedPortPrototype AbstractRequiredPortPrototype
«atpVariation» Tags:
vh.latestBindingTime =
preCompileTime
«atpVariation,atpSplitable»
+providedInterface
+requiredInterface
«atpVariation» Tags:
vh.latestBindingTime =
preCompileTime
+event * +runnable 0..*
AbstractEvent AtpStructureElement
AtpStructureElement +startOnEvent ExecutableEntity
ModeSwitchInterface
RTEEvent RunnableEntity
0..1
«instanceRef»
+modeGroup 1
AtpPrototype
ModeDeclarationGroupPrototype
SwcModeSwitchEvent ModeSwitchedAckEvent
«isOfType» ModeDeclaration
«instanceRef»
1 1..2
+type {redefines atpType} +mode {ordered} +disabledMode 0..*
ARElement AtpStructureElement
+modeDeclaration
AtpBlueprint Identifiable
AtpBlueprintable «atpVariation» 1..* ModeDeclaration
AtpType
ModeDeclarationGroup
+initialMode
1
+enteredMode 1 +exitedMode 1
+modeTransition 0..*
AtpStructureElement
Referrable
ModeTransition
application mode manager application mode user basic software mode user basic software mode user
mode request mode switch mode request mode switch mode request mode switch
mode switch mode request port port
port port port port port port
Runtime Environment
System Services
Previous versions of the Basic Software Modules especially the ECU state manager
module have differentiated between ECU states and ECU modes. ECU modes were
longer lasting operational ECU states that were visible to applications i.e. starting
up, shutting down, going to sleep and waking up. The ECU Manager states were
generally continuous sequences of ECU Manager module operations terminated by
waiting until external conditions were fulfilled. Startup1, for example, contained all BSW
initialization before the OS was started and terminated when the OS returned control to
the ECU Manager module. With flexible ECU management the ECU state machine is
implemented as general modes under the control of the BSW Mode Manager module.
To overcame this terminology problem states are used only internally and are not visible
to the application. For interaction with the application the basic software has to use
modes.
+modeGroup 1
AtpPrototype
ModeDeclarationGroupPrototype
Mode requests are distributed on the way from the mode requester (Mode Arbitration
SWC or a generic SWC) to the mode manager. The mode managers on each ECU
then have to decide and initiate the local mode switch. Thus the arbitration result is
communicated only locally on each ECU using RTE mode switch mechanism.
For mode requests, the communication of modes works slightly differently as for
mode switches: without ModeDeclarationGroups.
The request of modes is done via standard SenderReceiverInterfaces. Contrarily
to ModeSwitchInterfaces the requested mode is not given by a ModeDeclara-
tionGroup but by a VariableDataPrototype that has to contain an enumeration.
This enumeration consists of a set which contains the modes that can be requested.
Mode requests can be distributed in the whole system. For application and vehicle
modes, the requests of the mode requester have to be distributed to all affected ECUs.
This implies a 1:n-connection between the mode requester and the mode Managers.
In AUTOSAR this is only possible with Sender-Receiver Communication. The mode
manager only requires the information about the requested mode and not the mode
switch from the mode requester. The mode manager has one Sender-Receiver port
for each mode requester. To actually transmit the signal, COM shall use a periodic
signal with signal timeout notification to RTE. The mode manager will use the data
element outdated event to release a mode request.
Currently AUTOSAR has a constraint that only local software components are allowed
to communicate with ServiceComponents. So it is not possible that a SoftwareCom-
ponent can request modes from a remote e.g Basic Software Mode Manager. To
overcome this limitation so called ServiceProxyComponentType were introduced
in AUTOSAR Release 4.0. Figure 2.4 depicts this concept.
ECU1 ECU2
Runtime Environment
System Services
Core1 Core2
The following paragraphs define the interface of the BswM in pseudo code.
...
<APPLICATION-PRIMITIVE-DATA-TYPE>
<SHORT-NAME>ENUM_ApplicationModes</SHORT-NAME>
<CATEGORY>VALUE</CATEGORY>
<SW-DATA-DEF-PROPS>
<SW-DATA-DEF-PROPS-VARIANTS>
<SW-DATA-DEF-PROPS-CONDITIONAL>
<COMPU-METHOD-REF DEST="COMPU-METHOD">ENUM_ApplicationModes_def</
COMPU-METHOD-REF>
</SW-DATA-DEF-PROPS-CONDITIONAL>
</SW-DATA-DEF-PROPS-VARIANTS>
</SW-DATA-DEF-PROPS>
</APPLICATION-PRIMITIVE-DATA-TYPE>
...
<COMPU-METHOD>
<SHORT-NAME>ENUM_ApplicationModes_def</SHORT-NAME>
<CATEGORY>TEXTTABLE</CATEGORY>
<COMPU-INTERNAL-TO-PHYS>
<COMPU-SCALES>
<COMPU-SCALE>
<LOWER-LIMIT INTERVAL-TYPE="CLOSED">0</LOWER-LIMIT>
<UPPER-LIMIT INTERVAL-TYPE="CLOSED">0</UPPER-LIMIT>
<COMPU-CONST>
<VT>ModeA</VT>
</COMPU-CONST>
</COMPU-SCALE>
<COMPU-SCALE>
<LOWER-LIMIT INTERVAL-TYPE="CLOSED">1</LOWER-LIMIT>
<UPPER-LIMIT INTERVAL-TYPE="CLOSED">1</UPPER-LIMIT>
<COMPU-CONST>
<VT>ModeB</VT>
</COMPU-CONST>
</COMPU-SCALE>
<COMPU-SCALE>
<LOWER-LIMIT INTERVAL-TYPE="CLOSED">2</LOWER-LIMIT>
<UPPER-LIMIT INTERVAL-TYPE="CLOSED">2</UPPER-LIMIT>
<COMPU-CONST>
<VT>ModeC</VT>
</COMPU-CONST>
</COMPU-SCALE>
</COMPU-SCALES>
</COMPU-INTERNAL-TO-PHYS>
</COMPU-METHOD>
Every mode request to the BswM has to be mapped to an restricted set of values,
which allows the integrator the define the arbitration rules.
The ECU modes can be set by BswM using the EcuM_SetState API.
Purpose: Via this interface BswM sets the current state of the EcuM.
Signature: EcuM_SetState(EcuM_StateType State)
Modes: modeGroup EcuM_StateType {
ECUM_STATE_STARTUP,
ECUM_STATE_APP_RUN,
ECUM_STATE_APP_POST_RUN,
ECUM_STATE_SHUTDOWN,
ECUM_STATE_SLEEP
}
In the BswM configuration, the mode request sources have to be defined. The fol-
lowing ModeRequestPorts are implicitly defined by API of the BswM. This subsection
summarizes the port interface.
The following ModeDeclarationGroups are defined in the particular SWS docu-
ments of the AUTOSAR specification as C-Enums. Nevertheless they are referenced
here in form of BswM configurations which act as a base for the rest of this document.
Refer to the definition of C-Enums in the SWS documents for the definition of modes.
3.2.2.2.1 BswMComMIndication
3.2.2.2.2 BswMComMPncRequest
3.2.2.2.3 BswMDcmComModeRequest
3.2.2.2.4 BswMCanSMIndication
3.2.2.2.5 BswMEthSMIndication
3.2.2.2.6 BswMFrSMIndication
3.2.2.2.7 BswMLinSMIndication
Note: This ModeRequestSource has to be created once for each Lin chan-
nel.
3.2.2.2.8 BswMEcuMRequestedState
Purpose: Via this interface EcuM requests a state from BswM based on the
result of the RUN Request Protocol.
Signature: BswM_EcuM_RequestState(
EcuM_StateType State,
EcuM_RunStatusType CurrentStatus)
Modes: modeGroup EcuM_StateType {
ECUM_STATE_APP_RUN,
ECUM_STATE_APP_POST_RUN
}
Parameter: EcuM_RunStatusType {
ECUM_RUNSTATUS_UNKNOWN,
ECUM_RUNSTATUS_REQUESTED,
ECUM_RUNSTATUS_RELEASED
}
3.2.2.2.9 BswMEcuMCurrentState
3.2.2.2.10 BswMEcuMIndication
Purpose: Function called by the ECUM with fixed state machine to indicate its
current state.
Signature: void BswM_EcuM_CurrentState(
EcuM_StateType CurrentState
)
Modes: modeGroup EcuM_StateType
3.2.2.2.11 BswMEcuMWakeupSource
Purpose: Function called by the ECUM to indicate the current state of the
wakeup sources.
Signature: void BswM_EcuM_CurrentWakeup(
EcuM_WakeupSourceType source,
EcuM_WakeupStatusType state
)
Modes: modeGroup EcuM_WakeupStatusType
3.2.2.2.12 BswMLinScheduleIndication
Modes: The reported modes depend on the configured schedules in the Lin
Statemanager.
Example: request LinScheduleIndication LinSM1_CurrentSchedule {
processing IMMEDIATE
initialValue TBD
source MyLinSM.LinSMChannel
}
3.2.2.2.13 BswMLinTpModeRequest
3.2.2.2.14 BswMNvMJobModeIndication
Purpose: Indicates the current status of the multiblock job. The job is iden-
tified via BswMNvmService, e.g. 0x0c for NvmReadAll, 0x0d for
NvmWriteAll.
Signature: void BswM_NvM_CurrentJobMode(
uint8 ServiceId,
NvM_RequestResultType CurrentJobMode
)
Modes: modeGroup NvM_RequestResultType
3.2.2.2.15 BswMNvMRequest
Purpose: Via this Mode Request Source the NvM indicates the current status
of the specified block.
Signature: void BswM_NvM_CurrentBlockMode(
NvM_BlockIdType Block,
NvM_RequestResultType CurrentBlockMode
)
Modes: modeGroup NvM_RequestResultType
3.2.2.2.16 BswMJ1939NmIndication
3.2.2.2.17 BswMWdgMRequestPartitionReset
3.2.2.2.18 BswMJ1939DcmBroadcastStatus
Note: This is a notification of the desired broadcast status per network, trig-
gered via DM13.
Besides the interface, which is defined by the standardized interface of the BswM,
additional mode request ports can be defined via the configuration parameters.
E.g it is necessary for the interaction with applications, that an application software
component at least notifies the BswM about it’s current state. This can be achieved by
definition of a ModeRequestPort as shown in Listing 3.4. The BswM will than create
a corresponding RPort typed by a SenderReceiverInterface.
Listing 3.4: Application ModeRequestPort
request SwcModeRequest App1ModeRequest {
source MSIF_ApplicationModes.appMode
processing IMMEDIATE
initialValue ModeA
}
Listing 3.5 shows the declaration of a mode notification port. Note that in contrast
to 3.4 the BswM will generate a RPort typed by a ModeSwitchInterface in this
case. The BswM then gets informed via a ModeSwitchNotification if the mode
manager initiates a mode switch.
Listing 3.6: BasicSoftwareModeNotification
request BswModeNotification EcuMode {
source MSIF_EcuMode.ecuMode
processing IMMEDIATE
initialValue ECU_STARTUP_ONE
}
Listing 3.6 shows the declaration of a mode notification port. If such a port is config-
ured, the BswM configuration tool will create a requiredModeGroup ModeDecla-
rationGroupPrototype, so that the BswM gets informed of mode switches via the
Schedule Manager, if the corresponding mode manager initiates a mode switch with a
call to SchM_Switch API.
The behavior of the BswM is specified via rules and action lists. A rule is a logical ex-
pression, which combines the current values of ModeRequestPorts. The evaluation
of each rule either results in the execution of its true or false action lists.
The ModeControlContainer contains these ActionLists. An ActionList can
consist of a set of atomic actions, other “nested” ActionLists or it can reference
(nested) rules which are then evaluated in the context of this Actionlist.
The following example shows a simple rule, which activates the IPDU Groups
of a dedicated CAN channel. According to this rule, the BswM has to pro-
vide a ModeRequestPort of type CanSMIndication named Can1_Indication.
This is a ModeRequest from a basic software module in this case from the
Can State manager. In code this ModeRequestPorts corresponds to the API
BswM_CanSM_CurrentState as described in [SWS_BswM_00049] in [5]. The
source parameter identifies the network to which this ModeRequestSourcePort
belongs to. It’s up to the configuration tool of the BswM to allocate the right parameters
for the API corresponding to the referenced ECUC Container.
The value of the ModeRequestSourcePort initially is
CAN_SM_BswM_NO_COMMUNICATION.
processing immediate means that every evaluation rule, which refers to this Mod-
eRequestSourcePort shall immediately be processed. Every immediate mode re-
quest will trigger the evaluation of the referring rules. If this parameter would be de-
ferred in case of a mode request, the evaluation of rules would be delayed until the next
run of the main function of the BSWM. The BSWM does not support queued evaluation
of deferred mode requests. As a result, deferred mode requests will have "last-is-best"
semantics. Only the last mode request made before the execution of the BSWM’S
main function will be used.
The following example shows an arbitration rule called canIPDUActivation. The
overall content is rather self explanatory. The initial parameters specifies that the
initial result of the rule evaluation is false.
Listing 3.8: Example for a rule
rule checkApp1Request initially false {
if ( App1ModeRequest == MDG_ApplicationModes.ModeA && EcuMode ==
MDG_EcuMode.ECU_RUN) {
actionlist checkApp1RequestTrueActions
}
}
At which point in time a rule is executed, after an event has occurred depends on
the parameter BswMActionListExecution. Either it is executed every time the
rule is evaluated with the corresponding result, or only when the evaluation result has
changed from the previous evaluation. This is called triggered respectively condi-
tional execution.
Table 3.1 gives an overview in which situations an ActionList is executed or not.
Triggered ActionLists are executed (triggered) if the result of the rule evaluation
changes. Conditional ActionLists depend only on the current result (condition) of
the evaluation independent if it has changed or not.
eval. result false ->
true -> true true -> false false -> true
(old) -> (new) false
TRIGGERED/
TrueActionList CONDITION - -
CONDITION
TRIGGERED/
FalseActionList - CONDITION -
CONDITION
ECU Mode Handling is introduced with AUTOSAR 4.2.1 in BSW modules ECU State
Manager with flexible state machine and BSW Mode Manager. ECU State Manager
provides a common interface to SW-Cs to request and release the Modes RUN and
POST_RUN.
The ECU State Manager (EcuM) does not contain an own state machine. It shall
receive state notifications from BswM and propagate these to the RTE.
The following API is provided for ECU Mode Handling:
Purpose: Via this interface EcuM notifies BswM about the current Mode of ECU
Mode.
Modes: modeGroup EcuM_StateType {
ECUM_STATE_STARTUP,
ECUM_STATE_APP_RUN,
ECUM_STATE_APP_POST_RUN,
ECUM_STATE_SHUTDOWN,
ECUM_STATE_SLEEP
}
3.3.1.1 Startup
The Mode STARTUP is applied during startup of RTE. After all drivers are initialized,
the RUN Mode is set:
rule SwitchToStartup initially false {
if (EcuMode == ECUM_STARTUP) {
actionlist SwitchToStartup
}
}
custom "Rte_Start()"
custom "EcuM_DriverInitListThree()"
custom "ComM_CommunicationAllowed(TRUE)"
custom "EcuM_SetState(ECUM_STATE_APP_RUN)"
}
3.3.1.2 Running
When all EcuM users have released the RUN Mode, EcuM sets the RUNRequested
Mode to RELEASED.
Rule SwitchToPostRun initially false {
if (EcuM_CurrentState==RUN && RUNRequested == RELEASED) {
actionlist SwitchToPostRun
}
}
SWCs can request RUN Mode during POST_RUN. The following BswM rule switches
back to RUN Mode in case at least one EcuM user has requested the RUN Mode.
rule SwitchBackToRunMode initially false {
if (EcuM_CurrentState==POST_RUN && RUNRequested == REQUESTED &&
POSTRUNRequested == RELEASED) {
actionlist SwitchBackToRunMode
}
The BswM rules below illustrate only the switch to SLEEP Mode.
rule SwitchToShutdownMode initially false {
if (EcuM_CurrentState==POST_RUN && RUNRequested == RELEASED &&
POSTRUNRequested == RELEASED) {
actionlist SwitchToShutdownMode
}
Note that further BswM rules are needed for a complete running system.
3.3.2 Startup
The ECUM starts the operating system and afterwards its post OS se-
quence starts the Schedule Manager (SchM_Start()), initializes the BswM
(BswM_Init()) and afterwards finishes the initilization of the SchM (SchM_Init()
and SchM_StartTiming()). The BswM after its initialization has to take care, that
all necessary init routines of the basic software modules are called and that the RTE is
started (First Rte_Start(), then Rte_Init() and at last Rte_StartTiming()).
In this scenario it is expected that the BswM has the following providedModeGroup.
The purpose of this modeGroup is to track the current state/mode of the ECU similar
to the states of the ECU State manager in previous AUTOSAR releases.
Rule InitBlockII specifies the initialization of basic drivers to access the NVRAM
and initiates NvM_ReadAll. As the EcuMode source has the processing attribute set
to DEFERRED this rule will be evaluated every time the main function of the BswM is
called. After the first run it sets the EcuMode to ECU_STARTUP_TWO so that the action
list will never be invoked again.
If the NvMReadAll job is finsihed the NvMReadAllFinished rule is triggered, which
initiates the remaining initialization and switches the EcuMode to ECU_RUN.
Listing 3.10: Rules and ActionLists for Startup
rule InitBlockII initially false {
if ( EcuMode == MDG_EcuMode.ECU_STARTUP_ONE ) {
actionlist InitBlockIIActions
}
}
custom "LinSM_Init(null)"
custom "LinTp_Init(null)"
custom "Fr_Init(null)"
custom "FrIf_Init(null)"
custom "FrSM_Init(null)"
custom "FrTp_Init(null)"
custom "PduR_Init(null)"
custom "CANNM_Init(null)"
custom "FrNM_Init(null)"
custom "NmIf_Init(null)"
custom "IpduM_Init(null)"
custom "COM_Init(null)"
custom "DCM_Init(null)"
custom "ComM_Init(null)"
custom "DEM_Init(null)"
custom "StartRte()"
SchMSwitch EcuMode : ECU_RUN
}
In order to ensure that the RTE is properly initialized before runnables in service mod-
ules call RTE API functions, those runnables can be disabled by a mode disabling de-
pendency deactivating the runnable in all modes except EcuM mode RUN. For server
runnables - which cannot be disabled - the Rte will ignore incoming client server re-
quests as long as it is not initialized.
When the RTE is started the runnables will be started. Now it is up to the applica-
tion to keep the ECU running. To achieve this the BswM can for example provide a
ModeRequestPort as depicted in example 3.4. For the further reading is is expected,
that the application software requests the mode APP1_ACTIVE from the BswM. If this
mode is requested the BswM shall not shutdown the ECU.
Listing 3.11: Application runs, enable communication
rule checkApp1Request initially false {
if ( App1ModeRequest == MDG_ApplicationModes.ModeA && EcuMode ==
MDG_EcuMode.ECU_RUN) {
actionlist checkApp1RequestTrueActions
}
}
3.3.3 Run
As the BswM is a highly flexible module it depends to a high extend to the integrator,
how it is determined if an ECU shall shut down or not. Many different variants are con-
ceivable. This document proposes an approach, which is quite similar to the concept
of the ECUM in AUTOSAR R3.1. The general concept is, that a ECU keeps running as
long as at least one application software component requests the run state.
The information if an application can be shut down in a certain mode has to be pro-
vided by the software component developer. Example 3.12 shows a simplified rule for
an ECU with one software component. If switches its mode to INACTIVE the BswM
initiates the shutdown sequence.
Listing 3.12: Initiate shutdown, if no application wants to run any more
rule checkApp1Request initially false {
if ( App1ModeRequest == MDG_ApplicationModes.APP_INACTIVE && EcuMode ==
MDG_EcuMode.ECU_RUN) {
actionlist checkApp1RequestActions
}
}
3.3.4 Shutdown
In state ECU_APP_POST_RUN the BswM waits until all channels report, that no requests
are pending any more. The rule in listing 3.12 is triggered every time the mode of a
ComM channel changes. If there are mmultiple ComM channels, they have to be
combined to a single expression.
Listing 3.13: Shutdown sequence
rule InitiateShutdown initially false {
if ( ComM_Mode_Channel1 == COMM_NO_COM_REQUEST_PENDING && EcuMode ==
MDG_EcuMode.ECU_APP_POST_RUN) {
actionlist InitiateShutdownActions
}
}
Note that the in the configuration of the ECUM the module id of the BswM has to be
added as a valid user to EcuMFlexUserConfig.
3.3.5 Sleep
Entering a sleep state is similar to the shutdown sequence 3.12 except that
EcuM_GoHalt resp. EcuM_GoPoll is called instead of EcuM_GoDown.
3.3.6 Wakeup
Example 3.14 shows a rule which starts the ECU only, if a certain wakeup event, iden-
tified by EcuM_WakeupSource has occured. Otherwise the ECU will be immediately
shut down.
Listing 3.14: start sequence with wakeup check
rule InitBlockII initially false {
if ( EcuMode == MDG_EcuMode.ECU_STARTUP_ONE && EcuM_WakeupSource ==
ECUM_WKSTATUS_VALIDATED) {
actionlist InitBlockIITrueActions
} else {
actionlist InitBlockIIFalseActions
}
}
In the case that an error occurred in a particular partition and it has to be restarted,
the BSW Modules which are partitioned to the partition have to be reinitialized. In
order to determine the partition which has been restarted, the Mode Request Source
BswMPartitionRestarted can be utilized.
• AUTOSAR COM
Besides the initialization of the communication stack the BswM can be configured to
initialize further modules or execute customs actions depending on the ECU’s needs.
Due to the flexibility of the BswM it is also possible, that after a wake up event only a
part of the communication stack is started.
Analogue to Startup, it is possible to configure additional actions to be executed on
shutdown.
For the I-PDU group switching it is expected that there exists for each channel a dedi-
cated I-PDU group for outgoing and incoming I-PDUs in COM. AUTOSAR COM takes
care that an I-PDU is active(started) if at least one I-PDU group containing this I-PDU
is active.
To illustrate how the I-PDUs of an ECU can be managed the following scenario is
created. The examplary ECU shall have two CAN channels and three partial networks.
The mode request ports for the channels are named CanSM_Can1 and CanSM_Can2,
the request sources for the partial networks are named PNC1, PNC2 and PNC3.
I-PDUs of PNC1 shall be communicated only over Channel1. I-PDUs of PNC3 shall
be communicated over Channel1 and Channel2. I-PDUs of PNC3 shall be commu-
nicated only over Channel2.
In case of an indication by a bus state manager the BswM shall check, which partial
networks are requested.
Listing 3.16: Active wakeup on channel
rule activeWakeupChannel1 initially false {
if ( CanSM_Can1 == CANSM_BSWM_FULL_COMMUNICATION) {
actionlist activeWakeupChannel1Actions
}
}
PNC3 != PNC_REQUESTED
) {
actionlist activeWakeupChannel2Actions
}
}
If a bus state manager reports that the bus is going silent the BswM stop the corre-
sponding I-PDU groups. If the channel is part of a partial network the whole partial
network has to be stopped.
Listing 3.17: CanSM reports SILENT_COMMUNICATION or NO_COMMUNICATION
rule stopComChannel1 initially false {
if ( CanSM_Can1 == CANSM_BSWM_SILENT_COMMUNICATION ||
CanSM_Can1 == CANSM_BSWM_NO_COMMUNICATION
) {
actionlist stopComChannel1Actions
}
}
In case that a single partial network is going down the IPDU group representing this
network has to be switched off.
Listing 3.18: PNC reports NO_COMMUNICATION
rule pnc1nocom initially false {
if ( PNC1 == PNC_NO_COMMUNICATION ) {
actionlist pnc1nocomTrueActions
}
}
}
rule pnc3nocom initially false {
if ( PNC3 == PNC_NO_COMMUNICATION ) {
actionlist pnc3nocomActions
}
}
In case of an indication that the partial network statemachine has switched to the pre-
pare sleep state only the deadline monitoring of the corresponding IPDU groups shall
be turned off but the IPDUs are still transmitted until the state PNC_OFF is reached.
Listing 3.20: PNC reports PNC_PREPARE_SLEEP
rule pnc1preparesleep initially false {
if (PNC1 == PNC_PREPARE_SLEEP)
{
actionlist pnc1preparesleepActions
}
}
In contrast to current AUTOSAR network management, the task of J1939 network man-
agement is not to handle sleep and wake-up of ECUs, but to assign unique addresses
to each node represented by an ECU.
This is achieved by sending the AddressClaimed (AC, 0x0EE00) parameter group at
start-up, which announces the desired address. If another node claims the same ad-
dress, and has higher priority, the node has to go silent after sending the Cannot-
ClaimAddress parameter group (AC with null address as SA), or try to use another
address.
To support this use case the BswM is extended to accept state change indications from
the J1939Nm via the API function BswM_J1939Nm_StateChangeNotification()
(see also 3.2.2.2.16).
Depending on the state indicated by the network management the BswM needs to
switch ComIPduGroups of COM, PduRRoutingPathGroups of PduR, and general re-
quest handling of the J1939Rm.
The first two actions are realized via BswMPduGroupSwitch- and
BswMPduRouterControl -actions. The J1939 Request Manager shall be switched
using the BswMJ1939Rm action.
COM is expected to have IPDU groups containing all locally received and transmitted
I-PDUs for each network. The PduR shall be configured in the same way, having
RoutingPathGroups for all locally received and transmitted IPDUs for each channel,
excluding the received I-PDU for the Request message forwarded to the J1939Rm.
The BswM must then be configured to switch on and off the aforementioned IPDU
groups and PduRRoutingPathGroups depending on the reported NM states, as well as
general request handling of the J1939 Request Manager. The following rule shows the
actions of the BswM depending on the NM states. 2
Listing 3.21: Rule to implement network management according to J1939
rule J1939_nm_normal_operation initially false {
if ( J1939NmState == NM_STATE_NORMAL_OPERATION ) {
actionlist J1939NormalOperationActions
}
}
2
It is recommended to use the BswMJ1939Rm action instead of the custom calls. The custom calls
are only used in this listing as they are not supported in the current ARText version.
In addition to address assignment the BswM has also to supervise the sending of
broadcast messages in a J1939 environment. Each IPDU group represents the broad-
cast messages (J1939 PGs with PDU2 format PGN or PDU1 format PGN and broad-
cast destination address) of one network.
For this purpose it is also expected that COM contains one IPDU group for each chan-
nel, which contains the broadcast messages of this ECU.
Listing 3.22: Rule to implement broadcast management according to J1939
rule J1939_broadcast_management initially false {
if ( BswMJ1939DcmBroadcastStatus == NETWORK_ENABLED) {
actionlist J1939ActivateBroadcastActions
} else {
actionlist J1939DeactivateBroadcastActions
}
}
When implementing the Pretended Networking concept, the BswM should be user-
configured to support the mode management requirements. The following subchapters
contain recommendations regarding the BswM configuration for Pretended Network-
ing.
For the configuration of the activation of Pretended Networking the following aspects
have to be considered:
• The BswM should be configured to arbitrate the Mode Request. If there are
different ICOM Mode Requests received during the same arbitration cycle of the
BswM, the request with the lowest ICOM Configuration ID should be used.
if(IcomConfigId == 0) doActionList1;
if(IcomConfigId == 1) doActionList2;
//ignore all other IcomConfigIds
• BswM should be configured to stop all I-PDU groups for a channel to be switched
to Pretended Networking.
• BswM should be configured to request activation of Pretended Networking in
<bus>SM by calling <bus>SM_SetIcomConfiguration.
• BswM should be configured to handle a notification from <bus>SM (e.g. CanSm
calls Bswm_CanSm_CurrentIComConfiguration) if activation of Pretended Net-
working was successful. This can be performed by means of the ModeRequest-
Source "BswMCanSMIcomIndication".
• The BswM should notify the affected SWCs when an ICOM configuration has
been changed. In order to ensure this, the BswM should be configured to perform
mode switch indications.
• Errors in case of failures in changing the ICOM configuration should be con-
figured based on a sub state via a BswM action list. The error occured can
be accessed by evaluation of the BswMModeRequestSource "BswMCanSMIco-
mIndication".
For the configuration of the deactivation of Pretended Networking the following aspects
have to be considered:
• The BswM should be configured to start the I-PDU groups assigned to a channel
when Pretended Networking is deactivated for this channel.
The BswM is able to switch the schedule tables LIN channels based on requests from
Application SWCs.
The SWC requests a LIN schedule table from the BswM in form of an application mode.
After the successful switch the BswM switches to the requested mode.
In the following, an example for this behavior is shown. At first, a ModeDeclara-
tionGroup is needed which is used by the Application SWCs to request a certain
schedule to which the LIN channel shall be switched.
modeGroup MDG_LinScheduleTables {
Schedule1,
Schedule2
}
The following BswM rule switches the schedule table of a LIN channel when the appli-
cation SWC request another application mode.
rule LinChannel1Schedule1Request initially false {
if (LinChannel1ScheduleTableRequestPort == Schedule1)
{
LinScheduleSwitch(LinSchedule1)
}
}
The following BswM rule switches the application mode to the mode which was previ-
ously requested by the application. It is triggered when the LinSM notifies the BswM
that a LIN schedule table switch occurred.
rule LinChannel1Schedule1Switched initially false {
if (LinSM_CurrentState == LinSchedule1)
{
RteSwitch(LinScheduleMode, Schedule1)
}
}
And finally the corresponding rules for the LIN schedule table LinSchedule2:
rule LinChannel1Schedule2Request initially false {
if (LinChannel1ScheduleTableRequestPort == Schedule2)
{
LinScheduleSwitch(LinSchedule2)
}
}
rule LinChannel2Schedule1Switched initially false {
if (LinSM_CurrentState == Schedule2)
{
RteSwitch(LinScheduleMode, LinSchedule2)
}
}
3.5 Diagnostics
In AUTOSAR release 4.0.3 onwards the DCM is the overall mode manager for all di-
agnostic use cases. The BswM is responsible to change the state of the other basic
software modules accordingly.
The DCM acting as a mode manager can inform other BSW modules about the cur-
rent mode of the session control service and if needed set the basic software in the
corresponding mode. Listing 3.24 shows the corresponding mode switch interface.
Note that the same interface can also be used to inform the application software about
the current diagnostic session.
Listing 3.24: ModeRequestPort for session control service of the DCM
request BswModeNotification DiagnosticSessionControl {
source MSIF_DcmDiagnosticSessionControl.diagnosticSessionControl
processing IMMEDIATE
initialValue DefaultSession
}
In case of ECU Reset, the interaction between DCM and BswM is more complex. The
Specification of the Diagnostic Communication Manager [6] specifies for this purpose
the interface as described in listing 3.25. Via this interface the DCM signals the BswM
to
1. prepare the ECU to execute a specific reset.
2. to explicitly execute this reset.
Listing 3.25: Mode switch interface for ECU reset diagnostic service
modeGroup DcmEcuReset{
NONE,
HARD,
KEYONOFF,
SOFT,
JUMPTOBOOTLOADER,
JUMPTOSYSSUPPLIERBOOTLOADER ,
EXECUTE
}
[SWS_Dcm_00373] states that on reception of a request for UDS Service with the
sub functions other than enableRapidPowerShutDown (0x04) or disableRapidPower-
ShutDown (0x05), the DCM module shall switch the ModeDeclarationGroupPrototype
DcmEcuReset to the received resetType. After the mode switch is requested the DCM
triggers the start of the positive response message transmission.
According to [SWS_Dcm_00594] on the transmit confirmation (call to
Dcm_TpTxConfirmation) of the positive response, the DCM module shall trig-
ger the mode switch of ModeDeclarationGroupPrototype DcmEcuReset to
EXECUTE. By this final mode switch the DCM request the BswM to finally shutdown
the ECU and to to perform the reset.
Listing 3.26 depicts how the different reset scenarios specified in the DCM can be
configured in the DCM. Note that in the running example of this document the overall
EcuMode is used to signal to the DCM that the ECU is ready to be reset. Depending
on the diagnostic service the DCM shall wait for this acknowledgment or switch imme-
diately to the EXECUTE mode, which will cause the BswM to invoke EcuM_GoDown.
Listing 3.26: Ruleset to implement different reset scenarios
rule DcmEcuResetHard initially false {
if ( DcmEcuResetMode == DcmEcuReset.HARD) {
actionlist DcmEcuResetHardActions
}
}
}
rule DcmEcuResetSoft initially false {
if ( DcmEcuResetMode == DcmEcuReset.SOFT) {
actionlist DcmEcuResetSoftActions
}
}
}
rule DcmEcuResetBootLoader initially false {
if ( DcmEcuResetMode == DcmEcuReset.JUMPTOBOOTLOADER) {
actionlist DcmEcuResetBootLoaderActions
}
}
On reception of a request for UDS Service with the sub functions enableRapidPower-
Shutdown (0x04) or disableRapidPowerShutdown (0x05), the DCM module triggers the
If the DCM reports to the BswM that a specified communication control mode is en-
tered, the BswM has to enable resp. disable the corresponding IPDU groups as shown
in listing 3.28.
Listing 3.28: Ruleset for diagnostic communication control
rule communicationcontrol1 initially false on condition {
if (Dcm_Communication_Control_CAN1 == DCM_ENABLE_RX_TX_NORM )
{
actionlist communicationcontrol_DCM_ENABLE_RX_TX_NORM
}
}
}
//----------------------------------------------------------------
init true
enable ArMmExample.EcuC.MyCom.CAN1NMRXIPDUS, ArMmExample.EcuC.MyCom.
CAN1RXIPDUS
disable ArMmExample.EcuC.MyCom.CAN1NMTXIPDUS, ArMmExample.EcuC.MyCom.
CAN1TXIPDUS
}
}
//----------------------------------------------------------------
The Dcm will switch the current status of the Roe per configured Roe Event via a mode
switch of ModeDeclarationGroupPrototype DcmResponseOnEvent_<RoeEventID>
switching the mode to EVENT_STARTED, EVENT_STOPPED and EVENT_CLEARED.
The information is necessary mainly for applications that need to interact with the Dcm
if the events shall be triggered from external.
Listing 3.30: Mode switch interface for Roe Status
ModeGroup DcmResponseOnEvent_<RoeEventID> {
EVENT_STARTED,
EVENT_STOPPED,
EVENT_CLEARED
}
Startup up: After startup of the OS, each EcuM will hand over control to the partition
local BswM, which then takes care of the initialization of the other partition local BSW
Modules. Afterwards, the partition local BswM signals the readiness of the partition
to the other BswM instances running in other partitions. This signalling is done using
normal mode-communication between the BswM service components.
Shutdown: The partition local BswM determines via its ModeRequestSources, whether
it can be shut down or not. If this is the case, it signals its current state to the other
BswM instances running in other partitions. This signalling is done using normal mode-
communication between the BswM service components. The BswM placed inside the
partition of the Master EcuM can then decide on this information whether it initiates a
shutdown of the ECU.
Deinitialization: The BswM (on the partition where the Master EcuM is running inside)
can signal the other BswMs that it wants to shutdown the ECU. This signalling is done
using normal mode-communication between the BswM service components. The other
BwsMs can then deinitialize the modules running inside their partition in order to enable
a clean shutdown.
Restart of a partition: If a partition is restarted, the local BswM signals to the other
BswM instances that it is in a restart mode. This signalling is done using normal mode-
communication between the BswM service components. Then, the other BswMs can
determine if local applications need to be informed or potentially restarted, and how to
synchronize them to the newly started partition.
a mode request/indication which crosses a partition via the Rte (e.g. BswMSwcMod-
eRequest), the configurator does not need to take special considerations regarding
system stability or data consistency, the Rte handles the communication of this type
of cross-partition mode request/indication. However, if the cross-partition mode re-
quest/indication comes directly from a BSW module (e.g. BswMComMIndication) or
from a generic source (e.g. BswMGenericRequest), the configurator must take special
considerations, for example:
1. When the configurator uses memory protection, memory sections which are in-
volved in cross-partition mode requests/indications (e.g. BswM-internal status
flags) need to be configured to allow such cross-partition access.
2. Cross-partition Mode requests/indications which are configured with IMMEDIATE
processing may also trigger an immediately executed actionlist. The resultant
actions will be executed in the context of the caller (e.g. a BSW module in another
partition). For these IMMEDIATE cross-partition mode requests/indication, the
same issues as in chapter "Inter-partition Actions" also need to be considered.
4 Backward Compatibility
This chapter describes a setup to reuse software components (legacy SWCs), which
are designed to work with the “ECU State Manager (EcuM) with fixed state machine”
[1]. This means that a setup based on EcuM with flexible state machines and the
BswM is described described which emulates the behavior of the EcuM with a fixed
state machine.
An overview of the architectural solution is shown in Figure 4.1. To reuse software
components (legacy SWCs), which are designed to work with the "ECU State Manager
with fixed state machine" the option "ECU Mode Handling" has to be activated. A so
called Compatibility SWC is not necessary to realize this behavior.
SWC 1 SWC 2
EcuM User
RTE
EcuM Mode
EcuM_StateRequest
Rte_Switch_currentMode
EcuM BswM
BswM_EcuM_RequestedState
RUN
State
Request EcuM_SetState
Machine
Protocol
Figure 4.1: Default States in EcuM Flex make it possible to reuse legacy SWCs
Figure 4.2 depicts the behavioral aspects of the proposal. The small boxes represent
the states of fixed EcuM. The green boxes mark the phases of the EcuM flexible. Ap-
plication software will only notice changes during the UP phase.
The result is that all states of the fixed EcuM in the UP phase have to be emulated using
the BswM and the software component introduced for this scenario. This software
component has to map modes reported by the BswM to modes defined in the interface
of the EcuM with fixed statemachine.
4.1.1 Startup
During startup phase the same BSW modules shall be initialized as the fixed EcuM
does. This is implemented via BswM rules which are executed after initialization of
EcuM and initialize these modules. The modules which are already initialized by flexible
EcuM are omitted by BswM.
The changed BswM rules can be seen in Listing 4.1.
Listing 4.1: BswM configuration for fixed EcuM compatible startup
rule InitBlockII initially false {
if ( EcuMode == MDG_EcuMode.ECU_STARTUP_ONE ) {
actionlist InitBlockIITrueActions
}
}
custom "LinSM_Init(null)"
custom "LinTp_Init(null)"
custom "FrTrcv_Init(null)"
custom "Fr_Init(null)"
custom "FrIf_Init(null)"
custom "FrSM_Init(null)"
custom "FrTp_Init(null)"
custom "PduR_Init(null)"
custom "CANNM_Init(null)"
custom "FrNM_Init(null)"
custom "NmIf_Init(null)"
custom "IpduM_Init(null)"
custom "COM_Init(null)"
custom "DCM_Init(null)"
custom "StartRte()"
custom "ComM_Init(null)"
custom "DEM_Init(null)"
custom "FIM_Init(null)"
custom "EcuM_SetState(ECU_RUN)"
}
4.1.2 Shutdown
For that shutdown mechanism the BswM configuration of Listing 4.2 is responsible. The
listed rules coordinate the post-run phase, deinitialize the modules and put the ECU
into shut down or sleep. These rules execute the same callouts EcuM_On<Mode>() as
it would happen with a fixed EcuM.
Listing 4.2: BswM configuration for fixed EcuM compatible shutdown
rule checkEcuMCompatibilityModeRequest initially false {
if ( EcuMode == MDG_EcuMode.ECU_APP_RUN) {
actionlist checkEcuMCompatibilityModeRequestActions
}
}
4.1.3 Wakeup
The functionality for correct wakeup from sleep mode has to be fully configured in the
BswM. But as it does not need any adjustments for backward compatibility, there are
no modifications to be done.