TK Disassembler

=====================
TK Disassembler v 1.0
=====================

Z80 disassembler for TK90X and ZX Spectrum. Decoding of Z80 instruction is based on the document "Decoding Z80 Opcodes" by Cristian Dinu (http://z80.info/decoding.htm, accessed on 22/Jan/2023).
Author: TK Fan (cantinhotk90x@bol.com.br, http://cantinhotk90x.blogspot.com)
Date: 07/Mar/2023

---------------------------------
Archive 'TK Disassembler 1.0.zip'
---------------------------------
Files:
------
TK Disassembler.asm Z80 assembler source code, compatible with pasmo
TK Disassembler.tzx Tape image file (see below)
Header_Basic.asm Include file for the source code
Header_Calc.asm Include file for the source code
Header_Print.asm Include file for the source code
TK Disassembler v1.0.readme This file

How to assemble the binary file:
--------------------------------
For the impatient one: skip this section and read about 'TK Disassembler.tzx' below. This section explains how to make binary file from the source code.

Unzip all *.asm files to the current subdirectory. Edit 'TK Disassembler.asm' with any text editor, replacing ORG argument with the desired start address. Use a Z80 assembler of your choice to make the binary file.

If you are using pasmo, the command is:
$ pasmo --tap 'TK Disassembler.asm' 'TKDIS.tap'

The file 'TKDIS.tap' can be loaded in an emulator typing (set the RAMTOP with CLEAR statement if necessary):
LOAD ""CODE <start address>

The following pokes defines the address of machine code to be disassembled:
POKE <start address>+2,<machine code address LSB)
POKE <start address>+3,<machine code address MSB)

Addresses and Z80 instruction numeric arguments are displayed in decimal or hexadecimal format, depending on the value in <start address>+8. So, the output mode is defined with:
POKE <start address>+8,n
(n=0 for decimal mode/n=1 for hexadecimal mode)

To run the disassembler:
RANDOMIZE USR <start address>

--------------------------
File 'TK Disassembler.tzx'
--------------------------
This tape file uses TZX format, supported by many ZX Spectrum emulators. It contains TK Disassembler program resident at 24500-26337 (low memory) or 60000-61837 (high memory). Also, AllOpcodes is saved in the last part.

TK Disassembler (low memory)
----------------------------
To load this version, type in the emulator:
LOAD "TKDIS_low"
The machine code is loaded, RAMTOP is set at 24499 and the program stops. Type 'RUN' to run the disassembler. You will be asked to enter the address to disassemble and if you want the output in decimal (0) or hexadecimal (1) mode.

Lines containing address, hexadecimal machine code and Z80 mnemonic are printed until the entire screen is filled. After that, the 'scroll?' prompts is displayed. Press BREAK or N key to quit program, any other key to print more disassembly list.

TK Disassembler (high memory)
-----------------------------
To load this version, type:
LOAD "TKDIS_high"
The instructions are the same as the low memory resident version. The RAMTOP is set at 59999 and can be changed if necessary.

All Opcodes
-----------
All Opcodes is a binary containing all possible combinations of Z80 machine code instructions. It is useful to test TK disassembler. All Opcodes is loaded with:
LOAD "AllOpcodes"CODE <address>
If <address> is omitted, All Opcodes is loaded from 40000.