Merge branch 'main' into content/micropython/micropython-revamp

Author: karlsoderby

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/debugger/assets/blink_example.png

@@ -0,0 +1,72 @@
+---
+title: 'Debugging the Arduino UNO R4 WiFi'
+description: 'Learn how to debug the UNO R4 WiFi with the Arduino IDE.'
+tags:
+  - Debugger
+  - IDE
+author: 'Hannes Siebeneicher'
+---
+
+Debugging is the process of identifying and fixing errors in your code. It’s a vital skill for anyone writing code especially when dealing with microcontrollers like those on your Arduino.
+
+In this article, we will focus on using the Arduino IDE's built-in debugger, which can be used to debug the UNO R4 WiFi over USB. We will go through how to:
+- Enable debugging mode in the Arduino IDE
+- Create breakpoints for where we want to inspect the code
+- Monitor the value of a variable at a specific point in the program 
+
+Note that you **do not** need an external debugger to follow this tutorial.
+
+***To learn more about general debugging principles, you can read up on the topic [here](/learn/microcontrollers/debugging).***
+
+## Goals
+
+The goals of this tutorial are:
+
+- learn about the basics of debugging.
+- learn how to set up the Arduino IDE to debug an Arduino sketch.
+
+## Hardware & Software Needed
+
+- [Arduino IDE](https://www.arduino.cc/en/main/software)
+- [Arduino UNO R4 WiFi](https://store.arduino.cc/uno-r4-wifi)
+- [UNO R4 Board Package](/tutorials/uno-r4-minima/minima-getting-started)
+
+## Debugging
+
+Debugging your Arduino project allows you to dive deep into your code and troubleshoot as well as analyze the code execution. You can gain full access to the microcontroller's internal registers, memory, and variables. This is especially helpful when working on more complex projects where understanding the code execution flow is crucial. With the Arduino IDE you can step through the code line by line, allowing you to analyze why your code might break at a specific point.
+
+## Connection
+
+The only thing you need to do is to connect your UNO R4 WiFi to your computer using a USB-Cable.
+
+## Software 
+
+### Setting up the Arduino IDE
+
+First, if you haven't done it yet, install the [Arduino IDE](https://www.arduino.cc/en/software). It's a good idea to verify that everything is working as it should by uploading the Blink example.
+
+![Blink Example](./assets/blink_example.png)
+
+## Set Correct Programmer
+
+To access and debug the Arduino's MCU it's important that we set the correct programmer. Select **Tools** > **Programmer** > **ARM CMSIS-DAP compatible**.
+
+![Set Programmer](./assets/set_programmer.png)
+
+## Setting Breakpoints
+
+A breakpoint is an intentional stopping or pausing place at a specific point in the code. You can add them by clicking the sidebar next to your sketch, and you should see a red dot appear. You have now set a breakpoint.
+
+![Setting a breakpoint](./assets/set_breakpoints.png)
+
+## Start Debugging
+
+Now you are ready to start debugging. Press "**Start Debugging**" next to the "Upload button" or click the icon in the left sidebar.
+
+![Start Debugging](./assets/start_debugger.png)
+
+You will see how your code is executed and **stopped** at the line you set the breakpoint. You can set as many breakpoints as you want, depending on where you want to stop your code.
+
+To resume the code press the "**Continue**" in the top left corner and you will see how the code runs until the it reaches the next breakpoint.
+
+![Resume Code](./assets/resume_code.png)

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/debugger/assets/resume_code.png

@@ -26,7 +26,7 @@ The goals of this tutorials are:
 
 ## EEPROM
 
-Electronically erasable programmable read-only memory (EEPROM) is a memory that can be used to store data that can be retrieved after power loss. This memory can be effective to use during run-time to log data can be used to re-initialize whenever a system comes back online.
+Electronically erasable programmable read-only memory (EEPROM) is a memory that can be used to store data that can be retrieved after power loss - it is non-volatile. EEPROM memory can be useful during run-time to log data, or can be used to re-initialize variables whenever a system comes back online.
 
 When writing to the EEPROM memory, we specify two parameters: the **address** and **value**. Each byte can hold a value between 0-255.
 
@@ -90,4 +90,4 @@ void loop() {
 
 ## Summary
 
-In this tutorial, you've learned how to access the EEPROM on the UNO R4 WiFi board. To learn more about EEPROM, visit [A Guide to EEPROM](https://docs.arduino.cc/learn/programming/eeprom-guide).
+In this tutorial, you've learned how to access the EEPROM on the UNO R4 WiFi board. To learn more about EEPROM, visit [A Guide to EEPROM](https://docs.arduino.cc/learn/programming/eeprom-guide).

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/debugger/assets/set_breakpoints.png

@@ -277,7 +277,7 @@ void setup() {
   
   msd.connect();
 
-  while (!msd.connected()) {
+  while (!msd.connect()) {
     //while (!port.connected()) {
     delay(1000);
   }
@@ -358,7 +358,7 @@ void setup() {
 
   msd.connect();
 
-  while (!msd.connected()) {
+  while (!msd.connect()) {
     Serial.print("MSD not found.");
     delay(1000);
   }

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/debugger/assets/set_programmer.png

@@ -43,6 +43,7 @@ To use the library, we simply need to create a display object, initialize the li
 GigaDisplay_GFX display; // create the object
 
 void setup() {
+  delay(3000);
   display.begin(); //init library
   
   display.setCursor(10,10); //x,y
@@ -97,6 +98,7 @@ GigaDisplay_GFX display; // create the object
 #define BLACK 0x0000
 
 void setup() {
+  delay(3000);
   display.begin();
   display.fillScreen(BLACK);
   display.setCursor(10,10); //x,y
@@ -131,6 +133,7 @@ GigaDisplay_GFX display;
 #define BLACK 0x0000
 
 void setup() {
+  delay(3000);
   display.begin();
   display.fillScreen(WHITE);
   display.drawTriangle(100, 200, 300, 400, 300, 600, BLACK);
@@ -173,6 +176,7 @@ int counter;
 void setup() {
   // put your setup code here, to run once:
   Serial.begin(9600);
+  delay(3000);
   display.begin();
 
   if (touchDetector.begin()) {

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/debugger/assets/start_debugger.png

@@ -64,6 +64,7 @@ In the `setup()`, we begin by initializing the display and the touch detector.
 
 ```arduino
 void setup(){
+  delay(3000);
   Display.begin();
   TouchDetector.begin();
 }
@@ -154,6 +155,7 @@ Arduino_H7_Video Display(800, 480, GigaDisplayShield);
 Arduino_GigaDisplayTouch TouchDetector;
 
 void setup() {
+  delay(3000);
   Display.begin();
   TouchDetector.begin();
 
@@ -236,6 +238,7 @@ To make sure we see the image use the align function to make it centered. Then a
 Arduino_H7_Video          Display(800, 480, GigaDisplayShield);
 
 void setup() {
+  delay(3000);
   Display.begin();
 
   lv_obj_t * screen = lv_obj_create(lv_scr_act());
@@ -335,6 +338,7 @@ Arduino_H7_Video          Display(800, 480, GigaDisplayShield);
 Arduino_GigaDisplayTouch  TouchDetector;
 
 void setup() {
+  delay(3000);
   Display.begin();
   TouchDetector.begin();
 
@@ -410,6 +414,7 @@ Arduino_H7_Video          Display(800, 480, GigaDisplayShield);
 Arduino_GigaDisplayTouch  TouchDetector;
 
 void setup() {
+  delay(3000);
   Display.begin();
   TouchDetector.begin();
 
@@ -506,6 +511,7 @@ Arduino_H7_Video          Display(800, 480, GigaDisplayShield); /* Arduino_H7_Vi
 Arduino_GigaDisplayTouch  TouchDetector;
 
 void setup() {
+  delay(3000);
   Display.begin();
   TouchDetector.begin();
 
@@ -634,6 +640,7 @@ static void set_slider_val(void * bar, int32_t val) {
 }
 
 void setup() {
+  delay(3000);
   Display.begin();
   TouchDetector.begin();
 
@@ -752,6 +759,7 @@ static void btn_event_cb(lv_event_t * e) {
 }
 
 void setup() {
+  delay(3000);
   Display.begin();
   TouchDetector.begin();
 

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/debugger/debugger.md

@@ -42,6 +42,7 @@ Let's first draw the background of the image. Start by initializing the display
 
 ```arduino
 void setup() {
+  delay(3000);
   Display.begin();
   
   Display.beginDraw();
@@ -97,6 +98,7 @@ Arduino_H7_Video Display(800, 480, GigaDisplayShield);
 //Arduino_H7_Video Display(1024, 768, USBCVideo);
 
 void setup() {
+  delay(3000);
   Display.begin();
   
   Display.beginDraw();
@@ -193,6 +195,7 @@ Arduino_H7_Video Display(800, 480, GigaDisplayShield);
 Image img_arduinologo(ENCODING_RGB16, (uint8_t *) texture_raw, 300, 300);
 
 void setup() {
+  delay(3000);
   Display.begin();
 
   Display.beginDraw();

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/debugger/hero-banner.png

@@ -85,6 +85,7 @@ int lastTouch;
 int threshold = 250; //time in milliseconds
 
 void setup() {
+  delay(3000);
   Serial.begin(115200);
   while(!Serial) {}
 
@@ -147,6 +148,7 @@ int threshold = 250;
 bool switch_1;
 
 void setup() {
+  delay(3000);
   // put your setup code here, to run once:
   Serial.begin(9600);
   display.begin();

content/hardware/02.hero/boards/uno-r4-wifi/tutorials/eeprom/eeprom.md

@@ -33,13 +33,14 @@ BoschSensorClass imu(Wire1);
 
 Start receiving IMU readings with `imu.begin();` and start the display with `Display.begin();`.
 
-Then we can assign attributes to the images such as its source, alignment and how the rotation should behave. For more information on image attributes with LVGL, check out our [LVGL tutorial](lvgl-guide#image).
+Then we can assign attributes to the images such as its source, alignment and how the rotation should behave. For more information on image attributes with LVGL, check out our [LVGL tutorial](/tutorials/giga-display-shield/lvgl-guide).
 
 ```arduino
 LV_IMG_DECLARE(img_arduinologo);
 lv_obj_t * img;
 
 void setup() {
+  delay(3000);
   Serial.begin(115200);
   
   Display.begin();
@@ -91,6 +92,7 @@ The easiest way to tell what values you are getting depending on the orientation
 BoschSensorClass imu(Wire1);
 
 void setup(){
+  delay(3000);
   Serial.begin(115200);
   imu.begin();
 }
@@ -131,6 +133,7 @@ LV_IMG_DECLARE(img_arduinologo);
 lv_obj_t * img;
 
 void setup() {
+  delay(3000);
   Serial.begin(115200);
   
   Display.begin();
@@ -176,4 +179,4 @@ Now try rotating your device to see if the image behaves correctly. If the image
 
 ## Conclusion
 
-Now you know how to use the GIGA Display Shield's IMU sensor to gather readings for device orientation, and how to use these readings to make an image on the GIGA Display Shield maintain the correct orientation depending on what way it is facing. 
+Now you know how to use the GIGA Display Shield's IMU sensor to gather readings for device orientation, and how to use these readings to make an image on the GIGA Display Shield maintain the correct orientation depending on what way it is facing. 

content/hardware/10.mega/boards/giga-r1-wifi/tutorials/giga-usb/giga-usb.md

@@ -209,6 +209,7 @@ short sampleBuffer[512];
 volatile int samplesRead;
 
 void setup() {
+  delay(3000);
   Display.begin();
   Display.beginDraw();
   Display.background(255, 255, 255);
@@ -316,6 +317,7 @@ lv_anim_t a;
 int micValue;
 
 void setup() {
+  delay(3000);
   Display.begin();
 
   PDM.onReceive(onPDMdata);

content/hardware/10.mega/shields/giga-display-shield/tutorials/02.gfx-guide/gfx-guide.md

@@ -113,6 +113,7 @@ void blinkLED(uint32_t count = 0xFFFFFFFF)
 uint32_t palette[256];
 
 void setup() {
+  delay(3000);
   // Init the cam QVGA, 30FPS
   if (!cam.begin(CAMERA_R320x240, IMAGE_MODE, 30)) {
     blinkLED();

content/hardware/10.mega/shields/giga-display-shield/tutorials/03.lvgl-guide/content.md

@@ -62,6 +62,7 @@ Arduino_H7_Video          Display(800, 480, GigaDisplayShield);
 Arduino_GigaDisplayTouch  Touch;
 
 void setup() {
+  delay(3000);
   Display.begin();
   Touch.begin();
 
@@ -119,6 +120,7 @@ Then it is as simple as using the names of the widgets in a LVGL function. For e
 
 ```arduino
 void setup() {
+    delay(3000);
     Display.begin();
     Touch.begin();
 
@@ -182,6 +184,7 @@ static void ButtonDec_evt_handler(lv_event_t * e) {
 }
 
 void setup() {
+    delay(3000);
     Display.begin();
     Touch.begin();
 

content/hardware/10.mega/shields/giga-display-shield/tutorials/04.basic-draw-and-image/content.md

@@ -52,6 +52,7 @@ When creating elements, information about the screen and placement needs to be p
 
 ```arduino
 void setup() {
+  delay(3000);
   /* Init SEGGER emWin library. It also init display and touch controller */
   GUI_Init();
 
@@ -73,6 +74,7 @@ Here is an example that sets the screen background color to green and prints the
 #include <DIALOG.h>
 
 void setup() {
+  delay(3000);
   GUI_Init();
   GUI_MULTIBUF_Begin();
   GUI_SetBkColor(GUI_GREEN);
@@ -261,6 +263,7 @@ static void _cbWin(WM_MESSAGE * pMsg) {
 }
 
 void setup() {
+  delay(3000);
   GUI_Init();
   WM_MULTIBUF_Enable(1);
   WM_CreateWindowAsChild(0, 0, LCD_GetXSize(), LCD_GetYSize(), WM_HBKWIN, WM_CF_SHOW, _cbWin, 0);
@@ -358,6 +361,7 @@ static void _cbChildWinCheck(WM_MESSAGE * pMsg) {
 }
 
 void setup() {
+  delay(3000);
   /* Init SEGGER emWin library. It also init display and touch controller */
   GUI_Init();
 
@@ -469,6 +473,7 @@ static void _cbChildWinSlider(WM_MESSAGE * pMsg) {
 }
 
 void setup() {
+  delay(3000);
   /* Init SEGGER emWin library. It also init display and touch controller */
   GUI_Init();
 
@@ -608,6 +613,7 @@ int progbarCnt = 0;
 unsigned long previousMillis = 0;
 
 void setup() {
+  delay(3000);
   /* Init SEGGER emWin library. It also init display and touch controller */
   GUI_Init();
 
@@ -732,6 +738,7 @@ static void _cbChildWinBtn(WM_MESSAGE * pMsg) {
 }
 
 void setup() {
+  delay(3000);
   /* Init SEGGER emWin library. It also init display and touch controller */
   GUI_Init();