デバッグサーバー

デバッグサーバーを使うことで、組み込み開発でのデバッグ設定が簡単に行えます。事前構成済みデバッグサーバーを使用すると、実行/デバッグ構成や CMake や Makefile などのビルドシステムターゲットを実行できます。また、GDB ターゲット拡張リモートモードとして知られる長時間実行されるデバッグサーバーセッションも実行できます。これは、デバッグを停止してもサーバーが終了しません。

このガイドでは、デバッグサーバーを構成してデバッグセッションを実行する方法について説明します。機能のデモを行うために、SEGGER J-Link デバッガーが組み込まれた nRF52840 開発キット(英語)と、コンソールに「Hello world」を出力する簡単なアプリケーション例を使用します。

デバッグサーバーの設定

設定 | ビルド、実行、デプロイ | デバッガー | デバッグプロファイルに進みます。
組み込み開発用デバッガーの下で、お使いのデバッグプローブ用タイルをクリックします。 CLion はそのタイプの新しいデバッグサーバープロファイルをリストに追加します。
GDB サーバータイルはどのデバッグプローブにも対応し、より幅広いオプションを提供します。他はより特化されており、必要なオプションのみを提供します。 SEGGER J-Link プロファイルは J-Link デバッグプローブをターゲットとし、 ST-LINK と ESP-IDF はそれぞれ STM32CubeMXおよび ESP-IDFプロジェクトをターゲットとします。
プロジェクトの必要に応じて、適切なタブで GDB サーバー、デバイス、デバッガーを構成します。
デバッグサーバーテンプレートには、そのまま使用できるデフォルト設定がいくつかあります。ただし、カスタマイズが必要な場合や、カスタマイズしたい場合もある設定がいくつかあります。参考までに、以下の SEGGER J-Link および GDB サーバー設定を参照してください。
J-Link ソフトウェアがインストールされている(英語)があることを確認してください。
注意すべき重要な設定:
- SEGGER JLink GDB サーバータブでは、作業するデバイスを指定する必要があります：
  CLion は実行可能ファイルを使ってインストールパスを推測しようとしますが、場合によっては手動でパスを指定する必要があります。
- デバイス設定タブでは、 RTT、 Semihosting 、または SWO など、希望するコンソールタイプを選択して設定でき、 printf 出力を表示できます。ポートに加えて、SWO には他にも設定すべきパラメーターがあります。 MCU やファームウェアも適切に設定されていることを確認してください。
- デバッガータブには永続セッションオプションがあります。このオプションはデフォルトで有効化されており、セッション終了後もデバッグサーバーへの接続を維持します。 GDB サーバーのポートを指定する必要があります。
  永続セッションは、デバッグサーバーが再起動するのを待たずに次のセッションの準備をしたい場合に便利です。必要ない場合は、このオプションをオフにすることができます。
注意すべき重要な設定:
- GDB サーバータブにはデフォルト設定がないため、すべてのフィールドを手動で指定する必要があります。
- GDB サーバータブのヘルプフィールドでは、 --ヘルプ コマンドラインパラメーターを使用して GDB サーバーを実行し、このフィールドで直接出力を表示し、使用可能な引数を見つけることができます。青色でハイライトされた引数をクリックすると、自動的に引数フィールドに追加されます。このオプションは、 --ヘルプ パラメーターをサポートする GDB サーバーでのみ機能することに注意してください。
- 引数フィールドの横にあるテスト実行… をクリックして、引数の有効性を確認することもできます。
- デバイス設定タブでは、コンソールポートのみを指定できます。つまり、コンソールの種類に制限はなく、任意の種類を使用できます。コンソールを構成するには、 GDB サーバータブの引数フィールドを使用します。
- デバッガータブでは、永続セッション機能に複数の構成オプションがあります。引数フィールドで、TCP ホストやポート、その他コマンドライン引数を指定できます。デバッグ開始時に実行するカスタム接続スクリプトも作成できます。
デバッグサーバーの設定が完了したら、 OK をクリックします。デバッグサーバープロファイルはメインツールバーのデバッグプロファイルスイッチャーに表示され、デバッグを開始できます。

Git などのバージョン管理システムでデバッグサーバープロファイルを共有するには、プロファイル設定で共有オプションを選択してください。 CLion は共有プロファイルを .idea/debug-profiles.xml ファイルに保存します。詳細については、デバッグプロファイルの共有を参照してください。