ArduinoIoTCloud

Communication

This library allows connecting to the Arduino IoT Cloud service.
It provides a ConnectionManager to handle connection/disconnection, property-change updates and events callbacks. The supported boards are MKR GSM, MKR1000 and WiFi101.

Compatibility

This library is compatible with the mbed, samd, esp8266, mbed_nano, mbed_portenta, mbed_nicla, esp32, mbed_opta, mbed_giga, renesas_portenta, renesas_uno, mbed_edge, stm32 architectures so you should be able to use it on the following Arduino boards:

Compatibility Note

Note: while the library is supposed to compile correctly on these architectures, it might require specific hardware features that may be available only on some boards.

Releases

To use this library, open the Library Manager in the Arduino IDE and install it from there.

Usage

The ArduinoIoTCloud library is the central element of the firmware enabling certain Arduino boards to connect to the Arduino IoT Cloud.

thingProperties.h

When you are create and configure a Thing in the Arduino IoT Cloud interface, the thingProperties.h file is generated automatically.

This file adds all the variable/properties along with its specifications (e.g. update policy, read/write permissions), and the type of connection handler depending on what device you have attached.

Methods such as addProperty() and setThingId() are implemented here, so there’s no need for manually entering anything.

We recommend that you do not edit this file as it is automatically updating whenever you make changes in the Arduino IoT Cloud.

Offline Editing

If you have set up your sketch in an offline environment, make sure that whatever changes you make are reflected in this file, as it will be updated in the online environment.

TCP / LPWAN

Depending on what type of connection is used (TCP/LPWAN), either the ArduinoIoTCloudTCP or ArduinoIoTCloudLPWAN base classes are initialized. This specification is done in the Arduino IoT Cloud’s “Thing” interface, and is reflected in the automatically generated thingProperties.h file.

  • If a board is configured as a TCP device, it will automatically include the ArduinoIoTCloudTCP.h file, and methods of the ArduinoIoTCloudTCP class will be made available. This is the most common option.
  • If a board is configured as an LPWAN device, it will instead include the ArduinoIoTCloudLPWAN.h file, and methods of the ArduinoIoTCloudLPWAN class will be made available.

As a result, functions such as begin(), update(), connected() and printDebugInfo() are documented under each corresponding class.

Connection Handler Library

When the library is initialized via the begin() function, it will choose the specified connection handler, which is automatically added to your thingProperties.h file when configuring a Thing.

The connection handler is done via another library, Arduino_ConnectionHandler, which supports Wi-Fi®, GSM, NB-IoT, LoRa® & Ethernet.

ArduinoCloud Class (TCP)

ArduinoCloud Class (LPWAN)