diff options
| author | Peter Easton <Peter@JollyRogers.ca> | 2020-04-12 20:16:30 +0000 |
|---|---|---|
| committer | Daniel Micay <danielmicay@gmail.com> | 2020-04-21 07:06:36 -0400 |
| commit | df86b8b6d5fa8d389bd5b056d57ca2fa6bb1a2fd (patch) | |
| tree | 7706bc9d652af8c28ae6351862da226ccd5ec658 | |
| parent | 83ee8d25b78276f8f7230050a4a6cc43a5b3baaf (diff) | |
Add a troubleshooting section to "Flashing factory images"
| -rw-r--r-- | static/install.html | 24 |
1 files changed, 23 insertions, 1 deletions
diff --git a/static/install.html b/static/install.html index 34a60a09..07fd7c49 100644 --- a/static/install.html +++ b/static/install.html @@ -60,7 +60,12 @@ <li><a href="#enabling-oem-unlocking">Enabling OEM unlocking</a></li> <li><a href="#unlocking-the-bootloader">Unlocking the bootloader</a></li> <li><a href="#obtaining-factory-images">Obtaining factory images</a></li> - <li><a href="#flashing-factory-images">Flashing factory images</a></li> + <li> + <a href="#flashing-factory-images">Flashing factory images</a> + <ul> + <li><a href="#troubleshooting">Troubleshooting</a></li> + </ul> + </li> <li><a href="#locking-the-bootloader">Locking the bootloader</a></li> <li><a href="#disabling-oem-unlocking">Disabling OEM unlocking</a></li> <li><a href="#verifying-installation">Verifying installation</a></li> @@ -212,6 +217,23 @@ TMPDIR="$PWD/tmp" ./flash-all.sh</pre> XL, you'll need to reboot from the userspace fastbootd mode to the bootloader by selecting <code>Reboot to bootloader</code> from the fastbootd menu using the volume keys and the power button in order to continue the installation.</p> + <h3 id="troubleshooting"> + <a href="#troubleshooting">Troubleshooting</a> + </h3> + <p>A majority of failed flashes tend to be caused by substandard USB connectors, + plugging in via hubs or bad cables which aren't properly up to the USB standard. The + scrollback from a failed flash will contain valuable diagnostic information which + is essential in knowing where and how the process went wrong.</p> + <p>Front I/O ports on desktop computer cases and USB 3.1 or USB C on many laptops + often aren't implement properly or are broken in subtle ways, which may cause flashing + to fail even a USB port that works for other peripherals. Older Linux kernels that + predate version 5 may have inadequate or patchwork support for USB C or USB 3. If you + are installing from a Linux distribution, ensure your distribution uses a modern + kernel.</p> + <p>Always use a high quality USB A to USB C cable with a rear USB port directly on your + motherboard, and never use a USB hub for flashing. <em>Never install from a virtual + machine;</em> USB passthrough in software emulation may be broken or inadequate and this + can cause the flashing to fail.</p> <h2 id="locking-the-bootloader"> <a href="#locking-the-bootloader">Locking the bootloader</a> </h2> |