Skip to content

Conversation

@91volt
Copy link
Contributor

@91volt 91volt commented Nov 21, 2025

Summary

This PR updates the Nesso N1 user manual to clarify that currently the board can be programmed with the desktop Arduino IDE, is compatible with Arduino IoT Cloud as a Manual Device, and is not yet supported by the Arduino Cloud Editor.

What changed

  • Software requirements

    • Removed Arduino Cloud Editor as a supported environment.
    • Clarified that Arduino IDE is required, version 2.0 or higher recommended.
    • Specified that the ESP32 boards core by Espressif must be version 3.3.3 or newer.
  • Installation section

    • Updated wording to state that Nesso N1 is programmed through the desktop Arduino IDE.
    • Clarified that support for Nesso N1 requires ESP32 core version 3.3.3 or newer.
    • Adjusted Boards Manager steps to mention Install or Update and selecting Arduino Nesso N1 from the esp32 menu.
  • Cloud Editor section

    • Replaced the previous description with a clear note that Nesso N1 is not yet supported in the Arduino Cloud Editor.
    • Instructed users to use the desktop Arduino IDE to compile and upload sketches.
  • Arduino IoT Cloud section

    • Added a guide for using Nesso N1 with Arduino IoT Cloud as a Manual Device.
    • Described the flow to create a Manual Device, set up a Thing and Cloud variables, copy the generated sketch into the Arduino IDE, configure credentials in thingProperties.h, and upload using the Arduino Nesso N1 board.

@91volt 91volt requested review from per1234 and ubidefeo November 21, 2025 17:17
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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
4. Click the **Install** (or Update) button.
4. Click the **Install** (or **Update**) button.

Consistent formatting.

### 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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sketches are not generated for Things associated with "manual devices".

The user can use the ArduinoIoTCloud library's "ArduinoIoTCloud-Basic" example sketch as a starting point for implementing their own Thing sketch. That example is accessible by selecting File > Examples > ArduinoIoTCloud > ArduinoIoTCloud-Basic from the Arduino IDE menus.

Unfortunately that example is not very approachable to less technical users because the developers of the library added a bunch of preprocessor conditionals to make it support every possible type of Device.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another thing that should be notes about the "ArduinoIoTCloud-Basic" example sketch is that it won't compile for the Nesso N1 as written. It can still serve as a starting point for a sketch, but it will be necessary to make This is the reason why I created my own demo sketch when providing support for Nesso N1 users wanting to use Arduino Cloud:

https://forum.arduino.cc/t/nesso-n1-not-showing-on-arduino-cloud-editor-despite-the-manual-saying-so/1414912/8#p-8320889-d-create-thing-sketch-4

I also think that the "ArduinoIoTCloud-Basic" example sketch program is excessively complex for something named "basic". My desire is always to start with the absolute minimum "hello world", but Arduino tends to add additional complexity to the introductory examples and tutorials. The sketch I provide at the link above is the type of simple example I always hope to find in documentation.

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is true that the credentials can be configured via the thingProperties.h tab. However, the established convention is to do this via arduino_secrets.h (example). If the user is starting from a sketch that has arduino_secrets.h, I think it would be confusing for them to instead configure credentials via thingProperties.h.

The exception is that the convention is to define the Device ID via thingProperties.h (since this information is not a secret).

@91volt 91volt added the preview label Nov 21, 2025
@github-actions
Copy link

Preview Deployment

🚀 Preview this PR: https://6920cc0c95ac7d98a0422cbc--docs-content.netlify.app
📍 Commit SHA: 46d4469

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants