Le projet DRCV, autrement dit "Dsi Room Calendar View" est un mini projet ayant pour but d'afficher sur un écran E-ink les réservations actuelles et à venir de nos salles de conférence.
La partie configuration du projet a une partie commune avec des prérequis globaux. Cette section de la documentation concerne donc les points et choses à avoir absolument peu importe l'écran
Pour utiliser ce projet, il vous faudra tout d'abord :
- Un des écrans cités à la section 📁 Projet sur différent écran
- Arduino IDE dans la version la plus récente 💿 Installation de l'IDE Arduino
- Un compte pour le programme, qui a accès aux réservations de la salle souhaitée.
Cloner le repo sur lequel vous êtes actuellement avec la commande suivate :
git clone https://github.com/epfl-si/drcv-esp32.gitou
git clone git@github.com:epfl-si/drcv-esp32.gitNote
Vous pouvez depuis le repository Github, cliquer sur le bouton vert avec inscris Code. Une interface s'ouvrira vous proposant, dans l'onglet local, plusieurs paramètres (https, ssh et Github CLI) afin de télécharger le repository sur votre appareil.
Si vous n'avez pas l'utilitaire de commande git, vous pouvez également, en suivant les étapes précédente, cliquer sur Download ZIP puis l'extraire.
| Système d'exploitation (OS) | Téléchargement |
|---|---|
| Windows | Depuis le site web officiel sur https://www.arduino.cc/en/software/. |
| MAC | Depuis le site web officiel sur https://www.arduino.cc/en/software/. |
| Linux | Je recommande d'installer la version Arduino IDE v2 avec flatpak ou d'installer l'AppImage ou le zip que l'on peut récupérer depuis le site officiel sur https://www.arduino.cc/en/software/. Je déconseille la version snap n'était pas à jour et causait donc de nombreux problèmes. |
- Lancer Arduino
- Dirigez-vous sur
Files > Preferencies(en français =>Fichier > Préférences) - Tout à droite du champ "URL de gestionnaire de cartes supplémentaires", cliquez sur le bouton bleu avec deux carrés
- Ajoutez cette ligne : https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
- Ensuite, allez dans
Tools > Board > Boards Manager(en français =>Outils > Carte > Gestionnaire de Cartes) - Tapez "esp32"
- Installer la version la plus récente du gestionnaire de cartes esp32, par Espressif Systems
Différentes librairies sont à installer afin que le projet puisse fonctionner. Certaines libraries sont communes et sont donc référé ici, d'autres sont exclusives à l'écran et seront donc expliqués dans la section 📚 Libraries du README.md de leur dossier respectif.
Note
S'ils n'ont pas besoin de librairies supplémentaires, la section 📚 Libraries sera manquante au README.md.
Voici donc la liste des libraires à installer qui sont communes à tous les écrans :
ArduinoHttpClientpar Arduino (Utilisé afin d'effectuer les requêtes HTTP vers l'API SOAP EWS)Base64par Xander Electronics (Utilisé afin de convertir en base 64 le nom d'utilisateur et le mot de passe du compte de service, et le mettre dans les requête HTTP)
Note
Certaines méthodes comme le XMLParser ou encore le Split sont handmade.
Les différentes documentations de ceux-ci sont référé dans la section 🧩 Classes et fonctions créées pour ce projet
- Aller dans le dossier
src - Dupliquer le fichier
secrets.h.exampleet renommez-lesecrets.h - Ajoutez les valeurs nécessaires (nom d'utilisateurs, mot de passe, etc..)
[!WARNING] Prennez garde à ne pas modifier les valeurs déjà existante.
-
Fonction Split
-
Classe DateTime
-
Classe Event
-
Function XML_Parser
La prise en charge du multi langue n'est pas disponible, cependant, l'intégralité des textes affichés sur l'écran (hors valeurs décimales), sont editables dans le fichier variables.h