From 1a59c3d5ac53ed9266eba2bd65b09e6bfcc9ad7d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gabriel=20N=C3=BCtzi?= <gabriel.nuetzi@sdsc.ethz.ch>
Date: Mon, 24 Jun 2024 08:31:05 +0200
Subject: [PATCH] fix: Improve doc for Tuxedo Pulse Gen3 power issues

---
 tuxedo/pulse/14/gen3/README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/tuxedo/pulse/14/gen3/README.md b/tuxedo/pulse/14/gen3/README.md
index a44b5b3..959ab83 100644
--- a/tuxedo/pulse/14/gen3/README.md
+++ b/tuxedo/pulse/14/gen3/README.md
@@ -5,3 +5,22 @@
 [NixOS hardware configuration](https://github.com/NixOS/nixos-hardware) for
 [TUXEDO Pulse 14 -
 Gen3](https://www.tuxedocomputers.com/en/TUXEDO-Pulse-14-Gen3).
+
+## Troubleshooting
+
+### Shutdown and Power Issues
+
+With the Linux Kernel version `6.6.33` (NixOS 24.05) there are shutdown issues resulting in the battery not turning off
+completely. Apparently a newer Kernel (tested with `6.8.12`) fixes this (the exact version where this problem is fixed is unknown).
+
+You can use
+
+```nix
+  boot.kernelPackages =
+    if (config.boot.zfs.enabled)
+    then pkgs.zfs.latestCompatibleLinuxPackages
+    else pkgs.linuxPackages_latest;
+```
+
+to use the latest Kernel, where `pkgs` should probably
+be the `nixos-unstable` channel (`github:nixos/nixpkgs/nixos-unstable`).