INTERNNEEEEET

Prérequis

Avoir un groupe
Avoir un compte Github
Git / Git Bash
VS Code
Platformio

Objectif

Vous avez déjà eu l'opportunité d'utiliser MQTT lors du cours d'IOT. L'objectif de ce cours est de vous donner une nouvelle opportunité de bien comprendre le fonctionnement du prototole et son utilisation pour la distribution de messages légers en IOT. Le but de ce TP est de faire remonter les données de température et humidité lues lors du TP précédent avec MQTT.

Préparation

Forkez le projet du TP sur votre compte github avec le nom "PDP_ETUDIANTS_02_TD<NUMERO_DE_TD>_GP<NUMERO_DE_GROUPE>". Par exemple, le groupe 7 du TD 4 devra créer le repo "PDP_ETUDIANTS_02_TD04_GP07"
ATTENTION : un projet mal nommé sera sanctionné de -5pts sur le suivi du TP. C'est littéralement la partie la plus facile pour vous et ça facilite énormément la correction.
Clonez votre fork sur votre machine avec git clone <url>
Ouvrir le projet avec PlatformIO (sinon les options de compilation et téléversement peuvent ne pas apparaître)
Compléter le code pour compléter chaque étape et commit REGULIEREMENT

Afin de vérifier votre compréhension du fonctionnement de l'environnement de développement, vous allez travailler avec Git, vous devrez donc commit vos modifications régulièrement. Chaque étape devra faire l'objet d'une branch distincte sur votre repository. Pour indiquer qu'un exercice est terminé, vous devrez tagguer le commit corrrespondant avec un formalisme indiqué dans les instructions. Comme vous devez travailler sur des branches par étape, le master devrait être inchangé à la fin.

Evaluation

L'évaluation de votre travail sera réalisée sur les critères suivants :

Etapes terminées
Respect des consignes de nommage des branch et tag git
Contenu et description des commit
Qualité du code (structure, lisibilité, commentaires utiles si et seulement si nécessaire...)
Temps nécessaire pour réaliser les étapes

Quelques ressources

Etape 1 - INTERNNEEEEET

Une seule étape dans ce TP :)

Réalisation

Créer une branch etape_1 à partir de master avec git checkout -b etape_1 master. Cette commande crée la nouvelle branche et vous met dessus directement. Si vous la créez avec git branch, pensez à switcher dessus avec git checkout etape_1. La récupération des repos et des branches est automatisée. Si la branche n'existe pas sur votre repo github ou qu'elle est mal nommée, elle ne sera pas corrigée.
Vérifier que le code fourni compile et fonctionne. Il reprend là où vous avez laissé la fin du TP1.
Dans main.cpp dans le dossier src, remplacer le bloc

#include <Arduino.h>
#include <Adafruit_Sensor.h>
#include <DHT.h>
#include <DHT_U.h>

par

#include <Arduino.h>
#include <Adafruit_Sensor.h>
#include <DHT.h>
#include <DHT_U.h>
#include "WiFiClientSecure.h"
#include <PubSubClient.h>

const char* wifi_ssid = <votre_ssid_wifi>;
const char* wifi_password = <votre_mdp_wifi>;
const char* mqtt_server = "27cc61dbaffc4da08cd0081cabd8cf01.s2.eu.hivemq.cloud";
int mqtt_port = 8883;
const char* mqtt_user = "ocres4ever";
const char* mqtt_pass = "ocresse123";
const char* client_id = <votre_groupe>;

Remplacer les bouts manquants dans le code:
1. <votre_ssid_wifi> : Le nom du réseau WiFi que vous voulez utiliser. Si le WiFi de l'école ne marche pas, essayez avec du partage de connexion (bonne chance à E3 😁).
2. <votre_mdp_wifi> : Le mot de passe du réseau WiFi.
3. <votre_groupe> : Votre nom de groupe avec le formalisme "TDXX_GPXX", eg "TD02_GP01" pour le groupe 1 du TD 2. IMPORTANT: Respectez exactement ce format pour votre groupe sinon les messages ne seront pas reçus.
Petite explication :
- Un vrai produit industriel utilisera sûrement un réseau LPWAN style LoRa plutôt que du WiFi pour limiter sa conso et augmenter la portée, mais ici on fait un proto, alors on va au plus simple :)
- On utilise un broker cloud offert par HiveMQ (gratuit jusqu'à 100 connexions simultanées et 10GB de stockage) dont on configure les accès ici. Notez qu'on utilise la bibliothèque "WiFiClientSecure.h" au lieu de "WiFi.h" car HiveMQ force l'utilisation de connexions sécurisées par TLS.
- On utilise la bibliothèque "PubSubClient.h" pour établir la connexion au broker avec le protocole MQTT.
- la variable client_id est un identifiant qui permet au broker de connaître l'origine d'un message.
Juste en-dessous du code ajouté à l'étape précedente, ajouter la ligne :

static const char ca_cert[] PROGMEM = R"EOF(
-----BEGIN CERTIFICATE-----
MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
-----END CERTIFICATE-----
)EOF";

Vous venez d'ajouter le certificat CA du broker, utilisé pour la connexion sécurisée.

Au-dessus du setup, créer et instancier le client WiFi et le client MQTT.

WiFiClientSecure client;
PubSubClient mqtt_client(client);

Toujours au-dessus du setup, déclarer la fonction qui servira à connecter la carte au réseau WiFi. L'appeler à l'endroit indiqué dans le setup.

void connect_wifi() {
  Serial.print("Connecting to WiFi");
  WiFi.begin(wifi_ssid, wifi_password);
  // attempt to connect to Wifi network:
  while (WiFi.status() != WL_CONNECTED) {
    Serial.print(".");
    // wait 2OOms for re-trying
    delay(200);
  }
  Serial.println("\nConnected.");
}

Configurer le serveur MQTT à l'endroit indiqué avec

mqtt_client.setServer(mqtt_server, mqtt_port);
client.setCACert(ca_cert);

A ce moment, le code est prêt à envoyer les valeurs lues au broker avec MQTT.
Au bon endroit dans le code, connectez le client au broker avec la fonction mqtt_client.connect(), connez-lui les bons arguments.
Si et seulement si la fonction connect a bien fonctionné (elle retourne un booléen...), publiez la température et l'humidité relative avec MQTT.
- Le topic pour la température est "TDXX_GPXX/temp", même formalisme que pour client_id.
- Le topic pour l'humidité est "TDXX_GPXX/relhum", même formalisme que pour client_id.
Un programme affiche les messages reçus sur le broker en direct. Vérifiez que votre montage envoie bien les mesures lues.
Appelez-moi pour vérifier que tout fonctionne bien.
commit le code si ce n'est pas déjà fait.
Tagguer le dernier commit à corriger avec "e1" avec la commande git tag e1 HEAD. Cette commande utilise "HEAD" comme référence au commit le plus récent.
Publier vos commit avec vos tags avec git push origin --tags (ou git push --set_upstream origin etape_1 --tags pour associer la branche sur le repo distant si c'est votre premier push sur cette branche)

dydelu / PDP_ETUDIANTS_02_TD08_GP03