4. 地址适配问题场景：硬件地址与软件地址不匹配、多从设备地址冲突、地址偏移处理

在 QNX I2C 驱动移植与适配过程中，地址问题是导致通信失败的最常见原因之一。硬件设计、芯片手册与软件配置之间的细微差异，往往需要开发者具备敏锐的排查能力。本节将系统梳理三种典型地址适配场景，并提供对应的调试方法与解决策略。

4.1 硬件地址与软件地址不匹配

这是最频繁出现的地址问题。硬件工程师在原理图中标注的地址，与驱动代码中写入的地址往往存在差异，根源在于地址的表示方式不同。

4.1.1 地址表示方式对比

4.1.2 调试步骤与验证方法

1. 确认硬件原理图标注：检查从设备 ADDR 引脚的电平配置，计算理论 7 位地址。
2. 查阅芯片数据手册：确认手册中地址的表示格式（7 位还是 8 位）。
3. 检查 I2C 控制器驱动：确认控制器是否自动左移地址位。
4. 使用逻辑分析仪抓取波形：观察 SDA 线上实际发送的地址字节，与预期对比。
5. 调整驱动代码：根据上述分析，修正 i2c_addr 或 slave_addr 参数。

4.2 多从设备地址冲突

当 I2C 总线上挂载多个同型号或地址可配置的设备时，若未正确设置地址引脚，会导致地址冲突，总线无法正常通信。

4.2.1 冲突场景分析

• 同型号设备默认地址相同：多数 I2C 传感器在未配置地址引脚时使用默认地址。
• 地址引脚电平配置错误：硬件设计未按预期拉高/拉低 ADDR 引脚。
• 地址范围重叠：不同设备虽然型号不同，但地址可能重叠（如 0x48 被多个设备使用）。

4.2.2 检测与解决策略

4.2.3 地址冲突解决矩阵

4.3 地址偏移处理

部分 I2C 从设备支持多个子地址或寄存器地址偏移，驱动需要正确处理偏移量才能访问正确的内部寄存器。地址偏移处理不当会导致读写数据错位或设备无响应。

4.3.1 偏移类型与处理方式

4.3.2 典型代码实现

以下示例展示如何正确处理带寄存器地址偏移的 I2C 读写操作：

/* 带寄存器地址偏移的 I2C 写操作 */
int i2c_write_reg(int fd, uint8_t dev_addr, uint8_t reg_addr, 
                  uint8_t *data, uint16_t len) {
    uint8_t buffer[len + 1];
    buffer[0] = reg_addr;  /* 第一个字节为寄存器地址 */
    memcpy(&buffer[1], data, len);
    
    /* 发送设备地址 + 寄存器地址 + 数据 */
    return i2c_write(fd, dev_addr, buffer, len + 1);
}

/* 带寄存器地址偏移的 I2C 读操作 */
int i2c_read_reg(int fd, uint8_t dev_addr, uint8_t reg_addr,
                 uint8_t *data, uint16_t len) {
    /* 先写寄存器地址，再重新开始读取数据 */
    int ret = i2c_write(fd, dev_addr, &reg_addr, 1);
    if (ret != 0) return ret;
    
    /* 重新发送 START 条件后读取 */
    return i2c_read(fd, dev_addr, data, len);
}

4.3.3 地址偏移调试要点

• 确认寄存器映射表：仔细阅读芯片手册的寄存器地址定义，注意地址是 8 位还是 16 位。
• 验证偏移计算：对于 16 位寄存器地址，注意字节序（大端/小端）问题。
• 测试边界条件：测试页边界、块边界处的读写操作，确保地址递增逻辑正确。
• 使用回读验证：写入数据后立即回读，对比数据一致性。

4.4 地址适配综合调试清单

以下清单总结了地址适配调试过程中的关键检查点，可作为移植调试的快速参考：