Fix iot section content

Author: 91volt

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

@@ -93,31 +93,119 @@ Please use the **Arduino IDE** (desktop version) to compile and upload code to t
 
 ## 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.
+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. This is done by configuring it as a "Manual Device" and uploading the sketch from your desktop IDE.
+
+Follow these steps to connect your Nesso N1 to the Cloud.
 
 ### 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).
+3.  Select **Any Device** (do not search for Nesso N1, as it is not yet listed).
 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.
+6.  **Important:** A screen will appear with your **Device ID** and **Secret Key**. Save these credentials in a secure place immediately; you will not be able to view the Secret Key again.
 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).
+2.  Click **+ THING** to create a new Thing.
+3.  Click **Select Device** and associate it with the "Manual Device" you just created.
+4.  Click **Add Variable** to create a test variable:
+    *   **Name**: `led`
+    *   **Type**: Boolean
+    *   **Permission**: Read & Write
+    *   **Update Policy**: On Change
+5.  Click **Add Variable** to confirm.
+
+### 3. Create a Dashboard
+
+1.  Go to the [Dashboards page](https://app.arduino.cc/dashboards).
+2.  Click **+ DASHBOARD**.
+3.  Click **ADD** and select the **Things** tab.
+4.  Select your Thing and create a widget for the `led` variable (a Switch widget is recommended).
+
+### 4. Program the Board via Desktop IDE
+
+Because "Manual Devices" do not automatically generate a downloadable sketch, you must create one manually.
 
-### 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.
+2.  Install the **ArduinoIoTCloud** library via the Library Manager (**Tools > Manage Libraries...**).
+3.  Create a new sketch (**File > New**).
+4.  To keep your credentials secure, create a new tab named `arduino_secrets.h` (click the 3-dot icon near the tab bar > **New Tab**).
+5.  Paste the following code into `arduino_secrets.h` and fill in your details:
+
+    ```cpp
+    #define SECRET_SSID "YOUR_WIFI_SSID"
+    #define SECRET_OPTIONAL_PASS "YOUR_WIFI_PASSWORD"
+    #define SECRET_DEVICE_LOGIN_NAME "YOUR_DEVICE_ID" // From Step 1
+    #define SECRET_DEVICE_KEY "YOUR_SECRET_KEY"       // From Step 1
+    ```
+
+6.  Create another new tab named `thingProperties.h` and paste the following configuration code:
+
+    ```cpp
+    #include <ArduinoIoTCloud.h>
+    #include <Arduino_ConnectionHandler.h>
+    #include "arduino_secrets.h"
+
+    const char SSID[]     = SECRET_SSID;
+    const char PASS[]     = SECRET_OPTIONAL_PASS;
+    const char DEVICE_LOGIN_NAME[]  = SECRET_DEVICE_LOGIN_NAME;
+    const char DEVICE_KEY[]  = SECRET_DEVICE_KEY;
 
-The board will now connect to the Arduino IoT Cloud, allowing you to control it via dashboards despite not using the Cloud Editor.
+    void onLedChange();
+
+    bool led;
+
+    void initProperties(){
+      ArduinoCloud.setBoardId(DEVICE_LOGIN_NAME);
+      ArduinoCloud.setSecretDeviceKey(DEVICE_KEY);
+      ArduinoCloud.addProperty(led, READWRITE, ON_CHANGE, onLedChange);
+    }
+
+    WiFiConnectionHandler ArduinoIoTPreferredConnection(SSID, PASS);
+    ```
+
+7.  Finally, paste the main application code into your `.ino` file:
+
+    ```cpp
+    #include "thingProperties.h"
+
+    void setup() {
+      Serial.begin(115200);
+      delay(1500); // Wait for Serial Monitor
+
+      // Initialize the Nesso N1 built-in LED
+      pinMode(LED_BUILTIN, OUTPUT);
+      
+      // Initialize Cloud properties and connection
+      initProperties();
+      ArduinoCloud.begin(ArduinoIoTPreferredConnection);
+      
+      // Set debug level to see connection status in Serial Monitor
+      setDebugMessageLevel(2);
+      ArduinoCloud.printDebugInfo();
+    }
+
+    void loop() {
+      ArduinoCloud.update();
+    }
+
+    // This function is called whenever the 'led' variable changes in the Cloud
+    void onLedChange() {
+      // The Nesso N1 LED uses inverted logic (LOW is ON)
+      if (led) {
+        digitalWrite(LED_BUILTIN, LOW);
+      } else {
+        digitalWrite(LED_BUILTIN, HIGH);
+      }
+    }
+    ```
+
+8.  Select **Arduino Nesso N1** as your board and upload the sketch.
+9.  Open the **Serial Monitor** to verify the connection. Once connected, you can toggle the switch on your Cloud Dashboard to control the LED on the board.
 
 ## First Use
 
@@ -1444,6 +1532,4 @@ Join our community forum to connect with other Nesso N1 users, share your experi
 
 Please get in touch with our support team if you need personalized assistance or have questions not covered by the help and support resources described before. We are happy to help you with any issues or inquiries about the Nesso N1.
 
-- [Contact us page](https://www.arduino.cc/en/contact-us/)
-
-
+- [Contact us page](https://www.arduino.cc/en/contact-us/)