TSUNAGI///Matrix — MAPPING

matrix-tsunagi — TSUNAGI///Matrix

TSUNAGI の BMW E46 M3 ツールを支える計算機能を、ライブラリ、コマンドライン、MCP サーバーとして提供します。 MSS54HP DME イメージとドライブログを読み込み、走行データが裏付ける VE マップ補正値を取得できます。 SMG II ギアボックスイメージを読み込み、キャリブレーションをデコードして比較できます。 DME のバックアップやクラスター EEPROM のバックアップを読み込み、内容を確認できます。 車両もケーブルもなくても、ご自身のマシンで実行できます。

npx matrix-tsunagi mapping ve --sample

--sample は、パッケージに同梱されている練習用ファイルで実行します。ご自身のファイルを使う場合は、--bin <file.bin> --log <file.csv> に置き換えてください。

AI アシスタント（Claude、ChatGPT など）へのインストール方法： INSTALL.md をご覧ください。このリポジトリをアシスタントに渡すと、そのクライアントに適したものをインストールできるように書かれています。

TSUNAGI///M は、E46 M3（S54 エンジン、MSS54HP DME、SMG II）向けの TSUNAGI のツールファミリーです。 オーナーは m3.tsunagi.app でツールを利用でき、AI アシスタントはこちらで利用できます。 TSUNAGI///Matrix は、AI アシスタント向けのファミリーのゲートウェイです。独自の計算は行わず、各ツールのコードをカテゴリーごとにアシスタントへ届けます。 このパッケージには 2 つのカテゴリーが含まれています。MAPPING：MSS54HP CSL CONVERT /// TUNER と E46M3SMG2 /// MAPPING。 MIGRATION：MSS54HP CSL CONVERT /// BOOT と E46 M35080 /// MIGRATION のバックアップを読み取ります。読み取りのみを行います。

質問する

Testo のログから、CSL 変換済み MSS54HP の VE（alpha-N）マップを補正するにはどうすればよいですか？

npx matrix-tsunagi mapping ve --bin my.bin --log drive.csv --out tuned.bin

変更されるセルとその変更量、追加の走行が必要なセルとその走行方法がわかります。また、--out を指定すると、チェックサムを修正したチューニング済み BIN を取得できます。このファイルは、同じ 2 つのファイルを指定したときに TUNER の DOWNLOAD TUNED が出力するものと、バイト単位で完全に一致します。

MSS54HP の bin には何が入っていますか？チェックサムは正しいですか？どのパッチが適用されていますか？

npx matrix-tsunagi mapping bin my.bin

ログの大部分が除外されたのはなぜですか？

npx matrix-tsunagi mapping log drive.csv --bin my.bin

各サンプルが除外された理由（エンジンの冷間状態、過渡状態、全負荷、オーバーランなど）と、次の走行で変更すべき点を確認できます。

走行データはどの rf_korr テーブルを裏付けていますか？ (実験的)

npx matrix-tsunagi mapping rfkorr --bin my.bin --log drive.csv

排気温度の密度補正（KF_RF_KORR_DRREL）をセルごとに確認でき、それぞれの根拠もわかります。

SMG II のシフトポイントはどこですか？この SMG イメージの内容は何ですか？

npx matrix-tsunagi mapping smg2 image smg.bin
npx matrix-tsunagi mapping smg2 read smg.bin --xdf Siemens_SMG_II_510_512K.xdf --item "A1 Speed"

smg2 image はほかに何も必要ありません。イメージが 24 KiB のキャリブレーションウィンドウか、512 KiB のフルフラッシュかを判定し、ZB 番号と CRC チェックサムが有効かどうかを示します。 smg2 read は、MS4X の定義ファイルに記載されたすべての項目を、E46M3SMG2 /// MAPPING による修正も反映してデコードします。ギアやプログラムごとのシフト速度しきい値、ギア比、クラッチとローンチの設定が含まれます。 定義ファイル（Siemens_SMG_II_510_24K.xdf または _512K.xdf）は MS4X Dev Team のもので、ここには同梱されていないため、ご自身で用意して渡してください。 E46M3SMG2 /// MAPPING の WORKS ビルドには、この定義ファイルが含まれています。

2 つの SMG II キャリブレーション間で何が変わりましたか？

npx matrix-tsunagi mapping smg2 compare before.bin after.bin --xdf Siemens_SMG_II_510_512K.xdf

DME バックアップにはどのブートローダーが含まれていますか？CSL 変換のどの部分が残っていますか？

npx matrix-tsunagi migration boot backup dme-backup.bin

BOOT の 1 MiB フルバックアップから、各プロセッサーに標準 M3 または CSL のブートローダーがあるか、各ブートローダーの CRC が有効か、プログラム番号、残っているステージを確認できます。 migration boot compare a.bin b.bin では、2 つのバックアップで異なる箇所を確認できます。

このクラスター EEPROM に記録されている走行距離はどれくらいですか？このダンプは実際に読み取られたものですか？

npx matrix-tsunagi migration m35080 read eeprom.bin

1 KB の M35080 バックアップから、実チップの読み取りデータかどうか（バスが断線または短絡している場合は、同じバイトが繰り返されます）、セキュアカウンターの走行距離、レイアウトとチェックサム、VIN のコピーが一致しているかどうかを確認できます。 migration m35080 compare a.bin b.bin では、2 つのダンプ間で変更された領域を確認できます。

MIGRATION は読み取りのみを行います。イメージを変更する機能はこのパッケージに含まれておらず、npm run verify でバンドルにそれらが含まれていないことを確認します。 VIN と DME の識別情報レコードは出力されません。コマンドの出力はアシスタントとの会話に含まれるためです。

どんなことができますか？

npx matrix-tsunagi describe

AI アシスタント向け

• npx matrix-tsunagi describe を一度実行してください。各コマンドは標準出力に JSON を出力し、エラーは終了コード 1 とともに標準エラー出力に JSON として出力されます。
• 各結果には、伝えるべき内容を示す summary、数値を含む result、計算に使用したツールとバージョン、および計算が実験的かどうかを示す source があります。
• apply が表示されるのは、所有者が結果を車に書き込む必要がある場合のみです。アプリ名、アプリが無料か WORKS か、適用方法が記載されています。apply.how と source.note は英語と日本語で記載されています。
• まだファイルがない場合は、--sample を追加すると練習用の BIN とドライブデータを使ってコマンドの動作を確認できます。
• データが外部に送信されることはありません。指定したパスからファイルを読み込みます。

Claude プラグイン

plugin/ は Claude プラグインで、2 つの部分を 1 つのパッケージにまとめています。公開部分は、このコンピューター（Claude Code）で MAPPING サーバーと MIGRATION サーバーを実行し、matrix-public Skill を使用します。WORKS 部分は TUNER WORKS コネクター（bridge/、m3 でサインイン）と tuner-drive Skill で構成されており、車のログを記録しながら、スマートフォンからも所有者が TUNER WORKS とやり取りできます。所有者が許可すると、キャリブレーション変更の準備、セッションの保存、所有者のクラウドとの同期をそれぞれ実行できます。車への接続と書き込みは、画面上で所有者自身が行います。Skills は入口にすぎません。手順はサーバー（about_matrix の howToUse、tuner_guide）から提供されるため、新しいプラグインを使わなくてもツールとともに更新されます。また、プラグインは npm 上の最新の matrix-tsunagi を実行します。インストール方法は INSTALL.md をご覧ください。

MCP

カテゴリごとに 1 つずつ、2 つのサーバーがあります。

MAPPING サーバーは、同じ計算機能をツールとして公開します。TUNER 用は read_bin、read_log、propose_ve、propose_rfkorr です。SMG2 用は smg2_image、smg2_read、smg2_compare です。さらに about_matrix があります。stdio 経由でローカルに実行されます。

MIGRATION サーバー（npx -y matrix-tsunagi mcp migration、または npx -y matrix-tsunagi-migration）は、boot_backup、boot_compare、m35080_read、m35080_compare、about_matrix を公開します。これらはすべて読み取り専用です。

Claude Code：

claude mcp add matrix-tsunagi-mapping -- npx -y matrix-tsunagi mcp mapping

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "matrix-tsunagi-mapping": {
      "command": "npx",
      "args": ["-y", "matrix-tsunagi", "mcp", "mapping"]
    }
  }
}

Windows で npx が見つからない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "matrix-tsunagi", "mcp", "mapping"] を使用してください。

リモート（ChatGPT）

npm を実行できないアシスタント向けに、MAPPING サーバーもリモートで実行できます。

https://matrix-mcp.tsunagi.app/mcp/mapping

ChatGPT で開発者モードを有効にし（設定 → セキュリティとログイン）、その URL を使ってプラグインとして追加してください。チャットに BIN とログを添付して、質問してください。 ファイルは ChatGPT のファイルパラメーターとしてサーバーに届きます。ChatGPT が発行した一時リンクからファイルをダウンロードし、メモリ上で計算して結果を返し、データは保持しません。 返されるのは値のみです。そのため、チューニング済み BIN は無料の TUNER で作成してください。また、MIGRATION のダンプには VIN と走行距離が含まれ、ユーザーのマシンから外に出ないようにしているため、対応するのは MAPPING のみです。 ファイルの取り扱いについては、プライバシーポリシーのセクション 11 をご覧ください。

ライブラリ

import { mapping } from 'matrix-tsunagi';
import fs from 'node:fs';

const ve = mapping.proposeVe({
  bin: new Uint8Array(fs.readFileSync('my.bin')),
  csv: fs.readFileSync('drive.csv', 'utf8'),
});
console.log(ve.summary);
fs.writeFileSync('tuned.bin', ve.tunedBin);

mapping.readBin、mapping.readLog、mapping.proposeRfKorr は同じ入力を受け取ります。SMG2 には mapping.smg2Image({ image })、mapping.smg2Read({ image, xdf, item })、mapping.smg2Compare({ image, other, xdf }) があり、xdf は定義のテキストです。

車に結果を書き込む

計算は無料です。結果を車に書き込む作業は各アプリで行います。

結果	車への書き込みを行うもの
VE マップ（ve）	MSS54HP CSL CONVERT /// TUNER で行います。無料で、ブラウザー上から K+DCAN ケーブル経由で書き込めます。--out でも同じファイルを保存できます。
rf_korr テーブル（rfkorr）	ファイルの作成と書き込みを行う TUNER の WORKS ビルドです。このパッケージが返すのは値のみです。
DME バックアップ（migration boot）	OBD 経由で DME をバックアップし、検証して、CSL への変換を計画する作業は、MSS54HP CSL CONVERT /// BOOT の WORKS ビルドで行います。
クラスター EEPROM（migration m35080）	M35080 の読み取り、バックアップ、修復、および車の正確な走行距離とコーディングの交換用クラスターへの引き継ぎは、E46 M35080 /// MIGRATION の WORKS ビルドで行います。カウンターは増加する一方なので、このツールは正確な値を引き継ぎます。
SMG II キャリブレーション（smg2）	車からの読み取り、編集、エクスポートは、MS4X 定義を備えた E46M3SMG2 /// MAPPING の WORKS ビルドで行います。このパッケージで行うのは読み取り、デコード、比較のみです。

WORKS ビルドは、MESH で MILE を購入した方、および TSUNAGI が作業した車のオーナー向けに、リクエストに応じて提供されます。 対象は、TUNER の実験的機能、E46M3SMG2 /// MAPPING、E46M3 /// MONITORING、MSS54HP CSL CONVERT /// BOOT、E46 M35080 /// MIGRATION です。 MILE は一度限りの支払いで、サブスクリプションや更新はありません。 購入者は MILE を MILESTONE に割り当て、希望する使途を示すことができます。これは記録された希望であり、リリースや日程を約束するものではありません。

入力

• BIN：65,536 バイトの MSS54HP キャリブレーション部分データ（「0401 partial BIN」）。TUNER が読み書きするファイルです。
• ログ：ヘッダー行を含む CSV で、Testo の MSS54 エクスポート、または TUNER がエクスポートした CSV のいずれかです。列は Testo と TUNER の表記に基づいて照合されます。必須列がない場合、使用可能なヘッダー名をエラーに表示します。
• SMG II イメージ：24,576 バイトのキャリブレーションウィンドウ、または 524,288 バイトの SMG II 510 のフルフラッシュです。E46M3SMG2 /// MAPPING が読み取り、エクスポートする形式です。
• DME バックアップ：1,048,576 バイトの MSS54HP フルイメージ（マスターおよびスレーブ）。BOOT がバックアップする形式です。
• M35080 イメージ：1,024 バイトのクラスター EEPROM。E46 M35080 /// MIGRATION がバックアップする形式です。
• XDF：MS4X Dev Team の TunerPro 定義ファイルです。ウィンドウには Siemens_SMG_II_510_24K.xdf、フル読み取りには _512K.xdf を使用します。オフセットを誤って読み取ることがないよう、もう一方の形式は受け付けません。

数値の出所

このパッケージは、どの機能も再実装していません。各ツールの公開リポジトリにあるコードを、サブモジュールで固定されたコミットから取り込んでいます。 mushitaro/mss54hp-csl-convert-tuner（vendor/tuner）と mushitaro/e46m3smg2-mapping（vendor/smg2）、 mushitaro/mss54hp-csl-convert-boot（vendor/boot）と mushitaro/e46-m35080-migration（vendor/m35080）です。 すべての結果の source には、ツール名、バージョン、コミットが記載されます。

npm run verify は、同じコミットから取得した TUNER 独自の DOWNLOAD TUNED で測定した SHA-256 と、チューニング済み BIN を照合します。 SMG2 のデコードは、アプリ独自の loadDefinition と項目ごとに照合します。 どちらにも、比較に失敗することを示すコントロールがあります。 SMG2 のチェックには MS4X 定義と車のイメージが必要ですが、これらは公開されていません。これらがない場合は SKIP と報告され、合格を意味するものではありません。

git clone --recursive https://github.com/mushitaro/matrix-tsunagi
cd matrix-tsunagi && npm install && npm run verify

日本語

TSUNAGI///M（BMW E46 M3 のツール群）の計算を、ライブラリ・コマンド・MCP で使えるようにしたパッケージです。 TSUNAGI///Matrix は、M のツールを AI アシスタントにつなぐ門です。自分では計算せず、各ツールのコードをカテゴリごとに束ねて渡します。 MSS54HP の BIN と走行ログ（Testo の CSV）から、VE マップの補正案、ログのどこが使われなかったかとその直し方、rf_korr の表（試験中）を出します。 SMG II の画像からは、ZB 番号とチェックサム、較正の解読（変速点など）、2 本の比較を出します。解読には、お手持ちの MS4X の XDF が要ります。 MIGRATION は、DME のバックアップ（ブートローダの種類と CRC、CSL 化の残り）と、メーターの M35080 のバックアップ（走行距離、チェックサム、VIN の一致）を読むだけで、書き換えはしません。VIN と DME の識別情報は出力しません。 お手元の PC で計算し、どこにも送信しません。ファイルがなくても --sample で試せます。

VE マップは MSS54HP CSL CONVERT /// TUNER（無料・ブラウザで動作）で車に書き込めます。 rf_korr などの試験中の機能は、TUNER のワークス版でファイルにして書き込みます。 SMG II の車からの読み取り・編集・書き出しは、E46M3SMG2 /// MAPPING のワークス版で行えます。ワークス版には XDF も入っています。 ワークス版は、MESH で MILE をご購入いただいた方と、お申し出いただいた施工オーナーさんがお使いいただけます。 MILE は一回限りのお支払いで、自動更新はありません。 MILESTONE への割り当ては使い道のご希望の表示で、公開や時期を約束するものではありません。

License

MIT, © TSUNAGI. See THIRD-PARTY-NOTICES.md for what is bundled, including the practice BIN.