1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
ARAnyM (Atari Running on Any Machine)
version 0.9.0 released on 2005/04/14
1) License
----------
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Soft-
ware Foundation; either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the
Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston,
MA 02111-1307 USA
2) What is this?
----------------
ARAnyM is a multiplatform virtual machine (a software layer) for running Atari
ST/TT/Falcon TOS/GEM applications on any hardware with many host operating
systems. The reason for writing ARAnyM is to provide Atari power users with
faster and better machines. The ultimate goal is to create a new platform
where TOS/GEM applications could continue to live forever.
Features:
---------
o 68040 CPU (including MMU040)
o 68040 and 68881/2 FPU
o 14 MB ST-RAM and up to 3824 MB (configurable) of FastRAM
o VIDEL, Blitter, MFP, ACIA, IKBD for highest possible compatibility
o Sound (compatible with Atari XBIOS Sound subsystem, incl. TimerA DMA IRQ)
o Atari floppy DD/HD for connecting floppy image or real floppy drive
o two IDE channels for connecting disk images, harddrives or CD-ROMs
o extended keyboard and mouse support (including mouse wheel)
o direct access to host file system via BetaDOS and MiNT xfs drivers
o networking using ethernet emulation with a driver for MiNT-Net
o TOS 4.04, EmuTOS or Linux as the booting operating system
o runs with FreeMiNT, MagiC, and any other operating system that runs
also on real Atari computer.
o Native CD-ROM access (under Linux, other OS: audio CD only), without
scsi/ide/whatsoever emulation
Important: ARAnyM is not finished. Consider this to be a beta version
and a work-in-progress. Sorry for incomplete and confusing documentation.
Any help with programming/documentation/porting is very welcome!
3) Installing
-------------
See INSTALL file.
4) Configuring and running
--------------------------
See doc/documentation.txt
5) Keyboard shortcuts
---------------------
Keys not found on a PC keyboard:
--------------------------------
Atari Help key - mapped on the F11
Atari Undo key - mapped on the F12
Keys not found on Atari keyboard:
---------------------------------
Page Up key - mapped as Shift+Arrow Up (usual combination in GEM apps)
Page Down key - mappped as Shift+Arrow Down (usual combo in GEM apps)
Special keys:
-------------
Pause/Break - invoke SETUP GUI (ARAnyM on-the-fly configuration)
Shift+Pause - QUIT ARAnyM
Ctrl+Pause - REBOOT ARAnyM
Alt+Pause - enter integrated debugger (only if started with "-D")
PrintScreen - create a screenshot in actual directory
Alt+Ctrl+Esc - release the keyboard/mouse input focus so you can use
your keyboard and mouse in other host applications.
Scroll Lock - switch between windowed and fullscreen mode
10) Troubleshooting
------------------
If your Microsoft IntelliMouse doesn't work correctly on Linux framebuffer
console you may want to set the SDL_MOUSEDEV_IMPS2 environment variable to 1.
Example for bash: export SDL_MOUSEDEV_IMPS2=1; aranym
11) More information
--------------------
Read the NEWS file for user visible changes.
Read ChangeLog for internal changes.
Look at TODO if you want to help us.
Join our mailing list for ARAnyM users - the WEB interface for the list
is at http://bobek.sh.cvut.cz/cgi-bin/mailman/listinfo/aranym-user/
Visit http://aranym.atari.org/ for latest information and source code.
For developers we have a developer mailing list and a CVS server.
For details go to http://aranym.atari.org/
The "Power Without The Price" is back!
|
