Klipperrに接続

注意

• このチュートリアルはKlipperrに接続する方法のみです
• 他のいかなる設定やマクロの使用も自分で書く必要があります

BLを書き込む

ファームウェア書き込みモードに入る

• ファームウェア書き込みモードに入るには2つの方法があります
• 1つ目：マザーボードを完全に電源オフの状態で、BOOTボタンを押したままデータケーブルの一方をマザーボードに接続し、もう一方をあなたのデバイスに接続します
• 2つ目：データケーブルの一方をマザーボードに接続し、もう一方をあなたのデバイスに接続した後、BOOTボタンを押してRSTボタンを押します。その後、RSTボタンを離し、最後にBOOTボタンを離します
  

ファームウェアを書き込む

Windowsでのファームウェア書き込みチュートリアル

• バッファのBLファームウェア
  • 百度网盘:百度网盘ダウンロードリンク
  • GOOGLE网盘:GOOGLE网盘

注意

• システム互換性の問題があるため、PCのUSB2.0ポートを使用して焼込を行ってください
• それでも焼込できない場合は、アップローダーを使用して焼込を行ってください

1. 焼込ツール ダウンロードリンク
2. SetupSTM32CubeProgrammerとSTM32 DFUドライバーをダウンロードする必要があります
3. 事前にコンパイルしたファームウェア（klipper.bin）または事前にコンパイルしたKatapultファームウェアをPCの任意のディレクトリにコピーします
4. USB Type-Cケーブルを使用してマザーボードをPCに接続し、すでに：DFU焼込モードに入ることを確認してください
5. STM32CubeProgrammerでUSBモードを選択し、更新して接続します
   
6. エラーポップアップが表示されない場合は接続が成功しています。
   警告

   下図のような内容が表示された場合、PCまたはソフトウェアの問題であるため、アップローダーを使用して焼込を行ってください：アップローダーでの焼込チュートリアル

   
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

ファームウェア書き込みモードに入る

ヒント

2024年9月1日以降に製造されたD5はすでにKatapultファームウェアが書き込まれています

• TypeCデータケーブルを使用してマザーボードをホストコンピュータに接続した後、リセットボタンを2回押します。このとき、マザーボードのLEDランプが点滅します。

警告

• LEDランプが点滅しない場合は、再びKatapultファームウェアを書き込みます：Katapultファームウェアを書き込む
• LEDランプが点滅しない場合は、Katapultファームウェアを書き込んだ後、次のステップに進んでください

ファームウェア書き込みモードに入っているか確認する

• 上位機が正常にネットワークに接続できることを確認し、下位機と接続されているデータケーブルがデータ転送機能を持っていることを確認してください。
• 上位機に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を入力してください。

---