Autosar Sws Combasedtransformer
Autosar Sws Combasedtransformer
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 and functional overview 5
3 Related documentation 7
3.1 Input documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.2 Related standards and norms . . . . . . . . . . . . . . . . . . . . . . . 8
3.3 Related specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
4 Constraints and assumptions 9
4.1 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2 Applicability to car domains . . . . . . . . . . . . . . . . . . . . . . . . 9
5 Dependencies to other modules 10
5.1 File structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
5.1.1 Code file structure . . . . . . . . . . . . . . . . . . . . . . . . 10
6 Requirements Tracing 11
7 Functional specification 12
7.1 Specification of the COM Based Transformer . . . . . . . . . . . . . . 15
7.2 Error classification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
7.2.1 Development Errors . . . . . . . . . . . . . . . . . . . . . . . 18
7.2.2 Runtime Errors . . . . . . . . . . . . . . . . . . . . . . . . . . 18
7.2.3 Transient Faults . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.2.4 Production Errors . . . . . . . . . . . . . . . . . . . . . . . . 19
7.2.5 Extended Production Errors . . . . . . . . . . . . . . . . . . . 19
8 API specification 20
8.1 Imported types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
8.2 Type definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
8.3 Function definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
8.3.1 ComXf_<transformerId> . . . . . . . . . . . . . . . . . . . . . 20
8.3.2 ComXf_Inv_<transformerId> . . . . . . . . . . . . . . . . . . 22
8.3.3 ComXf_Init . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
8.3.4 ComXf_DeInit . . . . . . . . . . . . . . . . . . . . . . . . . . 23
8.3.5 ComXf_GetVersionInfo . . . . . . . . . . . . . . . . . . . . . 24
8.4 Callback notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
8.5 Scheduled functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
8.6 Expected interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
9 Sequence diagrams 25
10 Configuration specification 26
3 Related documentation
References
[1] Glossary
AUTOSAR_TR_Glossary
[2] General Specification on Transformers
AUTOSAR_ASWS_TransformerGeneral
[3] Specification of RTE Software
AUTOSAR_SWS_RTE
[4] Specification of Communication
AUTOSAR_SWS_COM
[5] General Requirements on Basic Software Modules
AUTOSAR_SRS_BSWGeneral
[6] Requirements on Transformer
AUTOSAR_SRS_Transformer
[7] System Template
AUTOSAR_TPS_SystemTemplate
[8] General Specification of Basic Software Modules
AUTOSAR_SWS_BSWGeneral
4.1 Limitations
For the COM Based Transformer all general transformer limitations (see [2]) apply.
Additionally the following restrictions apply for the COM Based Transformer:
[SWS_ComXf_00017] d The COM Based Transformer does not support Client-Server
communication. c(SRS_Xfrm_00201)
[SWS_ComXf_00032] d The COM Based Transformer does not support external trig-
ger communication. c(SRS_Xfrm_00201)
[SWS_ComXf_00018] d The COM Based Transformer only supports composite data
types (i.e. Signal Groups from COM). c(SRS_Xfrm_00201)
[SWS_ComXf_00019] d The COM Based Transformer only supports fix sized data
types. c(SRS_Xfrm_00201)
[SWS_ComXf_00022] d The COM Based Transformer only supports signal groups
which are byte aligned. c(SRS_Xfrm_00201)
[SWS_ComXf_00023] d The COM Based Transformer shall support signal group
where all group signals are mapped successively (possibly with gaps where posi-
tions in the signal group layout have no corresponding signal defined) to the IPdu.
c(SRS_Xfrm_00201)
6 Requirements Tracing
The following table references the features specified in [5] and [6] and links to the
fulfillments of these.
Feature Description Satisfied by
[SRS_BSW_00159] All modules of the [SWS_ComXf_00025]
AUTOSAR Basic Software
shall support a tool based
configuration
[SRS_BSW_00337] Classification of [SWS_ComXf_00028]
development errors
[SRS_BSW_00404] BSW Modules shall support [SWS_ComXf_00030]
post-build configuration
[SRS_BSW_00407] Each BSW module shall [SWS_ComXf_00024] [SWS_ComXf_00026]
provide a function to read [SWS_ComXf_00027]
out the version information
of a dedicated module
implementation
[SRS_BSW_00411] All AUTOSAR Basic [SWS_ComXf_00024] [SWS_ComXf_00026]
Software Modules shall [SWS_ComXf_00027]
apply a naming rule for
enabling/disabling the
existence of the API
[SRS_BSW_00441] Naming convention for type, [SWS_ComXf_00030]
macro and function
[SRS_Xfrm_00009] A fixed set of transformer [SWS_ComXf_00003]
classes shall exist
[SRS_Xfrm_00011] A transformer shall belong [SWS_ComXf_00003] [SWS_ComXf_00006]
to a specific transformer
class
[SRS_Xfrm_00201] The COM Based [SWS_ComXf_00004] [SWS_ComXf_00005]
Transformer shall define the [SWS_ComXf_00007] [SWS_ComXf_00008]
serialization of atomic and [SWS_ComXf_00009] [SWS_ComXf_00010]
structured data elements [SWS_ComXf_00011] [SWS_ComXf_00012]
into linear arrays based on [SWS_ComXf_00013] [SWS_ComXf_00015]
a fixed data mapping [SWS_ComXf_00016] [SWS_ComXf_00017]
[SWS_ComXf_00018] [SWS_ComXf_00019]
[SWS_ComXf_00020] [SWS_ComXf_00021]
[SWS_ComXf_00022] [SWS_ComXf_00023]
[SWS_ComXf_00032] [SWS_ComXf_00035]
[SWS_ComXf_00036]
[SRS_Xfrm_00202] The COM Based [SWS_ComXf_00005] [SWS_ComXf_00020]
Transformer shall take its [SWS_ComXf_00025] [SWS_ComXf_00031]
configuration from the COM [SWS_ComXf_00033] [SWS_ComXf_00034]
module [SWS_ComXf_00036]
7 Functional specification
When a SWC initiates an inter-ECU communication which is configured to be trans-
formed, the SWC hands the data over to the RTE. The RTE executes the configured
transformer chain which contains - if the configuration demands this - the COM Based
Transformer.
Application SWC
1. Rte_Write_a {x,y,z}
3. Further Transformers
add information
4. one large
crc x y z hash byte array
RTE
5. One call to Com_SendSignalGroupArray()
Signal
Signal Group X Signal B Signal IPdu
A
Array representation
CRC SC D D D D
enhanced by
1 2 3 4 E2E Transformer
Array representation
CRC SC D D D D
result of
1 2 3 4 COM Based Transformer
Array representation
D D D D
filled by
1 2 3 4 COM Based Transformer
The handling of the data inside COM’s IPdu buffer and the transformer buffer is shown
in figure 7.2.
The ISignalIPdu is handled by the COM module as ComIPdu and may contain
several parts (signals and signal groups). A signal group in COM is represented by the
ComSignalGroup container.
In the System Template [7] it is possible to define that a signal group shall be handled by
the COM Based Transformer. The usage of the COM Based Transformer for a specific
transformer chain is defined by the reference comBasedSignalGroupTransforma-
tion from the ISignalGroup to DataTransformation (see figure 7.3).
FibexElement Identifiable
+dataTransformation
ISignal DataTransformation
«atpVariation,atpSplitable»
+ dataTypePolicy: DataTypePolicyEnum 0..1
+ iSignalType: ISignalTypeEnum [0..1]
+ length: Integer
0..1 +comBasedSignalGroupTransformation
0..*
+iSignal
«atpVariation,atpSplitable»
+networkRepresentationProps 0..1
«atpVariation» FibexElement
SwDataDefProps ISignalGroup
+physicalProps 0..1
+systemSignalGroup 1
ARElement +systemSignal ARElement
+systemSignal SystemSignal SystemSignalGroup
*
1 + dynamicLength: Boolean
+transformingSystemSignal
0..1
In the Ecu configuration of the COM module such ComSignalGroups have a Com-
SignalGroupArrayAccess=true parameter defined.
If the ComSignalGroupArrayAccess=true then it implicitly defines the length of
the signal group ([SWS_Com_00845] [4]) and the start position inside the ComIPdu
where the signal group starts ([SWS_Com_00844] [4]). Thus there can be several
signals and signal groups defined inside an ISignalIPdu (e.g. ’Signal A’ and ’Signal
B’ are part of the IPdu but are not considered by the COM Based Transformer for the
’Signal Group X’).
The Com APIs Com_SendSignalGroupArray and
Com_ReceiveSignalGroupArray handle the signal group as array represen-
tation based on length of the signal group and the start position inside the ComIPdu.
This array representation contains all signals that belong to the signal group,
regardless whether the application software has a data mapping defined or not.
As an example in figure 7.2 the ’Signal Group X’ consists of the signals ’M’, ’CRC’, ’SC’,
’D1’, ’D2’, ’D3’, and ’D4’. Thus the RTE will interact with COM based on the whole array
representation of this signal group with length of the signal group.
When the RTE interacts with the COM Based Transformer also all the other poten-
tial transformers need to be considered in order to determine which part of the array
representation of the signal group actually is provided to each transformer since each
transformer may add data during sending (or remove data during reception).
E.g. the part of the array representation which holds the ’CRC’ and ’SC’ signals are
handled by the E2E transformer but will not be considered by the COM Based Trans-
former. The ’M’ signal will neither be handled by the E2E transformer nor the COM
Based Transformer. For ’M’ a further transformer is responsible.
The RTE will provide the data buffer from the ’Start of data with DataMapping defined’
location to the COM Based Transformer.
IPdu unused area IPdu unused area IPdu unused area IPdu Unused
default default default
0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 0 1 Areas Default
[SWS_ComXf_00020] d The COM Based Transformer shall place the serialized data
element into the data buffer at the bit position according to the configuration of the
ISignalGroup in Com. c(SRS_Xfrm_00201, SRS_Xfrm_00202)
[SWS_ComXf_00013] d To allow migration, the deserialization shall be able to accept
larger array representations and ignore dataElements appended at the end of a previ-
ously known parameter list. c(SRS_Xfrm_00201)
This means: data elements that were not defined in the interface specification used to
generate or parameterize the deserialization code at the end of the serialized data will
be ignored by the deserialization.
- AUTOSAR Confidential -
Class TransformationTechnology
Package M2::AUTOSARTemplates::SystemTemplate::Transformer
Note A TransformationTechnology is a transformer inside a transformer chain.
Tags: xml.namePlural=TRANSFORMATION-TECHNOLOGIES
Base ARObject, Identifiable, MultilanguageReferrable, Referrable
Attribute Type Mul. Kind Note
bufferProperties BufferProperties 1 aggr Aggregation of the mandatory BufferProperties.
hasInternal Boolean 0..1 attr This attribute defines whether the Transformer has an
State internal state or not.
needsOriginal Boolean 0..1 attr Specifies whether this transformer gets access to the
Data SWC’s original data.
protocol String 1 attr Specifies the protocol that is implemented by this
transformer.
transformation Transformation 0..1 aggr A transformer can be configured with transformer specific
Description Description parameters which are represented by the Transformer
Description.
Stereotypes: atpVariation
Tags: vh.latestBindingTime=postBuild
transformer TransformerClassEnum 1 attr Specifies to which transformer class this transformer
Class belongs.
version String 1 attr Version of the implemented protocol.
Enumeration TransformerClassEnum
Package M2::AUTOSARTemplates::SystemTemplate::Transformer
Note Specifies the transformer class of a transformer.
Literal Description
custom The transformer is a custom transformer.
Tags: atp.EnumerationValue=0
safety The transformer is a safety transformer.
Tags: atp.EnumerationValue=1
security The transformer is a security transformer.
Tags: atp.EnumerationValue=2
serializer The transformer is a serializing transformer.
Tags: atp.EnumerationValue=3
Class BufferProperties
Package M2::AUTOSARTemplates::SystemTemplate::Transformer
Note Configuration of the buffer properties the transformer needs to work.
Base ARObject
Attribute Type Mul. Kind Note
buffer CompuScale 0..1 aggr If the transformer changes the size of the data, the
Computation CompuScale can be used to specify a rule to derive the
size of the output data based on the size of the input data.
5
4
Class BufferProperties
headerLength Integer 1 attr Defines the length of the header (in bits) this transformer
will add in front of the data.
inPlace Boolean 1 attr If set, the transformer uses the input buffer as output
buffer.
Table 7.3: BufferProperties
[SWS_ComXf_00028] Development Errors d The errors shown in table 7.5 are de-
fined as development errors for the COM Based Transformer. c(SRS_BSW_00337)
No extended production errors are specified for the COM Based Transformer.
8 API specification
[SWS_ComXf_00030] d
Name: ComXf_ConfigType
Type: Structure
Element: implementation –
specific
Description: This is the type of the data structure containing the initialization data for the
transformer.
Available ComXf.h
via:
c(SRS_BSW_00404, SRS_BSW_00441)
8.3.1 ComXf_<transformerId>
[SWS_ComXf_00007] d
c(SRS_Xfrm_00201)
where
• type is data type of the data element after all data conversion activities of the
RTE
• paramtype is derived from type according to the parameter passing
rules rules defined by the SRS BSW General [5] (see [SRS_BSW_00484],
[SRS_BSW_00485], and [SRS_BSW_00486]) and SWS BSW General [8] (see
[SWS_BSW_00186] and [SWS_BSW_00187])
• transformerId is the name pattern for the transformer specified be the Gen-
eral Specification on Transformers [2] [SWS_Xfrm_00062].
The function specified in [SWS_ComXf_00007] exists for each transformed
Sender/Receiver communication which uses the COM Based Transformer.
[SWS_ComXf_00008] d The function specified in [SWS_ComXf_00007] shall ex-
ist for the first reference in the list of ordered references transformerChain
from a DataTransformation to a TransformationTechnology if the Data-
Transformation is referenced by an ISignalGroup in the role comBasedSig-
nalGroupTransformation where the ISignalGroup references a SystemSig-
nalGroup which is referenced by SenderReceiverToSignalGroupMapping. c
(SRS_Xfrm_00201)
[SWS_ComXf_00009] d The function specified in [SWS_ComXf_00007] shall serial-
ize complex data elements of Sender/Receiver communication into a linear byte array
representation using the COM Based Transformation. c(SRS_Xfrm_00201)
8.3.2 ComXf_Inv_<transformerId>
[SWS_ComXf_00010] d
Service name: ComXf_Inv_<transformerId>
Syntax: uint8 ComXf_Inv_<transformerId>(
const uint8* buffer,
uint32 bufferLength,
<type>* dataElement
)
Service ID[hex]: 0x04
Sync/Async: Synchronous
Reentrancy: Reentrant
Parameters (in): buffer Buffer allocated by the RTE, where the still serial-
ized data are stored by the Rte
bufferLength Used length of the buffer
Parameters (inout): None
Parameters (out): dataElement Data element which is the result of the transforma-
tion and contains the deserialized data element
Return value: uint8 0x00 (E_OK): Serialization successful
0x01 (E_NO_DATA): No data available which can be
deserialized
0x81 (E_SER_GENERIC_ERROR): A generic error
occurred
Description: This function deserializes a Sender/Receiver communication using the
deserialization of COM Based Transformer. It takes the uint8 array con-
taining the serialized data as input and outputs the original data element
which will be passed to the Rte.
Available via: ComXf.h
c(SRS_Xfrm_00201)
where
• type is data type of the data element before all data conversion activities of the
RTE
• transformerId is the name pattern for the transformer specified in
[SWS_Xfrm_00062] ([2]).
The function specified in [SWS_ComXf_00010] exists for each transformed
Sender/Receiver communication which uses the COM Based Transformation.
[SWS_ComXf_00011] d The function specified in [SWS_ComXf_00010] shall ex-
ist for the first reference in the list of ordered references transformerChain
from a DataTransformation to a TransformationTechnology if the Data-
Transformation is referenced by an ISignalGroup in the role comBasedSig-
nalGroupTransformation where the ISignalGroup references a SystemSig-
nalGroup which is referenced by SenderReceiverToSignalGroupMapping. c
(SRS_Xfrm_00201)
8.3.3 ComXf_Init
[SWS_ComXf_00026] d
Service name: ComXf_Init
Syntax: void ComXf_Init(
const ComXf_ConfigType* config
)
Service ID[hex]: 0x01
Sync/Async: Synchronous
Reentrancy: Reentrant
Parameters (in): config Pointer to the transformer’s configuration data.
Parameters (inout): None
Parameters (out): None
Return value: None
Description: This service initializes the transformer for the further processing.
Available via: ComXf.h
c(SRS_BSW_00407, SRS_BSW_00411)
8.3.4 ComXf_DeInit
[SWS_ComXf_00027] d
Service name: ComXf_DeInit
Syntax: void ComXf_DeInit(
void
)
Service ID[hex]: 0x02
Sync/Async: Synchronous
Reentrancy: Reentrant
Parameters (in): None
Parameters (inout): None
Parameters (out): None
Return value: None
Description: This service deinitializes the transformer.
Available via: ComXf.h
c(SRS_BSW_00407, SRS_BSW_00411)
8.3.5 ComXf_GetVersionInfo
[SWS_ComXf_00024] d
Service name: ComXf_GetVersionInfo
Syntax: void ComXf_GetVersionInfo(
Std_VersionInfoType* VersionInfo
)
Service ID[hex]: 0x00
Sync/Async: Synchronous
Reentrancy: Reentrant
Parameters (in): None
Parameters (inout): None
Parameters (out): VersionInfo Pointer to where to store the version information of
this module.
Return value: None
Description: This service returns the version information of the called transformer
module.
Available via: ComXf.h
c(SRS_BSW_00407, SRS_BSW_00411)
9 Sequence diagrams
There are no sequence diagrams applicable to COM Based Transformer.
10 Configuration specification
[SWS_ComXf_00031] d The COM Based Transformer is configured based on the
COM module configuration [4]. c(SRS_Xfrm_00202)
Still, there is an EcuC necessary to map the implementation of the transformer. The
EcuC defined in [2] shall be used.
[SWS_ComXf_00033] d The vendor specific module definition of the COM Based
Transformer - based on the Xfrm configuration [2] - may be extended by the vendor
to support the close interaction with the Com module [4]. c(SRS_Xfrm_00202)
[SWS_ComXf_00034] d The COM Based Transformer shall be configured to be post-
Build when the configuration of the Com module [4] is postBuild for the respective
ComSignalGroups. c(SRS_Xfrm_00202)
[SWS_ComXf_00025] d The apiServicePrefix of the COM Based Transformer’s
EcuC shall be set to ComXf. c(SRS_BSW_00159, SRS_Xfrm_00202)
Class EcucModuleDef
Package M2::AUTOSARTemplates::ECUCParameterDefTemplate
Note Used as the top-level element for configuration definition for Software Modules, including BSW and RTE
as well as ECU Infrastructure.
Tags: atp.recommendedPackage=EcucModuleDefs
Base ARElement, ARObject, AtpBlueprint, AtpBlueprintable, AtpDefinition, CollectableElement, Ecuc
DefinitionElement, Identifiable, MultilanguageReferrable, PackageableElement, Referrable
Attribute Type Mul. Kind Note
apiServicePrefix CIdentifier 0..1 attr For CDD modules this attribute holds the apiService
Prefix.
The shortName of the module definition of a Complex
Driver is always "Cdd". Therefore for CDD modules the
module apiServicePrefix is described with this attribute.
container EcucContainerDef 1..* aggr Aggregates the top-level container definitions of this
specific module definition.
Stereotypes: atpSplitable
Tags: atp.Splitkey=shortName
xml.sequenceOffset=11
postBuildVariant Boolean 0..1 attr Indicates if a module supports different post-build variants
Support (previously known as post-build selectable configuration
sets). TRUE means yes, FALSE means no.
refinedModule EcucModuleDef 0..1 ref Optional reference from the Vendor Specific Module
Def Definition to the Standardized Module Definition it refines.
In case this EcucModuleDef has the category
STANDARDIZED_MODULE_DEFINITION
this reference shall not be provided. In case this Ecuc
5
5
4
Class EcucModuleDef
4
ModuleDef has the category
VENDOR_SPECIFIC_MODULE_DEFINITION this
reference is mandatory.
Stereotypes: atpUriDef
supported EcucConfiguration * attr Specifies which ConfigurationVariants are supported by
ConfigVariant VariantEnum this software module.
This attribute is optional if the EcucModuleDef has the
category STANDARDIZED_MODULE_DEFINITION. If
the category attribute of the EcucModuleDef is set to
VENDOR_SPECIFIC_MODULE_DEFINITION then this
attribute is mandatory.
Class ISignalGroup
Package M2::AUTOSARTemplates::SystemTemplate::Fibex::FibexCore::CoreCommunication
Note SignalGroup of the Interaction Layer. The RTE supports a "signal fan-out" where the same System
Signal Group is sent in different SignalIPdus to multiple receivers.
An ISignalGroup refers to a set of ISignals that shall always be kept together. A ISignalGroup represents
a COM Signal Group.
Therefore it is recommended to put the ISignalGroup in the same Package as ISignals (see
atp.recommendedPackage)
Tags: atp.recommendedPackage=ISignalGroup
Base ARObject, CollectableElement, FibexElement, Identifiable, MultilanguageReferrable, Packageable
Element, Referrable
Attribute Type Mul. Kind Note
comBased DataTransformation 0..1 ref Optional reference to a DataTransformation which
SignalGroup represents the transformer chain that is used to transform
Transformation the data that shall be placed inside this ISignalGroup
based on the COMBasedTransformer approach.
Stereotypes: atpSplitable; atpVariation
Tags: atp.Splitkey=comBasedSignalGroup
Transformation, variationPoint.shortLabel
vh.latestBindingTime=codeGenerationTime
iSignal ISignal * ref Reference to a set of ISignals that shall always be kept
together.
systemSignal SystemSignalGroup 1 ref Reference to the SystemSignalGroup that is defined on
Group VFB level and that is supposed to be transmitted in the
ISignalGroup.
transformation TransformationISignal * aggr A transformer chain consists of an ordered list of
ISignalProps Props transformers. The ISignalGroup specific configuration
properties for each transformer are defined in the
TransformationISignalProps class. The transformer
configuration properties that are common for all ISignal
Groups are described in the TransformationTechnology
class.
Table A.3: ISignalGroup
Class ISignalIPdu
Package M2::AUTOSARTemplates::SystemTemplate::Fibex::FibexCore::CoreCommunication
Note Represents the IPdus handled by Com. The ISignalIPdu assembled and disassembled in AUTOSAR
COM consists of one or more signals.
In case no multiplexing is performed this IPdu is routed to/from the Interface Layer.
A maximum of one dynamic length signal per IPdu is allowed.
Tags: atp.recommendedPackage=Pdus
Base ARObject, CollectableElement, FibexElement, IPdu, Identifiable, MultilanguageReferrable, Packageable
Element, Pdu, Referrable
Attribute Type Mul. Kind Note
iPduTiming IPduTiming 0..1 aggr Timing specification for Com IPdus (Transmission
Specification Modes).
This information is mandatory for the sender in a System
Extract. This information may be omitted on receivers in a
System Extract.
atpVariation: The timing of a Pdu can vary.
Stereotypes: atpVariation
Tags: vh.latestBindingTime=postBuild
iSignalToPdu ISignalToIPduMapping * aggr Definition of SignalToIPduMappings included in the Signal
Mapping IPdu.
atpVariation: The content of a PDU can be variable.
Stereotypes: atpVariation
Tags: vh.latestBindingTime=postBuild
pduCounter SignalIPduCounter 0..1 aggr An included Pdu counter is used to ensure that a
sequence of Pdus is maintained.
Stereotypes: atpVariation
Tags: vh.latestBindingTime=preCompileTime
pduReplication SignalIPduReplication 0..1 aggr Pdu Replication is a form of redundancy where the data
content of one ISignalIPdu (source) is transmitted inside a
set of replica ISignalIPdus. These ISignalIPdus (copies)
have different Pdu IDs, identical PduCounters, identical
data content and are transmitted with the same frequency.
Stereotypes: atpVariation
Tags: vh.latestBindingTime=preCompileTime
unusedBit Integer 1 attr AUTOSAR COM and AUTOSAR IPDUM are filling not
Pattern used areas of an IPDU with this bit-pattern. This attribute
is mandatory to avoid undefined behavior. This
byte-pattern will be repeated throughout the IPdu.
Class ISignalToIPduMapping
Package M2::AUTOSARTemplates::SystemTemplate::Fibex::FibexCore::CoreCommunication
Note An ISignalToIPduMapping describes the mapping of ISignals to ISignalIPdus and defines the position of
the ISignal within an ISignalIPdu.
Base ARObject, Identifiable, MultilanguageReferrable, Referrable
Attribute Type Mul. Kind Note
5
4
Class ISignalToIPduMapping
iSignal ISignal 0..1 ref Reference to a ISignal that is mapped into the ISignal
IPdu.
Each ISignal contained in the ISignalGroup shall be
mapped into an IPdu by an own ISignalToIPduMapping.
The references to the ISignal and to the ISignalGroup in
an ISignalToIPduMapping are mutually exclusive.
iSignalGroup ISignalGroup 0..1 ref Reference to an ISignalGroup that is mapped into the
SignalIPdu.
If an ISignalToIPduMapping for an ISignalGroup is
defined, only the UpdateIndicationBitPosition and the
transferProperty is relevant. The startPosition and the
packingByteOrder shall be ignored.
Each ISignal contained in the ISignalGroup shall be
mapped into an IPdu by an own ISignalToIPduMapping.
The references to the ISignal and to the ISignalGroup in
an ISignalToIPduMapping are mutually exclusive.
packingByte ByteOrderEnum 0..1 attr This parameter defines the order of the bytes of the signal
Order and the packing into the SignalIPdu. The byte ordering
"Little Endian" (MostSignificantByteLast), "Big Endian"
(MostSignificantByteFirst) and "Opaque" can be selected.
For opaque data endianness conversion shall be
configured to Opaque.
The value of this attribute impacts the absolute position of
the signal into the SignalIPdu (see the startPosition
attribute description).
For an ISignalGroup the packingByteOrder is irrelevant
and shall be ignored.
startPosition Integer 0..1 attr This parameter is necessary to describe the bitposition of
a signal within an SignalIPdu.
It denotes the least significant bit for "Little Endian" and
the most significant bit for "Big Endian" packed signals
within the IPdu (see the description of the packingByte
Order attribute). In AUTOSAR the bit counting is always
set to "sawtooth" and the bit order is set to "Decreasing".
The bit counting in byte 0 starts with bit 0 (least significant
bit). The most significant bit in byte 0 is bit 7.
Please note that the way the bytes will be actually sent on
the bus does not impact this representation: they will
always be seen by the software as a byte array.
If a mapping for the ISignalGroup is defined, this attribute
is irrelevant and shall be ignored.
transferProperty TransferPropertyEnum 0..1 attr Defines how the referenced ISignal contributes to the
send triggering of the ISignalIPdu.
update Integer 0..1 attr The UpdateIndicationBit indicates to the receivers that the
IndicationBit signal (or the signal group) was updated by the sender.
Position Length is always one bit. The UpdateIndicationBitPosition
attribute describes the position of the update bit within the
SignalIPdu. For Signals of a ISignalGroup this attribute is
irrelevant and shall be ignored.
Note that the exact bit position of the updateIndicationBit
Position is linked to the value of the attribute packingByte
Order because the method of finding the bit position is
different for the values mostSignificantByteFirst and most
SignificantByteLast. This means that if the value of
5
5
4
Class ISignalToIPduMapping
4
packingByteOrder is changed while the value of update
IndicationBitPosition remains unchanged the exact bit
position of updateIndicationBitPosition within the
enclosing ISignalIPdu still undergoes a change.
This attribute denotes the least significant bit for "Little
Endian" and the most significant bit for "Big Endian"
packed signals within the IPdu (see the description of the
packingByteOrder attribute). In AUTOSAR the bit
counting is always set to "sawtooth" and the bit order is
set to "Decreasing". The bit counting in byte 0 starts with
bit 0 (least significant bit). The most significant bit in byte
0 is bit 7.
Class ImplementationDataType
Package M2::AUTOSARTemplates::CommonStructure::ImplementationDataTypes
Note Describes a reusable data type on the implementation level. This will typically correspond to a typedef in
C-code.
Tags: atp.recommendedPackage=ImplementationDataTypes
Base ARElement, ARObject, AbstractImplementationDataType, AtpBlueprint, AtpBlueprintable, AtpClassifier ,
AtpType, AutosarDataType, CollectableElement, Identifiable, MultilanguageReferrable, Packageable
Element, Referrable
Attribute Type Mul. Kind Note
dynamicArray String 0..1 attr Specifies the profile which the array will follow in case this
SizeProfile data type is a variable size array.
isStructWith Boolean 0..1 attr This attribute is only valid if the attribute category is set to
Optional STRUCTURE.
Element
If set to True, this attribute indicates that the
ImplementationDataType has been created with the
intention to define at least one element of the structure as
optional.
Tags: atp.Status=draft
subElement (or- ImplementationData * aggr Specifies an element of an array, struct, or union data
dered) TypeElement type.
The aggregation of ImplementionDataTypeElement is
subject to variability with the purpose to support the
conditional existence of elements inside a Implementation
DataType representing a structure.
Stereotypes: atpVariation
Tags: vh.latestBindingTime=preCompileTime
symbolProps SymbolProps 0..1 aggr This represents the SymbolProps for the Implementation
DataType.
Stereotypes: atpSplitable
Tags: atp.Splitkey=shortName
typeEmitter NameToken 0..1 attr This attribute is used to control which part of the
AUTOSAR toolchain is supposed to trigger data type
definitions.
Table A.6: ImplementationDataType
Class SenderReceiverInterface
Package M2::AUTOSARTemplates::SWComponentTemplate::PortInterface
Note A sender/receiver interface declares a number of data elements to be sent and received.
Tags: atp.recommendedPackage=PortInterfaces
Base ARElement, ARObject, AtpBlueprint, AtpBlueprintable, AtpClassifier , AtpType, CollectableElement,
DataInterface, Identifiable, MultilanguageReferrable, PackageableElement, PortInterface, Referrable
Attribute Type Mul. Kind Note
dataElement VariableDataPrototype 1..* aggr The data elements of this SenderReceiverInterface.
invalidation InvalidationPolicy * aggr InvalidationPolicy for a particular dataElement
Policy
Class SenderReceiverToSignalGroupMapping
Package M2::AUTOSARTemplates::SystemTemplate::DataMapping
Note Mapping of a sender receiver communication data element with a composite datatype to a signal group.
Base ARObject, DataMapping
Attribute Type Mul. Kind Note
dataElement VariableDataPrototype 1 iref Reference to a data element with a composite datatype
which is mapped to a signal group.
signalGroup SystemSignalGroup 1 ref Reference to the signal group, which contain all primitive
datatypes of the composite type
5
4
Class SenderReceiverToSignalGroupMapping
typeMapping SenderRecComposite 1 aggr The CompositeTypeMapping maps the the Application
TypeMapping ArrayElements and ApplicationRecordElements to
Signals of the SignalGroup.
Class SystemSignalGroup
Package M2::AUTOSARTemplates::SystemTemplate::Fibex::FibexCore::CoreCommunication
Note A signal group refers to a set of signals that must always be kept together. A signal group is used to
guarantee the atomic transfer of AUTOSAR composite data types.
The SystemSignalGroup defines a signal grouping on VFB level. On cluster level the Signal grouping is
described by the ISignalGroup element.
Tags: atp.recommendedPackage=SystemSignalGroups
Base ARElement, ARObject, CollectableElement, Identifiable, MultilanguageReferrable, Packageable
Element, Referrable
Attribute Type Mul. Kind Note
systemSignal SystemSignal * ref Reference to a set of SystemSignals that must always be
kept together.
transforming SystemSignal 0..1 ref Optional reference to the SystemSignal which shall
SystemSignal contain the transformed (linear) data.
ComHandleId:
EcucIntegerParamDef
min = 0
max = 65535
+parameter lowerMultiplicity = 0
upperMultiplicity = 1
symbolicNameValue = true
ComGroupSignal: ComBitPosition:
EcucParamConfContainerDef +parameter EcucIntegerParamDef
lowerMultiplicity = 0 min = 0
upperMultiplicity = * max = 4294967295 ComSignalLength:
EcucIntegerParamDef
+subContainer +parameter
max = 4294967295
min = 0
lowerMultiplicity = 0
ComBitSize: upperMultiplicity = 1
EcucIntegerParamDef
+parameter
max = 64
min = 0
lowerMultiplicity = 0
upperMultiplicity = 1
Default Value
Post-Build Variant true
Multiplicity
Post-Build Variant true
Value
Multiplicity Pre-compile time X VARIANT-PRE-COMPILE
Configuration Class
Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Value Configuration Pre-compile time X VARIANT-PRE-COMPILE
Class
Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Scope / Dependency scope: local
This ID identifies signals and signal groups in the COM APIs using
Com_SignalIdType or Com_SignalGroupIdType parameter
respectively.
Multiplicity 0..1
Type EcucIntegerParamDef (Symbolic Name generated for this parameter)
Range 0 .. 65535
Default Value
Post-Build Variant false
Multiplicity
Post-Build Variant false
Value
Multiplicity Pre-compile time X All Variants
Configuration Class
Link time –
Post-build time –
Value Configuration Pre-compile time X All Variants
Class
Link time –
Post-build time –
Scope / Dependency scope: ECU
Range: 0..63 for CAN and LIN, 0..511 for CAN FD, 0..2031 for FlexRay,
0..4294967295 for TP.
Multiplicity 0..1
Type EcucIntegerParamDef
Range 0 .. 4294967295
Default Value
Post-Build Variant true
Multiplicity
Post-Build Variant true
Value
Multiplicity Pre-compile time X VARIANT-PRE-COMPILE
Configuration Class
Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Value Configuration Pre-compile time X VARIANT-PRE-COMPILE
Class
Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Scope / Dependency scope: local
Included Containers
Container Name Multiplicity Scope / Dependency
ComGroupSignal 0..* This container contains the configuration parameters of
group signals. I.e. signals that are included within a
signal group.
This ID identifies signals and signal groups in the COM APIs using
Com_SignalIdType or Com_SignalGroupIdType parameter
respectively.
Multiplicity 0..1
Type EcucIntegerParamDef (Symbolic Name generated for this parameter)
Range 0 .. 65535
Default Value
Post-Build Variant false
Multiplicity
Post-Build Variant false
Value
FLOAT64
SINT16
SINT32
SINT64
SINT8
UINT16
UINT32
UINT64
UINT8
UINT8_DYN
UINT8_N
Post-Build Variant false
Value
Value Configuration Pre-compile time X VARIANT-PRE-COMPILE
Class
Link time X VARIANT-LINK-TIME,
VARIANT-POST-BUILD
Post-build time –
Scope / Dependency scope: local
Regular Expression
Post-Build Variant true
Multiplicity
Post-Build Variant true
Value
Multiplicity Pre-compile time X VARIANT-PRE-COMPILE
Configuration Class
Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Value Configuration Pre-compile time X VARIANT-PRE-COMPILE
Class
Link time X VARIANT-LINK-TIME
Post-build time X VARIANT-POST-BUILD
Scope / Dependency scope: local
Included Containers
Container Name Multiplicity Scope / Dependency
ComFilter 0..1 This container contains the configuration parameters of
the AUTOSAR COM module’s Filters.
Included Containers
Container Name Multiplicity Scope / Dependency
ComIPduCounter 0..1 This optional container contains the configuration
parameters of PDU Counter.
ComIPduReplication 0..1 This optional container contains the information needed
for each I-PDU replicated.
ComTxIPdu 0..1 This container contains additional transmission related
configuration parameters of the AUTOSAR COM
module’s I-PDUs.
Included Containers
Container Name Multiplicity Scope / Dependency
ComTxModeFalse 0..1 This container contains the configuration parameters of
the AUTOSAR COM module’s transmission modes in
the case the ComFilter evaluates to false.
ComTxModeTrue 0..1 This container contains the configuration parameters of
the AUTOSAR COM module’s transmission modes in
the case the ComFilter evaluates to true.
[SWS_ComXf_00032]
[SWS_ComXf_00028]
none
none
[SWS_ComXf_00036]
[SWS_ComXf_00007] [SWS_ComXf_00023]
none
none
[SWS_ComXf_00007] [SWS_ComXf_00020]
[SWS_ComXf_00001] [SWS_ComXf_00014]