ThinkWiki - User contributions [en]

Category:Edge Twist

2013-01-29T23:27:03Z

Shane: Associate with Category:Edge

{| 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;">
=== ThinkPad Twist ===
This page gives an overview of the ThinkPad Twist.

==== Standard Features ====
*One of the following processors:

**Intel® Core™ i3 – 3217U (1.8 GHz, 3MB L3, 1600 MHz FSB)
**Intel® Core™ i5 – 3317U (2.60 GHz, 3MB L3, 1600 MHz FSB)
**Intel Core i7-3517U CPU @ 1.90GHz (quadcore, 4mb cache each core)

* 12.5" 1366*768 display (glossy) with 10 point multitouch screen
** Intel graphics adapters
*** Intel® HD Graphics 4000
*** Intel® HD Graphics 3000 (i3-2365)

** Atmel touch adaptor: Atmel maXTouch Digitizer

* 4GB or 8GB DDR3 (soldered in)
* One of the following storage options:

** 16gb mSata SSD and 320GB or 500gb HDD
** 128GB SSD

* WLAN adapter
** Centrino Wireless-N 2230

* LAN adapter:
** Realtek Semiconductor Co., Ltd. RTL8111/8168B PCI Express Gigabit Ethernet controller

* Optionally WWAN adapter:
** Ericsson Business Mobile Networks BV

* Battery internal.

* Internal PCIe slots:
** 1 full size - WLAN module
** 1 half size mSata card or WWAN
* USB 2x (3.0)
* miniHDMI
* DisplayPort
* SD card reader
* Size: 313mm x 236mm x 20mm (12.3" x 9.3" x 0.8")
* Weight 1.58 kg (3.48 lb)
</div>
|style="vertical-align:top" |
[[Image:twist.png|ThinkPad Twist|300px]]
|}

[[Category:Edge]]

ThinkPad series

2013-01-29T23:20:05Z

Shane: Adding Categories for the Edge series devices

=Current Series=
==ThinkPad R series==
Dropping the [[#ThinkPad A series|A series]], IBM introduced a mainstream budget line of ThinkPads in the R series. The RXXe series lacks some of "normal" RXX series features like stereo speakers, touchpad, hot-swappable CD/DVD drive, docking connector and some other things. They also usually feature slower CPU like Intel Celeron (but in newer models also slower Intel Core processors). ACPI functions in modern RXX-e models are just as well supported in Linux as they are for the regular RXX models.

Starting from R61, the R series ThinkPads feature the same chassis (including RollCage) as the [[#ThinkPad T series|T series]] making them virtually indistinguishable from each other.

==ThinkPad T series==
As successor of the [[#ThinkPad 600 series|600 series]], the T series became IBM mobile productivity line. Usually leading the ThinkPad range in technology, innovation and price, the T series was intended for the travelling businessman - comparatively more stylish, functional, and rugged machines; and easy to disassemble for repair or upgrades. T series ThinkPads are clad in black non-slip rubber with embedded glitter. The case lid has tabs along the edge that interlocks with depressions in the lower case when closed, to reduce case flexing.

===ThinkPad T2x series===
The ThinkPad T2x models ([[:Category:T20|T20]], [[:Category:T21|T21]], [[:Category:T22|T22]], [[:Category:T23|T23]]) were [[Intel Mobile Pentium III-M]] based, sub-5 lb (2.3 kg) class machines. These machines typically had 14.1 inch XGA screens, S3 Savage graphics chips and Cirrus Logic sound chips. The T2x series introduced the [[UltraBay|UltraBay 2000]] optical drive bay and titanium-reinforced screen lids. With the [[:Category:T23|T23]], an internal WiFi antenna became available, so WiFi miniPCI cards could be used. Also the [[:Category:T23|T23]] was the first ThinkPad featuring an [[UltraBay|UltraBay Plus]] drive and [[Embedded Security Subsystem]].

===ThinkPad T3x series===
The T3x series only saw one model, the [[:Category:T30|T30]]. Powered by a [[Intel Mobile Pentium 4-M]] and a Radeon 7500 graphics chip with 16 MB of discrete video memory, the T30 was available with 14.1 inch XGA or SXGA screens. The [[:Category:T30|T30]] introduced the [[UltraNav]] touchpad and integrated Bluetooth among ThinkPads. Other features include the [[Embedded Security Subsystem]], [[UltraBay|Ultrabay Plus]] drive, integrated Wireless LAN. The shell is titanium reinforced composite. The whole package was a bit heavier and thicker than both the T2x and the T4x series.

===ThinkPad T4x series===
Includes the [[:Category:T40|T40]], [[:Category:T41|T41]], [[:Category:T42|T42]], [[:Category:T43|T43]], and associated "p" series (for "performance"; e.g., [[:Category:T43p|T43p]]). A typical T4x weighs 2.2 kg (4.9 lb), slightly less than the [[#ThinkPad 600 series|600 series]], and features an [[Intel Pentium M (Dothan)]] Processor, a 14.1 or 15 inch LCD (XGA or SXGA+), an integrated GPU ([[Intel Graphics Media Accelerator 900]]) or a discrete GPU ([[ATI Mobility Radeon 7500]], [[ATI Mobility Radeon 9000|9000]], [[ATI Mobility Radeon X300|X300]], [[ATI Mobility FireGL 9000]], FireGL 9600, [[ATI Mobility FireGL T2| FireGL T2]] and [[ATI Mobility FireGL V3200|FireGL V3200]]), and a hard drive ranging in size from 30 to 100 GB with the [[Active Protection System]] to protect the hard drive ([[:Category:T41|T41]] and later models). "p" (mobile workstation) models are also available with a 14" SXGA+ or a 15 inch UXGA FlexView display with wide viewing angle and high density IPS technology with resolutions up to 1600x1200. These 15 inch display models weigh slightly more than their lesser brethren, with optical drive and battery, at 2.7 kg (5.9 lb). Some [[:Category:T42|T42]] and [[:Category:T43|T43]] models feature a biometric security system with [[Integrated Fingerprint Reader]].

===ThinkPad T6x series===
ThinkPad [[:Category:T60|T60]] contained the [[Intel Core Duo (Yonah)]]. It was paired with either a [[ATI Mobility Radeon X1300]] or [[ATI Mobility Radeon X1400|x1400]] or with an [[ATI Mobility FireGL V5200]] for the performance model. The [[:Category:T60|T60]] was also the first of its kind to support Wireless Wide Area Network (WWAN) out of the box if the option was selected.

The ThinkPad [[:Category:T60|T60]] refresh contained the [[Intel Core 2 Duo (Merom)]]. It gave a processing speed of up to twenty five percent faster than the [[Intel Core Duo (Yonah)|Yonah]] and introduced EM64T into the mobile realm. It was paired with either a [[ATI Mobility Radeon X1300]] or [[ATI Mobility Radeon X1400|x1400]] or with an [[ATI Mobility FireGL V5250]] for the performance model.

ThinkPad [[:Category:T61|T61]] features the Santa Rosa chipset, in addition to the existing [[Intel Core 2 Duo (Merom)]]. The designers found it prudent to move from an ATI based Mobility Radeon to NVIDIA's Quadro NVS series discrete video processors. The move also marked a more aggressive shift to the wide screen format. Introductory [[:Category:T61|T61]] models only shipped with a wide screen. In addition, the designers added a Roll Cage for the screen to decrease the likelihood of damage in the event of a fall. Finally fan blades were overhauled to decrease fan noise and temperature.

==ThinkPad X series==
===ThinkPad X12x series===
[[:Category:X121e|X121e]] with Intel i3 or AMD CPUs, appeared 2011.

===ThinkPad X2x series===
[[Intel Mobile Pentium III]] with [[ATI Rage Mobility M]] ([[:Category:X20|X20]], [[:Category:X21|X21]]) or [[Intel Mobile Pentium III-M]] with [[ATI Mobility Radeon 7000]] ([[:Category:X22|X22]], [[:Category:X23|X23]], [[:Category:X24|X24]]), sub-4 lb machines. Contained processors ranging from [[Intel Mobile Pentium III|MPIII]] 500 MHz to [[Intel Mobile Pentium III-M|PIII-M]] 1+ GHz. 12.1 inch XGA screens. Used miniPCI form factor cards, which supports modem and/or ethernet. With the [[:Category:X22|X22]] and later machines, provisions for wireless networking support are built into the chassis. [[UltraBay|UltraBay 2000]] optical drive support can be fitted via the [[UltraBase X2]] portable docking station option, and extended batteries can give the series a 5 hour running time.

===ThinkPad X3x series===
[[Intel Mobile Pentium III-M]] with [[Intel Graphics Technology]] ([[:Category:X30|X30]]) or [[Intel Pentium M (Banias)]]/[[Intel Pentium M (Dothan)|(Dothan)]] with [[ATI Mobility Radeon 7000]] ([[:Category:X31|X31]], [[:Category:X32|X32]]), 12.1 inch XGA screens, [[IrDA]], FireWire, Compact Flash card slot. No built-in optical drive. Like the X2x series [[UltraBay|UltraBay Plus]] optical drive support can be fitted via the [[UltraBase X3]] portable docking station option. As the [[UltraBase X3]] can take the same battery as the notebook, the running time can be increased to amazing 10 hours.

===ThinkPad X4x Series===
A continuation of the lightweight X series. Weighting in at 1.2 kg (2.7 lb), the lightest [[:Category:X41|X41]] is 25% lighter than its predecessor, the [[:Category:X31|X31]]. Part of the X4x series, the [[:Category:X41 Tablet|X41 Tablet]] is the first Tablet PC (convertible) ThinkPad. They also get [[UltraBay|UltraBay Slim]] optical drive support via the [[UltraBase X4]] portable docking station option, but it is not compatible with the [[:Category:X41 Tablet|X41 Tablet]].

===ThinkPad X6x Series===
Starting in 2006, the first models in X6x series were [[:Category:X60|X60]], lighter and smaller [[:Category:X60s|X60s]] and [[:Category:X60 Tablet|X60 Tablet]] (the two with slower CPU). These models featured [[:Intel_Core_Duo_(Yonah)|Intel Core]] CPUs, later Core 2.

Later, [[:Category:X61|X61]], [[:Category:X61s|X61s]] and [[:Category:X61 Tablet|X61 Tablet]] appeared. These ThinkPads are now migrated to the new Santa Rosa chipset, in addition to the existing [[:Intel_Core_2_Duo_(Merom)|Intel Core 2 (Merom)]] platform and has some design improvements. The X61 features full-blown Core 2 Duo processors, X61s and X61 Tablet can be configured only with low-voltage variants. In many benchmarks, the X61 proved, that it can be as fast as ThinkPad [[:Category:T61|T61]] with same configuration.

Unlike T61 and [[:Category:R61|R61]], the X61 series aren't available with widescreen display option.

X6x series ThinkPads fit in the [[UltraBase X6]], while X6x Tablets fit in [[X6 Tablet UltraBase]] docking stations.

==ThinkPad Edge Series==
This Series, originally introduced in early 2010 with the 13"(withdrawn), 14" and 15" models, are billed to "reflect a new progressive and strikingly clean appearance while retaining ThinkPad durability and reliability. For example, the laptops include spill-resistant keyboards and value-added ThinkVantage Technologies like the Active Protection System and Rescue and Recovery."[http://news.lenovo.com/article_display.cfm?article_id=1294]

Complete product details of current (not withdrawn) Edge Series devices can be found in the [http://www.lenovo.com/psref/pdf/edgebook.pdf PSRef for Lenovo ThinkPad Edge Notebooks]

{{Todo|Needs additional info and history added for each of the sub-categories below}}

===ThinkPad Edge 14" and 15" Series===
This series includes the [[:Category:Edge_14"|Edge 14"]] and [[:Category:Edge_15"|Edge 15"]] models

===ThinkPad Edge E220s===
The only Edge product in this series so far is the [[:Category:E220s|E220s]]

===ThinkPad Edge E4xx Series===
This series includes the [[:Category:E420|E420]], [[:Category:E420s|E420s]], [[:Category:E425|E425]], [[:Category:E430|E430]], [[:Category:E430c|E430c]] models

===ThinkPad Edge E5xx Series===
This series includes the [[:Category:E520|E520]], [[:Category:E525|E525]], [[:Category:E530|E530]], [[:Category:E530c|E530c]], and [[:Category:E325|E325]] models

===ThinkPad Edge Twist===
The [[:Category:Edge_Twist|Edge Twist]] is a bit of an odd member, as it is the only "convertible" one of the [[:Category:Edge|Edge]] series, and it's model name (S230u) does not begin with the usual "'''E'''". It's also the only one with a Multitouch capable display, nicely protected with "Gorilla Glass".

=Withdrawn Series=
==ThinkPad 200 series==
The 200 series ([[:Category:220|220]], [[:Category:230|230]], [[:Category:235|235]], [[:Category:240|240]] and their various sub series) was a subnotebook series. This means they were extremely small and light crossovers between notebooks and PDAs. The series ended with the [[:Category:240X|240X]]. With the changing from the numeric to the alphanumeric naming scheme in 2000, IBM stopped developing subnotebook class ThinkPads. Only in the Asia-Pacific only [[#ThinkPad S series|S series]] did in find a rather short revival.

==ThinkPad 300 series==
The 300 series ([[:Category:300|300]], [[:Category:310|310]], [[:Category:350|350]], [[:Category:360|360]], [[:Category:365E|365E]], [[:Category:380|380]], [[:Category:385ED|385ED]], [[:Category:390|390]] and their various sub series) was a long running value series starting at the [[Intel 386|Intel 386SL-33]] going all the way to the [[Intel Mobile Pentium III]]. The ThinkPad 300 was also produced for IBM by Zenith Data Systems. They were a bit large and slower than the more full featured models but offered a less expensive ThinkPad. The successor of this series is the [[#ThinkPad R series|R series]].

==ThinkPad 500 series==
The 500 series ([[:Category:500|500]], [[:Category:510Cs|510Cs]], [[:Category:560|560]], [[:Category:570|570]] and their various sub series) were the main line of the ultraportable ThinkPads. Starting with the [[IBM 486|IBM 486BL-25 Blue Lightening]] to the [[Intel Mobile Pentium III]], these machines had only a hard disk onboard. Any other drives were either external or available in the respective [[Docking Solutions]]. The successor of the 500 series is the [[#ThinkPad X series|X series]].

==ThinkPad 600 series==
The 600 series ([[:Category:600|600]], [[:Category:600D|600D]], [[:Category:600E|600E]] and [[:Category:600X|600X]]) are the direct predecessors of the [[#ThinkPad T series|T series]], and are legendary for their portability and sturdy construction. Most 600 series models packed a 13.3 inch LCD, [[Intel Mobile Pentium II]] or [[Intel Mobile Pentium III]] processor and full sized keyboard into a package weighing roughly 2.3 kg (5 lb). The [[UltraBay|UltraSlimBay]] was introduced with the 600 series. IBM was able to create this light, fully featured machine by using lightweight but strong carbon fibre composite plastics.

==ThinkPad 700 series==
The 700 series ([[:Category:700|700]], [[:Category:701C|701C]], [[:Category:730T|730T]], [[:Category:750|750]], [[:Category:755C|755C]], [[:Category:760E|760E]], [[:Category:765D|765D]], [[:Category:770|770]] and their various sub series) were the cutting edge Intel-based ThinkPads. They featured the best screens, largest hard drives and fastest processors available at the time.

==ThinkPad 800 series==
The PowerPC ThinkPad series, (800, [[:Category:820|820]], 821, 822, 823, [[:Category:850|850]], 851, [[:Category:860|860]]) were unique in that they ran on the PowerPC architecture, and not the x86 architecture. They all used the [[IBM PowerPC 603|IBM PowerPC 603e]] CPU. The 800 may have used a 603, and it is unclear if the 800 was experimental or not. All units used SCSI 2 instead of IDE. The units are believed to have all been extremely expensive, as the [[:Category:850|850]] cost upwards of $12,000 USD. The 800 series can run Windows NT 3.5 (probably 4.0 as well), OS/2, AIX 4.14, Solaris Desktop 2.5.1 PowerPC Edition and Linux.

==ThinkPad Transnote==
The IBM [[:Category:TransNote|TransNote]] was a pen based PC in a notebook. Data could not only be entered through keyboard, TrackPoint and TouchScreen, but also through a unique paper notepad with integrated digitizer which was produced in cooperation with Cross AT. This ThinkPad expanded on IBM's previous pen based notebooks ([[:Category:360P|360P]](E), [[:Category:730T|730T]](E), and 755(P).

==ThinkPad A series==
The A series was developed as an allround productivity machine, equipped with hardware powerful enough to make it a desktop replacement. Hence it was the biggest and heaviest ThinkPad series at its time, but also had features not even found in a [[#ThinkPad T series|T series]] of the same age. The A series was dropped in favour of the [[#ThinkPad G series|G series]] and [[#ThinkPad R series|R series]].

==ThinkPad G series==
The G series consists of only two models so far, the [[:Category:G40|G40]] and [[:Category:G41|G41]]. Being large and heavy machines, equipped with powerful desktop processors, this line of ThinkPads is consequently specialised in serving as a desktop replacement.

==ThinkPad i series==
The i Series introduced the [[ThinkLight]] and were also the first notebooks equipped with Wireless LAN. Some types from the i Series allow playing music CDs without turning on the computer.

==ThinkPad S series==
A subnotebook series consisting of only two models: the [[:Category:S30|S30]] and [[:Category:S31|S31]].
[[Category:Models]]

==ThinkPad Z series==
The widescreen ThinkPad build to offer the ultimate multimedia experience. Internal similar to the [[#ThinkPad T series|T series]], but they have a widescreen and are available with a Titanium Special Edition Cover on selected models. This was the first ThinkPad series completely developed by Lenovo. This series was discontinued as the [[#ThinkPad T series|T series]] are available with widescreen displays.

===ThinkPad Z60x Series===
The first widescreen ThinkPads, internal similar to the T4x series, but they are available with 14" ([[:Category:Z60t|Z60t]]) or 15.4" ([[:Category:Z60m|Z60m]]) widescreens (some with optional MaxBright-technology). Travel weight starting at 4.1 lb and they are less than 1.1" thin. They are the first ThinkPads completely developed by Lenovo.

===ThinkPad Z61x Series===
Second generation Z series, upgraded to the internal technology level of the T60 series ThinkPads.

=Adding a new series=

Please refer to [[Adding a new ThinkPad series or category to ThinkWiki]] for instructions on how to add a new ThinkPad series to ThinkWiki.

Installing Ubuntu 12.10 on Thinkpad Twist

2013-01-29T02:30:15Z

Shane: /* Key Bindings */

Installing Ubuntu 12.10 on the Lenovo Twist ultrabook

==Overview==
===Specs===
*Lenovo Twist - S230u (model 3347-CTO)
*Ubuntu 12.10 - 64bit (ubuntu-12.10-desktop-amd64.iso)

{{Todo|DMESG etc to follow}}

===What Works===
*Touch screen - single touch only {{Fixme|Needs review. Multitouch worked for me --[[User:Shane|Shane]] 03:20, 29 January 2013 (CET)}}
*Sound, WLAN, camera, SSD works
*WWAN works

===What Does Not Work===
*GPS does not work

==Install==
{{WARN|Since this device ships with the BIOS set to boot from '''UEFI only'''. You must enable '''Legacy''' boot option in the BIOS before you can begin installing Ubuntu.}}
# Enable Legacy boot in BIOS
# Plug in USB drive containing Ubuntu 12.10 install image
# Turn power on
# Proceed through install
# Reboot when done
# Log in and install any available updates (rebooting as needed)

==Customize==

===Additional Packages===
Much of what follows depends on some additional tools. You can run the following command to install them all at once:

$ sudo apt-get install \
mesa-utils # resolves "Graphics Unknown" reported in system info \
input-utils # Misc tools to assist in detecting and configuring special HW keys/events

===Graphics===
====Fix "unknown" graphics adapter====
Install mesa-utils, which adds glxinfo, used by system info to report the "friendly" graphics device name
{{cmduser|sudo apt-get install mesa-utils}}
====Enable SNA====
To enable SNA (vs. default UXA) in X, create an Xorg config option file (/usr/share/X11/xorg.conf.d/20-enable-sna.conf) as follows:
# cat <<EOF > /usr/share/X11/xorg.conf.d/20-enable-sna.conf
Section "Device"
Identifier "Card0"
Driver "intel"
Option "AccelMethod" "sna"
EndSection
EOF
===Key Bindings===
{{HINT|Lenovo's intended behavior for the Function keys in Windows 8 is defined in the their [http://download.lenovo.com/ibmdl/pub/pc/pccbbs/mobiles_pdf/s230u_twist_ug_en.pdf Lenovo Twist User Manual])}}
{| class="wikitable"
!Button!!Purpose!!HKEY!!Scan Code!!Key Code!!Key Sym!!Bind To!!Works Out of Box||Works with Tweaking
|-
|{{key|F1}}||"Mute" key (toggle speaker muting)||{{Cunk}}||{{Cunk}}||113||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F2}}||"Volume Down" key||{{Cunk}}||{{Cunk}}||114||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F3}}||"Volume Up" key||{{Cunk}}||{{Cunk}}||115||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F4}}||"Mic" key (toggle mic muting)||00000080 0000101b||0x1A||micmute||{{Cunk}}||/etc/acpi/event/lenovo-micmute calls amixer to toggle Capture device||{{Cno}}||{{Cyes}}
|-
|{{key|F5}}||"Brightness Down" key||{{Cunk}}||{{Cunk}}||224||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F6}}||"Brightness Up" key||{{Cunk}}||{{Cunk}}||225||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F7}}||"Display" key (toggle display output selection)||{{Cunk}}||0x06||227||switchvideomode|| ||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F8}}||"Radio" key (toggle Airplane mode)||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F9}}||"Settings" key (launch settings charm/app)||00000080 0000101d||0x1C||{{Cunk}}||{{Cunk}}||gnome-control-center||{{Cno}}||{{Cyes}}
|-
|{{key|F10}}||"Search" key (launch search charm/app)||00000080 0000101e||0x1D||{{Cunk}}||{{Cunk}}||Meta-f (Unity file search)||{{Cno}}||{{Cyes}}
|-
|{{key|F11}}||"Task Manager" key (show opened programs)||00000080 0000101f||0x1E||{{Cunk}}||{{Cunk}}||Alt-Tab (task switcher)||{{Cno}}||{{Cyes}}
|-
|{{key|F12}}||"All Apps" key (show picker for all installed programs)||00000080 00001020||0x1F||{{Cunk}}||{{Cunk}}||Meta||{{Cno}}||{{Cyes}}
|-
|Lid flipped||Enable tablet mode||00000080 000060c0 00000080 00005009||{{Cunk}}||''reserved''||{{Cunk}}||Launch on-screen keyboard? Disable TouchPad/Enable TouchScreen||{{Cno}}||{{Cyes}}
|-
|Lid normal||Disable tablet mode||00000080 000060c0 00000080 0000500a||{{Cunk}}||''reserved''||{{Cunk}}||Hide on-screen-keyboard? Enable TouchPad/Disable TouchScreen||{{Cno}}||{{Cyes}}
|-
|{{key|Rotate}}||Toggle screen rotation||00000080 00006020||{{Cunk}}||{{Cunk}}||{{Cunk}}||/etc/acpi/event/lenovo-twist-rotate calls notify-send ATM, since xrandr is crashing X :/||{{Cno}}||{{Fixme|X crashing}}
|}

===Toggling TouchPad===
One of the very annoying things about the available settings in 12.10 is that there no longer appears to be a way to completely disable the Synaptics TouchPad device from the UI. Also, no touchpad indicator applet appears to be available in the standard repos.

Related to this, is the very poor interaction between the TouchPad and the TouchScreen (Atmel maXTouch Digitizer) when the screen is folded into tablet mode. The result is the cursor begins to jump around and get "twitchy".

So, to solve this, there are two things to address:
# How to disable/enable the TouchPad on demand (hotkey event or other keybinding)
# How to disable/enable the TouchPad automatically when tablet mode is enabled/disabled
====On Demand====
To add new, custom, key bindings, launch the "'''Keyboard'''" editor:

{{cmduser|gnome-control-center keyboard}}

Then navigate to the "'''Shortcuts'''" tab, select the "'''Custom Shortcuts'''" and then click the "'''+'''" button and provide the name and command for your binding. For example:

[[Image:Add-custom-keybinding.png]]

In this example, I tell it to invoke the script <tt>~/toggle-touchpad.sh</tt>, which you can create like this:

cat <<EOF > ~/toggle-touchpad.sh
#!/bin/bash
declare -A TOGGLE=([true]=false [false]=true)
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad"
KEY="touchpad-enabled"
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}
EOF

Or, use this one-line version directly in the "Command:" field:

/bin/bash -c 'declare -A TOGGLE=([true]=false [false]=true) && \
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad" && \
KEY="touchpad-enabled" && \
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}'

Finally, click the word "'''disabled'''" on the newly added custom shortcut and hit the button or key combination you want to use for toggling the TouchPads enabled state.

====Automatic====
To solve the "jitter" problem with the mouse when the Twist is in tablet mode, a few additions to the acpi events handlers is all that's required. The following need to be run as root, or via sudo.

First, we need to configure acpid to recognize the events triggered when the Twist changes tablet mode state:

cat <<EOF > /etc/acpi/events/twist-tablet-enabled
# /etc/acpi/events/twist-tablet-enabled
# This is called when the lid is placed in tablet position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 00005009
action=/etc/acpi/twist-tabletmode.sh 1
EOF

cat <<EOF > /etc/acpi/events/twist-tablet-disabled
# /etc/acpi/events/twist-tablet-disabled
# This is called when the lid is placed in normal position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 0000500a
action=/etc/acpi/twist-tabletmode.sh 0
EOF

# Now, restart acpid so it can re-read the event filters, including the ones you just added
killall -SIGHUP acpid

Second, create the referenced action script (<tt>/etc/acpi/twist-tabletmode.sh</tt>):

cat <<EOF > /etc/acpi/twist-tabletmode.sh
#!/bin/bash
[ -f /usr/share/acpi-support/state-funcs ] || exit 0

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

getXconsole

# If passed in a (valid) arg, use it
[ "$1" ] && [ "$1" = "0" -o "$1" = "1" ] && MODE=${MODE:=${1}}

# Otherwise, use current state from thinkpad acpi sysfs entry, as described at
# http://www.kernel.org/doc/Documentation/laptops/thinkpad-acpi.txt
MODE=${MODE:="$(cat /sys/devices/platform/thinkpad_acpi/hotkey_tablet_mode)"}

TOUCHPAD_NAME="TouchPad"
TOUCHPAD_STATES=("enable" "disable")
TOUCHPAD_CMD=${TOUCHPAD_STATES[$MODE]}

TOUCHSCREEN_NAME="maXTouch"
TOUCHSCREEN_STATES=("disable" "enable")
TOUCHSCREEN_CMD=${TOUCHSCREEN_STATES[$MODE]}

# Get xinput ids for the TouchPad and TouchScreen devices
TOUCHPAD_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHPAD_NAME)")
TOUCHSCREEN_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHSCREEN_NAME)")

# Get users configured TouchPad state preference and honor it.
TOUCHPAD_ENABLED=$(sudo -iu $user gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled)

# Only change TouchPad state if touchpad-enabled=true and a device was found
[ ${#TOUCHPAD_ID} -gt 0 -a "$TOUCHPAD_ENABLED" = "true" ] && xinput $TOUCHPAD_CMD $TOUCHPAD_ID

# Only change TouchScreen state if a device was found
[ ${#TOUCHSCREEN_ID} -gt 0 ] && xinput $TOUCHSCREEN_CMD $TOUCHSCREEN_ID

EOF

# Make it executable...
chmod +x /etc/acpi/twist-tabletmode.sh

That's it!!! Time to test it out by converting the Twist into tablet mode. You can crack the lid about 1½ inches before the Twist will exit tablet mode. While in tablet mode, crack the lid and confirm that touching the TouchPad has no effect.

====More Detail====
Initially, I pursued this as an XInput issue, only to discover later after digging through this to solve the automatice use case during tablet mode changes, that there is a GSettings key that also is at play here. As I soon discovered, the GSettings key will actually determine if any changes vi xinput will be honored.

=====XInput Method=====
First, determine the xinput device id for the TouchPad

{{cmduser|xinput list --name-only|grep -im1 TouchPad}} 
{{cmdresult|SynPS/2 Synaptics TouchPad}}

Next, using this name, get the xinput device id for it

{{cmduser|xinput list --id-only "SynPS/2 Synaptics TouchPad"}} 
{{cmdresult|12}}

Now, to disable and then enable it, simply run

{{cmduser|xinput disable 12}} 
{{cmduser|xinput enable 12}}

=====GSettings Method=====
There is a GSettings key in the <tt>org.gnome.settings-daemon.peripherals.touchpad</tt> schema called <tt>touchpad-enabled</tt>. To get and set this key, you use the <tt>gsettings</tt> command from a terminal that is associated with your active user session:

Get the current value of touchpad-enabled

{{cmduser|gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled}} 
{{cmdresult|true}}

To disable the TouchPad, set touchpad-enabled to false

{{cmduser|gsettings set org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled false}}

Now check the value of touchpad-enabled, should be false...

{{cmduser|gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled}} 
{{cmdresult|false}}

===Think Light Control===
You can control red the LED in the "i" of the "ThinkPad" logo as follows

Turn on the LED...

{{cmdroot|echo 0 on > /proc/acpi/ibm/led}}

Turn off the LED...

{{cmdroot|echo 0 off > /proc/acpi/ibm/led}}

Blink the LED

{{cmdroot|echo 0 blink > /proc/acpi/ibm/led}}

===Headphone Plug Events===
On the Twist, when I was testing this, /dev/input/event12 was where Headphone jack plug and unplug events were being reported

Install the input-utils package and then run:

# input-events 12
/dev/input/event12
bustype : (null)
vendor : 0x0
product : 0x0
version : 0
name : "HDA Intel PCH Headphone"
phys : "ALSA"
bits ev : EV_SYN EV_SW

waiting for events
11:54:14.257360: EV_SW SW_HEADPHONE_INSERT 1
11:54:14.257361: EV_SYN code=0 value=0
11:54:14.587882: EV_SW SW_HEADPHONE_INSERT 0
11:54:14.587883: EV_SYN code=0 value=0

{{NOTE|
<tt>'''SW_HEADPHONE_INSERT''' 1</tt> represents the "'''plug'''" event 
<tt>'''SW_HEADPHONE_INSERT''' 0</tt> represents the "'''unplug'''" event
}}

===Input Mapping===
The following table is derived from the output of the {{cmdroot|lsinput}} command (part of the input-utils package)

{| class="wikitable"
!/dev path!!name!!phys!!ev flags
|-
|/dev/input/event0||Power Button||PNP0C0C/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event1||Lid Switch||PNP0C0D/button/input0||EV_SYN EV_SW
|-
|/dev/input/event2||Power Button||LNXPWRBN/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event3||AT Translated Set 2 keyboard||isa0060/serio0/input0||EV_SYN EV_KEY EV_MSC EV_LED EV_REP
|-
|/dev/input/event4||ThinkPad Extra Buttons||thinkpad_acpi/input0||EV_SYN EV_KEY EV_MSC EV_SW
|-
|/dev/input/event5||Atmel Atmel maXTouch Digitizer||usb-0000:00:1a.0-1.1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event6||Integrated Camera||usb-0000:00:1d.0-1.6/button||EV_SYN EV_KEY
|-
|/dev/input/event7||Video Bus||LNXVIDEO/video/input0||EV_SYN EV_KEY
|-
|/dev/input/event8||SynPS/2 Synaptics TouchPad||isa0060/serio1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event9||HDA Intel PCH HDMI/DP,pcm=7||ALSA||EV_SYN EV_SW
|-
|/dev/input/event10||HDA Intel PCH HDMI/DP,pcm=3||ALSA||EV_SYN EV_SW
|-
|/dev/input/event11||HDA Intel PCH Mic||ALSA||EV_SYN EV_SW
|-
|/dev/input/event12||HDA Intel PCH Headphone||ALSA||EV_SYN EV_SW
|-
|/dev/input/event13||TPPS/2 IBM TrackPoint||synaptics-pt/serio0/input0||EV_SYN EV_KEY EV_REL
|}

[[Category:Edge Twist]]

Installing Ubuntu 12.10 on Thinkpad Twist

2013-01-29T02:28:31Z

Shane: /* GSettings Method */

Installing Ubuntu 12.10 on the Lenovo Twist ultrabook

==Overview==
===Specs===
*Lenovo Twist - S230u (model 3347-CTO)
*Ubuntu 12.10 - 64bit (ubuntu-12.10-desktop-amd64.iso)

{{Todo|DMESG etc to follow}}

===What Works===
*Touch screen - single touch only {{Fixme|Needs review. Multitouch worked for me --[[User:Shane|Shane]] 03:20, 29 January 2013 (CET)}}
*Sound, WLAN, camera, SSD works
*WWAN works

===What Does Not Work===
*GPS does not work

==Install==
{{WARN|Since this device ships with the BIOS set to boot from '''UEFI only'''. You must enable '''Legacy''' boot option in the BIOS before you can begin installing Ubuntu.}}
# Enable Legacy boot in BIOS
# Plug in USB drive containing Ubuntu 12.10 install image
# Turn power on
# Proceed through install
# Reboot when done
# Log in and install any available updates (rebooting as needed)

==Customize==

===Additional Packages===
Much of what follows depends on some additional tools. You can run the following command to install them all at once:

$ sudo apt-get install \
mesa-utils # resolves "Graphics Unknown" reported in system info \
input-utils # Misc tools to assist in detecting and configuring special HW keys/events

===Graphics===
====Fix "unknown" graphics adapter====
Install mesa-utils, which adds glxinfo, used by system info to report the "friendly" graphics device name
{{cmduser|sudo apt-get install mesa-utils}}
====Enable SNA====
To enable SNA (vs. default UXA) in X, create an Xorg config option file (/usr/share/X11/xorg.conf.d/20-enable-sna.conf) as follows:
# cat <<EOF > /usr/share/X11/xorg.conf.d/20-enable-sna.conf
Section "Device"
Identifier "Card0"
Driver "intel"
Option "AccelMethod" "sna"
EndSection
EOF
===Key Bindings===
{{HINT|Lenovo's intended behavior for the Function keys in Windows 8 is defined in the their [http://download.lenovo.com/ibmdl/pub/pc/pccbbs/mobiles_pdf/s230u_twist_ug_en.pdf Lenovo Twist User Manual])}}
{| class="wikitable"
!Button!!Purpose!!HKEY!!Scan Code!!Key Code!!Key Sym!!Bind To!!Works Out of Box||Works with Tweaking
|-
|{{key|F1}}||"Mute" key (toggle speaker muting)||{{Cunk}}||{{Cunk}}||113||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F2}}||"Volume Down" key||{{Cunk}}||{{Cunk}}||114||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F3}}||"Volume Up" key||{{Cunk}}||{{Cunk}}||115||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F4}}||"Mic" key (toggle mic muting)||00000080 0000101b||0x1A||micmute||{{Cunk}}||/etc/acpi/event/lenovo-micmute calls amixer to toggle Capture device||{{Cno}}||{{Cyes}}
|-
|{{key|F5}}||"Brightness Down" key||{{Cunk}}||{{Cunk}}||224||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F6}}||"Brightness Up" key||{{Cunk}}||{{Cunk}}||225||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F7}}||"Display" key (toggle display output selection)||{{Cunk}}||0x06||227||switchvideomode|| ||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F8}}||"Radio" key (toggle Airplane mode)||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F9}}||"Settings" key (launch settings charm/app)||00000080 0000101d||0x1C||{{Cunk}}||{{Cunk}}||gnome-control-center||{{Cno}}||{{Cyes}}
|-
|{{key|F10}}||"Search" key (launch search charm/app)||00000080 0000101e||0x1D||{{Cunk}}||{{Cunk}}||Meta-f (Unity file search)||{{Cno}}||{{Cyes}}
|-
|{{key|F11}}||"Task Manager" key (show opened programs)||00000080 0000101f||0x1E||{{Cunk}}||{{Cunk}}||Alt-Tab (task switcher)||{{Cno}}||{{Cyes}}
|-
|{{key|F12}}||"All Apps" key (show picker for all installed programs)||00000080 00001020||0x1F||{{Cunk}}||{{Cunk}}||Meta||{{Cno}}||{{Cyes}}
|-
|Lid flipped||Enable tablet mode||00000080 000060c0 00000080 00005009||{{Cunk}}||''reserved''||{{Cunk}}||Launch on-screen keyboard||{{Cno}}||{{Cyes}}
|-
|Lid normal||Disable tablet mode||00000080 000060c0 00000080 0000500a||{{Cunk}}||''reserved''||{{Cunk}}||Hide on-screen-keyboard||{{Cno}}||{{Cyes}}
|-
|{{key|Rotate}}||Toggle screen rotation||00000080 00006020||{{Cunk}}||{{Cunk}}||{{Cunk}}||/etc/acpi/event/lenovo-twist-rotate calls notify-send ATM, since xrandr is crashing X :/||{{Cno}}||{{Fixme|X crashing}}
|}
===Toggling TouchPad===
One of the very annoying things about the available settings in 12.10 is that there no longer appears to be a way to completely disable the Synaptics TouchPad device from the UI. Also, no touchpad indicator applet appears to be available in the standard repos.

Related to this, is the very poor interaction between the TouchPad and the TouchScreen (Atmel maXTouch Digitizer) when the screen is folded into tablet mode. The result is the cursor begins to jump around and get "twitchy".

So, to solve this, there are two things to address:
# How to disable/enable the TouchPad on demand (hotkey event or other keybinding)
# How to disable/enable the TouchPad automatically when tablet mode is enabled/disabled
====On Demand====
To add new, custom, key bindings, launch the "'''Keyboard'''" editor:

{{cmduser|gnome-control-center keyboard}}

Then navigate to the "'''Shortcuts'''" tab, select the "'''Custom Shortcuts'''" and then click the "'''+'''" button and provide the name and command for your binding. For example:

[[Image:Add-custom-keybinding.png]]

In this example, I tell it to invoke the script <tt>~/toggle-touchpad.sh</tt>, which you can create like this:

cat <<EOF > ~/toggle-touchpad.sh
#!/bin/bash
declare -A TOGGLE=([true]=false [false]=true)
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad"
KEY="touchpad-enabled"
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}
EOF

Or, use this one-line version directly in the "Command:" field:

/bin/bash -c 'declare -A TOGGLE=([true]=false [false]=true) && \
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad" && \
KEY="touchpad-enabled" && \
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}'

Finally, click the word "'''disabled'''" on the newly added custom shortcut and hit the button or key combination you want to use for toggling the TouchPads enabled state.

====Automatic====
To solve the "jitter" problem with the mouse when the Twist is in tablet mode, a few additions to the acpi events handlers is all that's required. The following need to be run as root, or via sudo.

First, we need to configure acpid to recognize the events triggered when the Twist changes tablet mode state:

cat <<EOF > /etc/acpi/events/twist-tablet-enabled
# /etc/acpi/events/twist-tablet-enabled
# This is called when the lid is placed in tablet position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 00005009
action=/etc/acpi/twist-tabletmode.sh 1
EOF

cat <<EOF > /etc/acpi/events/twist-tablet-disabled
# /etc/acpi/events/twist-tablet-disabled
# This is called when the lid is placed in normal position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 0000500a
action=/etc/acpi/twist-tabletmode.sh 0
EOF

# Now, restart acpid so it can re-read the event filters, including the ones you just added
killall -SIGHUP acpid

Second, create the referenced action script (<tt>/etc/acpi/twist-tabletmode.sh</tt>):

cat <<EOF > /etc/acpi/twist-tabletmode.sh
#!/bin/bash
[ -f /usr/share/acpi-support/state-funcs ] || exit 0

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

getXconsole

# If passed in a (valid) arg, use it
[ "$1" ] && [ "$1" = "0" -o "$1" = "1" ] && MODE=${MODE:=${1}}

# Otherwise, use current state from thinkpad acpi sysfs entry, as described at
# http://www.kernel.org/doc/Documentation/laptops/thinkpad-acpi.txt
MODE=${MODE:="$(cat /sys/devices/platform/thinkpad_acpi/hotkey_tablet_mode)"}

TOUCHPAD_NAME="TouchPad"
TOUCHPAD_STATES=("enable" "disable")
TOUCHPAD_CMD=${TOUCHPAD_STATES[$MODE]}

TOUCHSCREEN_NAME="maXTouch"
TOUCHSCREEN_STATES=("disable" "enable")
TOUCHSCREEN_CMD=${TOUCHSCREEN_STATES[$MODE]}

# Get xinput ids for the TouchPad and TouchScreen devices
TOUCHPAD_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHPAD_NAME)")
TOUCHSCREEN_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHSCREEN_NAME)")

# Get users configured TouchPad state preference and honor it.
TOUCHPAD_ENABLED=$(sudo -iu $user gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled)

# Only change TouchPad state if touchpad-enabled=true and a device was found
[ ${#TOUCHPAD_ID} -gt 0 -a "$TOUCHPAD_ENABLED" = "true" ] && xinput $TOUCHPAD_CMD $TOUCHPAD_ID

# Only change TouchScreen state if a device was found
[ ${#TOUCHSCREEN_ID} -gt 0 ] && xinput $TOUCHSCREEN_CMD $TOUCHSCREEN_ID

EOF

# Make it executable...
chmod +x /etc/acpi/twist-tabletmode.sh

That's it!!! Time to test it out by converting the Twist into tablet mode. You can crack the lid about 1½ inches before the Twist will exit tablet mode. While in tablet mode, crack the lid and confirm that touching the TouchPad has no effect.

====More Detail====
Initially, I pursued this as an XInput issue, only to discover later after digging through this to solve the automatice use case during tablet mode changes, that there is a GSettings key that also is at play here. As I soon discovered, the GSettings key will actually determine if any changes vi xinput will be honored.

=====XInput Method=====
First, determine the xinput device id for the TouchPad

{{cmduser|xinput list --name-only|grep -im1 TouchPad}} 
{{cmdresult|SynPS/2 Synaptics TouchPad}}

Next, using this name, get the xinput device id for it

{{cmduser|xinput list --id-only "SynPS/2 Synaptics TouchPad"}} 
{{cmdresult|12}}

Now, to disable and then enable it, simply run

{{cmduser|xinput disable 12}} 
{{cmduser|xinput enable 12}}

=====GSettings Method=====
There is a GSettings key in the <tt>org.gnome.settings-daemon.peripherals.touchpad</tt> schema called <tt>touchpad-enabled</tt>. To get and set this key, you use the <tt>gsettings</tt> command from a terminal that is associated with your active user session:

Get the current value of touchpad-enabled

{{cmduser|gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled}} 
{{cmdresult|true}}

To disable the TouchPad, set touchpad-enabled to false

{{cmduser|gsettings set org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled false}}

Now check the value of touchpad-enabled, should be false...

{{cmduser|gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled}} 
{{cmdresult|false}}

===Think Light Control===
You can control red the LED in the "i" of the "ThinkPad" logo as follows

Turn on the LED...

{{cmdroot|echo 0 on > /proc/acpi/ibm/led}}

Turn off the LED...

{{cmdroot|echo 0 off > /proc/acpi/ibm/led}}

Blink the LED

{{cmdroot|echo 0 blink > /proc/acpi/ibm/led}}

===Headphone Plug Events===
On the Twist, when I was testing this, /dev/input/event12 was where Headphone jack plug and unplug events were being reported

Install the input-utils package and then run:

# input-events 12
/dev/input/event12
bustype : (null)
vendor : 0x0
product : 0x0
version : 0
name : "HDA Intel PCH Headphone"
phys : "ALSA"
bits ev : EV_SYN EV_SW

waiting for events
11:54:14.257360: EV_SW SW_HEADPHONE_INSERT 1
11:54:14.257361: EV_SYN code=0 value=0
11:54:14.587882: EV_SW SW_HEADPHONE_INSERT 0
11:54:14.587883: EV_SYN code=0 value=0

{{NOTE|
<tt>'''SW_HEADPHONE_INSERT''' 1</tt> represents the "'''plug'''" event 
<tt>'''SW_HEADPHONE_INSERT''' 0</tt> represents the "'''unplug'''" event
}}

===Input Mapping===
The following table is derived from the output of the {{cmdroot|lsinput}} command (part of the input-utils package)

{| class="wikitable"
!/dev path!!name!!phys!!ev flags
|-
|/dev/input/event0||Power Button||PNP0C0C/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event1||Lid Switch||PNP0C0D/button/input0||EV_SYN EV_SW
|-
|/dev/input/event2||Power Button||LNXPWRBN/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event3||AT Translated Set 2 keyboard||isa0060/serio0/input0||EV_SYN EV_KEY EV_MSC EV_LED EV_REP
|-
|/dev/input/event4||ThinkPad Extra Buttons||thinkpad_acpi/input0||EV_SYN EV_KEY EV_MSC EV_SW
|-
|/dev/input/event5||Atmel Atmel maXTouch Digitizer||usb-0000:00:1a.0-1.1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event6||Integrated Camera||usb-0000:00:1d.0-1.6/button||EV_SYN EV_KEY
|-
|/dev/input/event7||Video Bus||LNXVIDEO/video/input0||EV_SYN EV_KEY
|-
|/dev/input/event8||SynPS/2 Synaptics TouchPad||isa0060/serio1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event9||HDA Intel PCH HDMI/DP,pcm=7||ALSA||EV_SYN EV_SW
|-
|/dev/input/event10||HDA Intel PCH HDMI/DP,pcm=3||ALSA||EV_SYN EV_SW
|-
|/dev/input/event11||HDA Intel PCH Mic||ALSA||EV_SYN EV_SW
|-
|/dev/input/event12||HDA Intel PCH Headphone||ALSA||EV_SYN EV_SW
|-
|/dev/input/event13||TPPS/2 IBM TrackPoint||synaptics-pt/serio0/input0||EV_SYN EV_KEY EV_REL
|}

[[Category:Edge Twist]]

Installing Ubuntu 12.10 on Thinkpad Twist

2013-01-29T02:25:53Z

Shane: /* On Demand */

Installing Ubuntu 12.10 on the Lenovo Twist ultrabook

==Overview==
===Specs===
*Lenovo Twist - S230u (model 3347-CTO)
*Ubuntu 12.10 - 64bit (ubuntu-12.10-desktop-amd64.iso)

{{Todo|DMESG etc to follow}}

===What Works===
*Touch screen - single touch only {{Fixme|Needs review. Multitouch worked for me --[[User:Shane|Shane]] 03:20, 29 January 2013 (CET)}}
*Sound, WLAN, camera, SSD works
*WWAN works

===What Does Not Work===
*GPS does not work

==Install==
{{WARN|Since this device ships with the BIOS set to boot from '''UEFI only'''. You must enable '''Legacy''' boot option in the BIOS before you can begin installing Ubuntu.}}
# Enable Legacy boot in BIOS
# Plug in USB drive containing Ubuntu 12.10 install image
# Turn power on
# Proceed through install
# Reboot when done
# Log in and install any available updates (rebooting as needed)

==Customize==

===Additional Packages===
Much of what follows depends on some additional tools. You can run the following command to install them all at once:

$ sudo apt-get install \
mesa-utils # resolves "Graphics Unknown" reported in system info \
input-utils # Misc tools to assist in detecting and configuring special HW keys/events

===Graphics===
====Fix "unknown" graphics adapter====
Install mesa-utils, which adds glxinfo, used by system info to report the "friendly" graphics device name
{{cmduser|sudo apt-get install mesa-utils}}
====Enable SNA====
To enable SNA (vs. default UXA) in X, create an Xorg config option file (/usr/share/X11/xorg.conf.d/20-enable-sna.conf) as follows:
# cat <<EOF > /usr/share/X11/xorg.conf.d/20-enable-sna.conf
Section "Device"
Identifier "Card0"
Driver "intel"
Option "AccelMethod" "sna"
EndSection
EOF
===Key Bindings===
{{HINT|Lenovo's intended behavior for the Function keys in Windows 8 is defined in the their [http://download.lenovo.com/ibmdl/pub/pc/pccbbs/mobiles_pdf/s230u_twist_ug_en.pdf Lenovo Twist User Manual])}}
{| class="wikitable"
!Button!!Purpose!!HKEY!!Scan Code!!Key Code!!Key Sym!!Bind To!!Works Out of Box||Works with Tweaking
|-
|{{key|F1}}||"Mute" key (toggle speaker muting)||{{Cunk}}||{{Cunk}}||113||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F2}}||"Volume Down" key||{{Cunk}}||{{Cunk}}||114||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F3}}||"Volume Up" key||{{Cunk}}||{{Cunk}}||115||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F4}}||"Mic" key (toggle mic muting)||00000080 0000101b||0x1A||micmute||{{Cunk}}||/etc/acpi/event/lenovo-micmute calls amixer to toggle Capture device||{{Cno}}||{{Cyes}}
|-
|{{key|F5}}||"Brightness Down" key||{{Cunk}}||{{Cunk}}||224||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F6}}||"Brightness Up" key||{{Cunk}}||{{Cunk}}||225||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F7}}||"Display" key (toggle display output selection)||{{Cunk}}||0x06||227||switchvideomode|| ||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F8}}||"Radio" key (toggle Airplane mode)||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F9}}||"Settings" key (launch settings charm/app)||00000080 0000101d||0x1C||{{Cunk}}||{{Cunk}}||gnome-control-center||{{Cno}}||{{Cyes}}
|-
|{{key|F10}}||"Search" key (launch search charm/app)||00000080 0000101e||0x1D||{{Cunk}}||{{Cunk}}||Meta-f (Unity file search)||{{Cno}}||{{Cyes}}
|-
|{{key|F11}}||"Task Manager" key (show opened programs)||00000080 0000101f||0x1E||{{Cunk}}||{{Cunk}}||Alt-Tab (task switcher)||{{Cno}}||{{Cyes}}
|-
|{{key|F12}}||"All Apps" key (show picker for all installed programs)||00000080 00001020||0x1F||{{Cunk}}||{{Cunk}}||Meta||{{Cno}}||{{Cyes}}
|-
|Lid flipped||Enable tablet mode||00000080 000060c0 00000080 00005009||{{Cunk}}||''reserved''||{{Cunk}}||Launch on-screen keyboard||{{Cno}}||{{Cyes}}
|-
|Lid normal||Disable tablet mode||00000080 000060c0 00000080 0000500a||{{Cunk}}||''reserved''||{{Cunk}}||Hide on-screen-keyboard||{{Cno}}||{{Cyes}}
|-
|{{key|Rotate}}||Toggle screen rotation||00000080 00006020||{{Cunk}}||{{Cunk}}||{{Cunk}}||/etc/acpi/event/lenovo-twist-rotate calls notify-send ATM, since xrandr is crashing X :/||{{Cno}}||{{Fixme|X crashing}}
|}
===Toggling TouchPad===
One of the very annoying things about the available settings in 12.10 is that there no longer appears to be a way to completely disable the Synaptics TouchPad device from the UI. Also, no touchpad indicator applet appears to be available in the standard repos.

Related to this, is the very poor interaction between the TouchPad and the TouchScreen (Atmel maXTouch Digitizer) when the screen is folded into tablet mode. The result is the cursor begins to jump around and get "twitchy".

So, to solve this, there are two things to address:
# How to disable/enable the TouchPad on demand (hotkey event or other keybinding)
# How to disable/enable the TouchPad automatically when tablet mode is enabled/disabled
====On Demand====
To add new, custom, key bindings, launch the "'''Keyboard'''" editor:

{{cmduser|gnome-control-center keyboard}}

Then navigate to the "'''Shortcuts'''" tab, select the "'''Custom Shortcuts'''" and then click the "'''+'''" button and provide the name and command for your binding. For example:

[[Image:Add-custom-keybinding.png]]

In this example, I tell it to invoke the script <tt>~/toggle-touchpad.sh</tt>, which you can create like this:

cat <<EOF > ~/toggle-touchpad.sh
#!/bin/bash
declare -A TOGGLE=([true]=false [false]=true)
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad"
KEY="touchpad-enabled"
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}
EOF

Or, use this one-line version directly in the "Command:" field:

/bin/bash -c 'declare -A TOGGLE=([true]=false [false]=true) && \
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad" && \
KEY="touchpad-enabled" && \
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}'

Finally, click the word "'''disabled'''" on the newly added custom shortcut and hit the button or key combination you want to use for toggling the TouchPads enabled state.

====Automatic====
To solve the "jitter" problem with the mouse when the Twist is in tablet mode, a few additions to the acpi events handlers is all that's required. The following need to be run as root, or via sudo.

First, we need to configure acpid to recognize the events triggered when the Twist changes tablet mode state:

cat <<EOF > /etc/acpi/events/twist-tablet-enabled
# /etc/acpi/events/twist-tablet-enabled
# This is called when the lid is placed in tablet position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 00005009
action=/etc/acpi/twist-tabletmode.sh 1
EOF

cat <<EOF > /etc/acpi/events/twist-tablet-disabled
# /etc/acpi/events/twist-tablet-disabled
# This is called when the lid is placed in normal position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 0000500a
action=/etc/acpi/twist-tabletmode.sh 0
EOF

# Now, restart acpid so it can re-read the event filters, including the ones you just added
killall -SIGHUP acpid

Second, create the referenced action script (<tt>/etc/acpi/twist-tabletmode.sh</tt>):

cat <<EOF > /etc/acpi/twist-tabletmode.sh
#!/bin/bash
[ -f /usr/share/acpi-support/state-funcs ] || exit 0

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

getXconsole

# If passed in a (valid) arg, use it
[ "$1" ] && [ "$1" = "0" -o "$1" = "1" ] && MODE=${MODE:=${1}}

# Otherwise, use current state from thinkpad acpi sysfs entry, as described at
# http://www.kernel.org/doc/Documentation/laptops/thinkpad-acpi.txt
MODE=${MODE:="$(cat /sys/devices/platform/thinkpad_acpi/hotkey_tablet_mode)"}

TOUCHPAD_NAME="TouchPad"
TOUCHPAD_STATES=("enable" "disable")
TOUCHPAD_CMD=${TOUCHPAD_STATES[$MODE]}

TOUCHSCREEN_NAME="maXTouch"
TOUCHSCREEN_STATES=("disable" "enable")
TOUCHSCREEN_CMD=${TOUCHSCREEN_STATES[$MODE]}

# Get xinput ids for the TouchPad and TouchScreen devices
TOUCHPAD_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHPAD_NAME)")
TOUCHSCREEN_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHSCREEN_NAME)")

# Get users configured TouchPad state preference and honor it.
TOUCHPAD_ENABLED=$(sudo -iu $user gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled)

# Only change TouchPad state if touchpad-enabled=true and a device was found
[ ${#TOUCHPAD_ID} -gt 0 -a "$TOUCHPAD_ENABLED" = "true" ] && xinput $TOUCHPAD_CMD $TOUCHPAD_ID

# Only change TouchScreen state if a device was found
[ ${#TOUCHSCREEN_ID} -gt 0 ] && xinput $TOUCHSCREEN_CMD $TOUCHSCREEN_ID

EOF

# Make it executable...
chmod +x /etc/acpi/twist-tabletmode.sh

That's it!!! Time to test it out by converting the Twist into tablet mode. You can crack the lid about 1½ inches before the Twist will exit tablet mode. While in tablet mode, crack the lid and confirm that touching the TouchPad has no effect.

====More Detail====
Initially, I pursued this as an XInput issue, only to discover later after digging through this to solve the automatice use case during tablet mode changes, that there is a GSettings key that also is at play here. As I soon discovered, the GSettings key will actually determine if any changes vi xinput will be honored.

=====XInput Method=====
First, determine the xinput device id for the TouchPad

{{cmduser|xinput list --name-only|grep -im1 TouchPad}} 
{{cmdresult|SynPS/2 Synaptics TouchPad}}

Next, using this name, get the xinput device id for it

{{cmduser|xinput list --id-only "SynPS/2 Synaptics TouchPad"}} 
{{cmdresult|12}}

Now, to disable and then enable it, simply run

{{cmduser|xinput disable 12}} 
{{cmduser|xinput enable 12}}

=====GSettings Method=====
There is a GSettings key in the <tt>org.gnome.settings-daemon.peripherals.touchpad</tt> schema called <tt>touchpad-enabled</tt>. To get and set this key, you use the <tt>gsettings</tt> command from a terminal that is associated with your active user session:

Get the current value of touchpad-enabled
$ gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled
true

To disable the TouchPad, set touchpad-enabled to false
$ gsettings set org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled false

Now check the value of touchpad-enabled, should be false...
$ gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled
false

===Think Light Control===
You can control red the LED in the "i" of the "ThinkPad" logo as follows

Turn on the LED...

{{cmdroot|echo 0 on > /proc/acpi/ibm/led}}

Turn off the LED...

{{cmdroot|echo 0 off > /proc/acpi/ibm/led}}

Blink the LED

{{cmdroot|echo 0 blink > /proc/acpi/ibm/led}}

===Headphone Plug Events===
On the Twist, when I was testing this, /dev/input/event12 was where Headphone jack plug and unplug events were being reported

Install the input-utils package and then run:

# input-events 12
/dev/input/event12
bustype : (null)
vendor : 0x0
product : 0x0
version : 0
name : "HDA Intel PCH Headphone"
phys : "ALSA"
bits ev : EV_SYN EV_SW

waiting for events
11:54:14.257360: EV_SW SW_HEADPHONE_INSERT 1
11:54:14.257361: EV_SYN code=0 value=0
11:54:14.587882: EV_SW SW_HEADPHONE_INSERT 0
11:54:14.587883: EV_SYN code=0 value=0

{{NOTE|
<tt>'''SW_HEADPHONE_INSERT''' 1</tt> represents the "'''plug'''" event 
<tt>'''SW_HEADPHONE_INSERT''' 0</tt> represents the "'''unplug'''" event
}}

===Input Mapping===
The following table is derived from the output of the {{cmdroot|lsinput}} command (part of the input-utils package)

{| class="wikitable"
!/dev path!!name!!phys!!ev flags
|-
|/dev/input/event0||Power Button||PNP0C0C/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event1||Lid Switch||PNP0C0D/button/input0||EV_SYN EV_SW
|-
|/dev/input/event2||Power Button||LNXPWRBN/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event3||AT Translated Set 2 keyboard||isa0060/serio0/input0||EV_SYN EV_KEY EV_MSC EV_LED EV_REP
|-
|/dev/input/event4||ThinkPad Extra Buttons||thinkpad_acpi/input0||EV_SYN EV_KEY EV_MSC EV_SW
|-
|/dev/input/event5||Atmel Atmel maXTouch Digitizer||usb-0000:00:1a.0-1.1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event6||Integrated Camera||usb-0000:00:1d.0-1.6/button||EV_SYN EV_KEY
|-
|/dev/input/event7||Video Bus||LNXVIDEO/video/input0||EV_SYN EV_KEY
|-
|/dev/input/event8||SynPS/2 Synaptics TouchPad||isa0060/serio1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event9||HDA Intel PCH HDMI/DP,pcm=7||ALSA||EV_SYN EV_SW
|-
|/dev/input/event10||HDA Intel PCH HDMI/DP,pcm=3||ALSA||EV_SYN EV_SW
|-
|/dev/input/event11||HDA Intel PCH Mic||ALSA||EV_SYN EV_SW
|-
|/dev/input/event12||HDA Intel PCH Headphone||ALSA||EV_SYN EV_SW
|-
|/dev/input/event13||TPPS/2 IBM TrackPoint||synaptics-pt/serio0/input0||EV_SYN EV_KEY EV_REL
|}

[[Category:Edge Twist]]

File:Add-custom-keybinding.png

2013-01-29T02:22:35Z

Shane:

Installing Ubuntu 12.10 on Thinkpad Twist

2013-01-29T02:20:22Z

Shane: Integrated previous authors content

Installing Ubuntu 12.10 on the Lenovo Twist ultrabook

==Overview==
===Specs===
*Lenovo Twist - S230u (model 3347-CTO)
*Ubuntu 12.10 - 64bit (ubuntu-12.10-desktop-amd64.iso)

{{Todo|DMESG etc to follow}}

===What Works===
*Touch screen - single touch only {{Fixme|Needs review. Multitouch worked for me --[[User:Shane|Shane]] 03:20, 29 January 2013 (CET)}}
*Sound, WLAN, camera, SSD works
*WWAN works

===What Does Not Work===
*GPS does not work

==Install==
{{WARN|Since this device ships with the BIOS set to boot from '''UEFI only'''. You must enable '''Legacy''' boot option in the BIOS before you can begin installing Ubuntu.}}
# Enable Legacy boot in BIOS
# Plug in USB drive containing Ubuntu 12.10 install image
# Turn power on
# Proceed through install
# Reboot when done
# Log in and install any available updates (rebooting as needed)

==Customize==

===Additional Packages===
Much of what follows depends on some additional tools. You can run the following command to install them all at once:

$ sudo apt-get install \
mesa-utils # resolves "Graphics Unknown" reported in system info \
input-utils # Misc tools to assist in detecting and configuring special HW keys/events

===Graphics===
====Fix "unknown" graphics adapter====
Install mesa-utils, which adds glxinfo, used by system info to report the "friendly" graphics device name
{{cmduser|sudo apt-get install mesa-utils}}
====Enable SNA====
To enable SNA (vs. default UXA) in X, create an Xorg config option file (/usr/share/X11/xorg.conf.d/20-enable-sna.conf) as follows:
# cat <<EOF > /usr/share/X11/xorg.conf.d/20-enable-sna.conf
Section "Device"
Identifier "Card0"
Driver "intel"
Option "AccelMethod" "sna"
EndSection
EOF
===Key Bindings===
{{HINT|Lenovo's intended behavior for the Function keys in Windows 8 is defined in the their [http://download.lenovo.com/ibmdl/pub/pc/pccbbs/mobiles_pdf/s230u_twist_ug_en.pdf Lenovo Twist User Manual])}}
{| class="wikitable"
!Button!!Purpose!!HKEY!!Scan Code!!Key Code!!Key Sym!!Bind To!!Works Out of Box||Works with Tweaking
|-
|{{key|F1}}||"Mute" key (toggle speaker muting)||{{Cunk}}||{{Cunk}}||113||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F2}}||"Volume Down" key||{{Cunk}}||{{Cunk}}||114||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F3}}||"Volume Up" key||{{Cunk}}||{{Cunk}}||115||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F4}}||"Mic" key (toggle mic muting)||00000080 0000101b||0x1A||micmute||{{Cunk}}||/etc/acpi/event/lenovo-micmute calls amixer to toggle Capture device||{{Cno}}||{{Cyes}}
|-
|{{key|F5}}||"Brightness Down" key||{{Cunk}}||{{Cunk}}||224||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F6}}||"Brightness Up" key||{{Cunk}}||{{Cunk}}||225||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F7}}||"Display" key (toggle display output selection)||{{Cunk}}||0x06||227||switchvideomode|| ||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F8}}||"Radio" key (toggle Airplane mode)||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F9}}||"Settings" key (launch settings charm/app)||00000080 0000101d||0x1C||{{Cunk}}||{{Cunk}}||gnome-control-center||{{Cno}}||{{Cyes}}
|-
|{{key|F10}}||"Search" key (launch search charm/app)||00000080 0000101e||0x1D||{{Cunk}}||{{Cunk}}||Meta-f (Unity file search)||{{Cno}}||{{Cyes}}
|-
|{{key|F11}}||"Task Manager" key (show opened programs)||00000080 0000101f||0x1E||{{Cunk}}||{{Cunk}}||Alt-Tab (task switcher)||{{Cno}}||{{Cyes}}
|-
|{{key|F12}}||"All Apps" key (show picker for all installed programs)||00000080 00001020||0x1F||{{Cunk}}||{{Cunk}}||Meta||{{Cno}}||{{Cyes}}
|-
|Lid flipped||Enable tablet mode||00000080 000060c0 00000080 00005009||{{Cunk}}||''reserved''||{{Cunk}}||Launch on-screen keyboard||{{Cno}}||{{Cyes}}
|-
|Lid normal||Disable tablet mode||00000080 000060c0 00000080 0000500a||{{Cunk}}||''reserved''||{{Cunk}}||Hide on-screen-keyboard||{{Cno}}||{{Cyes}}
|-
|{{key|Rotate}}||Toggle screen rotation||00000080 00006020||{{Cunk}}||{{Cunk}}||{{Cunk}}||/etc/acpi/event/lenovo-twist-rotate calls notify-send ATM, since xrandr is crashing X :/||{{Cno}}||{{Fixme|X crashing}}
|}
===Toggling TouchPad===
One of the very annoying things about the available settings in 12.10 is that there no longer appears to be a way to completely disable the Synaptics TouchPad device from the UI. Also, no touchpad indicator applet appears to be available in the standard repos.

Related to this, is the very poor interaction between the TouchPad and the TouchScreen (Atmel maXTouch Digitizer) when the screen is folded into tablet mode. The result is the cursor begins to jump around and get "twitchy".

So, to solve this, there are two things to address:
# How to disable/enable the TouchPad on demand (hotkey event or other keybinding)
# How to disable/enable the TouchPad automatically when tablet mode is enabled/disabled
====On Demand====
To add new, custom, key bindings, launch the "'''Keyboard'''" editor:
{{cmduser|gnome-control-center keyboard}}

and navigate to the "Shortcuts" tab, select the '''Custom Shortcuts''' and then click the '''+''' button and provide the name and command for your binding. For example:

[[Image:Add-custom-keybinding.png]]

In this example, I tell it to invoke the script <tt>~/toggle-touchpad.sh</tt>, which might look something like this:

#!/bin/bash
declare -A TOGGLE=([true]=false [false]=true)
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad"
KEY="touchpad-enabled"
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}

Or, use this one-line version directly in the "Command:" field:

/bin/bash -c 'declare -A TOGGLE=([true]=false [false]=true) && \
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad" && \
KEY="touchpad-enabled" && \
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}'

Finally, click the word "'''disabled'''" on the newly added custom shortcut and hit the button or key combination you want to use for toggling the TouchPads enabled state.
====Automatic====
To solve the "jitter" problem with the mouse when the Twist is in tablet mode, a few additions to the acpi events handlers is all that's required. The following need to be run as root, or via sudo.

First, we need to configure acpid to recognize the events triggered when the Twist changes tablet mode state:

cat <<EOF > /etc/acpi/events/twist-tablet-enabled
# /etc/acpi/events/twist-tablet-enabled
# This is called when the lid is placed in tablet position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 00005009
action=/etc/acpi/twist-tabletmode.sh 1
EOF

cat <<EOF > /etc/acpi/events/twist-tablet-disabled
# /etc/acpi/events/twist-tablet-disabled
# This is called when the lid is placed in normal position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 0000500a
action=/etc/acpi/twist-tabletmode.sh 0
EOF

# Now, restart acpid so it can re-read the event filters, including the ones you just added
killall -SIGHUP acpid

Second, create the referenced action script (<tt>/etc/acpi/twist-tabletmode.sh</tt>):

cat <<EOF > /etc/acpi/twist-tabletmode.sh
#!/bin/bash
[ -f /usr/share/acpi-support/state-funcs ] || exit 0

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

getXconsole

# If passed in a (valid) arg, use it
[ "$1" ] && [ "$1" = "0" -o "$1" = "1" ] && MODE=${MODE:=${1}}

# Otherwise, use current state from thinkpad acpi sysfs entry, as described at
# http://www.kernel.org/doc/Documentation/laptops/thinkpad-acpi.txt
MODE=${MODE:="$(cat /sys/devices/platform/thinkpad_acpi/hotkey_tablet_mode)"}

TOUCHPAD_NAME="TouchPad"
TOUCHPAD_STATES=("enable" "disable")
TOUCHPAD_CMD=${TOUCHPAD_STATES[$MODE]}

TOUCHSCREEN_NAME="maXTouch"
TOUCHSCREEN_STATES=("disable" "enable")
TOUCHSCREEN_CMD=${TOUCHSCREEN_STATES[$MODE]}

# Get xinput ids for the TouchPad and TouchScreen devices
TOUCHPAD_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHPAD_NAME)")
TOUCHSCREEN_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHSCREEN_NAME)")

# Get users configured TouchPad state preference and honor it.
TOUCHPAD_ENABLED=$(sudo -iu $user gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled)

# Only change TouchPad state if touchpad-enabled=true and a device was found
[ ${#TOUCHPAD_ID} -gt 0 -a "$TOUCHPAD_ENABLED" = "true" ] && xinput $TOUCHPAD_CMD $TOUCHPAD_ID

# Only change TouchScreen state if a device was found
[ ${#TOUCHSCREEN_ID} -gt 0 ] && xinput $TOUCHSCREEN_CMD $TOUCHSCREEN_ID

EOF

# Make it executable...
chmod +x /etc/acpi/twist-tabletmode.sh

That's it!!! Time to test it out by converting the Twist into tablet mode. You can crack the lid about 1½ inches before the Twist will exit tablet mode. While in tablet mode, crack the lid and confirm that touching the TouchPad has no effect.

====More Detail====
Initially, I pursued this as an XInput issue, only to discover later after digging through this to solve the automatice use case during tablet mode changes, that there is a GSettings key that also is at play here. As I soon discovered, the GSettings key will actually determine if any changes vi xinput will be honored.

=====XInput Method=====
First, determine the xinput device id for the TouchPad

{{cmduser|xinput list --name-only|grep -im1 TouchPad}} 
{{cmdresult|SynPS/2 Synaptics TouchPad}}

Next, using this name, get the xinput device id for it

{{cmduser|xinput list --id-only "SynPS/2 Synaptics TouchPad"}} 
{{cmdresult|12}}

Now, to disable and then enable it, simply run

{{cmduser|xinput disable 12}} 
{{cmduser|xinput enable 12}}

=====GSettings Method=====
There is a GSettings key in the <tt>org.gnome.settings-daemon.peripherals.touchpad</tt> schema called <tt>touchpad-enabled</tt>. To get and set this key, you use the <tt>gsettings</tt> command from a terminal that is associated with your active user session:

Get the current value of touchpad-enabled
$ gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled
true

To disable the TouchPad, set touchpad-enabled to false
$ gsettings set org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled false

Now check the value of touchpad-enabled, should be false...
$ gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled
false

===Think Light Control===
You can control red the LED in the "i" of the "ThinkPad" logo as follows

Turn on the LED...

{{cmdroot|echo 0 on > /proc/acpi/ibm/led}}

Turn off the LED...

{{cmdroot|echo 0 off > /proc/acpi/ibm/led}}

Blink the LED

{{cmdroot|echo 0 blink > /proc/acpi/ibm/led}}

===Headphone Plug Events===
On the Twist, when I was testing this, /dev/input/event12 was where Headphone jack plug and unplug events were being reported

Install the input-utils package and then run:

# input-events 12
/dev/input/event12
bustype : (null)
vendor : 0x0
product : 0x0
version : 0
name : "HDA Intel PCH Headphone"
phys : "ALSA"
bits ev : EV_SYN EV_SW

waiting for events
11:54:14.257360: EV_SW SW_HEADPHONE_INSERT 1
11:54:14.257361: EV_SYN code=0 value=0
11:54:14.587882: EV_SW SW_HEADPHONE_INSERT 0
11:54:14.587883: EV_SYN code=0 value=0

{{NOTE|
<tt>'''SW_HEADPHONE_INSERT''' 1</tt> represents the "'''plug'''" event 
<tt>'''SW_HEADPHONE_INSERT''' 0</tt> represents the "'''unplug'''" event
}}

===Input Mapping===
The following table is derived from the output of the {{cmdroot|lsinput}} command (part of the input-utils package)

{| class="wikitable"
!/dev path!!name!!phys!!ev flags
|-
|/dev/input/event0||Power Button||PNP0C0C/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event1||Lid Switch||PNP0C0D/button/input0||EV_SYN EV_SW
|-
|/dev/input/event2||Power Button||LNXPWRBN/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event3||AT Translated Set 2 keyboard||isa0060/serio0/input0||EV_SYN EV_KEY EV_MSC EV_LED EV_REP
|-
|/dev/input/event4||ThinkPad Extra Buttons||thinkpad_acpi/input0||EV_SYN EV_KEY EV_MSC EV_SW
|-
|/dev/input/event5||Atmel Atmel maXTouch Digitizer||usb-0000:00:1a.0-1.1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event6||Integrated Camera||usb-0000:00:1d.0-1.6/button||EV_SYN EV_KEY
|-
|/dev/input/event7||Video Bus||LNXVIDEO/video/input0||EV_SYN EV_KEY
|-
|/dev/input/event8||SynPS/2 Synaptics TouchPad||isa0060/serio1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event9||HDA Intel PCH HDMI/DP,pcm=7||ALSA||EV_SYN EV_SW
|-
|/dev/input/event10||HDA Intel PCH HDMI/DP,pcm=3||ALSA||EV_SYN EV_SW
|-
|/dev/input/event11||HDA Intel PCH Mic||ALSA||EV_SYN EV_SW
|-
|/dev/input/event12||HDA Intel PCH Headphone||ALSA||EV_SYN EV_SW
|-
|/dev/input/event13||TPPS/2 IBM TrackPoint||synaptics-pt/serio0/input0||EV_SYN EV_KEY EV_REL
|}

[[Category:Edge Twist]]

Installing Ubuntu 12.10 on Thinkpad Twist

2013-01-29T02:12:10Z

Shane: Initial details of my Ubuntu 12.10 install onto the Lenovo Twist

{{stub}}
Needs disabling of UEFI in the BIOS setup screens

Touch screen - single touch only

Sound, WLAN, camera, SSD works

WWAN works
GPS does not work

DMESG etc to follow

Installing Ubuntu on the Lenovo Twist ultrabook

==Specs==
*Lenovo Twist - S230u (model 3347-CTO)
*Ubuntu 12.10 - 64bit (ubuntu-12.10-desktop-amd64.iso)

==Install==
{{WARN|Since this device ships with the BIOS set to boot from '''UEFI only'''. You must enable '''Legacy''' boot option in the BIOS before you can begin installing Ubuntu.}}
# Enable Legacy boot in BIOS
# Plug in USB drive containing Ubuntu 12.10 install image
# Turn power on
# Proceed through install
# Reboot when done
# Log in and install any available updates (rebooting as needed)

==Customize==

===Additional Packages===
Much of what follows depends on some additional tools. You can run the following command to install them all at once:

$ sudo apt-get install \
mesa-utils # resolves "Graphics Unknown" reported in system info \
input-utils # Misc tools to assist in detecting and configuring special HW keys/events

===Graphics===
====Fix "unknown" graphics adapter====
Install mesa-utils, which adds glxinfo, used by system info to report the "friendly" graphics device name
{{cmduser|sudo apt-get install mesa-utils}}
====Enable SNA====
To enable SNA (vs. default UXA) in X, create an Xorg config option file (/usr/share/X11/xorg.conf.d/20-enable-sna.conf) as follows:
# cat <<EOF > /usr/share/X11/xorg.conf.d/20-enable-sna.conf
Section "Device"
Identifier "Card0"
Driver "intel"
Option "AccelMethod" "sna"
EndSection
EOF
===Key Bindings===
{{HINT|Lenovo's intended behavior for the Function keys in Windows 8 is defined in the their [http://download.lenovo.com/ibmdl/pub/pc/pccbbs/mobiles_pdf/s230u_twist_ug_en.pdf Lenovo Twist User Manual])}}
{| class="wikitable"
!Button!!Purpose!!HKEY!!Scan Code!!Key Code!!Key Sym!!Bind To!!Works Out of Box||Works with Tweaking
|-
|{{key|F1}}||"Mute" key (toggle speaker muting)||{{Cunk}}||{{Cunk}}||113||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F2}}||"Volume Down" key||{{Cunk}}||{{Cunk}}||114||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F3}}||"Volume Up" key||{{Cunk}}||{{Cunk}}||115||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F4}}||"Mic" key (toggle mic muting)||00000080 0000101b||0x1A||micmute||{{Cunk}}||/etc/acpi/event/lenovo-micmute calls amixer to toggle Capture device||{{Cno}}||{{Cyes}}
|-
|{{key|F5}}||"Brightness Down" key||{{Cunk}}||{{Cunk}}||224||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F6}}||"Brightness Up" key||{{Cunk}}||{{Cunk}}||225||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F7}}||"Display" key (toggle display output selection)||{{Cunk}}||0x06||227||switchvideomode|| ||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F8}}||"Radio" key (toggle Airplane mode)||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cunk}}||{{Cyes}}||{{Cunk|text=}}N/A
|-
|{{key|F9}}||"Settings" key (launch settings charm/app)||00000080 0000101d||0x1C||{{Cunk}}||{{Cunk}}||gnome-control-center||{{Cno}}||{{Cyes}}
|-
|{{key|F10}}||"Search" key (launch search charm/app)||00000080 0000101e||0x1D||{{Cunk}}||{{Cunk}}||Meta-f (Unity file search)||{{Cno}}||{{Cyes}}
|-
|{{key|F11}}||"Task Manager" key (show opened programs)||00000080 0000101f||0x1E||{{Cunk}}||{{Cunk}}||Alt-Tab (task switcher)||{{Cno}}||{{Cyes}}
|-
|{{key|F12}}||"All Apps" key (show picker for all installed programs)||00000080 00001020||0x1F||{{Cunk}}||{{Cunk}}||Meta||{{Cno}}||{{Cyes}}
|-
|Lid flipped||Enable tablet mode||00000080 000060c0 00000080 00005009||{{Cunk}}||''reserved''||{{Cunk}}||Launch on-screen keyboard||{{Cno}}||{{Cyes}}
|-
|Lid normal||Disable tablet mode||00000080 000060c0 00000080 0000500a||{{Cunk}}||''reserved''||{{Cunk}}||Hide on-screen-keyboard||{{Cno}}||{{Cyes}}
|-
|{{key|Rotate}}||Toggle screen rotation||00000080 00006020||{{Cunk}}||{{Cunk}}||{{Cunk}}||/etc/acpi/event/lenovo-twist-rotate calls notify-send ATM, since xrandr is crashing X :/||{{Cno}}||{{Fixme|X crashing}}
|}
===Toggling TouchPad===
One of the very annoying things about the available settings in 12.10 is that there no longer appears to be a way to completely disable the Synaptics TouchPad device from the UI. Also, no touchpad indicator applet appears to be available in the standard repos.

Related to this, is the very poor interaction between the TouchPad and the TouchScreen (Atmel maXTouch Digitizer) when the screen is folded into tablet mode. The result is the cursor begins to jump around and get "twitchy".

So, to solve this, there are two things to address:
# How to disable/enable the TouchPad on demand (hotkey event or other keybinding)
# How to disable/enable the TouchPad automatically when tablet mode is enabled/disabled
====On Demand====
To add new, custom, key bindings, launch the "'''Keyboard'''" editor:
{{cmduser|gnome-control-center keyboard}}

and navigate to the "Shortcuts" tab, select the '''Custom Shortcuts''' and then click the '''+''' button and provide the name and command for your binding. For example:

[[Image:Add-custom-keybinding.png]]

In this example, I tell it to invoke the script <tt>~/toggle-touchpad.sh</tt>, which might look something like this:

#!/bin/bash
declare -A TOGGLE=([true]=false [false]=true)
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad"
KEY="touchpad-enabled"
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}

Or, use this one-line version directly in the "Command:" field:

/bin/bash -c 'declare -A TOGGLE=([true]=false [false]=true) && \
SCHEMA="org.gnome.settings-daemon.peripherals.touchpad" && \
KEY="touchpad-enabled" && \
gsettings set $SCHEMA $KEY ${TOGGLE[$(gsettings get $SCHEMA $KEY)]}'

Finally, click the word "'''disabled'''" on the newly added custom shortcut and hit the button or key combination you want to use for toggling the TouchPads enabled state.
====Automatic====
To solve the "jitter" problem with the mouse when the Twist is in tablet mode, a few additions to the acpi events handlers is all that's required. The following need to be run as root, or via sudo.

First, we need to configure acpid to recognize the events triggered when the Twist changes tablet mode state:

cat <<EOF > /etc/acpi/events/twist-tablet-enabled
# /etc/acpi/events/twist-tablet-enabled
# This is called when the lid is placed in tablet position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 00005009
action=/etc/acpi/twist-tabletmode.sh 1
EOF

cat <<EOF > /etc/acpi/events/twist-tablet-disabled
# /etc/acpi/events/twist-tablet-disabled
# This is called when the lid is placed in normal position on
# Lenovo Twist ThinkPads

event=ibm/hotkey HKEY 00000080 0000500a
action=/etc/acpi/twist-tabletmode.sh 0
EOF

# Now, restart acpid so it can re-read the event filters, including the ones you just added
killall -SIGHUP acpid

Second, create the referenced action script (<tt>/etc/acpi/twist-tabletmode.sh</tt>):

cat <<EOF > /etc/acpi/twist-tabletmode.sh
#!/bin/bash
[ -f /usr/share/acpi-support/state-funcs ] || exit 0

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

getXconsole

# If passed in a (valid) arg, use it
[ "$1" ] && [ "$1" = "0" -o "$1" = "1" ] && MODE=${MODE:=${1}}

# Otherwise, use current state from thinkpad acpi sysfs entry, as described at
# http://www.kernel.org/doc/Documentation/laptops/thinkpad-acpi.txt
MODE=${MODE:="$(cat /sys/devices/platform/thinkpad_acpi/hotkey_tablet_mode)"}

TOUCHPAD_NAME="TouchPad"
TOUCHPAD_STATES=("enable" "disable")
TOUCHPAD_CMD=${TOUCHPAD_STATES[$MODE]}

TOUCHSCREEN_NAME="maXTouch"
TOUCHSCREEN_STATES=("disable" "enable")
TOUCHSCREEN_CMD=${TOUCHSCREEN_STATES[$MODE]}

# Get xinput ids for the TouchPad and TouchScreen devices
TOUCHPAD_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHPAD_NAME)")
TOUCHSCREEN_ID=$(xinput list --id-only "$(xinput list --name-only|grep -m1 $TOUCHSCREEN_NAME)")

# Get users configured TouchPad state preference and honor it.
TOUCHPAD_ENABLED=$(sudo -iu $user gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled)

# Only change TouchPad state if touchpad-enabled=true and a device was found
[ ${#TOUCHPAD_ID} -gt 0 -a "$TOUCHPAD_ENABLED" = "true" ] && xinput $TOUCHPAD_CMD $TOUCHPAD_ID

# Only change TouchScreen state if a device was found
[ ${#TOUCHSCREEN_ID} -gt 0 ] && xinput $TOUCHSCREEN_CMD $TOUCHSCREEN_ID

EOF

# Make it executable...
chmod +x /etc/acpi/twist-tabletmode.sh

That's it!!! Time to test it out by converting the Twist into tablet mode. You can crack the lid about 1½ inches before the Twist will exit tablet mode. While in tablet mode, crack the lid and confirm that touching the TouchPad has no effect.

====More Detail====
Initially, I pursued this as an XInput issue, only to discover later after digging through this to solve the automatice use case during tablet mode changes, that there is a GSettings key that also is at play here. As I soon discovered, the GSettings key will actually determine if any changes vi xinput will be honored.

=====XInput Method=====
First, determine the xinput device id for the TouchPad

{{cmduser|xinput list --name-only|grep -im1 TouchPad}} 
{{cmdresult|SynPS/2 Synaptics TouchPad}}

Next, using this name, get the xinput device id for it

{{cmduser|xinput list --id-only "SynPS/2 Synaptics TouchPad"}} 
{{cmdresult|12}}

Now, to disable and then enable it, simply run

{{cmduser|xinput disable 12}} 
{{cmduser|xinput enable 12}}

=====GSettings Method=====
There is a GSettings key in the <tt>org.gnome.settings-daemon.peripherals.touchpad</tt> schema called <tt>touchpad-enabled</tt>. To get and set this key, you use the <tt>gsettings</tt> command from a terminal that is associated with your active user session:

Get the current value of touchpad-enabled
$ gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled
true

To disable the TouchPad, set touchpad-enabled to false
$ gsettings set org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled false

Now check the value of touchpad-enabled, should be false...
$ gsettings get org.gnome.settings-daemon.peripherals.touchpad touchpad-enabled
false

===Think Light Control===
You can control red the LED in the "i" of the "ThinkPad" logo as follows

Turn on the LED...

{{cmdroot|echo 0 on > /proc/acpi/ibm/led}}

Turn off the LED...

{{cmdroot|echo 0 off > /proc/acpi/ibm/led}}

Blink the LED

{{cmdroot|echo 0 blink > /proc/acpi/ibm/led}}

===Headphone Plug Events===
On the Twist, when I was testing this, /dev/input/event12 was where Headphone jack plug and unplug events were being reported

Install the input-utils package and then run:

# input-events 12
/dev/input/event12
bustype : (null)
vendor : 0x0
product : 0x0
version : 0
name : "HDA Intel PCH Headphone"
phys : "ALSA"
bits ev : EV_SYN EV_SW

waiting for events
11:54:14.257360: EV_SW SW_HEADPHONE_INSERT 1
11:54:14.257361: EV_SYN code=0 value=0
11:54:14.587882: EV_SW SW_HEADPHONE_INSERT 0
11:54:14.587883: EV_SYN code=0 value=0

{{NOTE|
<tt>'''SW_HEADPHONE_INSERT''' 1</tt> represents the "'''plug'''" event 
<tt>'''SW_HEADPHONE_INSERT''' 0</tt> represents the "'''unplug'''" event
}}

===Input Mapping===
The following table is derived from the output of the {{cmdroot|lsinput}} command (part of the input-utils package)

{| class="wikitable"
!/dev path!!name!!phys!!ev flags
|-
|/dev/input/event0||Power Button||PNP0C0C/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event1||Lid Switch||PNP0C0D/button/input0||EV_SYN EV_SW
|-
|/dev/input/event2||Power Button||LNXPWRBN/button/input0||EV_SYN EV_KEY
|-
|/dev/input/event3||AT Translated Set 2 keyboard||isa0060/serio0/input0||EV_SYN EV_KEY EV_MSC EV_LED EV_REP
|-
|/dev/input/event4||ThinkPad Extra Buttons||thinkpad_acpi/input0||EV_SYN EV_KEY EV_MSC EV_SW
|-
|/dev/input/event5||Atmel Atmel maXTouch Digitizer||usb-0000:00:1a.0-1.1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event6||Integrated Camera||usb-0000:00:1d.0-1.6/button||EV_SYN EV_KEY
|-
|/dev/input/event7||Video Bus||LNXVIDEO/video/input0||EV_SYN EV_KEY
|-
|/dev/input/event8||SynPS/2 Synaptics TouchPad||isa0060/serio1/input0||EV_SYN EV_KEY EV_ABS
|-
|/dev/input/event9||HDA Intel PCH HDMI/DP,pcm=7||ALSA||EV_SYN EV_SW
|-
|/dev/input/event10||HDA Intel PCH HDMI/DP,pcm=3||ALSA||EV_SYN EV_SW
|-
|/dev/input/event11||HDA Intel PCH Mic||ALSA||EV_SYN EV_SW
|-
|/dev/input/event12||HDA Intel PCH Headphone||ALSA||EV_SYN EV_SW
|-
|/dev/input/event13||TPPS/2 IBM TrackPoint||synaptics-pt/serio0/input0||EV_SYN EV_KEY EV_REL
|}

[[Category:Edge Twist]]