|
1 | 1 | # ArduinoIoTCloud
|
2 | 2 |
|
3 | 3 | This library allows to connect to the Arduino IoT Cloud service. It provides a ConnectionManager to handle connection/disconnection, property-change updates and events callbacks.
|
4 |
| -The supported boards are MKRGSM, MKR1000 (Wifi101) and MKR 1010 (WifiNINA). |
| 4 | +The supported boards are MKRGSM, MKR1000 (WiFi101) and MKR 1010 (WiFiNINA). |
5 | 5 |
|
6 | 6 | ## Arduino IoT Cloud
|
7 | 7 |
|
8 |
| -[Arduino IoT Cloud](https://create.arduino.cc/iot/things) is a service which allows connecting the cloud to the world around you. [Here](https://www.arduino.cc/en/IoT/HomePage) an introduction. |
9 |
| -Now the platform is in public beta, feedbacks are welcome. |
| 8 | +[Arduino IoT Cloud](https://create.arduino.cc/iot/things) is a service which allows connecting the cloud to the world around you. [Here](https://www.arduino.cc/en/IoT/HomePage) is an introduction. |
| 9 | +Now the platform is in public beta, feedback is welcome. |
10 | 10 |
|
11 | 11 |
|
12 | 12 | ### Arduino IoT Cloud Components
|
13 | 13 |
|
14 |
| -- **Devices**: Physical objects like a hardware board (e.g. MKR WiFi 1010). This is the hardware which runs the software, read sensors, controls actuators and comunicates with the Arduino IoT Cloud. |
| 14 | +- **Devices**: Physical objects like a hardware board (e.g. MKR WiFi 1010). This is the hardware which runs the software, reads sensors, controls actuators and communicates with the Arduino IoT Cloud. |
15 | 15 |
|
16 | 16 | - **Things**: Logical representation of a connected object. They represent the inherent properties of the object, with as little reference to the actual hardware used to implement them. Each thing is represented by a collection of properties (e.g., temperature, light).
|
17 | 17 |
|
18 | 18 | - **Properties**: Qualities defining the characteristics of a system. A property can be something like a read-only (RO) setting to indicate the Arduino IoT Cloud can read the data, but cannot change the value of the property. A property might be designed as read and write (RW) if the Arduino IoT Cloud can also remotely change the property’s value and send an event notification to the device.
|
19 | 19 |
|
20 |
| -- **Events**: When something happens the Arduino IoT Cloud is aware of it thanks to application messages. For example, it might be informed by a face-recognition application that someone is at a door, or it has received a request from another app that a light be turned on. |
| 20 | +- **Events**: When something happens the Arduino IoT Cloud is aware of it thanks to application messages. For example, it might be informed by a face-recognition application that someone is at a door, or it has received a request from another app that a light be turned on. |
21 | 21 |
|
22 |
| -- **Software**: It's quickly autogenerated automatically by the Arduino IoT Cloud when setting up a new thing: in this way everything that you need it's almost done and ready. The connection to the cloud it's already made possible by this library. You have only to implement the callbacks linked to the properties. |
| 22 | +- **Software**: It's quickly autogenerated automatically by the Arduino IoT Cloud when setting up a new thing: in this way, almost everything that you need is done and ready. The connection to the cloud is handled by this library. You have only to implement the callbacks linked to the properties. |
23 | 23 |
|
24 | 24 | ## ArduinoIoTCloud library
|
25 | 25 |
|
26 |
| -The library is divided in various classes: |
27 |
| -- `ConnectionManager` which is responsable for the connection to the internet and to the Arduino IoT Cloud through `WiFiConnectionManager` or `GSMConnectionManager`. The selection is done using the type of board used. |
| 26 | +The library is divided into various classes: |
| 27 | +- `ConnectionManager` which is responsable for the connection to the Internet and to the Arduino IoT Cloud through `WiFiConnectionManager` or `GSMConnectionManager`. The selection is done using the type of board used. |
28 | 28 |
|
29 |
| -- `ArduinoIoTCloud` it's the leading class. It's responsable for the connection to the MQTT Broker. |
| 29 | +- `ArduinoIoTCloud` it's the leading class. It's responsible for the connection to the MQTT Broker. |
30 | 30 |
|
31 |
| -- `CloudSerial` it's similar to [Serial](https://www.arduino.cc/reference/en/language/functions/communication/serial/), but it's used in combination with the cloud. |
| 31 | +- `CloudSerial` it's similar to [Serial](https://www.arduino.cc/reference/en/language/functions/communication/serial/), but used in combination with the cloud. |
32 | 32 |
|
33 | 33 | ### ConnectionManager
|
34 | 34 | [todo]
|
35 | 35 |
|
36 | 36 | ### ArduinoIoTCloud
|
37 | 37 | [todo]
|
38 | 38 | ### CloudSerial
|
39 |
| -[todo] |
| 39 | +[todo] |
0 commit comments