メインコンテンツにスキップ

USBファームウェアのコンパイル

コンパイルを開始​

ファームウェアコンパイル簡易ガイド​

注意事項​

  • ネットワーク: 上位機(ラズベリーパイなど)がネットワークに接続されていることを確認してください
  • ログイン方法: SSH を使用してネットワーク経由でログインする必要があります。シリアルポートは無効にしてください
  • 入力方式: キーボードは英数字半角モードに保ってください

SSHログインとユーザー切り替え​

MobaXterm、PuTTY などのツールを使用して上位機にSSHログインします。

ユーザー切り替え：​

  • 通常システム(ラズベリーパイ公式システムなど)
    root の使用は禁止されており、通常ユーザーに切り替える必要があります： 
    su <ユーザー名>
  • FLY上位機(FlyOS-FASTシステム)
    root ユーザーでのログインのみサポート（パスワード：mellow）

ファームウェアコンパイル操作ガイド​

Klipper ファームウェア設定画面ではキーボード操作のみサポートされており、マウスは使用できません。

キー機能
↑ / ↓上下にカーソルを移動し、メニュー項目を選択
Enter / スペース選択の確定、オプションのチェック、またはサブメニューに入る
ESC前のメニューに戻る
Q設定画面を終了
Y終了時にプロンプトが表示されたら Y を押して設定を保存

以下にファームウェアのコンパイル方法を説明します：

  • SSHに接続後、以下のコマンドを入力し、Enterキーを押します：

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

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

    Loading...

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

    Loading...

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

    Loading...

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

    Loading...

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

    Loading...

  • Clock Reference (8 MHz crystal)を選択し、25 MHz crystalを選択します

    Loading...

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

    Loading...
  • マイクロコントローラー起動時に設定するGPIOピンを選択します。入力:!PA15 !は大文字であることに注意してください
    Loading...
  • Qキーを押すと、Save configurationが表示されるので、次にYキーを押します
    Loading...
  • これで設定が保存され、コマンドラインインターフェースに戻るはずです
  • 以下のコマンドを入力してコンパイルを開始します。時間がかかります
make -j4
Loading...
  • 最後に以下の内容が出力されればコンパイル成功です
  • Klipperのバージョンによって、out/klipper.binが表示されれば成功です 
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

書き込みモードに入っているか確認​

  • ツールボードをUSBケーブルでホストマシンに接続すると、マザーボードのLEDが点滅します。
警告
  • LEDが点滅しない場合は、Katapultファームウェアを再度書き込んでください：Katapultファームウェアの書き込み
  • LEDが点滅しない場合は、Katapultファームウェアを書き込んだ後、次の手順を実行してください。

ファームウェアの書き込み​

書き込み開始​

  • Fly公式以外の上位機種にはKatapultのインストールが必要です
  • Katapultのインストール

マザーボードIDの取得​

以下のコマンドを実行してデバイスIDを検索します。通常、下図のようなIDが表示されます(注意：マザーボードごとにIDは異なります):

ls /dev/serial/by-id/*

検索されたIDにusb-katapult_stm32xxxxxxxxが含まれている場合、次のステップに進めます

Loading...

ファームウェアの書き込み​

⚠️ 準備作業
  • コンパイル済みのファームウェアファイルを用意してください
  • 以下のコマンド内の <あなたのマザーボードID> を、前の手順で確認した実際のIDに置き換えてください
  • 通常の上位機種は以下のコードを使用 
    ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d <あなたのマザーボードID>
  • FLY上位機種は以下のコードを使用 
    python3 ~/katapult/scripts/flashtool.py -d <あなたのマザーボードID>

書き込み過程の参考:

Loading...

書き込み成功の参考:

Loading...

ファームウェアの更新​

USBファームウェア更新手順​

  1. マザーボードIDの確認
ls /dev/serial/by-id/*
識別のポイント

下図の /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00 がマザーボードIDです

Loading...
  1. ファームウェアの更新
cd ~/klipper/ && make flash FLASH_DEVICE=<あなたのマザーボードID>
注意
  • <あなたのマザーボードID> を実際に確認したIDに置き換えてください
Loading...

誤ったファームウェアを書き込んだ場合の対処法​

方法一：素早く書き込みモードに入る​

  1. マザーボードの電源を切る
  2. 再通電後、RESETボタンを素早く2回押す
  3. 書き込みモードに再度入る

方法二：Katapultファームウェアを再書き込み​

Katapultファームウェア書き込みガイドを確認する

ファームウェアが起動したか確認​

  • ファームウェアが正常に起動するとLEDが点灯します
    Loading...
Loading...