HN 日本語サマリー

← 一覧へ戻る
プログラミング

Apple Silicon Macでmacvdmtoolを使用してDFUリストアを実行する (2021)

Perform DFU Restores on Apple Silicon Macs with Macvdmtool (2021) (bkurtz.io)

22 pointsby gregsadetsky4 コメント

要約

この記事では、AsahiLinuxプロジェクトによって開発されたmacvdmtoolというツールを紹介しています。macvdmtoolを使用すると、Apple Silicon搭載MacやT2チップ搭載Intel Macを、煩雑なキーボード操作なしに、簡単なターミナルコマンドでDFUモードに移行させることができます。その後、Apple Configurator 2のcfgutilコマンドとIPSWファイルを用いて、ターゲットMacのリストアや復旧を行う手順を解説しています。

全文翻訳

macvdmtool を使用して Apple Silicon Mac で DFU リストアを実行する

macvdmtool とは何か?

これは Asahi Linux プロジェクト の下で marcan によって書かれたツールです。macvdmtool を使うと、煩雑なキーボード操作を必要とせずに、簡単なターミナルコマンドで Apple Silicon または T2 チップ搭載の Intel Mac (2018年以降) を DFU モードに入れることができます。

注意: macvdmtool は、ホストマシンが Apple Silicon ベースである必要があります。Intel Mac はホストとしてこのツールをサポートしていないようです。

前提条件

  • macvdmtool を利用するには 2 台の Mac が必要です。
    • 1 台は「ホスト Mac」として機能します。このマシンは正常に動作している必要があります。
    • 2 台目の「ターゲット Mac」は、電源が入り、疑問符またはリカバリモードで起動する限り、機能している必要はありません。

macvdmtool のセットアップと使用方法

  1. ホスト Mac で Xcode をインストールし、ターミナルで以下のコマンドを実行して Xcode コマンドラインツールをインストールします。

    xcode-select --install
    

    正しくインストールされたか確認します。

    xcode-select -p
    
  2. Mac App Store から Apple Configurator 2 をインストールします。

  3. macvdmtool をクローンします。

    git clone https://github.com/AsahiLinux/macvdmtool.git
    
  4. macvdmtool ディレクトリに移動し、ツールをコンパイルします。

    cd macvdmtool && make
    
  5. macvdmtool をパスにコピーします。

    sudo cp macvdmtool /usr/local/bin
    

    以下のコマンドを実行して、インストールされパスに追加されたか確認します。

    macvdmtool
    
  6. Apple Configurator 2 を起動し、「Automation Tools」をインストールします。

    [画像: Install Automation Tools]

    [画像: Install Automation Tools dialogue]

    [画像: Install Automation Tools password prompt]

  7. 公式の Apple USB-C 充電ケーブルまたは TB3/TB4 ケーブルを使用して、ホスト Mac とターゲット Mac を接続します。ケーブルは両端の DFU ポート に接続され、データ転送をサポートしている必要があります。

Apple Silicon マシンでは、DFU ポートは左側の画面に最も近いポートです。

Intel マシンでは、DFU ポートは左側のトラックパッドに最も近いポートです。

  1. ターゲット Mac を DFU モードにします。

    sudo macvdmtool dfu
    

    上記のコマンドは以下のような出力を返すはずです。

     Mac type: J313AP
     Looking for HPM devices...
     Found: IOService:/AppleARMPE/arm-io@10F00000/AppleT810xIO/i2c0@35010000/AppleS5L8940XI2CController/hpmBusManager@6B/AppleHPMBusController/hpm0/AppleHPMARM
     Connection: Source
     Status: APP
     Unlocking... OK
     Entering DBMa mode... Status: DBMa
     Rebooting target into DFU mode... OK
     Exiting DBMa mode... OK
    

cfgutil を使用したリストア/復旧

代わりに Apple Configurator 2 または Finder を使用して Mac をリストア/復旧することもできます。

注意: cfgutil を使用するこの方法は、ターゲット Mac が Apple Silicon の場合にのみ機能します。

  1. Apple Configurator 2 を起動して、デバイスが DFU モードであることを確認します。このようになっているはずです。(表示されない場合は、ホストとターゲット間のケーブルを抜き差ししてみてください)

    [画像: Apple Configurator 2 is now showing target device in DFU]

  2. リストアしたい IPSW を Mr. Macintosh のデータベース から取得します。

  3. cfgutil を使用してその IPSW をリストアします。

    cfgutil restore -I ~/Downloads/UniversalMac_12.1_21C5021h_Restore.ipsw
    

    結果は以下のようになります。

    objc[53015]: Class AMSupportURLConnectionDelegate is implemented in both /usr/lib/libauthinstall.dylib (0x1da64c9e8) and /Library/Apple/System/Library/PrivateFrameworks/MobileDevice.framework/Versions/A/MobileDevice (0x104d782c8). One of the two will be used. Which one is undefined.
    objc[53015]: Class AMSupportURLSession is implemented in both /usr/lib/libauthinstall.dylib (0x1da64ca38) and /Library/Apple/System/Library/PrivateFrameworks/MobileDevice.framework/Versions/A/MobileDevice (0x104d78318). One of the two will be used. Which one is undefined.
    cfgutil: restore: target OS is 12.1
    
    Waiting for the device [1/2] [*******************************************]  100%
    Step 2 of 2: Installing System [2/2] [**********************************>]  99%
    

この時点で、ターゲット Mac に Apple ロゴとローディングバーが表示されるはずです。

数分後、Mac は再起動し、標準のセットアップアシスタントが表示されます。

これで完了です!お楽しみください。

将来の 自動化 強化

  • Apple が com_apple_macOSIPSW.xml フィードに 12.X IPSW を追加したら、最新の IPSW をダウンロードして macvdmtool と cfgutil を実行するスクリプトを作成できます。
  • 最新の IPSW をダウンロードして Munki でパッケージ化する Autopkg レシピ。これは技術者に IPSW を配布するのに役立つ可能性があります。

私のブログの https://github.com/discentem/blog-content で課題やプルリクエストを提出するか、MacAdmins Slack で連絡してください。

DFU に関する追加情報

DFU リストアに関する詳細については、Mr. Macintosh の優れた ブログ記事 を参照してください。