Difference between revisions of "Docking Solutions"

From ThinkWiki
Jump to: navigation, search
(No event on undock)
(added redirect, shifted info)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{| width="100%"
+
#REDIRECT [[Category:Docking Solutions]]
|style="vertical-align:top;padding-right:20px;width:10px;white-space:nowrap;" | __TOC__
 
|style="vertical-align:top" |
 
Docks allow users to connect a variety of external peripherals simply by attaching their ThinkPad to the dock.
 
|}
 
==Linux support==
 
With recent distributions, docking and undocking should function out of the box. You can monitor this by running {{cmdroot|udevadm monitor}} and when you dock or press the undock button you should see a flurry of events.
 
 
 
There are some issues though
 
 
 
====No event on undock====
 
There are various possible reasons for not getting ACPI docking or undocking events;
 
 
 
# port-replicators have never supported ACPI docking events
 
# newer docks (series 3 and newer from 2009 onwards), instead of generating ACPI dock events, generate key events which are only supported by the thinkpad-acpi driver since kernel 3.0. And no default action is taken on receiving these events.
 
# prior to kernel 2.6.34 the ACPI Dock driver only registered the first logical Dock port, and subsequent dock ports where ignored. This effected the ThinkPad X40 with ThinkPad X4 Dock. For older kernels patches are [https://bugzilla.kernel.org/show_bug.cgi?id=15521 available].
 
 
 
====Filesystem corruption====
 
 
 
Pressing the undock button will immediately unplug all dock attached devices. This can easily lead to problems, for instance if you have a USB or Ultrabay storage device attached to the dock and have a filesystem mounted RW, this can easily lead to filesystem corruption.
 
 
 
The solution for now is to always make sure any storage devices attached to the dock are unmounted BEFORE pressing the undock button.
 
====External display issues====
 
{{NOTE|This only works for devices that register themselves as a dock through ACPI, it does not work for port replicators which are hidden to the OS.}}
 
{{NOTE|Newer series 3 docks no longer register themselves as a dock, but instead behave like a port replicator, as such the below method does not work. They do however cause a key event on dock and undock which could be used as a trigger, but for now these key events are not exposed by the thinkpad-acpi driver before kernel 3.0}}
 
Docking or undocking will also not change the display configuration, which can lead to issues when your undock and your screensaver decided to put the unlock dialog on the secondary display, effectively requiring you to unlock the screensaver blind, before you can press Fn-F7 to restore your display setup to ThinkPad (LVDS) only. This last issue can be resolved by creating a custom udev rule and script as shown below. This script can also be used to take other actions on dock/undock such as automatically configuring your external display on dock.
 
 
 
create a file {{Path|/etc/udev/rules.d/81-thinkpad-dock.rules}}
 
KERNEL=="dock.0", ACTION=="change", RUN+="/usr/local/sbin/thinkpad-dock.sh"
 
 
 
Then create the file {{Path|/usr/local/sbin/thinkpad-dock.sh}}
 
#!/bin/sh
 
# wait for the dock state to change
 
sleep 0.5
 
DOCKED=$(cat /sys/devices/platform/dock.0/docked)
 
case "$DOCKED" in
 
"0")
 
        #undocked event - lets remove all connected outputs apart from LVDS
 
        for output in $(/usr/bin/xrandr -d :0.0 --verbose|grep " connected"|grep -v LVDS|awk '{print $1}')
 
          do
 
          /usr/bin/xrandr -d :0.0 --output $output --off
 
        done
 
;;
 
"1")
 
#docked event - sample will created extended desktop with DVI1 to the right of LVDS1
 
#/usr/bin/xrandr -d :0.0 --output DVI1 --right-of LVDS1 --auto
 
;;
 
esac
 
exit 0
 
And set it executable
 
chmod +x /usr/local/sbin/thinkpad-dock.sh
 
 
 
{{NOTE|The output names shown above are specific to the Intel video drivers. For the ATI Radeon driver they are different. But you best check your output names by running xrandr manually, and adjusting the script appropriately for your needs. The undock event should work on any ThinkPad where the graphics driver supports RandR and the ThinkPad LCD has LVDS in the name.}}
 
 
 
Part of this is based on information from a thread on the Ubuntu [http://ubuntuforums.org/showthread.php?t=1076486 forums]
 
 
 
=====Newer series 3 docks=====
 
There is a solution for the Series 3 docks: http://phihag.de/2012/thinkpad-docking.html
 
 
 
==Available Docking Stations and Port Replicators==
 
* [[ThinkPad Mini Dock Plus Series 3 - 170W]] <tt>(T400s, T410, T410s, T420, T420s, T430, T510, W510, T520, W520, W530)</tt>
 
* [[ThinkPad Mini Dock Plus Series 3 - 135W]] <tt>(T400s, T410, T410s, T420, T420s, T430, T510, W510, T520)</tt>
 
* [[ThinkPad Mini Dock Plus Series 3 - 90W]] <tt>(T400s, T410, T410s, T420, T420s, T430, T510, T520)</tt>
 
* [[ThinkPad Mini Dock Series 3]] <tt>(T400s, T410, T410s, T420, T420s, T430, T510, T520)</tt>
 
* [[ThinkPad Port Replicator Series 3]] <tt>(T400s, T410, T410s, T420, T420s, T430, T510, T520)</tt>
 
* [[ThinkPad UltraBase Series 3]] <tt>(X220, X220i, X220 Tablet, X230, X230i, X230 Tablet)</tt>
 
* [[ThinkPad Ultra Dock]], [[ThinkPad Pro Dock]], [[ThinkPad Basic Dock]] <tt>(L440, L540, T440, T440s, T440p, T540p, X240)</tt>
 
* [[USB Port Replicator with Digital Video]]
 
 
 
==Withdrawn Docking Stations and Port Replicators==
 
* [[ThinkPad 700/720 Dock]]
 
* [[ThinkPad 700/720 Port Replicator]]
 
* [[ThinkPad Dock I (3545)]] <tt>(360/370/750/755/760 series models)</tt>
 
* [[ThinkPad Dock II (3546)]] <tt>(360/370/750/755/760 series models)</tt>
 
* [[ThinkPad Port Replicator Model 1]] <tt>(360/370/750/755/760/765 series models)</tt>
 
* [[ThinkPad Port Replicator Model 2]] <tt>(360/370/750/755/760/765 series models)</tt>
 
* [[ThinkPad MultiPort]] <tt>(510Cs)</tt>
 
* [[ThinkPad MultiPort II]] <tt>{701C/701CS)</tt>
 
* [[SelectaBase Model I]] <tt>(TP 760 and 765 series models)</tt>
 
* [[SelectaBase 600]] <tt>(TP 600 series models)</tt>
 
* [[SelectaBase 770]] <tt>(TP 770 series models)</tt>
 
* [[SelectaDock I]] <tt>(TP 600{{footnote|3}}, 760{{footnote|1}}, 765{{footnote|1}} and 770{{footnote|2}} series models)</tt>
 
* [[SelectaDock II]] <tt>(TP 600{{footnote|3}}, 760{{footnote|1}}, 765{{footnote|1}} and 770{{footnote|2}} series models)</tt>
 
* [[SelectaDock III]] <tt>(TP 600{{footnote|3}}, 760{{footnote|1}}, 765{{footnote|1}} and 770{{footnote|2}} series models)</tt>
 
* [[TransNote Port Extender]] <tt>(ThinkPad TransNote)</tt>
 
* [[ThinkPad i Series Port Replicator]] <tt>(TP i1400, i1500 Series)</tt>
 
* [[ThinkPad 365 Port Replicator]] <tt>(TP 365)</tt>
 
* [[ThinkPad 365X Port Replicator]] <tt>(TP 365X)</tt>
 
* [[ThinkPad 380/385 Port Replicator]]
 
* [[ThinkPad 560 Port Replicator]] <tt>(TP 380/385 series, 560 and 570{{footnote|4}})</tt>
 
* [[ThinkPad Enhanced Port Replicator]] <tt>(TP 380/385 series and 560X)</tt>
 
* [[ThinkPad Port Replicator with Advanced EtherJet]] <tt>(TP 380Z, i1720, i1721 and 390, 570, 600 and 770 series)</tt>
 
* [[ThinkPad Port Replicator]] <tt>(A20-A31p, R30-R32, T20-T30, X20-X32)</tt>
 
* [[ThinkPad Port Replicator II]] <tt>(A,R,T,X series models)</tt>
 
* [[ThinkPad Dock]] <tt>(A,T,X series models)</tt>
 
* [[ThinkPad Dock II]] <tt>(A,R,T,X series models)</tt>
 
* [[ThinkPad Mini-Dock]] <tt>(A,R,T,X series models)</tt>
 
* [[ThinkPad Essential Port Replicator]] <tt>(T60, Z series models)</tt>
 
* [[ThinkPad Advanced Dock]] <tt>(T60, Z series models)</tt>
 
* [[ThinkPad Advanced Mini Dock]] <tt>(T60, Z series models)</tt>
 
* [[UltraBase]] <tt>(TP 570 series)</tt>
 
* [[UltraBase X2]] <tt>(X20, X21, X22, X23, X24)</tt>
 
* [[UltraBase X3]] <tt>(X30, X31, X32)</tt>
 
* [[UltraBase X4]] <tt>(X40, X41)</tt>
 
* [[ThinkPad X4 Dock]] <tt>(X40, X41, X41 Tablet)</tt>
 
* [[UltraBase X6]] <tt>(X60, X60s, X61, X61s)</tt>
 
* [[X6 Tablet UltraBase]] <tt>(X60 Tablet, X61 Tablet)</tt>
 
* [[X200 UltraBase]] <tt>(X200, X201)</tt>
 
* [[W700 Mini Dock]]
 
* [[W700 Mini Dock 2.0]]
 
 
 
==Monitor and Notebook Stands==
 
* [[ThinkPad Adjustable Notebook Stand]]
 
* [[ThinkPad Monitor Stand 2001]] - (withdrawn)
 
* [[ThinkPad Monitor Stand 2000]] - (withdrawn)
 
 
 
==Other==
 
* [[Dock II Adapter Kit]] - (withdrawn)
 
* [[Direct Dock Adapter]] - (withdrawn)
 
* [[SelectaBase PC Card Enabler]] - (withdrawn)
 
* [[SelectaBase PC Card Enabler with Advanced EtherJet]] - (withdrawn)
 
* [[Portable Drive Bay]] (PC-Card UltraslimBay adapter) - (withdrawn)
 
* [[Portable Drive Bay 2000]] (PC-Card/USB UltraBay 2000 adapter)
 
 
 
==External Sources==
 
*[http://www-307.ibm.com/pc/support/site.wss/document.do?sitestyle=lenovo&lndocid=MIGR-4NXNTP IBMs Docking Solutions overview page]
 
*[http://martin-ueding.de/en/projects/think-rotate/ ThinkPad Scripts]
 
 
 
{{footnotes|
 
#requires [[SelectaBase Model I]]
 
#requires [[SelectaBase 770]]
 
#requires [[SelectaBase 600]]
 
#requires [[Direct Dock Adapter]] or [[UltraBase]]
 
}}
 

Latest revision as of 18:06, 18 October 2020