スクリーンの使用
- LCD HDMIスクリーンの使用
- LCD DSIスクリーンの使用
- G2TとTFTスクリーンを使用する


注意事項:
- システム拡張ボードをインストールする前に、上位機器が電源をオフにしていることを確認してください。
- 濕度やほこりの多い環境では拡張ボードを使用しないでください。
- スクリーンをインストールする際は、電力を抜き差ししないよう注意し、画面線の向きを確認して破損を防いでください。
- ファンをインストールする際は、ファンの電流と電圧仕様を確認して破損を防いでください。
- UART1は既にデフォルトで有効化されており、設定は不要です。
- 最新のミラーリングイメージをフラッシュしてください(例:
mainsailos
),カーネルのアップグレードではありません。 - ラズベリーピーはすべてのインターフェースを使用できます!!!
- 注意:ラズベリーピーに使用されるシステムカーネルバージョンは5.17.xより大きい必要があり、カーネルバージョンを確認するにはコマンド
uname -r
を実行してください
ラズベリーピープリインストールTFTV2システムダウンロードリンク
- RPi 3B/3B+/4B/CM4/5B向けのシステムイメージ
https://cdn.mellow.klipper.cn/IMG/Beta/RPI-TFT-IMG-new.img.xz
スクリーンドライバーのインストール
- 事前にインストールされたシステムを使用することも可能です。
- プロジェクトアドレス:FLY-TFT
ご紹介
FLY-TFT-V2はST7796ベースのTFT液晶ディスプレイで、キャパシティブタッチとレジスタティブタッチの両方をサポートしています。解像度は320x480で、SPIインターフェースを使用します。
- KlipperScreenのインストールが必要です(https://klipperscreen.readthedocs.io/en/latest/Installation/)
システムのインストール
注意:ラズベリーピーに使用されるシステムカーネルバージョンは5.17.xより大きい必要があり、カーネルバージョンを確認するにはコマンドuname -r
を実行してください
最新のミラーリングイメージをフラッシュしてください(例:mainsailos
),カーネルのアップグレードではありません
- 最新の MainsailOS をインストールするためにRaspberry Imagerを使用します
- Raspberry Imagerをダウンロードしインストールします
- Raspberry Imagerを開きます
- CHOOSE DEVICEをクリックします
- お使いのデバイスに対応するモデルを選択します
- CHOOSE OSをクリックします
- Other specific-purpose OSを選択します
- 3D printingを選択します
- Mainsail OSを選択します
- 最新のバージョンを選択します。設定が64ビットシステムをサポートしている場合はrpi64を選択します
- CHOOSE STORAGEをクリックします
- お使いのストレージデバイスを選択します(例:SDカード)
- NEXTをクリックし、インストールが完了するまで待ちます
ドライバーのインストール
- FLY-TFT-V2ドライバーのインストール
git clone https://github.com/kluoyun/FLY-TFT.git
cd FLY-TFT
sudo chmod +x ./scripts/install.sh
./scripts/install.sh
TFT表示の有効化
- タッチ機能を有効にするためにI2Cサポートが必要です。対応する設定は
dtparam=i2c_arm=on
- ドライバーのインストール後、config.txtファイルに
dtoverlay=fly-tft-v2
のオーバーレイサポートを追加する必要があります /boot/config.txt
(bookwormシステムの場合/boot/firmware/config.txt
)を開きますsudo nano /boot/config.txt
- ファイルの最後に次の設定を追加します
dtoverlay=fly-tft-v2
- デフォルトでは画面は90度横向きに表示されます。画面を回転させる場合は次の設定を使用します
dtoverlay=fly-tft-v2,r90 # デフォルトの向きと同じで横向き
dtoverlay=fly-tft-v2,r270 # 270度横向き(反転)
dtoverlay=fly-tft-v2,r0 # 0度縦向き(反転なし)
dtoverlay=fly-tft-v2,r180 # 180度縦向き(反転)
- 任意の設定を1つだけ追加できます。複数の設定を追加することはできません
- 通常、TFTのタッチ機能は表示方向に自動的に同期しますので、システム内のタッチ設定を変更する必要はありません
- ファイルの最後に設定を追加した後、コマンド
sudo reboot
を実行してシステムを再起動します
TFTの使用
- ハードウェア接続が正しく行われていることを確認してください
- ドライバーがインストールされていることを確認してください
/boot/config.txt
(bookwormシステムの場合/boot/firmware/config.txt
)ファイルにdtoverlay=fly-tft-v2
のオーバーレイサポートが追加されていることを確認してください- 一部のシステムではデフォルトでfb0デバイスが存在することがあります。FLY-TFTはfb1デバイスに割り当てられる場合があります。fb1デバイスを有効にするために設定ファイルを変更する必要があります
- デバイスを確認するため、コマンド
ls /dev/fb*
を実行します。fb0とfb1の2つのデバイスが表示された場合は、fb1デバイスを有効にするために次のコマンドを実行してください - fb1デバイスをデフォルトとして設定するため、次のコマンドを実行します
sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf
KlipperScreenの使用
- MainsailOSはデフォルトでKlipperScreenをインストールしていません。手動でインストールする必要があります
- KlipperScreenのインストールについてはKlipperScreenを参照してください、またはkiauhを使用してインストールしてください
- KlipperScreenが正常にインストールされ、第5ステップが正しく完了した場合、KlipperScreenのインターフェースが表示されるはずです
利用可能な全設定
-
speed
[パラメータが必要]:TFTの最大SPIクロック周波数を設定します。単位はHzで、デフォルト値は96000000です(表示が乱れる場合はこの値を適切に下げてください) -
例:
dtoverlay=fly-tft-v2,speed=80000000
-
r0/r90/r180/r270
[オプション][パラメータが必要ない]:TFTの表示とタッチ方向を設定します。デフォルトは90度で、選択可能な値は0,90,180,270です(任意の設定を1つだけ追加できます) -
例:
dtoverlay=fly-tft-v2,r90
またはdtoverlay=fly-tft-v2,r180
-
disable_touch
[パラメータが必要ない]:TFTのタッチ機能を無効化します。デフォルトは有効です -
例:
dtoverlay=fly-tft-v2,disable_touch
-
invx
,invy
[パラメータが必要ない]:TFTのタッチ方向を設定します。invx
はX方向の反転、invy
はY方向の反転を意味します -
例:
dtoverlay=fly-tft-v2,invx
またはdtoverlay=fly-tft-v2,invy
またはdtoverlay=fly-tft-v2,invx,invy
-
swapxy
[パラメータが必要ない]:TFTのタッチ方向を設定します。X軸とY軸が入れ替わります。つまり横向きになります- 例:
dtoverlay=fly-tft-v2,swapxy
- 例:
注意: すべてのパラメータを同時に設定することができます(オプションのパラメータは1つだけ設定できます)。複数のパラメータはコンマで区切ります。複数のパラメータは同一行にのみ追加できます
警告: 通常、
r0
,r90
,r180
,r270
の4つのパラメータのみが使用されます。その他のパラメータは特殊な状況でのみ使用されます、特にinvx
,invy
,swapxy
- 例:
dtoverlay=fly-tft-v2,speed=80000000,r270