Skip to content

Commit 18a866c

Browse files
committed
improved instructions
1 parent 74a6f1f commit 18a866c

File tree

2 files changed

+16
-15
lines changed

2 files changed

+16
-15
lines changed

src/app/Flash.jsx

+1-2
Original file line numberDiff line numberDiff line change
@@ -22,8 +22,7 @@ const steps = {
2222
icon: cloud,
2323
},
2424
[Step.READY]: {
25-
status: 'Ready',
26-
description: 'Tap the button above to begin',
25+
status: 'Tap to start',
2726
bgColor: 'bg-[#51ff00]',
2827
icon: bolt,
2928
iconStyle: '',

src/app/index.jsx

+15-13
Original file line numberDiff line numberDiff line change
@@ -70,13 +70,10 @@ export default function App() {
7070
</ul>
7171
{isWindows && (<>
7272
<h3>USB Driver</h3>
73-
<p>
74-
You need additional driver software for Windows before you connect
75-
your device.
76-
</p>
73+
<p>You need additional driver software for Windows before you connect your device.</p>
7774
<ol>
7875
<li>
79-
Download and install <a href="https://zadig.akeo.ie/">Zadig</a>.
76+
Download and run <a href="https://zadig.akeo.ie/" target="_blank">Zadig</a>.
8077
</li>
8178
<li>
8279
Under <code>Device</code> in the menu bar, select <code>Create New Device</code>.
@@ -110,14 +107,15 @@ export default function App() {
110107
<p>Follow these steps to put your device into QDL mode:</p>
111108
<ol>
112109
<li>Unplug the device and wait for the LED to switch off.</li>
113-
<li>Connect the device to your computer using the lower <span className="whitespace-nowrap">USB-C</span> port.</li>
110+
<li>Connect the device to your computer using the <strong>lower</strong> <span className="whitespace-nowrap">USB-C</span> port.</li>
114111
</ol>
115112
<img
116113
src={qdlPorts}
117114
alt="image showing comma three and two ports. the upper port is labeled with a cross. the lower port is labeled with a checkmark."
118115
width={450}
119116
height={300}
120117
/>
118+
<p>Your device&apos;s screen will remain blank for the entire flashing process. This is normal.</p>
121119
{isLinux && (<>
122120
<strong>Note for Linux users</strong>
123121
<p>
@@ -128,8 +126,8 @@ export default function App() {
128126
<CopyText>{DETACH_SCRIPT}</CopyText>
129127
</>)}
130128
<p>
131-
After your device is in QDL mode, you can click the button to start flashing. A prompt may appear to
132-
select a device; choose the device starts with <code>QUSB_BULK</code>.
129+
Next, click the button to start flashing. From the prompt select the device which starts with
130+
&ldquo;QUSB_BULK&rdquo;.
133131
</p>
134132
<p>
135133
The process can take 30+ minutes depending on your internet connection and system performance. Do not
@@ -142,14 +140,18 @@ export default function App() {
142140
<h2>Troubleshooting</h2>
143141
<h3>Lost connection</h3>
144142
<p>
145-
Try using a different USB cable or USB port. Sometimes USB 2.0 ports work better than USB 3.0 (blue) ports.
146-
If you&apos;re using a USB hub, try connecting the device directly to your computer, or alternatively use a
147-
USB hub between your computer and the device.
143+
Try using high quality USB 3 cables. You should also try different USB ports on the front or back of your
144+
computer. If you&apos;re using a USB hub, try connecting directly to your computer instead.
148145
</p>
149146
<h3>My device&apos;s screen is blank</h3>
150147
<p>
151-
The device screen will be blank in QDL mode, but you can verify that it is in QDL if the device shows up
152-
when you press the Flash icon.
148+
This is normal in QDL mode. You can verify that the &ldquo;QUSB_BULK&rdquo; device shows up when you press
149+
the Flash button to know that it is working correctly.
150+
</p>
151+
<h3>My device says &ldquo;fastboot mode&rdquo;</h3>
152+
<p>
153+
You may have followed outdated instructions for flashing. Please read the instructions above for putting
154+
your device into QDL mode.
153155
</p>
154156
<h3>After flashing, device says unable to mount data partition</h3>
155157
<p>This is expected after the filesystem is erased. Press confirm to finish resetting your device.</p>

0 commit comments

Comments
 (0)