Merge cd51712 into 29b4d7d

Author: 91volt

content/hardware/09.kits/maker/nesso-n1/tutorials/user-manual/content.md

@@ -20,7 +20,6 @@ software:
   - ide-v1
   - ide-v2
   - iot-cloud
-  - web-editor
 ---
 
 The **Arduino® Nesso N1** is an all-in-one enclosed development board. Based on the ESP32-C6 System on Chip (SoC), it integrates a suite of communication protocols, including 2.4 GHz Wi-Fi® 6, Bluetooth® 5.3 LE, 802.15.4 (Thread/Zigbee®), and long-range LoRa®. It also includes a 1.14" color touchscreen, buttons, and a built-in LiPo battery for immediate user interaction in portable applications.
@@ -38,8 +37,8 @@ This document serves as a comprehensive user manual for the Nesso N1, providing
 
 ### Software Requirements
 
-- [Arduino IDE](https://www.arduino.cc/en/software) or [Arduino Cloud Editor](https://app.arduino.cc/sketches)
-- [ESP32 Boards core by Espressif](https://github.com/espressif/arduino-esp32)
+- [Arduino IDE](https://www.arduino.cc/en/software) (v2.0 or higher recommended)
+- [ESP32 Boards core by Espressif](https://github.com/espressif/arduino-esp32) (v3.3.3 or higher)
 
 ## Product Overview
 
@@ -72,25 +71,53 @@ The full datasheet is available as a downloadable PDF from the link below:
 
 ## Installation
 
-The Nesso N1 can be programmed using the Arduino IDE or the Arduino Cloud Editor. To get started, you will need to install the appropriate board package.
+The Nesso N1 is programmed using the desktop Arduino IDE. To get started, you will need to install the appropriate board package.
 
 ### Arduino IDE
 
-To use the board in the Arduino IDE, you need to install the latest version of the **esp32 by Espressif Systems** package from the boards manager.
+To use the board in the Arduino IDE, you must install the latest version of the **esp32 by Espressif Systems** package. Support for the Nesso N1 requires version **3.3.3** or newer.
 
 1.  Open the Arduino IDE.
 2.  Navigate to **Boards Manager** (**Tools > Board > Boards Manager...**).
 3.  Search for **"esp32"** and find the package by **Espressif Systems**.
-4.  Click the **Install** button.
+4.  Click the **Install** (or Update) button.
 5.  Once installed, select **Arduino Nesso N1** from the **Tools > Board > esp32** menu.
 
 ![Installing the esp32 Boards core in the Arduino IDE](assets/board-manager.png)
 
 ### Arduino Cloud Editor
 
-The Arduino Cloud Editor is an online IDE that supports the Nesso N1 without requiring manual installation of the board package.
+Direct support for the Nesso N1 in the **Arduino Cloud Editor** (the online web IDE) is coming soon. Currently, the Cloud Editor does not support the specific ESP32 core version required for this board.
 
-Read more in the [Getting Started with the Cloud Editor](https://docs.arduino.cc/arduino-cloud/guides/editor/) guide.
+Please use the **Arduino IDE** (desktop version) to compile and upload code to the Nesso N1.
+
+## Arduino IoT Cloud
+
+Although the Nesso N1 cannot yet be programmed directly via the Cloud Editor, you can still use it with **Arduino IoT Cloud** dashboards and variables by configuring it as a "Manual Device" and uploading the sketch from your desktop IDE.
+
+### 1. Create a Manual Device
+1.  Go to the [Arduino IoT Cloud Devices page](https://app.arduino.cc/devices).
+2.  Click **+ CREATE**.
+3.  Select **Any Device** (do not search for Nesso N1).
+4.  Click **Continue**.
+5.  Name your device (e.g., "MyNessoN1") and click **Next**.
+6.  **Important:** Save the **Device ID** and **Secret Key**. You will need these later in your code.
+7.  Check the box confirming you have saved your credentials and click **Continue**.
+
+### 2. Create a Thing
+1.  Go to the [Things page](https://app.arduino.cc/things).
+2.  Create a new Thing and associate it with the "Manual Device" you just created.
+3.  Add your desired Cloud Variables (e.g., an LED switch or sensor value).
+
+### 3. Program the Board via Desktop IDE
+1.  Open the **Arduino IDE** on your computer.
+2.  Install the **ArduinoIoTCloud** library via the Library Manager.
+3.  Copy the sketch generated by the Cloud "Thing" (from the "Sketch" tab in the web interface) into the Arduino IDE.
+4.  Open the `thingProperties.h` tab in your local sketch.
+5.  Manually enter your Wi-Fi credentials and the **Device ID** and **Secret Key** you saved in step 1.
+6.  Select **Arduino Nesso N1** as your board and upload the sketch.
+
+The board will now connect to the Arduino IoT Cloud, allowing you to control it via dashboards despite not using the Cloud Editor.
 
 ## First Use