tdock.sh

tdock

ThinkPad + Linux + Docking Station = 💔

ThinkPad + Linux + Docking Station + tdock = 🧡

Support ACPI event triggers when un-/docking a lenovo thinkpad

Usage

tdock.sh <install|uninstall|config|isdocked>

• install & uninstall to install/uninstall the acpi event hooks
• config to list the configured scripts
• isdocked returns '1' if the laptop is currently docked, '0' if not

Installation

• Clone the repo

  git clone https://git.swrzm.de/msc/tdock.sh
  

• Add the executable to the $PATH variable (for the event actions)

• Install the hooks & generate sample config

  tdock.sh install
  

• To uninstall the hooks again:

  tdock.sh uninstall
  

Setup Event Hooks

To setup the scripts that should be executed on the un-/docking events, use the $HOME/.config/tdock/tdock.conf configuration file.

Set it up with the following two lines and replace the paths to the scripts you want to have executed:

docked:/path/to/docked/script.sh
undocked:/path/to/undocked/script.sh

• The scripts are executed after the thinkpad is docked/undocked (as non-root)
• Make sure the scripts are executable (chmod +x)

Configure ThinkPad Event Triggers

Important: The un-/docking ACPI events can change from model to mode.

to change the event-code, the two variables can be changed in the tdock.sh script as seen below:

# event-codes
event_ondock="ibm/hotkey LEN0268:00 00000080 00006030"
event_onundock="ibm/hotkey LEN0268:00 00000080 00004010"

To get the correct event-codes, proceed like following:

• Run acpi_listen
  • This records all acpi-events that happening
• Undock your laptop and note down the event that is happening
• Put your laptop in the docking station again and note down this event aswell
• Change both variables in the script according to the recorded event codes.
• They should start with: ibm/hotkey LEN0???:00