================================================================================ 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.