3. 属性配置与注册：属性配置文件、权限、变更模式与访问模式

在 Vehicle HAL 中，属性（Property）是车辆信号与上层服务之间的核心数据单元。每个属性在被系统使用之前，必须通过 属性配置文件 完成定义与注册。本章节将深入解析 VehiclePropertyConfig 的结构、属性权限模型、变更模式以及访问模式，帮助开发者构建安全、高效的车辆信号订阅体系。

3.1 属性配置文件（VehiclePropertyConfig）

VehiclePropertyConfig 是描述一个车辆属性元数据的核心结构体。它定义了属性的唯一标识、数据类型、访问权限、变更行为以及支持的车辆区域。该配置通常在 HAL 实现层的 onCreate() 方法中通过列表形式注册。

3.2 属性权限模型

属性权限通过 VehiclePropertyAccess 枚举定义，决定了上层应用或服务能够对属性执行的操作。权限模型是车辆安全策略的第一道防线。

• READ（读）：允许订阅者读取属性的当前值。适用于传感器数据、状态指示等只读信号。
• WRITE（写）：允许订阅者向属性写入新值。适用于控制类信号，如车窗升降、门锁控制。
• READ_WRITE（读写）：同时允许读取和写入。适用于可读可控制的属性，如空调温度设定。

3.3 变更模式（Change Mode）

变更模式定义了属性值发生变化时的通知策略。正确选择变更模式直接影响系统性能和信号订阅的实时性。

3.4 访问模式（Access Mode）与订阅关系

访问模式决定了订阅者与属性之间的交互方式。在 Vehicle HAL 中，访问模式与变更模式共同决定了属性在订阅系统中的行为特征。

3.5 属性注册代码示例

以下代码展示了如何在 HAL 实现中创建并注册一个车速属性（VEHICLE_SPEED）和一个车门状态属性（DOOR_POSITION）。

// VehicleHalServer.cpp 中的 onCreate() 方法
Return<void> onCreate() override {
    // 创建属性配置列表
    std::vector<VehiclePropertyConfig> configs;

    // 1. 车速属性：连续变化，只读，全局区域
    VehiclePropertyConfig speedConfig;
    speedConfig.prop = (int32_t)VehicleProperty::VEHICLE_SPEED;
    speedConfig.access = VehiclePropertyAccess::READ;
    speedConfig.changeMode = VehiclePropertyChangeMode::CONTINUOUS;
    speedConfig.minSampleRate = 10.0f;  // 最低 10 Hz
    speedConfig.maxSampleRate = 50.0f;  // 最高 50 Hz
    // 全局区域配置
    VehicleAreaConfig areaConfig;
    areaConfig.areaId = 0;  // 全局区域 ID
    areaConfig.minInt32Value = 0;
    areaConfig.maxInt32Value = 300;  // 车速范围 0-300 km/h
    speedConfig.areaConfigs = {areaConfig};
    configs.push_back(speedConfig);

    // 2. 车门状态属性：按需变化，读写，按车门区域
    VehiclePropertyConfig doorConfig;
    doorConfig.prop = (int32_t)VehicleProperty::DOOR_POSITION;
    doorConfig.access = VehiclePropertyAccess::READ_WRITE;
    doorConfig.changeMode = VehiclePropertyChangeMode::ON_CHANGE;
    // 四个车门区域配置
    for (int32_t doorId = 1; doorId <= 4; ++doorId) {
        VehicleAreaConfig areaCfg;
        areaCfg.areaId = doorId;
        areaCfg.minInt32Value = 0;   // 关闭
        areaCfg.maxInt32Value = 100; // 完全打开
        doorConfig.areaConfigs.push_back(areaCfg);
    }
    configs.push_back(doorConfig);

    // 注册到 HAL 服务
    auto status = mHalServer->registerProperties(configs);
    if (status != StatusCode::OK) {
        ALOGE("属性注册失败: %d", (int32_t)status);
    }
    return Void();
}

3.6 属性配置与订阅的映射关系

属性配置直接影响订阅者的行为。下表总结了不同配置组合下订阅者的典型表现：