js-ble-esp32
# [Envoi de données de JS à ESP32 avec BLE](https://qypol342.github.io/js-ble-esp32/demo_async.html)
[English README 🇬🇧](/js-ble-esp32/README_EN.html)
🎯 Objectif
L’objectif de ce projet est d’avoir le code minimum pour communiquer avec esp32 avec du Bluetooth BLE depuis son navigateur. Parce que le projet se repose sur le navigateur cela fonctionne aussi sur mobile.
⚠️ Attention
L’api Bluetooth n’est pas encore supporté par beaucoup de navigateurs. Pour l’instant seuls les navigateurs avec le moteur Chromium sont compatibles. Mais cela n’est pas un probleme sur mobile (PWA)
👉 Prérequis
Vous avez besoin d’un Esp32 évidemment, de l’IDE Arduino pour téléverser le code et finalement d’un serveur web (dans mon cas j’ai utiliser npm avec la commande npx serve)
📋 Installation
Cloner le projet sur votre machine </br>
Téléverser le .ino sur votre Esp32 </br>
Assurez vous que le chemin du serveur web correspond bien à la racine de ce projet
Lancer votre serveur web ( exemple npx serve )
📐 Bluetooth BLE structure
Le protocole fonctionne avec des services et des caractéristiques. Cette structure est très similaire à celle d’une bibliothèque, les services sont des étagères, on y range donc les livres des mêmes auteurs et du même genre. Les caractéristiques sont comme des livres on les ranges dans les mêmes services si il propose le même type de donnée ou que les données ont le même objectif.
Voici la structure créée dans ce projet:
Dans cette exemple characteristicRandNb est un seul octet, alors que characteristicLed est un table de 2 octet. L’objectif est de contrôler la led (l’allumer et l’éteindre).
🚀 Utilisation
Un fois la page web chargée et l’Esp 32 alimenté, cliquez sur connect, si votre navigateur est compatible un petit page va soucrir où vous allez pouvoir choisir l’appareil.
Une fois l’appareil choisi et la connexion réussit les autres boutons sont activés. Avec le bouton Read vous pouvez lire characteristicLed qui est un tableau de 2 octets. Avec le bouton Write vous pouvez écrire sur characteristicLed. Le code envoyé lorsque vous cliquez sur Write change entre ces deux tableaux: Une fois [42, 35] un fois [42,2]. </br>
Dans le code de l’arduino si le deuxième élément du tableau est un 2 alors la LED s’allume. Pour confirmer cet événement, il change la première valeur du tableau, il la met à 23. L’Esp 32 va a chaque révolution modifier la valeur de characteristicRandNb avec un nombre aléatoire compris entre 0 et 11. </br>
Avec le bouton Notify sur la page web vous pouvez vous abonner au changement de valeur. A chaque changement, la nouvelle valeur sera affichée dans la console.</br>
Finalement le bouton Disconnect qui parle de lui-même permet de déconnecter l’appareil. Dans cette configuration l’Esp 32 peut être connecté à un seul appareil à la fois.
📚 Documentation
Data needed
- datetime
- door status 1 byte
- winter time 1 byte
- light sensor value (more than 4 (254))
Note video
- dans cette demo on aura un seul service avec 2 char
- un qui premt de génré la led de esp32 avec qui peut recevoi 2 octec
- un qui sera en lecture seul mais pour le quel on mettre un lsitenser qui observe si la valeur change commé d’un seul octer
- crée le fichier html
- ajouter la structure de base d’un fichier html
- ajouter 5 button
- pour se co pour lire pour ecrit pour etre notifier et se deco
- definir les bouton dans le js
- definir les uuid des service
- ajouter de vaiable
- ajouter les liseneter quand onc lcike sur les boutotn
- desactiver les bouton tant qu’uaun apparail est connecter
- fonction se connecter
- verfiifer si le navigateur est compatible
- fonction pour la demande d’appapreil
- fonction connecter se conncter
- demande le service
- aperis du service demander la charcherteroistique que l’on soughaite
- activer les bouton
- fonction read pour la char led
- conertry en array
- fonction écritre pour le char led
- alterner en 2 e
- fonction notify echoute chengemenat
-
deconneciton
- code arduino
- import la lib BLE
- delare le service et les characteristic, avec leur taille et leur type
- delare les pins LED et les variables
- dans le setup
- definir le pinde la led comme output
- verfie que la lib BLE est bien prette
- on defnie le nom de notre appreil (faire attention)
- start advertising le service
- ajoute les char au service
- on ajoute le service au serveur BLE
- met un valeur par default
- et on demare le service
advertise(); - while loop
- if central conected ? // si un apparile est connecter
- print son adresse mac
- tant qu’il est connecter
- faire ce que l’on veut
- si la char led est modifier
- on print la valeur duc char
- si la deuxieme valeur du array du char est a 2
- on allume la led et modifier la premier valeur de l’array du char
-
sinon on eteint la led
- on genere un nomre alétoir pour le char RandNb un nomreb entre 0 et 11
-
on ecrit la nouvelle valeur au char
- si l’appreil se déconnect on afficher son adress mac
to redo
- read function
-
- on recupère la valeur avec readeValue sera un type array Buffer
-
puis on la converti an array
- la fonction requestDevice qui retour l’appareil chsoir par l’ulisateur
- on lui donne un filtre, on va donc affiché seulement les apprail nome comme la variable devcice name
- et qui ocntione les services et charchartirse que nous allons utliser, ca c’est tres important