# マルチスレッド RTOS デバッグ

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

RTOS でデバッグする場合、CLion は [FreeRTOS](https://www.freertos.org/)、 [Azure RTOS](https://azure.microsoft.com/en-us/products/rtos/)、 [Zephyr](https://zephyrproject.org/) のタスク（スレッド）を表示できます。 FreeRTOS の場合、 [オブジェクト](#rtos-objects)と [ヒープ](#rtos-heap)も探索できます。

> **Tip:**
> 一部の  gdbserver  には、さまざまな RTOS のサポートが組み込まれています。 このような場合に CLion 統合が正しく機能するには、gdbserver 側の組み込みサポートを必ず無効にしてください。

Procedure: RTOS スレッドビューを有効にする

1. `設定 | ビルド、実行、デプロイ | 組み込み開発 | RTOS 統合`  に進みます。

2. RTOS 統合を有効にする   チェックボックスを設定し、オプションのリストから選択します。

![RTOS 統合の有効化](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_integration_enable.png)

> **Note:**
> RTOS 統合には、Python 対応の GDB 7.4 以降が必要ですのでご注意ください。 そのために CLion 同梱の GDB を利用できます。詳しくは [デバッガーの切り替え](configuring-debugger-options.html#select-debugger) をご参照ください。

RTOS 統合は、 [実行/デバッグ構成](run-debug-configuration.html)（例えば [Embedded GDB サーバー](embedded-gdb-server.html) や [OpenOCD ダウンロード &amp; 実行](openocd-support.html#opecocd-debug)）で利用できるように設計されています。

例: [QEMU(英語)](https://www.qemu.org/) エミュレーターを使用して組み込み GDB サーバー構成をセットアップする方法は次のとおりです。

![組み込み GDB サーバーの構成例](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_qemu_config.png)

## FreeRTOS/Azure RTOS/Zephyr タスクビュー

上記のような構成をデバッグすると、FreeRTOS/Azure RTOS/Zephyr タスクが [デバッグツールウィンドウ](debug-tool-window.html)の   スレッド & 変数   ペインに表示されます。

![FreeRTOS スレッドビュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_debug_threadview.png)

タスクごとに、変数が   変数   ペインに表示されます。

RTOS タスクビューは [対称型マルチプロセッシング (SMP)(英語)](https://en.wikipedia.org/wiki/Symmetric_multiprocessing) でも機能します。 プロセッサーコアは同一で、同じメモリを共有する必要があります。

> **Note:**
> Zephyr を使用している場合は、プロジェクトの構成ファイルで  `CONFIG_THREAD_MONITOR`  と  `CONFIG_THREAD_NAME`  を設定してください。設定されていないと、デバッガーが必要な情報を取得できません。 定義が不足している場合、CLion が通知します：
>
> ![Zephyr 構成パラメーターがありません](https://resources.jetbrains.com/help/img/idea/2026.3/cl_zephyr_notification.png)

## FreeRTOS オブジェクトビュー

FreeRTOS のオブジェクトを確認するには、   FreeRTOS オブジェクト   タブに切り替えてください。  Task  テーブルはステータス情報付きのタスクリストを表示し、  Queue  テーブルは現在アクティブなキュー、セマフォ、ミューテックスを表示し、  Timer  テーブルはソフトウェアタイマーを一覧表示します：

![FreeRTOS オブジェクトビュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_objectsview.png)

このタブが正しく機能するようにするには、  `FreeRTOSConfig.h`  で次の定義を構成します。

* タスク番号とキュータイプを表示するには、 `configUSE_TRACE_FACILITY` を 1 に設定します。

* タスク名を正しく表示するために、 `configMAX_TASK_NAME_LEN` をゼロより大きい値に設定してください。

* タスクスタック情報を表示するには、 `configRECORD_STACK_HIGH_ADDRESS` を 1 に設定します。

* ランタイム情報（タスクテーブルのランタイム列）を収集するには、 `configUSE_TRACE_FACILITY` および `configGENERATE_RUN_TIME_STATS` を 1 に設定します。

* ゼロより大きい `configQUEUE_REGISTRY_SIZE` および `vQueueAddToRegistry()` を使用して、キュー、セマフォ、ミューテックスに名前を割り当てます。 タスク（作成時に名前を取得する）とは異なり、キューにはデフォルトで名前がないため、これは便利です。

CLion は、一部の定義が不足している場合に警告を表示します：

![FreeRTOS は欠落を定義する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_defines_warning.png)

## FreeRTOS ヒープビュー

FreeRTOS ヒープ   タブには、すべてのデフォルトの FreeRTOS メモリ管理スキームの現在のヒープ使用量とメモリブロック割り当てが表示されます。

> **Note:**
> [heap_5](https://www.freertos.org/a00111.html) を正しくサポートするには、グローバルスコープで  `xHeapRegions`  変数を定義してください。例えば：
>
>
> ```CPLUSPLUS
> HeapRegion_t xHeapRegions[] = {
> { &heap_sram_lower1[0], sizeof(heap_sram_lower1)},
> { &heap_sram_lower2[0], sizeof(heap_sram_lower2)},
> {NULL, 0}
> };
> int main( void ) {...}
>
> ```

![FreeRTOS ヒープビュー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_rtos_heapview.png)

## See also

### プロシージャ

[組み込み開発](embedded-overview.html) [組み込み GDB サーバー](embedded-gdb-server.html) [OpenOCD のサポート](openocd-support.html) [デバッグ](debugging-code.html)

### ハウツー

[デバイスツリーファイル](dts-support.html) [リンカースクリプト](language-support-for-linker-scripts.html)

