Configurez la connectivité WiFi et installez les mises à jour OTA du micrologiciel sur votre OSSM
L'OSSM prend en charge la connectivité WiFi pour les mises à jour OTA du micrologiciel. Ce guide explique comment connecter votre OSSM à votre réseau domestique et vérifier les mises à jour.
Configuration WiFi
Démarrage de la configuration WiFi
Accédez à WiFi Setup
Dans le menu principal, faites défiler jusqu'à WiFi Setup et appuyez sur l'encodeur pour le sélectionner.
Afficher les instructions de connexion
L'écran affiche :
- En-tête "WiFi Setup"
- Instructions pour se connecter à "OSSM Setup"
- Un QR code pour une connexion rapide
Le code QR encode : WIFI:S:OSSM Setup;T:nopass;;
Connectez-vous au point d'accès OSSM
Sur votre téléphone ou ordinateur :
- Ouvrez les paramètres WiFi
- Recherchez un réseau nommé OSSM Setup
- Connectez-vous (aucun mot de passe requis)
Scannez le code QR avec l'appareil photo de votre téléphone pour une connexion d’un simple appui sur les appareils pris en charge.
Configurez votre réseau domestique
Après vous être connecté au point d'accès OSSM :
- Un portail captif devrait s'ouvrir automatiquement
- Sinon, ouvrez un navigateur et accédez à
192.168.4.1 - Sélectionnez votre réseau WiFi domestique dans la liste
- Entrez votre mot de passe WiFi
- Cliquez sur Save
L'OSSM tentera de se connecter à votre réseau domestique.
Quitter la configuration WiFi
Appuyez sur l'encodeur ou sélectionnez Restart pour quitter le mode de configuration WiFi. L'OSSM redémarrera et se connectera à votre réseau configuré.
Vérification de la connexion
Après le redémarrage, l'OSSM tentera de se connecter à votre réseau WiFi configuré. Vous pouvez vérifier la connexion comme suit :
- Sélectionnez Update dans le menu principal
- Si le WiFi est connecté, vous verrez "Checking for update..."
- Si le WiFi n'est pas connecté, vous serez redirigé vers WiFi Setup
L'OSSM n'affiche pas son adresse IP à l'écran. Pour une mise en réseau avancée, vous pouvez la trouver dans la liste des clients DHCP de votre routeur ou utiliser des outils d'analyse réseau.
Effacement des paramètres WiFi
Pour vous connecter à un autre réseau ou résoudre les problèmes de connexion :
- Sélectionnez WiFi Setup dans le menu
- La configuration réseau précédente sera écrasée lorsque vous enregistrerez de nouveaux paramètres
- Vous pouvez également reflasher le micrologiciel pour effacer tous les paramètres
Mises à jour OTA
L'OSSM peut télécharger et installer les mises à jour du micrologiciel directement via WiFi, sans se connecter à un ordinateur.
Conditions préalables
- Connexion WiFi active (configurée via WiFi Setup)
- Accès Internet depuis votre réseau
- Alimentation électrique suffisante pendant la mise à jour
Vérification des mises à jour
Accédez à Update
Dans le menu principal, faites défiler jusqu'à Update et appuyez sur l'encodeur.
Attendez la vérification de la version
L'écran affiche "Checking for update..." pendant que l'OSSM contacte le serveur de mise à jour.
Le micrologiciel envoie sa version actuelle (SW_VERSION) au serveur, qui indique si une mise à jour est disponible.
Consulter le résultat
Vous verrez l'un des deux écrans :
Aucune mise à jour disponible :
- Message "No Update Available"
- Appuyez sur l'encodeur pour revenir au menu
Mise à jour disponible :
- Message "Updating OSSM..."
- La mise à jour démarre automatiquement
Pendant la mise à jour
N'éteignez pas et ne déconnectez pas votre OSSM pendant une mise à jour. Cela peut corrompre le micrologiciel et nécessiter une récupération manuelle.
Le processus de mise à jour :
- Télécharge le nouveau fichier binaire du micrologiciel (~1-2 MB)
- Vérifie l'intégrité du téléchargement
- Écrit le micrologiciel dans la mémoire flash
- Redémarre automatiquement l'appareil
L'écran affiche : "Update is in progress. This may take up to 60s."
Après la mise à jour
L'OSSM redémarre automatiquement après une mise à jour réussie. Il va :
- démarrer avec le nouveau micrologiciel
- effectuer la séquence de référencement
- revenir au menu principal
Vos paramètres et votre configuration WiFi sont conservés après les mises à jour.
Canaux de mise à jour
Le micrologiciel OSSM prend en charge plusieurs canaux de mise à jour :
| Canal | URL | Description |
|---|---|---|
| Production | d2g4f7zewm360.cloudfront.net | Versions stables pour un usage général |
| Development | d2oq8yqnezqh3r.cloudfront.net | Versions préliminaires pour les tests |
Le canal de mise à jour est déterminé au moment de la compilation. Le micrologiciel Production vérifie le serveur Production ; le micrologiciel Development vérifie le serveur Development.
Dépannage
- Assurez-vous que vous êtes en mode WiFi Setup (l'écran affiche le code QR)
- Rapprochez-vous de l'OSSM
- Essayez d'actualiser la liste WiFi de votre appareil
- Redémarrez l'OSSM et réessayez
- Ouvrez un navigateur manuellement et accédez à
192.168.4.1 - Désactivez temporairement les données mobiles sur votre téléphone
- Essayez un autre appareil
- Vérifiez que votre mot de passe WiFi est correct
- Assurez-vous que votre réseau est à 2,4 GHz (l'ESP32 ne prend pas en charge 5 GHz)
- Vérifiez que votre routeur autorise les nouveaux appareils
- Essayez de rapprocher l'OSSM de votre routeur
- Vérifiez que le WiFi est connecté (essayez d'abord WiFi Setup)
- Vérifiez votre connexion Internet
- Le serveur de mise à jour peut être temporairement indisponible
- Réessayez dans quelques minutes
- Assurez un signal WiFi stable pendant la mise à jour
- Rapprochez-vous de votre routeur si nécessaire
- Vérifiez que votre connexion Internet fonctionne
- Réessayez après avoir rebranché l’alimentation
Ceci est rare mais peut arriver si la mise à jour a été interrompue. Options de récupération :
- Effectuez un cycle d’alimentation (débranchez puis rebranchez l’alimentation)
- Si l'appareil ne démarre pas, vous devrez reflasher via USB en utilisant PlatformIO
Détails techniques
Communication avec le serveur de mise à jour
L'OSSM envoie une requête POST au serveur de mise à jour avec :
{
"ossmSwVersion": "x.y.z"
}Le serveur répond par :
{
"response": {
"needUpdate": true
}
}Si needUpdate est true, le micrologiciel télécharge le binaire à partir du serveur de distribution du micrologiciel.
Emplacements des binaires du micrologiciel
| Canal | URL du binaire |
|---|---|
| Production | d2sy3zdr3r1gt5.cloudfront.net/firmware.bin |
| Development | d2sy3zdr3r1gt5.cloudfront.net/firmware-dev.bin |