Allgemeine Anleitungen Emulie

Emulia – Anleitung​

Beispiel für eine Environment-Datei und praktische Nutzung​

---

1. Ziel verstehen​

Emulia emuliert die Adam2/Eva-Bootumgebung von AVM-Geräten.
Damit das funktioniert, benötigt das Programm eine sogenannte Environment-Datei.

Diese Datei simuliert die Umgebungsvariablen eines echten Geräts – also genau das, was normalerweise im Bootloader gespeichert ist.

Ohne eine passende Environment-Datei ist die Emulation unzuverlässig oder bricht ab.

---

2. Aufbau einer Environment-Datei​

Die Dateien liegen im Ordner:

Conf/np/
Eine typische Datei ist eine einfache Textdatei, z. B.:

Conf/np/Fritz7490.txt

Beispielinhalt​

HWRevision 184
ProductID Fritz_Box_7490
SerialNumber 1234567890
annex B
autoload yes
bootloaderVersion 1.1234
firmware_info 113.07.29
mtd0 0x90000000,0x90010000
mtd1 0x90010000,0x90400000
my_ipaddress 192.168.178.1

---

3. Erklärung der wichtigsten Parameter​

HWRevision​

Identifiziert die Hardware-Revision des Geräts.
Muss exakt zum Gerät passen, sonst verweigert die Firmware die Zusammenarbeit.

ProductID​

Interne Modellkennung der FRITZ!Box.

SerialNumber​

Seriennummer des Geräts.
Für viele Tests ist ein Dummywert ausreichend.

firmware_info​

Gibt die aktuell erwartete Firmwareversion an.

mtd-Einträge​

Definieren Speicherbereiche im Flash.
Falsche Werte führen zu Fehlern bei Firmware-Transfers.

my_ipaddress​

IP-Adresse, unter der sich das emulierte Gerät meldet.

---

4. Eigene Environment-Daten gewinnen​

Schritt 1: Verbindung per FTP zum Bootloader​

Gerät neu starten und während der ersten Sekunden verbinden:

ftp 192.168.178.1
Login meist:

adam2 adam2

Schritt 2: Variablen anzeigen​

quote GETENV
oder einzelne Variable:

quote GETENV HWRevision

Schritt 3: Werte kopieren​

Alle ausgegebenen Variablen sauber in eine Textdatei übertragen.

Wichtig:

• Keine zusätzlichen Leerzeichen
• Keine Anführungszeichen
• Jede Variable in eine eigene Zeile

---

5. Datei korrekt speichern​

Speichern als:

Conf/np/DeinModell.txt
Beispiel:

Conf/np/Fritz6690.txt
Dateiendung muss .txt sein.

---

6. Emulia mit eigener Datei starten​

Linux​

sudo ./go.sh Fritz6690

Windows​

go.bat Fritz6690
Wichtig:
Nur den Dateinamen ohne .txt angeben.

---

7. Ergebnis prüfen​

Nach dem Start entstehen folgende Ordner:

Logs/ Bins/

Logs​

Enthält die komplette Emulationsausgabe.
Hier sieht man, ob Variablen fehlen oder falsch sind.

Bins​

Enthält übertragene Binärdaten (z. B. Firmware-Blöcke).

---

8. Typische Fehlerquellen​

Falsche HWRevision​

→ Firmware verweigert Transfer

Fehlende mtd-Einträge​

→ Speicherzuweisung bricht ab

Keine Root-Rechte​

→ Port 21 kann nicht geöffnet werden

Generische Datei verwendet​

→ Meist nicht kompatibel mit echter Firmware

---

9. Best Practice​

1. Immer ein echtes Gerät auslesen
2. Environment vollständig übernehmen
3. Testlauf durchführen
4. Logs analysieren
5. Schrittweise anpassen

---

10. Optional: Minimale Test-Environment​

Für reine Analysezwecke genügt oft eine reduzierte Datei:

HWRevision 184 ProductID Fritz_Box_7490
autoload yes
my_ipaddress 192.168.178.1
Für Firmware-Uploads reicht das meist nicht, aber zum Starten der Emulation oft schon.

Quelle:

Viele Spaß beim Testen.
Vielen Dank an den Autor

ps. Fehler vorbehalten