llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

STM32CubeMX プロジェクト

CLion は、 STM32 ボードをターゲットとする組み込みプロジェクト向けに STM32CubeMX と統合されています。 IDE でこれらのプロジェクトを操作する前に、STM32CubeMX と STM32CubeCLT(英語) をインストールする必要があります。 その後、既存の STM32CubeMX プロジェクトを開くか、新しいプロジェクトを作成してください。

CLion は、ST のバンドルマネージャーである Cube CLI もサポートしています。 CMake、ST-LINK GDB サーバー、GNU ツールなど、必要なツールだけをダウンロードし、IDE で開発バンドルを管理できます (詳しくは下の章を参照してください)。 Cube CLI を使用するには、 cube がマシンにインストールされていることを確認してください。

STM32CubeMX プロジェクトを操作する

プロジェクトを開く

  • CLion を起動したら、 ようこそ 画面で オープン をクリックします。

    プロジェクトダイアログ

    Then, navigate to your project folder, select it, and click Open. すると、CLion がプロジェクトを CMake として開きます。

  • プロジェクトフォルダー内の .ioc ファイルを選択し、 プロジェクトとして開く​ をクリックすることもできます。 .ioc ファイル名にスペース、非ラテン文字、その他の特殊文字が含まれていないことを確認してください。

  • CLion がすでに実行されている場合は、 ファイル| オープン に移動し、プロジェクトフォルダーまたは .ioc ファイルを開きます。

新規プロジェクトを作成する

  1. CLion で、 ファイル|新規|プロジェクト に移動し、プロジェクトタイプとして STM32CubeMX を選択します。

    新しい stm32 プロジェクト

    その後、 新規プロジェクト 画面に表示される手順、または以下の詳細な手順に従います。

  2. STM32CubeMX を起動します。 In the window that opens, click ACCESS TO MCU SELECTOR. You can also select ACCESS TO BOARD SELECTOR.

    cubemx の MCU セレクタへのアクセス
  3. Find your MCU or board in the list, then click Start Project in the upper right corner:

    cubemx プロジェクト開始
  4. The Pinout & Configuration tab will open. From there, you can change the default settings displayed in Pinout view, configure additional parameters, or install middleware if necessary.

    cubemx ピン配置ビュー
  5. Click the Project Manager tab.

  6. From the Toolchain / IDE dropdown menu, select CMake:

    cubemx cmake ツールチェーン
  7. In the Project Name field, enter the name of your project:

    cubemx プロジェクト名
  8. In the upper right corner, click Generate Code.

  9. Once generation is finished, close the Code Generation window:

    cubemx コード生成
  10. Copy the path from the Toolchain Folder Location field using the keyboard shortcut: ^C on macOS or Ctrl + C on Windows/Linux:

    cubemx ツールチェーンの場所
  11. CLion 新プロジェクト ウィンドウに戻ります。 Enter the path you copied in the ロケーション field at the top of this dialog, then click 続行:

    プロジェクトの場所
  12. STM32CubeMX プロジェクトが作成されます。

    新しいプロジェクトが作成されました

プロジェクトを構築する

プロジェクトをビルドするには、メインツールバーの ボタンをクリックします。

プロジェクトのビルド

すべてが正しく動作している場合は、 メッセージ ウィンドウに Build finished が表示されます。

ビルド完了

    プロジェクトをデバッグする

    1. 適切な実行 / デバッグ構成と ST-LINK デバッグサーバーが設定されていることを確認してください。 新しい STM32CubeMX プロジェクトの場合は、CLion が事前設定したデフォルト設定を使用できます。

    2. ソースコードにブレークポイントを設定し、メインツールバーの ボタンをクリックします。

      デバッグプロジェクト

      すべてが正しく動作している場合は、デバッガーの コンソール タブに Debugger connected to ST-LINK というメッセージが表示されます。

    3. プログラムが一時停止されると、次のようなさまざまなアクションを実行できます。

      デバッグ

    ソースコードを編集する

    • STM32CubeMX によって生成されたファイルを編集する際は、必ずコードを /* USER CODE BEGIN ... */ および /* USER CODE END ... */ 疑似コメントで囲んでください。 次に例を示します。

      /* Infinite loop */ /* USER CODE BEGIN WHILE */ while (1) { HAL_GPIO_TogglePin(LD3_GPIO_Port, LD3_Pin); HAL_Delay(1000); /* USER CODE END WHILE */

      これにより、コードの再生成中に STM32CubeMX によってコードが上書きされるのを防ぐことができます。

    • ソースファイルまたはヘッダーファイルを追加する場合は、 Src ディレクトリと Inc ディレクトリに配置してください。 また、コードの一部を個別の .c ファイルまたは .h ファイルに抽出してください。

    Cube CLI でバンドルを管理する

    Cube CLI は開発ツールを バンドル として配布します: CMake、コンパイラー、ST-LINK GDB サーバー、GNU ツール、その他のコンポーネント。 Cube プロジェクトでは、プロジェクトをビルドするすべての環境で同じツールセットが使用されるように、バンドルとそのバージョンがプロジェクトファイル内でロックされます。

    Cube CLI を構成する

    1. ST ドキュメントの説明に従って、 cube をインストールします。

    2. CLion は cube 実行可能ファイルを自動的に検出します。 検出されたパスを確認するか、現在のデフォルトツールチェーン用に手動で設定するには、 設定 | ビルド、実行、デプロイ | 組み込み開発 | STM32 を開き、 Cube CLI コマンド フィールドを使用します。

      CLion が設定で cube 実行可能ファイルを検出するか確認する
    3. Cube CLI は、プロジェクトでロックされたバンドルを使用して CMake プロファイルの環境を拡張します。 この機能はデフォルトで有効になっています。 無効にするには、 詳細設定で STM32 の下にある STM32 Cube CLI を使用して CMake の環境を拡張する チェックボックスをオフにします。

    プロジェクトを Cube プロジェクトに変換する

    プロジェクトがまだ Cube プロジェクトでない場合、 ツール | STM32 Cube CLI には STM32 Cube プロジェクトに変換 と STM32 Cube CLI ターミナルを開く の 2 つのアクションが含まれます。 ターミナルアクションについては、 Cube CLI コマンドを実行するを参照してください。

    1. ツール | STM32 Cube CLI | STM32 Cube プロジェクトに変換 に進みます。

      STM32 Cube CLI サブメニューが開いているツールメニュー。STM32 Cube CLI ターミナルを開くアクションと STM32 Cube プロジェクトに変換アクションが表示されています。״},{
    2. CLion は Cube プロジェクトを初期化し、CMake やコンパイラーなど、プロジェクトがすでに使用しているツールをロックします。 ロックされたツールは、プロジェクトルートの .settings/bundles.store.json と .settings/bundles-lock.store.json に保存されます。

    プロジェクトバンドルをインストールする

    Cube プロジェクトでは、 ツール | STM32 Cube CLI でさらに 2 つのアクションが使用可能になります:

    プロジェクトバンドルのインストール

    Cube CLI によってロックされているが、マシンにないバンドルをインストールします。

    すべての環境にプロジェクトバンドルをインストール

    プロジェクトが使用するすべてのマシンに、不足しているバンドルをインストールします。 このアクションは、CMake プロファイルが異なるマシン (ローカルツールチェーンとリモートツールチェーンなど) をターゲットにしている場合に表示されます。

    不足しているバンドルが必ずしも CMake 再読み込みを中断するわけではありません。Cube CLI は同等のツールを探し、代わりに使用します。 この場合、CMake 再読み込みターミナルには、必要なバンドルをインストールするクイックフィックス付きの警告が表示されます。

    Cube CLI コマンドを実行する

    既存のプロジェクトのバンドルを管理するには、Cube CLI コマンドを使用します。 ツール | STM32 Cube CLI | STM32 Cube CLI ターミナルを開く に移動して、選択した CMake プロファイルの環境で cube を使用できるターミナルを開きます。 ターミナルエミュレータ ツールウィンドウのタブドロップダウンリストから開くこともできます。

    cube bundle list-online

    ダウンロード可能なバンドルとそのバージョンを一覧表示します。

    cube bundle show

    cube bundle show <bundle> は、バンドルの詳細を表示します: 設定する環境変数、 PATH 変数のエントリ、提供するコマンド。

    cube bundle init

    cube bundle init --project <bundles> は現在のプロジェクトを Cube プロジェクトに変換し、指定されたバンドルをその中でロックします。

    cube bundle install

    cube bundle install --project <bundles> は指定されたバンドルをインストールし、プロジェクトでロックします。 バンドルをグローバルにインストールするには、 --project を省略します。

    cube bundle remove

    cube bundle remove --project <bundles> は、プロジェクトでロックされたツールから指定されたバンドルを削除します。 バンドルをグローバルにアンインストールするには、 --project を省略します。

    これらのコマンドでは、 <bundles> は bundle_name@version 形式を使用します。 例: gnu-tools-for-stm32@14.3.1+st.2。

    2026 年 11 月 6 日