CST328: セットアップ・トラブルシューティング

CST328の概要

これらの数値にはHynitronのデータシートを使用していません。オンラインで見つかったコピーは販売代理店によるアップロードであったため、上記の値はドライバのソースコードおよびボードのドキュメントに基づいています。

CST3530への変更

LilyGOのT-Deck Pro READMEによると、CST328の供給元は「生産を終了」しており、そのため新しいT-Deck Pro v1.1ボードではCST3530が使用されています。さらに「両チップは同じデバイスアドレスを使用する」と記載されており、ファームウェアは初期化時にチップを識別する必要があります。LilyGOはCST3530にHynitronの cst66xx ルーチンを、CST328に cst3xx を使用しています。

WaveshareのRP2350-Touch-LCD-2.8でも同じ変更が行われました。RS-Keyプロジェクトでは、V1はCST328（アドレス 0x1A）、V2はCST3530（アドレス 0x58）であることが記録されています。T-Deck Proではアドレスは変わりませんが、このボードでは変わります。

CST3530 に関する記述は、作者が V2 ボードでテストした RS-Key のマージ済みドライバーと、LilyGO の README に基づいています。

チップの入れ替わりで現れる症状

この問題に遭遇した両プロジェクトとも、同じ現象を報告しています。ファームウェアは動作しディスプレイも描画されるのに、タップがまったく検知されないというものです。reticulum-tdeck のイシューによると、T-Deck Pro v1.1 の個体によって動作するものとしないものがあり、これは配線不良というよりも生産ロット間の変更に合致します。

さらに注意すべき落とし穴が 2 つあります。

• I2C スキャンではチップを特定できません。 T-Deck Pro では両チップとも 0x1A で応答します。reticulum-tdeck の作者らは CST3530 を先にプローブしています。CST3530 が「CST328 のレジスタ読み出しを普通に ACK する」ためです。また、このコードは CST3530 ボード上ではまだ実行されていないとも述べています。T-Deck Pro V1.1 での meshcore-firmware のベンチテストでも同じ結果が示されています。CST328 方式の読み出しは ACK されたもののチップタイプも解像度も返らず、一方 CST3530 方式の読み出しでは 0xCA 0xCA のマーカーとパネルの 240×320 解像度を含む有効なブロックが返されました。
• 他のドライバーが 0x1A を名乗る場合があります。 ある公開中の Meshtastic プルリクエストでは、ステータスレジスタのテストが偶然一致したため、I2C スキャンが T-Deck Pro のタッチチップを DS2482-800 ブリッジと誤認したと報告されています。

これは小型タッチコントローラでよく見られるパターンです。ボード上の型番はそのままでも、チップが変更されることがあります。量産で調達する場合は、ディスプレイサプライヤーに搭載されているタッチ IC の種類を確認し、変更があれば事前に通知してもらえるよう依頼してください。変更通知に何が含まれるべきかについては、EOL・PCN 用語集で解説しています。

ESPHome でのブリングアップ

ESPHome の cst328 プラットフォームは I2C の設定が必要で、オプションとして interrupt_pin と reset_pin を受け付けます。セットアップ時の動作は以下のとおりです。

• リセットを 5 ms 間 Low にパルスした後、待機します。
• ファームウェアの CRC を読み出し、0xCACA を期待します。それ以外の値の場合は、コンポーネントを失敗としてマークします。
• チップタイプ、プロジェクト ID、ファームウェアリビジョン、解像度を読み出した後、チップを通常モードに切り替えます。

ESPHome がタッチスクリーンの失敗を報告した場合、最初に確認すべき箇所がこの CRC チェックです。ESPHome は 2 バイトのレジスタアドレスによる CST328 方式の読み出しを使用しており、meshcore-firmware のベンチテストでは、この方式の読み出しは CST3530 から有用な値を返しませんでした。したがって、CST3530 搭載のボードではこのチェックが失敗すると想定してください。これは当社の推測であり、CST3530 ボード上で ESPHome を実行したわけではありません。

ドライバー対応状況

• ESPHome: cst328 プラットフォーム。ドキュメントでは Waveshare ESP32-S3 Touch LCD 2.8 ボードが名指しされています。CST3530 用のプラットフォームはありません。
• ESP-IDF: Waveshare が esp_lcd_touch_cst328 を Espressif コンポーネントレジストリで公開しています。互換性テーブルには CST328 のみが記載されています。
• Rust: crates.io の cst328 クレート、および両チップに対応した RS-Key ファームウェア。
• Hynitron 純正ドライバー: 両チップについて、LilyGO が Hynitron の hyn_driver ソースをリンクしています。

関連コントローラ

丸型ディスプレイでのシングルタッチには、同じく Hynitron 製の CST816S をご覧ください。最大 5 点対応のより大きなパネルには、GT911 をご覧ください。