属性管理基础：VehicleProperty 的定义与核心要素

在 Vehicle HAL 中，属性（Property）是车辆信号的最小可操作单元。每个属性由四个核心维度唯一确定：属性 ID、属性类型、属性区域和属性状态。理解这四个维度的定义与组合规则，是正确实现车辆信号订阅与数据分发的前提。

2.1 属性 ID（Property ID）

属性 ID 是一个 int32 类型的全局唯一标识符，用于在系统中定位一个具体的车辆信号。其编码规则遵循 Android 官方定义，按功能域进行分段：

2.2 属性类型（Property Type）

属性类型定义了该属性承载的数据格式。Vehicle HAL 使用 VehiclePropertyType 枚举来标记每个属性的数据类型，确保 HAL 层与应用层之间的数据序列化一致。

2.3 属性区域（Property Area）

属性区域用于标识该属性在车辆中的物理或逻辑位置。对于同一信号（如“车窗位置”），不同车门（左前、右后）需要不同的区域值来区分。区域使用 VehicleArea 枚举定义：

• GLOBAL（全局）：适用于整车唯一的信号，如 VIN、总里程。
• WINDOW（车窗）：按车窗位置细分，如左前、右前、左后、右后。
• DOOR（车门）：按车门位置细分，与车窗区域类似但独立。
• SEAT（座椅）：按座椅位置细分，如驾驶员、副驾、后排左、后排右。
• MIRROR（后视镜）：按外后视镜位置细分。
• HVAC（空调）：按空调分区，如驾驶区、副驾区、后排区。
• WHEEL（车轮）：按车轮位置细分，如左前轮、右后轮。

属性 ID 的高 4 位（bit 28-31）用于编码区域类型，低 28 位用于编码具体属性编号。例如：

// 属性 ID 编码示例
#define VEHICLE_AREA_GLOBAL  0x00000000
#define VEHICLE_AREA_WINDOW  0x10000000
#define VEHICLE_AREA_DOOR    0x20000000
#define VEHICLE_AREA_SEAT    0x30000000

// 左前车窗位置属性 ID = 区域(车窗) + 属性编号(0x0100)
#define WINDOW_POS_LEFT_FRONT  (VEHICLE_AREA_WINDOW | 0x0100)

2.4 属性状态（Property Status）

属性状态描述当前属性值的可用性与质量。每次属性值上报时，必须附带一个 VehiclePropertyStatus 枚举值：

应用层和 CarService 必须根据状态决定是否信任该数据。例如，当车速属性状态为 ERROR 时，ADAS 系统应降级或告警，而非使用无效值。

2.5 四维组合关系图

下图展示了属性 ID、类型、区域、状态四个维度如何共同构成一个完整的 VehicleProperty 实例：

2.6 属性定义完整示例

以下代码展示了一个完整的 VehicleProperty 定义，包含上述四个维度的配置：

// 定义：左前车窗位置属性
// 属性 ID：WINDOW_POS_LEFT_FRONT (0x10000100)
// 属性类型：INT32（单位：毫米，0 = 完全关闭）
// 属性区域：WINDOW（左前）
// 属性状态：由 HAL 层动态上报

struct VehiclePropConfig {
    int32_t prop_id = 0x10000100;          // 属性 ID（含区域编码）
    int32_t access = 0x01;                 // 可读可写
    int32_t change_mode = 0x01;            // 连续变化
    int32_t min_sample_rate = 10;          // 最小采样间隔 10ms
    int32_t max_sample_rate = 100;         // 最大采样间隔 100ms
};

struct VehiclePropValue {
    int32_t prop_id = 0x10000100;
    int32_t area_id = 0x01;                // 左前区域
    int32_t status = VehiclePropertyStatus::AVAILABLE;
    struct {
        int32_t value = 250;               // 当前开度 250mm
    } data;
};

2.7 属性生命周期状态机

属性状态在运行时遵循有限状态机转换规则，确保数据质量的可追溯性：

2.8 属性管理核心原则总结