Basic Data types
The following basic datatypes shall be supported:
| Type | Description | Size [bit] | Remark |
|---|---|---|---|
| boolean | TRUE/FALSE value | 8 | FALSE(0),TURE(1) |
| uint8 | unsigned Integer | 8 | |
| uint16 | unsigned Integer | 16 | |
| uint32 | unsigned Integer | 32 | |
| sint8 | signed Integer | 8 | |
| sint16 | signed Integer | 16 | |
| sint32 | signed Integer | 32 | |
| float32 | floating point number | 32 | IEEE 754 binary32 (Single Precision) |
| float64 | floating point number | 64 | IEEE 754 binary64 (Double Precision) |
The Byte Order is specified for each parameter by the interface definition.
In addition, uint64 and sint64 types shall be supported at least on infotainment ECUs.
Structured Datatypes (structs)
String
- Serialization of string (fixed length)
- Serialization of string (dynamic length)
Arrays (fixed length)
- One-dimensional array, fixed length: a[n]
- Multi-dimensional array, fixed length: a[n][m]
Dynamic Length Arrays / Variable Size Arrays
- One-dimensional array, dynamic length
- Multi-dimensional array, dynamic length
Union
- The default serialization layout of unions in SOME/IP is shown as following.
SOME / IP中 union的默认序列化布局。 - SOME/IP allows to add a length field of 8, 16 or 32 bit in front of unions.
SOME / IP允许在union前添加8,16或32位的长度字段。 - The length field of a union describes the number of bytes in the union. This allows the deserializer to quickly calculate the position where the data after the union begin in the serialized data stream. This gets necessary if the union contains data which are larger than expected, for example if a struct was extended with appended new members and only the first “old” members are deserialized by the SOME/IP transformer.
union的长度字段描述联合中的字节数。 这允许deserializer快速计算串行数据流中union开始后的数据的位置。 如果联合包含比预期更大的数据，则这是必要的，例如，如果一个结构体扩展了附加的新成员，并且只有第一个“旧”成员被SOME / IP transformer反序列化。
- Example:
Union of uint8/uint16 both padded to 32 bit.
uint8 / uint16的联合都填充为32位。
In this example a length of the length field is specified as 32 bits. The union shall support a uint8 and a uint16 as elements. Both are padded to the 32 bit boundary (length=4 Bytes).
在这个例子中，长度字段的长度被指定为32位。 union应支持uint8和uint16作为元素。 两者都填充到32位边界（长度= 4字节）。
A uint8 will be serialized like this:
uint8将会像这样被序列化：
| Lentgh =4 Bytes | Type =1 | uint 8 | Padding 0x00 | Padding 0x00 | Padding 0x00 |
|---|
A uint16 will be serialized like this:
uint16将会像这样被序列化：
| Lentgh =4 Bytes | Type =2 | uint 16 | Padding 0x00 | Padding 0x00 |
|---|