--- uae/docs/README 2018/04/24 17:05:15 1.1.1.20 +++ uae/docs/README 2018/04/24 17:19:47 1.1.1.28 @@ -1,7 +1,10 @@ -This is version 0.8.20 of UAE, the UAE Amiga Emulator. +This is version 0.8.28 of UAE-core, the UAE Amiga Emulator. -Versions numbered 0.8.x are considered beta versions, but they generally -tend to work better than the last "stable" release 0.7. +This package used to be the master copy of UAE; it has somewhat lagged in +development since. It is now intended to be a stable emulator core with a +focus on running old A500 games and demos. Certain extra features, such as +a JIT compiler, will not be added - other packages such as WinUAE or E-UAE +are available which include these patches. License @@ -82,8 +85,6 @@ Not emulated: - An MMU (part of 68030/040 CPUs except those that Commodore used). This means you can't use virtual memory systems or real operating systems like Linux or BSD. -- The AGA chipset (A4000/A1200). This chipset has enhanced capabilites for - up to 256 colors in all resolutions. - Serial port emulation exists but doesn't work too well. Since the PC floppy controller can't read Amiga disks (yes, that's a fact), @@ -162,6 +163,8 @@ floppy0=file [default=df0.adf] The options floppy1, floppy2, and floppy3 also exist. kickstart_rom_file=file [default=kick.rom] Use the specified file instead of kick.rom as Kickstart image. + You can also use an 8k sized A1000 boot ROM. The emulator will detect it + by its small size and behave like an A1000. kickstart_key_file=file [default=none] For some strange licensing reasons, Cloanto had to encrypt the ROM images they ship with the Amiga Forever package. This option lets you select the @@ -589,6 +592,16 @@ After that is complete, reboot, and you modes from the ScreenModes program. +AHI sound card emulation +======================== + +In the "amiga" subdirectory of the UAE distribution, you will find a "Devs" +directory that contains the necessary files for AHI sound support. This is +at an early stage and will not work very well in this release. It is +included mainly in the hope that someone with a clue about AHI will pick up +this work and finish it properly. + + Saving and restoring snapshots ============================== @@ -685,20 +698,38 @@ press ^C at any time to enter this debug Each debugger command consists of a single letter and occasionally some parameters. -g: Start execution at the current address. -c: Dump state of the CIA and custom chips. -r: Dump state of the CPU -m
: Memory dump starting at
-d
: Disassembly starting at
-t: Step one instruction -z: Step through one instruction - useful for JSR, DBRA etc. -f
: Step forward until PC ==
-q: Quit the emulator. You don't want to use this command. -M: hunt for sound modules -S
: - save a sound module -C : Search for values like energy or lifes in games -W
: Write into Amiga memory +g [
] Start execution at the current address or
+c Dump state of the CIA, disk drives and custom registers +r Dump state of the CPU +m
[] Memory dump starting at
+d
[] Disassembly starting at
+t [instructions] Step one or more instructions +z Step through one instruction - useful for JSR, DBRA etc +f Step forward until PC in RAM +f
Add/remove breakpoint +fi Step forward until PC points to RTS/RTD or RTE +fi Step forward until PC points to +fl List breakpoints +fd Remove all breakpoints +f Step forward until <= PC <= +e Dump contents of all custom registers +i Dump contents of interrupt and trap vectors +o <1|2|addr> []View memory as Copper instructions +O Display bitplane offsets +O Offset a bitplane +H Show PC history instructions +M Search for *Tracker sound modules +C Search for values like energy or lifes in games +W
Write into Amiga memory +w
[] + Add/remove memory watchpoints +wd Enable illegal access logger +S Save a block of Amiga memory +s / [] [] + Search for string/bytes +T Show exec tasks and their PCs +h,? Show this help page +q Quit the emulator. You don't want to use this command. Sound @@ -793,19 +824,19 @@ Special thanks to: Authors/Maintainers =================== -My address is (please read the section "Before you send email" below): +My email address is (please read the section "Before you send email" below): -crux@pool.informatik.rwth-aachen.de +bernds_cb1@t-online.de or, via snailmail Bernd Schmidt -21 St Stephen's Place -Cambridge CB3 0JE -UK +Toelzer Strasse 27a +81379 Muenchen +Germany Email is more likely to be answered, and will definitely be answered much -faster. Please avoid phonecalls if you can. +faster. I won't distribute software, neither PD or commercial. Don't send me floppy disks without at least asking first, you will not get them back. @@ -896,10 +927,8 @@ and the file FAQ contains about every pi try to help people who have questions, but sometimes it takes too much time. Please don't ask for Kickstart ROM files or other copyrighted software. Don't -_send_ me stuff like this either. If you want to send me something else which -is big (>= 50K), ask me before or put it somewhere in Webspace. This -university mail account has a limit on how big my mailbox can get before it -risks getting deleted without warning, and I don't enjoy that happening. +_send_ me stuff like this either. Don't send large attachments, at least not +without asking first. Oh, and another thing: If I promise to do things (like implement new features), and forget about them, pester me. That happens occasionally, it's