From 8954b65a93fe5f79fb094220b6092f0323d28892 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Fri, 1 Nov 2024 11:20:22 +0100 Subject: [PATCH 01/12] Update If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md --- ...rent-board-than-the-one-youve-connected.md | 20 ++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md b/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md index 9c6e5a7b..f8a927a8 100644 --- a/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md +++ b/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md @@ -9,6 +9,7 @@ In this article: * [Reset manual board selection](#manual-selection) * [If your UNO R4 WiFi or Nano ESP32 is identified as a generic ESP32 board](#generic-esp32) +* [If Arduino UNO (Rev3 or earlier), Mega, or classic Nano is misidentified](#misidentified-uno-mega-nano) --- @@ -39,6 +40,23 @@ If the Reset symbol is not present, click "Select other board and port" at the b * 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). -* 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). +* 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). + +--- + + + +## If Arduino UNO (Rev3 or earlier), Mega, or classic Nano is misidentified + +* If your **UNO (Rev3 or earlier)** or **Mega** board is recognized as any of the following, it may indicate that the USB-to-Serial firmware is missing or corrupted: + + * Unknown Device + * Composite Device + * ATmega16u2 DFU + * Atmega8U2 DFU + + To solve the issue, [flash the USB-to-serial firmware](https://support.arduino.cc/hc/en-us/articles/4408887452434-Flash-the-USB-to-serial-firmware-for-UNO-Rev3-and-earlier-and-Mega-boards). + +* If you're using a **classic Nano**, but it's being detected as "USB Serial Port" or another generic name, the FTDI drivers may be missing. To solve the issue, follow [install the FTDI drivers](https://support.arduino.cc/hc/en-us/articles/4411305694610-Install-or-update-FTDI-drivers). From a59f24a9367dd8d8ea544fa27fadc2ad319c6f71 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Fri, 1 Nov 2024 14:14:54 +0100 Subject: [PATCH 02/12] update "If your board does not appear on a port in Arduino IDE" --- ...oes-not-appear-on-a-port-in-Arduino-IDE.md | 202 ------------------ ...ur-board-is-not-detected-by-Arduino-IDE.md | 95 ++++++++ 2 files changed, 95 insertions(+), 202 deletions(-) delete mode 100644 content/Software Support/Upload/If-your-board-does-not-appear-on-a-port-in-Arduino-IDE.md create mode 100644 content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md diff --git a/content/Software Support/Upload/If-your-board-does-not-appear-on-a-port-in-Arduino-IDE.md b/content/Software Support/Upload/If-your-board-does-not-appear-on-a-port-in-Arduino-IDE.md deleted file mode 100644 index c09ba893..00000000 --- a/content/Software Support/Upload/If-your-board-does-not-appear-on-a-port-in-Arduino-IDE.md +++ /dev/null @@ -1,202 +0,0 @@ ---- -title: "If your board does not appear on a port in Arduino IDE" -id: 4412955149586 ---- - -Learn what to do if your board is missing from the board selector or _Tools > Port_ menu. - -## Before you begin - -* Ensure you've connected your board with a working data USB cable. -* Check that your device is powered. One or more more LEDs should be lit. -* In earlier versions of Arduino IDE 2, the _Tools > Port_ menu option would only be displayed if at least one device was detected on a port. This was fixed in version 2.0.4[^2.0.4]. -* Classic Nano boards and some clone boards with generic USB chips will show up as **"Unknown"** in the board selector. When selecting an "Unknown" port you will be prompted to select the board type manually. Alternatively, select your board in the _Tools > Board_ menu. -* If you're using a classic Arduino Nano, you may need to [manually install FTDI drivers](https://support.arduino.cc/hc/en-us/articles/4411305694610-Install-or-update-FTDI-drivers). -* If you're using an Arduino-based "clone" board with a CH340 USB chip, you may need to [manually install CH340 drivers](https://sparks.gogo.co.nz/ch340.html). - -[^2.0.4]: - -## In this article - -* [If there are "Unknown" devices in the board selector and without a board name in the Tools > Port menu](#unknown-devices) -* [If your board does not appear on any port](#no-device-recognized) - ---- - - - -## If there are "Unknown" devices in the board selector and without a board name in the Tools > Port menu - -Arduino IDE will list detected serial ports in the board selector and _Tools > Port_ menu. - - - -* If Arduino IDE is able to **identify** a device as an Arduino board, it will the board name instead of "Unknown" in the board selector. In the _Tools > Port_ menu, the board name will appear after the port name, enclosed by parentheses. -* 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, it will appear as an "Unknown" device in the board selector and show only the port name in the _Tools > Port_ menu. - -This example shows the board selector and Tools > Port menu on Windows when an Arduino UNO board and one other unidentified device is connected: - -![Identified and unidentified ports in the board selector (left) and Tools > Port menu (right).](img/ide-com.png) - -The types of unidentified ports shown by Arduino IDE can be grouped in two categories: - -* Arduino-compatible boards that use generic USB chips: - * The "classic" Arduino Nano, which uses a FTDI USB chip. - * Various "clone" board with generic USB chips such as the CH340. -* Ports that do not belong to an Arduino-compatible device, but are detected and shown by Arduino IDE anyway: - * Some non-Arduino devices with generic USB chips. - * Some Bluetooth ports. - * Debug ports. - -> [!NOTE] -> 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. - - - -### Disconnect and reconnect your board to check its port - -**Using the board selector:** - -1. Disconnect your board from your computer. - -1. Open the board selector menu. - -1. Connect your board to your computer. - -**If you're using IDE 1, the board selector won't be available. Use the _Tools > Port_ menu instead:** - -1. Disconnect your board from your computer. - -2. Open the _Tools > Port_ menu. Some ports may still be listed. Take note of this, and close the menu. - -3. Connect your board to your computer. - -4. Open the _Tools > Port_ menu. The port your board is connected to should now appear as a new port in the list. - - - -### Configure an unidentified board - -If you've determined which port belongs to your board: - -**Using the board selector:** - -1. Open the board selector. - -1. Select the "Unknown" board you want to use. - -1. In the pop-up "Select Other Board and Port" menu, select the board from the list. - -1. Click OK. - -**Using the _Tools > Board_ menu**: - -1. Open the Tools > Board menu. - -1. Choose the board you want to use. - -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). - ---- - - - -## If your board does not appear on any port - -> [!NOTE] -> If the Tools > Port menu is open, you need to close and re-open it for the list to refresh. - -If you've determined that none of the listed ports belongs to your board, or of no ports are listed at all, check the following: - -### Check board connections - -A common reason for the board not appearing on a port is a problem with the USB connection: - -1. The board needs to be connected to your computer with a data USB cable. -2. Make sure the USB cable is not damaged. Test your cable with a different device, or try using a different cable. -3. Try using a different USB port on your computer. -4. If possible, connect the board directly to your computer instead of a through a hub. -5. Remove any connections to the **0(RX)** and **1(TX)** pins when uploading code. - -### Install missing drivers - -Some boards require special drivers for serial communication: - -* If you're using a classic Nano, [install the FTDI drivers](https://support.arduino.cc/hc/en-us/articles/4411305694610-Install-or-update-FTDI-drivers). -* If you're using a "clone" board with a CH340 USB chip, you may need to [manually install CH340 drivers](https://sparks.gogo.co.nz/ch340.html). - -### Try a bootloader reset if your board supports it - -The board may be stuck in a state where it cannot communicate on the port. On some boards (such as those of the MKR Family and newer Nano boards), pressing the RESET button twice in quick succession will put the board in bootloader mode. Instead of running a sketch, the Arduino will wait until a sketch is uploaded. While in bootloader mode, an orange LED will fade in and out. - -1. Find the reset button on the board. - -2. Click the button two times in succession. - - ![The RESET button on Arduino Zero with an "x2" label graphic.](img/zero-reset-button-double.png) - -3. Check the board selector or Tools > Port again. - -### Check for additional system information - -If Arduino IDE is not displaying a port for your board, you may still get some information by using a dedicated software utility: - - - - - - - - - - - - - - - -
Windows -
    -
  1. Open the Device Manager by searching for it in the start menu. You can also try right-clicking the Start button and choosing Device Manager.
    2. -
  2. In the Device Manager, open the Other Devices section.
    3. -
  3. Review the list of devices.
    4. -
-
macOS -
    -
  1. Press ⌘ + Space to open Spotlight. Search for the System Information app and open it.
    2. -
  2. Select the Hardware > USB section.
    3. -
  3. Review the list of USB devices.
    4. -
-
Linux -

Use a device manager of your choice, such as hardinfo.

-

To install and use hardinfo, follow these steps:

-
    -
  1. Open Terminal and run sudo apt install hardinfo.
    2. -
  2. Wait for the installation to complete, then run the hardinfo command.
    3. -
  3. Check Devices > USB Devices
    4. -
  4. Review the list of USB devices.
    5. -
-
- -Here are some cases to look out for: - -* Missing drivers can cause your "classic" Nano board to be recognized as **"USB Serial Port"**, or some other generic name. -* If your board is an UNO or Mega board, missing or corrupted **USB-to-Serial firmware** may cause the board to be recognized as any of the following: - - * Unknown Device - * Unknown USB Device - * Composite Device - * USB Device - * ATmega16u2 DFU - * Atmega8U2 DFU - - If your board is listed with one of these names you may resolve the issue by [flashing the USB-to-serial firmware in DFU mode](https://support.arduino.cc/hc/en-us/articles/4408887452434-Flash-USB-to-serial-firmware-in-DFU-mode). - ---- - -## Still need help? - -* Visit the [Installation & Troubleshooting category](https://forum.arduino.cc/c/18) in the Arduino forum. -* [Contact us](https://www.arduino.cc/en/contact-us/) - - diff --git a/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md new file mode 100644 index 00000000..9514d8d2 --- /dev/null +++ b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md @@ -0,0 +1,95 @@ +--- +title: "If your board is not detected by Arduino IDE" +id: 4412955149586 +--- + +Learn what to do if your Arduino board is missing from the board selector or from the _Tools > Port_ menu in Arduino IDE. + +> [!NOTE] +> If you're using Arduino Cloud Editor, see [If your board is not detected by Arduino Cloud Editor](https://support.arduino.cc/hc/en-us/articles/360018131160-If-your-board-is-not-detected-by-Arduino-Cloud-Editor). + +## Troubleshooting + +### 1. Identify the problem + +* **Incorrect Board Identification**: If Arduino IDE incorrectly identifies your board with a generic name or as a different board type, see [If Arduino IDE detects a different board than the one you've connected](https://support.arduino.cc/hc/en-us/articles/12070802257436-If-Arduino-IDE-detects-a-different-board-than-the-one-you-ve-connected) instead. + +* **Unknown Devices**: If the board selector in Arduino IDE displays “Unknown” devices, refer to [If there are “Unknown” devices in the board selector and without a board name in the Tools > Port menu](add link) instead. + +* **Missing Board**: If your Arduino board is missing from the board selector or from the Tools > Port menu in Arduino IDE, proceed to the instructions below. + +### 1. Check board connection + +A common reason for a board not being detected is an issue with the USB connection. Follow the steps below to ensure a proper setup: + +* *Use a Data USB Cable*: Connect your board with a data USB cable, not a charging-only cable. +* *Test the USB Cable*: Check that the USB cable is not damaged. You can verify this by testing the cable with another device or by trying a different cable. +* *Connect directly*: connect the board directly into your computer instead of through a USB hub. +* *Try a Different USB Port*: If the board is still not detected, connect it to a different USB port on your computer. +* *Check power*: Verify that your device powers on—at least one LED should be lit. +* *Disconnect jumper cables*: Remove any jumper cables connected to the board’s pins, as they may interfere with detection. + +### 2. Try a bootloader reset if your board supports it + +If the board is still not detected, it might be stuck in a state where it cannot communicate on the port. For some boards (such as those in the MKR Family and newer Nano boards), pressing the RESET button twice in quick succession will activate bootloader mode. Follow the steps below to perform a bootloader reset: + +1. Find the reset button on the board. + +2. Press the button two times in succession. + + ![The RESET button on Arduino Zero with an "x2" label graphic.](img/zero-reset-button-double.png) + +3. An orange LED will fade in and out, indicating that the board is in bootloader mode, + +4. Check the board selector or _Tools > Port_ again to see if your board is now detected. + +### 3. Check for additional system information + +If Arduino IDE is not displaying a port for your board, you may still get some information by using a dedicated software utility: + + + + + + + + + + + + + + + +
Windows +
    +
  1. Open the Device Manager by searching for it in the start menu. You can also try right-clicking the Start button and choosing Device Manager.
    2. +
  2. In the Device Manager, open the Other Devices section.
    3. +
  3. Review the list of devices.
    4. +
+
macOS +
    +
  1. Press ⌘ + Space to open Spotlight. Search for the System Information app and open it.
    2. +
  2. Select the Hardware > USB section.
    3. +
  3. Review the list of USB devices.
    4. +
+
Linux +

Use a device manager of your choice, such as hardinfo.

+

To install and use hardinfo, follow these steps:

+
    +
  1. Open Terminal and run sudo apt install hardinfo.
    2. +
  2. Wait for the installation to complete, then run the hardinfo command.
    3. +
  3. Check Devices > USB Devices
    4. +
  4. Review the list of USB devices.
    5. +
+
+ +> [!TIP] +> You can use this information to determine if the board is being detected by the computer but not by the Arduino IDE. + +--- + +## Still need help? + +* Visit the [Installation & Troubleshooting category](https://forum.arduino.cc/c/18) in the Arduino forum. +* [Contact us](https://www.arduino.cc/en/contact-us/) From ab533a63a7fee3c47d7d58d6fc115b612f1a3e76 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Fri, 1 Nov 2024 14:16:43 +0100 Subject: [PATCH 03/12] Update If-your-board-is-not-detected-by-Arduino-IDE.md --- .../Upload/If-your-board-is-not-detected-by-Arduino-IDE.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md index 9514d8d2..a715a2a0 100644 --- a/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md +++ b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md @@ -18,7 +18,7 @@ Learn what to do if your Arduino board is missing from the board selector or fro * **Missing Board**: If your Arduino board is missing from the board selector or from the Tools > Port menu in Arduino IDE, proceed to the instructions below. -### 1. Check board connection +### 2. Check board connection A common reason for a board not being detected is an issue with the USB connection. Follow the steps below to ensure a proper setup: @@ -29,7 +29,7 @@ A common reason for a board not being detected is an issue with the USB connecti * *Check power*: Verify that your device powers on—at least one LED should be lit. * *Disconnect jumper cables*: Remove any jumper cables connected to the board’s pins, as they may interfere with detection. -### 2. Try a bootloader reset if your board supports it +### 3. Try a bootloader reset if your board supports it If the board is still not detected, it might be stuck in a state where it cannot communicate on the port. For some boards (such as those in the MKR Family and newer Nano boards), pressing the RESET button twice in quick succession will activate bootloader mode. Follow the steps below to perform a bootloader reset: @@ -43,7 +43,7 @@ If the board is still not detected, it might be stuck in a state where it cannot 4. Check the board selector or _Tools > Port_ again to see if your board is now detected. -### 3. Check for additional system information +### 4. Check for additional system information If Arduino IDE is not displaying a port for your board, you may still get some information by using a dedicated software utility: From 60e4f9d4262ffd0075f652f7a7ee0fca6e223286 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Fri, 1 Nov 2024 14:44:47 +0100 Subject: [PATCH 04/12] Create If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md --- ...-a-board-name-in-the-Tools-Port-menu.md.md | 100 ++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md diff --git a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md new file mode 100644 index 00000000..192b016f --- /dev/null +++ b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md @@ -0,0 +1,100 @@ +--- +title: "If there are "Unknown" devices in the board selector and ports without a board name in the Tools > Port menu" +id: 4412955149586 +--- + +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. + +In this article: + +* [Understanding port detection](#understanding-port-detection) +* [Troubleshooting steps](#troubleshooting) + +--- + +## Understanding port detection {#understanding-port-detection} + +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. + +* **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. + +* **"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. + +> [!NOTE] +> In earlier versions of Arduino IDE 2, the _Tools > Port_ menu option would only be displayed if at least one device was detected on a port. This was fixed in version 2.0.4[^2.0.4]. + +[^2.0.4]: + +This example shows the board selector and _Tools > Port_ menu on Windows when an Arduino UNO board and one other unidentified device is connected: + +![Identified and unidentified ports in the board selector (left) and Tools > Port menu (right).](img/ide-com.png) + +### Types of unidentified ports + +The types of unidentified ports shown by Arduino IDE can be grouped in two categories: + +* Arduino-compatible boards that use generic USB chips: + * The "classic" Arduino Nano, which uses a FTDI USB chip. + * Various "clone" board with generic USB chips such as the CH340. +* Ports that do not belong to an Arduino-compatible device, but are detected and shown by Arduino IDE anyway: + * Some non-Arduino devices with generic USB chips. + * Some Bluetooth ports. + * Debug ports. + +> [!NOTE] +> 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. + +--- + +## Troubleshooting steps {#troubleshooting} + +### Disconnect and reconnect your board to check its port {#disconnect-reconnect-procedure} + +**Using the board selector:** + +1. Disconnect your board from your computer. + +1. Open the board selector menu. + +1. Connect your board to your computer. + +**If you're using IDE 1, the board selector won't be available. Use the _Tools > Port_ menu instead:** + +1. Disconnect your board from your computer. + +2. Open the _Tools > Port_ menu. Some ports may still be listed. Take note of this, and close the menu. + +3. Connect your board to your computer. + +4. Open the _Tools > Port_ menu. The port your board is connected to should now appear as a new port in the list. + +### Configure an unidentified board {#configuring-an-unidentified-board} + +If you've determined which port belongs to your board: + +**Using the board selector:** + +1. Open the board selector. + +1. Select the "Unknown" board you want to use. + +1. In the pop-up "Select Other Board and Port" menu, select the board from the list. + +1. Click OK. + +**Using the _Tools > Board_ menu**: + +1. Open the Tools > Board menu. + +1. Choose the board you want to use. + +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). + +--- + +## Still need help? + +* Visit the [Installation & Troubleshooting category](https://forum.arduino.cc/c/18) in the Arduino forum. +* [Contact us](https://www.arduino.cc/en/contact-us/) + + From 4237c0ab13e6803e9a99039c4161bccb120a70a7 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Fri, 1 Nov 2024 14:45:41 +0100 Subject: [PATCH 05/12] Update If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md --- ...-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md index 192b016f..005a71d0 100644 --- a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md +++ b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md @@ -18,7 +18,7 @@ The Arduino IDE scans the ports on your computer for devices that might be compa * **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. -* **"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. +* **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. > [!NOTE] > In earlier versions of Arduino IDE 2, the _Tools > Port_ menu option would only be displayed if at least one device was detected on a port. This was fixed in version 2.0.4[^2.0.4]. From 0dda5720450abc1cf3d07083c9d1396d096f2e6b Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Mon, 4 Nov 2024 12:47:39 +0100 Subject: [PATCH 06/12] updates after review --- ...rent-board-than-the-one-youve-connected.md | 17 ------- ...ur-board-is-not-detected-by-Arduino-IDE.md | 50 ++++++++++++------- 2 files changed, 32 insertions(+), 35 deletions(-) diff --git a/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md b/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md index f8a927a8..7905252b 100644 --- a/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md +++ b/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md @@ -42,21 +42,4 @@ If the Reset symbol is not present, click "Select other board and port" at the b * 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). ---- - - - -## If Arduino UNO (Rev3 or earlier), Mega, or classic Nano is misidentified - -* If your **UNO (Rev3 or earlier)** or **Mega** board is recognized as any of the following, it may indicate that the USB-to-Serial firmware is missing or corrupted: - - * Unknown Device - * Composite Device - * ATmega16u2 DFU - * Atmega8U2 DFU - - To solve the issue, [flash the USB-to-serial firmware](https://support.arduino.cc/hc/en-us/articles/4408887452434-Flash-the-USB-to-serial-firmware-for-UNO-Rev3-and-earlier-and-Mega-boards). - -* If you're using a **classic Nano**, but it's being detected as "USB Serial Port" or another generic name, the FTDI drivers may be missing. To solve the issue, follow [install the FTDI drivers](https://support.arduino.cc/hc/en-us/articles/4411305694610-Install-or-update-FTDI-drivers). - diff --git a/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md index a715a2a0..daa18db8 100644 --- a/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md +++ b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md @@ -8,25 +8,23 @@ Learn what to do if your Arduino board is missing from the board selector or fro > [!NOTE] > If you're using Arduino Cloud Editor, see [If your board is not detected by Arduino Cloud Editor](https://support.arduino.cc/hc/en-us/articles/360018131160-If-your-board-is-not-detected-by-Arduino-Cloud-Editor). -## Troubleshooting +## Troubleshooting steps -### 1. Identify the problem +### 1. Disconnect and reconnect your board -* **Incorrect Board Identification**: If Arduino IDE incorrectly identifies your board with a generic name or as a different board type, see [If Arduino IDE detects a different board than the one you've connected](https://support.arduino.cc/hc/en-us/articles/12070802257436-If-Arduino-IDE-detects-a-different-board-than-the-one-you-ve-connected) instead. - -* **Unknown Devices**: If the board selector in Arduino IDE displays “Unknown” devices, refer to [If there are “Unknown” devices in the board selector and without a board name in the Tools > Port menu](add link) instead. - -* **Missing Board**: If your Arduino board is missing from the board selector or from the Tools > Port menu in Arduino IDE, proceed to the instructions below. + 1. Disconnect and reconnect your board to reset its power. + 1. Check for any system notifications that may prompt you to grant USB device permissions, and allow them if they appear. + 1. If the Tools > Port menu is open, close and reopen it to refresh the list of available devices. ### 2. Check board connection -A common reason for a board not being detected is an issue with the USB connection. Follow the steps below to ensure a proper setup: +A common reason for a board not being detected is an issue with the USB connection. Follow the instructions below to ensure a proper setup: * *Use a Data USB Cable*: Connect your board with a data USB cable, not a charging-only cable. -* *Test the USB Cable*: Check that the USB cable is not damaged. You can verify this by testing the cable with another device or by trying a different cable. -* *Connect directly*: connect the board directly into your computer instead of through a USB hub. -* *Try a Different USB Port*: If the board is still not detected, connect it to a different USB port on your computer. -* *Check power*: Verify that your device powers on—at least one LED should be lit. +* *Test the USB Cable*: Confirm the cable is working by testing it with another device or trying a different cable. +* *Connect directly*: Connect the board directly to your computer instead of through a USB hub. +* *Try a Different USB Port*: If the board is still not detected, try a different USB port on your computer. +* *Check power*: Verify that at least one LED on your board lights on. * *Disconnect jumper cables*: Remove any jumper cables connected to the board’s pins, as they may interfere with detection. ### 3. Try a bootloader reset if your board supports it @@ -35,17 +33,23 @@ If the board is still not detected, it might be stuck in a state where it cannot 1. Find the reset button on the board. -2. Press the button two times in succession. +2. Press the button two times in quick succession. ![The RESET button on Arduino Zero with an "x2" label graphic.](img/zero-reset-button-double.png) -3. An orange LED will fade in and out, indicating that the board is in bootloader mode, +3. An on-board LED will fade in and out, indicating that the board is in bootloader mode. 4. Check the board selector or _Tools > Port_ again to see if your board is now detected. -### 4. Check for additional system information +### 4. Check if your board appears as "Unknown" or as a board with a different name + +* **Unknown Devices**: If the board selector in Arduino IDE displays “Unknown” devices, refer to [If there are “Unknown” devices in the board selector and without a board name in the Tools > Port menu](addlink) instead. + +* **Incorrect Board Identification**: If Arduino IDE incorrectly identifies your board with a generic name or as a different board type, see [If Arduino IDE detects a different board than the one you've connected](https://support.arduino.cc/hc/en-us/articles/12070802257436-If-Arduino-IDE-detects-a-different-board-than-the-one-you-ve-connected) instead. -If Arduino IDE is not displaying a port for your board, you may still get some information by using a dedicated software utility: +### 5. Check for additional system information + +If Arduino IDE is not displaying a port for your board, you can use a dedicated software utility to confirm whether the board is recognized by your computer: @@ -84,8 +88,18 @@ If Arduino IDE is not displaying a port for your board, you may still get some i
-> [!TIP] -> You can use this information to determine if the board is being detected by the computer but not by the Arduino IDE. +Here are some cases to look out for: + +* **Classic Nano** : If you're using a **classic Nano**, but it's being detected as "USB Serial Port" or another generic name, the FTDI drivers may be missing. To solve the issue, follow [install the FTDI drivers](https://support.arduino.cc/hc/en-us/articles/4411305694610-Install-or-update-FTDI-drivers). + +* If you're using an **UNO (Rev3 or earlier)** or **Mega** board, missing or corrupted USB-to-Serial firmware may cause the board to be recognized as any of the following: + + * Unknown Device + * Composite Device + * ATmega16u2 DFU + * Atmega8U2 DFU + + To solve the issue, [flash the USB-to-serial firmware](https://support.arduino.cc/hc/en-us/articles/4408887452434-Flash-the-USB-to-serial-firmware-for-UNO-Rev3-and-earlier-and-Mega-boards). --- From 181dfbb8632f5c740ad5bb0469d06ea26b6f1267 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Mon, 4 Nov 2024 12:52:11 +0100 Subject: [PATCH 07/12] remove item from TOC --- ...IDE-detects-a-different-board-than-the-one-youve-connected.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md b/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md index 7905252b..ba597dde 100644 --- a/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md +++ b/content/Software Support/Upload/If-Arduino-IDE-detects-a-different-board-than-the-one-youve-connected.md @@ -9,7 +9,6 @@ In this article: * [Reset manual board selection](#manual-selection) * [If your UNO R4 WiFi or Nano ESP32 is identified as a generic ESP32 board](#generic-esp32) -* [If Arduino UNO (Rev3 or earlier), Mega, or classic Nano is misidentified](#misidentified-uno-mega-nano) --- From f163fa5eebb8a7aba15ae031ac2a9ed6a9c7c13f Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Mon, 4 Nov 2024 13:28:32 +0100 Subject: [PATCH 08/12] more updates --- ...-ports-without-a-board-name-in-the-Tools-Port-menu.md} | 8 ++++---- .../If-your-board-is-not-detected-by-Arduino-IDE.md | 6 +++--- 2 files changed, 7 insertions(+), 7 deletions(-) rename content/Software Support/Upload/{If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md => If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md} (92%) diff --git a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md similarity index 92% rename from content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md rename to content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md index 005a71d0..51ac053a 100644 --- a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md +++ b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md @@ -1,5 +1,5 @@ --- -title: "If there are "Unknown" devices in the board selector and ports without a board name in the Tools > Port menu" +title: "If there are \"Unknown\" devices in the board selector and ports without a board name in the Tools > Port menu" id: 4412955149586 --- @@ -48,7 +48,7 @@ The types of unidentified ports shown by Arduino IDE can be grouped in two categ ## Troubleshooting steps {#troubleshooting} -### Disconnect and reconnect your board to check its port {#disconnect-reconnect-procedure} +### 1. Disconnect and reconnect your board to check its port {#disconnect-reconnect-procedure} **Using the board selector:** @@ -68,7 +68,7 @@ The types of unidentified ports shown by Arduino IDE can be grouped in two categ 4. Open the _Tools > Port_ menu. The port your board is connected to should now appear as a new port in the list. -### Configure an unidentified board {#configuring-an-unidentified-board} +### 2. Configure an unidentified board {#configuring-an-unidentified-board} If you've determined which port belongs to your board: @@ -84,7 +84,7 @@ If you've determined which port belongs to your board: **Using the _Tools > Board_ menu**: -1. Open the Tools > Board menu. +1. Open the _Tools > Board_ menu. 1. Choose the board you want to use. diff --git a/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md index daa18db8..61dce6dc 100644 --- a/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md +++ b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md @@ -41,7 +41,7 @@ If the board is still not detected, it might be stuck in a state where it cannot 4. Check the board selector or _Tools > Port_ again to see if your board is now detected. -### 4. Check if your board appears as "Unknown" or as a board with a different name +### 4. Check for "Unknown" or incorrect board name * **Unknown Devices**: If the board selector in Arduino IDE displays “Unknown” devices, refer to [If there are “Unknown” devices in the board selector and without a board name in the Tools > Port menu](addlink) instead. @@ -90,9 +90,9 @@ If Arduino IDE is not displaying a port for your board, you can use a dedicated Here are some cases to look out for: -* **Classic Nano** : If you're using a **classic Nano**, but it's being detected as "USB Serial Port" or another generic name, the FTDI drivers may be missing. To solve the issue, follow [install the FTDI drivers](https://support.arduino.cc/hc/en-us/articles/4411305694610-Install-or-update-FTDI-drivers). +* If you're using a **classic Nano**, and it's recognized by your computer as "USB Serial Port" or another generic name, the FTDI drivers may be missing. To solve the issue, follow [install the FTDI drivers](https://support.arduino.cc/hc/en-us/articles/4411305694610-Install-or-update-FTDI-drivers). -* If you're using an **UNO (Rev3 or earlier)** or **Mega** board, missing or corrupted USB-to-Serial firmware may cause the board to be recognized as any of the following: +* If you're using an **UNO (Rev3 or earlier)** or **Mega** board, missing or corrupted USB-to-Serial firmware may cause your computer to recognize the board as one of the following: * Unknown Device * Composite Device From f2a8490469848fd53487440aef096a2d89d08dc0 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 <86349945+Renat0Ribeir0@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:02:37 +0100 Subject: [PATCH 09/12] Update content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md Co-authored-by: seaxwi <71350948+seaxwi@users.noreply.github.com> --- ...-and-ports-without-a-board-name-in-the-Tools-Port-menu.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md index 51ac053a..ee15348d 100644 --- a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md +++ b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md @@ -20,11 +20,6 @@ The Arduino IDE scans the ports on your computer for devices that might be compa * **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. -> [!NOTE] -> In earlier versions of Arduino IDE 2, the _Tools > Port_ menu option would only be displayed if at least one device was detected on a port. This was fixed in version 2.0.4[^2.0.4]. - -[^2.0.4]: - This example shows the board selector and _Tools > Port_ menu on Windows when an Arduino UNO board and one other unidentified device is connected: ![Identified and unidentified ports in the board selector (left) and Tools > Port menu (right).](img/ide-com.png) From 96f978c510da4b2a1e8769c57d31e5b6b99b0b16 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 <86349945+Renat0Ribeir0@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:03:14 +0100 Subject: [PATCH 10/12] Update content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md Co-authored-by: seaxwi <71350948+seaxwi@users.noreply.github.com> --- ...tor-and-ports-without-a-board-name-in-the-Tools-Port-menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md index ee15348d..3f3f30c5 100644 --- a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md +++ b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md @@ -53,7 +53,7 @@ The types of unidentified ports shown by Arduino IDE can be grouped in two categ 1. Connect your board to your computer. -**If you're using IDE 1, the board selector won't be available. Use the _Tools > Port_ menu instead:** +**Using the _Tools > Board_ menu**: 1. Disconnect your board from your computer. From bc6adee98b19f43607fae19f33096ad05015cc44 Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 <86349945+Renat0Ribeir0@users.noreply.github.com> Date: Mon, 11 Nov 2024 17:03:42 +0100 Subject: [PATCH 11/12] Update content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md Co-authored-by: seaxwi <71350948+seaxwi@users.noreply.github.com> --- ...tor-and-ports-without-a-board-name-in-the-Tools-Port-menu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md index 3f3f30c5..354620de 100644 --- a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md +++ b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md @@ -1,5 +1,5 @@ --- -title: "If there are \"Unknown\" devices in the board selector and ports without a board name in the Tools > Port menu" +title: "If there are \"Unknown\" devices in the board selector or ports without a board name in the Tools > Port menu" id: 4412955149586 --- From 1117c6edae6fd1018aa7ec36b323a55cb260875c Mon Sep 17 00:00:00 2001 From: Renat0Ribeir0 Date: Mon, 11 Nov 2024 17:10:58 +0100 Subject: [PATCH 12/12] rename to match title --- ...ector-or-ports-without-a-board-name-in-the-Tools-Port-menu.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename content/Software Support/Upload/{If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md => If-there-are-Unknown-devices-in-the-board-selector-or-ports-without-a-board-name-in-the-Tools-Port-menu.md} (100%) diff --git a/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md b/content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-or-ports-without-a-board-name-in-the-Tools-Port-menu.md similarity index 100% rename from content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md rename to content/Software Support/Upload/If-there-are-Unknown-devices-in-the-board-selector-or-ports-without-a-board-name-in-the-Tools-Port-menu.md