Skip to content

Update IDE nomenclature #1013

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
merged 2 commits into from
Apr 25, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -410,7 +410,7 @@ arduino-cloud-cli ota mass-upload --fqbn <deviceFQBN> --device-tags <key0>=<valu
When uploading a sketch using OTA, you will need to compile the binary file (`.bin`) first. This is **not** a feature in the `arduino-cloud-cli`, so you will need to use the following options:

- [Arduino CLI](https://arduino.github.io/arduino-cli/)
- [Arduino IDE 1.8.x or 2.0](https://www.arduino.cc/en/software)
- [Arduino IDE](https://www.arduino.cc/en/software)

#### Compile with Arduino CLI

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ If you want to get started with the Arduino Cloud IoT, you can check out [gettin

## Sharing your dashboards

>**Note:** Before we start, let's make sure that we have a **Thing** and **Dashboard** already set up. If you haven't got that set up, head over to the [Setting up the Arduino IoT Cloud in detail]() tutorial.
>**Note:** Before we start, let's make sure that we have a **Thing** and **Dashboard** already set up. If you haven't got that set up, check out the [Getting Started with Arduino IoT Cloud](/arduino-cloud/getting-started/iot-cloud-getting-started) tutorial.

The Arduino IoT Cloud's dashboard feature is a really good tool for sending, receiving and storing data through the cloud. You can now also share your dashboards with other people, so that they can access your devices as well, without having access to your account!

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ In this tutorial, we will look into the applications of using Node-RED together
## Hardware & Software Requirements

- [Arduino Create Agent](https://github.com/arduino/arduino-create-agent)
- [Node.js](https://nodejs.org/en/) and [Node-RED installed]()
- [Node.js](https://nodejs.org/en/) and [Node-RED installed](https://nodered.org/)
- An [Arduino account](http://create.arduino.cc/iot).

For this tutorial, you will need a cloud compatible board. You will find all compatible boards in the link below:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ Now, we need to add the rest of the variables in a very similar fashion, but cha
| **uvb**\* | float |
| **uvIndex**\* | float |

>**Note:** the `uva`, `uvb` and `uvIndex` variables will only work with the MKR ENV Shield v1. Newer versions does not have the UV sensor. If you have a newer version, do not add these variables. You can read more about the different versions in the this [Arduino Help Center article]().
>**Note:** the `uva`, `uvb` and `uvIndex` variables will only work with the MKR ENV Shield v1. Newer versions does not have the UV sensor. If you have a newer version, do not add these variables. You can read more about the different versions in the this [Arduino Help Center article](https://support.arduino.cc/hc/en-us/articles/360019197540-Different-MKR-ENV-Shield-versions).

When we have added these, the variable list will look something like this:

Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: 'Debugging SAM-Based Arduino® Boards with Atmel-ICE'
description: 'Learn how to debug SAM-based Arduino boards using the Atmel-ICE debugger and the Arduino IDE 2.0'
description: 'Learn how to debug SAM-based Arduino boards using the Atmel-ICE debugger and the Arduino IDE 2'
tags:
- IDE 2.0
- IDE 2
- Debugging
- Debugger
- Atmel-ICE
Expand All @@ -11,20 +11,20 @@ author: 'José Bagur'

## Introduction

In this tutorial, we will learn how to use the [Atmel-ICE](https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE) development tool with the new [Arduino IDE 2.0](https://www.arduino.cc/en/software) for debugging SAM-based Arduino® boards. Using an [Arduino MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010) board and a simple program, we will learn about the debugging functionalities that are integrated with the debugger tool of the new IDE 2.0.
In this tutorial, we will learn how to use the [Atmel-ICE](https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE) development tool with the new [Arduino IDE 2](https://www.arduino.cc/en/software) for debugging SAM-based Arduino® boards. Using an [Arduino MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010) board and a simple program, we will learn about the debugging functionalities that are integrated with the debugger tool of the new IDE 2.

## Goals

The goals with this tutorial are:

- Learn how to use an [Atmel-ICE](https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE) development tool with the new [Arduino IDE 2.0](https://www.arduino.cc/en/software) and a SAM-based Arduino® board.
- Learn about the debugging functionalities of the new [Arduino IDE 2.0](https://www.arduino.cc/en/software).
- Learn how to use an [Atmel-ICE](https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE) development tool with the new [Arduino IDE 2](https://www.arduino.cc/en/software) and a SAM-based Arduino® board.
- Learn about the debugging functionalities of the new [Arduino IDE 2](https://www.arduino.cc/en/software).

## Hardware and Software Needed

The hardware and software used in this tutorial:

- [Arduino IDE 2.0](https://www.arduino.cc/en/software).
- [Arduino IDE 2](https://www.arduino.cc/en/software).
- [Arduino MKR WiFi 1010](https://store.arduino.cc/arduino-mkr-wifi-1010) board.
- [Atmel-ICE](https://www.microchip.com/DevelopmentTools/ProductDetails/ATATMEL-ICE) development tool.
- 10-pin mini-squid cable (included with the Atmel-ICE development tool)
Expand Down Expand Up @@ -95,19 +95,19 @@ We used the SAM port in this tutorial; this means we used the pins **4**, **2**,

> Note: be careful and **double-check the connections between the Atmel-ICE and the MKR WiFi 1010 board SWD interfaces to avoid damaging one or both devices**.

If the SWD interfaces of the debugger and the board are connected properly, a **green LED should turn on in the debugger**. Now that we have both devices, the Atmel-ICE and the MKR WiFi 1010 board, SWD interfaces connected, its time to use the **debugger tool** of the Arduino IDE 2.0.
If the SWD interfaces of the debugger and the board are connected properly, a **green LED should turn on in the debugger**. Now that we have both devices, the Atmel-ICE and the MKR WiFi 1010 board, SWD interfaces connected, its time to use the **debugger tool** of the Arduino IDE 2.

## Using the Debugger Tool

Now that we have our hardware set up, we can learn how to use the IDE 2.0 Debugger Tool main functionalities through the [**Debugging with the Arduino IDE 2.0 tutorial**](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-debugger). This tutorial goes through some key features of the Debugger Tool, and includes pointers to get started.
Now that we have our hardware set up, we can learn how to use the IDE 2 Debugger Tool main functionalities through the [**Debugging with the Arduino IDE 2 tutorial**](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-debugger). This tutorial goes through some key features of the Debugger Tool, and includes pointers to get started.

As explained in the [**Debugging with the Arduino IDE 2.0 tutorial**](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-debugger), before we can use the Debugger Tool of the Arduino IDE 2.0, we need to upload a sketch to our MKR WiFi 1010 board, making sure it is optimized for debugging. Let's try a simple program that blinks the onboard LED of our MKR WiFi 1010 board and changes the value of several variables while running.
As explained in the [**Debugging with the Arduino IDE 2 tutorial**](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-debugger), before we can use the Debugger Tool of the Arduino IDE 2, we need to upload a sketch to our MKR WiFi 1010 board, making sure it is optimized for debugging. Let's try a simple program that blinks the onboard LED of our MKR WiFi 1010 board and changes the value of several variables while running.

### 1. Setting Up

Let's start by opening the Arduino IDE 2.0 and connecting our MKR WiFi 1010 board to our computer with a micro USB cable. The IDE should recognize automatically the board, if so, the board and port should appear as shown in the image below:
Let's start by opening the Arduino IDE 2 and connecting our MKR WiFi 1010 board to our computer with a micro USB cable. The IDE should recognize automatically the board, if so, the board and port should appear as shown in the image below:

![The board and port recognized by the Arduino IDE 2.0.](assets/ide_v2_t1_img05.png)
![The board and port recognized by the Arduino IDE 2.](assets/ide_v2_t1_img05.png)

### 2. Creating the Test Code

Expand All @@ -120,7 +120,7 @@ Let's try the example code show below, it is a simple program that blinks the on
This example blinks the onboard LED of an Arduino board and changes
the value of the variables x and y wwhile running. The purpose of
this example is to test the debugging functionalities of the Arduino
IDE 2.0.
IDE 2.

The circuit:
- Arduino MKR WiFi 1010
Expand Down Expand Up @@ -153,15 +153,15 @@ void loop() {

Before uploading the code to our board, we must optimize it for debugging. This can be made easily by clicking on the **Sketch** tab and then selecting the option **Optimize for Debbuging**:

![The "Optimize for Debugging" option in the Arduino IDE 2.0](assets/ide_v2_t1_img06.png)
![The "Optimize for Debugging" option in the Arduino IDE 2](assets/ide_v2_t1_img06.png)

With the **Optimize for Debugging** option selected, now its time to upload the code to our board and start debugging it.

### 3. Using the Debugger Tool with the Test Code

We can easily access to the Debugger Tool menu from the left sidebar of the Arduino IDE 2.0 where we can find also the **Board Manager**, **Library Manager**, **Search** and **Sketchbook Explorer**.
We can easily access to the Debugger Tool menu from the left sidebar of the Arduino IDE 2 where we can find also the **Board Manager**, **Library Manager**, **Search** and **Sketchbook Explorer**.

![The debugger tool menu option in the left sidebar of the Arduino IDE 2.0](assets/ide_v2_t1_img07.png)
![The debugger tool menu option in the left sidebar of the Arduino IDE 2](assets/ide_v2_t1_img07.png)

Now, we can see the Debugger Tool menu expanded. Let's start using the debugger tool by selecting the **Start Debugging** button that is located near the **Upload** button:

Expand All @@ -187,7 +187,7 @@ As expected, we can see that the value of x increases in one unit while the valu

## Conclusion

In this tutorial, we have learned how to use the Atmel-ICE development tool with the new Arduino IDE 2.0 for debugging SAM-based Arduino® boards. We learn how to connect the SWD interface of the Atmel-ICE development tool with the SWD interface of a MKR WiFi 1010 board. With a simple program, we learned also about the debugging functionalities of the debugger tool of the new Arduino IDE 2.0.
In this tutorial, we have learned how to use the Atmel-ICE development tool with the new Arduino IDE 2 for debugging SAM-based Arduino® boards. We learn how to connect the SWD interface of the Atmel-ICE development tool with the SWD interface of a MKR WiFi 1010 board. With a simple program, we learned also about the debugging functionalities of the debugger tool of the new Arduino IDE 2.

### Troubleshoot

Expand All @@ -197,6 +197,6 @@ Sometimes errors occur, there are some common issues we can troubleshoot:
- Arduino board connected to the wrong port.
- Accidental interruption of cable connection of the board or the debugger.
- SWD interfaces of the debugger hardware tool and the board are not connected properly.
- The debugging session in the IDE 2.0 didn't initialize correctly.
- The debugging session in the IDE 2 didn't initialize correctly.

We hope you enjoy the Debugger, and if you are having issues, please report them in [Arduino IDE GitHub repository](https://github.com/arduino/arduino-ide/issues).
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@ description: This tutorial teaches you how to set up a MKR board with the Segger
---

## Overview
This tutorial will show you how to debug an Arduino sketch using an Arduino MKR board and the Segger J-Link probe. It will go through how to connect these and use the Arduino IDE 2.0 to then debug a sketch.
This tutorial will show you how to debug an Arduino sketch using an Arduino MKR board and the Segger J-Link probe. It will go through how to connect these and use the Arduino IDE 2 to then debug a sketch.

### Required Hardware and Software
- [Arduino IDE 2.0](https://www.arduino.cc/en/software)
- [Arduino IDE 2](https://www.arduino.cc/en/software)
- Segger J-link device ([EDU](https://store.arduino.cc/products/j-link-edu) or [BASE](https://store.arduino.cc/products/j-link-base-compact))
- [Arduino MKR WiFi 1010](https://store.arduino.cc/mkr-wifi-1010) (other boards from the MKR family works as well).
- Soldering equipment
Expand Down Expand Up @@ -55,15 +55,15 @@ When the connections have been made, simply power the J-link probe and the MKR v

### Installing the J-Link GDB Server Software

If you haven't already, download and install the [Arduino IDE 2.0](https://www.arduino.cc/en/software), this will be used to debug our sketch. You will also need to download the J-Link GDB Server software, [here](https://www.segger.com/products/debug-probes/j-link/tools/j-link-gdb-server/about-j-link-gdb-server/). The J-Link GDB Server is a remote server for the GNU Debugger (GDB) which allows to use a J-Link probe with GDB or any toolchain which uses GDB as debugging interface, like the Arduino IDE 2.0.
If you haven't already, download and install the [Arduino IDE 2](https://www.arduino.cc/en/software), this will be used to debug our sketch. You will also need to download the J-Link GDB Server software, [here](https://www.segger.com/products/debug-probes/j-link/tools/j-link-gdb-server/about-j-link-gdb-server/). The J-Link GDB Server is a remote server for the GNU Debugger (GDB) which allows to use a J-Link probe with GDB or any toolchain which uses GDB as debugging interface, like the Arduino IDE 2.

> Note: write down where you installed the J-Link GDB Server software in your computer, this install path will be useful in the next step.

### Debugging in Arduino IDE 2.0
### Debugging in Arduino IDE 2

Now we are ready to start debugging our sketch. Connect the power to the MKR board and the J-link to power them up. Start Arduino IDE 2.0 and select your MKR board in the deployable menu where you specify the board and port.
Now we are ready to start debugging our sketch. Connect the power to the MKR board and the J-link to power them up. Start Arduino IDE 2 and select your MKR board in the deployable menu where you specify the board and port.

![Selecting board and port in Arduino IDE 2.0](assets/mkr_jlink_IDE_board_select.png)
![Selecting board and port in Arduino IDE 2](assets/mkr_jlink_IDE_board_select.png)

Then create or open the sketch that you want to debug. If you don't already have a sketch in mind, feel free to use the example sketch found at the end of this tutorial.

Expand All @@ -85,17 +85,17 @@ The `"serverpath"` field needs to be set to the path of the "J-Link GDB Server C

When you have finished creating the `debug_custom.json` file, click on the debugging icon.

![Start debug feature in Arduino IDE 2.0](assets/mkr_jlink_IDE_debugging_button.png)
![Start debug feature in Arduino IDE 2](assets/mkr_jlink_IDE_debugging_button.png)

You should see a window similar to the one shown below. Do not close this window, just minimize it and you are now ready to start debugging. You can add breakpoints, inspect variables, halt the execution and more.

![J-link debug window in Arduino IDE 2.0](assets/mkr_jlink_IDE_debugging_window.png)
![J-link debug window in Arduino IDE 2](assets/mkr_jlink_IDE_debugging_window.png)

## Conclusion

In this tutorial you learned how to connect your MKR board to a Segger J-Link probe. And then how to use this setup to debug a sketch with Arduino IDE 2.0.
In this tutorial you learned how to connect your MKR board to a Segger J-Link probe. And then how to use this setup to debug a sketch with Arduino IDE 2.

Now that you have your hardware set up, you can learn how to use the IDE 2.0 Debugger through the Debugging with the [Arduino IDE 2.0 tutorial](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-debugger). This tutorial goes through some key features of the Debugger, and includes pointers to get started.
Now that you have your hardware set up, you can learn how to use the IDE 2 Debugger through the Debugging with the [Arduino IDE 2 tutorial](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-debugger). This tutorial goes through some key features of the Debugger, and includes pointers to get started.

### Example Sketch

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,11 +45,11 @@ The UNO Mini LE can be programmed through the **Classic Arduino IDE 1.8.X**. To

- [Installing classic AVR boards.](/software/ide-v1/tutorials/getting-started/cores/arduino-avr)

### Arduino IDE 2.0.X
### Arduino IDE 2

The UNO Mini LE can be programmed through the **Arduino IDE 2.0.X**. To install your board, you can check out the guide below:
The UNO Mini LE can be programmed through the **Arduino IDE 2**. To install your board, you can check out the guide below:

- [How to use the board manager with the Arduino IDE 2.0](/software/ide-v2/tutorials/ide-v2-board-manager)
- [How to use the board manager with the Arduino IDE 2](/software/ide-v2/tutorials/ide-v2-board-manager)

### Web Editor

Expand Down
2 changes: 1 addition & 1 deletion content/hardware/02.hero/boards/zero/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ bootloader programming.

<Feature title="Embedded Debugger" image="mcu">

The Zero comes with a built-in debugger, which can be used with the Arduino IDE 2.0 version.
The Zero comes with a built-in debugger, which can be used with the Arduino IDE 2 version.

<FeatureLink variant="primary" title="Documentation" url="/tutorials/zero/debugging-with-zero"/>
</Feature>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: 'Setting up the Arduino Zero Built-in Debugger Interface'
author: 'Karl Söderby'
compatible-products: [zero]
description: 'Learn how to set up the Arduino Zero built-in debugger interface, which can be used directly with the IDE 2.0, without any extra hardware.'
description: 'Learn how to set up the Arduino Zero built-in debugger interface, which can be used directly with the IDE 2, without any extra hardware.'
tags:
- Debugging
- Configuration
Expand All @@ -12,7 +12,7 @@ For this this tutorial we will be using the Arduino Zero's built-in debugger int

## Requirements

- Arduino IDE 2.0 installed.
- Arduino IDE 2 installed.
- [Arduino Zero](https://store.arduino.cc/arduino-zero)
- Micro USB cable.

Expand All @@ -30,9 +30,9 @@ For this this tutorial we will be using the Arduino Zero's built-in debugger int

![Enable "Optimize for Debugging" option.](assets/optimize-debugger.png)

**4.** Your Arduino Zero is now ready to be debugged using the Arduino IDE 2.0.
**4.** Your Arduino Zero is now ready to be debugged using the Arduino IDE 2.

To learn more about using the Debugger, you can continue on to the [main article on Debugging with IDE 2.0](/software/ide-v2/tutorials/ide-v2-debugger). This article goes more in-depth on how to use the different Debugger features, and provides a good overview of the tool.
To learn more about using the Debugger, you can continue on to the [main article on Debugging with IDE 2](/software/ide-v2/tutorials/ide-v2-debugger). This article goes more in-depth on how to use the different Debugger features, and provides a good overview of the tool.

## Conclusion

Expand Down
Loading