Add comprehensive README with installation and usage instructions
This commit is contained in:
root
302
README.md
Normal file
302
README.md
Normal file
@@ -0,0 +1,302 @@
|
|||||||
|
# T14 System Settings Manager
|
||||||
|
|
||||||
|
A comprehensive GUI and system tray application for managing Lenovo ThinkPad T14 Gen 6 system settings on Linux (Kubuntu/Ubuntu).
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
### CPU Governor Control
|
||||||
|
- **Performance Mode**: Maximum CPU performance when plugged into AC power
|
||||||
|
- **Powersave Mode**: Battery-optimized CPU frequency scaling
|
||||||
|
- Automatic switching based on AC power status (via udev rules)
|
||||||
|
|
||||||
|
### Fan Control
|
||||||
|
- **7 Fan Levels**: Manual control from L1 (silent) to L7 (maximum cooling)
|
||||||
|
- **Automatic Mode (L2)**: Temperature-based fan management via thinkfan
|
||||||
|
- **Office-Friendly**: Default configuration keeps fan at constant level 2 (~2600 RPM) up to 100°C
|
||||||
|
- Real-time fan speed monitoring
|
||||||
|
|
||||||
|
### Battery Management
|
||||||
|
- **Conservative Mode (75-80%)**: Extends battery lifespan for daily use
|
||||||
|
- **Moderate Mode (80-90%)**: Balanced charging for regular usage
|
||||||
|
- **Full Charge (0-100%)**: Maximum capacity when needed
|
||||||
|
- **Quick Charge**: One-click charge to 100% immediately
|
||||||
|
- **Automated Management**:
|
||||||
|
- Time-based: Automatically charge to full before end of workday
|
||||||
|
- Network-based: Smart charging based on WiFi location (office vs. home)
|
||||||
|
|
||||||
|
### System Integration
|
||||||
|
- **GUI Application**: Full-featured window with all controls
|
||||||
|
- **System Tray**: Quick access menu with status updates
|
||||||
|
- **Auto-start**: Tray icon launches automatically on login
|
||||||
|
- **Real-time Status**: CPU temperature, governor, fan speed, battery level
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
### Hardware
|
||||||
|
- Lenovo ThinkPad T14 Gen 6 (Intel)
|
||||||
|
- Battery with charge threshold support (BAT0)
|
||||||
|
|
||||||
|
### Software
|
||||||
|
- Ubuntu 24.04 / Kubuntu (or compatible)
|
||||||
|
- Python 3.12+
|
||||||
|
- Thinkfan 1.3.1+
|
||||||
|
- Required Python packages: `tkinter`, `pystray`, `pillow`
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
### 1. Install Dependencies
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install thinkfan
|
||||||
|
sudo apt install thinkfan
|
||||||
|
|
||||||
|
# Install Python packages
|
||||||
|
pip3 install --user --break-system-packages pystray pillow
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Enable ThinkPad Fan Control
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Enable fan control parameter
|
||||||
|
echo "options thinkpad_acpi fan_control=1" | sudo tee /etc/modprobe.d/thinkpad_acpi.conf
|
||||||
|
|
||||||
|
# Apply immediately
|
||||||
|
sudo modprobe -r thinkpad_acpi
|
||||||
|
sudo modprobe thinkpad_acpi
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Configure Thinkfan
|
||||||
|
|
||||||
|
Create `/etc/thinkfan.yaml`:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
sensors:
|
||||||
|
- hwmon: /sys/class/hwmon/hwmon5/temp1_input # CPU core temp
|
||||||
|
indices: [1, 2, 3, 4, 5, 6, 7, 8, 9]
|
||||||
|
- hwmon: /sys/class/hwmon/hwmon7/temp1_input # ThinkPad sensor
|
||||||
|
indices: [1]
|
||||||
|
- hwmon: /sys/class/hwmon/hwmon3/temp1_input # NVMe temp
|
||||||
|
indices: [1]
|
||||||
|
|
||||||
|
fans:
|
||||||
|
- tpacpi: /proc/acpi/ibm/fan
|
||||||
|
|
||||||
|
levels:
|
||||||
|
- ["level 2", 0, 100] # Constant level 2 up to 100°C (ultra-silent)
|
||||||
|
- ["level 3", 98, 255] # Level 3 only above 98°C (safety)
|
||||||
|
```
|
||||||
|
|
||||||
|
Enable and start thinkfan:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo systemctl enable thinkfan
|
||||||
|
sudo systemctl start thinkfan
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Create Privilege Elevation Helper
|
||||||
|
|
||||||
|
Create `/usr/local/bin/system-settings-helper.sh`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
case "$1" in
|
||||||
|
cpu-governor)
|
||||||
|
for cpu in /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor; do
|
||||||
|
echo "$2" > "$cpu"
|
||||||
|
done
|
||||||
|
;;
|
||||||
|
fan-level)
|
||||||
|
echo "level $2" > /proc/acpi/ibm/fan
|
||||||
|
;;
|
||||||
|
fan-stop-thinkfan)
|
||||||
|
systemctl stop thinkfan
|
||||||
|
;;
|
||||||
|
fan-start-thinkfan)
|
||||||
|
systemctl start thinkfan
|
||||||
|
;;
|
||||||
|
battery-start)
|
||||||
|
echo "$2" > /sys/class/power_supply/BAT0/charge_control_start_threshold
|
||||||
|
;;
|
||||||
|
battery-end)
|
||||||
|
echo "$2" > /sys/class/power_supply/BAT0/charge_control_end_threshold
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
```
|
||||||
|
|
||||||
|
Make it executable:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo chmod +x /usr/local/bin/system-settings-helper.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Setup CPU Governor Auto-Switching
|
||||||
|
|
||||||
|
Create `/usr/local/bin/cpu-governor-switch.sh`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
#!/bin/bash
|
||||||
|
if [ "$(cat /sys/class/power_supply/AC/online)" = "1" ]; then
|
||||||
|
for cpu in /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor; do
|
||||||
|
echo "performance" > "$cpu"
|
||||||
|
done
|
||||||
|
else
|
||||||
|
for cpu in /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor; do
|
||||||
|
echo "powersave" > "$cpu"
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
```
|
||||||
|
|
||||||
|
Create udev rule `/etc/udev/rules.d/99-cpu-governor.rules`:
|
||||||
|
|
||||||
|
```
|
||||||
|
ACTION=="change", SUBSYSTEM=="power_supply", ENV{POWER_SUPPLY_ONLINE}=="*", RUN+="/usr/local/bin/cpu-governor-switch.sh"
|
||||||
|
```
|
||||||
|
|
||||||
|
Make executable and reload:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo chmod +x /usr/local/bin/cpu-governor-switch.sh
|
||||||
|
sudo udevadm control --reload-rules
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. Install the Applications
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Clone this repository
|
||||||
|
git clone ssh://git@gitea.egonetix.de:222/root/battery_management.git
|
||||||
|
cd battery_management
|
||||||
|
|
||||||
|
# Make scripts executable
|
||||||
|
chmod +x system-settings-gui.py system-settings-tray.py
|
||||||
|
|
||||||
|
# Create desktop entry for GUI
|
||||||
|
cat > ~/.local/share/applications/system-settings-gui.desktop << EOF
|
||||||
|
[Desktop Entry]
|
||||||
|
Type=Application
|
||||||
|
Name=T14 System Settings
|
||||||
|
Comment=Manage T14 CPU, Fan, and Battery Settings
|
||||||
|
Exec=python3 $(pwd)/system-settings-gui.py
|
||||||
|
Icon=preferences-system
|
||||||
|
Terminal=false
|
||||||
|
Categories=System;Settings;
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# Create autostart entry for tray
|
||||||
|
mkdir -p ~/.config/autostart
|
||||||
|
cat > ~/.config/autostart/system-settings-tray.desktop << EOF
|
||||||
|
[Desktop Entry]
|
||||||
|
Type=Application
|
||||||
|
Name=T14 System Tray
|
||||||
|
Comment=T14 System Settings in System Tray
|
||||||
|
Exec=python3 $(pwd)/system-settings-tray.py
|
||||||
|
Icon=preferences-system
|
||||||
|
Terminal=false
|
||||||
|
Categories=System;Settings;
|
||||||
|
StartupNotify=false
|
||||||
|
X-GNOME-Autostart-enabled=true
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# Update desktop database
|
||||||
|
update-desktop-database ~/.local/share/applications
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### GUI Application
|
||||||
|
Launch from application menu: **System → T14 System Settings**
|
||||||
|
|
||||||
|
Or run directly:
|
||||||
|
```bash
|
||||||
|
python3 system-settings-gui.py
|
||||||
|
```
|
||||||
|
|
||||||
|
### System Tray
|
||||||
|
The tray icon starts automatically on login. Right-click the icon for quick access to:
|
||||||
|
- CPU governor switching
|
||||||
|
- Fan level control (L1-L7)
|
||||||
|
- Battery management presets
|
||||||
|
- Quick charge to 100%
|
||||||
|
|
||||||
|
### Command Line
|
||||||
|
|
||||||
|
Check current status:
|
||||||
|
```bash
|
||||||
|
# CPU temperature
|
||||||
|
cat /sys/class/hwmon/hwmon5/temp1_input | awk '{print int($1/1000)}'
|
||||||
|
|
||||||
|
# CPU governor
|
||||||
|
cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
|
||||||
|
|
||||||
|
# Fan speed
|
||||||
|
grep "^speed" /proc/acpi/ibm/fan
|
||||||
|
|
||||||
|
# Battery status
|
||||||
|
cat /sys/class/power_supply/BAT0/capacity
|
||||||
|
cat /sys/class/power_supply/BAT0/status
|
||||||
|
cat /sys/class/power_supply/BAT0/charge_control_start_threshold
|
||||||
|
cat /sys/class/power_supply/BAT0/charge_control_end_threshold
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fan Levels
|
||||||
|
|
||||||
|
| Level | Speed (RPM) | Use Case |
|
||||||
|
|-------|-------------|----------|
|
||||||
|
| L1 | ~2400 | Ultra-silent (very low load) |
|
||||||
|
| L2 | ~2600 | Silent office mode (default auto) |
|
||||||
|
| L3 | ~3100 | Light work |
|
||||||
|
| L4 | ~3600 | Moderate load |
|
||||||
|
| L5 | ~3900 | Higher performance |
|
||||||
|
| L6 | ~4400 | Heavy workload |
|
||||||
|
| L7 | ~5100+ | Maximum cooling |
|
||||||
|
|
||||||
|
**Note**: L2 is the default automatic mode managed by thinkfan. Selecting L2 re-enables automatic temperature-based fan management. All other levels disable thinkfan and use manual fan control.
|
||||||
|
|
||||||
|
## Battery Health Tips
|
||||||
|
|
||||||
|
- **Daily Use**: Keep at 75-80% for maximum battery lifespan
|
||||||
|
- **Before Travel**: Charge to 100% (0-100% mode)
|
||||||
|
- **Long-term Storage**: Store at 50-60% charge
|
||||||
|
- **Avoid**: Constant 100% charging when plugged in all day
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Fan control not working
|
||||||
|
```bash
|
||||||
|
# Verify fan control is enabled
|
||||||
|
cat /sys/module/thinkpad_acpi/parameters/fan_control
|
||||||
|
# Should output: Y
|
||||||
|
|
||||||
|
# Check if thinkfan is running
|
||||||
|
systemctl status thinkfan
|
||||||
|
```
|
||||||
|
|
||||||
|
### Permission denied errors
|
||||||
|
```bash
|
||||||
|
# Verify helper script exists and is executable
|
||||||
|
ls -l /usr/local/bin/system-settings-helper.sh
|
||||||
|
|
||||||
|
# Test pkexec manually
|
||||||
|
pkexec /usr/local/bin/system-settings-helper.sh cpu-governor performance
|
||||||
|
```
|
||||||
|
|
||||||
|
### Tray icon not appearing
|
||||||
|
```bash
|
||||||
|
# Check if process is running
|
||||||
|
ps aux | grep system-settings-tray
|
||||||
|
|
||||||
|
# Restart manually
|
||||||
|
pkill -f system-settings-tray
|
||||||
|
python3 system-settings-tray.py &
|
||||||
|
```
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT License - Feel free to modify and distribute.
|
||||||
|
|
||||||
|
## Author
|
||||||
|
|
||||||
|
Created for Lenovo ThinkPad T14 Gen 6 on Kubuntu 24.04.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Issues and pull requests welcome at: https://gitea.egonetix.de/root/battery_management
|
||||||
Reference in New Issue
Block a user