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..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 @@ -39,6 +39,6 @@ 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). diff --git a/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 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 new file mode 100644 index 00000000..354620de --- /dev/null +++ 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 @@ -0,0 +1,95 @@ +--- +title: "If there are \"Unknown\" devices in the board selector or 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. + +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} + +### 1. 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. + +**Using the _Tools > Board_ menu**: + +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. + +### 2. 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/) + + 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..61dce6dc --- /dev/null +++ b/content/Software Support/Upload/If-your-board-is-not-detected-by-Arduino-IDE.md @@ -0,0 +1,109 @@ +--- +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 steps + +### 1. Disconnect and reconnect your board + + 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 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*: 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 + +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 quick succession. + + ![The RESET button on Arduino Zero with an "x2" label graphic.](img/zero-reset-button-double.png) + +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 "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. + +* **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. + +### 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: + + + + + + + + + + + + + + + +
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: + +* 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 your computer to recognize the board as one 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). + +--- + +## 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/)