nixos-hardware/dell/xps/15-9560/README.wiki

= Dell XPS 15 9560 =

== Tested Hardware ==

* CPU: Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz
* RAM: 16 GB
* HDD: 512 GiB SSD
* Screen: 15.6" FHD(1920x1080) InfinityEdge
* Graphics: NVIDIA Corporation GTX1050 4GB GDDR5, with Intel Graphics too.
* Input: trackpad


== Firmware Configuration ==

Not much tweaking of NixOS itself was needed. But we currently cannot automate the firmware setup, so this must be done by hand.

== Installation ==

=== Before installation ===

These settings are needed both for booting the final install, and installer itself. Therefore, they must be done first.

* ''Disable Secure Boot (but keep UEFI Boot).'' Thakfully doing so is as easy as changing any other simple setting.

* ''Disable Intel hardware RAID and use AHCI instead.'' Intel doesn't seem to provide a working linux driver for this.  (If you just have SSD it's pointless and just slows things down needlessly anyways.)


=== After installation ===

* ''Add systemd-boot to UEFI boot list.'' The (uneditable anyways) settings mapping drive UUIDs to HD* work fine.

=== Optional ===

* ''Disable C-States.'' This is a processor idling thing. It seems to cause random crashes (Blank screen, no normal panic debug dump). Unfortunately, without it, the computer cannot be suspended. On the other hand, it doesn't seem to affect acpi's estimation of battery life when the computer is running with minimal load, but I haven't tested battery life in practice. I list it as optional as there's a tradeoff, and the crashes are rare enough one can probably get through installation just fine.

  * This does not seem to be a problem on recent firmware/kernel versions.

* ''Update BIOS.'' According to Reddit, this helps with battery life.

* ''Update Intel's Thunderbolt firmware.'' Without this, the Thunderbolt port will only work as power source, and not transfer data.

== Optional Functionality ==

* ''Fan control'' This laptop supports Dell's own libsmbios: https://github.com/dell/libsmbios to set fan modes, as well as other bios settings. Simply add the `libsmbios` package to your environment.

* ''TPM 2.0 LUKS Decryption'' If using the experimental systemd initrd, the TPM can easily be used to decrypt the root partition at boot. Simply use `systemd-cryptenroll` with desired options.

* ''Firmware Upgrades'' `services.fwupd` and your desired front-end can be used to update almost all of the firmware on this system. Something curious is the BIOS offered through fwupd/lvfs is much newer than the one available on Dell's website.

* ''Secure Boot'' This works. There is more than one way to enable it. Tested with https://github.com/nix-community/lanzaboote v0.3.0

== Troubleshooting ==

==== rcu_sched freezing problems ====

After a recent update my machine became unstable. X couldn't start and even running `lspci` would lock the machine. I'm not sure what the root cause was, but I found the fix here: https://wiki.archlinux.org/index.php/Dell_XPS_15_9560#Troubleshooting

TL;DR I added this line:
  I am leaving these params here, I haven't test these so use on your own risk.
  I am using different method to disable nvidia.
  ("acpi_rev_override=1" param is save and I have been using it for a while now,
  no crashes.)

```
boot.kernelParams = [ "acpi_rev_override=1" "pcie_aspm=off" "nouveau.modeset=0" ];
```

Some more detail about the problem can be found here: https://bbs.archlinux.org/viewtopic.php?id=223056

==== TPM 2.0 Intermittent ====

* The TPM was very unreliable, sometimes not showing up to the system. Updating to the latest TPM firmware fixed the problem. I could not seem to do this through `fwupd` so used the latest exe from the Dell website. Loading the exe through a command prompt on a Windows installer was adequate.

== Broken Functionality ==

* ''Fingerprint Reader'': Can be enabled with `services.fprintd.enable`, and can read your fingerprint. Fingerprint authentication is extremely reliable to the point it is not worth using.
Add xps 9560 with its own quirks, I added versions: 1 default one, with nvidia working and intel working, needs optirun to run application with nvidia 2 intel only, I am using this as my daily driver for long time, only intel is turned on and nvidia is turned off and doesn't drain any power. 3 nvidia only, intel is dissabled and nvidia is picked as default gpu, no need to fiddle with optirun etc, good for gpu heavy application. All these settings needs to reboot to work properly 2020-02-05 05:40:43 -05:00			`= Dell XPS 15 9560 =`

			`== Tested Hardware ==`

			`* CPU: Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz`
			`* RAM: 16 GB`
			`* HDD: 512 GiB SSD`
			`* Screen: 15.6" FHD(1920x1080) InfinityEdge`
			`* Graphics: NVIDIA Corporation GTX1050 4GB GDDR5, with Intel Graphics too.`
			`* Input: trackpad`


			`== Firmware Configuration ==`

			`Not much tweaking of NixOS itself was needed. But we currently cannot automate the firmware setup, so this must be done by hand.`

Dell XPS 9560: Add information and tweak config 2023-08-09 14:38:17 -04:00			`== Installation ==`

Add xps 9560 with its own quirks, I added versions: 1 default one, with nvidia working and intel working, needs optirun to run application with nvidia 2 intel only, I am using this as my daily driver for long time, only intel is turned on and nvidia is turned off and doesn't drain any power. 3 nvidia only, intel is dissabled and nvidia is picked as default gpu, no need to fiddle with optirun etc, good for gpu heavy application. All these settings needs to reboot to work properly 2020-02-05 05:40:43 -05:00			`=== Before installation ===`

			`These settings are needed both for booting the final install, and installer itself. Therefore, they must be done first.`

			`* ''Disable Secure Boot (but keep UEFI Boot).'' Thakfully doing so is as easy as changing any other simple setting.`

			`* ''Disable Intel hardware RAID and use AHCI instead.'' Intel doesn't seem to provide a working linux driver for this. (If you just have SSD it's pointless and just slows things down needlessly anyways.)`


			`=== After installation ===`

			`* ''Add systemd-boot to UEFI boot list.'' The (uneditable anyways) settings mapping drive UUIDs to HD* work fine.`

			`=== Optional ===`

			`* ''Disable C-States.'' This is a processor idling thing. It seems to cause random crashes (Blank screen, no normal panic debug dump). Unfortunately, without it, the computer cannot be suspended. On the other hand, it doesn't seem to affect acpi's estimation of battery life when the computer is running with minimal load, but I haven't tested battery life in practice. I list it as optional as there's a tradeoff, and the crashes are rare enough one can probably get through installation just fine.`

Dell XPS 9560: Add information and tweak config 2023-08-09 14:38:17 -04:00			`* This does not seem to be a problem on recent firmware/kernel versions.`

Add xps 9560 with its own quirks, I added versions: 1 default one, with nvidia working and intel working, needs optirun to run application with nvidia 2 intel only, I am using this as my daily driver for long time, only intel is turned on and nvidia is turned off and doesn't drain any power. 3 nvidia only, intel is dissabled and nvidia is picked as default gpu, no need to fiddle with optirun etc, good for gpu heavy application. All these settings needs to reboot to work properly 2020-02-05 05:40:43 -05:00			`* ''Update BIOS.'' According to Reddit, this helps with battery life.`

			`* ''Update Intel's Thunderbolt firmware.'' Without this, the Thunderbolt port will only work as power source, and not transfer data.`

Dell XPS 9560: Add information and tweak config 2023-08-09 14:38:17 -04:00			`== Optional Functionality ==`

Dell XPS 9560: Fix README links 2023-08-09 14:41:35 -04:00			* ''Fan control'' This laptop supports Dell's own libsmbios: https://github.com/dell/libsmbios to set fan modes, as well as other bios settings. Simply add the `libsmbios` package to your environment.
Dell XPS 9560: Add information and tweak config 2023-08-09 14:38:17 -04:00
			* ''TPM 2.0 LUKS Decryption'' If using the experimental systemd initrd, the TPM can easily be used to decrypt the root partition at boot. Simply use `systemd-cryptenroll` with desired options.

			* ''Firmware Upgrades'' `services.fwupd` and your desired front-end can be used to update almost all of the firmware on this system. Something curious is the BIOS offered through fwupd/lvfs is much newer than the one available on Dell's website.

Dell XPS 9560: Fix README links 2023-08-09 14:41:35 -04:00			`* ''Secure Boot'' This works. There is more than one way to enable it. Tested with https://github.com/nix-community/lanzaboote v0.3.0`
Dell XPS 9560: Add information and tweak config 2023-08-09 14:38:17 -04:00
			`== Troubleshooting ==`
Add xps 9560 with its own quirks, I added versions: 1 default one, with nvidia working and intel working, needs optirun to run application with nvidia 2 intel only, I am using this as my daily driver for long time, only intel is turned on and nvidia is turned off and doesn't drain any power. 3 nvidia only, intel is dissabled and nvidia is picked as default gpu, no need to fiddle with optirun etc, good for gpu heavy application. All these settings needs to reboot to work properly 2020-02-05 05:40:43 -05:00
			`==== rcu_sched freezing problems ====`

			After a recent update my machine became unstable. X couldn't start and even running `lspci` would lock the machine. I'm not sure what the root cause was, but I found the fix here: https://wiki.archlinux.org/index.php/Dell_XPS_15_9560#Troubleshooting

			`TL;DR I added this line:`
			`I am leaving these params here, I haven't test these so use on your own risk.`
			`I am using different method to disable nvidia.`
			`("acpi_rev_override=1" param is save and I have been using it for a while now,`
			`no crashes.)`

			```
			`boot.kernelParams = [ "acpi_rev_override=1" "pcie_aspm=off" "nouveau.modeset=0" ];`
			```

			`Some more detail about the problem can be found here: https://bbs.archlinux.org/viewtopic.php?id=223056`
Dell XPS 9560: Add information and tweak config 2023-08-09 14:38:17 -04:00
Dell XPS 9560: Fix README headers 2023-08-09 14:42:43 -04:00			`==== TPM 2.0 Intermittent ====`
Dell XPS 9560: Add information and tweak config 2023-08-09 14:38:17 -04:00
			* The TPM was very unreliable, sometimes not showing up to the system. Updating to the latest TPM firmware fixed the problem. I could not seem to do this through `fwupd` so used the latest exe from the Dell website. Loading the exe through a command prompt on a Windows installer was adequate.

			`== Broken Functionality ==`

			* ''Fingerprint Reader'': Can be enabled with `services.fprintd.enable`, and can read your fingerprint. Fingerprint authentication is extremely reliable to the point it is not worth using.