Voir la source de Qubitro Device Data - IoT Platform Series

{{Tuto Details
|Main_Picture=Qubitro_Device_Data_-_IoT_Platform_Series_qubitro.png
|Description=<translate>Qubitro Device Data - IoT Platform Series</translate>
|Area=Electronics
|Type=Technique
|Difficulty=Easy
|Duration=1
|Duration-type=hour(s)
|Cost=0
|Currency=USD ($)
}}
{{Introduction
|Introduction=<translate>Qubitro is an IoT (Internet of Things) platform that provides tools and services for connecting, managing, and analyzing IoT devices and data. It provides a cloud-based platform where users can securely connect their IoT devices and collect data from sensors and actuators.


It supports a wide range of communication protocols and provides device management capabilities, monitoring device data, linking with third-party webhooks, and creating rules to trigger based on conditions, etc. All of it with a Great UI ❤</translate>
}}
{{Materials}}
{{Tuto Step
|Step_Title=<translate>Getting Started</translate>
|Step_Content=<translate>To get started with Qubitro, we will first need to create an account. Go to the Qubitro website (https://www.qubitro.com/) and click on the "Sign Up" button. You will be prompted to enter ''Full Name'', ''Email Address,Country'', and ''password'' to create your account.


Once, we have created the account, we can log in from '''https://portal.qubitro.com/login<nowiki/>.''' However, we shall automatically be logged in to our account.</translate>
|Step_Picture_00=Qubitro_Device_Data_-_IoT_Platform_Series_1.png
}}
{{Tuto Step
|Step_Title=<translate>Create a New Project</translate>
|Step_Content=<translate>Once you have logged in, you will be prompted to create a project. Enter a name for your project and mention a description for your project.</translate>
|Step_Picture_00=Qubitro_Device_Data_-_IoT_Platform_Series_2.png
}}
{{Tuto Step
|Step_Title=<translate>Add Devices</translate>
|Step_Content=<translate>Next, you will need to add devices to your application. Go to the Project (if not already open), there we can see a button '''[+ New Source]'''. From this section, we will have 3 major sections -

'''1. Communication Protocol'''

With a prompt to choose between LoRaWAN, MQTT, & Cellular. We can choose the protocol that best suits our use-case.

I choose MQTT to get started with the platform basics. And since I shall be using Arduino IDE for programming the board, I went ahead with the '''MQTT Broker''' (Qubitro has its own broker - we shall see it in the upcoming section). In case you wish to know how the Toit platform works, you can check my '''[https://www.hackster.io/school_of_iot/toit-io-iot-platform-series-2-a352e0 Tutorial on Toit.io]'''

'''2. Device Details'''

I shall be using an ESP32 Dev Board, and therefore entered the details as per the image below -

'''3. Credentials'''

In the next step, we receive credentials, to connect to the MQTT Broker. We can use this detail to connect to the broker as a client - to Publish or Subscribe.

Now that we have the server, port, username and password we are all ready to send data to the Qubitro Cloud. '''Copy these details in a safe place''' (''We can view them later in the device settings as well though'')</translate>
|Step_Picture_00=Qubitro_Device_Data_-_IoT_Platform_Series_3.png
|Step_Picture_01=Qubitro_Device_Data_-_IoT_Platform_Series_4.png
}}
{{Tuto Step
|Step_Title=<translate>Hardware - From Device to Cloud</translate>
|Step_Content=<translate>Once you have configured your devices, you can start collecting data. Qubitro provides a range of tools for data collection and analysis, including real-time data visualization, data logging, and data filtering.

We shall upload a code on ESP32 using Arduino IDE to send data to Qubitro -
 <code>#include <WiFiClientSecure.h></code>

 <code>#include <PubSubClient.h></code>

 <code>#include <HTTPClient.h></code>

 <code>#include <ArduinoJson.h></code>
These are the necessary libraries for establishing an MQTT connection, handling HTTP requests, and working with JSON data.
 <code>const char* ssid = "xxxxxxxxx";</code>

 <code>const char* password = "xxxxxxxxx";</code>

 <code>String topic = "xxxxx";</code>

 <code>String mqtt_server = "broker.qubitro.com";</code>

 <code>String mqttuser = "xxxxxxxxxxxxxxxxxxxxxx";</code>

 <code>String mqttpass = "xxxxxxxxxxxxxxxxxxxxxx";</code>

 <code>String clientId = "xxxxxxxxxxxxxxxxxxxxxx";</code>
These variables store the Wi-Fi credentials (<code>ssid</code> and <code>password</code>), MQTT broker server address (<code>mqtt_server</code>), MQTT authentication credentials (<code>mqttuser</code> and <code>mqttpass</code>), MQTT client ID (<code>clientId</code>), and the MQTT topic (<code>topic</code>) to which the data will be published.
 <code>WiFiClientSecure espClient;</code>

 <code>PubSubClient client(espClient);</code>

 <code>float humidity = 0;</code>

 <code>float temp = 0;</code>
Create an instance of <code>WiFiClientSecure</code> and <code>PubSubClient</code> classes to establish a secure connection with the MQTT broker. Also, initializing default value of temperature and humidity.
 <code>#define MSG_BUFFER_SIZE (500)</code>

 <code>char msg[MSG_BUFFER_SIZE];</code>

 <code>char output[MSG_BUFFER_SIZE];</code>
Define the size of the message buffer for storing MQTT messages.
 <code>void device_setup() {</code>

   <code>// ... Wi-Fi connection setup ...</code>

 <code>}</code>
This function sets up the Wi-Fi connection by connecting to the specified Wi-Fi network (<code>ssid</code> and <code>password</code>).
 <code>void reconnect() {</code>

   <code>// ... MQTT reconnection logic ...</code>

 <code>}</code>
This function handles the reconnection to the MQTT broker in case of disconnection.
 <code>void setup() {</code>

   <code>// ... Initialization code ...</code>

 <code>}</code>
The <code>setup()</code> function is the entry point of the code. It initializes the serial communication, sets up the device, establishes a connection with the MQTT broker, and prepares the secure connection using <code>WiFiClientSecure</code> and <code>PubSubClient</code> objects.
 <code>void loop() {</code>

   <code>// ... Main code loop ...</code>

 <code>}</code>
The <code>loop()</code> function is the main execution loop of the code. It checks the MQTT connection, publishes the simulated temperature and humidity data to the MQTT topic, and then waits for a delay of 1 second before repeating the process.

Inside the <code>loop()</code> function, you'll notice the following steps:

* <code>if (!client.connected())</code> checks if the MQTT client is connected. If not, it calls the <code>reconnect()</code> function to establish the connection.
* <code>client.loop()</code> allows the MQTT client to maintain the connection and handle any incoming messages.
* The <code>temp</code> and <code>humidity</code> variables are randomly generated simulated values.
* A JSON document is created using the ArduinoJson library to store the temperature and humidity data.
* The JSON document is serialized into a string format using the <code>serializeJson()</code> function and stored in the <code>output</code> variable.
* The <code>client.publish()</code> function is used to publish the serialized JSON data to the specified MQTT topic.
* The serialized JSON data is printed to the serial monitor using <code>Serial.println()</code>.
* A delay of 1 second is added before repeating the loop.

Full version of the code available in the '''Code Section.'''

'''Now''' that we have written the code, upload it to the ESP32 board and wait for it to send data to cloud.

To check data, go to Device Name that you created, and check for any incoming data in the table. (refresh the table in case data not retrieved)</translate>
|Step_Picture_00=Qubitro_Device_Data_-_IoT_Platform_Series_5.png
}}
{{Tuto Step
|Step_Title=<translate>Create Dashboard</translate>
|Step_Content=<translate>Now that we were able to fetch for real-time data from the ESP32 board and view it on the table of Qubitro. Let us use the visualization feature to plot a graph of the data. Trust me, it takes seconds to setup the whole thing.

* Go to Dashboards, and create a New Dashboard. Give it a name.
* Once created, open it and go to Edit > Add Widget > Charts.
* Click on the new widget > three dots (settings) > Customization.
* Accordingly, select the data source, chart type and colour for data variables. Follow the below images for reference, and final Graph.

Data source example above

Data Point example above

Finally, I received the above graph based on a 30-minute data logging. If we head back to the main dashboard page, we can have a proper view, and with a view configuration, receive live data in realtime on Qubitro.

* In the dashboard, click on the chart widget we created, click on edit and drag it to the middle.
* Stretch and play with the widget according to the need. Resizing it for proper viewing. Remember to save it.

If you are facing trouble with viewing the data with 4 points in the graph period, you can change it in the View Mode's configuration of the graph widget.

Now, using this we can view the data of our device based on our needs!</translate>
|Step_Picture_00=Qubitro_Device_Data_-_IoT_Platform_Series_5.png
|Step_Picture_01=Qubitro_Device_Data_-_IoT_Platform_Series_6.png
|Step_Picture_02=Qubitro_Device_Data_-_IoT_Platform_Series_7.png
|Step_Picture_03=Qubitro_Device_Data_-_IoT_Platform_Series_8.png
|Step_Picture_04=Qubitro_Device_Data_-_IoT_Platform_Series_9.png
|Step_Picture_05=Qubitro_Device_Data_-_IoT_Platform_Series_10.png
}}
{{Tuto Step
|Step_Title=<translate>Rules to Trigger and Integration Services</translate>
|Step_Content=<translate>Finally, Qubitro allows you to integrate with other services such as Twilio, Slack, MailGun, and SendGrid. We can also use the trigger for Webhooks (RAW HTTP request) triggering,  You can do this by clicking on the "Rules" tab in the Device section and selecting the service you want to integrate with.


'''Congratulations! You have now completed the Qubitro IoT Platform documentation tutorial. We hope that this tutorial has provided you with the information you need to get started with Qubitro and create your own IoT application. '''


'''If you have any questions or need further assistance, please visit the Qubitro website or contact their support team.'''

'''Hurray! 🎉'''

'''We have learned another IoT Platform - Qubitro Device Data Platform'''</translate>
}}
{{Notes
|Notes=<translate></translate>
}}
{{PageLang
|Language=en
|SourceLanguage=none
|IsTranslation=0
}}
{{Tuto Status
|Complete=Draft
}}