DIZ80 - декомпилятор для систем K580
====================================

Назначение
----------
Декомпилятор DIZ80 предназначен для декомпиляции двоичных исполняемых
файлов в кодах процессора K580 и получения текстов программ для 
стандартного ассемблера или для компилятора VMAKER.

Требования к системе
--------------------
Самые минимальные: 
 + установленная система EvForth (файл ev.exe)
 + наличие стандартного компилятора pasm.ev (если нужна модификация программы)
 + какой-либо текстовый редактор (edit.com, наконец)

Комплект поставки
-----------------
Каталог DIZ80

 + README.TXT - описание программы (этот файл)
 + README.HTM - описание программы (в виде HTML)
 + DIZASM.BAT - командный файл декомпиляции BIN => ASM
 + DIZVMK.BAT - командный файл декомпиляции BIN => VMK
 + DIZ80.PC - декомпилятор BIN => ASM
 + DIZVMK.PC - декомпилятор BIN => VMK

Каталог DIZ80/src

 + MAKE.BAT - makefile для компиляции декомпилятора
 + DIZ80.EV - файл конфигурации компилятора PASM
 + DIZCORE.EV - основное ядро программы DIZ80
 + DIZ_ASM.EV - таблица декомпиляции на язык ASSEMBLER
 + DIZ_VMK.EV - таблица декомпиляции на язык VMAKER

Каталог DIZ80/demo - пример декомпиляции файлов

 + RUNME.BAT - запустите этот файл на выполнение для 
   проверки работоспособности программы DIZ80
 + ROMR.BIN - двоичный файл Монитора для компьютера Радио-86 РК
 + Romr.asm - декомпилированный на Ассемблер файл Romr.bin
 + Romr.vmk - декомпилированный на VMAKER файл Romr.bin
  
Для нормальной работы требуются файлы: 

 + ev.exe - система EvForth
 + DIZ80.PC (DIZVMK.PC) - декомпилятор
 + DIZASM.BAT (DIZVMK.BAT) - командный файл для удобства использования 
 программы

Использование
-------------

Синтаксис вызова

  ev /run diz80.pc  input.bin start [ options ]  >output.asm
  ev /run dizvmk.pc input.bin start [ options ]  >output.asm

или:

  dizasm.bat input.bin output.asm start [ options ] 
  dizvmk.bat input.bin output.asm start [ options ] 

где 
input.bin -? файл для обработки
start -? начальный адрес файла input.bin (все буквы - прописные, например, F8AC)
output.asm -? файл с программой на ассемблере K580
options -? опции дизассемблера (могут быть опущены):
	0 ничего не печатать
	1 печатать адреса
	2 печатать коды
	4 печатать текст программы
	5 печатать адреса и текст
	7 полная распечатка
	F полная распечатка
   сумма 1 + 2 + 4 (HEX) задает, что нужно печатать
   например
	режим 5 = 1 + 4? печатать адреса и текст
	режим 3 = 1 + 2? печатать адреса и коды
	режим 7 или F = 1 + 2 + 4 полная распечатка. 
	По умолчанию используется режим 4 (только текст)

Декомпилятор формирует файл распечатки программы 
output.asm в следующем формате:

 ; Dissassembler for K580 systems, v.1.1
 ; (C) AG PRO, 2000
 ; File: A.BIN
 BASE &0000
 0000 :    78       A=B
 0001 :    C3 05 00 GOTO X0000
 0004 :    57       D=A
 X0000:
 0005 :    C9       RETURN
 END

Примеры
-------

  dizasm romr.bin romr.asm F800 5      // bin -> asm
  dizvmk romr.bin romr.vmk F800        // bin -> vmk

-------------------------------------------------------------------------------
                                                  (C) AG Software, 28 Март 2000