Installing Fedora Core 5 on a ThinkPad X41 Tablet

2006-06-22T17:16:16Z

Prschaffner: /* Fingerprint Reader */

== Success Chart ==

{| border="1" cellpadding="5" cellspacing="0"
|-
|colspan=2| '''Item''' || '''Working''' || '''Notes'''
|-
|rowspan=2|Installation
| Network Installation ||class="diff-addedline"| Yes ||
|-
| USB Installation ||class="diff-addedline"| Yes (DVD) ||
|-
|rowspan=4|Display
| Laptop Screen ||class="diff-addedline"| Yes || X.org i810 driver
|-
| CRT / Projector ||class="diff-addedline"| Yes ||
|-
| Screen Rotation ||class="diff-addedline"| Yes ||
|-
| Stylus ||class="diff-addedline"| Yes || wacom serial driver.
|-
|rowspan=2|Power Management
| Software Suspend (hibernate) ||class="diff-addedline"| Yes || [[Software Suspend 2]]
|-
| Suspend to Memory (ACPI sleep) ||class="diff-addedline"| Yes (mostly) || [[Software Suspend 2]], occasional blank screen
|-
|colspan=2| Audio ||class="diff-addedline"| Yes || ALSA intel8x0 driver
|-
|rowspan=2| Wireless || 802.11b/g ||class="diff-addedline"| Yes || ipw2200/madwifi drivers
|-
| Bluetooth ||class="diff-context"| Not Tested (should work) || See [[Installing_Fedora_Core_4_on_a_ThinkPad_X41_Tablet#Bluetooth|Bluetooth on Fedora Core 4]]
|-
|rowspan=2|Extra Buttons || Keyboard Section ||class="diff-addedline"| Yes || ibm-acpi driver
|-
| Tablet buttons ||class="diff-addedline"| Yes || setkeycodes
|-
|colspan=2| Fingerprint Scanner ||class="diff-addedline"| Yes || bioapi
|-
|colspan=2| Harddisk Active Protection ||class="diff-addedline"| Yes || kernel 2.6.16, hdapsd
|}

== Installation ==

Installation is straight forward and identical to the Fedora Core 4 installation process mentioned [[Installing Fedora Core 4 on a ThinkPad X41 Tablet#Installation|here]].

== Configuration ==

=== X Server ===

==== Enabling the Stylus ====

Add the following lines to {{path|/etc/rc.d/rc.local}}:
<br><i>(Note: You will need to be root to perform these two edits)</i>
# Map stylus to a serial port
setserial /dev/ttyS0 port 0x0200 irq 5 autoconfig

Add the lines in bold font to {{path|/etc/X11/xorg.conf}}:

Section "ServerLayout"
Identifier "default"
Screen 0 "Screen0" 0 0
InputDevice "Mouse0" "CorePointer"
InputDevice "Keyboard0" "CoreKeyboard"
'''InputDevice "cursor" "SendCoreEvents"'''
'''InputDevice "stylus" "SendCoreEvents"'''
EndSection

'''Section "InputDevice"'''
'''Driver "wacom"'''
'''Identifier "cursor"'''
'''Option "Device" "/dev/ttyS0"'''
'''Option "Type" "cursor"'''
'''Option "ForceDevice" "ISDV4"'''
'''Option "Mode" "Absolute"'''
'''Option "TPCButton" "on"'''
'''EndSection'''

'''Section "InputDevice"'''
'''Driver "wacom"'''
'''Identifier "stylus"'''
'''Option "Device" "/dev/ttyS0"'''
'''Option "Type" "stylus"'''
'''Option "ForceDevice" "ISDV4"'''
'''EndSection'''

==== Enabling Screen Rotation ====

Download and install the updated X server and drivers as follows:

{{cmdroot|wget http://www.cs.cornell.edu/~saikat/xorg-x11-drv-i810-1.6.0-1.i386.rpm}}
{{cmdroot|wget http://www.cs.cornell.edu/~saikat/xorg-x11-server-Xorg-1.0.99.901-5.i386.rpm}}
{{cmdroot|wget http://www.cs.cornell.edu/~saikat/linuxwacom-0.7.2-3.i386.rpm}}
{{cmdroot|yum localinstall xorg-x11-drv-i810-1.6.0-1.i386.rpm xorg-x11-server-Xorg-1.0.99.901-5.i386.rpm linuxwacom-0.7.2-3.i386.rpm}}
{{HINT|'''Update:''' If you have issues using yum to install the RPM's, try:<br> rpm -Uvh xorg-x11-drv-i810-1.6.0-1.i386.rpm xorg-x11-server-Xorg-1.0.99.901-5.i386.rpm linuxwacom-0.7.2-3.i386.rpm}}

Download (and verify) the following script into your path:

{{cmduser|wget http://www.cs.cornell.edu/~saikat/rotate}}
{{cmduser|chmod a+x rotate}}

Rotate the screen using the script:

{{cmduser|rotate -h}}
Useage:
rotate [left|right|inverted|normal]

If no option is given, rotates the screen 90 degrees to the right.

To bind the tablet's {{key|Rotate}} button to rotate the screen on-the-fly, add the following line to {{path|/etc/X11/Xmodmap}}
keycode 139 = XF86RotateWindows

{{HINT|'''Update:''' Check to make sure you are using the new <tt>setkeycodes</tt> line in the Tablet Buttons section (one with <tt>6c 120</tt> in the command).}}

Create the Gnome keybindings as follows:

{{cmduser|gconftool-2 -s '/apps/metacity/keybinding_commands/command_12' -t string rotate}}
{{cmduser|gconftool-2 -s '/apps/metacity/global_keybindings/run_command_12' -t string XF86RotateWindows}}

=== Wireless Network ===

Install the <tt>ipw2200</tt> driver from [http://atrpms.net/ ATrpms].

{{cmdroot|rpm --import http://ATrpms.net/RPM-GPG-KEY.atrpms}}
{{cmdroot|cd /etc/yum.repos.d}}
{{cmdroot|wget http://www.cs.cornell.edu/~saikat/atrpms.repo}}
{{cmdroot|yum install atrpms-package-config ipw2200}}

=== Hibernation ===

Software suspend works using [[Software Suspend 2]]. To install:

{{cmdroot|cd /etc/yum.repos.d}}
{{cmdroot|wget http://mhensler.de/swsusp/download/suspend2.repo}}
{{cmdroot|yum install userui-suspend2-fbsplash userui-suspend2-theme-fedorabubbles kernel-suspend2}}

Edit the appropriate kernel line in {{path|/etc/grub.conf}} and add the parameters {{bootparm|vga|0x317}} and {{bootparm|acpi_sleep|s3_bios}}. For example:

title Fedora Core (''<kernel.version-build>''.rhfc5.cubbi_suspend2)
root (hd0,1)
kernel /vmlinuz-''<kernel.version-build>''.rhfc5.cubbi_suspend2 ro root=/dev/VolGroup00/LogVol00 rhgb quiet '''vga=0x317 acpi_sleep=s3_bios'''
initrd /initrd-''<kernel.version-build>''.rhfc5.cubbi_suspend2.img

Comment out the following line in {{path|/etc/hibernate/hibernate.conf}}:

'''#''' ProcSetting userui_program /sbin/suspend2ui_text

Add the following lines in {{path|/etc/hibernate/hibernate.conf}}:

ProcSetting userui_program /sbin/suspend2ui_fbsplash
OnResume 96 setserial /dev/ttyS0 port 0x0200 irq 5 autoconfig

Add the following lines in {{path|/etc/hibernate/ram.conf}}:

Distribution fedora

Comment out the following lines in {{path|/etc/hibernate/ram.conf}}:

'''#''' EnableVbetool yes
'''#''' VbetoolPost yes

Force the use of <tt>suspend2</tt> by editing the appropriate line in {{path|/etc/sysconfig/pm}}:

HIBERNATE_METHOD="'''suspend2'''"

=== Tablet Buttons ===

Activate mappings for the tablet buttons by adding the following lines to {{path|/etc/rc.d/rc.local}}:

# Map tablet hardware buttons
setkeycodes 6e 109 6d 104 69 28 6b 1 6c 120

=== Fingerprint Reader ===

The fingerprint reader is supported through the BioAPI framework. The BioAPI framework and the UPEK fingerprint reader driver can be installed as follows:

wget http://www.cs.cornell.edu/~saikat/libbiometrics-1.2.2-1.sg.i386.rpm
wget http://www.cs.cornell.edu/~saikat/libbiometrics-tfmess-1.0-1.sg.i386.rpm
yum localinstall libbiometrics-1.2.2-1.sg.i386.rpm libbiometrics-tfmess-1.0-1.sg.i386.rpm

{{NOTE|This is still work-in-progress. Currently you can enroll fingerprints, and verify them through a test application. Integrating
this support into pam (and therefore logins, gdm, screensaver etc.) is in the works. Those interested in developing biometrics applications
can install [http://www.cs.cornell.edu/~saikat/libbiometrics-devel-1.2.2-1.sg.i386.rpm libbiometrics-devel-1.2.2-1.sg.i386.rpm]. Stay tuned.}}

{{NOTE|Making SRPMS or a spec file available would be very nice for those who want
to try this on other distros.}}

To try out enrollment and verification, run: {{cmdroot|useraddbio}}

=== Harddrive Active Protection System (HDAPS) ===

Harddrive active protection system requires the <tt>hdaps</tt> kernel module (included in stock Fedora kernels), and
a kernel capable of parking disks (patch included in <tt>kernel-suspend2</tt> RPMs from the Hibernation section above).
It also requires a userspace daemon to monitor the accleration sensor and park the disk head when excessive motion is detected. To install
the userspace daemon, do the following:

{{HINT|This requires kernel support for <tt>hdaps</tt> and head parking. Install <tt>[http://mhensler.de/swsusp/download/yum/development/fc5/kernel-suspend2-2.6.16-1.2084_2.rhfc5.cubbi_suspend2.i686.rpm kernel-suspend2-2.6.16-1.2084_2]</tt> or [http://mhensler.de/swsusp/download/yum/development/fc5/ higher]}}

{{cmdroot|wget http://www.cs.cornell.edu/~saikat/hdapsd-20060326cvs-1.sg.i386.rpm}}
{{cmdroot|yum localinstall hdapsd-20060326cvs-1.sg.i386.rpm}}

If software suspend is enabled, add the following line to {{path|/etc/hibernate/hibernate.conf}}

UnloadModules hdaps

To install the Gnome panel applet that monitors the state of the harddisk, install:

{{cmdroot|wget http://www.cs.cornell.edu/~saikat/gnome-applet-hdaps-20060120cvs-1.sg.i386.rpm}}
{{cmdroot|yum localinstall gnome-applet-hdaps-20060120cvs-1.sg.i386.rpm}}

== Software ==

=== Network, Power Management, OSD ===

Some useful software is not installed by default. These include:
* <tt>tpb</tt> — On screen display for thinkpad buttons
* <tt>Network Manager</tt> — Manages wireless and wired networks automatically
* <tt>Gnome Power Manager</tt> — Manages ACPI power events

To install them execute:

{{cmdroot|yum install tpb NetworkManager gnome-power-manager}}
{{cmdroot|chkconfig NetworkManager on}}

Check your <tt>gnome-session-manager</tt> is configured to automatically start the panel applets that control Network Manager and Gnome Power Manager.
Ensure the following entries are present under {{path|System > Preferences > More Preferences > Sessions > Startup Programs}}:

nm-applet --sm-disable
gnome-power-manager --sm-disable

=== Java 1.5 ===

Install Sun's JRE 1.5. This is required for the <tt>jarnal</tt> program below.

* Download the build: {{cmduser|wget http://mirrors.dotsrc.org/jpackage/1.6/generic/non-free/SRPMS/java-1.5.0-sun-1.5.0.06-1jpp.nosrc.rpm}}
* Create the build environment: {{cmdroot|rpm -Uvh java-1.5.0-sun-1.5.0.05-1jpp.nosrc.rpm}}
* Download the JVM from [http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=jdk-1.5.0_06-oth-JPR&SiteId=JSC&TransactionId=noreg Sun's Java page] and download <tt>jdk-1_5_0_06-linux-i586.bin</tt> to {{path|/usr/src/redhat/SOURCES}}
* Build the RPMs: {{cmdroot|rpmbuild -ba /usr/src/redhat/SPECS/java-1.5.0-sun.spec}}
* Install the JVM: {{cmdroot|yum localinstall /usr/src/redhat/RPMS/i586/java-1.5.0-sun-1.5.0.06-1jpp.i586.rpm}}
* Install the fonts: {{cmdroot|yum localinstall /usr/src/redhat/RPMS/i586/java-1.5.0-sun-fonts-1.5.0.06-1jpp.i586.rpm}}

Note: This is tailored for the latest JVM as of writing this article. Substitute the latest version numbers if this doesn't work.

=== Jarnal Note-Taking ===

Install the [http://www.dklevine.com/general/software/tc1000/jarnal.htm Jarnal] note-taking application:

{{cmdroot|wget http://www.cs.cornell.edu/~saikat/jarnal-8.14-1sg.noarch.rpm}}
{{cmdroot|yum localinstall jarnal-8.14-1sg.noarch.rpm}}

[[Category:X41 Tablet]][[Category:Fedora]]

ThinkWiki - User contributions [en]

Installing Fedora Core 5 on a ThinkPad X41 Tablet