Skip to content

Commit 6f47139

Browse files
Merge pull request #443 from arduino/update-if-your-board-does-not-appear-in-a-port
Improvements to board detection Arduino IDE articles [HC-1518]
2 parents 2ba8666 + 1117c6e commit 6f47139

4 files changed

+205
-203
lines changed

content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,6 @@ If the Reset symbol is not present, click "Select other board and port" at the b
3939

4040
* If you're using an **Arduino Nano ESP32**, but it's being detected as a generic ESP32 board, the Arduino bootloader may be missing. To solve the issue, [reset the default Arduino bootloader](https://support.arduino.cc/hc/en-us/articles/9810414060188-Reset-the-Arduino-bootloader-on-the-Nano-ESP32).
4141

42-
* If you're using an **Arduino UNO R4 WiFi**, but it's being detected as an ESP32 board, the USB bridge firmware may be missing. To solve the issue, follow [these instructions to restore the firmware using espflash](https://support.arduino.cc/hc/en-us/articles/9670986058780-Update-the-connectivity-module-firmware-on-UNO-R4-WiFi#espflash).
42+
* If you're using an **Arduino UNO R4 WiFi**, but it's being detected as an ESP32 board, the USB bridge firmware may be missing. To solve the issue, follow [these instructions to restore the firmware using espflash](https://support.arduino.cc/hc/en-us/articles/16379769332892-Restore-the-USB-connectivity-firmware-on-UNO-R4-WiFi-with-espflash).
4343

4444
<!-- markdownlint-disable-file HC001 -->
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
---
2+
title: "If there are \"Unknown\" devices in the board selector or ports without a board name in the Tools > Port menu"
3+
id: 4412955149586
4+
---
5+
6+
Learn how to troubleshoot and resolve cases where the Arduino IDE shows "Unknown" devices or fails to assign a board name in the board selector and _Tools > Port_ menu.
7+
8+
In this article:
9+
10+
* [Understanding port detection](#understanding-port-detection)
11+
* [Troubleshooting steps](#troubleshooting)
12+
13+
---
14+
15+
## Understanding port detection {#understanding-port-detection}
16+
17+
The Arduino IDE scans the ports on your computer for devices that might be compatible boards. These detected serial ports are shown in both the board selector and the _Tools > Port_ menu.
18+
19+
* **Identified Devices**: If the Arduino IDE recognizes a device as an Arduino board, it displays the board and port in the board selector. In the _Tools > Port_ menu, the board name appears after the port name, enclosed in parentheses.
20+
21+
* **Unidentified Devices**: In some cases, the port information is not sufficient to determine the type of board that's connected, or if the connected device is a compatible board at all. In this case, the device will appear as "Unknown" in the board selector, and only the port name will be shown in the _Tools > Port_ menu.
22+
23+
This example shows the board selector and _Tools > Port_ menu on Windows when an Arduino UNO board and one other unidentified device is connected:
24+
25+
![Identified and unidentified ports in the board selector (left) and Tools > Port menu (right).](img/ide-com.png)
26+
27+
### Types of unidentified ports
28+
29+
The types of unidentified ports shown by Arduino IDE can be grouped in two categories:
30+
31+
* Arduino-compatible boards that use generic USB chips:
32+
* The "classic" Arduino Nano, which uses a FTDI USB chip.
33+
* Various "clone" board with generic USB chips such as the CH340.
34+
* Ports that do not belong to an Arduino-compatible device, but are detected and shown by Arduino IDE anyway:
35+
* Some non-Arduino devices with generic USB chips.
36+
* Some Bluetooth ports.
37+
* Debug ports.
38+
39+
> [!NOTE]
40+
> If you have many unidentified ports showing up in the list, consider disconnecting any boards and peripherals you don't need from your computer. Then, use [this procedure](#disconnect-reconnect-procedure) to see whether your board is being detected on any of the ports.
41+
42+
---
43+
44+
## Troubleshooting steps {#troubleshooting}
45+
46+
### 1. Disconnect and reconnect your board to check its port {#disconnect-reconnect-procedure}
47+
48+
**Using the board selector:**
49+
50+
1. Disconnect your board from your computer.
51+
52+
1. Open the board selector menu.
53+
54+
1. Connect your board to your computer.
55+
56+
**Using the _Tools > Board_ menu**:
57+
58+
1. Disconnect your board from your computer.
59+
60+
2. Open the _Tools > Port_ menu. Some ports may still be listed. Take note of this, and close the menu.
61+
62+
3. Connect your board to your computer.
63+
64+
4. Open the _Tools > Port_ menu. The port your board is connected to should now appear as a new port in the list.
65+
66+
### 2. Configure an unidentified board {#configuring-an-unidentified-board}
67+
68+
If you've determined which port belongs to your board:
69+
70+
**Using the board selector:**
71+
72+
1. Open the board selector.
73+
74+
1. Select the "Unknown" board you want to use.
75+
76+
1. In the pop-up "Select Other Board and Port" menu, select the board from the list.
77+
78+
1. Click OK.
79+
80+
**Using the _Tools > Board_ menu**:
81+
82+
1. Open the _Tools > Board_ menu.
83+
84+
1. Choose the board you want to use.
85+
86+
For more information, see [Select board and port in Arduino IDE](https://support.arduino.cc/hc/en-us/articles/4406856349970-Select-board-and-port-in-Arduino-IDE).
87+
88+
---
89+
90+
## Still need help?
91+
92+
* Visit the [Installation & Troubleshooting category](https://forum.arduino.cc/c/18) in the Arduino forum.
93+
* [Contact us](https://www.arduino.cc/en/contact-us/)
94+
95+
<!-- markdownlint-disable-file HC001 -->

content/Software Support/Upload/If-your-board-does-not-appear-on-a-port-in-Arduino-IDE.md

Lines changed: 0 additions & 202 deletions
This file was deleted.

0 commit comments

Comments
 (0)