FT6336：设置与常见问题排查

FT6336 概览

数据手册的特性列表给出的是 2.8 V 至 3.6 V，而其直流参数表将 VDDA 和 VDD3 列为 2.8 V 至 3.3 V。除非模块供应商另有说明，请按较窄的范围进行设计。

你使用的是哪款 FT6336？

这些数据来自两份 FocalTech 数据手册：FT6336G v1.0 和 FT6X36 系列 v0.3。我们没有找到 FT6336U 的数据手册，因此关于它的信息来自驱动源代码。

读取触点数据

ESPHome 的 FT63x6 源代码会读取以下寄存器：

第二个触点采用相同布局，地址向上偏移 6 字节，从 0x09 开始。ESPHome 会忽略 0x00 或 0xFF 的触点数量。

复位与上电时序

摘自 FT6336G 数据手册：

• 复位脉冲（Trst）：RSTN 引脚保持低电平至少 5 ms。
• 复位后（Trsi）：至少需要 300 ms 才开始上报触点。
• 上电后（Tpon）：至少需要 300 ms 才开始上报触点。
• 上电前：将 RSTN 保持为低电平。同时建议将 INT 和 I2C 线也保持为低电平。
• 重新上电：让电源电压降至 0.3 V 以下并保持超过 5 ms。

各驱动在这方面的做法不同。Linux 的 edt-ft5x06 驱动在释放复位后等待 300 ms，与数据手册一致。ESPHome 的复位流程将复位保持 10 ms，释放后不添加任何等待。Espressif 的 FT5x06 驱动将复位保持 10 ms，然后等待 10 ms。

工作模式与 I2C

数据手册列出了三种模式：

• Active（主动）：默认以每秒 60 帧的速率扫描，主机可以更改此速率。
• Monitor（监测）：默认以每秒 25 帧的速率扫描。触摸会使它返回 Active 模式。数据手册称在此模式下"串口关闭"。
• Hibernation（休眠）：掉电模式，需要复位或来自主机的唤醒信号才能退出。

Monitor 模式的说明可能影响空闲面板上的 I2C 扫描。我们并未亲自测量过这一点，因此在排查时可将其列为待排除因素：扫描时触摸一下面板。

常见症状与解决方法

驱动支持

• ESPHome: 使用 ft63x6 平台，可选配置 reset_pin 和 interrupt_pin。I2C 必须已配置。其文档中提到的开发板为 WT32-SC01，其源码日志中为 FT6336U。
• Linux: 没有 FT6336 的条目。最接近的是 edt-ft5x06 驱动中的 focaltech,ft6236，支持 2 个触摸点，且必须提供 compatible、reg 和 interrupts 属性。我们尚未在 FT6336 上测试过此驱动。
• ESP-IDF: esp_lcd_touch_ft5x06 驱动默认使用地址 0x38 和 100 kHz。其源码最多覆盖 5 个触摸点，且未提及 FT6336，因此依赖它之前请先核对你的具体型号。
• Arduino: Adafruit 的 FT6206 库定义了 FT6336U 的芯片 ID，并默认使用地址 0x38。

相关控制器

圆形显示屏的单指触摸，请参见 CST816S。更大的面板，请参见 GT911。M5Stack Core2 是使用 FT6336U 的开发板之一。