U A E

UN*X AMIGA EMULATOR

wersja 0. 6. 9 dla DOS

Uwaga! Istnieje juz tlumaczenie dokumentacji nowszej wersji programu -- UAE 0.8.6. Najlepiej czytaj od razu je (chyba, ze uzywasz starszej wersji). Tlumaczenie to znajdziesz tutaj. Ninejsza strona o DOSUAE 0.6.9 nie bedzie juz uaktualniana, kod html nie zostanie poprawiony. Strone te zostawiam dla uzytkownikow tej wersji programu oraz dla zachowania waznosci linkow na innych stronach o UAE.


Powrót do strony głównej

Spis treści

1.Wstęp  2.Prawa autorskie  3.Czym jest emulator?  4.Sprawy istotne dla DOSa  5.Wymagania programu  6.Instalacja  7.Konfigurowanie  8.Komendy wprowadzane z klawiatury  9.Klawiszologia  10.Parametry linii komend  11.Emulacja twardego dysku  12.Przenoszenie danych z Amigi  13.Współpraca  14.Informacje dodatkowe O tej stronie


WSTĘP  spis treści

Witaj, użytkowniku UAE, pierwszego w pełni funkcjonalnego emulatora komputera Commodore Amiga! Ta dokumentacja została napisana dla DOS-owskiej wersji UAE i zawiera informacje na temat emulatora, jego konfiguracji i sposobów jak najpełniejszego wykorzystania jego możliwości.


PRAWA AUTORSKIE  spis treści

Copyright 1995, 1996, 1997 Bernd Schmidt i współautorzy

UAE jest programem FREEWARE, tj. nie wymaga się opłaty za użytkowanie go do celów osobistych. Zezwala się na jego bezpłatną dystrybucję, pod warunkiem, że będzie rozpowszechniany jako pełne archiwum bez zmienionej zawartości. Za program nie wolno pobierać żadnych opłat, za wyjątkiem ceny nośnika. Wyjątkiem od tej zasady jest zamieszczenie programu w kolekcjach freeware/shareware na płytach CD i CD-ROMach dołączanych do magazynów. Nie udziela się żadnych gwarancji. Jeśli używasz tego programu, robisz to na swoje własne ryzyko. Autorzy nie są odpowiedzialni za żadne zniszczenia, które mogą być wynikiem działania programu. "Amiga" jest zastrzeżonym znakiem handlowym Amiga International.


CZYM JEST EMULATOR I CZYM DOKŁADNIE JEST UAE?  spis treści

Emulator jest to program umożliwiający uruchomienie na Twoim komputerze oprogramowania napisanego dla innego komputera i systemu operacyjnego. UAE jest emulatorem programowym pozwalającym na uruchomienie większej części Amigowskiego oprogramowania, zarówno komercyjnego, jak i Public Domain. Do emulacji nie jest potrzebny żaden specjalny sprzęt, wystarcza po prostu pliki wchodzące w skład pakietu UAE i, w przypadku tej wersji, IBM PC pracujący pod systemem MS-DOS 5.0 lub nowszym. UAE emuluje tak wiele możliwości sprzętowych Amigi, ze możesz uruchomić większość gier i prawie wszystkie aplikacje dostępne dla Amigi, a samej Amigi mieć nie musisz! UAE umożliwia przesył oprogramowania z Amigi na twardy dysk Twojego Peceta, skąd emulator będzie mógł je pobierać. Podczas działania emulatora twój komputer zachowywał się będzie jak prawdziwa Amiga - będziesz miał joystick, mysz, dźwięk, możliwość konfigurowania wyświetlania obrazu i, zakładając, że posiadasz oprogramowanie, oryginalny system operacyjny Amigi. Istotną rzeczą jest aby pamiętać, ze UAE jest emulatorem działającym jak prawdziwa Amiga. Na komputerze z procesorem Pentium działa z całkiem znośną prędkością. UAE jest otwartym projektem, wspieranym przez wielu oddanych ludzi, i będzie się rozwijać w miarę ich wkładu w ulepszanie i kształtowanie emulatora.


.SPRAWY ISTOTNE DLA UŻYTKOWNIKA WERSJI DOS  spis treści


WYMAGANIA PROGRAMU  spis treści
 

Aby uruchomić UAE, musisz posiadać:

Jednak jeśli chcesz wykorzystać wszystkie możliwości UAE, ZALECA SIĘ:

Prędkość działania UAE bardzo zależy od sprzętu. Emulator będzie o wiele lepiej działał z szybkim procesorem i mnóstwem pamięci. Im szybszy masz komputer, tym bardziej będziesz mógł cieszyć się szybką emulacją - nie oczekuj świetnej zabawy na 386 z karta VGA 256k i 4 MB RAM.


INSTALACJA UAE  spis treści

Powinieneś rozpakować archiwum UAE do jakiegoś katalogu, a potem uruchomić plik wsadowy RUNME.BAT, który zakończy za ciebie procedurę instalacji. Program cztery razy poprosi o wciśnięcie dowolnego klawisza.

W podkatalogu UTILS znajdziesz dwa programy: makedisk.exe oraz readdisk.exe. Makedisk.exe służy do stworzenia pliku wirtualnego dysku twardego, którego będziesz mógł używać z emulatora Amigi. Programu tego możesz tez użyć do stworzenia pliku dyskietki, której oczywiście także będziesz mógł używać z emulatorem. Readdisk.exe służy do czytania image'ów Amigowskich dysków (.adf = Amiga Disk File) i przenoszenia zawartości tych plików do dowolnego katalogu na Twoim pecetowskim twardym dysku. Dokładniej przyjrzymy się pracy obu tych programów pózniej w tym dokumencie.

W podkatalogu AMIGA znajdują się dwa Amigowskie wykonywalne pliki służące do przenoszenia zawartości Amigowskiej dyskietki do pliku .adf oraz do zgrywania Kickstartu do pliku kick.rom. Plik kick.rom jest niezbędnie potrzebny jeśli będziesz chciał emulować Workbencha (tj. oryginalny system operacyjny Amigi). Również te programy zostaną pózniej omówione bardziej szczegółowo. Po upewnieniu się, że posiadasz wszystkie pliki wchodzące w skład pakietu DosUAE, możesz uruchomić emulator wpisując uae. exe i wciskając ENTER. Zobaczysz prosty program konfiguracyjny, w którym możesz zmienić i ustawić rożne opcje, tak aby działanie emulatora odpowiadało Twoim potrzebom. Każda z opcji menu jest krotko opisana, znajdziesz też kilka zalecanych ustawień dla osób, które nie orientują się zbyt dobrze w zawiłościach Amigowskiego sprzętu i nie są całkiem pewne jak skonfigurować UAE.

Bardziej szczegółowa pomoc dotycząca konfigurowania emulatora znajduje się w pliku qsetup.dos.


KONFIGUROWANIE UAE  spis treści

Po uruchomieniu UAE zobaczysz prosty program konfiguracyjny w formie menu. Możesz tu zmienić i ustawić rożne opcje, tak aby działanie emulatora odpowiadało Twoim potrzebom. Tekst po prawej stronie pokazuje jak w danej chwili skonfigurowany jest UAE. W miarę jak będziesz zmieniał ustawienia, zmiany zostaną odnotowane z prawej strony.


KOMENDY WPROWADZANE Z KLAWIATURY  spis treści

Podczas pracy emulatora można użyć następujących komend:

Opcje wkładania i wyjmowania dyskietki są szczególnie przydatne przy instalowaniu oprogramowania mającego więcej dyskietek niż Ty masz stacji. Jest to też istotne gdy chcesz przypisać jakąś nazwę do dysku poleceniem Assign, (dysk taki musi zostać wyjęty, zanim Assign zacznie działać).
KLAWISZOLOGIA  spis treści

Amiga ma swoje specjalne klawisze, podobnie jak MAC, czy najnowsze Pecety z klawiatura Windows95. Klawisze "prawa i lewa Amiga" używane są do wywoływania specjalnych funkcji, jak na przykład wywoływanie opcji z menu bez użycia myszy, czy choćby resetowanie. Lista dostępnych klawiszy funkcyjnych:


PARAMETRY PODAWANE Z LINII KOMEND  spis treści

Opcjonalnie możesz dodać w linii poleceń następujące parametry:

Emulowanie zewnętrznych urządzeń (dysk twardy, CD-ROM, drukarka, port szeregowy):

dźwięk:

Przy wyświetlaniu grafiki z jednoczesnym włączeniem dźwięku, emulator w większości wypadków będzie działał o wiele za wolno. Dlatego dołączono możliwość wyłączenia odświeżania ekranu klawiszem ScrollLock.

Emulacja pamięci:

Opcje debuggera (nieistotne dla większości użytkowników):

Opcje wyświetlania:

tryb (ilość kolorów):

spec (tryb graficzny):

Po opcji -O ustawiamy wysokość i szerokość wyświetlanego obrazu oraz dodatkowe parametry. Np. można ustawić "-O 640:300:", co da szerokość ekranu na 640 pikseli, a wysokość na 300 pikseli bez żadnych modyfikatorów (bo nie podano parametru po drugim dwukropku). Można zastosować następujące parametry:

UAE może zignorować niektóre kombinacje tych parametrów, bądź odmówić działania. Niektóre z tych trybów mogą nie działać na Twoim systemie. Możesz także umieścić te opcje w pliku konfiguracyjnym: plik należy nazwać uae.rc i umieścić go w katalogu bieżącym


EMULACJA TWARDEGO DYSKU  spis treści

UAE może emulować więcej niż jeden dysk twardy, dyski te nazywać się będą UAE0:, UAE1:, itd. UAE będzie inicjowac system z UAE0:, jeśli nie jest podany żaden plik dyskietki dla DF0:

a) Pliki z image'em twardego dysku (nie polecane)

Możesz stworzyć plik z image'em twardego dysku (niesformatowanego) komendą:

dd if=/dev/zero of=hardfile bs=512 count=16384

Zostanie stworzony plik o wielkości 8 MB. Inne wielkości tez powinny działać, z tym, że powinny to być potęgi 2. Emulator zawiera rezydentny moduł (hardfile.device), który służy do obsługi emulowanego twardego dysku.

Używając Kickstartu 1.3 lub starszego nie można inicjować systemu z image'u twardego dysku. Będziesz go musiał zainicjować z pliku dyskietki (lub z oryginalnego systemu plików - patrz poniżej), a dopiero później poleceniem mount założyć hardfile.device. Aby to zrobić, musisz dodać do DEVS:mountlist następujące linie:

UAE0:
Device = hardfile.device
Unit = 0
Flags = 0
Surfaces = 1
BlocksPerTrack = 32
Reserved = 1
Interleave = 0
LowCyl = 0 ; HighCyl = 511
Buffers = 5
DosType = 0x444F5300
BufMemType = 1
#

Po zrobieniu tego napisz mount UAE0: (lub dodaj tę komendę do startup-sequence). Nie zapomnij o sformatowaniu twardego dysku z poziomu AmigaDOS poleceniem:
format drive uae0: name Nazwa

b) pobieranie danych z oryginalnego systemu plików

Metoda ta ma kilka istotnych plusów: nie ma kłopotów z Kickstartem 1.3, jest wygodniejsza, jest szybsza niż prawdziwa Amiga czytająca dyski. Jeśli w linii komend podasz parametr -M lub -m, będziesz mógł czytać swój oryginalny system plików z poziomu emulatora. Np. uruchomienie emulatora poleceniem uae -m dh0:C:\
da ci dostęp do pecetowskiego twardego dysku jako "DH0:".W ten sposób można utworzyć do 20 urządzeń pamięci zewnętrznej. Jest to także sposób na uzyskanie dostępu do amigowskich CD-ROMów.


PRZENOSZENIE DANYCH Z AMIGI  spis treści

Ponieważ pecetowski kontroler stacji dysków nie może czytać Amigowskich dysków, dostęp do dyskietek Amigowskich jest rozwiązany w inny sposób. Dyskietki są emulowane za pomocą plików zawierających "image" dyskietki, którą chcesz odczytać. Image jest to zapis scieżka-po-scieżce danych z dyskietki. Plik z image'em zawiera 901120 bajtów (880K) - standardowa pojemność Amigowskiej dyskietki. Aby uruchomić emulator musisz zainstalować jeszcze zapis pamięci ROM z Twojej Amigi. Plik ten nie jest dołączony, ponieważ chroniony jest prawami autorskimi. Nie proś o przysłanie go! Jeśli nie masz Amigi i chcesz używać UAE, musisz kupić Amigę lub co najmniej oprogramowanie systemowe (ROM i Workbench). Image Kickstartu (ROM-u) może mieć wielkość 256K lub 512K. Standardowo powinien być nazwany "kick.rom". Jeśli nie masz image'u ROM-u, i tak będziesz mógł uruchamiać NIEKTÓRE gry i dema. Emulator zawiera uproszczony kod, który próbuje odczytać i zabootować używany przez ciebie image. Nie oczekuj jednak zbyt wiele.

Jest kilka sposobów na przesył plików z Amigi:

- za pomocą kabla łączącego komputery, (tzw. null modem cable) i programu terminala. Można użyć standardowego Commodorowskiego sterownika serial.device. Jednak szybszy jest nowszy sterownik BaudBandit.device (osiągalny na Aminecie). Innym sposobem jest użycie napisanego w BASICu programu adfi.bas (dołączonego w pakiecie z UAE).

- jeśli na swojej Amidze używasz CrossDOSa, możesz spakować plik dyskietki lub ROMu za pomocą LHA (lub innego zgodnego z PC archiwizera) i skopiować go na pecetowską dyskietkę 720K. Jeśli nie masz CrossDOSa, istnieje darmowe oprogramowanie o spełniające podobną funkcje, jest to Msh (dostępny w Aminecie lub na dysku Fisha nr 382 lub 327)

W podkatalogu "AMIGA" znajdują się dwa małe programy, które pomogą ci stworzyć pliki image'ów dyskietek i ROMu. Programy nazywają się transdisk i transrom. Skopiuj je do swojej Amigi i napisz w oknie poleceń "protect transrom rwed" i "protect transdisk rwed", aby programy były wykonywalne. Transrom skopiuje zawartość Kickstart ROM, a transdisk stworzy image dyskietki znajdującej się w jednym z napędów. Oba programy dokonują zapisu na standardowym wyjściu (tj. na ekranie), musisz więc to zmienić. Napisz:
transrom ram:kick.rom
aby w RAM dysku stworzyć plik "kick.rom", lub
transdisk ram:df0.adf
aby w RAM dysku utworzyć plik "df0.adf". Pliki te są dosyć duże, zapis ROMu zabiera 262144 lub 524288 bajtów, a image dysku 901120.

Transdisk rozpoznaje następujące parametry:

Jeśli masz niewiele RAMu i cały image dyskietki nie mieści ci się w RAM dysku, możesz podzielić image na kilka części parametrami "-s" i "-e". Aby przenieść dysk w czterech częściach, użyj następujących poleceń:

transdisk ram:df0_1.adf -s 0 -e 19
transdisk ram:df0_2.adf -s 20 -e 39
transdisk ram:df0_3.adf -s 40 -e 59
transdisk ram:df0_4.adf -s 60 -e 79

Gdy już masz te pliki na swoim pececie, napisz:
COPY /B df0_1.adf+df0_2.adf+df0_3.adf+df0_4.adf df0.adf

W tej chwili program transdisk odczytuje tylko standardowy format dyskietek AmigaDOS. Znaczy to, ze niektóre gry używające pewnych typów zabezpieczenia przed skopiowaniem nie może zostać przeniesiona.

Jeśli przenosisz oprogramowanie komercyjne, nie wolno ci rozprowadzać stworzonych plików image - byłoby to pogwałceniem obowiązujących praw. Kickstart ROM _jest_ oprogramowaniem komercyjnym. Możesz używać pliku Kickstartu pochodzącego wyłącznie z Twojej Amigi, i nie wolno ci tego pliku rozpowszechniać.


WSPÓŁPRACA  spis treści

Do pisania kodu przyczynili się:

W kilku innych dziedzinach zasłużyli się:
INFORMACJE DODATKOWE  spis treści

Wersja UAE dla DOS ma swoje miejsce w sieci: http://www.netrunner.com.br/dosuae

Dyskusje n/t UAE: http://www.netrunner.com.br/dosuae/uaeboard

Jeśli używasz BBS-u w Niemczech, spróbuj:

Point Of No Return BBS 28k8:
+49-6039-95934
ISDN: +49-6039-95935

Autor wersji UAE dla DOS jest osiągalny przez pocztę elektroniczną pod adresem:

ggoedert@netrunner.com.br

Zanim wyślesz pytanie, upewnij się, że odpowiedzi nie ma w tym pliku ani w Najczęściej Zadawanych Pytaniach. Nie przysyłaj próśb o image żadnych dysków ani o pliki Kickstart ROM - prośby takie zostaną zignorowane.

spis treści

Powrót do strony głównej

Copyright for the translation © 1998 by Tomasz Sienicki
Kontakt do autora tłumaczenia: Tomasz 'tsca' Sienicki, tsca@cryogen.com


Uwaga! Istnieje juz tlumaczenie dokumentacji nowszej wersji programu -- UAE 0.8.6. Najlepiej czytaj od razu je (chyba, ze uzywasz starszej wersji). Tlumaczenie to znajdziesz tutaj. Ninejsza strona o DOSUAE 0.6.9 nie bedzie juz uaktualniana, kod html nie zostanie poprawiony. Strone te zostawiam dla uzytkownikow tej wersji programu oraz dla zachowania waznosci linkow na innych stronach o UAE.

Page hosted by geocities. 1