Ek — Dosya formatları

İçe aktarılan formatlar

Format	Uzantı	Notlar
A2L / DAMOS	.a2l .dam .damos	ASAM MCD-2 MC; en güvenilir yol
Intel HEX	.hex	Kayıt adresleri çözülür, boşluklar korunur
Motorola S-record	.s19 .s28 .s37	S0–S9 kayıtları
Ham ROM	.bin .rom .ori .mpc	Harita sınırları yazılı değildir
WinOLS	.ols	ROM + harita + eksen + meta veri içerir
KP paket	.kp	ROM içermez; açık proje gerekir
TunerPro	.xdf	Tanım dosyası
VAG	.frf .sgo .odx .zip	Şifreli içerik için AES anahtar dosyası gerekir
CSV / JSON liste	.csv .json	Harita adres listeleri
Harita paketi	.mtrpack	MRC biçimi
Yama	.mtrpatch	MRC biçimi
Datalog	.csv	Kanal listesi ve zaman serisi

Dışa aktarılan formatlar

Format	Uzantı	Notlar
Proje	.mtrp	ROM + harita + geçmiş + meta veri (kapsayıcı)
Ham ROM	.bin .rom	Boyut ve bayt sırası korunur
WinOLS	.ols	Proje dışa aktarımı
TunerPro	.xdf	Tanım dışa aktarımı
Harita paketi	.mtrpack / .csv	Seçili haritalar
Harita listesi	.csv .json	Ad, adres, boyut
Ayar raporu	.html	Eski/yeni değer karşılaştırması
Tema	.mtrtheme	Palet tanımı

Proje kapsayıcı biçimi (.mtrp)

.mtrp ikili bir kapsayıcıdır:

• Başlık — sihir (MTRP), biçim sürümü, toplam boyut, TOC ofseti.
• TOC — her bloğun sihir, ofset ve boyutu.
• Bloklar — ROM verisi, harita tanımları, meta veri, geçmiş, stiller.
• Gövde sağlaması — bozulmayı algılamak için.

Bloklar bağımsız yazılıp okunur; tek bir bloğu okumak için tüm dosyayı belleğe almak gerekmez.

Yama biçimi (.mtrpatch)

JSON belgesidir:

{
  "format": "mtrpatch",
  "label": "Stage 1 — düşük RPM yakıt haritaları",
  "maps": [
    {
      "name": "KRKTE_FIX",
      "address": "0x0012A340",
      "ref":  "0x0B0C0D0E",
      "new":  "0x0B0C1012"
    }
  ],
  "raw": []
}

• ref — değişiklikten önceki baytlar; doğrulama için.
• new — yazılacak baytlar.
• raw — harita dışı ham bayt yamaları (aynı yazılım sürümü için geçerli).

Harita paketi biçimi (.mtrpack)

Haritaları ad + adres + ölçekleme + değerler olarak taşır. Uygulama hedef ROM'da üç kademeli eşleştirme yapar: açık adres, ad, paketteki adres.

A2L'den alınan ölçekleme

COMPU_METHOD içindeki COEFFS_LINEAR ifadesi f(x) = a·x + b biçimindedir. Uygulama bu katsayıları doğrudan haritanın çarpan/sapma değerlerine dönüştürür. COMPU_TAB_REF ile tanımlanan sekmeli (tabular) dönüşümler de desteklenir.

Bayt sırası

Bazı A2L dosyalarında BYTE_ORDER MSB_LAST bulunur; hücre baytları ters sırada yazılmış demektir. Uygulama bunu özellik olarak okur, ancak Görünüm ▸ Bayt Sırası ile elle de değiştirebilirsiniz. Yanlış sırada okunan harita "anlamsız" değerler üretir ve genellikle fark edilmez.