diff --git a/content/Software Support/Compilation/Compilation-error-Error-2-UNKNOWN-platform-not-installed.md b/content/Software Support/Compilation/Compilation-error-Error-2-UNKNOWN-platform-not-installed.md deleted file mode 100644 index 4e43c1b3..00000000 --- a/content/Software Support/Compilation/Compilation-error-Error-2-UNKNOWN-platform-not-installed.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: "Compilation error: Error: 2 UNKNOWN: platform not installed" -id: 360020846379 ---- - -When compiling or uploading, the following error appears in the output panel. - -``` -Compilation error: Error: 2 UNKNOWN: platform not installed -``` - -This error appears when the required *board core* is not installed. Please ensure the core is installed using [this guide](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-board-manager). diff --git a/content/Software Support/Compilation/Compilation-error-Missing-FQBN-Fully-Qualified-Board-Name.md b/content/Software Support/Compilation/Compilation-error-Missing-FQBN-Fully-Qualified-Board-Name.md index b0e03b7c..5a33b1fd 100644 --- a/content/Software Support/Compilation/Compilation-error-Missing-FQBN-Fully-Qualified-Board-Name.md +++ b/content/Software Support/Compilation/Compilation-error-Missing-FQBN-Fully-Qualified-Board-Name.md @@ -3,40 +3,37 @@ title: "Compilation error: Missing FQBN (Fully Qualified Board Name)" id: 4412950941074 --- -When compiling or uploading, the following error appears in the output panel. +When compiling or uploading, the following error may occur: ``` Compilation error: Missing FQBN (Fully Qualified Board Name) ``` -When compiling or uploading code, this error will occur if no board is selected, or if the board core is not installed. +The error occurs if no board has been selected. -Note that a board needs to be selected even if you're not uploading any code. +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). -## Is a board selected? +## Select board -Since the code cannot compile without a board selected, we'll start by ensuring just that. +With IDE 2, you can use the board selector menu: -![The Arduino IDE. The board dropdown displays Arduino UNO, with a red cross.](img/Arduino-Uno_no-port.png) +* Connected boards that were identified by Arduino IDE will appear in the list. +* To manually select the board, or to select a board without connecting it, choose _Select other board and port_. -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. +![The board selector menu in Arduino IDE 2.](img/board-selector-labels.png) -If it reads `no board selected`, a board needs to be selected. Click to open the dropdown. +Alternatively, use the _Tools > Board_ menu option: -![The board dropdown open, with no board selected.](img/select-other-board-and-port.png) +![The 'Tools > Board' menu bar option.](img/tools-menu-board.png) -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'. +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. -![The 'Select Board' window.](img/select-board.png) - -Choose the intended board. You do not have to select a port. Click 'OK'. +## Install missing boards If you do not have the associated board core installed, you may receive the following pop-up. ![The board core installation pop-up.](img/board-core-install-pop-up.png) -In this case, choose 'Yes' to have the required core installed. - -## Is the board core installed? +In this case, choose **Yes** to install the required core. -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). +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). diff --git a/content/Software Support/Compilation/Compilation-error-Platform-not-found-platform-not-installed.md b/content/Software Support/Compilation/Compilation-error-Platform-not-found-platform-not-installed.md new file mode 100644 index 00000000..aa631e96 --- /dev/null +++ b/content/Software Support/Compilation/Compilation-error-Platform-not-found-platform-not-installed.md @@ -0,0 +1,17 @@ +--- +title: "Compilation error: Platform not found: platform not installed" +id: 360020846379 +--- + +When compiling or uploading, the following error may appear in the output panel. + +``` +Compilation error: Platform not found: platform not installed +``` + +This error appears when the selected board is not installed. + +Follow these steps: + +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). +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). diff --git a/content/Software Support/Compilation/Compilation-error-exit-status-1.md b/content/Software Support/Compilation/Compilation-error-exit-status-1.md new file mode 100644 index 00000000..8a6c3231 --- /dev/null +++ b/content/Software Support/Compilation/Compilation-error-exit-status-1.md @@ -0,0 +1,23 @@ +--- +title: "Compilation error: exit status 1" +--- + +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. + +For example, check this error output: + +``` +.../core_arduino_samd_mkrwifi1010_dc4ffca0ef28855003b5cc223e78a605.a(main.cpp.o): In function `main': +.../Arduino15/packages/arduino/hardware/samd/1.8.13/cores/arduino/main.cpp:53: undefined reference to `loop' +collect2: error: ld returned 1 exit status + +exit status 1 + +Compilation error: exit status 1 +``` + +The most useful information is ``undefined reference to `loop'``, which occurs because the sketch is missing a correctly defined `loop()` function. + +## Further reading + +* [If your sketch doesn't compile](https://support.arduino.cc/hc/en-us/articles/4402764401554-If-your-sketch-doesn-t-compile) diff --git a/content/Software Support/Compilation/Error-2-UNKNOWN-no-FQBN-provided.md b/content/Software Support/Compilation/Error-2-UNKNOWN-no-FQBN-provided.md deleted file mode 100644 index 214055ed..00000000 --- a/content/Software Support/Compilation/Error-2-UNKNOWN-no-FQBN-provided.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: "Error: 2 UNKNOWN: no FQBN provided" -id: 360020843439 ---- - -When compiling or uploading, the following error appears in the output panel. - -``` -Compilation error: Error: 2 UNKNOWN: no FQBN provided -``` - -FQBN stands for 'Fully Qualified Board Name'. When compiling or uploading code, this error will occur if no board is selected, or if the board core is not installed. - -Note that a board needs to be selected even if you're not uploading any code. - -## Is a board selected? - -Since the code cannot compile without a board selected, we'll start by ensuring just that. - -![The Arduino IDE. The board dropdown displays Arduino Uno, with a red cross.](img/Arduino-Uno_no-port.png) - -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. - -If it reads `no board selected`, a board needs to be selected. Click to open the dropdown. - -![The board dropdown open, with no board selected.](img/select-other-board-and-port.png) - -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'. - -![The 'Select Board' window.](img/select-board.png) - -Choose the intended board. You do not have to select a port. Click 'OK'. - -If you do not have the associated board core installed, you may receive the following pop-up. - -![The board core installation pop-up.](img/board-core-install-pop-up.png) - -In this case, choose 'Yes' to have the required core installed. - -## Is the board core installed? - -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). diff --git a/content/Software Support/Compilation/img/board-selector-labels.png b/content/Software Support/Compilation/img/board-selector-labels.png new file mode 100644 index 00000000..93656921 Binary files /dev/null and b/content/Software Support/Compilation/img/board-selector-labels.png differ diff --git a/content/Software Support/Compilation/img/symbol_verify2.png b/content/Software Support/Compilation/img/symbol_verify2.png new file mode 100644 index 00000000..6a7dc629 Binary files /dev/null and b/content/Software Support/Compilation/img/symbol_verify2.png differ diff --git a/content/Software Support/Compilation/img/tools-menu-board.png b/content/Software Support/Compilation/img/tools-menu-board.png new file mode 100644 index 00000000..bebab3e7 Binary files /dev/null and b/content/Software Support/Compilation/img/tools-menu-board.png differ diff --git a/content/Software Support/Upload/Error-exit-status-1.md b/content/Software Support/Upload/About-error-messages-with-exit-status.md similarity index 75% rename from content/Software Support/Upload/Error-exit-status-1.md rename to content/Software Support/Upload/About-error-messages-with-exit-status.md index 1c45dfe4..6395cdd2 100644 --- a/content/Software Support/Upload/Error-exit-status-1.md +++ b/content/Software Support/Upload/About-error-messages-with-exit-status.md @@ -1,9 +1,11 @@ --- -title: "Error: exit status 1" +title: 'About error messages with "exit status"' id: 360016955139 --- -**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. +Error messages that occur when Arduino IDE is compiling or uploading a sketch can include an exit status. + +**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. Your error output may end with one of these lines: diff --git a/content/Software Support/Upload/Failed-uploading-uploading-error-exit-status-1.md b/content/Software Support/Upload/Failed-uploading-uploading-error-exit-status-1.md new file mode 100644 index 00000000..c5e3bf22 --- /dev/null +++ b/content/Software Support/Upload/Failed-uploading-uploading-error-exit-status-1.md @@ -0,0 +1,30 @@ +--- +title: "Failed uploading: uploading error: exit status 1" +--- + +`Failed uploading: uploading error: exit status 1` is a generic error message indicating that the upload has failed. + +## Check the console output + +Often preceding lines will contain more specific information. For example: + +``` +No device found on cu.Bluetooth-Incoming-Port +Failed uploading: uploading error: exit status 1 +``` + +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. + +## If you're not sure what's causing the error + +Follow these steps: + +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. + +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). + +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). + +## Further reading + +* [Errors when uploading a sketch](https://support.arduino.cc/hc/en-us/articles/4403365313810-Errors-when-uploading-a-sketch)