-
-
Notifications
You must be signed in to change notification settings - Fork 12
Improvements to board detection Arduino IDE articles [HC-1518] #443
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Renat0Ribeir0
merged 12 commits into
main
from
update-if-your-board-does-not-appear-in-a-port
Nov 11, 2024
Merged
Changes from 5 commits
Commits
Show all changes
12 commits
Select commit
Hold shift + click to select a range
8954b65
Update If-Arduino-IDE-detects-a-different-board-than-the-one-youve-co…
Renat0Ribeir0 a59f24a
update "If your board does not appear on a port in Arduino IDE"
Renat0Ribeir0 ab533a6
Update If-your-board-is-not-detected-by-Arduino-IDE.md
Renat0Ribeir0 60e4f9d
Create If-there-are-Unknown-devices-in-the-board-selector-and-ports-w…
Renat0Ribeir0 4237c0a
Update If-there-are-Unknown-devices-in-the-board-selector-and-ports-w…
Renat0Ribeir0 0dda572
updates after review
Renat0Ribeir0 181dfbb
remove item from TOC
Renat0Ribeir0 f163fa5
more updates
Renat0Ribeir0 f2a8490
Update content/Software Support/Upload/If-there-are-Unknown-devices-i…
Renat0Ribeir0 96f978c
Update content/Software Support/Upload/If-there-are-Unknown-devices-i…
Renat0Ribeir0 bc6adee
Update content/Software Support/Upload/If-there-are-Unknown-devices-i…
Renat0Ribeir0 1117c6e
rename to match title
Renat0Ribeir0 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
100 changes: 100 additions & 0 deletions
100
...-the-board-selector-and-ports-without-a-board-name-in-the-Tools-Port-menu.md.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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]: <https://github.com/arduino/arduino-ide/releases/tag/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: | ||
|
||
 | ||
|
||
### 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/) | ||
|
||
<!-- markdownlint-disable-file HC001 --> |
202 changes: 0 additions & 202 deletions
202
...ftware Support/Upload/If-your-board-does-not-appear-on-a-port-in-Arduino-IDE.md
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.