The goal of this project is to disassemble TR-DOS 5.03, in order to study it and fix some problems found during the development of its support for Solo Forth (Solo Forth in GitHub).
. ├── inc = ZX Spectrum symbols for the disassembler │ ├── zx_spectrum_char_codes.z80s │ ├── zx_spectrum_rom_routines.z80s │ ├── zx_spectrum_system_variables.z80s │ ├── zx_spectrum_trdos_addresses.z80s │ └── zx_spectrum_trdos_codes.z80s ├── Makefile ├── README.adoc = This file ├── TO-DO.adoc = To-Do list ├── tools = programs used by Makefile or during the development │ ├── make_blocks.c_commands_table.fs │ ├── make_blocks.rst_20.fs │ └── tidier.vim = VimL program that postprocess the disassembly ├── trdos.blocks.txt = Block definitions for the disassembler ├── trdos.raw.z80s = Disassembly created by the disassembler ├── trdos.reassembled.rom = TR-DOS reassembled from <trdos.z80s> ├── trdos.rom = Original ROM of TR-DOS 5.03 to be disassembled ├── trdos.symbols.input.z80s = Symbols defined for the disassembler ├── trdos.symbols.output.z80s = Output symbols of the disassembly └── trdos.z80s = Final disassembly, postprocessed by <tools/tidier.vim>
In order to disassemble the ROM, the following programs must be installed:
The following programs are needed to reassemble the disassembly, what is optional:
-
Make sure the required programs are installed.
-
Enter the project directory and give the
makecommand. -
If you want to assemble the disassembly and check that the result is identical to the original ROM, give the
make backcommand.
Documentation used for this project, listed in order of publication:
-
Technology Research Beta 128 Disk Interface — User Manual, 1986. http://www.worldofspectrum.org/documentation.html#manuals, http://www.worldofspectrum.org/pub/sinclair/hardware-info/Beta128DiskInterface_Manual.txt.
-
TR-DOS для профессионалов и любителей (TR-DOS for professionals and amateurs), by Yu Pomortsev, 1994. PDF version by Deny (Denisenko DA), 2007. https://vtrd.in, http://trd.speccy.cz/book/TRDOSUA.ZIP.
-
Описание и полный дизассемблер ПЗУ TR-DOS 5.04T (Description and full disassembly of TR-DOS 5.04T), by Павел Федин (Paul Fedin), 1996. https://vtrd.in, http://trd.speccy.cz/book/TRDISASM.ZIP.
-
TR-DOS System Functions, by Igor Yudincev, 1997-06-01. http://ramsoft.bbk.org.omegahg.com/tech/tr-info.zip.
-
Work in TR-DOS from command line and from BASIC, by Igor Yudincev, 1997-06-27. http://ramsoft.bbk.org.omegahg.com/tech/tr-info.zip.
-
TR-DOS disk specs, anonymous, 1997-09-28. http://ramsoft.bbk.org.omegahg.com/tech/tr-info.zip.
-
Russian Most Popular Spectrum Models (combined) FAQ and TECH INFO, by Potapov Vsevolod Viktorovich, 1997-10-25. http://www.worldofspectrum.org/rusfaq/
-
TR-DOS v5.xx - programmer’s manual, by Andrew MOA and Mac Buster^Extreme, 1990 (English translation, 1999), http://www.worldofspectrum.org/documentation.html#manuals, http://www.worldofspectrum.org/pub/sinclair/hardware-info/TR-DOS_Programming.txt.
-
TR-DOS v5.xx variables in Beta 128 Disk interface, by Mac Buster^Extreme, 2000. http://www.worldofspectrum.org/documentation.html#manuals, http://www.worldofspectrum.org/pub/sinclair/hardware-info/TR-DOS_Variables.txt.
Websites that were used: