M-VAVE FM-1 Pocket Synthesizerファームウェアのリバースエンジニアリング
Reverse Engineering of the M-VAVE FM-1 Pocket Synthesizer Firmware (github.com)
要約
このGitHubリポジトリは、M-Vave FM-1シンセサイザーのファームウェアのリバースエンジニアリングとアップデートプロトコルの研究結果を公開しています。分析により、シンセサイザーがJieLi AC791N/WL82チップセットとpi32v2 CPUを使用していることが特定され、そのFMエンジンはDexed/msfaから派生したものであることが示唆されています。リポジトリには、アーキテクチャ概要、OTAプロトコル、デバッグインターフェース、および関連ツールやスクリプトが含まれていますが、安全なリカバリパスはまだ確立されていません。
全文翻訳
FM-1 ファームウェアのリバースエンジニアリング
M-Vave FM-1 シンセサイザーのファームウェアのリバースエンジニアリングとアップデートプロトコルの研究。パッケージ、SPL、SDKの出所から、ターゲットがJieLi AC791N/WL82であり、pi32v2 CPU、0x02000000 のXIPフラッシュ、およびDexed/msfa派生の6オペレーターFMエンジンであることが特定されました。埋め込まれたJL-BR22文字列は、継承されたライブラリの命名規則であり、信頼できるSoC識別子ではありません。
このmainブランチには、意図的に代替ファームウェアやカスタムイメージビルダーは含まれていません。以前の実験的な実装は、with-custom-firmware ブランチに保存されています。
ここから始める
- アーキテクチャ概要: マッピングされたハードウェア、ブートチェーン、メモリレイアウト、主要サブシステム。
- OTAプロトコル: キャプチャされたUSB-MIDIフレーミング、セッションフロー、ローダーの動作、未解決のゲート。
- 安全性の評価と未解決の質問: いかなるアップデートパスも回復可能と見なす前に必要な証拠。
- デバッグインターフェース監査: コンソール、ファクトリーモード、テストコマンド、リカバリエントリーポイントの静的検索。
- デバイスOTAローダーと終了ゲートトレース: 抽出、制御フロー、フラッシュゲート、ターミナルハンドシェイク。
- Windowsアップデーター分析: M-UPGRADEステートマシンとID解析の逆コンパイル。
- Linuxプロトコルクライアント、ツールの注釈、オフラインテスト。
リポジトリのレイアウト
- analysis/: V13逆アセンブリ、バイト同一再構築、関数データベース、分類、OTAローダー分析、ホストアップデーター逆コンパイル。
- docs/: ファームウェア特性評価、アーキテクチャ、サブシステム分解、関数インデックス、OTA調査結果。
- scripts/: 逆アセンブリ、抽出、インデックス作成、分類パイプライン。
- tools/: USB-MIDIアップデートプロトコルクライアントとオフラインテスト。
- ghidra/scripts/: チェックインされたpi32v2ヘッドレス分析スクリプト。
- firmware-images/: 不変のV13およびV14パッケージと展開された入力。
reference/: scripts/setup_reference.shによって生成された、無視されたSDK、Ghidraインストール、およびアップストリームソースミラー。- 3rd-party/jl-misctoolsおよび3rd-party/jl-uboot-tool: ファームウェア解析およびブートツール参照に使用されるピン留めされたサブモジュール。
リポジトリには、独立して開発された2つのV13分析パイプラインが保持されています。analysis/README.mdがそれらの役割を説明しています。analysis/db.jsonとdocs/function-index.mdは現在の分類出力であり、analysis/function_db.jsonとanalysis/master_index.jsonは独立した相互検証と出所を提供します。
再現方法
リポジトリのルートからコマンドを実行してください:
# 低レベル逆アセンブリと独立した関数マップ
scripts/run_ghidra.sh
python3 scripts/build_funcdb.py
python3 scripts/resolve_strings.py
python3 scripts/match_libs.py
python3 scripts/build_master_index.py
python3 scripts/build_slices.py
# OTAローダー抽出、ベンダーマップ、および検証用Ghidraスキャン
scripts/analyze_ota_loader.sh
scripts/run_ghidra_loader.sh
# 現在の強化された分類データベースとドキュメント
python3 scripts/build_db.py
scripts/disasm_toolchain_libs.sh
python3 scripts/match_libs.py
python3 scripts/mech_tag.py
python3 scripts/export_shards.py
python3 scripts/aggregate.py
# オフラインOTAプロトコルチェック
python3 -m unittest discover -s tools/tests -v
安全性ステータス
アップデートプロトコルは、実証された回復メカニズムではありません。現在の作業では、シングルバンクレイアウトに対するROMリカバリ、ロールバック、または安全な中断書き込み動作は確立されていません。コンソール/ファクトリーモードの監査(analysis/device/debug-surfaces.md)では、代替のリカバリエントリーは見つかりませんでした。いかなるアップデートまたはフラッシュユーティリティを使用する前に、TODO_aug2.mdをお読みください。
外部参照
- USB_KEY | jielie: JieLi USBブートをD+/D-の信号で呼び出す方法に関するリバースエンジニアリングされたノート。キー波形、確認応答、タイミング、USBバスの注意点が含まれます。
- JL SoCフォーラムスレッド: JieLi SoC、SDK、ツールチェーン、プログラマー、ブートアクティベーター、USB/ISP/UARTキー実験に関する長期にわたるロシアのコミュニティディスカッション。報告はコミュニティの観察であり、議論されているチップファミリーにのみ適用される場合があります。
- SMK-37 Proコミュニティノート: 関連するM-Vave/JieLiキーボードに関する観察。共有パッケージング、アップデート、ハードウェアの慣習の特定に役立つ可能性があります。
- kagaimiq/jl-misctools (
3rd-party/jl-misctools、../jl-misctoolsとしてもチェックアウト): JieLiファームウェアコンテナ、キーファイル、UIリソース、および古い形式用のユーティリティ。 - kagaimiq/jl-uboot-tool (
3rd-party/jl-uboot-tool): UBOOTデバイスの検出、RAMへのコードロード、フラッシュの読み取り、書き込み、消去用のPythonツール。そのサポートテーブルはWL82/AC791Nを不明としてリストしているため、確立されたFM-1フラッシャーではありません。 - Jieli-Tech/fw-AC79_AIoT_SDK (
../fw-AC79_AIoT_SDK): ペリフェラルおよびMaskROM APIヘッダー、ブート/アップデート設定、ライブラリ、ビルドツール、および標準ファームウェアの動作を特定するために使用されるアプリケーション例を含む、公式のAC791N/WL82 SDK。