adsp219x-re/docs/PRACTICAL_EXAMPLE.md

Praktisches Analyse-Beispiel: ADSP-219x Boot-Sequenz

In diesem Beispiel analysieren wir einen (generierten) 3-Byte-Packed Dump. Wir gehen die Instruktionen nacheinander durch, wie du es in iaito oder mit unserem Disassembler machen würdest.

Die Rohdaten (Hex-Dump)

Offset 0x00: 00 00 00
Offset 0x03: 40 12 30
Offset 0x06: 50 20 00
Offset 0x09: 50 00 14
Offset 0x0C: DA 00 00
Offset 0x0F: 18 10 0F

Schritt-für-Schritt Disassembly

1. Adresse 0x0000: 0x000000

• Decodierung: Type 30 (NOP).
• Bedeutung: Keine Operation. Oft am Reset-Vektor zu sehen, falls der eigentliche Einsprungpunkt erst bei 0x0004 liegt (je nach Core-Revision).

2. Adresse 0x0001: 0x401230

• Decodierung: Type 6 (Immediate Register Load). 0x0123 ist der Wert (4 Bits geshiftet).
• Assembly: AX0 = 0x1230
• Bedeutung: Das Arithmetische X-Register 0 wird mit einer Konstanten geladen. Das ist der typische Beginn einer Berechnung.

3. Adresse 0x0002: 0x502000

• Decodierung: Type 7 (Immediate Address Register Load).
• Assembly: I0 = 0x2000
• Bedeutung: Ein Index-Register des DAG1 wird mit einer Startadresse geladen. Hier fängt wahrscheinlich ein Daten-Buffer im DM (Data Memory) an.

4. Adresse 0x0003: 0x500014

• Decodierung: Type 7.
• Assembly: M1 = 1
• Bedeutung: Das Modifier-Register wird auf 1 gesetzt. Das bedeutet, bei jedem Zugriff auf den Buffers springt der interne Pointer genau 1 Word weiter.

5. Adresse 0x0004: 0xDA0000 (Multifunktions-Instruction)

• Decodierung: Type 1. Opcode beginnt mit 11 (Binar: 11 01 101...).
• Bedeutung: Hier passiert die Magie. AMF = 13 (Add), DMI=0, DMM=0.
• Assembly: AR = AX0 + AY0, AX0 = DM(I0 += M0), AY0 = PM(I4 += M4)
• Schlussfolgerung: Das ist eine DSP-Operation. Er berechnet die Summe zweier Werte, lädt gleichzeitig den nächsten Wert aus dem Datenspeicher (DM) und gleichzeitig den übernächsten Filter-Koeffizienten aus dem Programmspeicher (PM). Wenn du das siehst, hast du die Signalverarbeitung gefunden!

6. Adresse 0x0005: 0x18100F

• Decodierung: Type 10 (Direct Jump).
• Assembly: JUMP 0x0100
• Bedeutung: Ein Sprung zu einer anderen Code-Region (wahrscheinlich das Hauptprogramm oder eine Header-Überspringen).

Worauf du achten musst:

1. I/M Paare: Wenn du siehst, dass I2 geladen wird, suche nach dem zugehörigen M2. Ohne Mn kann der DAG nicht sinnvoll inkrementieren.
2. Register-Gruppen: Der ADSP-2191 hat 4 Gruppen (REG0-3). AX0 ist REG0, I0 ist REG1. Wenn du Register-zu-Register Kopien siehst (z.B. REG(0,4) = REG(1,0)), achte auf die Gruppennummern im Opcode.
3. B-Bit (Delayed Branches): Bei Sprüngen (JUMP, CALL) gibt es oft ein B-Bit. Wenn es gesetzt ist (JUMP (DB)), wird der Befehl nach dem Sprung noch ausgeführt, bevor er springt (Pipelining!). Das ist eine häufige Falle bei Reverse-Engineering.

---

Nächster Schritt: Probiere den neuen Disassembler mit dem generierten base_test.bin aus: python3 disassembler/adsp219x_disasm.py testrom/test_roms/base_test.bin