forked from KolibriOS/kolibrios
351 lines
12 KiB
Plaintext
351 lines
12 KiB
Plaintext
|
================================================================================
|
||
|
|
dZ80 What's New?
|
||
|
|
================================================================================
|
||
|
|
|
||
|
|
********************************************************************************
|
||
|
|
|
||
|
|
E-mail: dz80@inkland.org
|
||
|
|
WWW: http://www.inkland.org
|
||
|
|
Macintosh dZ80: http://www.hinton.demon.co.uk/archive/macide.html
|
||
|
|
|
||
|
|
********************************************************************************
|
||
|
|
|
||
|
|
|
||
|
|
v2.0 - 9th March, 2002
|
||
|
|
----------------------
|
||
|
|
|
||
|
|
Additions and Changes to all versions
|
||
|
|
|
||
|
|
Please note the change of email address and URL at the top of this
|
||
|
|
document.
|
||
|
|
|
||
|
|
dZ80 now has scripting support. Writing a script for dZ80 allows you
|
||
|
|
to override, or simply modify dZ80's existing handling of opcodes.
|
||
|
|
Using a script, an opcode can be trapped before and/or after dZ80 has
|
||
|
|
processed it. This allows, for example, machine dependant "RST"
|
||
|
|
handling, which is different on every Z80-based machine. A Sinclair
|
||
|
|
ZX Spectrum script is supplied as an example. The scripting language
|
||
|
|
used is Lua 4.0, and its Web page at http://www.lua.org contains all
|
||
|
|
the tutorials and help for the language, although for simple jobs,
|
||
|
|
hacking the supplied example script will probably do :)
|
||
|
|
|
||
|
|
See Section 3.0 in the supplied dz80.txt file for the details on this
|
||
|
|
powerful new feature.
|
||
|
|
|
||
|
|
Added configuration file support (again, courtesy of Lua!). When dZ80
|
||
|
|
runs, it attempts to load and execute a dz80.ini file. The Windows GUI
|
||
|
|
version of dZ80 continues to use the Windows registry to load and save
|
||
|
|
its settings, but if there's a dz80.ini in the same folder when a
|
||
|
|
binary file is loaded, you will be prompted if you want to import the
|
||
|
|
dz80.ini settings.
|
||
|
|
|
||
|
|
A special case number prefix "{" has been added. It translates to a
|
||
|
|
"0" if the number would otherwise start with a non-numeric value:
|
||
|
|
|
||
|
|
{1234 = 1234 (starts with a numeric character)
|
||
|
|
{ffff = 0ffff (starts with a non-numeric character)
|
||
|
|
|
||
|
|
You can now control whether you have the relative displacement
|
||
|
|
comments or not in the disassembly. By default they're switched off.
|
||
|
|
|
||
|
|
Single instruction disassemblies (DISFLAG_SINGLE) are now much faster.
|
||
|
|
|
||
|
|
Numerous code clean-ups and minor optimisations.
|
||
|
|
|
||
|
|
Added Raffaele Sena's skip.c to the source code download. Skip is
|
||
|
|
now documented in dZ80.txt.
|
||
|
|
|
||
|
|
Additions and Changes to the command line versions
|
||
|
|
|
||
|
|
-j command line option to enable relative displacement comments.
|
||
|
|
|
||
|
|
-k= command line option to specify a script to load and run.
|
||
|
|
|
||
|
|
-v show version information
|
||
|
|
|
||
|
|
Special case switch - "!". If the pling is placed at the start of
|
||
|
|
the command line, it prevents dZ80 from automatically loading
|
||
|
|
dz80.ini. E.g. dz80 ! file.bin file.asm
|
||
|
|
|
||
|
|
Additions and Changes to the Windows version
|
||
|
|
|
||
|
|
A dZ80 output window has been added to the main GUI. This displays
|
||
|
|
the disassembly progress and summary as well as any error messages
|
||
|
|
that may appear.
|
||
|
|
|
||
|
|
Added support for Windows XP themes.
|
||
|
|
|
||
|
|
Improved options page.
|
||
|
|
|
||
|
|
Improved context help.
|
||
|
|
|
||
|
|
Miscellaneous minor improvements throughout.
|
||
|
|
|
||
|
|
Windows console version of dZ80 (dz80c.exe) is now included in the
|
||
|
|
package. Note that, as with all command-line versions of dZ80,
|
||
|
|
dz80c.exe will use dz80.ini to load its settings and not the
|
||
|
|
dZ80 for Windows settings which are stored in the registry.
|
||
|
|
|
||
|
|
Bug Fixes (all versions)
|
||
|
|
|
||
|
|
The (DISFLAG_SINGLE | DISFLAG_UPPER) flag combination now works
|
||
|
|
correctly when calling dZ80_Disassemble()
|
||
|
|
|
||
|
|
|
||
|
|
v1.50 - 10th February, 2001
|
||
|
|
----------------------------
|
||
|
|
|
||
|
|
Additions and Changes to all versions
|
||
|
|
|
||
|
|
dZ80's default radix can now be selected from octal, decimal or hex.
|
||
|
|
Please note that the opcode dump remains in hex regardless of the
|
||
|
|
radix chosen, because it becomes pretty ugly otherwise.
|
||
|
|
|
||
|
|
You can override dZ80's default number format prefix and suffixes.
|
||
|
|
E.g. you could change dz80's default hex format from "$1234" to
|
||
|
|
"1234h", "0x1234", etc.
|
||
|
|
|
||
|
|
The directive for define byte can be changed - default is "db"
|
||
|
|
|
||
|
|
The character to mark the start of a comment can be changed - default is a semicolon.
|
||
|
|
|
||
|
|
Skipped opcode bytes are now dumped individually as "db's"
|
||
|
|
|
||
|
|
Rewritten the references feature:
|
||
|
|
|
||
|
|
+ Every instruction is tracked, rather than just the first one
|
||
|
|
|
||
|
|
+ The Z80 instruction that generated the reference is shown in
|
||
|
|
the listing.
|
||
|
|
|
||
|
|
+ Items are sorted by address / port.
|
||
|
|
|
||
|
|
+ It's no longer necessary to specify a "max references" amount.
|
||
|
|
|
||
|
|
"org (start address)" now precedes labelled disassemblies.
|
||
|
|
|
||
|
|
Added support for the Z80-derivative used in the Gameboy handhelds.
|
||
|
|
|
||
|
|
The dZ80 source now contains a function to disassemble a single
|
||
|
|
instruction. This makes it easy to drop the dZ80 source into
|
||
|
|
your own programs, and instantly get a Z80/Z180/Z80GB disassembler.
|
||
|
|
Check out the example.c file in the dZ80 source code download
|
||
|
|
(http://www.inkland.org/dz80)
|
||
|
|
|
||
|
|
Source code change: dZ80_Disassemble() is now thread-safe.
|
||
|
|
|
||
|
|
Additions and Changes to the command line versions
|
||
|
|
|
||
|
|
dZ80.exe is now a 32-bit DOS executable (no more dz80-32.exe)
|
||
|
|
|
||
|
|
No more 16-bit DOS version of dZ80 - it's gone on a permanent
|
||
|
|
vacation :) Anyone requiring a 16-bit version of the disassembler can
|
||
|
|
download dZ80 1.31 from http://www.inkland.org/dz80
|
||
|
|
|
||
|
|
Parameters for the command line options can be given in hex or
|
||
|
|
octal by using the C style prefixes. E.g. dz80 /s=0x8000
|
||
|
|
|
||
|
|
New command line switches:
|
||
|
|
|
||
|
|
-d allows you to override dZ80's default of "db" to represent
|
||
|
|
define-byte. e.g. -d="defb"
|
||
|
|
|
||
|
|
-f allows you to override dZ80's default comment marker ("; ")
|
||
|
|
e.g. -f="# "
|
||
|
|
|
||
|
|
-i allows you to select the radix for dZ80's output.
|
||
|
|
-i=16 = select hexadecimal (default)
|
||
|
|
-i=10 = select decimal
|
||
|
|
-i=8 = select octal
|
||
|
|
|
||
|
|
-p and -y allow you to specify a prefix and suffix for all
|
||
|
|
numbers displayed by dZ80. e.g. -p="0x" -y="" or -p="" -y="h"
|
||
|
|
|
||
|
|
-z selects the cpu type.
|
||
|
|
-z=Z80 selects Z80 (default)
|
||
|
|
-z=Z180 selects the Z180
|
||
|
|
-z=Z80GB selects the Gameboy's Z80 derivative
|
||
|
|
|
||
|
|
Additions and Changes to the Windows version
|
||
|
|
|
||
|
|
The last file disassembled is automatically remembered and selected
|
||
|
|
in new sessions.
|
||
|
|
|
||
|
|
The details of the last disassembly (for the current session) are
|
||
|
|
shown.
|
||
|
|
|
||
|
|
The default button on the main dialog is now "Disassemble" (just load dZ80 and hit enter
|
||
|
|
if you're working on the same source file!)
|
||
|
|
|
||
|
|
You can enter C style hex and octal numbers in the options screen.
|
||
|
|
|
||
|
|
Bug Fixes (all versions)
|
||
|
|
|
||
|
|
Disassembly comments are no longer affected by the upper or lowercase
|
||
|
|
options.
|
||
|
|
|
||
|
|
Fixed comments which were slightly out of place if on the same line as
|
||
|
|
a label.
|
||
|
|
|
||
|
|
Fixed the 65,535 byte limit of the "skip file" bytes option, so you
|
||
|
|
can finally disassemble files > 64K!
|
||
|
|
|
||
|
|
|
||
|
|
v1.31 - 28th February, 1998. The Raffaele Sena Release ;-)
|
||
|
|
----------------------------------------------------------
|
||
|
|
|
||
|
|
Thanks to Raffaele Sena for reporting these bugs, and for providing
|
||
|
|
the fixes, too! I could get used to this :)
|
||
|
|
|
||
|
|
Additions and Changes to all versions:
|
||
|
|
|
||
|
|
Removed references to the two non-ANSI functions "strlwr" and "strupr"
|
||
|
|
from the source code.
|
||
|
|
|
||
|
|
Bug Fixes:
|
||
|
|
|
||
|
|
"add ix,ix" (or "iy") was being disassembled as "add ix,hl"
|
||
|
|
|
||
|
|
If using an Opcode Map file, dZ80 would attempt to close the file
|
||
|
|
twice, resulting in a crash when compiled for linux.
|
||
|
|
Note: this problem didn't affect the DOS and Win95 versions.
|
||
|
|
|
||
|
|
|
||
|
|
v1.30 - 29th November, 1997
|
||
|
|
---------------------------
|
||
|
|
|
||
|
|
Additions and Changes to all versions:
|
||
|
|
|
||
|
|
Added support for the Zilog Z180 processor, which fills some of the
|
||
|
|
holes in the Z80's EDxx opcode range. Thanks to Bruno G. for the
|
||
|
|
information on the Z180.
|
||
|
|
|
||
|
|
New command line swich /Z to exclude Z180 instructions from the
|
||
|
|
disassembly (they're treated as unknown Z80 ones instead).
|
||
|
|
|
||
|
|
To make listings clearer, blank lines are now automatically inserted
|
||
|
|
after a "ret", "reti", etc. This new feature can be disabled with
|
||
|
|
the /V command line option.
|
||
|
|
|
||
|
|
The source code for the command line version of dZ80 is freely available
|
||
|
|
from the dZ80 web site at http://www.inkland.org
|
||
|
|
|
||
|
|
Additions and Changes to the Windows version:
|
||
|
|
|
||
|
|
The program that dZ80 launches to view the disassembly with can now be
|
||
|
|
selected. It defaults to using Notepad.
|
||
|
|
|
||
|
|
The source file is now re-loaded for every disassembly, so that dZ80
|
||
|
|
can be left running, the source file can be updated and dZ80 will
|
||
|
|
disassemble the updated source file without having to re-select the
|
||
|
|
source to re-load it.
|
||
|
|
|
||
|
|
Made some cosmetic changes.
|
||
|
|
|
||
|
|
Bug Fixes:
|
||
|
|
|
||
|
|
The Windows version (dZ80w) was not using the "source file starts
|
||
|
|
at Z80 address" option correctly.
|
||
|
|
|
||
|
|
|
||
|
|
v1.21 - 24th August, 1997
|
||
|
|
-------------------------
|
||
|
|
|
||
|
|
Additions and Changes:
|
||
|
|
|
||
|
|
Changed the default install folder to "Program Files\Inkland\dZ80" to
|
||
|
|
keep everything from Inkland in one place. If you're upgrading from
|
||
|
|
an earlier version of dZ80 for Windows 95, please uninstall the older
|
||
|
|
version first.
|
||
|
|
|
||
|
|
When performing a 2-pass (labelled) disassembly, addresses that are
|
||
|
|
referenced are now referred to with the label, rather than the address.
|
||
|
|
Easier to show than describe! E.g.
|
||
|
|
|
||
|
|
l0000: inc a will now disassemble as: l0000: inc a
|
||
|
|
jr nz,#0000 jr nz,l0000
|
||
|
|
|
||
|
|
Bug Fixes:
|
||
|
|
|
||
|
|
None
|
||
|
|
|
||
|
|
|
||
|
|
v1.20a - 29th April, 1997
|
||
|
|
-------------------------
|
||
|
|
|
||
|
|
The installer was rebuilt with a new version of the install builder.
|
||
|
|
This fixes problems with the previous installer which didn't work
|
||
|
|
correctly on NT 4.0
|
||
|
|
|
||
|
|
Recompiled dZ80 with VC++ 5.0, for better performance.
|
||
|
|
|
||
|
|
|
||
|
|
v1.20 - 20th April, 1997
|
||
|
|
------------------------
|
||
|
|
|
||
|
|
Initial public release.
|
||
|
|
|
||
|
|
This program shares the same disassembly engine as its DOS command-
|
||
|
|
line counterpart. That's why this first release of dZ80 for Windows 95
|
||
|
|
is already at v1.20!
|
||
|
|
|
||
|
|
|
||
|
|
v1.11 - 12th January, 1997
|
||
|
|
--------------------------
|
||
|
|
|
||
|
|
Additions and Changes:
|
||
|
|
|
||
|
|
Modified the source code to be portable (i.e. separated the
|
||
|
|
nasty 16-bit DOS bit).
|
||
|
|
|
||
|
|
dZ80 now comes in two flavours: "dz80" the original 16-bit version
|
||
|
|
and "dz80-32" a 32-bit version, which works significantly faster.
|
||
|
|
|
||
|
|
The source code for dZ80 is now available for porting to another
|
||
|
|
platform. If you wish to convert, e-mail me at
|
||
|
|
dz80@inkland.org stating which platform you're wanting to
|
||
|
|
convert it to, and I'll send you the source.
|
||
|
|
|
||
|
|
Bug Fixes:
|
||
|
|
|
||
|
|
None - really! :)
|
||
|
|
|
||
|
|
|
||
|
|
v1.10 - 14th December, 1996
|
||
|
|
---------------------------
|
||
|
|
|
||
|
|
Additions and Changes:
|
||
|
|
|
||
|
|
Added all known undocumented ED opcodes and also the
|
||
|
|
"Super Loader Trap" pseudo opcode ED FB (used by some Sinclair
|
||
|
|
Spectrum emulator snapshot files).
|
||
|
|
|
||
|
|
Added support for opcode map files. This feature has been tested with
|
||
|
|
Gerton Lunter's "Z80" Sinclair Spectrum Emulator map files. See the
|
||
|
|
DZ80.TXT file (after installation) for information on the format of
|
||
|
|
these files. A small demonstraton of this feature is also supplied.
|
||
|
|
|
||
|
|
dZ80 now comes supplied with a sample Sinclair Spectrum snapshot and
|
||
|
|
opcode map file.
|
||
|
|
|
||
|
|
Made some minor optimisations.
|
||
|
|
|
||
|
|
All warnings and errors are now displayed via "stderr" which means
|
||
|
|
that they will be visible, even if dZ80's output is redirected.
|
||
|
|
|
||
|
|
Added a /q (quiet) command line option. It instructs dZ80 to only
|
||
|
|
display the disassembly and no other information.
|
||
|
|
|
||
|
|
Bug Fixes:
|
||
|
|
|
||
|
|
Fixed a problem with disassembling opcodes EDB8 to EDBB.
|
||
|
|
|
||
|
|
Fixed a problem with the opcodes 0x22 "ld (nn),hl" and 0x33
|
||
|
|
"ld (nn),a", which could sometimes be disassembled as the other.
|
||
|
|
|
||
|
|
|
||
|
|
v1.00 - 19th November, 1996
|
||
|
|
---------------------------
|
||
|
|
|
||
|
|
Initial public release.
|