← Back to branch summary

~drgeo-developers/drgeo/trunk

« back to all changes in this revision

Viewing changes to VMs/iPad/source/unix/vm-display-fbdev/00_README.fbdev

  • Committer: Hilaire Fernandes
  • Date: 2012-01-27 21:15:40 UTC
  • Revision ID: hilaire.fernandes@gmail.com-20120127211540-912spf97bhpx6mve
Initial additions

Show diffs side-by-side

added added

removed removed

Lines of Context:
VMs/iPad/source/unix/vm-display-fbdev/00_README.fbdev
 
1
0. WARNING
 
2
 
 
3
THIS IS BETA CODE!  It might work for you, it might not work for you,
 
4
it might cause Squeak to crash, it might put your machine into a state
 
5
where the keyboard and screen become *unusable*.
 
6
 
 
7
 
 
8
1. INTRO
 
9
 
 
10
This is a driver for Squeak running on the Linux framebuffer.
 
11
Graphics are displayed directly in the video memory, keyboard input is
 
12
taken from the console, and mouse input from the raw mouse device.
 
13
 
 
14
 
 
15
2. HARDWARE REQUIREMENTS
 
16
 
 
17
You will need a graphics card that provides a framebuffer interface
 
18
(which is by no means all of them).  If you see a penguin logo while
 
19
Linux is booting, or if your console font suddenly changes during
 
20
boot, then you have a framebuffer device.
 
21
 
 
22
Otherwise, check for one by running
 
23
 
 
24
        /usr/sbin/fbset
 
25
 
 
26
and if it says "/dev/fb0: no such device" then you don't have a
 
27
framebuffer device.  (This program can be used to set the framebuffer
 
28
depth before running Squeak.)
 
29
 
 
30
Otherwise there might be a module you can load: look in
 
31
/lib/modules/X.Y.Z/kernel/drivers/video for a file called "cardfb.o",
 
32
where "card" is the name of your graphics card.  If you find one, load
 
33
it (as root) like this:
 
34
 
 
35
        modprobe cardfb
 
36
 
 
37
The following configurations are known to work at all screen depths:
 
38
 
 
39
        arch    kernel  graphics card           os driver
 
40
        ----    ------  -------------           ---------
 
41
        PowerPC 2.4.20  ATI Radeon 9000 (M9)    radeonfb.o
 
42
        PowerPC 2.2.18  PowerMac Valkyrie       valkyriefb.o
 
43
        386     2.4.18  NeoMagic 256AV          neofb.o
 
44
 
 
45
 
 
46
3. SYSTEM REQUIREMENTS
 
47
 
 
48
To use this driver you must be logged in on the console with no window
 
49
system running.
 
50
 
 
51
You MUST have WRITE PERMISSION for the following devices:
 
52
 
 
53
  - the console
 
54
        this is either /dev/console or /dev/tty0 or the device
 
55
        reported by running the program "tty"
 
56
 
 
57
  - the framebuffer
 
58
        this is usually /dev/fb0
 
59
 
 
60
  - the mouse
 
61
        this is either /dev/psaux (if you have a real PS/2 mouse) or
 
62
        /dev/input/mice (which emulates PS/2 when you have some other
 
63
        kind of mouse)
 
64
 
 
65
In case of difficulty, the following might help:
 
66
 
 
67
        chmod a+rw /dev/tty* /dev/fb* /dev/psaux /dev/input/mice
 
68
 
 
69
although this will somewhat compromise the security of your machine.
 
70
 
 
71
Depending on your system you might also have to have ownership of the
 
72
above devices.  In extreme cases you might even have to run Squeak as
 
73
root to use this driver.
 
74
 
 
75
 
 
76
4. INVOCATION
 
77
 
 
78
You need to tell Squeak explicitly that you want to use the
 
79
framebuffer.  Either run Squeak with the '-vm-display-fbdev' option:
 
80
 
 
81
        squeak -vm-display-fbdev your.image
 
82
 
 
83
or set the variable SQUEAK_VM in your environment:
 
84
 
 
85
        export SQUEAK_VM=display-fbdev
 
86
 
 
87
 
 
88
5. RECOVERY
 
89
 
 
90
If the VM becomes unresponsive for any reason you will have no option
 
91
other than to log into your machine remotely and kill the VM.  If you
 
92
do this (or if the VM crashes) you will likely be left with the
 
93
keyboard and screen in an unusable state.  To recover from this, log
 
94
into the machine remotely and run
 
95
 
 
96
        kbd_mode -a
 
97
 
 
98
to restore the keyboard.  The screen is a little trickier; the most
 
99
reliable way to put it back into a sane state is to start the X server
 
100
 
 
101
        /usr/X11R6/bin/X :0
 
102
 
 
103
and then quit it by pressing Ctrl+Alt+Backspace.
 
104
 
 
105
 
 
106
6. MISSING
 
107
 
 
108
There is no rule number six.
 
109
 
 
110
 
 
111
7. LIABILITY
 
112
 
 
113
If this driver breaks your machine, you get to keep all the pieces.
 
114
 
 
115
 
 
116
8. CONTACTS
 
117
 
 
118
Please report bugs (and success stories) by email to: ian.piumarta@squeakland.org
 
119
 
 
120
Thanks!