gt911 --- GT911 5点静電容量式タッチコントローラー¶
gt911 モジュールは、Goodix GT911 投影型静電容量式タッチスクリーンコントローラーのドライバーを提供します。これは 4.3〜7 インチの 800x480 LCD パネルとよく組み合わせて使用されます。コントローラーは最大5点の同時タッチポイントを追跡し、それぞれを (x, y, size, id) タプルとして報告します。id は指がパネルに接触している限り、読み取りをまたいで安定しています。
ドライバーは I2C 経由でチップと通信し、2つの追加 GPIO を使用します:
リセット ラインは、電源投入時に Low に保持され、IRQ ラインと一緒に切り替えることで GT911 の 7 ビット I2C アドレスを選択します(リセット時に IRQ が Low の場合は
0x5D、IRQ が High の場合は0x14)。割り込み ラインは、タッチイベントが発生したときにコントローラーによってアサートされます。
作成後、アプリケーションは GT911.read_points() でタッチをポーリングするか、IRQ ピンの立ち下がりエッジで呼び出される touch_callback を指定できます。
class GT911 -- 5点静電容量式タッチコントローラー¶
- class gt911.GT911(bus: machine.I2C, reset_pin: int | str, irq_pin: int | str, address: int = _DEFAULT_ADDR, width: int = 800, height: int = 480, touch_points: int = 1, reverse_x: bool = False, reverse_y: bool = False, reverse_axis: bool = True, sito: bool = True, refresh_rate: int = 240, touch_callback: Callable | None = None)¶
GT911 タッチスクリーンコントローラーオブジェクトを作成します。
busは GT911 が接続されているmachine.I2Cバスオブジェクトです。reset_pinは GT911 のリセットラインに接続されたピン番号または名前です(Pinオブジェクトではありません)。ドライバーはリセット中にピンの方向を変更する必要があります。irq_pinは GT911 の割り込みラインに接続されたピン番号または名前です(Pinオブジェクトではありません)。ドライバーはリセット中にピンの方向を変更する必要があります。addressはコントローラーの I2C アドレスです。デフォルトはgt911._DEFAULT_ADDRです。widthは X 軸方向のタッチパネル解像度(ピクセル単位)です。heightは Y 軸方向のタッチパネル解像度(ピクセル単位)です。touch_pointsは報告する同時タッチポイントの最大数(1〜5)です。reverse_xが True の場合、X 軸を反転します。reverse_yが True の場合、Y 軸を反転します。reverse_axisが True の場合、X 軸と Y 軸を入れ替えます。sitoが True の場合、コントローラーの Single-Input-Touch-Output モードを有効にします。refresh_rateはタッチ報告レート(Hz)です。touch_callbackは、タッチイベント発生時に IRQ ピンの立ち下がりエッジで呼び出されるオプションの呼び出し可能オブジェクトです。ポーリングモードを使用するにはNoneを渡します。