Event & Callbacks

The Arduino Cloud has support for events and callbacks. This can be used to trigger specific functionalities depending on what state your device is in.

You can for example trigger a specific block of code whenever the board is in a connecting, synchronized or disconnected state. In this document, we will explore how to set it up, using an example from the ArduinoIoTCloud library.

Events

The

ArduinoIoTCloudEvent

• CONNECT

  (0) - Board successfully connects to Arduino Cloud.

• SYNC

  (1) - Data is successfully synced between Board and Arduino Cloud.

• DISCONNECT

  (2) - Board has lost connection to Arduino Cloud.

The

CONNECT

DISCONNECT

SYNC

These events can be subscribed to using the

addCallback()

Callbacks

Callbacks can be added for each event, and essentially triggers a custom function whenever the event occurs.

Callbacks are added via the

addCallback()

ArduinoIoTCloud

Copy
1ArduinoCloud.addCallback(ArduinoIoTCloudEvent::CONNECT, doThisOnConnect);

The above code will trigger the

doThisOnConnect()

CONNECT

Please note that callback functions should be added inside the

setup()

Full Example

The example below demonstrates how to use events & callbacks in the Arduino Cloud.

Copy
1