# STM32CubeMX プロジェクト

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> OS : Windows、Linux、macOS
>
>
>
> 必要なツール : STM32CubeMX、STM32CubeCLT
>
>
>
> プロジェクトフォーマット : CMake

CLion は、 [STM32](https://www.st.com/en/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus.html) ボードをターゲットとする組み込みプロジェクト向けに [STM32CubeMX](https://www.st.com/en/development-tools/stm32cubemx.html) と統合されています。 IDE でこれらのプロジェクトを操作する前に、STM32CubeMX と [STM32CubeCLT(英語)](https://www.st.com/en/development-tools/stm32cubeclt.html) をインストールする必要があります。 その後、既存の STM32CubeMX プロジェクトを開くか、新しいプロジェクトを作成してください。

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

> **Note:**
> [STM32Mxx Arm Cortex MPU](https://www.st.com/en/microcontrollers-microprocessors/stm32-arm-cortex-mpus.html) は現在サポートされていません。 これらのボードを CLion で使用する必要がある場合は、お気軽に [CPP-42553](https://youtrack.jetbrains.com/issue/CPP-42553/Rework-STM32CubeMX-support) でユースケースを共有してください。

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

Procedure: プロジェクトを開く

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

![プロジェクトダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_open_project.png)

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

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

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

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

> **Note:**
> まず、システムに [STM32CubeCLT(英語)](https://www.st.com/en/development-tools/stm32cubeclt.html) と [STM32CubeMX(英語)](https://www.st.com/en/development-tools/stm32cubemx.html) の両方がインストールされていることを確認します。

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

![新しい stm32 プロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_new_project.png)

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

> **Tip:**
> ステップ 2 – 10 では、CLion の操作に必要な STM32CubeMX 設定のみを使用します。 STM32CubeMX の機能の詳細については、 [公式ドキュメント(英語)](https://wiki.stmicroelectronics.cn/stm32mcu/wiki/Introduction_to_STM32CubeMX)を参照してください。

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

![cubemx の MCU セレクタへのアクセス](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_access_mcu_board.png)

3. Find your MCU or board in the list, then click  Start Project  in the upper right corner:

![cubemx プロジェクト開始](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_start_project.png)

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 ピン配置ビュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_pinout_configuration.png)

5. Click the  Project Manager  tab.

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

![cubemx cmake ツールチェーン](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_toolchain_cmake.png)

7. In the  Project Name  field, enter the name of your project:

![cubemx プロジェクト名](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_project_name.png)

8. In the upper right corner, click  Generate Code .

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

![cubemx コード生成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_code_generation.png)

10. Copy the path from the  Toolchain Folder Location  field using the keyboard shortcut:  `^C`  on macOS or  `Ctrl ＋ C`  on Windows/Linux:

![cubemx ツールチェーンの場所](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_toolchain_location.png)

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

![プロジェクトの場所](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_proceed.png)

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

![新しいプロジェクトが作成されました](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_project_created.png)

> **Note:**
> 新しい STM32CubeMX プロジェクトを作成すると、CLion は適切な [CMake プロファイル](cmake-profile.html) と [デバッグプロファイル](debug-profiles.html) を自動的に構成します。 これらのデフォルト構成を使用して、すぐにプロジェクトをビルド、実行、デバッグできます。

Procedure: プロジェクトを構築する

プロジェクトをビルドするには、メインツールバーの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.build.build.svg) ボタンをクリックします。

![プロジェクトのビルド](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_build.png)

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

![ビルド完了](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_build_finished.png)

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

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

2. ソースコードにブレークポイントを設定し、メインツールバーの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.debug.svg) ボタンをクリックします。

![デバッグプロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_start_debugging.png)

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

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

* `.svd` ファイルで定義されている [レジスタとペリフェラル](peripheral-view.html)を表示します。 STM32 MCU の場合、これらのファイルは `STM32CubeCLT` インストールディレクトリ内の `STMicroelectronics_CMSIS_SVD` ディレクトリにあります。

* Use [live watches](live-watches.html) to monitor global variables in real time.

* [逆アセンブルされたコード](disassembly-view.html)をデバッグします。

* 実行中のプロセスの [生のメモリ](memory-view.html)を表示します。

![デバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_debug.png)

Procedure: ソースコードを編集する

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

```C
               /* 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 プロジェクトでは、プロジェクトをビルドするすべての環境で同じツールセットが使用されるように、バンドルとそのバージョンがプロジェクトファイル内でロックされます。

> **Note:**
> Cube CLI は、System、MinGW、WSL、Remote SSH ツールチェーンで動作します。 Docker ツールチェーンでは、イメージにすでにインストールされているバンドルのみを使用できます。

Procedure: Cube CLI を構成する

1. [ST ドキュメント](https://dev.st.com/stm32cube-docs/stm32cubedocs-landing-page/en/index.html)の説明に従って、  `cube`  をインストールします。

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

![CLion が設定で cube 実行可能ファイルを検出するか確認する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_stm32_cube_cli_command.png)

3. Cube CLI は、プロジェクトでロックされたバンドルを使用して CMake プロファイルの環境を拡張します。 この機能はデフォルトで有効になっています。 無効にするには、 [詳細設定](advanced-settings.html#advanced-stm32)で   STM32   の下にある   STM32 Cube CLI を使用して CMake の環境を拡張する   チェックボックスをオフにします。

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

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

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

![STM32 Cube CLI サブメニューが開いているツールメニュー。STM32 Cube CLI ターミナルを開くアクションと STM32 Cube プロジェクトに変換アクションが表示されています。״},{](https://resources.jetbrains.com/help/img/idea/2026.3/bundles-lock.store.json`  に保存されます。

> **Tip:**
> プロジェクトにこれら 2 つのファイルを含む  `.settings`  ディレクトリがある場合、Cube プロジェクトとして認識されます。 そこにバンドルを記載しても、プロジェクトがそれを使用することにはなりません。ツールはプロジェクト自体でも参照されている必要があります。

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

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

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

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

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

> **Note:**
> プロジェクトでロックされていない場合でも、統合には常に CMake バンドルが必要です。 このバンドルがないと、CMake 再読み込みが失敗し、CMake 再読み込みターミナルのエラーには 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` 。

## See also

### JetBrains ブログ投稿集

[Working With STM32 Arm TrustZone-Based Projects in CLion](https://blog.jetbrains.com/clion/2026/03/working-with-stm32-arm-trustzone-in-clion/) [CLion for embedded development](https://blog.jetbrains.com/clion/2016/06/clion-for-embedded-development/) [CLion for embedded development, part II](https://blog.jetbrains.com/clion/2017/12/clion-for-embedded-development-part-ii/) [CLion for embedded development, part III](https://blog.jetbrains.com/clion/2019/02/clion-2019-1-eap-clion-for-embedded-development-part-iii/)

### 外部リンク

[Embedded Development in CLion FAQs](https://intellij-support.jetbrains.com/hc/en-us/articles/4405160320274-Embedded-Development-in-CLion) [PEmicro tools in CLion setup guide](https://www.pemicro.com/blog/index.cfm?post_id=245)

