Active Rotate

2009-02-09T22:11:52Z

KarlHegbloom: Correction regarding event mechanism that should trigger screen rotation, add link to my Launchpad project.

'''Active Rotate''' is a technology to automatically rotate the screen orientation based on the physical orientation of the tablet. It uses ACPI button event support for the event that it is being flipped down into tablet configuration, or up into laptop configuration. (On at least the X61 Tablet) there is an acpi status file that can be read to determine whether the machine is presently in laptop or tablet configuration. Once in tablet configuration, perhaps software that uses the same sensor as [[HDAPS]] could automatically reorient the display according to position --- landscape vs portrait mode --- in similar fashion to the display on the iPhone.

==Models featuring this Technology==
*ThinkPad {{X60_Tablet}}, {{X61_Tablet}}, {{X200_Tablet}} (non-SSD)

==See Also==
*[https://code.edge.launchpad.net/~karl.hegbloom/tabuntu/tablet-screen-rotation-support Tablet Screen Rotation Support], part of the [https://edge.launchpad.net/tabuntu Tabuntu] project at [https://edge.launchpad.net Launchpad].

[[Category:Glossary]]

Tablet Hardware Buttons

2009-02-09T22:00:12Z

KarlHegbloom: /* See also */

{| width="100%"
|style="vertical-align:top;padding-right:20px;width:10px;" |
|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;">
===Tablet Hardware Buttons===
The Thinkpad tablets includes hardware buttons located on the
LCD screen bezel. They are designed to be used when the ThinkPad is
converted to the tablet configuration (though they are still
accessible when in the laptop configuration).
</div>
|}

==Buttons==
The X41 Tablet hardware buttons include:
*Power (with sliding lock)
*Cltr-Alt-Del [sic]
*Page up
*Page down
*Enter
*Escape
*Screen Rotation
*Tablet shortcut menu

X61 Tablet: [http://www.tabletpcreview.com/picture.asp?f=3104 picture] from [http://www.tabletpcreview.com/default.asp?newsID=896 here].

X200 Tablet: see below.

==Linux Support==
The hardware buttons (except power) are recognized by the standard atkbd kernel driver which emits the following scancodes:

{| border="1" cellpadding="5" cellspacing="0"
! Key !! X41 Scancode || {{X60t}} Scancode || {{X61_Tablet}} Scancode || {{X200_Tablet}} Scancode
|-
| Page up || 0x6D || NA || NA || NA
|-
| Page down || 0x6E || NA || NA || NA
|-
| Enter || 0x69 || 0x69 || 0x69 || NA
|-
| Esc || 0x6B || 0x6B || 0x6b || NA
|-
| Toolbox || 0x68 || 0x68 || 0x68 || 0x66
|-
| Rotate || 0x6C || 0x6c || 0x6c || 0x6b
|-
| (Unlabeled) || 0x67 || NA || 0x67 || 0xe0 0x12
|-
| Right || NA || 0x6D || 0x6d || NA
|-
| Left || NA || 0x6E || 0x6e || NA
|-
| Up || NA || 0x71 || 0x71 || NA
|-
| Down || NA || 0x6F || 0x6f || NA
|-

|}

Notes:
* X200 Tablet
*: Layout: power (with sliding lock); clockwise-arrow (formerly unlabeled); rotate (two boxes and an arrow); Toolbox (the icon is now a menu); padlock.
*: The padlock button seems to do nothing. It generates no scancode, and has no effect on the other buttons.
*: The clockwise-arrow button returns a scancode pair. So you say {{cmduser|setkeycodes e012 ''whatever''}}.

The utility setkeycodes can be used to map these scancodes to keycodes. Read {{cmduser|man setkeycodes}} for usage.
For example, the following command will map the page up and page down buttons to their respective keys:

{{cmdroot|setkeycodes 6e 109 6d 104}}

==Models featuring this Device==
* {{X41_Tablet}}, {{X60t}}, {{X61_Tablet}}, {{X200_Tablet}}

==See also==
*[[How to get special keys to work]]
*[https://code.edge.launchpad.net/~karl.hegbloom/tabuntu/tablet-screen-rotation-support Tablet Screen Rotation Support] (Launchpad).
[[Category:Components]]

Wacom Serial Tablet PC Stylus

2009-02-09T21:55:28Z

KarlHegbloom: /* xrandr Rotation */ Mention new project supporting laptop tablet screen rotation.

__NOTOC__
{| width="100%"
|style="vertical-align:top" |[[Image:Logo_wacom.gif|Wacom Logo]]
|style="vertical-align:top" |
<div style="margin:0px; border: 1px solid #dfdfdf; padding: 0em 1em 1em 1em; background-color:#F8F8FF; align:right;">
=== Wacom Serial Tablet PC Stylus ===
This is a stylus made for tablet PCs by Wacom.
=== Features ===
* Chipset: Wacom
* Serial: irq 5 port 0x0200
</div>
|}

==Linux Support==
The pen is supported by the XFree/Xorg Wacom driver. New tablets also have the [[MultiTouch]] capability. [[MultiTouch]] is experimentally supported presently by the Linux wacom project. The pen works regardless of [[MultiTouch]] support.

The pen uses serial and appears on some {{path|/dev/ttySnn}} device where <tt>nn</tt> is a number. An easy way to find it is to map {{path|/dev/ttyS0}} to the pen's port and irq. The values can be found under the windows driver properties. Using values from an {{X41T}} 1869-5CU, the command is: {{cmdroot|setserial /dev/ttyS0 port 0x0200 irq 5 autoconfig}} (you need to run this after every suspend/resume cycle).

This may be inserted into startup scripts in {{path|/etc/rc.d/}}

The X config file needs to be changed to use the stylus. Add the following sections to your xorg.conf:

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

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

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

Add the following lines to the ServerLayout section:

InputDevice "cursor" "SendCoreEvents"
InputDevice "stylus" "SendCoreEvents"
InputDevice "eraser" "SendCoreEvents"

Check the wacom driver man page and [http://linuxwacom.sf.net/ website] for other options.

For handwriting recognition using pen you can use [[CellWriter]].

To get the right mouse button to map to the stylus button use this script and run it through .bashrc

#!/bin/bash
xsetwacom set stylus Button1 1
xsetwacom set stylus Button2 3
xsetwacom set stylus Button3 3

==xrandr Rotation==

There is work underway to create a [https://code.edge.launchpad.net/~karl.hegbloom/tabuntu/tablet-screen-rotation-support Tablet Screen Rotation Support] package for Ubuntu. Because I can afford only one tablet computer, and since this is relatively new and not many others have put any work into it yet, so far it mainly supports the Lenovo Thinkpad X61 Tablet. The next phase of development involves refactoring in such a way that it can easily be expanded to support other brands and models of tablet computer. The planned mechanism is similar to that used by the scripts in the Debian acpi-support package.

So far, it supports auto-rotation on conversion from laptop to tablet mode, including rebinding the navpad keys and turning the logical orientation of the Wacom tablet to match. It is done as an event called when the X Server has changed it's xRandR orientation. The actual work is carried out by a quick set of shell scripts that can easily be adapted and extended. The idea is that no matter what piece of software actually caused the X Server to rotate, the same things need to happen whenever it does. So the best place to hook in the support event is on an event handler for the RandR Rotate event. The programs and packaging are simple, and the source is available at the URL above. I encourage you to get a copy and learn from it while helping make it work for a new kind of tablet no other developer has created support for yet! If you can write an essay, you can write the necessary program.

Because this ThinkWiki page is one of the sources I drew from when I initially created tablet-screen-rotation-support. The following scripts by Gtx, radix, and Papertiger probably contain some elements in common. --[[User:KarlHegbloom|KarlHegbloom]] 21:55, 9 February 2009 (UTC)

=== xrotate support scripts ===

linuxwacom is very buggy. I needed some time to get the tablet work with "xrandr -r". I use the script below to do screen rotation. copy the source an put it in /usr/local/bin/xrotate. You may change output and devices to fit to you're system (the default values work fine for an x41 tablet)

you can use "xrotate +" to rotate the screen CCW or "xrotate -" to rotate clockwise. use "xrotate x" where x is
* 0 to set rotation to normal
* 1 to set rotation to left
* 2 to set rotation to inverted
* 3 to set rotation to right

#!/bin/sh

output=LVDS
if [ "$XROT_OUTPUT" ]
then
output=$XROT_OUTPUT;
fi
devices="stylus cursor"

geomnbr=0
xrandr=normal
wacom=normal
if [ "$1" == "-" ] || [ "$1" == "+" ] || ! [ "$1" ];
then
operator="$1";
[ "$1" ] || operator='+';
case `xrandr --verbose | grep "^$output " | sed "s/^[^ ]* [^ ]* [^ ]* ([^(]*) $[a-z]*$.*/\1/"` in
normal) geom=0;;
left) geom=1;;
inverted) geom=2;;
right) geom=3;;
esac
let geom=${geom}${operator}1+4
let geom=${geom}%4
else
geom="$1"
fi

case $geom in
1) wacom=2; xrandr=left ;;
2) wacom=3; xrandr=inverted ;;
3) wacom=1; xrandr=right ;;
*) wacom=0; xrandr=normal ;;
esac

echo "xrandr to $xrandr, xsetwacom to $wacom" >&2

if xrandr --output "$output" --rotate "$xrandr"; then
for d in $devices
do
xsetwacom set "stylus" Rotate "$wacom"
done
fi

#workaround for linuxwacom bug
if [ "`xsetwacom get stylus Mode`" == '1' ]; then
for d in $devices
do
xsetwacom set stylus CoreEvent "off"
xsetwacom set stylus Mode "off"
done
{ sleep 1;
for d in $devices
do
xsetwacom set stylus Mode "on"
xsetwacom set stylus CoreEvent "on"
done; } &
fi

--[[User:Gtx|Gtx]] 13:34, 22 April 2008 (CEST)

modified script for linuxwacom 0.8.1-1.

#!/bin/sh

output="(normal left inverted right)" #LVDS
# if [ "$XROT_OUTPUT" ]
# then
# output=$XROT_OUTPUT;
# fi
devices="stylus cursor"

geomnbr=0
xrandr=normal
wacom=normal
if [ "$1" == "-" ] || [ "$1" == "+" ] || ! [ "$1" ];
then
operator="$1";
[ "$1" ] || operator='+';
case `xrandr --verbose | grep "$output" | sed "s/^[^ ]* [^ ]* [^ ]* ([^(]*) $[a-z]*$.*/\1/"` in
normal) geom=0;;
left) geom=1;;
inverted) geom=2;;
right) geom=3;;
esac
let geom=${geom}${operator}1+4
let geom=${geom}%4
else
geom="$1"
fi
case $geom in
1) wacom=2; xrandr=left ;;
2) wacom=3; xrandr=inverted ;;
3) wacom=1; xrandr=right ;;
*) wacom=0; xrandr=normal ;;
esac

echo "xrandr to $xrandr, xsetwacom to $wacom" >&2

if xrandr -o "$xrandr"; then
for d in $devices
do
xsetwacom set "stylus" Rotate "$wacom"
done
fi

#workaround for linuxwacom bug
if [ "`xsetwacom get stylus Mode`" == '1' ]; then
for d in $devices
do
xsetwacom set stylus CoreEvent "off"
xsetwacom set stylus Mode "off"
done
{ sleep 1;
for d in $devices
do
xsetwacom set stylus Mode "on"
xsetwacom set stylus CoreEvent "on"
done; } &
fi

--[[User:radix|radix]] 13:15, 28 August 2008 (CEST)

Additional code for rotating the 4 navigation keys on the display frame.

<pre>
case $geom in
1) xmodmap -e 'keycode 98 = Right';xmodmap -e 'keycode 100 = Up';xmodmap -e 'keycode 102 = Down';xmodmap -e 'keycode 104 = Left';;
2) xmodmap -e 'keycode 98 = Down';xmodmap -e 'keycode 100 = Right';xmodmap -e 'keycode 102 = Left';xmodmap -e 'keycode 104 = Up';;
3) xmodmap -e 'keycode 98 = Left';xmodmap -e 'keycode 100 = Down';xmodmap -e 'keycode 102 = Up';xmodmap -e 'keycode 104 = Right';;
*) xmodmap -e 'keycode 98 = Up';xmodmap -e 'keycode 100 = Left';xmodmap -e 'keycode 102 = Right';xmodmap -e 'keycode 104 = Down';;
esac
</pre>

--[[User:Papertiger|Papertiger]] 02:05, 16 January 2009 (UTC)

==Troubleshooting==

If the stylus still doesn't work try to reset the bios. This fixed it for me. --[[User:Gtx|Gtx]] 08:22, 21 April 2008 (CEST)

==Models featuring this Device==
*ThinkPad {{X41_Tablet}}
*ThinkPad {{X60_Tablet}}
*ThinkPad {{X61_Tablet}}
*ThinkPad {{X200_Tablet}}

[[Category:Components]]

ThinkWiki - User contributions [en]

Active Rotate

Tablet Hardware Buttons

Wacom Serial Tablet PC Stylus