Skip to content

Latest commit

 

History

History
152 lines (93 loc) · 8.45 KB

document_utilisateur_iot.adoc

File metadata and controls

152 lines (93 loc) · 8.45 KB

Documentation utilisateur de l’application IOT

1. Description du projet

1.1. Équipe

L’équipe est composée de cinq membres avec les rôles suivants :

  • Romain : Product Owner et Développeur

  • Kilian : Développeur

  • Titouan : Développeur

  • Pablo : Développeur

  • Hugo : Scrum Master et Développeur

1.2. Contexte du projet

Le projet a pour objectif de développer une application de gestion d’entrepôt pour l’entreprise BuildMyPC, spécialisée dans la vente de composants informatiques et d’ordinateurs montés. Bien que son activité principale ne soit pas le stockage, l’entreprise doit gérer des locaux pour stocker les produits nécessaires à son activité. BuildMyPC souhaite donc intégrer une solution logicielle complémentaire pour surveiller les conditions environnementales de ses entrepôts, telles que la température, l’humidité et le niveau de CO2, afin de garantir la qualité de ses produits.
L’application devra également inclure un module pour suivre la production et la consommation énergétique des panneaux solaires de l’entreprise, permettant une gestion optimisée de l’énergie et une approche écoresponsable. Ce projet vise à renforcer l’efficacité opérationnelle de l’entreprise tout en soutenant ses engagements en matière de durabilité.

1.3. Objectifs du projet

Problématique :

Garantir la fiabilité et l’efficacité de l’application IoT de gestion d’entrepôt pour assurer la qualité des produits et optimiser la gestion énergétique, tout en offrant une expérience utilisateur optimale.

Objectifs :

  • Valider le fonctionnement des connexions, des capteurs et des modules énergétiques.

  • Assurer l’affichage précis et en temps réel des données, même en cas d’erreurs ou de données manquantes.

  • Tester les mécanismes d’alerte et de visualisation pour une prise de décision rapide.

  • Renforcer la robustesse du système face aux erreurs et interruptions.

  • Aligner l’application avec les objectifs de durabilité et d’efficacité opérationnelle de BuildMyPC.

2. Installer l’application

2.1. Prérequis

  • Système d’exploitation Windows

  • Installer les applications dans un répertoire dans lequel on a les droits de créer des nouveaux fichiers

  • Toujours avoir l’application java dans un fichier à coté de appli-python

  • Avoir java 17 installé sur sa machine

2.2. Installation

2.2.2. Python

Version recommandée : 3.11

L’application python utilise le module paho-mqtt pour communiquer avec les capteurs, pour l’installer, allez dans un terminal (ex : cmd) et executez la commande suivante :

pip install paho-mqtt

Pour récupérer l’application, rendez-vous la dernière release (ou cliquez ici) et téléchargez le fichier Application_Controle_Capteur.zip, puis décompressez-le.

Pour lancer l’application, double-cliquez sur le fichier AppliJava-1.0-shaded. L’application peut mettre du temps à démarrer si il y a un problème avec le script python.

3. Utiliser l’application

3.1. Fonctionnement général

fenêtre principale

Figure 1 : Menu principal de l’application

Les boutons Tester la connexion et relancer le python permettent respectivement de tester si la connexion fonctionne (donc si on peut recevoir des données) et de relancer le programme python mqtt qui va récupérer les données des capteurs. L’état actuel de ce programme python est affiché en haut à gauche de chaque fenêtre de l’application. Relancer le programme python permet de le faire démarrer si il y avait une erreur lors du lancement initial ou de lui appliquer les changements apportés au fichier de configuration.

Le bouton parametrer le config python permet de changer les filtres du programme python. Cette partie est expliquée plus en détail dans la section Configuration.

Le bouton Historique des alertes permet d’afficher une liste des alertes enregistrée. Cette partie est expliquée plus en détail dans la section Alertes.

Le reste des boutons permet de visualiser les données enregistrées de différentes manières. Cette partie est expliquée plus en détail dans la section Visualisation.

3.2. Configuration

fenêtre config

Figure 2 : Fenêtre de configuration du fichier config

Cette fenêtre vous permet de selectionner quelles données sont à récuperer par le fichier python et quels sont les seuils des alertes. Les informations saisissables sont donc dans l’ordre :

  • Température max : le seuil de température à ne pas dépasser.

  • Humidité max : le seuil d’humidité à ne pas dépasser.

  • Taux max (CO2) : le seuil à ne pas dépasser pour le taux de CO2.

  • Salles : les salles dont les données seront enregistrées.

  • Capteurs : les types de donnnées enregistrées (Température, Humidité, Taux).

Note : Lors que l’on modifie le config, il faut relancer le programme python pour que les changements s’appliquent. Le programme peut être relancé via le menu principal.

3.3. Visualisation

3.3.1. Données des capteurs des salles

Les données peuvent être visualisées de plusieurs manières :

  • Dernières données par salle : affiche une liste de salle avec leur dernières données récupérées. Si le fichier est introuvable ou la donnée absente "aucune donnée" est affiché à la place. Pour visualiser les données sous cette forme, il faut cliquer sur Visualiser les données dans le menu principal.

Visualisation dernières données

Figure 3 : Fenêtre d’affichage des dernières données par salle

  • Graphiques par salle : affiche un graphique par salle. A gauche, il est possible de sélectionner les données que l’on souhaite afficher sur une salle. Il est possible de masquer une salle. Lorsqu’une donnée est absente, elle n’est pas affichée sur le graphique. Le taux de CO2 est divisé par 100 pour que les autres données restent lisible. Pour obtenir le bon taux de CO2 il faut donc multiplier la valeur par 100. Pour visualiser les données sous cette forme, il faut cliquer sur Voir les courbes dans le menu principal puis Affichage par salle.

Affichage des données par salle

Figure 4 : Fenêtre d’affichage des données par salle

  • Graphiques par données : affiche un graphique par données. A gauche, il est possible de sélectionner les salles sur lequelles on veut afficher les données. Il est possible de masquer une donnée. Certaines salles ne contiennent pas de données mais elles sont tout de même affichées. Pour visualiser les données sous cette forme, il faut cliquer sur Voir les courbes dans le menu principal puis Affichage par données.

Affichage des données par salle

Figure 5 : Fenêtre d’affichage des graphiques par données

3.3.2. Données des capteurs solaire

Pour visualiser ces données, il faut cliquer sur Panneaux solaires dans le menu principal ou sur Voir les courbes dans le menu principal puis Affichage panneaux solaire.

Affichage des données solaire

Figure 6 : Fenêtre d’affichage des données solaire

Affichage des données solaire

Figure 7 : Fenêtre Voir les courbes

3.4. Alertes

Des alertes peuvent survenir lorsque les données enregistrées dépassent un certain seuil défini dans le config. Lorsque cela arrive, une alerte apparait en bas à droite de l’écran et disparait après 10 secondes. L’alerte propose de rediriger vers la page Historique des alertes qui affiche l’entièreté des alertes enregistrées. Ces alertes peuvent être triées par type, salle et date.

Exemple d’alerte

Figure 8 : Exemple d’alerte

Fenêtre historique des alertes

Figure 8 : Fenêtre historique des alertes