diff options
| author | Daniel Micay <daniel.micay@grapheneos.org> | 2023-11-25 20:28:54 -0500 |
|---|---|---|
| committer | Daniel Micay <daniel.micay@grapheneos.org> | 2023-11-26 07:19:25 -0500 |
| commit | 399d28714f3a370f015641ff9e0a6da811f31f9e (patch) | |
| tree | e4789e18c3915be326f634f2f2fab0cd1650777e | |
| parent | e97ab7e0d1948c57d16f4c5d07d1370ee81d3505 (diff) | |
document workaround for fwupd bug
| -rw-r--r-- | static/install/cli.html | 13 | ||||
| -rw-r--r-- | static/install/web.html | 13 |
2 files changed, 26 insertions, 0 deletions
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> |