Step
This commit is contained in:
1 parent
644e2363f7
commit
75bbcce5b4
10 files changed
+226
-98
No files matched your search
@@ -1,35 +1,16 @@
|
||||
# ESPTest
|
||||
|
||||
ESPTest est un exemple de firmware Arduino pour une carte **ESP32-S3 DevKitC-1**. Il configure le Wi-Fi, démarre un serveur web et met à disposition un tableau de bord avec une température simulée, une mise à jour du firmware par OTA et un terminal série accessible depuis le navigateur.
|
||||
Firmware Arduino pour une carte **ESP32-S3 DevKitC-1**. Au démarrage, l'appareil lit sa configuration MQTT en EEPROM, se connecte au Wi-Fi ou ouvre un portail de configuration, puis active les mises à jour OTA.
|
||||
|
||||
## Fonctionnalités
|
||||
|
||||
- **Configuration Wi-Fi** avec NetWizard : l'appareil se connecte au réseau mémorisé ou démarre le portail de configuration « My Device ».
|
||||
- **Tableau de bord** ESP-DASH affichant une valeur de température simulée, actualisée toutes les trois secondes.
|
||||
- **Mise à jour OTA** avec ElegantOTA.
|
||||
- **Terminal série web** avec WebSerial. Les messages reçus dans le terminal sont également écrits sur le port série USB.
|
||||
- **Serveur web asynchrone** sur le port 80.
|
||||
- **Configuration Wi-Fi** avec WiFiManager. Le point d'accès de configuration porte un nom `Legende-XXXX`, où `XXXX` correspond aux deux derniers octets de l'adresse MAC.
|
||||
- **Paramètres MQTT** (serveur, utilisateur, mot de passe et topic) saisis dans le portail et enregistrés en EEPROM. Le client MQTT n'est pas encore implémenté.
|
||||
- **Mise à jour du firmware** par ArduinoOTA après connexion au Wi-Fi.
|
||||
|
||||
## Matériel et prérequis
|
||||
## Prérequis et compilation
|
||||
|
||||
- Une carte ESP32-S3 DevKitC-1.
|
||||
- [Visual Studio Code](https://code.visualstudio.com/) avec l'extension [PlatformIO IDE](https://platformio.org/install/ide?install=vscode), ou PlatformIO Core en ligne de commande.
|
||||
- Un câble USB adapté à la carte.
|
||||
- Un navigateur sur un appareil connecté au même réseau local que l'ESP32 pour accéder au tableau de bord.
|
||||
|
||||
Les bibliothèques nécessaires sont déclarées dans [`platformio.ini`](./platformio.ini) et PlatformIO les installe lors de la compilation.
|
||||
|
||||
## Compiler et téléverser
|
||||
|
||||
### Avec Visual Studio Code
|
||||
|
||||
1. Ouvrir le dossier du projet dans VS Code.
|
||||
2. Laisser PlatformIO installer les dépendances.
|
||||
3. Connecter la carte en USB.
|
||||
4. Utiliser les actions PlatformIO **Build**, puis **Upload**.
|
||||
5. Ouvrir le moniteur série à **115200 bauds** pour suivre le démarrage.
|
||||
|
||||
### En ligne de commande
|
||||
Installer Visual Studio Code avec l'extension PlatformIO IDE, ou PlatformIO Core. La cible et la dépendance WiFiManager sont définies dans [`platformio.ini`](./platformio.ini).
|
||||
|
||||
Depuis la racine du projet :
|
||||
|
||||
@@ -39,36 +20,30 @@ pio run -e esp32-s3-devkitc-1 -t upload
|
||||
pio device monitor -b 115200
|
||||
```
|
||||
|
||||
Si plusieurs ports série sont disponibles, sélectionner celui de la carte dans les paramètres de PlatformIO ou préciser le port avec `--port`.
|
||||
Le premier téléversement se fait par USB. Les mises à jour OTA sont disponibles après le démarrage du firmware et la connexion de la carte au réseau.
|
||||
|
||||
## Première connexion et utilisation
|
||||
## Première configuration
|
||||
|
||||
1. Après démarrage, l'ESP32 se connecte au Wi-Fi mémorisé. Si aucun réseau enregistré n'est disponible, il lance le portail de configuration NetWizard nommé **My Device**.
|
||||
2. Depuis un téléphone ou un ordinateur, rejoindre le point d'accès de configuration et suivre le portail pour fournir les identifiants du réseau Wi-Fi.
|
||||
3. Une fois l'ESP32 connecté au réseau local, repérer son adresse IP dans le moniteur série ou dans la liste des appareils du routeur.
|
||||
4. Ouvrir `http://<adresse-ip-de-l-esp32>/` dans un navigateur. La racine redirige vers le tableau de bord. Son URL directe est `http://<adresse-ip-de-l-esp32>/dashboard`.
|
||||
1. Téléverser le firmware par USB et ouvrir le moniteur série à **115200 bauds**.
|
||||
2. Si aucun Wi-Fi enregistré n'est disponible, connecter un téléphone ou un ordinateur au point d'accès `Legende-XXXX`. Son mot de passe initial est `Legende_2026`.
|
||||
3. Ouvrir le portail captif et saisir les identifiants du réseau ainsi que les paramètres MQTT.
|
||||
4. Après connexion, le firmware démarre ArduinoOTA sous le nom réseau `Legende-XXXX`.
|
||||
|
||||
Autres interfaces :
|
||||
|
||||
| Chemin | Fonction |
|
||||
| --- | --- |
|
||||
| `/dashboard` | Tableau de bord et valeur de température simulée |
|
||||
| `/update` | Interface de mise à jour du firmware par OTA |
|
||||
| `/webserial` | Terminal série dans le navigateur |
|
||||
|
||||
L'interface OTA et le terminal WebSerial sont accessibles depuis le réseau local de l'appareil. Pour les mises à jour OTA, utiliser un firmware compilé pour cette carte et suivre les indications de l'interface.
|
||||
Le mot de passe OTA initial est également `Legende_2026`. Changez les mots de passe configurés dans les sources avant tout déploiement réel. Les paramètres MQTT sont conservés en EEPROM ; les identifiants Wi-Fi sont gérés par WiFiManager.
|
||||
|
||||
## Structure du projet
|
||||
|
||||
```text
|
||||
.
|
||||
├── platformio.ini # Carte, framework, dépendances et options de compilation
|
||||
├── include/
|
||||
│ ├── eeprom_storage.h
|
||||
│ ├── main.h
|
||||
│ ├── ota.h
|
||||
│ └── wifi_config.h
|
||||
├── platformio.ini
|
||||
└── src/
|
||||
└── main.cpp # Initialisation Wi-Fi et serveur, boucle et mise à jour du tableau de bord
|
||||
├── eeprom.cpp
|
||||
├── main.cpp
|
||||
├── ota.cpp
|
||||
└── wifi.cpp
|
||||
```
|
||||
|
||||
## Configuration et personnalisation
|
||||
|
||||
- La carte cible, le débit série, les bibliothèques et les options de compilation se configurent dans [`platformio.ini`](./platformio.ini).
|
||||
- Le nom du point d'accès, les routes web et la fréquence d'actualisation du tableau de bord se trouvent dans [`src/main.cpp`](./src/main.cpp).
|
||||
- La température affichée est générée aléatoirement entre 0 et 49 ; elle ne provient pas d'un capteur physique.
|
||||
Reference in new issue
Block a user