使用方法
このチュートリアルでは、Raspberry Pi システムに moon2uart をインストールおよび設定し、Nova 3.5 シリアルスクリーンが UART を介して Klipper ホストと通信できるようにする方法を説明します。
| 項目 | 説明 |
|---|---|
| 参考システム | Raspberry Pi OS with Desktop |
| 参考バージョン | Debian GNU/Linux 12 (bookworm) |
| 前提条件 | Klipper と Moonraker がインストールされており、ブラウザで Mainsail または Fluidd にアクセス可能であること |
| 操作方法 | SSH で Raspberry Pi にログインする必要があります |
始める前に、システムバージョンを確認してください：
cat /etc/os-release
出力に PRETTY_NAME="Debian GNU/Linux 12 (bookworm)" のような内容が含まれている場合、システムバージョンはこのチュートリアルと一致しています。
他の Linux ホストシステムを使用する場合もこのチュートリアルを参考にできますが、ファイルパス、シリアルポート名、サービス管理方法が異なる場合があるため、実際のシステムに応じて調整する必要があります。
配線説明
始める前に、プリンターの電源を完全にオフにし、電源供給を切断してください。通電状態でのケーブルの抜き差し、インターフェースの配線整理、ターミナルへの接触は行わないでください。
Nova 3.5 は UART シリアル通信を使用します。配線時には 5V、GND、TX、RX を接続する必要があります。具体的な配線図は準備中です。配線が完了したら、以下のソフトウェア設定に進んでください。
コンポーネントのインストール
SSH で以下のコマンドを実行し、moon2uart を自動インストールします：
curl -sSL https://cnb.cool/3dmellow/public/Moon2Uart/-/git/raw/master/scripts/install.sh | sudo bash
システムシリアルポート設定の編集
ステップ 1：Raspberry Pi UART の有効化
/boot/firmware/config.txt ファイルを開きます：
sudo nano /boot/firmware/config.txt
ファイルの末尾に以下の内容を追加します：
enable_uart=1
dtoverlay=miniuart-bt
force_turbo=1
dtoverlay=uart0
追加が完了したら、Ctrl + S で保存し、Ctrl + X でエディタを終了します。
ステップ 2：システムシリアルコンソールの無効化
/boot/firmware/cmdline.txt ファイルを開きます：
sudo nano /boot/firmware/cmdline.txt
ファイルに console=serial0,115200 が存在する場合は、この部分を削除して、システムコンソールがシリアルポートを占有しないようにします。
変更が完了したら、Ctrl + S で保存し、Ctrl + X でエディタを終了します。
ステップ 3：ログファイルのパーミッション調整
SSH で以下のコマンドを実行します：
sudo chmod 777 /home/pi/printer_data/logs/moon2uart.log
出力がない場合、通常は正常に実行されています。システムユーザーが pi でない場合は、/home/pi/printer_data を実際の printer_data パスに変更してください。
ステップ 4：moon2uart 設定の変更
ブラウザで Klipper の Web インターフェース（Mainsail または Fluidd）を開き、moon2uart.conf ファイルを開きます。
SERIAL_PORT= 設定項目を見つけ、シリアルポートアドレスを次のように変更します：
SERIAL_PORT="/dev/ttyAMA0"
また、PRINTER_DATA_PATH が現在のシステムの実際の printer_data パスであることを確認します。例：
PRINTER_DATA_PATH="/home/pi/printer_data"
Raspberry Pi の UART デバイス名は、システムバージョン、ハードウェアモデル、システム設定によって異なる場合があります。/dev/ttyAMA0 が使用できない場合は、/dev/ttyS0 を試すか、実際のシステムのシリアルポートデバイス名に応じて変更してください。
他のホストシステムでは、対応するシステムのシリアルポート名を使用してください。例えば、FLY ホストでは通常 /dev/ttyS0 を使用します。
変更が完了したら、右上の SAVE をクリックして設定を保存します。
ステップ 5：Raspberry Pi の再起動
設定を保存したら、Raspberry Pi を再起動してシステムのシリアルポート設定を有効にします：
sudo reboot