	wmachemu 0.0.0-rc3 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

Obecnie domylnie wspierane s dwie maszyny: maszyna W oraz maszyna WIO.
Maszyna W jest w peni kompatybilna z maszyn wykadow w zakresie
programu oraz prawie w peni kompatybilna w przypadku mikrokodu. Maszyna
WIO posiada dodatkowy mikrorozkaz io, ktry daje moliwo definiowania
rnego rodzaju portw io w przestrzeni adresowej. Przestrze ta jest dzielona
z pamici operacyjn. Jeeli pod danym adresem nie ma adnego portu
to zwracana jest zawarto pamici. Do pamici zawsze mona si dosta
w przypadku, gdy sygna sterujcy io nie wystpuje. Jako, e przewanie
pocztek pamici zajmuje kod, do ktrego nie trzeba mie dostpu
jako do danych mona w to miejsce wrzuci porty.

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