>Wongck at 14:22, 13 October 2011

2011-10-13T14:22:41Z

← Older revision		Revision as of 10:22, 13 October 2011
Line 229:		Line 229:
	</pre>		</pre>
	<br><br>		<br><br>
	[[Category:~~Programming~~]]		[[Category:Atari ST software]]
			[[Category: Debugger & Dis-assembler ]]

>Zorro 2 at 10:55, 31 October 2006

2006-10-31T10:55:26Z

← Older revision		Revision as of 06:55, 31 October 2006
Line 228:		Line 228:
	P.S. Doc became a little bigger then expected (dumb grin ...).		P.S. Doc became a little bigger then expected (dumb grin ...).
	</pre>		</pre>
			<br><br>

	[[Category:Programming]]		[[Category:Programming]]

>Zorro 2 at 15:53, 23 October 2006

2006-10-23T15:53:34Z

New page

<pre>
Disassembler version 2.21
Main Super Def Coding: AWA from AXE,
Additional Def Coding: EZ from AXE,
Doc by Brainz of Armalyte,
Some Ideas by Xelon of AXE,
Some Small Ideas by Brainz of Armalyte.
And Of Course We Could Continue For
A Long, Long Time, But I Think
We'd Better Stop Now

*** Standard Disclaimer ***

If this program ruins your life, then you can't blame me, nor can
you blame Eazy or AWA! If you still come to me, I'll pat you on
the back, say I'm very sorry and push you out of my house with
gentle force. Or: I do not accept *ANY* claims of damage this
program might do.
Send all angry people to Saddam Hoessein (or Bush, depends on your
opinion ...).

*** Usual Commercial Craptalk ***

May I congratulate you with the purchase/download/request/theft/
swap/bribe of the AXE disassembler? It is a very powerful tool for
programmers, developers, lamers, shitheads, US Gold coders (huh?),
and every other ST freak. In this small (I hope it will be small)
doc I will explain the use of this magnificent program (although
AWA is a slow coder, and a lazy one, he is a thorough coder ...),
and I'll try to solve some of your questions.

*** How To Disassemble ***

When you have executed the disassembler, you might be presented
with a fileselector. It is now your job (yes, YOUR job) to
doubleclick on the program you want to disassemble. An example:
you want to disassemble Acopy. You double click it. That's all.
End of example. Go home.
Well, anyway. The program (the disassembler, d*ckhead!) will then
acces the (hard)disk for a moment, irritate you, and finally
(sigh) present you with a dialog saying: "Relocate with address:".
If you want to do so, then type the address from where it should
be relocated. If you do not know what it does, or if you do not
need it, click the little and charming '0'. Tadaaaaaaa! The
disassembler in action (take a picture, you won't be seeing this
alot from now ...)!
Now, there are two (2) windows, one showing ASCII (the window on
the RIGHT) and one showing all the mnemonics (the one on the
LEFT). Nice, you will probably say. But what now? Ah, the
inevitable question!
Now you must enter the datasections. "WHAT!?". If this was your
first reaction, then I advise you the f**k off now, because then
you're either 1) A lamer, or 2) A US Gold coder (probably this
one). If you didn't react like that, but if there was a slight
flicker in your eyes, then I'll explain what a datasection is.
In an Assembler program, you can define 'data', like this: "DC.B
"Hello!",0", or like this: "DC.L 0". The disassembler from AWA is
as stupid as hell, and it can't sort all those things out by
itself, so you'll have to do it yourself (>very evil grin<)! In
fact, that's the only though thing about disassembling ...
Entering the datasections isn't hard, nor is it very complicated,
but FINDING them can be quite a nuisance ...
If you have found a datasection, then be sure that either window
is on the start of it, AND ACTIVE (a small 1 or 2 should be
present in the upper right corner, respectivly meaning mnemonics
and ASCII), then press: CTRL-B (this marks the start of a
datasection). Then go to the end of the datasection, and press
CTRL-K. If you want to save the block into the datasectionstable
(funny how strange words can grow with AXE products ...) press
CTRL-A. There are more ways to do so, I'll talk about them later.
Well ... When you have worked for some time, you will feel like a
second-hand banana, just like me. If this is the case (it will be,
finally), then you can save your datasectionstable, with the
option 'Save .DAW file'. The disassembler will ask you for a
comment (like: "I disassembled this file, asshole, not you!'), and
it will then save the DAW file. When you want to continue, just
load the program, then load the DAW and voila! It's there!
After some loooong and sleepless nights you WILL finally manage to
find all the datasections of the program you so much love(d), and
you would like to save the file.
Well, this is possible (ofcourse). Choose 'Make Disassembly (or
something in between (baby you can be a star (ploingploingploing
ploingploing) baby you can drive ...).), and the program will make
a nice, partially commented, disassemble.
By the way: while saving, the program will say (at a certain
point): 'The EZ Relocate Routine!'. You can click on 'Skip This Part'
most of the time. (=>AWA: I included this option for programs that do
not have a relocation-tab. For example lotsa music routines. If you
have ripped some nice coding from address $78000 and saved it to disk
with a monitor (templemon) you should use the Relocate option with
address $78000 and The EZ Relocate Routine with the address $78000,
$79000 (Length of your ripped coding is then about $1000 bytes).
My Disassembler will then scan the whole program for addresses between
$78000-$79000. If there are any addresses found they will be used as
labels. Try it out to see what happens.)
Now to the menues:

*** The Menues, And What They (Might) Do ***

The menue consists of 5 titles, which might work according to
normal GEM rules. The menues are:

Menu ATARI sign:
================
Information : Info about this program.

Menue File:
===========
Load Program : This should load a file into memory (old file is
cleared and the old DAW too ...)
Load DAW : This loads a previously saved DAW into memory.
Save DAW : This saves some hard work to disk, as a DAW file.
THIS IS THE MOST IMPORTANT OPTION! Almost.
Make Disas : This makes a neat ASM-file from your program.
Quit : This firstly tells you how to hardwarescroll, and
then shows a demo incorporating hardwarescrolling and
and 92 channel sound (stereo). In versions above
also three 320x400 sprites are moved (saying 'AXE')..
Most important option.

Menue Options:
==============
Show sections : This shows all the datasections you have defined
till then.
Add sections : Add a datasection to your collection. You must then
enter: where it starts, where it ends, and enter
it's 'value' (Long,Character, Word or Byte).
Kill section : Kill a preciously gathered section.
Clear DAW : Clear the complete DAW in memory (noooo ...).
Set Address : Jump to window address xxxx.
Switch Window : Switch window (TAB does the same thing).
Search : Search for Mnenonic, ASCII or Hex value ...
Search Next : Repeats the last search.
Set Options : This let's you define some options. Check the dialog
out and see for yourself.
Relocate : Relocate the file in memory with address xxxxx.

Menue Special:
==============
Music On/Off : This turns of the sweet melodies the soundchip
squeezes from itself. Click again to torture
again .......
Music List : The list of High Quality music, AWA so stylishly
included.
Fd Dta Pointers: This options find all the pointers in the data section.
This only works of course if there IS a data-section
(Check with [HELP]) and if there are any pointers.
Read Sectors : You cannot only read programs but also sectors for
disassembling. Though the actual program will be lost,
and also the DAW file. (So becareful!). There are two
ways to read sectors. You can use RWabs or FDC1772.
If you want to use the RWabs option you first have to
read the BPB of that drive. So if you want to read
sectors from drive A just click first on the little A
button. You can use the FDC1772 option for special
formatted disk.(=Bootable programs (Demos,Games)). Just
fill in the Start/End Track,Sector,Side. You may not
exceed the Max Sector Limit, if you do, you will be
warned and asked to read sectors again.
If sectors are read and an error occurs you MUST read
at least one sector before the program will continue.

Menue Help:
===========
Help : This helps you (a little, if you really need help,
you can contact me or EZ) (See below)
Program Info : Gives you information about the program you are
disassembling at the moment.

*** Keyboard Commands ***

Ctrl-B : Start Of Block: Begin of a data section.
Ctrl-K : End Of Block: End of a data section.
Ctrl-A : Add Block: Adds a predefined datasection to the table.
CONTROL-1/0 : Saves the position where you are in the window at the
moment.
ALT-1/0 : Retrieves the saved positions.
Clr/Home : Jump to TOP of window
Shift Clr/H : Jump To Bottom of window
Cursor keys : This scrolls the windows one line/mnemonic.
Shift+Cursor: This scrolls the windows one screen.

*** Other Things AWA Brainstormed ***

The dialogs are flying, that means, you can click on a dialog, hold
and move it somewhere else. The positions will be saved for one
session.

You can click on an address in window 1: bra R37da. If you click on
'37da' the actual window address will become $37da. (It only works
if the address really exists, so if the $37da is in the BBS section
it won't work, get it?). Ten addresses will be remembered. If you
then click on the right button and left button you jump one address
back.

Datasections are shown as black parts in the mnemonics window. So
you can easy see what is data and text. First you have to add the
datasections yourself. I have added some DAW files, just try them out.
(You should use the right program, else it will probably be one
big mess. So: acopy12p.daw is the daw file for acopy12p.prg)

*** The 'Where-Should-I-Put-This' Part ***

Not much left to say. Some useful tips, maybe? (Naah..)
With each disassembler version some DAW's are released. It
shouldn't be hard to understand that these are for your own use,
but it would be nice if you stated that you got certain routines
by a .DAW file from AWA. Also if you have got any DAW files made
yourself I (AWA) would be very happy if you send them to me. My
address:

Arjen Wagenaar or Arnhem Quick BBS
Dorpsweg 32a 085-644262
1711rj Hensbroek My Address For BBS Users:
02265-1674 2:281/801.4

Of course you can also contact EZ. He is also a coding maniac from AXE.
His address:

Erwin Zoer
Admiraliteitsweg 36
1601ed Enkhuizen

And we both live in the Netherlands...

P.S. Doc became a little bigger then expected (dumb grin ...).
</pre>

[[Category:Programming]]

Disassembler - Revision history

>Wongck at 14:22, 13 October 2011

>Zorro 2 at 10:55, 31 October 2006

>Zorro 2 at 15:53, 23 October 2006