	wmachemu 0.0.0-pre1 README

wmachemu jest emulatorem "maszyny W" uywanej na wykadach Postaw
Informatyki na kierunku Automatyka i Robotyka na wydziale Automatyki,
Elektroniki i Informatyki na Politechnice lskiej w Gliwicach.

Jest to alternatywa dla emulatrora dostpnego na stronie tego przedmiotu,
ktry jest dostpny tylko w formie wykonywalnej dla systemu Microsoft
Windows.

Obecna wersja skada si z trzech czci:
	wmachemu - waciwy emulator maszyny W
	wucc - kompilator mikrokodu
	was - assembler

Z emulatora korzysta si w nastpujcy sposb:
$ wmachemu -l mikrokod obraz1 [obraz2]

Przewanie aduje si dwa obrazy. Jeden z danymi, a drugi mniejszy
z programem. Dane wtedy umieszcza si na kocu pierwszego pliku.
Przewanie zadania ukadane w taki spobb, e taki sposb adowania
proramw wystarcza.

Przed uruchomieniem trzeba mie skompilowany mikrokod. Robi si to poprzez
$ wucc -o plik_wyjsciowy plik_wejsciowy

Trzeba take skompilowa wczeniej program:
$ was -o plik_wyjsciowy plik_wejsciowy

Przykadowo, by uruchomi program 2 (prog2.asm) z katalogu examples mona
wykona nastpujce polecenia:

$ cd examples
$ wucc -o w_machine.bin w_machine	# wygenerowanie mikrokodu
$ was -o prog2 prog2.asm		# skompilowanie programu
$ echo -e "\x04\x09" | dd of=dane bs=1 seek=30 count=2
					# wygenerowanie pliku z danymi.
					# na 30 bajcie jest 0x04, a na 31 0x09
$ wmachemu -l w_machine.bin dane prog2

Raporty o bdach lub proby dodanie jaki cech naley kierowa na
adres krzysiek@podlesie.net.
