Specification of SOME/IP Transformer
AUTOSAR CP R21-11
Document Title
Specification of SOME/IP
Transfor mer
Document Owner AUTOSAR
Document Responsibility AUTOSAR
Document Identification No 660
Document Status published
Part of AUTOSAR Standard Classic Platform
Part of Standard Release R21-11
Document Change History
Date Release Changed by
Description
2021-11-25 R21-11
AUTOSAR
Release
Management
• Clarification on network
representation
• SOME/IP Header encoded in
network byte order
• Clarification on
SOMEIPLegacyStringSerialization
• Optional method arguments not
supported
• Clarification on Interface Version
• Clarification on processing order of
header fields in AUTOSAR CP
• Removed
SOMEIPXF_E_UNKNOWN_SERVICE
and
SOMEIPXF_E_UNKNOWN_METHOD
• Introduction on External Trigger
Events
• Clarification on ISignal length of
external trigger event
• Editorial Changes
1 of 107 Document ID 660: AUTOSAR_SWS_SOMEIPTransformer
Specification of SOME/IP Transformer
AUTOSAR CP R21-11
2020-11-30 R20-11
AUTOSAR
Release
Management
• Added call/response context to Client
Server requirements
• Constraint added for data type of
length field of variable Strings
• Added E_E2E Error to Table 7.11:
Return Codes
• Requirement added in case
unvailability of optional member in
the received serialized byte stream
• Reworked E2E communication
protection for methods
• sizeOfStringLengthField introduced
for the size of the length field for
dynamic length strings
• sizeOfArrayLengthField introduced
for the size of the length field for
variable size arrays
• Fixed design issues with E2E
communication protection for
methods
• Editorial Changes
2019-11-28 R19-11
AUTOSAR
Release
Management
• Extended Serialization for Data
Structures in SOME/IP with
tag/length/value encoding set to valid
• Removed *_ACK message types
• replaced
implementsSOMEIPStringHandling
(in class
SOMEIPTransformationSignalProps)
with
implementsLegacyStringSerialization
• Minor corrections / clarifications /
editorial changes; For details please
refer to the ChangeDocumentation
• Changed Document Status from
Final to published
2 of 107 Document ID 660: AUTOSAR_SWS_SOMEIPTransformer
Specification of SOME/IP Transformer
AUTOSAR CP R21-11
2018-10-31 4.4.0
AUTOSAR
Release
Management
• Checking for length of received
dynamic length strings
• Extended Serialization for Data
Structures in SOME/IP with
tag/length/value encoding
• Minor corrections / clarifications /
editorial changes; For details please
refer to the ChangeDocumentation
2017-12-08 4.3.1
AUTOSAR
Release
Management
• Bugfixes in serialization of strings
and data with variable size
• Signatures improved
• Minor corrections / clarifications /
editorial changes; For details please
refer to the ChangeDocumentation
2016-11-30 4.3.0
AUTOSAR
Release
Management
• Sizes of length fields can be
configured independently from each
other
• Support of union data types
• Minor corrections / clarifications /
editorial changes; For details please
refer to the ChangeDocumentation
2015-07-31 4.2.2
AUTOSAR
Release
Management
• Size of length fields is configurable
• External trigger events are
communciated as fire-and-forget
methods
• Autonomous error reactions of
SOME/IP transformer
• Minor corrections / clarifications /
editorial changes; For details please
refer to the ChangeDocumentation
2014-10-31 4.2.1
AUTOSAR
Release
Management
Initial Release
3 of 107 Document ID 660: AUTOSAR_SWS_SOMEIPTransformer
Specification of SOME/IP Transformer
AUTOSAR CP R21-11
Disclaimer
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.
4 of 107 Document ID 660: AUTOSAR_SWS_SOMEIPTransformer
Specification of SOME/IP Transformer
AUTOSAR CP R21-11
Table of Contents
1 Introduction and functional overview 7
2 Acronyms and Abbreviations 8
3 Related documentation 9
3.1 Input documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2 Related standards and norms . . . . . . . . . . . . . . . . . . . . . . . 10
3.3 Related specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4 Constraints and assumptions 11
4.1 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.2 Applicability to car domains . . . . . . . . . . . . . . . . . . . . . . . . 11
5 Dependencies to other modules 12
5.1 File structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5.1.1 Code file structure . . . . . . . . . . . . . . . . . . . . . . . . 12
5.1.2 Header file structure . . . . . . . . . . . . . . . . . . . . . . . 12
6 Requirements Tracing 13
7 Functional specification 19
7.1 Definition of Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.2 Specification of the SOME/IP on-wire format . . . . . . . . . . . . . . . 23
7.2.1 Message Length Limitations . . . . . . . . . . . . . . . . . . 23
7.2.2 Endianess . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.2.3 Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.2.3.1 Message ID [32 bit] . . . . . . . . . . . . . . . . . . . 25
7.2.3.2 Length [32 bit] . . . . . . . . . . . . . . . . . . . . . . 26
7.2.3.3 Request ID [32 bit] . . . . . . . . . . . . . . . . . . . 26
7.2.3.4 Protocol Version [8 bit] . . . . . . . . . . . . . . . . . 27
7.2.3.5 Interface Version [8 bit] . . . . . . . . . . . . . . . . . 27
7.2.3.6 Message Type [8 bit] . . . . . . . . . . . . . . . . . . 28
7.2.3.7 Return Code [8 bit] . . . . . . . . . . . . . . . . . . . 28
7.2.3.8 Payload [variable size] . . . . . . . . . . . . . . . . . 29
7.2.4 Serialization of Parameters and Data Structures . . . . . . . 29
7.2.4.1 Basic Datatypes . . . . . . . . . . . . . . . . . . . . 31
7.2.4.2 Structured Datatypes (structs) . . . . . . . . . . . . . 31
7.2.4.3 Structured Datatypes and Arguments with Identifier
and optional Members . . . . . . . . . . . . . . . . . 34
7.2.4.4 Strings . . . . . . . . . . . . . . . . . . . . . . . . . . 39
7.2.4.5 Arrays (fixed length) . . . . . . . . . . . . . . . . . . 44
7.2.4.6 Optional Parameters / Optional Elements . . . . . . 47
7.2.4.7 Dynamic Length Arrays / Variable Size Arrays . . . . 47
7.2.4.8 Bitfield . . . . . . . . . . . . . . . . . . . . . . . . . . 50
7.2.4.9 Union / Variant . . . . . . . . . . . . . . . . . . . . . 50
5 of 107 Document ID 660: AUTOSAR_SWS_SOMEIPTransformer
评论0