3. 基础数据类型定义：Boolean、Integer、Real、String、Array的定义与属性

好，咱们今天聊聊ARXML里最基础的东西——数据类型定义。说实话，我刚开始接触AUTOSAR那会儿，觉得数据类型嘛，不就是C语言里的int、float、char吗？有什么好讲的？结果第一次做实际项目，就被ARXML里那些嵌套的、带约束的、带计算方法的类型定义给整懵了。

嗯，咱们今天就把这五种基础数据类型掰开揉碎了讲清楚。你想想看，ARXML里的数据定义，说白了就是给ECU里的信号、参数、接口定个“规矩”——这个数据多大、什么范围、怎么显示、单位是什么。规矩定好了，后面生成代码、做标定、搞诊断，全都顺风顺水。

3.1 Boolean类型——最简单的，也是最容易出错的

Boolean，布尔类型，就两个值：true和false。ARXML里定义起来很简单，但我个人习惯，一定要给它加上display-name和semantics。为什么？

我曾经在一个项目中，接手别人的ARXML，看到一个布尔信号叫EngSts，true代表什么？false代表什么？完全不知道。后来查了半天文档，才知道true是“发动机运行”，false是“发动机停止”。你说这多耽误事？

核心要点：布尔类型一定要有明确的语义描述，别让人猜。

ARXML里定义布尔类型的标准写法是这样的：

<SW-BASE-TYPE UUID="uuid-bool-001">
    <SHORT-NAME>Boolean_Base</SHORT-NAME>
    <CATEGORY>BOOLEAN</CATEGORY>
    <BASE-TYPE-ENCODING>BOOLEAN</BASE-TYPE-ENCODING>
    <BASE-TYPE-SIZE>8</BASE-TYPE-SIZE>
    <MEM-ALIGNMENT>8</MEM-ALIGNMENT>
    <BYTE-ORDER>MOST-SIGNIFICANT-BYTE-FIRST</BYTE-ORDER>
</SW-BASE-TYPE>

注意看，BASE-TYPE-SIZE我设成了8位。其实布尔类型1位就够了，但很多编译器对位域处理不好，所以我建议用8位，省心。

小技巧：布尔类型的BASE-TYPE-ENCODING一定要写BOOLEAN，别写成UINT8。虽然底层都是8位，但语义不同，代码生成器处理方式也不一样。

3.2 Integer类型——范围、精度、单位，一个都不能少

Integer，整数类型，这是ARXML里用得最多的。定义整数类型时，有三个属性我特别在意：下限、上限、单位。

我记得有一次，一个温度信号定义成uint16，范围0-65535，单位是摄氏度。结果标定工程师问我：“这个温度值到65535度，是要把发动机烧化吗？” 哈哈，虽然是个玩笑，但说明定义整数类型时，范围一定要合理。

ARXML里整数类型的定义，通常分两步：先定义SW-BASE-TYPE（底层类型），再定义SW-COMPU-METHOD（转换方法）。

先看底层类型：

<SW-BASE-TYPE UUID="uuid-int-001">
    <SHORT-NAME>Uint16_Base</SHORT-NAME>
    <CATEGORY>VALUE</CATEGORY>
    <BASE-TYPE-ENCODING>UINT16</BASE-TYPE-ENCODING>
    <BASE-TYPE-SIZE>16</BASE-TYPE-SIZE>
    <MEM-ALIGNMENT>16</MEM-ALIGNMENT>
    <BYTE-ORDER>MOST-SIGNIFICANT-BYTE-FIRST</BYTE-ORDER>
</SW-BASE-TYPE>

再看转换方法——这里定义物理值和原始值的映射关系：

<SW-COMPU-METHOD UUID="uuid-compu-001">
    <SHORT-NAME>Temp_CompuMethod</SHORT-NAME>
    <CATEGORY>LINEAR</CATEGORY>
    <UNIT-REF DEST="UNIT">/Units/DegC</UNIT-REF>
    <COMPU-INTERNAL-TO-PHYS>
        <COMPU-SCALES>
            <COMPU-SCALE>
                <SHORT-LABEL>Scale0</SHORT-LABEL>
                <LOWER-LIMIT INTERVAL-TYPE="CLOSED">0</LOWER-LIMIT>
                <UPPER-LIMIT INTERVAL-TYPE="CLOSED">65535</UPPER-LIMIT>
                <COMPU-RATIONAL-COEFFS>
                    <COMPU-NUMERATOR>
                        <V>1</V>
                        <V>0</V>
                    </COMPU-NUMERATOR>
                    <COMPU-DENOMINATOR>
                        <V>1</V>
                    </COMPU-DENOMINATOR>
                </COMPU-RATIONAL-COEFFS>
            </COMPU-SCALE>
        </COMPU-SCALES>
    </COMPU-INTERNAL-TO-PHYS>
</SW-COMPU-METHOD>

这里COMPU-RATIONAL-COEFFS里的分子分母，就是线性转换公式：物理值 = (分子1 * 原始值 + 分子0) / 分母1。上面这个例子是1:1映射，所以物理值=原始值。

注意：整数类型的LOWER-LIMIT和UPPER-LIMIT一定要写对。我曾经见过一个项目，下限写成了CLOSED（包含边界），上限写成了OPEN（不包含边界），结果标定工具死活报错。统一用CLOSED最保险。

3.3 Real类型——浮点数，精度是命根子

Real类型，就是浮点数。ARXML里支持float32和float64。我个人习惯，能用float32就别用float64，省内存、省带宽。但精度要求高的场合——比如GPS坐标、高精度扭矩控制——必须上float64。

定义Real类型和Integer类似，也是底层类型+转换方法。但Real类型有个特殊属性：精度。这个精度不是指浮点数的二进制精度，而是指显示或标定时保留几位小数。

<SW-BASE-TYPE UUID="uuid-real-001">
    <SHORT-NAME>Float32_Base</SHORT-NAME>
    <CATEGORY>VALUE</CATEGORY>
    <BASE-TYPE-ENCODING>IEEE754</BASE-TYPE-ENCODING>
    <BASE-TYPE-SIZE>32</BASE-TYPE-SIZE>
    <MEM-ALIGNMENT>32</MEM-ALIGNMENT>
    <BYTE-ORDER>MOST-SIGNIFICANT-BYTE-FIRST</BYTE-ORDER>
</SW-BASE-TYPE>

注意BASE-TYPE-ENCODING写的是IEEE754，这是浮点数的标准编码方式。别写成FLOAT32，虽然有些工具也认，但不够规范。

避坑指南：我曾经在定义Real类型时，忘了加COMPU-METHOD里的UNIT-REF。结果标定工具显示数值时没有单位，标定工程师得靠猜。后来我养成了习惯：所有物理量，不管Integer还是Real，必须关联单位。

3.4 String类型——文本数据，长度和编码是关键

String类型在ARXML里用得相对少一些，但诊断、标定描述、版本信息这些场景少不了。定义String类型，两个属性最重要：最大长度和编码方式。

编码方式一般用UTF-8或ISO-8859-1。我个人推荐UTF-8，兼容性好，中文、日文、特殊符号都能处理。但要注意，UTF-8是变长编码，一个字符可能占1-4个字节，所以最大长度要留够余量。

<SW-BASE-TYPE UUID="uuid-str-001">
    <SHORT-NAME>String_Base</SHORT-NAME>
    <CATEGORY>STRING</CATEGORY>
    <BASE-TYPE-ENCODING>UTF-8</BASE-TYPE-ENCODING>
    <BASE-TYPE-SIZE>255</BASE-TYPE-SIZE>
    <MEM-ALIGNMENT>8</MEM-ALIGNMENT>
</SW-BASE-TYPE>

这里BASE-TYPE-SIZE设成255，表示最大255个字节。如果是纯ASCII字符，就是255个字符；如果是中文，可能只有80多个字符。嗯，这个要心里有数。

核心要点：String类型的BASE-TYPE-SIZE是字节数，不是字符数。多字节编码时，字符数会少于字节数。

3.5 Array类型——批量数据的容器

Array类型，说白了就是数组。ARXML里定义数组，需要指定元素类型、元素个数、寻址方式。

寻址方式有两种：LINEAR（线性寻址）和INDEX（索引寻址）。线性寻址就是连续内存，索引寻址可以指定每个元素的偏移量。大部分场景用线性寻址就够了。

我举个例子，定义一个包含10个uint16元素的数组：

<SW-ARRAY-TYPE UUID="uuid-arr-001">
    <SHORT-NAME>Uint16_Array_10</SHORT-NAME>
    <CATEGORY>ARRAY</CATEGORY>
    <SW-DATA-DEF-PROPS>
        <SW-ADDR-METHOD-REF DEST="SW-ADDR-METHOD">/AddrMethods/Linear</SW-ADDR-METHOD-REF>
    </SW-DATA-DEF-PROPS>
    <ELEMENT-TYPE-REF DEST="SW-BASE-TYPE">/BaseTypes/Uint16_Base</ELEMENT-TYPE-REF>
    <MAX-NUMBER-OF-ELEMENTS>10</MAX-NUMBER-OF-ELEMENTS>
</SW-ARRAY-TYPE>

注意SW-ADDR-METHOD-REF引用了线性寻址方法。这个寻址方法需要提前定义好：

<SW-ADDR-METHOD UUID="uuid-addr-001">
    <SHORT-NAME>Linear</SHORT-NAME>
    <CATEGORY>LINEAR</CATEGORY>
</SW-ADDR-METHOD>

注意：数组的MAX-NUMBER-OF-ELEMENTS是最大元素个数，不是固定个数。如果你需要固定长度的数组，建议在SW-DATA-DEF-PROPS里加上SW-ARRAY-SIZE约束。我曾经因为没加这个约束，代码生成器生成了可变长度数组，导致内存分配出了问题。

3.6 知识体系总览

说了这么多，咱们用一张图把五种数据类型的关系串起来。你想想看，这些类型不是孤立的——Array可以包含Integer、Real、Boolean、String；Integer和Real又共享类似的转换方法结构。

ARXML基础数据类型知识体系 SW-BASE-TYPE Boolean Integer Real String Array 关键属性 • BASE-TYPE-SIZE: 8位 • ENCODING: BOOLEAN • 语义描述不可少 关键属性 • 范围: 下限/上限 • 单位: UNIT-REF • 转换: COMPU-METHOD 关键属性 • ENCODING: IEEE754 • 精度: 显示小数位 • 32位/64位选择 关键属性 • 最大长度: 字节数 • 编码: UTF-8 • 注意字符/字节区别 关键属性 • 元素类型引用 • 最大元素个数 • 寻址方式: LINEAR Array可包含Boolean/Integer/Real/String；Integer和Real共享COMPU-METHOD结构

3.7 实战中的避坑指南

最后，我把自己这些年踩过的坑总结一下，你写ARXML的时候多留个心眼：

数据类型 常见坑点 我的建议
Boolean 语义不明确，true/false含义靠猜 加semantics描述，或者用display-name说明
Integer 范围不合理，单位缺失 范围根据物理量实际需求定，单位必须关联
Real 精度设置过高或过低 显示精度和计算精度分开考虑
String 长度不够，编码不统一 UTF-8 + 预留20%余量
Array 固定长度/可变长度混淆 明确是否需要SW-ARRAY-SIZE约束

嗯，基础数据类型就讲到这里。说白了，ARXML的数据类型定义，就是给ECU里的每个数据立个“身份证”——你是谁、多大、什么范围、怎么显示。身份证立好了，后面所有工具链都认你。立不好，后面全是坑。

我个人习惯，每定义一个数据类型，都问自己三个问题：这个数据物理上是什么？范围合理吗？单位对吗？三个问题都答得上来了，这个类型定义基本就稳了。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →