document workaround for fwupd bug

This commit is contained in:
Daniel Micay 2023-11-25 20:28:54 -05:00
parent e97ab7e0d1
commit 399d28714f
2 changed files with 26 additions and 0 deletions

View File

@ -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>

View File

@ -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>