Some initial troubleshooting resources for Arduino App Lab (#533)

* Create If-your-Arduino-UNO-Q-board-software-is-out-of-date.md

* Create If-your-Arduino-UNO-Q-is-not-detected-by-Arduino-App-Lab.md

Author: seaxwi

content/Software Support/Arduino App Lab/If-your-Arduino-UNO-Q-board-software-is-out-of-date.md

@@ -0,0 +1,70 @@
+---
+title: If your Arduino UNO Q board software is out of date
+---
+
+The first Arduino UNO Q boards were shipped with an older software that can't be fully updated by Arduino App Lab. When connecting to a board with outdated software, Arduino App Lab will not be able to fully update it, which can cause certain issues. On Windows, Arduino App Lab may fail to connect to a board with outdated software.
+
+Learn how to tell if your board has outdated software and how to resolve the issue.
+
+In this article:
+
+<!-- TOC -->
+
+- [Recognize outdated software](#recognize-outdated-software)
+- [“Error checking for updates” when updating on Windows](#error-checking-for-updates-when-updating-on-windows)
+- [Other symptoms of an outdated software on any OS](#other-symptoms-of-an-outdated-software-on-any-os)
+- [Flash a new Linux image](#flash-a-new-linux-image)
+
+<!-- /TOC -->
+
+---
+
+## Recognize outdated software
+
+When connecting to a UNO Q in App Lab, or when running App Lab on the UNO Q Single-Board Computer mode, App Lab will display a message warning that your "board software is out of date", and that you should update your board software using the Arduino Flasher Tool.
+
+![Software updates warning in Arduino App Lab: "Your board software is out of date. You may experience missing features or functional issues"](img/app-lab-board-software-is-out-of-date.png)
+
+---
+
+## “Error checking for updates” when updating on Windows
+
+Arduino App Lab on Windows may fail to update to a board with the outdated image. In this case, you will see an **“Error checking for updates”** message.
+
+To successfully update the board, you can:
+
+- [Flash a new Linux image using the Arduino Flasher CLI](https://docs.arduino.cc/tutorials/uno-q/update-image/){.link-external} (recommended)
+- Run Arduino App Lab directly on the UNO Q in [Single-Board Computer (SBC) mode](https://docs.arduino.cc/tutorials/uno-q/single-board-computer/) first. When ran in SBC mode, App Lab will be able to update the board. This won’t fix all issues caused by the old image, but it will allow App Lab on your PC to connect successfully.
+
+---
+
+## Other symptoms of an outdated software (on any OS)
+
+Even if you are able to connect to a UNO Q running an outdated image, you may encounter one or more of the following issues:
+
+- **Missing App Lab icon**  
+  The App Lab icon may not appear on the desktop or dock, preventing you from easily launching the application.
+
+- **Hostname resolution issues when renaming the board**  
+  Changing the board name might cause hostname resolution failures. This is due to a missing package (`libnss-myhostname`) in the older image.
+
+- **Unexpected desktop or application restarts**  
+  You may notice random restarts of the desktop environment or applications. This is typically caused by memory pressure. The updated image enables the **ZRAM** kernel module, which compresses RAM to make better use of the available 1.7 GB of memory.
+
+- **ADB connection defaults to root**  
+  On older images, the ADB (Android Debug Bridge) connection automatically runs as `root`. The latest image includes a custom-built ADB configuration that resolves this issue.
+
+- **No audio over HDMI**  
+  HDMI audio output is not functional on early Linux images and is restored in newer releases.
+
+For the best experience, please [flash the latest Linux image](https://docs.arduino.cc/tutorials/uno-q/update-image/) before using a new Arduino UNO Q.
+
+---
+
+## Flash a new Linux image
+
+To fully resolve the above issues, please flash the board with the latest Linux image.
+
+Follow the step-by-step guide in Arduino Docs:
+
+[Flashing a New Image to the UNO Q](https://docs.arduino.cc/tutorials/uno-q/update-image/){.link-chevron-right}

content/Software Support/Arduino App Lab/If-your-Arduino-UNO-Q-is-not-detected-by-Arduino-App-Lab.md

@@ -0,0 +1,66 @@
+---
+title: "If your Arduino UNO Q is not detected by Arduino App Lab"
+---
+
+When Arduino App Lab starts, it will look for Arduino UNO Q boards connected on a USB port, [TODO]
+
+In this article:
+
+- [If your board is not detected via USB](#if-your-board-is-not-detected-via-usb)
+- [If your board is not detected via Wi-Fi](#if-your-board-is-not-detected-via-wi-fi)
+- [If your board is still not detected](#if-your-board-is-not-detected-via-wi-fi)
+
+---
+
+## If your board is not detected via USB
+
+Try again after each step:
+
+1. [Disconnect and reconnect your board](#disconnect-and-reconnect-your-board)
+2. [Check board connections](#check-board-connections)
+
+### 1. Disconnect and reconnect your board {#disconnect-and-reconnect-your-board}
+
+  1. Disconnect and reconnect your board to reset its power.
+  1. Verify that at least one LED on your board lights on.<!-- TODO -->
+  1. Wait for the Arduino UNO Q to fully boot up. AT first, the LED matrix will display a swirling animation the shape of the Arduino logo. Once the board has finished booting, the LED matrix will instead  display a heartbeat animation.
+  1. Check for any system notifications that may prompt you to grant USB device permissions, and allow them if they appear.
+
+### 2. Check board connections {#check-board-connections}
+
+A common reason for a board not being detected is an issue with the USB connection. Follow the instructions below to ensure a proper setup:
+
+- *Use a Data USB Cable*: Connect your board with a data USB cable, not a charging-only cable.
+- *Test the USB Cable*: Confirm the cable is working by testing it with another device or trying a different cable.
+- *Connect directly*: Connect the board directly to your computer instead of through a USB hub.
+- *Try a Different USB Port*: If the board is still not detected, try a different USB port on your computer.
+- *Disconnect jumper cables*: Remove any jumper cables connected to the board’s pins, as they may interfere with detection.
+
+Some USB accessories are not compatible with Arduino UNO Q:
+
+- Arduino UNO Q is not compatible with Apple USB-C hubs.
+- Arduino UNO Q may not be detected when connected to USB-A ports on some USB hubs.
+
+---
+
+## If your board is not detected via Wi-Fi
+
+Try again after each step:
+
+1. [Restart your board](#restart-your-board)
+2. [Check your Wi-Fi configuration](#check-your-wi-fi-configuration)
+
+> [!IMPORTANT]
+> To detect a UNO Q via Wi-Fi, you first need to connect to it via USB and configure the network connection.
+
+### 1. Restart your board {#restart-your-board}
+
+1. Disconnect and reconnect UNO Q from it's power supply.
+1. Verify that at least one LED on your board lights on.
+1. Wait for the Arduino UNO Q to fully boot up. AT first, the LED matrix will display a swirling animation the shape of the Arduino logo. Once the board has finished booting, the LED matrix will instead  display a heartbeat animation.
+
+### 2. Check your Wi-Fi configuration {#check-your-wi-fi-configuration}
+
+1. Ensure that your Wi-Fi router or access point is turned on and accessible.
+1. Ensure that your computer and your UNO Q board are connected to the same Wi-Fi network.
+1. Verify that your UNO Q board has the correct Wi-Fi name and password in [Single-Board Computer mode](https://docs.arduino.cc/tutorials/uno-q/single-board-computer/).