Klipperrに接続

注意

• このチュートリアルはFly-Buffer-PlusバッファーモジュールにKLIPPERファームウェアを焼くためのものです
• ファームウェアを焼いた後、圧力用のピンが上書きされます
• 以前の機能を実現するには、自分自身でマクロを書くか、以前のファームウェアを再焼く必要があります
• あらゆる設定や使用するマクロは自分で作成しなければなりません

BLの焼込み

烧込みモードに入ります

• 烧込みモードに入る方法は2種類あります
• 1つ目：メインボードを完全に電源オフの状態で、BOOTボタンを押したまま、データ伝送用のケーブルの片方をメインボードに接続し、もう片方をあなたのデバイスに接続します
• 2つ目：データ伝送用のケーブルの片方をメインボードに接続し、もう片方をあなたのデバイスに接続した後に、BOOTボタンを押したままRSTボタンを押します。その後RSTボタンを離し、最後にBOOTボタンを離します
  

ファームウェアの焼込み

windowsでの焼込みチュートリアル

• バッファーアダプターのBLファームウェア
  • 下記のダウンロードリンクをクリックしてください
• Loading...

注意

• USB3.0では焼込みができない場合があるため、できるだけパソコンのUSB2.0で焼込みを行ってください
• USB2.0ポートがない場合は、ハブを使用してください
• それでも焼込みができない場合は、上位機を使用して焼込みを行ってください

1. 烧录工具 ダウンロード先
2. SetupSTM32CubeProgrammerとSTM32 DFUドライバをダウンロードする必要があります
3. 以前にコンパイルしたファームウェア(klipper.bin)または事前にコンパイルされたKatapultファームウェアをコンピュータの任意のディレクトリにコピーしてください
4. Type-Cデータケーブルを使用してメインボードをコンピュータに接続し、dfu焼込みモードに入っていることを確認してください
5. STM32CubeProgrammerでUSBモードを選択し、リフレッシュし、接続してください
   
6. エラーメッセージが表示されない場合、接続に成功しました。
   警告

   図のように表示された場合は、コンピュータまたはソフトウェアの問題です。上位機を使用して焼込みを行ってください：上位機による焼込みチュートリアル

   
7. 左側のダウンロードアイコンをクリックし、下のいくつかの選択を有効にしてください
   
8. 矢印が指しているBrowseをクリックし、焼込む必要があるファームウェアを選択してください
   
9. Start addressに0x08000000を入力してください
   
10. 下のStart automatic modeをクリックしてファームウェアの焼込みを開始してください
    
11. 下記のメッセージが表示されればファームウェアの焼込みが完了しました
    

ホストコンピュータでの焼込みチュートリアル

1. フラッシュツールのインストール

• FLY上位機はフラッシュツールのインストールを実行する必要はありません
• インストールが必要な場合に注意してください：上位機はインターネットに接続できる必要があります
• すでにインストール済みの場合、インストールする必要はありません

sudo apt update
sudo apt install dfu-util -y

2. 接続が成功したかどうかを確認するために以下のコマンドを実行します。

lsusb

• DFUデバイスがない場合は再びフラッシュモードに入ることを試してください
• システムバージョンの問題により他の名前が表示される可能性があります。0483:df11と表示された場合、フラッシュモードに入ったことを示します

3. 事前にコンパイルされたファームウェアを取得

• これらはすべて事前にコンパイルされたファームウェアです
• 注意してください：上位機はインターネットに接続できる必要があります
• 上位機は次のコマンドを実行してファームウェアパッケージをダウンロードする必要があります（上位機のネットワーク問題によりファイルを取得できない場合は、售后群で管理者に連絡してください）

cd && git clone https://github.com/FengHua741/FLY_Katapult.git

• ファームウェアパッケージを既にダウンロードしている場合は、残りの操作を行う前にファームウェアパッケージを更新することをお勧めします

cd ~/FLY_Katapult && git pull

4. ファームウェアの焼込み

ヒント

いずれかのファームウェアを焼込めばよいです

• 下記はファームウェアの焼込みコマンドです

  sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/BL/buffer/FLY_BUFFER

5. 図の矢印部分に「File downloaded successfully」と表示されれば焼込み成功です

   

ヒント

烧込みが完了した後、メインボードを完全に電源オフにする必要があります。

USBファームウェアのビルド

ビルドを開始

• klipperサービスがインストールされた上位機を使用する必要があります ネットワーク経由でSSHに接続
• そしてデバイスを上位機に接続してください
• 注意：一般的な上位機を使用してください。例えば、ラズベリーパイやFLY派などです。改造された上位機（例：WiFiスティック、レッドミーなど）は問題が多いので、技術サポートを提供できません

手記

• 下記のコマンドを入力してROOTユーザーから通常のユーザーに切り替えることができます
• ROOTユーザーを使用しないでください
• flyユーザーの場合、su flyと直接入力できます。flyユーザー以外の場合、<あなたの上位機のユーザーネーム>をあなたの上位機のユーザーネームに置き換えてください！

su <あなたの上位機のユーザーネーム>

ヒント

• 上位機が正常にネットワークに接続できていることを確認してください
• 固件のコンパイル前に、SSHを使用してネットワーク経由で上位機にログインする必要があります
• 上位機にシリアルポートツールを使用しないでください

Klipperファームウェアのコンパイルと設定ページ操作説明

ヒント

キーボード入力モードを半角モード（英語モード）に設定してください

1. キーボードの↑キー、↓キーは、カーソルを上下移動させてメニュー項目を選択します
2. 確認キーEnterまたはスペースキーSpaceは、メニューをチェックするかサブメニューに進むために使用します
3. 戻るキーESCは、一つ前のメニューに戻ります
4. Qキーは、Klipperファームウェアの設定ページを終了します
5. Yキーは、Klipperファームウェアの設定ページを終了する際に、プロンプトがある場合に、Yキーを押して設定ファイルを保存します

手記

配置ページのオプションが少ない場合は、最初に[ ] Enable extra low-level configuration optionsをチェックして、一部の隠しオプションを表示してください

以下はファームウェアをコンパイルする方法です：

• SSHに接続した後、次のコマンドを入力し、Enterを押します：

  cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig

• そのうちrm -rf ~/klipper/.config && rm -rf ~/klipper/outは以前のコンパイルデータとファームウェアを削除し、make menuconfigはファームウェアをコンパイルします。実行後、以下のインターフェースが表示されるはずです。

  

• Enable extra low-level configuration optionsを選択し、Enterを押します

  

• メニューMicro-controller Architectureに入り、STMicroelectronics STM32を選択してEnterを押します

  

• メニューProcessor modelに入り、STM32F072を選択してEnterを押します

  

• Bootloader offsetを選択し、8KiB bootloaderを選択します

  

• Communication interfaceを選択し、**USB (on PA11/PA12)**を選択してEnterを押します

  

• 以下の図と照らし合わせて、一致していることを確認してください。一致したら次へ進んでください。

  

• Qキーを押してSave configurationが出たら、もう一度Yキーを押します
  
• これで設定が保存され、コマンドラインインターフェースに戻りました
• 下記のコマンドを入力してビルドを開始します、時間がかかるかもしれません

make -j4

• 最後に下記の内容が出力されればビルド成功です

  Linking out/klipper.elf
  Creating hex file out/klipper.bin

• 以下はファームウェアのビルド操作の記録です

Asciinema cast

烧込みモードに入ります

警告

• RSTボタンを2回押して、焼込みモードに入ります

烧込みモードに入っているか確認

• 上位機が正常にネットワークに接続できることを確認し、下位機と接続されているデータケーブルがデータ転送機能を持っていることを確認してください。
• 上位機にSSH接続し、コマンドラインで lsusb を入力してEnterを押します。もし下の画像で囲まれた情報が表示された場合、次のステップに進むことができます。
  • 何も情報が返ってこない場合、これは上位機のシステムの問題です。こちらでは対応できませんので、正常なシステムに変更するか、上位機を交換してください。
  • lsusb コマンドが見つからない場合、以下のコマンドを実行してインストールできます：

    sudo apt-get install usbutils

    
• 1d50:6177 は今回使用する予定のデバイスです。
  • 一部の上位機はシステムの問題により、完全に表示されないか、全く表示されないことがあります。
  • lsusb コマンドを入力するとデバイスが表示されるが、1d50:6177 が表示されない場合は、データケーブルを交換して、マザーボードを上位機の他のUSBポートに接続してみてください。
• 上記の手順を以前に実行しており、Klipperファームウェアの書き込みが成功し、マザーボードが正常に動作している場合、Klipperファームウェアを更新するだけであれば、このページの右側メニューにある「ファームウェア更新」セクションをご覧ください。

注意事項

1d50:6177 デバイスが表示された後でなければ、次のステップに進めません。

ファームウェアの焼込み

::: tip

• プラグインのフラッシュ中にインターネットに接続する必要があります。上位機が正常にインターネットに接続されていることを確認してください。
• もしすでにインストール済みの場合、再度インストールする必要はありません。 :::

フラッシュ開始

::: warning 警告

• 非fly上位機 は、以下のコードを実行して、ファームウェアフラッシュの依存パッケージをインストールすることをお勧めします！それ以外の場合、ファームウェアをフラッシュできません！

    cd && git clone https://github.com/Arksine/katapult.git

• 国内ではこのコマンドを使用してインストールできます。

  cd && git clone https://gitee.com/MrCakeFuck/katapult.git

:::

• 下記のコマンドを使用してデバイスIDを検索し、下図のようなIDが表示されることを確認してください。（図中のIDは例示であり、各ボードのIDは異なります）

  ls /dev/serial/by-id/*

  

• ファームウェアをフラッシュするには、下記のコードを使用してください。ファームウェアが正常にコンパイルされていることを確認し、<あなたのボードID>を前ステップで取得したIDに置き換えてください。

  ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<あなたのボードID>

fastシステムではこのコマンドを使用してフラッシュします。<あなたのボードID>を前ステップで取得したIDに置き換えてください。

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<あなたのボードID>

• 参考画像

  

• フラッシュ完了時の参考

  

ファームウェアの更新

USBファームウェアの更新

• ボードIDを検索するために以下のコマンドを使用し、下図のようなIDが表示されることを確認してください。（図中のIDは例示であり、各ボードのIDは異なります）

  ls /dev/serial/by-id/*

::: tip 注意 下図中の/dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00がボードのIDです。 :::

• USBファームウェアを更新するには、最新のファームウェアをコンパイルした後、以下のコマンドを使用して更新します。<あなたのボードID>を前ステップで取得したIDに置き換えてください。

  cd ~/klipper/ && make flash FLASH_DEVICE=<あなたのボードID>

  

CANブリッジファームウェアの更新

• CANブリッジファームウェアを更新する場合、最新のファームウェアをコンパイルした後、以下のコマンドを使用してKatapultにリセットします。（下図は例示であり、図中のIDは参考としてください。実際は設定ファイル内のIDを使用してください） ::: tip 注意

  • <あなたの CANBUS UUID>はprinter.cfg設定ファイル内のボードのCANBUS UUIDです。 :::
  
  

~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <あなたの CANBUS UUID>

fastシステムではこのコマンドを使用してフラッシュします。<あなたのボードID>を前ステップで取得したIDに置き換えてください。

python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <あなたの CANBUS UUID>

::: tip 注意

• 下図中のf95cee90e1f9がボードのCANBUS UUIDです。 :::

• Katapultにリセットした後、以下のコマンドを使用してボードIDを検索し、下図のようなIDが表示されることを確認してください。（図中のIDは例示であり、各ボードのIDは異なります）

  ls /dev/serial/by-id/*

::: tip 注意 下図中の/dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00がボードのIDです。 :::

• 新しいファームウェアをコンパイルした後に実行することを確認し、<あなたのボードID>を前ステップで取得したIDに置き換えてください。

  cd ~/klipper/ && make flash FLASH_DEVICE=<あなたのボードID>

  

ファームウェアの誤刷解決方法

• ボードを電源から切り、再度電源を入れ直し、リセットボタンを素早くダブルクリックすることで、再びフラッシュモードに入ることができます。
• または、Window/上位機を使用してkatapultファームウェアを再びフラッシュできます。katapultファームウェアのフラッシュ

USB IDを検索する

1. ブラウザを開き、URLバーに上位機のIPアドレスを入力します。例えば、私の上位機のIPアドレスが192.168.101.179の場合、それを直接入力してEnterキーを押すだけです。

2. 上位機のWEBインターフェースを開き、左側のサイドバーにある設定オプションで以下の内容を探します：

fluiddでは: {…} をクリックすると、printer.cfgが見つかります

mainsailでは: マシンをクリックすると、printer.cfgが見つかります

3. printer.cfgをクリックし、右上のDEVICESをクリックします

4. SERIALをクリックし、リフレッシュします

fluiddのリフレッシュ

mainsailのリフレッシュ

5. IDをコピーします。矢印の先をクリックすることでコピーできます

fluiddにはttyAMCが存在し、Path by IDが存在することを確認してください。これがUSBIDです

mainsailにはttyAMCが存在し、Path by IDが存在することを確認してください。これがUSBIDです

USB IDの入力

1. DEVICESを閉じてIDを入力します

注意

• 設定ファイルで以下を変更してください:

[mcu] 
serial: /tmp/klipper_host_mcu

に変更して:

[mcu host] 
serial: /tmp/klipper_host_mcu

• 追加してください:

[mcu]
serial: <ここに先ほど取得したIDを入力>

fluiddで[MCU]を見つけます

mainsailで[MCU]を見つけます

2. IDを設定に記入します

ヒント

• IDを入力したら右上のSAVE & RESTARTをクリックしてください

3. KlipperがADC out of rangeと表示された場合、これは正常な現象です。ヒートベッドやセンサーをメインボードに接続し、ヒーターとヒートベッドのセンサーピンを設定してから保存して再起動してください。

危ない

注意: ドキュメント中に登場するすべてのIDは例示です。実際の各メインボードのIDは異なりますので、実際に取得したIDを入力してください。

---