# 組み込み GDB サーバー

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

> **TL;DR**
> OS  : Windows (MinGW または MinGW-w64) / Linux / macOS
>
>
>
> 必要なツール  ：ソフトウェアを搭載したデバッグプローブ、クロスコンパイラーツールチェーン
>
>
>
> ビルドターゲット  : CMake / Makefile / カスタムビルドターゲット

GDB サーバーを使用してオンチップでデバッグするには、特別な実行 / デバッグ構成を作成する必要があります。 CLion では、次の GDB サーバー用に   新しい組み込み構成   ウィザードを使って構成をすばやく作成できます：

* [Segger J-Link(英語)](https://www.segger.com/downloads/jlink/#J-LinkSoftwareAndDocumentationPack) GDB サーバー

* GDB サーバーとしての [Qemu(英語)](https://en.wikibooks.org/wiki/QEMU/Debugging_with_QEMU)

* [PyOCD(英語)](https://pyocd.io)

* [st-util(英語)](https://github.com/stlink-org/stlink) (ST-LINK デバッグプローブ用のオープンソース GDB サーバー)

* ST-LINK_gdbserver ( [STM32CubeIDE(英語)](https://www.st.com/en/development-tools/stm32cubeide.html) の一部)

* [PE マイクロ (OpenSDA)(英語)](https://www.pemicro.com/opensda/)

GDB サーバープロトコルに準拠する他のデバッグプローブソフトウェアの実行 / デバッグ構成を作成することもできます。 これを行うには、   実行 / デバッグ構成   ダイアログから新しい   組み込み GDB サーバー   構成を追加します。 詳細については、 [Embedded GDB サーバーの構成を調整する](#gdbserver-config) を参照してください。

> **Note:**
> この記事で説明した方法とは別の方法を使用して、組み込み GDB サーバーをセットアップできます。 [Debug Servers](debug-servers.html) 構成オプションを使用すると、さまざまな gdbserver を構成してビルドターゲットと組み合わせる、より便利な方法が提供されます。

Procedure: 始める前に

1. クロスコンパイラー [ツールチェーン](embedded-overview.html#toolchains)を構成します。

> **Note:**
> Windows では、 [システム](quick-tutorial-on-configuring-clion-on-windows.html#system)ツールチェーンに切り替えます（推奨）。 または、 [MinGW/MinGW-w64](quick-tutorial-on-configuring-clion-on-windows.html#MinGW) 環境を使用することもできます。

2. 選択した GDB サーバーがマシンにインストールされていることを確認してください。 手動で起動する必要はありません。構成によって、デバッグセッション開始時に [GDB サーバー](#run-debug) が自動的に実行されます。

Procedure: 組み込み GDB サーバー構成を作成する

1. メインメニューで  `実行 | 新しい組み込み構成`  アクションを選択します。

2. 開いたウィザードで、次を設定します。

![新しい組み込み GDP サーバー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_embedded_config_wizard.png)

* GDB サーバーの種類 : GDB サーバーの型を選択します。 CLion は、このサーバーで必要な引数を自動的に事前定義します。

* ロケーション : GDB サーバーとして使用されるバイナリへのフルパスを指定します。 > **Tip:** > STM32CubeIDE ST-LINK GDB サーバーの場合、STM32CubeIDE バイナリへのパスを指定します。 > > > > PE-Micro の場合、プラットフォーム固有のバイナリへのパスを指定します。 詳細は [PEmicro GDB サーバーをセットアップする](#pemicro)を参照してください。

* デバッガー​ ：CLion 側で実行され、リモート GDB サーバーに接続する GDB デバッガーを選択します。 バンドルされた GDB またはカスタム GDB バイナリのいずれかを使用します。

* ターゲット​ と 実行可能バイナリ : ビルドするターゲットと、デバイスにダウンロードされる実行可能バイナリを選択します。

* 実行可能ファイルをダウンロード : 実行可能バイナリをターゲットデバイスにダウンロードするタイミングを指定します。 * 常に : デバッグセッション開始ごと。 * 更新された場合 : バイナリの変更時のみ。 * なし : ダウンロードをスキップします。

* TCP/IP ポート : GDB サーバーのポートを明示的に指定するか、このフィールドを空のままにしてランダムなポートを使用します。

3. 次へ   をクリックします。 ウィザードの次のページでは、選択した GDB サーバータイプに固有の設定を調整できます。 例: Segger JLink サーバーの場合、トランスポートインターフェース種類、初期速度、デバイスを選択できます。

![GDB サーバーデバイス](https://resources.jetbrains.com/help/img/idea/2026.3/cl_GDB_wizard_devices.png)

4. 作成   をクリックします。 指定されたサーバーに必要な引数を使用して、組み込み GDB サーバーの新しい実行 / デバッグ構成が作成されます。 調整方法については、次の手順を参照してください。

Procedure: Embedded GDB サーバーの構成を調整する

1. `実行 | 実行構成の編集​`  に移動し、編集する構成を選択します。

> **Note:**
> 使用可能な GDB 構成がない場合は、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして   実行 / デバッグ構成   ダイアログで   組み込み GDB サーバー   を選択するか、 [新しい組み込み構成](#create_GDB_config)ウィザードを使用して、新しい構成を作成できます。

2. ここから、次の設定を構成できます。

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

* デバッガー​ ：CLion 側で実行され、リモート GDB サーバーに接続する GDB デバッガーを選択します。 バンドルされた GDB またはカスタム GDB バイナリのいずれかを使用します。

* ターゲット​ と 実行可能バイナリ : ビルドするターゲットと、デバイスにダウンロードされる実行可能バイナリを選択します。

* 実行可能ファイルをダウンロード : 実行可能バイナリをターゲットデバイスにダウンロードするタイミングを指定します。 * 常に : デバッグセッション開始ごと。 * 更新された場合 : バイナリの変更時のみ。 * なし : ダウンロードをスキップします。

* 'target remote' 引数 : デバッグパケットを伝送する媒体 (TCP または UDP を使用したシリアルラインまたは IP ネットワーク) を提供します。 リモートターゲットへの接続の詳細については、 [gdb のドキュメント(英語)](https://sourceware.org/gdb/onlinedocs/gdb/Connecting.html#Connecting)を参照してください。

* GDB サーバー : GDB サーバーとして使用するバイナリを指定します。

* GDB サーバーの引数 : GDB サーバー固有の引数 (ポート番号やボード構成ファイルなど) を提供します。

* `高度な GDB サーバーオプション | リセットコマンド` : デフォルトでは、このコマンドは MCU をフラッシュした後に送信され、デバッグセッション中に ![MCU reset](https://resources.jetbrains.com/help/img/idea/2026.3/clion-embedded.icons.expui.resetMcu.svg) を押したときにも送信されます。 通常は [monitor(英語)](https://sourceware.org/gdb/current/onlinedocs/gdb/Server.html) で始まり、残りの行は GDB サーバーに直接渡されます。 ほとんどの GDB サーバーは複数のリセットコマンドをサポートしていることに注意してください（ベンダー固有のドキュメントを参照してください）。 リセットは、MCU ROM のフラッシュや RAM への書き込みの前後、常に（前後両方）、または実行しないなど、異なる段階で実施できます。 ![gdb サーバーのリセットオプションを埋め込む](https://resources.jetbrains.com/help/img/idea/2026.3/cl_embed_sgbserver_reset_options.png)

* `高度な GDB サーバーオプション | 起動遅延` ：GDB サーバーを開始した後、CLion が接続を試みるまでの待機時間。

Procedure: 組み込み GDB サーバー設定をデバッグする

この構成を   デバッグ   ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) とすると、CLion は一連のステップを実行します。

1.  指定された環境で GDB サーバーを起動します。

2.  設定された起動遅延時間が経過するまで待ちます。

3.  GDB クライアントを起動して GDB サーバーに接続します。

4.  構成設定の   ダウンロード   オプションで指定されたとおりにバイナリをアップロードします。

5.

デバッグセッションを開始します。

これで、オンチップで動作しているファームウェアを、 [メモリビュー](memory-view.html)、 [マルチスレッド RTOS デバッグ](rtos-debug.html)、およびペリフェラルレジスタやビットを表示する [周辺機器](peripheral-view.html) タブを含む CLion デバッグ機能全体を使ってデバッグできます。

![Debugging an Embedded GDB Server configuration](https://resources.jetbrains.com/help/img/idea/2026.3/cl_embed_gdbserver_debug.animated.gif)

デバッガーツールウィンドウの左側のバーにある ![MCU reset](https://resources.jetbrains.com/help/img/idea/2026.3/clion-embedded-plugin.icons.expui.resetMcu.svg) ボタンに注目してください。 押すと、構成設定の   リセットコマンド   フィールドで指定されたチップリセットコマンドを送信します。

Procedure: PEmicro GDB サーバーをセットアップする

1. [ARM デバイス用の PEmicro GDB サーバー - Eclipse プラグイン(英語)](https://www.pemicro.com/products/product_viewDetails.cfm?product_id=15320151&productTab=3)をダウンロードします (登録が必要です)。

2. ダウンロードしたアーカイブを一時フォルダーに解凍します。

3. `plugins/com.pemicro.debug.gdbjtag.pne_<version>.jar`  ファイルを目的のインストールフォルダーに解凍します。

4. オペレーティングシステムに応じて、そのフォルダーの  `\win32\pegdbserver_console.exe`  、  `osx/pegdbserver_console`  、または  `lin/pegdbserver_console`  ファイルを GDB サーバーバイナリとして使用します。

## See also

### 外部リンク

[Embedded Development in CLion FAQs](https://intellij-support.jetbrains.com/hc/en-us/articles/4405160320274-Embedded-Development-in-CLion) [Using nRF52 with CLion](https://blog.jetbrains.com/clion/2020/01/using-nrf52-with-clion/) [Tutorial: Using nRF52 With nRF Connect SDK, CMake, and CLion](https://blog.jetbrains.com/clion/2021/04/using-nrf52-with-cmake-connect-sdk/)

