# ConsentiumThings Arduino Data Receiver API

## Overview

This code interfaces with the **ConsentiumThings board** to receive sensor data from a server via Wi-Fi and print it to the Serial Monitor. It is intended for use with **ESP8266**, **ESP32**, and **Raspberry Pi Pico W** boards and operates by connecting to Wi-Fi and receiving data at regular intervals using the ConsentiumThings REST API.

## Dependencies

The code depends on the **ConsentiumThings.h** library, which provides functions for Wi-Fi connection, data reception, and RESTful API communication with the Consentium IoT platform.

## Components

### 1. **Wi-Fi Configuration**

* `const char *ssid = "YOUR_WIFI_SSID";`: This is the Wi-Fi network SSID to which the IoT board will connect.
* `const char *pass = "YOUR_WIFI_PASSWORD";`: The password for the specified Wi-Fi network.

### 2. **API Keys**

* `const char *ReceiveApiKey = "YOUR_API_KEY";`: API key for receiving data from the server.
* `const char *BoardApiKey = "YOUR_BOARD_API_KEY";`: API key specific to the board, used for authentication purposes.

### 3. **Data Reception Interval**

* `constexpr int interval = 7000;`: Defines the time interval between each data reception in milliseconds. In this case, the system will wait for 7 seconds (7000 ms) between receiving data from the server.

### 4. **Board Initialization**

* `ConsentiumThings board;`: Creates an instance of the **ConsentiumThings** object, representing the IoT board that will receive data from the server.

## Functions

### `void setup()`

* This function runs once when the board is powered on or reset.
* **Wi-Fi Initialization**:
  * `board.initWiFi(ssid, pass);`: Connects the board to the Wi-Fi network using the provided SSID and password.
* **Board API Initialization**:
  * `board.beginReceive(ReceiveApiKey, BoardApiKey);`: Authenticates the board and initiates the process to receive data from the server using the ConsentiumThings platform.

### `void loop()`

* This function runs repeatedly after `setup()` and handles the continuous reception and printing of sensor data.
* **Data Reception**:
  * `auto dataPairs = board.receiveData();`: Retrieves the sensor data from the server, storing it as key-value pairs, where each pair contains a sensor reading and its corresponding label.
* **Data Printing**:
  * A `for` loop iterates through the received `dataPairs` to print both the sensor data and its corresponding label (`info`) to the Serial Monitor.
  * `Serial.print("Data: ");` and `Serial.print("Info: ");`: These lines are used to display the data and information for each sensor.
* **Delay**:
  * `delay(interval);`: Pauses execution for 7 seconds before receiving and printing new data again.

## Example Output

The code prints the received sensor data in the following format on the Serial Monitor:

```
Data: 24.5          	Info: Temperature
Data: 55.0          	Info: Humidity
```

This output shows the sensor values along with the description of what each value represents.

## Customization

### Wi-Fi Configuration

You must replace `"YOUR_WIFI_SSID"` and `"YOUR_WIFI_PASSWORD"` with your actual Wi-Fi network credentials:

```cpp
const char *ssid = "MyWiFiNetwork";
const char *pass = "MyWiFiPassword";
```

### API Keys

The placeholders `"YOUR_API_KEY"` and `"YOUR_BOARD_API_KEY"` should be replaced with the actual API keys provided by the ConsentiumThings service. These keys authenticate the board and allow it to receive data.

### Interval

To change the interval between receiving data from the server, adjust the value of the `interval` constant (in milliseconds):

```cpp
constexpr int interval = 5000; // Wait for 5 seconds between data receptions
```

### LED Indication (Optional)

You can connect an LED to a specific GPIO pin to visually indicate REST events as mentioned in the comment header. The GPIO pin depends on the board:

* GPIO 16 for ESP8266
* GPIO 23 for ESP32
* GPIO 25 for Raspberry Pi Pico W