ThinkWiki - User contributions [en]

Installing Ubuntu 8.10 (Intrepid Ibex) on a ThinkPad X61 Tablet

2009-03-01T09:25:37Z

Ambush Commander: /* Tilt detection */ krizka instructions on tilt detection

This page is not complete, but it documents some differences from [[Installing Ubuntu 8.04 (Hardy Heron) on a ThinkPad X61|the Hardy page]].

Installing Intrepid should work the same as on most other computers. If you don't have [[UltraBase X6 Tablet|Ultrabase]] with a CD drive or another external CD drive, you can install from a USB drive.

Do not forget to install the mandatory wacom drivers before editing your xorg.conf! See [https://help.ubuntu.com/community/Wacom the Wacom documentation of the official Ubuntu help]. Basically, you need to install wacom-tools and xserver-xorg-input-wacom. You may get it using apt-get/Synaptic or from source.

= Tablet specific features =

== Stylus ==
Enable it as described in [[Wacom_Serial_Tablet_PC_Stylus]]:
Add to /etc/X11/xorg.conf:

<pre>
Section "InputDevice"
Driver "wacom"
Identifier "stylus"
Option "Device" "/dev/input/wacom"
Option "Type" "stylus"
Option "ForceDevice" "ISDV4" # Tablet PC ONLY
EndSection

Section "InputDevice"
Driver "wacom"
Identifier "eraser"
Option "Device" "/dev/input/wacom"
Option "Type" "eraser"
Option "ForceDevice" "ISDV4" # Tablet PC ONLY
Option "Button1" "3" # This works better with Xournal
EndSection

Section "InputDevice"
Driver "wacom"
Identifier "cursor"
Option "Device" "/dev/input/wacom"
Option "Type" "cursor"
Option "ForceDevice" "ISDV4" # Tablet PC ONLY
EndSection
</pre>

The main difference from Hardy, is that the option "Device" no longer takes the value "/dev/ttyS0", but "/dev/input/wacom" (due to a newer version of the driver). If your tablet supports MultiTouch, you can also add the section (untested - please remove this paranthesis if you have tested this successfully)

The Option Button1 3 incant in the eraser section is what I needed to add in order to make the tablet's eraser work with Xournal. I have not tested with other note-taking software.

<pre>
Section "InputDevice"
Driver "wacom"
Identifier "touch"
Option "Device" "/dev/input/wacom"
Option "Type" "touch"
Option "ForceDevice" "ISDV4"
EndSection
</pre>

In addition you will need a ServerLayout section. If you already have one, add the lines:
<pre>
InputDevice "stylus" "SendCoreEvents"
InputDevice "eraser" "SendCoreEvents"
InputDevice "cursor" "SendCoreEvents"
</pre>
to it. If there is no such section (which is the default), it has to be added. It can then look like this:
<pre>
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "stylus" "SendCoreEvents"
InputDevice "eraser" "SendCoreEvents"
InputDevice "cursor" "SendCoreEvents"
# InputDevice "touch" "SendCoreEvents" # Only a few TabletPCs support this type
EndSection
</pre>

Uncomment the last line if you have a MultiTouch capable tablet. The Identifier can be whatever you want, and the Screen is whatever the Identifier of your screen section is. "Default Screen" is the default. Make sure that you have a newline after the last EndSection in your file.

== Rotate screen when turning into slate mode ==

When you turn the screen to put the computer into slate mode (a.k.a. tablet mode) you typically want the picture on screen to rotate into portrait mode. The X61 generates an ACPI event when it is turned into slate mode and another event when it is turned back. We can then let acpid rotate the screen at this event.
At the moment, Ubuntu does not automatically rotate the stylus when the screen is rotated. This means that if you touch the screen in one corner, the cursor will show up in another.
We also want to remap the arrow keys so that what used to be left now becomes down, etc. so that the "wheel" work as expected.

First, we add two files for changing the arrow keys to <tt>/etc/acpi</tt>

<tt>Xmodmap.normalrotatedarrows</tt>:
<pre>
keycode 111 = Up NoSymbol Up NoSymbol Up
keycode 113 = Left NoSymbol Left NoSymbol Left
keycode 114 = Right NoSymbol Right NoSymbol Right
keycode 116 = Down NoSymbol Down NoSymbol Down
</pre>

<tt>Xmodmap.rightrotatedarrows</tt>:
<pre>
keycode 114 = Up NoSymbol Up NoSymbol Up
keycode 111 = Left NoSymbol Left NoSymbol Left
keycode 116 = Right NoSymbol Right NoSymbol Right
keycode 113 = Down NoSymbol Down NoSymbol Down
</pre>

The first of these is the default configuration and four of the lines you should get when you run <tt>xmodmap -pke</tt>. The second one rotates this the way we want for slate mode.

Next, we place two scripts in <tt>/etc/acpi</tt>

<tt>rotatescreenandstylus-laptop.sh</tt>
<pre>
#!/bin/sh
#
# This script rotates the display in TabletPCs when screen is changed from
# slate to laptop mode

test -f /usr/share/acpi-support/key-constants || exit 0

. /usr/share/acpi-support/power-funcs

for x in /tmp/.X11-unix/*; do
displaynum=`echo $x | sed s#/tmp/.X11-unix/X##`
getXconsole;
if [ x"$XAUTHORITY" != x"" ]; then
export DISPLAY=":$displaynum"
# Rotate the screen
/usr/bin/xrandr --orientation normal
# Rotate the stylus
/usr/bin/xsetwacom set stylus rotate none
/usr/bin/xsetwacom set eraser rotate none
/usr/bin/xsetwacom set cursor rotate none
# Rotate the arrow keys
xmodmap /etc/acpi/Xmodmap.normalrotatedarrows
fi
done

</pre>

<tt>rotatescreenandstylus-slate.sh</tt>
<pre>
#!/bin/sh
#
# This script rotates the display in TabletPCs when screen is changed from
# laptop to slate mode

test -f /usr/share/acpi-support/key-constants || exit 0

. /usr/share/acpi-support/power-funcs

for x in /tmp/.X11-unix/*; do
displaynum=`echo $x | sed s#/tmp/.X11-unix/X##`
getXconsole;
if [ x"$XAUTHORITY" != x"" ]; then
export DISPLAY=":$displaynum"
# Rotate the screen
/usr/bin/xrandr --orientation right
# Rotate the stylus
/usr/bin/xsetwacom set stylus rotate cw
/usr/bin/xsetwacom set eraser rotate cw
/usr/bin/xsetwacom set cursor rotate cw
# Rotate the arrow keys
xmodmap /etc/acpi/Xmodmap.rightrotatedarrows
fi
done

</pre>

These two scripts are basically copied from <tt>/etc/acpi/rotatescreen.sh</tt>, but instead of just rotating the screen it also rotates the stylus and the arrow keys.

Finally, we need to make the scripts run when the ACPI events are generated.
This is accomplished by adding files to <tt>/etc/acpi/events</tt>.

<tt>thinkpad-rotate-laptop</tt>:
<pre>
# /etc/acpi/events/thinkpad-rotate-slate
# This is called when the user rotates the screen to/from tablet mode

event=ibm/hotkey HKEY 00000080 0000500a
action=/etc/acpi/rotatescreenandstylus-laptop.sh
</pre>

<tt>thinkpad-rotate-slate</tt>:
<pre>
# /etc/acpi/events/thinkpad-rotate-slate
# This is called when the user rotates the screen to/from tablet mode

event=ibm/hotkey HKEY 00000080 00005009
action=/etc/acpi/rotatescreenandstylus-slate.sh
</pre>

This should be all. Next time you restart the computer or acpid, the screen/arrow key/stylus rotation should work when the computer is put into slate mode and back again.

= Tilt detection =
Unlike Hardy, Intrepid does not have the hdaps_ec module.

This has been reported as [https://bugs.launchpad.net/bugs/297213 bug 297213] in Launchpad.

[http://www.krizka.net/2008/01/23/thinkpad-x61-tablet-tilt-detection-and-ubuntu-hardy-heron/ This blog post] appears to have information on how to compile the kernel module. Be sure to `sudo modprobe hdaps` to load the kernel module, and add it to /etc/modules.conf to load it at boot time.

(TODO: Figure out how to enable hard drive prodection with accelerometers)

= External links =
[http://blog.aliencam.net/?page_id=438 Customized Ubuntu Hardy Setup Guide on X61t Hardware].

[[Category:X61 Tablet]]
[[Category:Ubuntu 8.10]]

Installing Ubuntu 8.10 (Intrepid Ibex) on a ThinkPad X61 Tablet

2009-03-01T09:02:58Z

Ambush Commander: /* Stylus */ add information on making eraser work on xournal

This page is not complete, but it documents some differences from [[Installing Ubuntu 8.04 (Hardy Heron) on a ThinkPad X61|the Hardy page]].

Installing Intrepid should work the same as on most other computers. If you don't have [[UltraBase X6 Tablet|Ultrabase]] with a CD drive or another external CD drive, you can install from a USB drive.

Do not forget to install the mandatory wacom drivers before editing your xorg.conf! See [https://help.ubuntu.com/community/Wacom the Wacom documentation of the official Ubuntu help]. Basically, you need to install wacom-tools and xserver-xorg-input-wacom. You may get it using apt-get/Synaptic or from source.

= Tablet specific features =

== Stylus ==
Enable it as described in [[Wacom_Serial_Tablet_PC_Stylus]]:
Add to /etc/X11/xorg.conf:

<pre>
Section "InputDevice"
Driver "wacom"
Identifier "stylus"
Option "Device" "/dev/input/wacom"
Option "Type" "stylus"
Option "ForceDevice" "ISDV4" # Tablet PC ONLY
EndSection

Section "InputDevice"
Driver "wacom"
Identifier "eraser"
Option "Device" "/dev/input/wacom"
Option "Type" "eraser"
Option "ForceDevice" "ISDV4" # Tablet PC ONLY
Option "Button1" "3" # This works better with Xournal
EndSection

Section "InputDevice"
Driver "wacom"
Identifier "cursor"
Option "Device" "/dev/input/wacom"
Option "Type" "cursor"
Option "ForceDevice" "ISDV4" # Tablet PC ONLY
EndSection
</pre>

The main difference from Hardy, is that the option "Device" no longer takes the value "/dev/ttyS0", but "/dev/input/wacom" (due to a newer version of the driver). If your tablet supports MultiTouch, you can also add the section (untested - please remove this paranthesis if you have tested this successfully)

The Option Button1 3 incant in the eraser section is what I needed to add in order to make the tablet's eraser work with Xournal. I have not tested with other note-taking software.

<pre>
Section "InputDevice"
Driver "wacom"
Identifier "touch"
Option "Device" "/dev/input/wacom"
Option "Type" "touch"
Option "ForceDevice" "ISDV4"
EndSection
</pre>

In addition you will need a ServerLayout section. If you already have one, add the lines:
<pre>
InputDevice "stylus" "SendCoreEvents"
InputDevice "eraser" "SendCoreEvents"
InputDevice "cursor" "SendCoreEvents"
</pre>
to it. If there is no such section (which is the default), it has to be added. It can then look like this:
<pre>
Section "ServerLayout"
Identifier "Default Layout"
Screen "Default Screen"
InputDevice "stylus" "SendCoreEvents"
InputDevice "eraser" "SendCoreEvents"
InputDevice "cursor" "SendCoreEvents"
# InputDevice "touch" "SendCoreEvents" # Only a few TabletPCs support this type
EndSection
</pre>

Uncomment the last line if you have a MultiTouch capable tablet. The Identifier can be whatever you want, and the Screen is whatever the Identifier of your screen section is. "Default Screen" is the default. Make sure that you have a newline after the last EndSection in your file.

== Rotate screen when turning into slate mode ==

When you turn the screen to put the computer into slate mode (a.k.a. tablet mode) you typically want the picture on screen to rotate into portrait mode. The X61 generates an ACPI event when it is turned into slate mode and another event when it is turned back. We can then let acpid rotate the screen at this event.
At the moment, Ubuntu does not automatically rotate the stylus when the screen is rotated. This means that if you touch the screen in one corner, the cursor will show up in another.
We also want to remap the arrow keys so that what used to be left now becomes down, etc. so that the "wheel" work as expected.

First, we add two files for changing the arrow keys to <tt>/etc/acpi</tt>

<tt>Xmodmap.normalrotatedarrows</tt>:
<pre>
keycode 111 = Up NoSymbol Up NoSymbol Up
keycode 113 = Left NoSymbol Left NoSymbol Left
keycode 114 = Right NoSymbol Right NoSymbol Right
keycode 116 = Down NoSymbol Down NoSymbol Down
</pre>

<tt>Xmodmap.rightrotatedarrows</tt>:
<pre>
keycode 114 = Up NoSymbol Up NoSymbol Up
keycode 111 = Left NoSymbol Left NoSymbol Left
keycode 116 = Right NoSymbol Right NoSymbol Right
keycode 113 = Down NoSymbol Down NoSymbol Down
</pre>

The first of these is the default configuration and four of the lines you should get when you run <tt>xmodmap -pke</tt>. The second one rotates this the way we want for slate mode.

Next, we place two scripts in <tt>/etc/acpi</tt>

<tt>rotatescreenandstylus-laptop.sh</tt>
<pre>
#!/bin/sh
#
# This script rotates the display in TabletPCs when screen is changed from
# slate to laptop mode

test -f /usr/share/acpi-support/key-constants || exit 0

. /usr/share/acpi-support/power-funcs

for x in /tmp/.X11-unix/*; do
displaynum=`echo $x | sed s#/tmp/.X11-unix/X##`
getXconsole;
if [ x"$XAUTHORITY" != x"" ]; then
export DISPLAY=":$displaynum"
# Rotate the screen
/usr/bin/xrandr --orientation normal
# Rotate the stylus
/usr/bin/xsetwacom set stylus rotate none
/usr/bin/xsetwacom set eraser rotate none
/usr/bin/xsetwacom set cursor rotate none
# Rotate the arrow keys
xmodmap /etc/acpi/Xmodmap.normalrotatedarrows
fi
done

</pre>

<tt>rotatescreenandstylus-slate.sh</tt>
<pre>
#!/bin/sh
#
# This script rotates the display in TabletPCs when screen is changed from
# laptop to slate mode

test -f /usr/share/acpi-support/key-constants || exit 0

. /usr/share/acpi-support/power-funcs

for x in /tmp/.X11-unix/*; do
displaynum=`echo $x | sed s#/tmp/.X11-unix/X##`
getXconsole;
if [ x"$XAUTHORITY" != x"" ]; then
export DISPLAY=":$displaynum"
# Rotate the screen
/usr/bin/xrandr --orientation right
# Rotate the stylus
/usr/bin/xsetwacom set stylus rotate cw
/usr/bin/xsetwacom set eraser rotate cw
/usr/bin/xsetwacom set cursor rotate cw
# Rotate the arrow keys
xmodmap /etc/acpi/Xmodmap.rightrotatedarrows
fi
done

</pre>

These two scripts are basically copied from <tt>/etc/acpi/rotatescreen.sh</tt>, but instead of just rotating the screen it also rotates the stylus and the arrow keys.

Finally, we need to make the scripts run when the ACPI events are generated.
This is accomplished by adding files to <tt>/etc/acpi/events</tt>.

<tt>thinkpad-rotate-laptop</tt>:
<pre>
# /etc/acpi/events/thinkpad-rotate-slate
# This is called when the user rotates the screen to/from tablet mode

event=ibm/hotkey HKEY 00000080 0000500a
action=/etc/acpi/rotatescreenandstylus-laptop.sh
</pre>

<tt>thinkpad-rotate-slate</tt>:
<pre>
# /etc/acpi/events/thinkpad-rotate-slate
# This is called when the user rotates the screen to/from tablet mode

event=ibm/hotkey HKEY 00000080 00005009
action=/etc/acpi/rotatescreenandstylus-slate.sh
</pre>

This should be all. Next time you restart the computer or acpid, the screen/arrow key/stylus rotation should work when the computer is put into slate mode and back again.

= Tilt detection =
Unlike Hardy, Intrepid does not have the hdaps_ec module.

This has been reported as [https://bugs.launchpad.net/bugs/297213 bug 297213] in Launchpad.

(TODO: Add information on how to download and compile the driver here.)

= External links =
[http://blog.aliencam.net/?page_id=438 Customized Ubuntu Hardy Setup Guide on X61t Hardware].

[[Category:X61 Tablet]]
[[Category:Ubuntu 8.10]]

LCD Brightness

2009-03-01T08:54:56Z

Ambush Commander: /* Ubuntu 8.10 Intrepid Ibex */ x61 problems

{{Stub}}

== Regular ACPI ==

This worked for my {{X61}}:

Once your brightness keys work, you can set the brightness by writing to the procfs:

{{cmdroot|echo 100 > /proc/acpi/video/VID1/LCD0/brightness}}

using a script and acpid events. However this may lead to a bug (screen flickers) described on the Debian mailing list [[http://www.mail-archive.com/debian-x@lists.debian.org/msg71942.html]]. This bug is related to the X server as it does not occur on the tty1. To fix it change your xrandr backlight control to native:

{{cmduser|$xrandr --output LVDS --set BACKLIGHT_CONTROL native}}

For my {{X61}}, these following scripts from [http://d.hatena.ne.jp/conceal-rs/20080309/1205083315 this japanese site] helped:

% cat /etc/acpi/video_brightnessdown.sh
#!/bin/sh
xbacklight -dec 10%

% cat /etc/acpi/video_brightnessup.sh
#!/bin/sh
xbacklight -inc 10%
=== 2.6.26 kernel ===

If you are using a 2.6.26 kernel, you are supposed to use the regular ACPI backlight control instead of thinkpad-acpi, on any Lenovo (Windows Vista-capable) ThinkPad.

Modify the kernel config by first disabling CONFIG_THINKPAD_ACPI_VIDEO and then enabling both CONFIG_VIDEO_OUTPUT_CONTROL and CONFIG_ACPI_VIDEO [http://www.nabble.com/T61-Brightness-keys-with-2.6.26-not-working-(NVIDIA)-td18577619.html] While you are at it, be sure to read the well-written help sections for the kernel config settings :)

== Thinkpad-ACPI ==

If you have an older ThinkPad model, such as the {{T20}}, you may want to use [[thinkpad-acpi]].
You can adjust the brightness of your screen by software using either procfs or sysfs.

If the following commands fail, you may want to try other module parameters for thinkpad-acpi. I had to use <tt>backlight_mode=1</tt> for example on my {{T20}}.
Just add the following line to your {{path|/etc/modprobe.conf}}
options thinkpad-acpi brightness_mode=1

See the chapter <tt>LCD brightness control</tt> of {{path|Documentation/laptops/thinkpad-acpi.txt}} in the kernel sources for more informations.

==== Using procfs ====

To adjust the brightness to a certain level:

{{cmdroot|echo 'level 3' > /proc/acpi/ibm/brightness}}

Just one level up or down:

{{cmdroot|echo 'up' > /proc/acpi/ibm/brightness}} <br />
{{cmdroot|echo 'down' > /proc/acpi/ibm/brightness}}

See {{path|/proc/acpi/ibm/brightness}} for a list of all available commands.

==== Using sysfs ====

The sysfs-interface allows more a flexible method of brightness control:

Get the current brightness level:

{{cmdroot|cat /sys/class/backlight/thinkpad_screen/actual_brightness}}

Get the highest brightness level:

{{cmdroot|cat /sys/class/backlight/thinkpad_screen/max_brightness}}

Adjust the brightness to a certain level:

{{cmdroot|echo 3 > /sys/class/backlight/thinkpad_screen/brightness}}

== Ubuntu 8.10 Intrepid Ibex ==
The hardware keys work out of the box on a clean install of Ubuntu 8.10 Intrepid Ibex and openSUSE 11.1. No tweaking necessary.

X61 appears to have some problems; the hardware keys for adjusting brightness are recognized, but they don't actually change the brightness. Setting xrandr to native, as described above, fixes the problem.