ラズベリーパイ使用説明書
注意事項:
- システムがシャットダウンされてから拡張ボードをインストールしてください。
- 拡張ボードは湿気やほこりの多い環境では使用しないでください。
- スクリーンを取り付ける際には、電源が入っていないことを確認し、ケーブルの向きに注意して取り付け、破損を防いでください。
- ファンを取り付ける際には、ファンの電流と電圧の仕様に注意して取り付け、破損を防いでください。
- UART1は既にデフォルトで有効になっていますので、設定する必要はありません。
- 最新のイメージをフラッシュしてください。例えば
mainsailos
をフラッシュしてください。カーネルをアップグレードするものではありません。 - ラズベリーパイはすべてのインターフェースを使用することができます!!!
- 注意:ラズベリーパイに使用されるシステムのカーネルバージョンは5.17.xより大きい必要があります。カーネルバージョンを確認するには
uname -r
コマンドを実行してください。
ラズベリーパイに事前インストールされたTFTV2システムのダウンロードリンク
- ラズベリーパイzero2/zero2W/2B/3B/3B+/4B/CM4/5B用のシステムイメージ
- このイメージにはKlipper、moonraker、mainsail、fulidd、klipper-screenなどが事前インストールされています。
https://cdn.mellow.klipper.cn/IMG/Beta/RPI-TFT-IMG-new.img.xz
G2Tのインストール
- 参照する下記があります:
- 参照配線:
ボード内蔵RS232接続ツール版の使用方法

- 最新のシステムにフラッシュした後、bootディスクのconfig.txtファイルを編集する必要があります。
- UART1はデフォルトで開かれていますので、システム内で設定する必要はありません。UART3は以下の手順を実行する必要があります。
- config.txtに以下を追加します:
dtoverlay=uart3
- UART1を使用する場合、以下が参照になります:
[mcu]
serial: /dev/ttyAMA0
baud: 250000
restart_method:command
- UART3を使用する場合、以下が参照になります:
[mcu]
serial: /dev/ttyAMA1
baud: 250000
restart_method:command
ボード内蔵5VFANの使用
-
ラズベリーパイ40PIN制御機器を使用する場合は、Klipperチュートリアルに従ってインストールする必要があります。
[mcu host]
serial: /tmp/klipper_host_mcu
[temperature_sensor Raspberry Pi]
sensor_type: temperature_host
[temperature_fan core_fan]
pin: host:gpio12
max_power: 1.0
sensor_type: temperature_host #設定は上位機器の主制御温度
control:watermark #制御方法
target_temp: 48 #上位機器冷却ファン起動温度
min_temp: 0 #最低温度、これより低い温度ではエラーが表示されます
max_temp: 90 #最高温度、これより高い温度ではエラーが表示されます
off_below: 0.10
kick_start_time: 0.50
max_speed: 0.8 #最大回転速度、全電力運転時の80%
min_speed: 0.3 #最小回転速度、全電力運転時の30%
スクリーンの使用方法
- GitHubアドレス FLY-TFT
1. ご紹介
FLY-TFT-V2はST7796ベースのTFT液晶ディスプレイで、キャパシティブタッチとレジスタティブタッチの両方をサポートし、解像度は320x480で、SPIインターフェースを使用します。
2. システムのインストール
- 注意:ラズベリーパイに使用されるシステムのカーネルバージョンは5.17.xより大きい必要があります。カーネルバージョンを確認するには
uname -r
コマンドを実行してください。 - 最新のイメージをフラッシュしてください。例えば
mainsailos
をフラッシュしてください。カーネルをアップグレードするものではありません。 - KlipperScreenをインストールする必要があります。
- Raspberry Imagerを使用して最新のMainsailOSをインストールします
- Raspberry Imagerをダウンロードしてインストールします
- Raspberry Imagerを開きます
- CHOOSE DEVICEをクリックします
- デバイスに応じて適切なモデルを選択します
- CHOOSE OSをクリックします
- Other specific-purpose OSを選択します
- 3D printingを選択します
- Mainsail OSを選択します
- もし設定が64ビットシステムをサポートしている場合は、rpi64を選択します
- CHOOSE STORAGEをクリックします
- ストレージデバイスを選択します。例えばSDカード
- NEXTをクリックし、インストールが完了するまで待ちます
4. ドライバーのインストール
-
FLY-TFT-V2ドライバーのインストール
git clone https://github.com/kluoyun/FLY-TFT.git
cd FLY-TFT
sudo chmod +x ./scripts/install.sh
./scripts/install.sh
5. 使用方法
- タッチ機能を有効にするには、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度縦向き、縦向き(反転)- これらの構成は、任意の一つだけを追加できます。複数の構成を追加することはできません
- 通常、TFTのタッチ機能は表示方向に自動的に追従しますので、システム内のタッチ設定を変更する必要はありません
-
追加した後、コマンド
sudo reboot
を実行してシステムを再起動します- ハードウェア接続が正しいことを確認してください
- ドライバーがインストールされていることを確認してください
/boot/config.txt
(bookwormシステムの場合/boot/firmware/config.txt
)ファイルにdtoverlay=fly-tft-v2
のオーバーレイを追加しています- 一部のシステムでは、デフォルトでfb0デバイスが存在する可能性があります。FLY-TFTはfb1デバイスに割り当てられるため、設定ファイルを変更してfb1デバイスを有効にする必要があります
ls /dev/fb*
コマンドを実行してデバイスを確認し、fb0とfb1の両方が表示される場合、fb1デバイスを有効にするために次のコマンドを実行してください- fb1デバイスをデフォルトとして設定するためのコマンドを実行します
sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf
6. KlipperScreenの使用
- MainsailOSはKlipperScreenをデフォルトでインストールしていません。手動でインストールする必要があります
- KlipperScreenのインストールについてはKlipperScreenを参照するか、kiauhを使用してインストールすることができます
- KlipperScreenを正常にインストールし、5番目の手順が正しく完了した場合、KlipperScreenのインターフェースが表示されるはずです
7. 全ての利用可能な構成
-
speed
**必要なパラメータ:TFTの最大SPIクロック周波数を設定します。単位はHzで、デフォルトは96000000です(重大な表示不良がある場合、この値を適切に下げてください) -
例:
dtoverlay=fly-tft-v2,speed=80000000
-
r0/r90/r180/r270
オプション **パラメータ不要:TFTの表示とタッチ方向を設定します。デフォルトは90度で、選択可能な値は0,90,180,270です(これらのパラメータは一つだけを追加できます) -
例:
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
- 例:
- 注意: すべてのパラメータは同時に設定できます(オプションのパラメータは一つだけを選択できます)。複数のパラメータはコンマで区切り、複数のパラメータは同一行にのみ追加できます
- 警告: 通常、
r0
,r90
,r180
,r270
の4つのパラメータしか使用しません。その他のパラメータは特殊な状況でのみ使用されます。特にinvx
,invy
,swapxy
- 例:
dtoverlay=fly-tft-v2,speed=80000000,r270
ラズベリーパイzero2とzero2Wの注意事項

- この注意事項はG2Tと一緒にFLY-TFTスクリーンを使用するためのものです
- ラズベリーパイzero2とzero2wは、デフォルトの表示デバイスを変更する必要があります。そうでない場合、表示されません
- 実行が完了したら、再起動する必要があります
sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf
スクリーンの取り付け
