کنترلر تاچ GT911: آدرس I2C، توالی ریست، رجیسترها و پیکربندی

GT911 یک کنترلر تاچ خازنی 5 نقطه‌ای از Goodix برای پنل‌های حدود 7 تا 8 اینچ است. با I2C تا 400 kbit/s روی آدرس 0x5D یا 0x14 کار می‌کند که با سطح پایهٔ INT در لحظهٔ آزادشدن RESET انتخاب می‌شود، و هر انگشت را به‌صورت یک رکورد 8 بایتی از رجیستر 0x814F به بعد گزارش می‌دهد. بیشتر مشکلات راه‌اندازی از سه جا می‌آید: توالی ریست، پاک‌نکردن رجیستر وضعیت 0x814E بعد از خواندن، و نوشتن پیکربندی بدون checksum آن.

دریافت پیشنهاد قیمت پنل لمسی و شیشهٔ محافظ

GT911 reset sequence and I2C address selection timingTiming diagram with three traces: VDD, RESET and INT. After power is up, the host drives INT low to select I2C address 0x5D, or high to select 0x14, and pulls RESET low for more than 100 microseconds. RESET is then released while INT is held at the chosen level for at least 5 milliseconds. INT is then switched to a floating input, and the host waits 50 milliseconds before writing configuration over I2C.GT911 reset and I2C address selectionVDDRESETINTINT low: address 0x5DINT high: address 0x14INT becomes a floating inputRESET low, more than 100 µshold INT at least 5 mswait 50 ms, then write config over I2CI2C ready
شکل: GT911 هنگام آزادشدن RESET سطح INT را می‌خواند. سطح پایین آدرس 0x5D و سطح بالا 0x14 را انتخاب می‌کند؛ بعد INT را آزاد کنید و پیش از نوشتن پیکربندی 50 ms صبر کنید.

GT911 چیست

کنترلر تاچ الکترودهای فرستندهٔ سنسور خازنی را تحریک می‌کند، الکترودهای گیرنده را اندازه می‌گیرد و تغییرات را به مختصات انگشت تبدیل می‌کند. GT911 این کار را برای حداکثر 5 انگشت انجام می‌دهد و نتیجه را از طریق I2C به میزبان می‌دهد. ارقام اصلی از دیتاشیت و راهنمای برنامه‌نویسی Goodix:

موردGT911
تعداد نقاط لمسحداکثر 5
کانال‌های سنسور26 کانال drive (Tx)، 14 کانال sense (Rx)
اندازهٔ صفحهٔ هدف7 تا 8 اینچ
نرخ گزارش100 Hz
رابط میزبانI2C، حداکثر 400 kbit/s، به‌علاوهٔ INT و RESET
تغذیهAVDD از 2.8 تا 3.3 V، VDDIO از 1.8 تا 3.3 V
بسته‌بندیQFN52، 6 × 6 × 0.8 mm

یک نکته را در نسخهٔ دیتاشیت خودتان بررسی کنید: فهرست ویژگی‌ها −40 تا +85 °C را ذکر می‌کند، در حالی که جدول شرایط کاری توصیه‌شده −20 تا +85 °C را. اگر محصول شما زیر −20 °C کار می‌کند، از تأمین‌کننده بخواهید تأیید کند کدام‌یک معتبر است.

آدرس I2C در GT911: 0x5D یا 0x14

GT911 در هر بار روشن‌شدن یا ریست، آدرسش را از سطحی که میزبان روی INT گذاشته انتخاب می‌کند. با INT در سطح پایین، آدرس 0x5D انتخاب می‌شود (0xBA برای نوشتن، 0xBB برای خواندن). با INT در سطح بالا، آدرس 0x14 (0x28 و 0x29). آدرس جایی ذخیره نمی‌شود؛ پس بردی که در زمان ریست INT را شناور رها کند ممکن است با هر کدام از دو آدرس بالا بیاید.

اگر اسکن چیزی پیدا نکرد، سه چیز را بررسی کنید: اینکه میزبان در زمان ریست واقعاً INT را درایو می‌کند و آن را به یک pull-up ضعیف نسپرده است، اینکه RESET واقعاً تغییر وضعیت می‌دهد، و اینکه مقاومت‌های pull-up روی SDA و SCL با سرعت باس جور است. Goodix توصیه می‌کند بالاتر از 200 kbit/s به مقدار مقاومت‌های pull-up توجه کنید.

توالی ریست GT911

  1. INT را به‌صورت خروجی درایو کنید: پایین برای 0x5D، بالا برای 0x14.
  2. RESET را بیش از 100 µs پایین نگه دارید.
  3. RESET را بالا ببرید تا آزاد شود و INT را دست‌کم 5 ms در سطح انتخاب‌شده نگه دارید.
  4. INT را به ورودی شناور تغییر دهید.
  5. پیش از نوشتن پیکربندی 50 ms صبر کنید.

درایور Zephyr هم همین الگو را با حاشیه‌های دست‌ودل‌باز دنبال می‌کند: 20 ms پس از روشن‌شدن، 1 ms در حالت ریست، 5 ms نگه‌داشتن INT و 50 ms انتظار. این حاشیه‌ها کمتر از 80 ms به زمان راه‌اندازی اضافه می‌کنند.

خواندن نقاط لمس از GT911

رجیستر 0x814E بایت وضعیت است. بیت 7 می‌گوید مختصات جدید آماده است و بیت‌های 3 تا 0 تعداد نقاط لمس را نگه می‌دارند. رکوردهای نقاط از 0x814F به بعد می‌آیند، هر کدام 8 بایت: شناسهٔ track، بایت پایین X، بایت بالای X، بایت پایین Y، بایت بالای Y، بایت پایین size، بایت بالای size و یک بایت رزرو. بعد از خواندن، 0 را در 0x814E بنویسید. اگر این مرحله را جا بیندازید، کنترلر دادهٔ جدیدی ارائه نمی‌کند.

در حالت polling، رجیستر 0x814E را بخوانید و اگر بیت 7 صفر بود، بعد از حدود 1 ms دوباره امتحان کنید. در حالت وقفه، INT با هر به‌روزرسانی مختصات یک پالس می‌دهد و میزبان باید بافر را در فاصلهٔ یک دورهٔ گزارش بخواند و پاک کند.

مثال عددی: تاچ چقدر از باس I2C را اشغال می‌کند. خواندن بایت وضعیت و پنج نقطه یعنی آدرس رجیستر 2 بایتی، 41 بایت داده و دو بار ارسال آدرس دستگاه، یک بار برای نوشتن و یک بار برای خواندن: در مجموع 45 بایت، یا 405 زمان بیت با 9 بیت برای هر بایت. در 400 kbit/s این کار حدود 1.0 ms طول می‌کشد؛ نوشتنی که وضعیت را پاک می‌کند 4 بایت، یعنی حدود 0.09 ms، اضافه می‌کند. با نرخ گزارش 100 Hz، هر 10 ms یک گزارش جدید می‌آید؛ پس تاچ حدود 11 درصد باس را مشغول نگه می‌دارد. در 100 kbit/s همین خواندن حدود 4.4 ms طول می‌کشد، یعنی بیش از 40 درصد هر دوره، که اگر دستگاه‌های دیگر هم روی همین باس باشند مهم است.

پیکربندی: بلوک 184 بایتی و checksum آن

پیکربندی در 0x8047 تا 0x80FE قرار دارد، یعنی 184 بایت. بایت اول نسخهٔ پیکربندی است که به‌صورت یک حرف از A تا Z ذخیره می‌شود. فیلدهای دیگر رزولوشن خروجی، سقف تعداد لمس در 0x804C و زمان‌بندی گزارش را تعیین می‌کنند. قواعد نوشتن آن:

  • checksum را به‌صورت مکمل دو (two’s complement) مجموع 8 بیتی این 184 بایت حساب کنید و در 0x80FF بنویسید. اگر مجموع بایت‌ها 0x3A7C باشد، بایت پایین 0x7C است و checksum برابر 0x100 منهای 0x7C، یعنی 0x84 می‌شود.
  • مقدار 1 را در 0x8100، یعنی پرچم Config_Fresh، بنویسید. بدون checksum و این پرچم، GT911 بلوک جدید را نادیده می‌گیرد.
  • اول شناسهٔ محصول را از 0x8140 بخوانید. این رجیستر نویسه‌های ASCII «911» را برمی‌گرداند.

سازندهٔ پنل پیکربندی را برای الگوی سنسور، شیشهٔ پوششی و لایه‌بندی خودش تنظیم می‌کند. بلوکی که از برد دیگری کپی شده ممکن است مختصات جابه‌جا، لمس‌های شبح (phantom) یا لبه‌های مرده بدهد. روی پنلی که درست کار می‌کند، جز فیلدهای رزولوشن و جهت چیزی را تغییر ندهید، مگر اینکه تأمین‌کننده بلوک جدیدی به شما بدهد.

مقایسهٔ GT911 با کنترلرهای تاچ خازنی دیگر

در کاتالوگ خود ما، پنل لمسی 7 اینچ S700GG-42 از GT911 استفاده می‌کند، مدل 10 اینچ S10GF2-94 از FocalTech FT5426G و مدل 3.5 اینچ S35001D از FT5446 با 10 نقطهٔ لمس. هر سه با I2C کار می‌کنند، اما قطعه‌های FocalTech نقشهٔ رجیستر خودشان را دارند؛ پس درایور GT911 آن‌ها را نمی‌خواند. وقتی پنل را عوض می‌کنید، پیش از استفادهٔ دوباره از firmware شمارهٔ قطعهٔ کنترلر را بررسی کنید.

مرجعاندازهکنترلر تاچرابطابعاد بیرونی (مرجع)
S700GG-427 اینچGT911I²C164.4 × 99.5 mm
S10GF2-9410 اینچFT5426GI²C247 × 152 mm
S35001D3.5 اینچ، نمایشگر و تاچFT5446-P03I²C76.96 × 63.96 mm

استفاده از GT911 با Arduino، ESP32 یا Linux

برای بیشتر پلتفرم‌ها درایور آماده وجود دارد. Zephyr درایور input_gt911 دارد، ESPHome یک کامپوننت touchscreen به نام gt911 دارد، MicroPython روی OpenMV ماژول gt911 دارد، و Linux کنترلرهای Goodix را با درایور goodix برای صفحهٔ لمسی پشتیبانی می‌کند. روی ESP32 هم همان قواعد INT و RESET برقرار است و تاچ هیچ پایهٔ مشترکی با باس نمایشگر ندارد؛ راهنمای نمایشگر ESP32 را ببینید.

وقتی GT911 انتخاب درستی نیست

  • پنل‌های خیلی بزرگ‌تر از 8 اینچ، که 26 در 14 کانال برایشان کم است. پنل 10 اینچ ما از کنترلر دیگری استفاده می‌کند.
  • بیش از 5 لمس هم‌زمان.
  • شیشهٔ پوششی ضخیم، دستکش یا آب روی صفحه. این‌ها بیشتر به طراحی و تنظیم سنسور بستگی دارند تا به نام کنترلر؛ پس با ساختار نهایی آزمایش کنید. تاچ خازنی با دستکش، آب و شیشهٔ ضخیم را ببینید.

پرسش‌های متداول

آدرس I2C در GT911 چیست؟

اگر INT هنگام آزادشدن RESET پایین نگه داشته شود 0x5D است، و اگر بالا نگه داشته شود 0x14. در قالب 8 بیتی این‌ها 0xBA و 0xBB، یا 0x28 و 0x29 هستند. آدرس در هر ریست دوباره انتخاب می‌شود.

چرا GT911 من روی I2C پاسخ نمی‌دهد؟

معمولاً توالی ریست اشتباه است: INT در زمان ریست درایو نشده، RESET اصلاً تغییر وضعیت نداده، یا میزبان پیش از پایان انتظار 50 ms نوشته است. مقاومت‌های pull-up روی SDA و SCL را هم بررسی کنید و مطمئن شوید هر دو آدرس 0x5D و 0x14 را اسکن می‌کنید.

checksum پیکربندی GT911 را چطور حساب کنم؟

184 بایت پیکربندی از 0x8047 تا 0x80FE را جمع کنید، 8 بیت پایین را نگه دارید و مکمل دو آن را بگیرید. نتیجه را در 0x80FF بنویسید، سپس مقدار 1 را در 0x8100 بنویسید تا کنترلر بلوک جدید را بارگذاری کند.

کنترلر صفحهٔ لمسی چیست؟

تراشه‌ای است که سنسور تاچ خازنی یا مقاومتی را تحریک می‌کند، آن را اندازه می‌گیرد و مختصات لمس را، معمولاً از طریق I2C، به میزبان گزارش می‌دهد. هر خانوادهٔ کنترلر نقشهٔ رجیستر خودش را دارد و به پیکربندی‌ای نیاز دارد که برای سنسور و شیشهٔ پوششی تنظیم شده باشد.

برای نمایشگرتان پنل لمسی انتخاب می‌کنید؟ اندازهٔ نمایشگر، ضخامت شیشهٔ پوششی و پردازندهٔ میزبان را بفرستید و بگویید آیا کنترلر خاصی مثل GT911 لازم دارید. پنل‌های لمسی کاتالوگ و پیکربندی کنترلرشان را با لایه‌بندی شما تطبیق می‌دهیم. پنل‌های لمسی و شیشه‌های پوششی سفارشی را ببینید، یا استعلام پنل لمسی بفرستید.

پیمایش به بالا
ارسال RFQWhatsApp