Skip to content

Commit

Permalink
Update driver software (#1127)
Browse files Browse the repository at this point in the history 
* Update order and switch to git versions

* Add io package

* Fix order

* Update Fedora steps

* Add content and reorder it

* Update system76-software.md

extended update around gnome-extension that it does not work on newer GNOME releases.

* Remove Paru line in Fedora steps

* Address feedback

* Update folder names

* Replace system76-firmware-daemon with base system76-firmware package

* Update repo

---------

Co-authored-by: Aaron Honeycutt <aaronhoneycutt@proton.me>
Co-authored-by: thomas-zimmerman <41023059+thomas-zimmerman@users.noreply.github.com>
  • Loading branch information
@ahoneybun @thomas-zimmerman
3 people authored Sep 15, 2023
1 parent 62e19d6 commit 49dc3f8
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 45 deletions.
45 changes: 10 additions & 35 deletions content/system76-driver.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -20,30 +20,6 @@ This guide will show you how to add the System76 software repository and install

Please note these steps are not necessary in Pop!\_OS, which includes the repository and the appropriate drivers installed by default.

## Adding the Apt Preferences File

If you are running Ubuntu 19.10 or later, you will need to manually add an apt preferences file to "pin" the System76 repository. This will tell apt to prefer System76 packages over standard Ubuntu packages. Installing the System76 Driver will not be possible until this step is completed.

Create the apt preferences file here:

```bash
sudo gedit /etc/apt/preferences.d/system76-apt-preferences
```

Add the following six lines (seven if you count the space in the middle):

```bash
Package: *
Pin: release o=LP-PPA-system76-dev-stable
Pin-Priority: 1001

Package: *
Pin: release o=LP-PPA-system76-dev-pre-stable
Pin-Priority: 1001
```

Save the file. Now you should be able to install the System76 Driver as described below.

## Installing the Driver

To install our Driver you need to run the following commands in the Terminal:
Expand All @@ -56,7 +32,7 @@ sudo apt install system76-driver

This installs the System76 driver and related utilities which are needed to enable full functionality for your system.

## Installing the System76 NVIDIA Driver for Systems with NVIDIA GPUs
### Installing the System76 NVIDIA Driver for Systems with NVIDIA GPUs

If your system has an NVIDIA graphics card, you will want to go ahead and use this command to install the System76 Driver with NVIDIA graphics drivers built-in:

Expand All @@ -66,7 +42,7 @@ sudo apt-get install system76-driver-nvidia

In addition to the standard packages, that will pull in the latest NVIDIA drivers as packaged by System76, and all related packages needed to take full advantage of your dedicated NVIDIA graphics card.

### Install System76 Driver on Other Operating Systems
## Install System76 Driver on Other Operating Systems

**DISCLAIMER:** This section explains how to install the <u>System76 Driver</u> on Arch and Fedora.

Expand All @@ -78,7 +54,7 @@ The support team typically makes a best-effort attempt to offer direction or tro

**Note:** At this time, it is recommended to use the NVIDIA driver from the Arch and Fedora repositories.

### Arch - Manual install
## Arch - Manual install

First, install some build dependencies for the <u>System76 Firmware Daemon</u>, <u>System76 Driver</u> and the <u>Firmware Manager</u> packages:

Expand All @@ -91,8 +67,8 @@ sudo pacman -S --needed base-devel git linux-headers
These commands will clone, build and install the <u>System76 Firmware Daemon</u> service.

```bash
git clone https://aur.archlinux.org/system76-firmware-daemon.git
cd system76-firmware-daemon
git clone https://aur.archlinux.org/system76-firmware.git
cd system76-firmware
makepkg -srcif
sudo systemctl enable --now system76-firmware-daemon
sudo gpasswd -a $USER adm
Expand Down Expand Up @@ -121,7 +97,7 @@ sudo systemctl enable --now system76

Reboot the system so that our user is added to the `adm` group, then we are done!

### Arch - Using an AUR helper
## Arch - Using an AUR helper

Arch users can alternatively use an AUR helper to automate some of the steps for installation and upgrading; in this example, we'll use the <u>Paru</u> application. <u>Paru</u> can be installed from the AUR using these commands:

Expand All @@ -134,13 +110,13 @@ makepkg -si
**Note:** By default, <u>Paru</u> uses VIM keyboard shortcuts, so when you see a `:`, press the <kbd>q</kbd> key to continue. You may also need to confirm the import of some public keys using the <kbd>y</kbd> key.

```bash
paru -S system76-firmware-daemon
paru -S system76-firmware-daemon-git
sudo systemctl enable --now system76-firmware-daemon
sudo gpasswd -a $USER adm
```

```bash
paru -S firmware-manager
paru -S firmware-manager-git
```

```bash
Expand All @@ -149,12 +125,11 @@ paru -S system76-driver
sudo systemctl enable --now system76
```

### Fedora
## Fedora

Run these commands in a <u>Terminal</u> to enable the [community Fedora COPR](https://copr.fedorainfracloud.org/coprs/szydell/system76/) and install the <u>System76 Driver</u> :

```bash
sudo dnf copr enable szydell/system76
sudo dnf install system76*
sudo systemctl enable --now com.system76.PowerDaemon.service
sudo dnf install system76-driver
```
35 changes: 25 additions & 10 deletions content/system76-software.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -34,17 +34,17 @@ If you want to use an AUR helper like [Paru](https://github.com/Morganamilo/paru
This command will install all of the packages using <u>Paru</u>.

```bash
paru -S system76-firmware-daemon system76-firmware firmware-manager system76-power gnome-shell-extension-system76-power-git system76-driver system76-dkms system76-acpi-dkms
paru -S system76-firmware-daemon system76-firmware firmware-manager system76-power gnome-shell-extension-system76-power-git system76-driver system76-dkms system76-acpi-dkms system76-io-dkms
```

This command will install `firmware-manager` using <u>Paru</u>.

**NOTE:** choose the first software option after running the <u>Paru</u> command.

```bash
paru -S firmware-manager
```

This command will install <u>firmware-manager</u> using <u>Paru</u>.

### System76 DKMS

This package is needed for hotkeys and fan(s) on Closed Firmware systems.
Expand Down Expand Up @@ -155,7 +155,14 @@ paru -S system76-acpi-oled

## Fedora

Be sure to install the <u>System76 Driver</u> first. The steps to do that are [here](/articles/system76-driver).
Be sure to install the <u>System76 Driver</u> first. The steps to do that are [here](/articles/system76-driver). The commands below will install every system76 package using the wildcard(*) use the other sections to install each package on it's own if you do not want all of the packages.

```bash
sudo dnf install system76* firmware-manager
sudo systemctl enable --now system76-firmware-daemon
sudo systemctl mask power-profiles-daemon.service
sudo gpasswd -a $USER adm
```

### System76 Firmware Manager in Fedora

Expand All @@ -167,6 +174,12 @@ sudo systemctl enable --now system76-firmware-daemon
sudo gpasswd -a $USER adm
```

**NOTE:** After enabling the dkms systemd service for any of the DKMS packages you will need to reboot the system:

```bash
sudo systemctl reboot
```

### System76 Power in Fedora

Use these commands to install the <u>System76 Power</u> package and enable the service:
Expand All @@ -184,6 +197,8 @@ sudo systemctl mask power-profiles-daemon.service

### System76 Power GNOME Shell Extension in Fedora

**NOTE:** Fedora uses GNOME 44 and some of the internal APIs are missing that are used in this extention. The API change happend with the release of GNOME 43. Pull requests that update to newer APIs are very welcome!

These commands will download the source code for the application, build it, install it and install the <u>Extensions</u> application:

```bash
Expand Down Expand Up @@ -221,12 +236,6 @@ sudo dnf install system76-acpi-dkms
sudo systemctl enable dkms
```

**NOTE:** After enabling the dkms systemd service for either the <u>System76 DKMS</u> or the <u>System76 ACPI DKMS</u> package you will need to reboot the system:

```bash
sudo systemctl reboot
```

### System76 Thelio Io DKMS in Fedora

This command will be used to install the <u>System76 Io DKMS</u> which is used for the Thelio Io board:
Expand All @@ -235,6 +244,12 @@ This command will be used to install the <u>System76 Io DKMS</u> which is used f
sudo dnf install system76-io-dkms
```

**NOTE:** After enabling the dkms systemd service for any of the DKMS packages you will need to reboot the system:

```bash
sudo systemctl reboot
```

### System76 OLED in Fedora

This command will be used to install the <u>System76 OLED</u> which is used for systems with OLED panels:
Expand Down

0 comments on commit 49dc3f8

Please sign in to comment.