Skip to content

Commit 5744779

Browse files
authored
Merge pull request #138 from arduino/ide2-updates
Various IDE 2 updates
2 parents d6244b9 + 41e16d1 commit 5744779

10 files changed

+88
-73
lines changed

content/Software Support/Compilation/Compilation-error-Error-2-UNKNOWN-platform-not-installed.md

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

content/Software Support/Compilation/Compilation-error-Missing-FQBN-Fully-Qualified-Board-Name.md

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,40 +3,37 @@ title: "Compilation error: Missing FQBN (Fully Qualified Board Name)"
33
id: 4412950941074
44
---
55

6-
When compiling or uploading, the following error appears in the output panel.
6+
When compiling or uploading, the following error may occur:
77

88
```
99
Compilation error: Missing FQBN (Fully Qualified Board Name)
1010
```
1111

12-
When compiling or uploading code, this error will occur if no board is selected, or if the board core is not installed.
12+
The error occurs if no board has been selected.
1313

14-
Note that a board needs to be selected even if you're not uploading any code.
14+
Note that a board needs to be selected even if you're not uploading any code (i.e. clicking ![Verify button](img/symbol_verify2.png) Verify).
1515

16-
## Is a board selected?
16+
## Select board
1717

18-
Since the code cannot compile without a board selected, we'll start by ensuring just that.
18+
With IDE 2, you can use the board selector menu:
1919

20-
![The Arduino IDE. The board dropdown displays Arduino UNO, with a red cross.](img/Arduino-Uno_no-port.png)
20+
* Connected boards that were identified by Arduino IDE will appear in the list.
21+
* To manually select the board, or to select a board without connecting it, choose _Select other board and port_.
2122

22-
It should be looking somewhat like the above. The name of your board should be visible in the board dropdown bar. There may also be a red cross. This indicates that the board isn't available on any port but this will not prevent the code from compiling.
23+
![The board selector menu in Arduino IDE 2.](img/board-selector-labels.png)
2324

24-
If it reads `no board selected`, a board needs to be selected. Click to open the dropdown.
25+
Alternatively, use the _Tools > Board_ menu option:
2526

26-
![The board dropdown open, with no board selected.](img/select-other-board-and-port.png)
27+
![The 'Tools > Board' menu bar option.](img/tools-menu-board.png)
2728

28-
If you have a board plugged in, and you want to write code for that board, you can choose it in the dropdown. Otherwise, choose 'Select Other Board & Port'.
29+
See [Select board and port in Arduino IDE](https://support.arduino.cc/hc/en-us/articles/4406856349970-Select-board-and-port-in-Arduino-IDE) to learn more.
2930

30-
![The 'Select Board' window.](img/select-board.png)
31-
32-
Choose the intended board. You do not have to select a port. Click 'OK'.
31+
## Install missing boards
3332

3433
If you do not have the associated board core installed, you may receive the following pop-up.
3534

3635
![The board core installation pop-up.](img/board-core-install-pop-up.png)
3736

38-
In this case, choose 'Yes' to have the required core installed.
39-
40-
## Is the board core installed?
37+
In this case, choose **Yes** to install the required core.
4138

42-
In the above example, we used the pop-up to install the required core. If you didn't receive a pop-up, or if you're receiving the same error despite a board being selected, please ensure the *board core* is installed using [this guide](https://www.arduino.cc/en/Tutorial/getting-started-with-ide-v2/ide-v2-board-manager#installing-a-core).
39+
To learn more about board installation, see [Add boards to Arduino IDE](https://support.arduino.cc/hc/en-us/articles/360016119519-Add-boards-to-Arduino-IDE).
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: "Compilation error: Platform not found: platform not installed"
3+
id: 360020846379
4+
---
5+
6+
When compiling or uploading, the following error may appear in the output panel.
7+
8+
```
9+
Compilation error: Platform <platform name> not found: platform not installed
10+
```
11+
12+
This error appears when the selected board is not installed.
13+
14+
Follow these steps:
15+
16+
1. Check that you've selected the correct board. See [Select board and port in Arduino IDE](https://support.arduino.cc/hc/en-us/articles/4406856349970-Select-board-and-port-in-Arduino-IDE).
17+
2. If the required board is not installed, install it. See [Add boards to Arduino IDE](https://support.arduino.cc/hc/en-us/articles/360016119519-Add-boards-to-Arduino-IDE).
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
title: "Compilation error: exit status 1"
3+
---
4+
5+
A `Compilation error: exit status 1` error indicates that the sketch compilation process has failed, and is not related to the upload process. For more information, look at previous lines in the error output.
6+
7+
For example, check this error output:
8+
9+
```
10+
.../core_arduino_samd_mkrwifi1010_dc4ffca0ef28855003b5cc223e78a605.a(main.cpp.o): In function `main':
11+
.../Arduino15/packages/arduino/hardware/samd/1.8.13/cores/arduino/main.cpp:53: undefined reference to `loop'
12+
collect2: error: ld returned 1 exit status
13+
14+
exit status 1
15+
16+
Compilation error: exit status 1
17+
```
18+
19+
The most useful information is ``undefined reference to `loop'``, which occurs because the sketch is missing a correctly defined `loop()` function.
20+
21+
## Further reading
22+
23+
* [If your sketch doesn't compile](https://support.arduino.cc/hc/en-us/articles/4402764401554-If-your-sketch-doesn-t-compile)

content/Software Support/Compilation/Error-2-UNKNOWN-no-FQBN-provided.md

Lines changed: 0 additions & 42 deletions
This file was deleted.
133 KB
Loading
1.81 KB
Loading
50.8 KB
Loading

content/Software Support/Upload/Error-exit-status-1.md renamed to content/Software Support/Upload/About-error-messages-with-exit-status.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
---
2-
title: "Error: exit status 1"
2+
title: 'About error messages with "exit status"'
33
id: 360016955139
44
---
55

6-
**Exit status 1** is used in some error messages to indicate that a process has finished (or "exited") in failure. Other parts of the error message will often contain more specific information.
6+
Error messages that occur when Arduino IDE is compiling or uploading a sketch can include an exit status.
7+
8+
**Exit status 1** indicates that a process has finished (or "exited") in failure. Other parts of the error message will often contain more specific information.
79

810
Your error output may end with one of these lines:
911

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: "Failed uploading: uploading error: exit status 1"
3+
---
4+
5+
`Failed uploading: uploading error: exit status 1` is a generic error message indicating that the upload has failed.
6+
7+
## Check the console output
8+
9+
Often preceding lines will contain more specific information. For example:
10+
11+
```
12+
No device found on cu.Bluetooth-Incoming-Port
13+
Failed uploading: uploading error: exit status 1
14+
```
15+
16+
In this case the `cu.Bluetooth-Incoming-Port` port was selected by mistake. Since no board is connected to the port, the upload failed. This is indicated by the `No device found on cu.Bluetooth-Incoming-Port` message. The issue can be solved by selecting the right port in the _Tools > Port_ menu.
17+
18+
## If you're not sure what's causing the error
19+
20+
Follow these steps:
21+
22+
1. **Check your connections**. Your board needs to be connected with a data USB cable (charge-only cables will not work). Make sure the cable is fully inserted in the port on each end. Try a different USB cable, and avoid hubs and other adapters if possible. Remove connections to the board pins, especially the **0 (RX)** and **1 (TX)** digital pins.
23+
24+
2. **Check your board and port selections**. In the top menu bar, make sure the correct board is selected in _Tools > Board_, and that you've selected the right port in _Tools > Port_. Try disconnecting and reconnecting your board if you're unsure which port is being used (close and reopen the Port menu to refresh the list). For more information, see [Select the right port and board](https://support.arduino.cc/hc/en-us/articles/4406856349970-Select-board-and-port).
25+
26+
3. **Make sure other applications aren't using the port**. Close other instances of the IDE, serial monitors, and any other applications that may be using the port. See [Find and stop process blocking a port](https://support.arduino.cc/hc/en-us/articles/4407830972050-Find-and-stop-process-blocking-a-port).
27+
28+
## Further reading
29+
30+
* [Errors when uploading a sketch](https://support.arduino.cc/hc/en-us/articles/4403365313810-Errors-when-uploading-a-sketch)

0 commit comments

Comments
 (0)