3. 参数配置文件结构：XML/JSON配置文件格式、节点与属性的层级关系、配置文件的加载流程

在Camera HAL层Tuning工具中，参数配置文件是连接算法库与硬件驱动的桥梁。本章深入剖析配置文件的两种主流格式——XML与JSON，解析其节点（Node）与属性（Attribute）的层级关系，并完整梳理配置文件从存储介质到生效的加载流程。

3.1 配置文件格式：XML vs JSON

Tuning工具通常支持两种结构化数据格式：XML（可扩展标记语言）和JSON（JavaScript对象表示法）。两者在可读性、解析效率、数据冗余度上各有优劣，实际项目中常根据平台SDK要求或团队习惯选择。

3.2 节点（Node）与属性（Attribute）的层级关系

无论是XML还是JSON，配置文件都采用树形层级结构组织参数。根节点（Root Node）代表传感器或模组型号，子节点逐层细化到ISP模块、场景模式、具体参数项。属性则用于描述节点的元信息，如版本号、使能标志、数据类型等。

3.2.1 XML结构示例

<?xml version="1.0" encoding="UTF-8"?>
<SensorConfig sensorName="IMX586" version="3.2">
    <ISPModule name="AWB" enable="true">
        <Parameter name="R_Gain" type="float">1.85</Parameter>
        <Parameter name="B_Gain" type="float">2.12</Parameter>
        <Parameter name="ColorTemp" type="int">5000</Parameter>
    </ISPModule>
    <ISPModule name="LSC" enable="true">
        <LUT width="16" height="16">
            <Row index="0">1.00 1.02 1.05 1.03</Row>
            <Row index="1">1.01 1.04 1.06 1.02</Row>
        </LUT>
    </ISPModule>
</SensorConfig>

在上述XML中：

• 根节点：<SensorConfig>，属性 sensorName 和 version 标识传感器型号与配置版本。
• 子节点：<ISPModule>，通过属性 name 区分模块（AWB/LSC），enable 控制模块是否生效。
• 叶节点：<Parameter> 和 <Row>，前者携带 type 属性指明数据类型，后者通过 index 属性标识行号。

3.2.2 JSON结构示例

{
    "sensorConfig": {
        "sensorName": "IMX586",
        "version": "3.2",
        "ispModules": [
            {
                "name": "AWB",
                "enable": true,
                "parameters": {
                    "R_Gain": 1.85,
                    "B_Gain": 2.12,
                    "ColorTemp": 5000
                }
            },
            {
                "name": "LSC",
                "enable": true,
                "lut": {
                    "width": 16,
                    "height": 16,
                    "rows": [
                        {"index": 0, "values": [1.00, 1.02, 1.05, 1.03]},
                        {"index": 1, "values": [1.01, 1.04, 1.06, 1.02]}
                    ]
                }
            }
        ]
    }
}

JSON通过嵌套对象和数组实现层级：

• 根对象：sensorConfig，包含传感器元数据。
• 模块列表：ispModules 数组，每个元素是一个模块对象。
• 参数表达：简单参数直接使用键值对（如 "R_Gain": 1.85），复杂结构（如LUT）使用嵌套对象与数组。

3.3 配置文件加载流程

从文件系统到HAL层参数生效，配置文件的加载需要经过路径定位、格式解析、校验合并、内存映射四个阶段。下图展示了完整的加载流程：

3.3.1 路径定位

HAL层启动时，Tuning工具按优先级搜索配置文件：

1. 默认路径：/vendor/etc/camera/ 或 /data/vendor/camera/。
2. 环境变量：如 CAMERA_TUNING_FILE 指定的绝对路径。
3. 设备树（Device Tree）：通过内核设备树节点获取传感器专属配置路径。

3.3.2 格式解析

根据文件扩展名选择解析器：

• XML解析：使用libxml2或Expat库，构建DOM树，支持XPath快速定位节点。
• JSON解析：使用cJSON或RapidJSON，将文件流解析为键值对树结构。

3.3.3 校验合并

解析后的数据需经过三层校验：

3.3.4 内存映射

校验通过后，Tuning工具将配置数据映射到HAL层内存结构体：

// HAL层参数结构体示例
typedef struct {
    char sensor_name[32];
    uint32_t version;
    struct {
        bool enable;
        float r_gain;
        float b_gain;
        int32_t color_temp;
    } awb;
    struct {
        bool enable;
        uint16_t width;
        uint16_t height;
        float *lut_data;  // 指向LUT数据指针
    } lsc;
} SensorConfig_t;

// 加载并映射配置
SensorConfig_t *config = (SensorConfig_t *)malloc(sizeof(SensorConfig_t));
parse_and_map("IMX586_config.xml", config);
// 注册到ISP驱动回调
isp_register_config_callback(sensor_id, config);

3.4 配置文件结构设计最佳实践

• 模块化拆分：将AWB、AE、AF、LSC等模块参数拆分为独立文件，HAL层按需加载，减少单次解析开销。
• 版本兼容：在根节点保留 min_version 和 current_version 属性，HAL层根据版本号决定是否启用新字段。
• 注释保留：XML格式天然支持注释，用于标注参数来源、调试日期、责任人；JSON可增加 "_comment" 字段模拟注释。
• 二进制后备：对于LSC、AWB网格等大型LUT数据，建议在XML/JSON中仅存储文件路径，运行时通过mmap直接加载二进制文件，避免文本解析性能瓶颈。