コンテンツにスキップ

IPRO Workbench のインストール

このページでは、IPRO Workbench のインストールから、IDE がボードを認識するまでを説明します。完了すると、IPRO Home のバナーに「Ready to run」と表示されます。対象は IPRO Workbench 0.1.1 です。ボタンなどのインターフェースのラベルは、英語のインターフェースでの表記のまま太字で示します。

前提条件

項目 内容
コンピューター macOS 12 以降(Apple シリコン)または Windows 11(x64)で、GitHub にアクセスできること。IDE、ツール、SDK で合計約 4 GB のディスク容量が必要です。
インストーラー macOS:IPRO-Workbench-0.1.1-mac-arm64.dmg、Windows:IPRO-Workbench-0.1.1-win-x64.exe。GitHub の IPRO Workbench リリースページからダウンロードします(ダウンロードと検証を参照)。GitHub アカウントは不要です。
ボード IPRO7AI Reef EVK V4.0、または IPRO6S EVK
プローブとケーブル IPRO Debug Probe と、それをコンピューターに接続する USB ケーブル
macOS で追加で必要なもの Xcode Command Line Tools と、Homebrew の CMake および Ninja(開発環境を整えるを参照)

ダウンロードと検証

ファイル システム サイズ
IPRO-Workbench-0.1.1-mac-arm64.dmg macOS 12 以降、Apple シリコン 199 MB
IPRO-Workbench-0.1.1-win-x64.exe Windows 11、x64 160 MB
  1. インストーラーをダウンロードします。 IPRO Workbench のリリースページ https://github.com/INTELPRO-INC/ipro-workbench/releases/latest を開き、Assets から使用しているシステム用のインストーラーをダウンロードします。

  2. ダウンロードしたファイルを検証し、破損や差し替えがないことを確認します。

    shasum -a 256 IPRO-Workbench-0.1.1-mac-arm64.dmg
    
    (Get-FileHash .\IPRO-Workbench-0.1.1-win-x64.exe -Algorithm SHA256).Hash
    

    期待される結果:同じファイルについて、下記の値と同じ値が表示されます(Windows では大文字で表示されます)。リリースページの SHA256SUMS.txt にもこれらの値が記載されています。

    IPRO Workbench 0.1.1 インストーラーの SHA-256
    # IPRO-Workbench-0.1.1-mac-arm64.dmg
    fb6980af59e4021ebd7357d3da1721a1490e2cec7446a98425b6c9ba0e25959e
    # IPRO-Workbench-0.1.1-win-x64.exe
    e057fb56c15cb68cdfeb8c60b0cfecd7f5bd82860573003ad2d94788a34aa74c
    

リリースページにある ZIP、latest-mac.yml、latest.yml、blockmap の各ファイルは、内蔵の更新機能で使用するものです。ダウンロードする必要はありません。

インストール

  1. プログラムをインストールします

    IPRO-Workbench-0.1.1-mac-arm64.dmg を開き、IPRO Workbench を「アプリケーション」フォルダーにドラッグします。

    1. IPRO-Workbench-0.1.1-win-x64.exe をダブルクリックします。
    2. 「Windows によって PC が保護されました」と表示される場合があります。詳細情報 をクリックしてアプリ名を確認し、実行 をクリックします。
    3. インストーラーのウィザードでインストール対象のユーザーを尋ねられたら、現在のユーザーのみにインストールする方を選択します(管理者権限は不要です)。続いてインストール先のフォルダーを変更できます。Install をクリックし、完了したら Finish をクリックします。

    期待される結果:スタートメニューとデスクトップに IPRO Workbench が表示されます。

  2. IPRO Workbench を開きます

    「アプリケーション」から IPRO Workbench を開きます。

    初めて開いたときに、macOS が開発元を検証できないと表示した場合は、「システム設定 → プライバシーとセキュリティ」を開き、下にスクロールして IPRO Workbench の項目で このまま開く をクリックし(macOS のバージョンによって表記が異なります)、もう一度 IPRO Workbench を開きます。

    スタートメニューから IPRO Workbench を開きます。

    期待される結果:IPRO Workbench のウィンドウが表示され、中央に IPRO Home、左側に IPRO サイドバー(Applications、Board、Environment)があります。macOS と Windows で同じ外観です。

Tip

IT 担当者が一括展開する場合は、サイレントインストール IPRO-Workbench-0.1.1-win-x64.exe /S を使用するか、/D=<folder> でインストール先を指定します(/D は最後のパラメーターにする必要があります)。

表示言語

システムの言語が繁体字中国語の場合、IPRO Workbench は初回起動時から中国語で表示されます。言語を変更するには、Cmd+Shift+P(Windows では Ctrl+Shift+P)を押してコマンドパレットを開き、Configure Display Language と入力して言語を選択し、表示に従って再起動します。

開発環境を整える

IPRO Workbench は、開発に必要なすべてのツールを自動的にチェックし、その結果をサイドバーの Environment に一覧表示します。

項目 用途 Fix Environment でインストールできるか
IPRO SDK アプリケーション、ドライバー、サンプルのソース できます。GitHub から最新リリースをインストールします
RISC-V toolchain ファームウェアをコンパイルします できます
CMake, Build program ビルドを生成して実行します Windows ではできます(Ninja、Python と 1 つのパッケージ)。macOS では Homebrew でインストールします
Python (menuconfig) 設定(Kconfig)と Menuconfig kconfiglib パッケージは別途インストールが必要です(下記参照)
IntelProCube 書き込み できます(IPRO6S EVK に必要な 0.7.0.1 以降をインストールします)
clangd (code navigation) 定義へのジャンプ、入力中のエラー表示 できます。clangd 拡張機能がダウンロードします(Fix の後、拡張機能がインストールするかどうかをもう一度確認します)
OpenOCD (debugging) JTAG デバッグ(本リリースではまだ利用できません) Windows ではできます。これがなくてもビルドと書き込みは動作します
Board IPRO Debug Probe を検出します プローブを接続するだけです
SDK for this toolchain Windows のみ:IPRO SDK 2.2 を Windows でビルドできるようにします できます
macOS quarantine macOS のみ:ブラウザーでダウンロードしたツールはシステムにブロックされます できます。確認後にフラグを削除します
  1. IPRO Home 上部のバナーを確認します。 不足があるときは「Finish the setup」と表示され、まだ不足している項目の数が示されます。

  2. macOS では、先に Xcode Command Line Tools とビルドツールをインストールします。 「ターミナル」で次を実行します(インストール済みの場合は不要です)。

    xcode-select --install
    brew install cmake ninja
    
  3. Fix Environment をクリックします。

    期待される結果:下部の Output パネルが IPRO Setup に切り替わり、各項目を GitHub からダウンロードしてインストールする様子が表示されます。ツールはホームフォルダーの IPRO/tools/<tool>/<version>(Windows では %USERPROFILE%\IPRO\tools)にインストールされます。完了すると Environment のすべての行に緑のチェックマークが付き、IPRO Home のバナーが次のステップに進みます。一般的なネットワーク環境では約 2 分かかります。

  4. kconfiglib がない場合はインストールします。 Python (menuconfig) の行に kconfiglib がないと表示された場合は、その行に表示されているコマンドをターミナルで実行し、Environment 上部の Check Again をクリックします。

    python3 -m pip install kconfiglib
    
    python -m pip install kconfiglib windows-curses
    
  5. 既存のツールを使用します(任意)。 ツールチェーンや IntelProCube がすでにコンピューターにある場合は、再インストールする必要はありません。Environment の該当する行でフォルダーアイコン(Use one already on this computer…)をクリックし、ツールがあるフォルダーを選択します。IPRO6S EVK に書き込むには、IntelProCube が 0.7.0.1 以降である必要があります。バージョンは、IntelProCube のフォルダーにある RELEASE_INFO.txt で確認できます。

  6. (macOS)quarantine フラグを解除します。 macOS quarantine の行は、ブラウザーやチャットアプリでダウンロードしたツールがあり、実行時にシステムにブロックされることを示します。その行の鍵アイコンをクリックし、確認すると IDE がフラグを削除します。

SDK を開く

IPRO Workbench は、IPRO SDK のフォルダーをワークスペースとして使用します。

  1. SDK フォルダーを開きます。 IPRO Home で Open SDK… をクリックし、IPRO SDK のフォルダー(例:ホームフォルダーの IPRO/SDK/IPRO-SDK-V2.2.1)を選択します。SDK がまだない場合は、Install SDK from GitHub… をクリックします。

    期待される結果:サイドバーの Applications に SDK 内のアプリケーションがカテゴリー別に一覧表示され、検索ボックスに「Filter N applications」と表示されます。

  2. 一覧を絞り込みます。 検索ボックスにキーワード(例:ble)を入力すると、一致するアプリケーションだけが一覧に残ります。入力を消去すると、すべてが再び表示されます。

サイドバーの Applications 一覧を検索ボックスのキーワードで絞り込んだ状態

SDK そのものと、IDE を使わずに入手する方法については、はじめにで説明しています。

ボードを接続する

  1. プローブとボードを接続します。 IPRO Debug Probe を USB ケーブルでコンピューターに接続し、次にプローブを Reef V4 に接続します(プローブはボードのデバッグコネクター U6 に取り付けます。IPRO6S EVK も同じように接続します)。

    期待される結果:サイドバーの Board に IPRO Debug Probe と 2 つのポートが表示されます。例えば macOS では UART cu.usbmodemXXXX · CCI cu.usbmodemYYYY、Windows では UART COM5 · CCI COM6 です。ツールバーのボード名の横にも、同じ UART ポートが表示されます。

  2. ツールバーに琥珀色で「no probe」と表示される場合、IDE はプローブを見つけられていません。USB ケーブルを確認し、できるだけハブを介さずにコンピューターに直接接続します。

Note

プローブには 2 つのポートがあります。UART はボードのコンソールで(シリアルモニターと書き込みの両方で使用します)、CCI は別のインターフェースです。IDE は UART を自動的に選択します。手動で変更するには、ツールバーのボード名をクリックして Select Port… を選択します。

トラブルシューティング

症状 対処
初回起動時に、macOS が開発元を検証できないと表示する 「システム設定 → プライバシーとセキュリティ」を開き、このまま開く をクリックします(インストールを参照)。
インストール時に「Windows によって PC が保護されました」と表示される 詳細情報 をクリックし、アプリ名が IPRO-Workbench であることを確認してから 実行 をクリックします。
CMake またはビルドプログラムがないと表示される(macOS) macOS では、IDE はビルドツールをインストールしません。ターミナルで xcode-select --install と brew install cmake ninja を実行し、Check Again を押します。
Python の行に kconfiglib がないと表示される その行に表示されている pip install コマンドを実行し(上記の手順 4 を参照)、Check Again を押します。
ツールバーに琥珀色で「no probe」と表示される IDE が IPRO Debug Probe を見つけられません。USB ケーブルを確認し、可能であればプローブをコンピューターに直接接続します。接続すると、数秒以内に自動的に表示されます。

その他の問題については、トラブルシューティングを参照してください。

次のステップ