# Testing
This document provides a guideline for testing and verifying NVIDIA driver updates. Copy this checklist and mark items as they are verified to work.

These tests _must_ be performed on every OS version that the driver will be released on. Typically, that will be the Pop!\_OS regular release, the Pop!\_OS LTS, and the Ubuntu LTS.

## Installation

Add the staging branch containing the updated driver with the [apt script](https://github.com/pop-os/pop/blob/master/scripts/apt) in the pop-os/pop repo.

- [x] `sudo apt upgrade` updates the driver without conflicts (Ubuntu may require `full-upgrade`).

## Laptop graphics (switchable graphics)

Switchable graphics laptops can render with either the CPU-integrated GPU or the dedicated NVIDIA GPU. Before installing the driver update, make sure the machine is in Hybrid graphics mode.

- [x] After update and reboot, the machine remained in Hybrid graphics mode.

### Hybrid mode tests

- [x] Laptop suspends and resumes
- [x] `nvidia-smi` correctly reports the GPU's status
- [x] DisplayPort (mDP and DP over USB-C) outputs (including sound) work as expected
- [x] HDMI-out (including sound) works as expected
- [x] External display becomes primary display when laptop lid is closed
- [x] HDMI-out fractional scaling on extrnal monitor works at 125%, 150%, 175%
- [ ] DisplayPort (mDP and DP over USB-C) fractional scaling on extrnal monitor works at 125%, 150%, 175%
- [x] Steam can be installed and launched
  - [x] From Launcher
  - [x] From App Library
  - [x] From Dock
  - [x] From Terminal
- [x] A native Linux game can be launched from Steam
- [x] A Proton game can be launched from Steam

### NVIDIA mode tests

- [x] Laptop suspends and resumes
- [x] `nvidia-smi` correctly reports the GPU's status
- [x] DisplayPort (mDP and DP over USB-C) outputs (including sound) work as expected
- [x] HDMI-out (including sound) works as expected
- [x] External display becomes primary display when laptop lid is closed
- [x] HDMI-out fractional scaling on extrnal monitor works at 125%, 150%, 175%
- [ ] DisplayPort (mDP and DP over USB-C) fractional scaling on extrnal monitor works at 125%, 150%, 175%
- [x] Steam can be installed and launched
  - [x] From Launcher
  - [x] From App Library
  - [x] From Dock
  - [x] From Terminal
- [x] A native Linux game can be launched from Steam
- [x] A Proton game can be launched from Steam

### Compute mode tests

- [x] `nvidia-smi` correctly reports the GPU's status

### Integrated mode test

- [x] Steam can be installed and launched
  - [x] From Launcher
  - [x] From App Library
  - [x] From Dock
  - [x] From Terminal
- [x] A native Linux game can be launched from Steam
- [x] A Proton game can be launched from Steam

## Software tests

These can be done on any machine with an NVIDIA GPU

- [x] NVIDIA X Server Settings application launches properly
- [x] A Unigine benchmark performs as expected