From d8b8fb9e426ac88901c92b72cdb80c0745e21dc8 Mon Sep 17 00:00:00 2001
From: Daniel Micay <daniel.micay@grapheneos.org>
Date: Sat, 26 Apr 2025 14:57:12 -0400
Subject: [PATCH] fwupd is still consistently buggy years later

---
 static/install/cli.html | 23 +++++++++--------------
 static/install/web.html | 23 +++++++++--------------
 static/js/redirect.js   |  3 +++
 3 files changed, 21 insertions(+), 28 deletions(-)

diff --git a/static/install/cli.html b/static/install/cli.html
index 5927096b..f00c9263 100644
--- a/static/install/cli.html
+++ b/static/install/cli.html
@@ -70,7 +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="#working-around-fwupd-bugs-on-linux-distributions">Working around fwupd bugs 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>
@@ -305,21 +305,16 @@ 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>
+            <section id="working-around-fwupd-bugs-on-linux-distributions">
+                <h2><a href="#working-around-fwupd-bugs-on-linux-distributions">Working around fwupd bugs on Linux distributions</a></h2>
 
-                <p>Some Debian, Ubuntu, and derivative distributions have an outdated fwupd package
-                with a bug breaking connecting to Android's bootloader interface (fastboot) while
-                fwupd is running since it tries to connect to arbitrary devices. This section can
-                be skipped on Arch Linux and other distributions with fwupd 1.9.10 or later since
-                we reported the bug and it was fixed. This never impacted Android or ChromeOS.</p>
+                <p>The fwupd software often used on Linux distributions for updating firmware is
+                known to incorrectly connect to arbitrary devices using the fastboot protocol which
+                will block using them for the intended purpose. This can result in receiving an
+                error about the USB device already being in use (claimed) when trying to connect to
+                it for the intended purpose.</p>
 
-                <p>Check your fwupd version with the following command:</p>
-
-                <pre>apt-cache policy fwupd</pre>
-
-                <p>If you have a fwupd version earlier than 1.9.10, you can stop fwupd with the
-                following command:</p>
+                <p>You can stop fwupd with the following command:</p>
 
                 <pre>sudo systemctl stop fwupd.service</pre>
 
diff --git a/static/install/web.html b/static/install/web.html
index 1fd678a0..516db0e9 100644
--- a/static/install/web.html
+++ b/static/install/web.html
@@ -54,7 +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="#working-around-fwupd-bugs-on-linux-distributions">Working around fwupd bugs 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>
@@ -202,21 +202,16 @@
                 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>
+            <section id="working-around-fwupd-bugs-on-linux-distributions">
+                <h2><a href="#working-around-fwupd-bug-on-linux-distributions">Working around fwupd bugs on Linux distributions</a></h2>
 
-                <p>Some Debian, Ubuntu, and derivative distributions have an outdated fwupd package
-                with a bug breaking connecting to Android's bootloader interface (fastboot) while
-                fwupd is running since it tries to connect to arbitrary devices. This section can
-                be skipped on Arch Linux and other distributions with fwupd 1.9.10 or later since
-                we reported the bug and it was fixed. This never impacted Android or ChromeOS.</p>
+                <p>The fwupd software often used on Linux distributions for updating firmware is
+                known to incorrectly connect to arbitrary devices using the fastboot protocol which
+                will block using them for the intended purpose. This can result in receiving an
+                error about the USB device already being in use (claimed) when trying to connect to
+                it for the intended purpose.</p>
 
-                <p>Check your fwupd version with the following command:</p>
-
-                <pre>apt-cache policy fwupd</pre>
-
-                <p>If you have a fwupd version earlier than 1.9.10, you can stop fwupd with the
-                following command:</p>
+                <p>You can stop fwupd with the following command:</p>
 
                 <pre>sudo systemctl stop fwupd.service</pre>
 
diff --git a/static/js/redirect.js b/static/js/redirect.js
index 3689a344..5043341a 100644
--- a/static/js/redirect.js
+++ b/static/js/redirect.js
@@ -35,6 +35,9 @@ const redirects = new Map([
     ["/install/cli#obtaining-signify", "/install/cli#obtaining-openssh"],
     ["/install/web#fastboot-as-non-root", "/install/web#flashing-as-non-root"],
 
+    ["/install/cli#working-around-fwupd-bug-on-linux-distributions", "/install/cli#working-around-fwupd-bugs-on-linux-distributions"],
+    ["/install/web#working-around-fwupd-bug-on-linux-distributions", "/install/web#working-around-fwupd-bugs-on-linux-distributions"],
+
     ["/build#enabling-updatable-apex-components", "/build#apex-components"],
     ["/build#kernel-6th-generation-pixels", "/build#kernel-6th-through-9th-generation-pixels"],
     ["/build#kernel-7th-generation-pixels", "/build#kernel-6th-through-9th-generation-pixels"],