Ghi chú datasheet FT6336: Địa chỉ I2C, thanh ghi và cách xử lý lỗi cảm ứng

Nhà sản xuất	FocalTech
Loại	Bộ điều khiển cảm ứng
Giao tiếp	I2C
Độ phân giải tối đa	2 touch points

Trả lời nhanh

FT6336 là touch controller cảm ứng điện dung tự thân (self-capacitive) của FocalTech hỗ trợ hai điểm chạm qua I2C, với các thư viện dùng địa chỉ 0x38. Datasheet cho phép SCL tới 400 kHz và xung reset tối thiểu 5 ms, sau đó chờ 300 ms trước khi chip bắt đầu báo dữ liệu. Dữ liệu cảm ứng bắt đầu tại thanh ghi 0x02, và các thư viện đọc chip ID từ 0xA3 (0x64 với FT6336U).

Địa chỉ I2C 0x38 trong driver của Adafruit và Espressif
2 điểm chạm, hoặc 1 điểm cộng với nhận diện cử chỉ
I2C SCL từ 10 đến 400 kHz; tốc độ báo dữ liệu tới 100 Hz
Reset tối thiểu 5 ms, sau đó tối thiểu 300 ms trước khi chip báo dữ liệu
Chip ID tại 0xA3: 0x64 với FT6336U, theo Adafruit

Tổng quan về FT6336

Hạng mục	Giá trị	Nguồn
Điểm chạm	2, hoặc 1 kèm cử chỉ	Datasheet FT6336G
Địa chỉ I2C (7-bit)	`0x38`	Driver Adafruit và Espressif
I2C SCL	10 đến 400 kHz	Datasheet FT6336G
Tốc độ báo cáo	Tối đa 100 Hz	Datasheet FT6336G
Điện áp hoạt động	2.8 V đến 3.6 V	Datasheet FT6336G
IOVCC	Độc lập, 1.8 V đến 3.6 V	Datasheet FT6336G
Nhiệt độ hoạt động	−40 °C đến 85 °C	Datasheet FT6336G

Danh sách tính năng trong datasheet cho biết 2.8 V đến 3.6 V, trong khi bảng DC lại liệt kê VDDA và VDD3 ở mức 2.8 V đến 3.3 V. Hãy thiết kế theo dải hẹp hơn trừ khi nhà cung cấp module của bạn nói khác.

Bạn đang dùng biến thể FT6336 nào?

Model	Số kênh	Vỏ IC (package)	Kích thước tấm nền
FT6336G	31	QFN 5×5, 40 chân	Tới 4.0″
FT6336DMB	36	QFN 6×6, 48 chân	Tới 4.5″

Các số liệu này lấy từ hai tài liệu datasheet của FocalTech: FT6336G v1.0 và loạt FT6X36 v0.3. Chúng tôi không tìm thấy datasheet cho FT6336U, nên những gì trình bày về chip này được suy ra từ mã nguồn driver.

Đọc dữ liệu cảm ứng

Mã nguồn FT63x6 của ESPHome đọc các thanh ghi sau:

Thanh ghi	Nội dung
`0x00`	Chế độ thiết bị (ESPHome ghi `0x00`)
`0x02`	Số điểm chạm, 4 bit thấp
`0x03`	Sự kiện ở bit 7:6, các bit cao của X ở bit 3:0
`0x04`	Byte thấp của X
`0x05`	Touch ID ở bit 7:4, các bit cao của Y ở bit 3:0
`0x06`	Byte thấp của Y
`0x07`	Trọng số điểm chạm
`0x80`	Ngưỡng cảm ứng
`0x88`	Tần số quét khi có điểm chạm (ESPHome ghi `0x0E`)
`0xA3`	Chip ID

Điểm chạm thứ hai dùng cùng cấu trúc, dịch lên 6 byte, bắt đầu tại 0x09. ESPHome bỏ qua số điểm chạm là 0x00 hoặc 0xFF.

Thời điểm reset và cấp nguồn

Theo datasheet FT6336G:

Xung reset (Trst): giữ RSTN ở mức thấp ít nhất 5 ms.
Sau reset (Trsi): ít nhất 300 ms trước khi chip bắt đầu báo tọa độ điểm chạm.
Sau khi cấp nguồn (Tpon): ít nhất 300 ms trước khi chip bắt đầu báo tọa độ điểm chạm.
Trước khi cấp nguồn: giữ RSTN ở mức thấp. Nên giữ cả INT và các đường I2C ở mức thấp.
Ngắt và cấp lại nguồn: để nguồn tụt xuống dưới 0.3 V trong hơn 5 ms.

Các driver xử lý khác nhau ở điểm này. Driver edt-ft5x06 của Linux chờ 300 ms sau khi thả reset, phù hợp với datasheet. Quy trình reset của ESPHome giữ reset ở mức thấp trong 10 ms và không thêm thời gian chờ sau khi thả. Driver FT5x06 của Espressif giữ reset 10 ms, sau đó chờ 10 ms.

Các chế độ hoạt động và I2C

Datasheet liệt kê ba chế độ:

Active: quét với tốc độ mặc định 60 khung hình mỗi giây, và host có thể thay đổi giá trị này.
Monitor: quét với tốc độ mặc định 25 khung hình mỗi giây. Một điểm chạm sẽ đưa chip quay về chế độ Active. Datasheet ghi rõ "cổng nối tiếp bị đóng" trong chế độ này.
Hibernation: chế độ ngắt nguồn, cần reset hoặc tín hiệu đánh thức từ host để thoát ra.

Ghi chú về chế độ Monitor có thể ảnh hưởng đến việc quét địa chỉ I2C trên panel đang ở trạng thái rảnh. Chúng tôi chưa tự đo kiểm chứng điều này, nên hãy coi nó là một nguyên nhân cần loại trừ: chạm vào panel trong khi quét.

Triệu chứng và cách xử lý

Triệu chứng	Cách kiểm tra
Không có gì tại `0x38`	Xác nhận RSTN ở mức cao, chờ 300 ms sau khi reset, sau đó chạm vào mặt kính trong khi quét. Tiếp theo, kiểm tra SDA, SCL và các điện trở pull-up.
ESPHome báo lỗi "FT6336U touch driver failed to start"	ESPHome đọc được `0` từ thanh ghi `0xA3`. Nó ghi log lỗi này rồi tiếp tục chạy, nên hãy kiểm tra đi dây và thời điểm reset.
Thư viện từ chối chip ID	ID khác nhau tùy từng part: Adafruit liệt kê `0x06` cho FT6206, `0x36` cho FT6236 và `0x64` cho FT6236U và FT6336U. Hãy kiểm tra xem thư viện của bạn chấp nhận những giá trị nào.
Cảm ứng quá nhạy hoặc không đủ nhạy	Thanh ghi `0x80` phụ thuộc vào từng tấm panel. Adafruit mặc định là 128, được "hiệu chỉnh" cho màn hình 2.8″ của chính họ, còn driver FT5x06 của Espressif ghi giá trị 70. Đừng mặc định giá trị nào cũng phù hợp với panel của bạn.
Điểm chạm thứ ba không được báo về	Đây là giới hạn của chip: cả datasheet lẫn driver Linux đều cho tối đa 2 điểm. Nếu cần nhiều điểm hơn, xem GT911.

Hỗ trợ driver

ESPHome: dùng platform ft63x6 với các tùy chọn reset_pin và interrupt_pin. I2C phải được cấu hình sẵn. Tài liệu của nó nêu board WT32-SC01, và mã nguồn ghi log FT6336U.
Linux: không có mục riêng cho FT6336. Gần nhất là focaltech,ft6236 trong driver edt-ft5x06, với 2 điểm chạm và các thuộc tính bắt buộc compatible, reg và interrupts. Chúng tôi chưa thử nghiệm với FT6336.
ESP-IDF: driver esp_lcd_touch_ft5x06 dùng địa chỉ 0x38 và 100 kHz theo mặc định. Mã nguồn của nó hỗ trợ tới 5 điểm và không nêu tên FT6336, nên hãy kiểm tra part của bạn trước khi tin dùng.
Arduino: thư viện FT6206 của Adafruit định nghĩa chip ID của FT6336U và mặc định dùng địa chỉ 0x38.

Các controller liên quan

Với cảm ứng một điểm trên màn hình tròn, xem CST816S. Với panel lớn hơn, xem GT911. M5Stack Core2 là một board sử dụng FT6336U.

Hướng dẫn & so sánh

Hướng dẫn

Cách chọn màn hình cho ESP32-S3 (SPI, QSPI, RGB)

Chọn giao tiếp và độ phân giải từ hai con số: bus truyền được bao nhiêu bit mỗi giây và một khung hình cần bao nhiêu bộ nhớ. Kèm số liệu tính toán và cấu hình tham khảo.

FT6336: xử lý sự cố & FAQ

Địa chỉ I2C của FT6336 là gì?

Các driver của Adafruit và Espressif dùng 0x38 (7-bit), và Linux cũng dùng giá trị này trong ví dụ binding của họ FT5x06. Datasheet FT6336G mà chúng tôi đọc không nêu địa chỉ, nên hãy xác nhận bằng cách quét I2C trên board của bạn.

Tại sao FT6336 của tôi không phản hồi trên I2C?

Kiểm tra RSTN đang mức cao, rồi chờ ít nhất 300 ms sau khi reset: đó là mức tối thiểu theo datasheet trước khi chip báo điểm chạm. Datasheet cũng ghi cổng serial bị đóng trong chế độ Monitor mode, nên hãy chạm vào màn hình và quét lại trước khi nghi ngờ phần đi dây.

Sự khác biệt giữa FT6336, FT6336G và FT6336U là gì?

Các datasheet của FocalTech liệt kê FT6336G với 31 kênh cho panel tới 4.0″, và FT6336DMB với 36 kênh cho panel tới 4.5″. Chúng tôi không tìm thấy datasheet cho FT6336U. Thư viện của Adafruit cho nó chip ID 0x64, giống với FT6236U.

FT6336: lưu ý datasheet & cài đặt