59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
# ESPTest
|
|
|
|
Firmware Arduino pour une carte **ESP32-S3 DevKitC-1**. Au démarrage, l'appareil lit sa configuration EEPROM, se connecte au Wi-Fi ou ouvre un portail de configuration.
|
|
La programmation est réalisable au travers de l'OTA.
|
|
|
|
Ce montage vise à remplacer les arduinos Mega utilisés à Legende de train. Ces cartes servent à piloter des relais en fonction d'un Topic MQTT, les sorties sont activées selon le schéma suivant :
|
|
<topic>/gpio<num sortie>
|
|
avec un payload <On/Off>
|
|
|
|
## Fonctionnalités
|
|
|
|
- **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.
|
|
- **Commandes MQTT** : le serveur, l'utilisateur, le mot de passe et le topic sont saisis dans le portail et enregistrés en EEPROM.
|
|
- L'ESP publie l'état conservé `online` sur `<topic>/status` et utilise `offline` comme message Last Will.
|
|
- L'ESP écoute `<topic>/#` et commande la sortie correspondante avec les topics `<topic>/gpio<numéro>` et les payloads `On` ou `Off`.
|
|
- La reconnexion au broker est tentée automatiquement toutes les cinq secondes.
|
|
|
|
- **Mise à jour du firmware** par ArduinoOTA après connexion au Wi-Fi.
|
|
|
|
## Prérequis et compilation
|
|
|
|
Installer Visual Studio Code avec l'extension PlatformIO IDE, ou PlatformIO Core. La cible et les dépendances WiFiManager et PubSubClient sont définies dans [`platformio.ini`](./platformio.ini).
|
|
|
|
Depuis la racine du projet :
|
|
|
|
```sh
|
|
pio run -e esp32-s3-devkitc-1
|
|
pio run -e esp32-s3-devkitc-1 -t upload
|
|
pio device monitor -b 115200
|
|
```
|
|
|
|
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 configuration
|
|
|
|
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`.
|
|
|
|
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
|
|
.
|
|
├── include/
|
|
│ ├── eeprom_storage.h
|
|
│ ├── main.h
|
|
│ ├── ota.h
|
|
│ └── wifi_config.h
|
|
├── platformio.ini
|
|
└── src/
|
|
├── eeprom.cpp
|
|
├── main.cpp
|
|
├── ota.cpp
|
|
└── wifi.cpp
|
|
```
|