ディスプレイの使用
- LCD HDMIディスプレイの使用
- LCD DSIディスプレイの使用
- TFTディスプレイの使用
DSIの使用方法
- イメージの書き込みが完了したら、/boot/config.txtに以下のコマンドを追加します
dtoverlay=vc4-kms-dsi-7inch
- 保存して終了します
注意事項:
- 拡張ボードをインストールする前に、上位機の電源がオフになっていることを確認してください。
- 湿気やほこりの多い環境での拡張ボードの使用は避けてください。
- 画面をインストールする際は、通電中に抜き差ししないでください。また、画面ケーブルの向きに注意して、損傷を防いでください。
- ファンをインストールする際は、ファンの電流と電圧の仕様に注意し、損傷を防いでください。
- UART1はデフォルトで有効になっていますので、再設定は不要です
- 最新のイメージ(例:
mainsailos)を書き込んでください。カーネルのアップグレードではありません。 - Raspberry Piは全てのインターフェースを使用できます!!!
- 注意: Raspberry Piで使用するシステムカーネルバージョンは
5.17.xより大きい必要があります。コマンドuname -rを実行してカーネルバージョンを確認してください。
Raspberry Pi プリインストール TFTV2 システム ダウンロードリンク
-
Raspberry Pi 3B/3B+/4B/CM4/5B に対応するシステムイメージ
-
以下のダウンロードリンクをクリック
-
Loading...
画面ドライバのインストール
- プリインストール済みシステムを直接使用できることに注意してください
- プロジェクトアドレス: FLY-TFT
紹介
FLY-TFT-V2はst7796をベースとしたTFT液晶画面で、静電容量式タッチと抵抗膜式タッチの両方をサポートし、解像度は320x480、SPIインターフェースを使用します。
- KlipperScreen を自分でインストールする必要があります。
システムのインストール
注意: Raspberry Piで使用するシステムカーネルバージョンは5.17.xより大きい必要があります。コマンドuname -rを実行してカーネルバージョンを確認してください。
最新のイメージ(例: mainsailos)を書き込んでください。カーネルのアップグレードではありません。
- Raspberry Pi Imager を使用して最新の MainsailOS をインストール
- Raspberry Pi Imager をダウンロードしてインストール
- Raspberry Pi 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デバイスを有効にしてください (デフォルトはfb0)。 - 以下のコマンドを実行して、デフォルト設定をfb1デバイスに変更します。
sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf
KlipperScreenの使用
- MainsailOSはデフォルトで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