==> deutsche Anleitung ist weiter unten
************************************************************************
AvigoDump.EXE Version 1.0


Author   : Hubert Baumgarten 
email    : hubert.baumgarten@germanynet.de.
HomePage : home.germany.net/101/265175

************************************************************************

Installation with Setup
-----------------------

Please unpack AvigoDumpSetup.zip into a temp-directory.
Start Setup.exe.
Follow the install-instructions.
Start the program by double-clicking AvigoDump.EXE.

Short-Installation 
------------------

This is a short way to install, when you have VB5-DLLs already.

Please unpack AvigoDump.zip into new directory.
Start the program by double-clicking AvigoDump.EXE.
When you have problems with missing DLL's, please use 
AvigoDumpSetup.zip.

Functions 
---------

Double-click on datafield 'File1' or 'File2' opens a filewindow.

All buttons except 'Compare' reads 'File1' only. 
Only 'Compare' read both: 'File1' and 'File2'. 

'Read' reads the in 'Bytes' entered number of bytes, starting at in 
'Startadress' given location with in 'LineSize' entered LineSize.

'AnalyseET' reads 32K at in 'Startadress' given location and interprets it  
as tabledata (Avsim.sav).

'AnalyseTT' reads Bank $86 and interprets it as table of tables (RAMBank6! in Avsim.sav).

'No lines with all $00', inhibits the display of lines, which contains only '$00'. 
Same for 'No Lines with only $FF' for lines with $FF.

'->' Computes the 'Bank' and the 'Offset in Bank' into 'StartAddress'.

Double-click in DisplayWindow moves then address from the line into 'Bank',
'Offset in Bank' and 'StartAddress'.

'Disassemble' disassembles the in 'Bytes' given number of bytes.
The number is limited on 1024 Bytes (runningtime!).

'Offset is + $4000' means that to Offset are added $4000. 
This is useful while reading *.app files, which are loaded at $4000.

In Avsim.sav-files are stored 128 ROM-Banks. Behind are the Ram-Banks 0 
to 7. Rambank0 is indicated as RAM-Bank $80. This works until Rambank7 
indicated as Bank $87.

'Compare' compares the 'Bank' in both files. 
The line with address is the line from file1.
Behind, without address is the nomatching line from file2.

Don't care how many bytes are different; a line with 16 bytes is displayed.

'Store' stores and 'Print' prints the contains then current display window, 
like it is.

All number-entries in inputfields can be used as hex, with leading '$' 
or decimal without leading '$'.


Extend Knowledge-database
-------------------------
There are 3 Text file :

	Z80.TXT 	Base for Processor-Instruction-Set
	Avigo.TXT 	Base for known Avigo-Calls.
	AvigoBank.TXT   Base for known Avigo-Banked-Calls 

A Avigo-Bank-Call ist only detected, when the next instruction a
Call 3003 is.

You can edit Avigo.TXT and AvigoBank.TXT. So you can extend it.
When you have useful new entries, please mail me a copy.


Instructions 
------------

Disassembling a *.app-File : 

1. Double-click datafield 'File1'
2. Choose App-File
3. Mark 'offset is +$4000'
4. Enter: 'Bank' = 0; $0 in 'Offset in Bank' 
5. Compute absolute Byte-Position by clicking '->'
6. Click 'Disassemble' 
7. Scroll forward: double-click on last line, and click 'disassemble' again.


Disassembling an App in Avsim.sav-File 

1. Double-click datafield 'File1'
2. Choose Avsim.sav-file
3. Unmark 'offset is +$4000'
4. Click 'AnalyseTT'
5. Read Bank in paragraph 'Application Index'. It's the first column (hex!)
6. Enter bank in 'Bank' ($Hex); $0 in 'Offset in Bank' 
7. Compute absolute Byte-Position by clicking '->'
8. Click 'Disassemble' 
9. Scroll forward: double-click on last line, and click 'disassemble' again.

Searching a word in current file 

1. Enter word in 'Search String ($.. = Hexstring)'.
2. Click 'Search' 

Search a Z80-instruction or a hex-string in current file: 
1. Hex-string know hex-string i.e. CDDB30 for Call 30BD.
2. Enter hex-string into 'Search String ($.. = Hexstring)'; 
   enter a leading $ i.e. $CDDB30
3. Click 'Search' 

Analyse Data-table-bank in Avsim.sav  
1. Double-click datafield 'File1'
2. Choose Avsim.sav-file
3. Unmark 'offset is +$4000'
4. Read Bank in paragraph 'Bank Index' Bank. It's the entry-number '#$..' (Hex!).
   Choose a used bank. It means choose an entry, which its data are not 
   '00 00 00 40 00 00'; otherwise it's stupid.
5. Enter bank in 'Bank' ($Hex); $0 in 'Offset in Bank'
6. Compute absolute Byte-Position by clicking '->'
7. Click 'AnalyseET' 

Compare Bank of 2 files.
1. Double-click datafield 'File1'
2. Choose File1
3. Double-click datafield 'File2'
4. Choose File2
5. Enter bank in 'Bank' 
6. Click 'Compare'

More information
----------------
Please read the appending document Datatabs.Doc.




Have fun


Hubert Baumgarten

**************************************************************************
AvigoDump.EXE Version 1.0


Autor    : Hubert Baumgarten 
email    : hubert.baumgarten@germanynet.de.
HomePage : home.germany.net/101/265175

************************************************************************

Installation mit Setup
------------

Bitte entpacken Sie das Zip-File AvigoDumpSetup.ZIP in ein 
temp-Directory.
Starten Sie Setup.exe.
Folgen Sie der Installationsanweisung.

Starten Sie das Programm durch doppelklick auf AvigoDump.EXE.

Funktionen 
----------

Doppelklick auf das Eingabefeld 'File1' oder 'File2' ffnet 
ein Dateisuchfenster.

Alle Befehle auer 'Compare' lesen nur aus 'File1'. 
Nur 'Compare' liest beide : 'File1' und 'File2'. 

'Read' liest die in 'Bytes' angegebene Anzahl Bytes ab der in angegebenen 
'Startadress' angegebenen Adresse mit in 'LineSize' angegebenen 
Zeilenbreite.

'AnalyseET' liest 32K ab der angegebenen Adresse und interpretiert 
sie als Tabellendaten (Avsim.sav).

'AnalyseTT' liest die Bank $86 und interpretiert sie als TabellenTabelle.
(RAMBank6! in Avsim.sav).

'No lines with all $00', unterdrckt die Ausgabe einer Zeile wenn nur 
$00 in der Zeile vorkommt. Entsprechendes gilt fr 'No Lines with only 
$FF' fr $FF-Zeilen. 

'->' Rechnet die 'Bank' und den 'Offset in Bank' in um und stellt sie 
rechtsdaneben in 'StartAddress'.

Doppelklick im Anzeige-Fenster stellt die Adresse der Zeile in
das Feld 'Bank' 'Offset in Bank' und 'StartAddress'.

'Diassemble' diassembliert die in 'Bytes' angegebene Anzahl Bytes.
Die Anzahl ist auf 1024 Bytes begrenzt (Laufzeit !).

'Offset is + $4000' bedeutet da zum Offset noch $4000 dazu gerechnet werden. 
Das ist sinnvoll bei *.app files, die ja ab $4000 geladen werden.

In Avsim.SAV-files sind 128 Rom-Banken gespeihert. Dahinter kommen
die Ram-Banken 0 bis 7. Es wird also die Rambank0 als Bank $80 ausgewiesen! Das geht bis 
Rambank7 die als Bank $87 ausgewiesen wird.

'Compare' vergleicht die angegebene Bank in beiden Files. 
Die Zeile mit der Adresse ist der Inhalt aus File1
Darunter ohne Adressangabe der abweichende Inhalt von File2.
Auch wenn nur 1 Zeichen abweichend ist, wird eine 16 Stellen Breite 
Zeile ausgegeben.

'Store' Speichert und 'Print' druckt den Inhalt des Anzeigefensters, 
so wie es ist.

Alle Zahlenangaben $ am Anfang werden als Hex interpretiert, sonst dezimal.

Erweitern der Wissensdatenbasis
-------------------------------
Es gibt 3 Textdateien :

	Z80.TXT 	Basis des Prozessor-Instruction-Sets
	Avigo.TXT 	Basis mit bekannen Avigo-Calls.
	AvigoBank.TXT   Basis mit bekannten Avigo-Banked-Calls 

Ein Avigo-Bank-Call wird nur bersetzt, wenn die folgede Instruction ein
Call 3003 ist.

Sie knnen die Dateien Avigo.TXT und AvigoBank.TXT editieren und 
dadurch erweitern. Wenn Sie neue ntzliche Eintrge gemacht haben, 
schicken Sie mir bitte eine Kopie per Mail.

Anleitung 
---------

Diassemblieren eines *.app-Files : 

1. doppelclick auf Eingabefeld 'File1'
2. App-File auswhlen
3. 'offset is +$4000' markieren
4. Eingabe : 'Bank' = 0; 'Offset in Bank' = $4000
5. Umrechnen in absolute Byte-Position durch anklicken '->'
6. 'Disassemble' anklicken 
7. Vorblttern : doppelklick auf letzte Zeile, dann erneut 'disassemble'


Diassemblieren einer App im Avsim.SAV-File 

1. doppelclick auf Eingabefeld 'File1'
2. Avsim.sav File auswhlen
3. 'offset is +$4000' ausschalten
4. 'AnalyseTT' ancklicken
5. Im Block 'Application Index' Bank ablesen. Das ist der 1. Tabelleneintrag (Hex!)
6. Bank in 'Bank' ($Hex) eintragen; 'Offset in Bank' = $0
7. Umrechnen in absolute Byte-Position durch anklicken '->'
8. 'Disassemble' anclicken 
9. Vorblttern : doppelklick auf letzte Zeile, dann erneut 'Disassemble'

Suchen eines Wortes in akuellen File

1. Wort in 'Search String ($.. = Hexstring)' eingeben.
2. 'Search' anklicken

Suchen eines Befehles oder eines Hex-Strings im aktuellen File :
1. Hex-String ermitteln z.B. CDDB30 fr Call 30BD.
2. Hex-String im Feld 'Search String ($.. = Hexstring)' eingeben; 
   $ voranstellen z.B. $CDDB30
3. 'Search' anklicken

Daten-Tabellen-Bank in Avsim.sav analysieren.
1. doppelclick auf Eingabefeld 'File1'
2. Avsim.sav File auswhlen
3. 'offset is +$4000' ausschalten
4. Im Block 'Bank Index' Bank ablesen. Das ist die Eintrags-Nummer '#$..' (Hex!)
   Whlen Sie eine benutze Bank aus. D.h. der Dateneintrag ist ungleich 
   '00 00 00 40 00 00'; sonst wird es langweilig.
5. Bank in 'Bank' ($Hex) eintragen; 'Offset in Bank' = $0
6. Umrechnen in absolute Byte-Position durch anklicken '->'
7. 'AnalyseET' anclicken 

Bank aus 2 Files vergleichen
1. doppelclick auf Eingabefeld 'File1'
2. 1. File auswhlen
3. doppelclick auf Eingabefeld 'File2'
4. 2. File auswhlen
5. Zu vergleichende Bank in 'Bank' eintragen
6. 'Compare' anklicken.

Weitere Informationen
---------------------
Bitte lesen Sie auch die beigefgte Dokumentation Datatabs.Doc.




Viel Spa

Hubert Baumgarten


