ラズベリーパイ使用説明

注意事項：

• 拡張ボードをインストールする前に、ホストコンピュータの電源がオフになっていることを確認してください。
• 拡張ボードを湿気やほこ dust の多い環境で使用しないでください。
• スクリーンを取り付ける際は、帯電防止のため電源を切った状態で取り扱い、スクリーンケーブルの方向に注意して破損を防いでください。
• ファンを取り付ける際は、ファンの電流および電圧仕様に注意してください。破損の原因になります。
• UART1 はデフォルトで有効になっているため、設定する必要はありません。
• 最新のイメージ例:mainsailos を書き込んでください。カーネルをアップグレードするだけではありません。
• ラズベリーパイはすべてのインターフェースを使用できます！！！
• 注意：ラズベリーパイで使用するシステムカーネルのバージョンは 5.17.x 以上である必要があります。コマンド uname -r を実行してカーネルバージョンを確認してください。

ラズベリーパイ予めインストール済みTFTV2システムダウンロードリンク

• ラズベリーパイzero2/zero2W/2B/3B/3B+/4B/CM4/5Bに対応するシステムイメージ

• このイメージには事前に klipper、moonraker、mainsail、fulidd、klipper-screen などがインストールされています。

• 下記のダウンロードリンクをクリックしてください。

• Loading...

G2Tのインストール

• 下記は参考例です。
  
• 配線の参考例
  

ボード内蔵RS232を使用してツールボードに接続する方法

• 最新のシステムをラズベリーパイに書き込んだ後は、ブートディスク内のconfig.txtファイルを編集する必要があります。
• UART1 はデフォルトで有効になっているため、システム内での設定は不要です。UART3 を使用する場合は以下の手順を実行してください。
• config.txt に追加してください。

dtoverlay=uart3

• UART1 を使用する場合のID設定例：

[mcu] 
serial: /dev/ttyAMA0
baud: 250000
restart_method:command

• UART3 を使用する場合のID設定例：

[mcu] 
serial: /dev/ttyAMA1
baud: 250000
restart_method:command

ボード内蔵5VFANの使用方法

• ラズベリーパイの40ピンでデバイスを制御する場合は、Klipperのチュートリアルに従ってインストールしてください RPi マイコン

  

[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 です。

1. ドライバをインストールした後、config.txt ファイルに dtoverlay=fly-tft-v2 のオーバーレイサポートを追加する必要があります。
2. /boot/config.txt を開きます（bookwormシステムの場合は /boot/firmware/config.txt）。

   sudo nano /boot/config.txt

3. ファイルの末尾に次の設定を追加します。

   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のタッチ方向は表示方向に自動で追随するため、システム内のタッチ設定を変更する必要はありません。

4. ファイルの末尾に追加後、コマンド sudo reboot を実行してシステムを再起動してください。

   • ハードウェア接続が正しいことを確認してください。
   • ドライバがインストールされていることを確認してください。
   • /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

6. KlipperScreenの使用方法

• MainsailOS にはデフォルトで 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から選択可能です（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

ラズベリーパイzero2 および zero2W の注意事項

• この注意事項は、G2TとFLY-TFTスクリーンを併用する場合の説明です。
• ラズベリーパイzero2 および zero2w では、デフォルトの表示デバイスを変更する必要があります。以下のコードを実行してください。変更後は再起動が必要です。

sudo sed -i 's/\/dev\/fb0/\/dev\/fb1/g' /etc/X11/xorg.conf.d/99-fbdev.conf

スクリーンの取り付け