ThinkWiki - User contributions [en]

S3 Savage IX8

2007-05-15T06:55:48Z

LtWorf: /* 3D Acceleration Quirks */ debian package

__NOTOC__
{| width="100%"
|style="vertical-align:top" |
<div style="margin: 0; margin-right:10px; border: 1px solid #dfdfdf; padding: 0em 1em 1em 1em; background-color:#F8F8FF; align:right;">
=== S3 Savage IX8 or IX8+===
This is a S3 video adapter 
S3 is now owned by Via Technologies

The IX8 and IX8+ chips share the same PCI-ID

=== Features ===
* Chipset: S3
* PCI ID: 5333:8c12
* AGP 2X
* 8MB SGRAM video memory
</div>
|style="vertical-align:top" |
|}

=== Linux X.Org driver ===
This chip is supported by the '[[savage]]' driver as part of the X.Org distribution.

==== ThinkPad LCD ====
Display on the internal LCD works as long as you set the monitor settings correctly. The driver does not appear
to support [DPMS] on the internal LCD, so it is necessary to make sure that horizontal sync and vertical refresh settings are included in the "Monitor" section of xorg.conf.

HorizSync 31.5 - 48.5
VertRefresh 50-70

==== External VGA port ====
Works. Fn-F7 switches between LCD and CRT. To use both, use [http://www.probo.com/timr/savage40.html s3switch] (on some models you need to run "'''s3switch lcd crt tv'''" even if you want only CRT and LCD, otherwise the CRT display is corrupted). You can also use [[ibm-acpi]] to control video output by echoing commands to /proc/acpi/ibm/video.

==== SVideo port ====
Works. Use [http://www.probo.com/timr/savage40.html s3switch] to change display output in software.

=== Linux kernel Framebuffer driver ===
This chip will work with either the 'vesa' or 'savagefb' driver as part of any recent 2.4 or 2.6 kernel.

==== Dual Monitor Tip ====
The chip supports using an external monitor plus the LCD as one big monitor. This can lead to a problem
if X is configured for this, but the external monitor has been detached. This creates a ghost monitor that you
cannot see, but can move the mouse onto and applications can open windows on.

Sometimes in this situation it's necessary to grab a window from the ghost monitor and drag it into view.
This can be done by moving the mouse onto the ghost screen and then holding down the ALT key, which allows you
to click-and-drag a window back into view. To see what is on the ghost monitor, a screen capture utility like
Ksnapshot can help you. When it takes a screenshot of the entire screen, it will show the contents of the ghost
screen, even though you can't see it directly.

=== Quirks ===
==== Power Management and savagefb ====
The savagefb appears to interfere with acpi sleep. (tested on 2.6 kernels up to 2.6.12) There are also some display problems with savagefb including limiting boot text to a 800x600 window centered in a 1024x768 display and problems with libdirectfb. For those reasons, vesafb is recommended as the framebuffer driver. 
The 800x600 boot-text problem can be resolved by altering the savagefb.c (pre-2.6.20) or savagefb_driver.c (2.6.20 and later) and then recompiling the Kernel or the respective module. To do that, open the savagefb_driver.c, for example under ''<Kernel Root>/drivers/video/savage'' in the 2.6.20 release. Now, locate the following function:
<pre>static struct fb_var_screeninfo __devinitdata savagefb_var800x600x8 = {
.accel_flags = FB_ACCELF_TEXT,
.xres = 800,
.yres = 600,
.xres_virtual = 800,
.yres_virtual = 600,
.bits_per_pixel = 8,
.pixclock = 25000,
.left_margin = 88,
.right_margin = 40,
.upper_margin = 23,
.lower_margin = 1,
.hsync_len = 128,
.vsync_len = 4,
.sync = FB_SYNC_HOR_HIGH_ACT | FB_SYNC_VERT_HIGH_ACT,
.vmode = FB_VMODE_NONINTERLACED
};</pre>

Alter the lines ''.xres'', ''.yres'', ''.xres_virtual'' and ''.yres_virtual'' to reflect your chosen resolution. Recompile and reinstall the Kernel, reboot or reload the module and the savagefb should use the new resolution.

==== Video-related System Lockups ====
Some quirks in the interactions between the OS and the Savage hardware can cause system lockups, especially due to high video load and 3D rendering operations. For a more complete description of this problem and the workarounds, see the [[Problem with video related system lockup]] page.

==== The Black 'X' (old X pointer) Problem ====
On some systems a black 'X' (which is actually the old default XFree86 pointer) appears frozen in the middle of the screen inside of X Windows. This problem can be remedied by setting

Option "SWCursor" "on"

in xorg.conf. Also see the [[Problem with black X]] page for more information.

==== 3D Acceleration Quirks ====
If 3D acceleration is not working on your system (after installing the DRM savage module), or 3D programs are exhibiting strange behavior, one of the following changes may fix the problem. First, most Savage chips do not have enough video memory to support 3D textures and acceleration with a frame buffer depth of 24 bits. Therefore, you may need to change "DefaultDepth 24" to "DefaultDepth 16" in the "Screen" section of xorg.conf (and of course provide the appropriate subsection for 16 bit depth if it is not present). Also, adding one of both of the following configuration options to the "Device" section of your xorg.conf may solve the video quirks (also explained in the [[Problem with video related system lockup|video related system lockup]] page)

Option "BusType" "PCI"
Option "DmaMode" "None"

On Debian based systems you need the package '''libgl1-mesa-dri''' to enable 3d acceleration. Deborphan may decide it is just a futile library, but that is false.

=== ThinkPads this chip may be found in ===
* {{A22e}}
* {{T20}}, {{T21}}, {{T22}}

[[Category:Components]]

Installing Ubuntu on a ThinkPad T20

2007-05-15T06:54:23Z

LtWorf: /* Video */

== Ubuntu 7.04, Feisty Fawn ==

Feisty reportedly [http://ubuntuforums.org/showthread.php?t=411498 works well on the T20].

Whether you install or upgrade, you will need to [[#Suspend_and_Hibernate_with_ACPI|force ACPI to be turned on]].

Video drivers seem to get installed correctly and Direct rendering seems to work automatically, even with the BIOS set to AGP. Desktop effects don't work. TORCS, ppracer and Actioncube work well.

The Belkin wireless adapter listed below does not seem to work "out of the box" with Feisty. It gets stuck on authenticating (at least with WEP).

Some of the other notes from below may apply.

== Ubuntu 6.10, Edgy Eft ==

=== Blank Screen when booting Live CD ===
There is an issue with the Savage driver which makes the initial boot into X hang.

1. Hit F6 on the boot menu, delete "quiet splash" from the boot parameter line, and add "break=bottom".

2. After a while you will get a prompt (initramfs), type "chroot /root nano -w /etc/X11/xorg.conf".

3. Find your video card, and change driver "savage" to "vesa".

4. Save (ctrl+w), exit nano (ctrl+x), then press ctrl+d.

5. After that the live cd will work

Howto with screenshots [https://wiki.ubuntu.com/EdgyKnownIssues/59618 Ubuntu Wiki]

=== Using APM to Suspend ===

To enable APM when booting the Live/Install CD, add these boot options:

`noacpi acpi=off apm=on`

After booting, `Fn-F4` will still only put the command in a standby state, but
using `apm --suspend` on the command line will successfully suspend machine, and it resumes as well.

Another user reports that APM leads to a unsuccessful shutdown, hanging on the last splash screen.

=== Suspend and Hibernate with ACPI ===

ACPI is a newer and preferred alternative to APM. On the T20 it necessary to force the use of ACPI, using
the following instructions.

gksudo gedit /boot/grub/menu.lst

Look for an uncommented line starting with "kernel" and add "acpi=force" to the end of the line. There should be
a "title" line above describing the default kernel that usually boots. Making the change for just the default kernel should be sufficient.

Once the file has been re-saved, you can re-install the bootloader. The command for that is:

sudo grub-install /dev/hda

'''NOTE''': This assumes your hard drive is at /dev/hda. Use "df" to see your hard drive names if you are not sure.
This operation can potentially make your computer unbootable if there are mistakes, so be careful! (Of course, even if the hard drive became unbootable, you could most likely boot off a CD and fix it. )

==== Fixing Sound-After-Suspend ====

Sound doesn't work after a suspend/resume cycle without some help. This is due to [https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+bug/11149 a bug in the sound card driver]. Until that's fixed, a workaround is available.

Install the files available here:

https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+bug/11149/comments/6
https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+bug/11149/comments/7

They automatically kill all sound applications when resuming, and then restart them. Be sure to save
your playlists, etc, before you suspend!

In `/etc/default/acpi-support` adjust the following values:

MODULES="sb uart401 sound soundcore maestro cs4281 snd-cs46xx"
RESTART_IRDA=true
RESTORE_SOUND=true

==== Suspend while using the LiveCD ====

''ACPI Suspend does not work on the LiveCD. `gnome-power-manager` logs to `/var/log/messages` that is beginning to suspend, but nothing happens. This looks like it might be a [https://launchpad.net/distros/ubuntu/+source/linux-source-2.6.15/+bug/50031 known bug] in Ubuntu.''

==== Getting rid of the password upon resuming ====

If you don't want the password prompt when resuming, Use "Alt-F2" to open the run box
and type `gconf-editor`. Navigate to "apps / gnome-power-manager ". Browse the options that start with "lock". Each has a description to read. While it's possible to directly disable the password prompt here, consider setting `lock_use_screensaver_settings`. Then, you can control the option through "System : Preferences : Screensaver", and you won't have to use gconf-editor in the future.

=== Special Key Support ===

The light and brightness keys work as expected. The volume keys have some on-screen visuals that automatically
appear to illustrate them, using graphics that match the curren theme. Rather nice!

=== Video ===

Direct rendering / GL acceleration works. Use "PCI" in BIOS rather than AGP. I removed all modes apart from 1024x768. ppracer plays well at c. 10fps with all the eye candy on.

Driver "savage" 
BusID "PCI:1:0:0" 
Option "SWCursor" "on" 
Option "ShadowStatus" "on" 
Option "DMAMode" "Vertex" 
Option "DmaType" "PCI" 
Option "BusType" "PCI" 
 
HorizSync 28-51 
VertRefresh 43-60 

Have to set DefaultColorDepth to 16 in section Screen, otherwise, the memory card won't have enough memory to do acceleration.

Make sure the package libgl1-mesa-dri is installed. Deborphan may decide it is just a futile library, but that is false.

=== Wireless ===

Ubuntu has a great wireless networking tool that is not installed by default.

sudo apt-get install network-manager network-manager-gnome

To launch the applet: Alt-F2 and then 'nm-applet'.

A networking applet should appear that you can click on to browse wireless networks and connect to them.

You may also want install "network-manager-pptp" which is a plugin for the system which makes it easy
to connect to PPTP-based VPN networks.

==== Confirmed compatible wireless cards ====

The Orinico Gold card works great with no configuration at all. They may be sold branded as
Lucent or 2wire. These cards can be found for around US $30. Be aware that they may support WEP
but not WPA, which is considered more secure and required in some cases.

Belkin f5d7050 Wireless 802.11g USB adaptor (version 3) works (plugged into dock's lower USB port). The procedure is essentially install the ndiswrapper-1.8 and work through https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide.=

=== DVDs ===

DVDs play great once you've installed all the missing multimedia plugins. (work through https://help.ubuntu.com/community/MultimediaApplications and the links to freeformats and restrictedformats pages).

=== Sound ===

Processor frequency scaling causes interruptions in sound output. To avoid this, disable scaling by removing the service powernowd (System > Administration > Service ...). This may reduce your run time on battery as a trade-off.

If sound appears disorted after resuming, check your mixer settings. From the volume icon in the dock, you can right click and select "Open Volume Control". Check if "PCM" is all the way up. Turn it down some to reduce the distortion.

=== Software memory requirements ===

Here are some test results from trying software with Ubuntu on this model.

*OpenOffice - OK with 128Mb
*Eclipse - 128Mb is not enough, 384Mb is OK

== Ubuntu 6.06 LTS, Dapper Drake ==

When booting the Live/Install CD, adjust the boot options to add the following:

`noacpi acpi=off apm=on`

Sometimes the CD may stall on boot with a blank black screen. Trying again with "Safe Graphics"
mode may help, but is no guarantee to work. Best way it to follow the same procedure as for 6.10, ie
use the alternate install CD.

Once booted, suspend and resume using Fn-F4 was successfully tested running from the LiveCD.
However, in at least a couple of cases, the Live CD froze at seemingly random points shortly
after resuming.

''Results from a complete install still need to be documented.''

== See Also ==

Because the models are very similar, [[Installing Ubuntu on a ThinkPad T21]] may also be helpful.

== External Resources ==

*[http://del.icio.us/tags/ubuntu+t20 Bookmarks tagged with Ubuntu and T20] on del.icio.us
*[http://ubuntuforums.org/tags/index.php/t20/ Forum posts tagged with T20] on ubuntuforums.org

{{Ubuntu}} {{T20}}

Installing Ubuntu on a ThinkPad T20

2007-05-15T06:52:58Z

LtWorf: /* Video */ libgl1-mesa-dri package must be installed

== Ubuntu 7.04, Feisty Fawn ==

Feisty reportedly [http://ubuntuforums.org/showthread.php?t=411498 works well on the T20].

Whether you install or upgrade, you will need to [[#Suspend_and_Hibernate_with_ACPI|force ACPI to be turned on]].

Video drivers seem to get installed correctly and Direct rendering seems to work automatically, even with the BIOS set to AGP. Desktop effects don't work. TORCS, ppracer and Actioncube work well.

The Belkin wireless adapter listed below does not seem to work "out of the box" with Feisty. It gets stuck on authenticating (at least with WEP).

Some of the other notes from below may apply.

== Ubuntu 6.10, Edgy Eft ==

=== Blank Screen when booting Live CD ===
There is an issue with the Savage driver which makes the initial boot into X hang.

1. Hit F6 on the boot menu, delete "quiet splash" from the boot parameter line, and add "break=bottom".

2. After a while you will get a prompt (initramfs), type "chroot /root nano -w /etc/X11/xorg.conf".

3. Find your video card, and change driver "savage" to "vesa".

4. Save (ctrl+w), exit nano (ctrl+x), then press ctrl+d.

5. After that the live cd will work

Howto with screenshots [https://wiki.ubuntu.com/EdgyKnownIssues/59618 Ubuntu Wiki]

=== Using APM to Suspend ===

To enable APM when booting the Live/Install CD, add these boot options:

`noacpi acpi=off apm=on`

After booting, `Fn-F4` will still only put the command in a standby state, but
using `apm --suspend` on the command line will successfully suspend machine, and it resumes as well.

Another user reports that APM leads to a unsuccessful shutdown, hanging on the last splash screen.

=== Suspend and Hibernate with ACPI ===

ACPI is a newer and preferred alternative to APM. On the T20 it necessary to force the use of ACPI, using
the following instructions.

gksudo gedit /boot/grub/menu.lst

Look for an uncommented line starting with "kernel" and add "acpi=force" to the end of the line. There should be
a "title" line above describing the default kernel that usually boots. Making the change for just the default kernel should be sufficient.

Once the file has been re-saved, you can re-install the bootloader. The command for that is:

sudo grub-install /dev/hda

'''NOTE''': This assumes your hard drive is at /dev/hda. Use "df" to see your hard drive names if you are not sure.
This operation can potentially make your computer unbootable if there are mistakes, so be careful! (Of course, even if the hard drive became unbootable, you could most likely boot off a CD and fix it. )

==== Fixing Sound-After-Suspend ====

Sound doesn't work after a suspend/resume cycle without some help. This is due to [https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+bug/11149 a bug in the sound card driver]. Until that's fixed, a workaround is available.

Install the files available here:

https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+bug/11149/comments/6
https://bugs.launchpad.net/ubuntu/+source/linux-source-2.6.20/+bug/11149/comments/7

They automatically kill all sound applications when resuming, and then restart them. Be sure to save
your playlists, etc, before you suspend!

In `/etc/default/acpi-support` adjust the following values:

MODULES="sb uart401 sound soundcore maestro cs4281 snd-cs46xx"
RESTART_IRDA=true
RESTORE_SOUND=true

==== Suspend while using the LiveCD ====

''ACPI Suspend does not work on the LiveCD. `gnome-power-manager` logs to `/var/log/messages` that is beginning to suspend, but nothing happens. This looks like it might be a [https://launchpad.net/distros/ubuntu/+source/linux-source-2.6.15/+bug/50031 known bug] in Ubuntu.''

==== Getting rid of the password upon resuming ====

If you don't want the password prompt when resuming, Use "Alt-F2" to open the run box
and type `gconf-editor`. Navigate to "apps / gnome-power-manager ". Browse the options that start with "lock". Each has a description to read. While it's possible to directly disable the password prompt here, consider setting `lock_use_screensaver_settings`. Then, you can control the option through "System : Preferences : Screensaver", and you won't have to use gconf-editor in the future.

=== Special Key Support ===

The light and brightness keys work as expected. The volume keys have some on-screen visuals that automatically
appear to illustrate them, using graphics that match the curren theme. Rather nice!

=== Video ===

Direct rendering / GL acceleration works. Use "PCI" in BIOS rather than AGP. I removed all modes apart from 1024x768. ppracer plays well at c. 10fps with all the eye candy on.

Driver "savage" 
BusID "PCI:1:0:0" 
Option "SWCursor" "on" 
Option "ShadowStatus" "on" 
Option "DMAMode" "Vertex" 
Option "DmaType" "PCI" 
Option "BusType" "PCI" 
 
HorizSync 28-51 
VertRefresh 43-60 

Have to set DefaultColorDepth to 16 in section Screen, otherwise, the memory card won't have enough memory to do acceleration.
Make sure the package libgl1-mesa-dri is installed. Deborphan may decide it is just a futile library, but that is false.

=== Wireless ===

Ubuntu has a great wireless networking tool that is not installed by default.

sudo apt-get install network-manager network-manager-gnome

To launch the applet: Alt-F2 and then 'nm-applet'.

A networking applet should appear that you can click on to browse wireless networks and connect to them.

You may also want install "network-manager-pptp" which is a plugin for the system which makes it easy
to connect to PPTP-based VPN networks.

==== Confirmed compatible wireless cards ====

The Orinico Gold card works great with no configuration at all. They may be sold branded as
Lucent or 2wire. These cards can be found for around US $30. Be aware that they may support WEP
but not WPA, which is considered more secure and required in some cases.

Belkin f5d7050 Wireless 802.11g USB adaptor (version 3) works (plugged into dock's lower USB port). The procedure is essentially install the ndiswrapper-1.8 and work through https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide.=

=== DVDs ===

DVDs play great once you've installed all the missing multimedia plugins. (work through https://help.ubuntu.com/community/MultimediaApplications and the links to freeformats and restrictedformats pages).

=== Sound ===

Processor frequency scaling causes interruptions in sound output. To avoid this, disable scaling by removing the service powernowd (System > Administration > Service ...). This may reduce your run time on battery as a trade-off.

If sound appears disorted after resuming, check your mixer settings. From the volume icon in the dock, you can right click and select "Open Volume Control". Check if "PCM" is all the way up. Turn it down some to reduce the distortion.

=== Software memory requirements ===

Here are some test results from trying software with Ubuntu on this model.

*OpenOffice - OK with 128Mb
*Eclipse - 128Mb is not enough, 384Mb is OK

== Ubuntu 6.06 LTS, Dapper Drake ==

When booting the Live/Install CD, adjust the boot options to add the following:

`noacpi acpi=off apm=on`

Sometimes the CD may stall on boot with a blank black screen. Trying again with "Safe Graphics"
mode may help, but is no guarantee to work. Best way it to follow the same procedure as for 6.10, ie
use the alternate install CD.

Once booted, suspend and resume using Fn-F4 was successfully tested running from the LiveCD.
However, in at least a couple of cases, the Live CD froze at seemingly random points shortly
after resuming.

''Results from a complete install still need to be documented.''

== See Also ==

Because the models are very similar, [[Installing Ubuntu on a ThinkPad T21]] may also be helpful.

== External Resources ==

*[http://del.icio.us/tags/ubuntu+t20 Bookmarks tagged with Ubuntu and T20] on del.icio.us
*[http://ubuntuforums.org/tags/index.php/t20/ Forum posts tagged with T20] on ubuntuforums.org

{{Ubuntu}} {{T20}}

Installing Ubuntu on a ThinkPad T20

2007-02-13T14:45:26Z

LtWorf: /* Video */

== Ubuntu 6.10, Edgy Eft ==

=== Blank Screen when booting Live CD ===
As described in [[Installing Ubuntu on a Thinkpad T21]], there is an issue with the Savage driver which makes the initial boot into X hit and miss.

You can avoid this problem by using the alternate install CD. However, that doesn't allow you to
do any pre-installation evaluation of the GUI that the Live/Install CD provides.

=== Using APM to Suspend ===

To enable APM when booting the Live/Install CD, add these boot options:

`noacpi acpi=off apm=on`

After booting, `Fn-F4` will still only put the command in a standby state, but
using `apm --suspend` on the command line will successfully suspend machine, and it resumes as well.

=== Trying to Suspend with ACPI ===

A alternative to APM is ACPI. It is newer and more advanced, and preferred when it works. However, even with the newest BIOS (1.22) isntalled in the T20, Linux will still recognize the BIOS as "too old" and will disable ACPI. You can override this by adding this boot option: `acpi=force`.

Assuming you actually have Ubuntu installed (i.e., not running from Live CD) To add this boot option, open /boot/grub/menu.lst and look for the line(s) (there will be one for each boot menu choice) similar to:

kernel /boot/vmlinuz-2.6.17-10-386 root=UUID=1a2b3c4d-5e6f-1234-7a8b-1a2b3c4d5e6f ro

(n.b., I've obscured the UUID hex string above).

and add acpi=force to the lines you wish to change (i.e., the choices you want ACPI enabled for, though you probably only want to add to the line corresponding to the option for normal boot, not the recovery boot options).

N.B. *** READ THIS ***. Before running the grub-install line *at your own risk* below, make sure you know what you're doing (i.e., have read the grub documentation) and that /dev/hda *is* your boot drive otherwise you may render your system unbootable. Obviously if you're not using grub then this won't work.

Now run: grub-install /dev/hda

With this enabled suspend and resume works OK with the following caveats:

1. Weird errors seem to get output on resume.
2. Sometimes the machine will randomly enter suspend mode. This may be a setting in power manager that I've got set wrong or due to LCD screen wobble (suspend activates on lid close, resumes on lid open). The power manager help indicates how to set advanced gconf settings. There are also files in /etc/modprobe.d and /etc/acpi for further machine-specific configuration (TODO: investigate and post results here).

Even this option, once booted into the LiveCD, suspend still does not work. `gnome-power-manager` logs
to `/var/log/messages` that is beginning to suspend, but nothing happens. This looks like it might
be a [https://launchpad.net/distros/ubuntu/+source/linux-source-2.6.15/+bug/50031 known bug] in Ubuntu.

=== Special Key Support ===

The light and brightness keys work as expected. The volume keys have some on-screen visuals that automatically
appear to illustrate them, using graphics that match the curren theme. Rather nice!

=== Video ===

Direct rendering / GL acceleration works. Use "PCI" in BIOS rather than AGP. I removed all modes apart from 1024x768. ppracer plays well at c. 10fps with all the eye candy on.

Driver "savage" 
BusID "PCI:1:0:0" 
Option "SWCursor" "on" 
Option "ShadowStatus" "on" 
Option "DMAMode" "Vertex" 
Option "DmaType" "PCI" 
Option "BusType" "PCI" 
 
HorizSync 28-51 
VertRefresh 43-60 

Have to set DefaultColorDepth to 16 in section Screen, otherwise, the memory card won't have enough memory to do acceleration.

=== Confirmed compatible wireless cards ===

Belkin f5d7050 Wireless 802.11g USB adaptor (version 3) works (plugged into dock's lower USB port). The procedure is essentially install the ndiswrapper-1.8 and work through https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide.=

=== DVDs ===

DVDs play great once you've installed all the missing multimedia plugins. (work through https://help.ubuntu.com/community/MultimediaApplications and the linked to freeformats and restrictedformats pages).

=== Working software (or not) ===

One thing I find frustrating is that often it's difficult to know in advance which software requires too much memory / cpu or has GL problems (e.g., the infamous visual 0x42 error). At the risk of this lengthening this page somewhat here's a small list to start with.

==== With 128Mb ====

OpenOffice OK
Eclipse needs more RAM

==== With 384Mb ====

Eclipse OK

== Ubuntu 6.06 LTS, Dapper Drake ==

When booting the Live/Install CD, adjust the boot options to add the following:

`noacpi acpi=off apm=on`

Sometimes the CD may stall on boot with a blank black screen. Trying again with "Safe Graphics"
mode may help. (Or prehaps this is the same X issue with the Edgy Live CD, and it is simply trying again that helps).

Once booted, suspend and resume using Fn-F4 was successfully tested running from the LiveCD.
However, in at least a couple of cases, the Live CD froze at seemingly random points shortly
after resuming.

''Results from a complete install still need to be documented.''

== See Also ==

Because the models are very similar, [[Installing Ubuntu on a ThinkPad T21]] may also be helpful.

== External Resources ==

*[http://del.icio.us/tags/ubuntu+t20 Bookmarks tagged with Ubuntu and T20] on del.icio.us
*[http://ubuntuforums.org/tags/index.php/t20/ Forum posts tagged with T20] on ubuntuforums.org

{{Ubuntu}} {{T20}}

How to configure the TrackPoint

2006-12-03T12:30:38Z

LtWorf: /* Press to Select */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
|style="vertical-align:top" |The [[Patch to enable advanced trackpoint configuration|kernel trackpoint driver]] is controlled by echoing values to special files. Common configuration options are outlined below.
{{NOTE|
*Starting from 2.6.13 config files for this driver are located in <tt>/sys/devices/platform/i8042/serio0/serio2</tt>. (This document uses the new locations.)
*From 2.6.11 on, they are in <tt>/sys/devices/platform/i8042/serio0</tt>.
*Prior to kernel 2.6.11, these files were located in <tt>/proc/trackpoint</tt>.
*Prior to kernel 2.6.9, these files were not files at all, but were command-line options to the psmouse module. (Note this means you must compile psmouse as a module!) See http://stephen.evanchik.com/node/16.
}}
|}

==General Configuration==
The configuration options are reflected by the files you can find in {{path|/sys/devices/platform/i8042/serio0/serio2}}. See the [[Patch to enable advanced trackpoint configuration|TrackPoint driver page]] for a complete list.
Configuration is done by echoing the appropriate values into these special files.

==Most common Features==
The most common settings are '''Press to Select''', '''sensitivity''', '''speed''' and '''scrolling'''.

===Press to Select===
Press to Select allows you to tap the control stick which will simulate a left click. You can enable this feature by typing the following in to a terminal (you may need to be root):

:{{cmdroot|echo -n 1 > /sys/devices/platform/i8042/serio0/press_to_select}}

Press to Select should now be enabled. You can disable it in a similar manner:

:{{cmdroot|echo -n 0 > /sys/devices/platform/i8042/serio0/press_to_select}}

You can use this script to automate the operation

#!/bin/bash
if [ "$1" = "1" ]; then
echo "Turning on tap on TrackPoint"
echo -n 1 > /sys/devices/platform/i8042/serio0/press_to_select
exit 0
fi
if [ "$1" = "0" ]; then
echo "Turning off tap on TrackPoint"
echo -n 0 > /sys/devices/platform/i8042/serio0/press_to_select
exit 0
fi
echo -n "Tap status: "
cat /sys/devices/platform/i8042/serio0/press_to_select

===Sensitivity & Speed===
Adjusting the speed and sensitivity of the TrackPoint requires echoing a value between 0 and 255 into the appropriate file. For example, for a speed of 120 and a sensitivity of 250, type the following into a terminal:

:{{cmdroot|echo -n 120 > /sys/devices/platform/i8042/serio0/serio2/speed}}
:{{cmdroot|echo -n 250 > /sys/devices/platform/i8042/serio0/serio2/sensitivity}}

Feel free to experiment with your settings until you find a combination that is comfortable.

When you satisfy your setting , add the two lines into /etc/rc.d/rc.local in order to avoid restoring the default setting every time the system reboots.

===Scrolling===
====Using a kernel prior to 2.6.11====
The scrolling action is essentially the same as is used in the TrackPoint Windows drivers. To enable this feature, type the following in to a terminal (you may need to be root):

:{{cmdroot|echo -n 1 > /proc/trackpoint/scroll}}

Then press the middle button and push the stick up and down to scroll. Similarly, to disable scrolling:

:{{cmdroot|echo -n 0 > /proc/trackpoint/scroll}}

====Using the X server (kernel 2.6.11+)====
The scroll setting has been removed from the trackpoint driver in kernel versions 2.6.11 and above. Scroll emulation should now be handled in the X server.

The necessary functionality, known as "EmulateWheelTimeout" allowing to use button 2 for a middle click, wasn't implemented in Xorg prior to 6.9/7.0. However, there was a patch included in most distributions packages of Xorg, which was announced [http://www.mail-archive.com/devel@xfree86.org/msg03333.html here]. You can find an updated version of the package in the experimental branch of {{Debian}} or try to build the mouse driver yourself with the information in the announcement. This has successfully been tried with FC3's 6.8.2 packages.

Once this functionality is in the X.org, add these lines to your TrackPoint configuration section in {{path|/etc/X11/xorg.conf}}:

Option "EmulateWheel" "on"
Option "EmulateWheelButton" "2"

It may also be necessary to add these lines:

Option "YAxisMapping" "4 5"
Option "XAxisMapping" "6 7"

which specify which buttons are mapped to motion in the vertical (Y) and horizontal (X) directions, respectively, in wheel emulation mode (see http://www.xfree86.org/current/mouse.4.html).

{{HINT| Use the program "xev" to see, what mouse button identifiers are sent by your mouse/touchpad/trackpoint.}}

So, a complete mouse section, that implements this nicely and works very well on my R51, even with a simultanously connected USB mouse, looks like that (tried out today, 20th of September, 2006 on Dapper):

Section "InputDevice"
Identifier "Configured Mouse"
Driver "mouse"
Option "CorePointer"
Option "Device" "/dev/input/mice"
Option "Protocol" "ExplorerPS/2"
Option "Emulate3Buttons" "on"
Option "Emulate3TimeOut" "50"
Option "EmulateWheel" "on"
Option "EmulateWheelTimeOut" "200"
Option "EmulateWheelButton" "2"
Option "YAxisMapping" "4 5"
Option "XAxisMapping" "6 7"
Option "ZAxisMapping" "4 5"
EndSection

I don't really understand at the moment why it works with the same mappings for X and Z, but I thought you got to know! :)

Now restart X and hold down button 2 and move the mouse to scroll, or just press and release button 2 for a middle click.

{{NOTE| With the above mouse section in my xorg.conf all this works like a charm:
*I can press the wheel on my external USB mouse and move the mouse up and down for scrolling
*or I can just use the wheel on the external mouse for scrolling
*or pressing the MMB button of the trackpoint and use the trackpoint for scrolling.
*Even horizontal scrolling works automagically in Konqueror, for Firefox/Opera see below.

Simultanously I can use
*a press on the external mouse's wheel
*or the MMB of the trackpoint

for pasting the buffer. Lovely! :) }}

===== EmulateWheelTimeout temporarily broken (-> fix for Ubuntu Dapper) =====

Unfortunately, there was a regression so that EmulateWheelTimeout was broken in X.org 6.9.0, and fixed
on March 20th, 2006.
You can see the [https://bugs.freedesktop.org/show_bug.cgi?id=5071 primary bug report] here, and also reports on the [http://qa.mandriva.com/show_bug.cgi?id=21196 Mandriva] and [http://lists.debian.org/debian-x/2006/01/msg00249.html Debian] ([http://bugs.debian.org/346098 #346098], [http://bugs.debian.org/320136 #320136]) packages.

Unfortunately, this bug is still present in Ubuntu Dapper Drake's xserver-xorg-input-mouse package (version 1.0.3.1+cvs.20060109-0ubuntu1)!

{{HINT|xserver-xorg-input-mouse (version 1.0.3.1+cvs.20060109-0ubuntu1.1) is in dapper-updates since July 3rd, 2006. You don't need to patch it anymore.}}

Use the following procedure to make it (middle button scrolling & middle button pasting) work:

:{{cmduser|cd /desired/path && mkdir tmp && cd tmp}} (create temporary directory somewhere)
:{{cmduser|sudo nano /etc/apt/sources.list}} (insert/uncomment the deb-src lines, save and exit)
:{{cmduser|sudo apt-get update}}
:{{cmduser|apt-get source xserver-xorg-input-mice}} (in order to get the source code)
:{{cmduser|sudo aptitude install xserver-xorg-dev}} (this package and the packages it depends on are needed in order to compile the source code, use aptitude for easy removal later on)
:{{cmduser|cd xserver-xorg-input-mouse-1.0.3.1+cvs.20060109/}}
:{{cmduser|wget http://librarian.launchpad.net/2639933/xserver-xorg-input-mouse_1.0.3.1+cvs.20060109-0ubuntu2.debdiff}} (downloads the patch that fixes the bug)
:{{cmduser|patch -p1 < xserver-xorg-input-mouse_1.0.3.1+cvs.20060109-0ubuntu2.debdiff}} (applies the bug fix)
:{{cmduser|fakeroot dpkg-buildpackage}} (rebuilds the package... watch out for errors and install other missing packages)
:{{cmduser|sudo dpkg -i ../xserver-xorg-input-mouse_1.0.3.1+cvs.20060109-0ubuntu2_i386.deb}} (installs the rebuilt built package)
:{{cmduser|sudo aptitude remove xserver-xorg-dev}} (removes the packages needed to rebuild the package)

Hope it works for you, it did work for me!
CrypTom

===== Older versions of X.org =====

For older versions of Xorg or for Xfree86 ({{path|/etc/X11/XF86Config}}) try this:

Option "Emulate3Buttons" "true"
Option "EmulateWheel" "true"
Option "EmulateWheelButton" "2"

Now restart X and hold down button two and move the mouse for scrolling. To get a middle click, press buttons 1 and 3 simultaneously.

==Soft Transparent Mode==
If you wish to connect a special device to the external PS/2 port, you should consider using "Soft Transparent Mode" so that the TrackPoint controller does not interpret any commands sent to the external PS/2 port. You can enable soft transparent mode by typing the following in to a terminal:

:{{cmdroot|echo -n 1 > /sys/devices/platform/i8042/serio0/serio2/transparent}}

Disabling soft transparent mode is similar:

:{{cmdroot|echo -n 0 > /sys/devices/platform/i8042/serio0/serio2/transparent}}

==Modify trackpoint parameter permanently in trackpoint.h==
If you do not want to run a script to reconfigure the trackpoint
you can change the default settings in the trackpoint header file that is located in
/usr/src/<KERNEL_VERSION>/drivers/input/mouse/trackpoint.h.

First you must convert the values (decimal numbers) you normaly echo to /sys/[...] to hex:

'''echo -e 'obase=16;<DECIMAL_NUMBER>' | bc'''

Then simply replace the default hex values in trackpoint.h, run 'make && make modules_install' to recompile and install psmouse.ko (should be compiled as module)

Example patch (speed=100, sensitivity=190, press_to_select=1):
<pre>
--- trackpoint.h.orig 2006-01-17 16:18:30.000000000 +0100
+++ trackpoint.h 2006-01-17 16:25:47.000000000 +0100
@@ -108,9 +108,9 @@
/*
* Default power on values
*/
-#define TP_DEF_SENS 0x80
+#define TP_DEF_SENS 0xBE
#define TP_DEF_INERTIA 0x06
-#define TP_DEF_SPEED 0x61
+#define TP_DEF_SPEED 0x64
#define TP_DEF_REACH 0x0A

#define TP_DEF_DRAGHYS 0xFF
@@ -123,7 +123,7 @@

/* Toggles */
#define TP_DEF_MB 0x00
-#define TP_DEF_PTSON 0x00
+#define TP_DEF_PTSON 0x01
#define TP_DEF_SKIPBACK 0x00
#define TP_DEF_EXT_DEV 0x01
</pre>

==Configure firefox for using trackpoint horizontal scrolling==
Vertical Scrolling seems to work out of the box in firefox if you followed the steps above.
Anyway, there is a problem when you doesnt scroll exactly vertical, because horizontal scrolling turns into
browser BACK/FORWARD commands.
You can avoid this by typing about:config + ENTER in the address bar of firefox.
You have to adjust the following options:

<pre>
mousewheel.horizscroll.withcontrolkey.action = 3;
mousewheel.horizscroll.withcontrolkey.numlines = 1;
mousewheel.horizscroll.withcontrolkey.sysnumlines = true;

mousewheel.horizscroll.withnokey.action = 0;
mousewheel.horizscroll.withnokey.numlines = 1;
mousewheel.horizscroll.withnokey.sysnumlines = true;

mousewheel.horizscroll.withshiftkey.action = 1;
mousewheel.horizscroll.withshiftkey.numlines = 1;
mousewheel.horizscroll.withshiftkey.sysnumlines = true;
</pre>

==Configure Opera for using trackpoint horizontal scrolling==
You'll experience the same annoying problem with the popular browser Opera. To fix this you need to edit the configfile <tt>/usr/share/opera/ini/standard_mouse.ini</tt> and comment the following lines out
<pre>
Button6 = Back
Button7 = Forward
</pre>
so they look something like that
<pre>
;Button6 = Back
;Button7 = Forward
</pre>
Remember, Button6 and Button7 do not so coincidental correspond with our X configuration we know from above:
<pre>
Option "YAxisMapping" "6 7"
</pre>