diff --git a/content/hardware/09.kits/maker/nesso-n1/tutorials/user-manual/content.md b/content/hardware/09.kits/maker/nesso-n1/tutorials/user-manual/content.md index 942a894cad..c2589c50d4 100644 --- a/content/hardware/09.kits/maker/nesso-n1/tutorials/user-manual/content.md +++ b/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