4. FT5x06 寄存器映射：地址空间与关键寄存器详解

FT5x06 系列触摸屏控制器通过 I²C 接口与主机通信，其内部寄存器采用 8 位地址 + 8 位数据 的映射方式。理解寄存器地址空间和关键寄存器的含义，是驱动移植与多点触控调试的基础。本章将系统性地解析 FT5x06 的寄存器布局、设备模式控制、手势识别以及触摸点数据读取等核心内容。

4.1 寄存器地址空间总览

FT5x06 的寄存器地址范围为 0x00 ~ 0xFF，共 256 个字节。根据功能可划分为以下几个区域：

4.2 设备模式与手势 ID 寄存器

4.2.1 设备模式寄存器（地址 0x00）

该寄存器用于控制 FT5x06 的工作模式，同时也是主机读取触摸数据前的状态指示。其位定义如下：

在驱动中，通常将 0x00 写入该寄存器以唤醒设备进入工作模式。读取该寄存器时，若 Bit[3:0] 为 0x00，表示设备已准备好上报触摸数据。

4.2.2 手势 ID 寄存器（地址 0x01）

FT5x06 支持多种单点手势识别，手势 ID 寄存器用于指示当前检测到的手势类型。常见手势 ID 定义如下：

4.3 触摸点状态与数据寄存器

4.3.1 触摸点状态寄存器（地址 0x02）

该寄存器指示当前有效触摸点的数量，是驱动轮询触摸数据的入口。其位定义如下：

驱动读取流程：

1. 读取 0x02 寄存器，获取触摸点数 td_status。
2. 若 td_status > 0，则依次读取触摸点数据寄存器。
3. 读取完成后，向 0x00 寄存器写入 0x00，清除中断标志并准备下一轮数据。

4.3.2 触摸点数据寄存器布局（地址 0x06 ~ 0x1D）

每个触摸点占用 6 个字节，最多支持 5 个点。数据寄存器地址映射如下：

坐标计算公式：

X = (XH & 0x0F) << 8 | XL
Y = (YH & 0x0F) << 8 | YL

4.4 寄存器映射与数据流 SVG 架构图

下图展示了 FT5x06 寄存器地址空间、关键寄存器与驱动数据读取流程之间的整体关系：

4.5 关键寄存器配置示例

以下代码展示了在驱动初始化阶段，如何配置 FT5x06 的关键寄存器以进入正常工作模式：

/* FT5x06 寄存器配置示例 */
static int ft5x06_configure(struct i2c_client *client)
{
    int ret;
    u8 val;

    /* 1. 读取芯片 ID 验证通信 */
    ret = i2c_smbus_read_byte_data(client, 0xA8);
    if (ret < 0) {
        dev_err(&client->dev, "Failed to read chip ID\n");
        return ret;
    }
    dev_info(&client->dev, "Chip ID: 0x%02x\n", ret);

    /* 2. 设置设备模式为工作模式 */
    val = 0x00;
    ret = i2c_smbus_write_byte_data(client, 0x00, val);
    if (ret < 0) {
        dev_err(&client->dev, "Failed to set device mode\n");
        return ret;
    }

    /* 3. 关闭手势识别功能（可选，避免干扰多点触摸） */
    val = 0x00;
    ret = i2c_smbus_write_byte_data(client, 0x01, val);
    if (ret < 0) {
        dev_err(&client->dev, "Failed to disable gesture\n");
        return ret;
    }

    /* 4. 设置触摸阈值（地址 0x80，默认值 22） */
    val = 22;
    ret = i2c_smbus_write_byte_data(client, 0x80, val);
    if (ret < 0) {
        dev_err(&client->dev, "Failed to set threshold\n");
        return ret;
    }

    dev_info(&client->dev, "FT5x06 configured successfully\n");
    return 0;
}

4.6 寄存器调试技巧

• 验证 I²C 通信： 使用 i2cget 命令读取 0xA8 寄存器，正常应返回 0x06（FT5x06）或 0x08（FT5x16）。
• 检查触摸中断： 读取 0x02 寄存器，当手指触摸时返回值应大于 0；若始终为 0，检查中断引脚配置和硬件连接。
• 坐标数据验证： 读取 0x06 ~ 0x0B 的 6 个字节，手动计算 X/Y 坐标，与屏幕显示位置对比，判断坐标映射是否正确。
• 寄存器转储： 在驱动中增加调试接口，通过 sysfs 导出整个寄存器空间（0x00 ~ 0xFF），便于离线分析。