Skip to content

Commit ebece6c

Browse files
committed
Update update-image.md
1 parent 0140c9f commit ebece6c

File tree

1 file changed

+43
-6
lines changed
  • content/hardware/02.uno/boards/uno-q/tutorials/04.update-image

1 file changed

+43
-6
lines changed

content/hardware/02.uno/boards/uno-q/tutorials/04.update-image/update-image.md

Lines changed: 43 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,21 @@ You should see something like:
5252

5353
This means it is working, and we can proceed to [flashing the board](#flash-image-to-the-board).
5454

55+
56+
#### Windows
57+
58+
Navigate to the unzipped folder (e.g. `arduino-flasher-cli-x.x.x-darwin-arm64`), and run the following command:
59+
60+
```
61+
arduino-flasher-cli
62+
```
63+
64+
A new window should appear, prompting you to install the driver. Install it, and run `arduino-flasher-cli` again in the terminal.
65+
66+
![Output from testing tool (Windows)](assets/windows.png)
67+
68+
This means it is working, and we can proceed to [flashing the board](#flash-image-to-the-board).
69+
5570
#### Linux
5671

5772
Navigate to the unzipped folder (e.g. `arduino-flasher-cli-x.x.x-darwin-arm64`), and run the following command:
@@ -66,19 +81,41 @@ You should see something like:
6681

6782
This means it is working, and we can proceed to [flashing the board](#flash-image-to-the-board).
6883

69-
#### Windows
84+
***Note: in some Linux systems there may be an issue with `qdl`, a tool included in the `arduino-flasher-cli`. This may occur if the kernel module `qcserial` is loaded. A workaround solution to fix this is in place (see section below).***
7085

71-
Navigate to the unzipped folder (e.g. `arduino-flasher-cli-x.x.x-darwin-arm64`), and run the following command:
86+
#### Fixing `qcserial` Issue (Linux Only)
87+
88+
Open a terminal, and check if `qcserial` is present by running `lsmod | grep qcse`
89+
90+
If present, it will return:
7291

7392
```
74-
arduino-flasher-cli
93+
> lsmod | grep qcse
94+
qcserial 24576 0
95+
usb_wwan 24576 1 qcserial
96+
usbserial 69632 2 qcserial,usb_wwan
7597
```
7698

77-
A new window should appear, prompting you to install the driver. Install it, and run `arduino-flasher-cli` again in the terminal.
99+
Then, check if `qcserial` is locking the serial port `ttyUSB0`, by running `sudo dmesg`:
78100

79-
![Output from testing tool (Windows)](assets/windows.png)
101+
```
102+
> sudo dmesg
103+
[31633.372270] qcserial ttyUSB0: Qualcomm USB modem converter now disconnected from ttyUSB0
104+
[31633.372308] qcserial 3-3:1.0: device disconnected
105+
```
80106

81-
This means it is working, and we can proceed to [flashing the board](#flash-image-to-the-board).
107+
This issue can be fixed by disabling (or blacklisting), the `qcserial` kernel module on the Linux system.
108+
109+
1. Create or edit a configuration file named `blacklist-modem.conf` inside the `/etc/modprobe.d/` directory:
110+
```sh
111+
sudo nano /etc/modprobe.d/blacklist-modem.conf
112+
```
113+
2. Inside this file, we need to blacklist the `qcserial` module:
114+
115+
```sh
116+
blacklist qcserial
117+
```
118+
3. Save the file and restart the system for the configuration to take effect.
82119

83120
## Preparing the Hardware
84121

0 commit comments

Comments
 (0)