概要

EmfrpのためのデバッガEmdbのためのリポジトリです. 以下のコンポーネントから構成されています.

• python : デバッガ本体
• vscode-extension/emdb : VSCode拡張
• ruby/emfrp-compiler : 拡張Emfrpコンパイラ
• sample : ホストPCで動作するサンプル
• sample-esp32 : ESP32で動作するサンプル

前提ツールとテスト済み環境

• M2 Macbook Sequoia 15.5
• pipenv(2025.0.4)
• python(3.9.6)
• lldb(Apple Swift version 6.0.3)
• npm(11.4.2)
• gem(3.7.0)
• ruby(3.3.8)
• esp-idf(5.5.1)
• gcc(Apple clang version 16.0.0)
• ESP32 + ESP-Prog

デバッグ手順

コンパイル

ruby/emfrp-compilerコンポーネントでEmfrpモジュールをコンパイルできます。 コンパイル手順はruby/emfrp-compilerディレクトリのREADMEを参照してください。 コンパイルするとModuleName.c, ModuleNameMain.c, ModuleName.mapping.jsonファイルが生成されます。 MoculeName.c, ModuleNameMain.cは公式コンパイラが生成するものと同じ扱いです。 mapping.jsonファイルはデバッガ本体が利用するものなので編集しないでください。

ビルド

Emfrpプログラムのビルドと同様の手順でビルドを行ってください。 実機を利用する場合は実機へのFlashまで行ってください。 サンプルを利用する場合のビルド手順はsample, sample-esp32ディレクトリのREADMEを参照してください。 -Og以上の最適化オプションをつけた場合の動作は保証されないので注意してください。

デバッグ

vscode-extension/emdbディレクトリからVSCode拡張機能をインストールまたは直接起動できます。 VSCode拡張機能はデバッガ本体（pythonディレクトリ）およびEmfrpインタープリタ（ruby/emfrp-compilerディレクトリ）を自動で起動するのであらかじめセットアップしてください。 VSCode拡張機能の起動手順はvscode-extension/emdbのREADMEを参照してください。