From 399d28714f3a370f015641ff9e0a6da811f31f9e Mon Sep 17 00:00:00 2001
From: Daniel Micay <daniel.micay@grapheneos.org>
Date: Sat, 25 Nov 2023 20:28:54 -0500
Subject: [PATCH] document workaround for fwupd bug

---
 static/install/cli.html | 13 +++++++++++++
 static/install/web.html | 13 +++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/static/install/cli.html b/static/install/cli.html
index b1f48a0a..602ae82d 100644
--- a/static/install/cli.html
+++ b/static/install/cli.html
@@ -70,6 +70,7 @@
                     </li>
                     <li><a href="#checking-fastboot-version">Checking fastboot version</a></li>
                     <li><a href="#flashing-as-non-root">Flashing as non-root</a></li>
+                    <li><a href="#working-around-fwupd-bug-on-linux-distributions">Working around fwupd bug on Linux distributions</a></li>
                     <li><a href="#booting-into-the-bootloader-interface">Booting into the bootloader interface</a></li>
                     <li><a href="#connecting-device">Connecting the device</a></li>
                     <li><a href="#unlocking-the-bootloader">Unlocking the bootloader</a></li>
@@ -299,6 +300,18 @@ Installed as /home/username/platform-tools/fastboot</pre>
                 years.</p>
             </section>
 
+            <section id="working-around-fwupd-bug-on-linux-distributions">
+                <h2><a href="#working-around-fwupd-bug-on-linux-distributions">Working around fwupd bug on Linux distributions</a></h2>
+
+                <p>The fwupd software used by many traditional Linux distributions (not Android or
+                ChromeOS) has a bug breaking connecting to fastboot devices. The web installer
+                takes slightly longer to connect to the device and is more impacted by this. If
+                you're on a Linux distribution with fwupd running, stop it before proceeding. You
+                can do this by running the following command in a terminal:</p>
+
+                <pre>sudo systemctl stop fwupd.service</pre>
+            </section>
+
             <section id="booting-into-the-bootloader-interface">
                 <h2><a href="#booting-into-the-bootloader-interface">Booting into the bootloader interface</a></h2>
 
diff --git a/static/install/web.html b/static/install/web.html
index 2fdf713d..531ffabd 100644
--- a/static/install/web.html
+++ b/static/install/web.html
@@ -54,6 +54,7 @@
                     <li><a href="#prerequisites">Prerequisites</a></li>
                     <li><a href="#enabling-oem-unlocking">Enabling OEM unlocking</a></li>
                     <li><a href="#flashing-as-non-root">Flashing as non-root</a></li>
+                    <li><a href="#working-around-fwupd-bug-on-linux-distributions">Working around fwupd bug on Linux distributions</a></li>
                     <li><a href="#booting-into-the-bootloader-interface">Booting into the bootloader interface</a></li>
                     <li><a href="#connecting-device">Connecting the device</a></li>
                     <li><a href="#unlocking-the-bootloader">Unlocking the bootloader</a></li>
@@ -188,6 +189,18 @@
                 Ubuntu, install the <code>android-sdk-platform-tools-common</code> package.</p>
             </section>
 
+            <section id="working-around-fwupd-bug-on-linux-distributions">
+                <h2><a href="#working-around-fwupd-bug-on-linux-distributions">Working around fwupd bug on Linux distributions</a></h2>
+
+                <p>The fwupd software used by many traditional Linux distributions (not Android or
+                ChromeOS) has a bug breaking connecting to fastboot devices. The web installer
+                takes slightly longer to connect to the device and is more impacted by this. If
+                you're on a Linux distribution with fwupd running, stop it before proceeding. You
+                can do this by running the following command in a terminal:</p>
+
+                <pre>sudo systemctl stop fwupd.service</pre>
+            </section>
+
             <section id="booting-into-the-bootloader-interface">
                 <h2><a href="#booting-into-the-bootloader-interface">Booting into the bootloader interface</a></h2>