Modifications

Sauter à la navigation Sauter à la recherche
4 058 octets ajoutés ,  24 octobre 2015 à 13:16
aucun résumé de modification
Ligne 29 : Ligne 29 :     
Dans le cas ci-présent, il ne faut pas détecter la fermeture d'un contact (comme le bouton poussoir) '''mais l'ouverture d'un contact'''.
 
Dans le cas ci-présent, il ne faut pas détecter la fermeture d'un contact (comme le bouton poussoir) '''mais l'ouverture d'un contact'''.
 +
 +
== Montage ==
 +
Comme pour le bouton poussoir, le montage est élémentaire et utilise une résistance pull-down de 10 KOhms (brun, noir, orange) et une résistance de protection de 100 Ohms (brun, noir, brun).
 +
 +
[[fichier:SPARK-MAGNETIC-SWITCH_bb.jpg|640px]]
 +
 +
Lorsque le contact est fermé (la porte fermée), 3.3V est appliqué sur la broche D4... lorsque la porte est ouverte, le contact reed s'ouvre et la broche D4 est ramenée à la masse par la résistance pull-down.
 
   
 
   
 
== Code ==
 
== Code ==
 
Voici le petit bout de code pour votre Core
 
Voici le petit bout de code pour votre Core
   −
  <nowiki>xxx</nowiki>
+
  <nowiki>// -------------------------------------------------
 +
// Internet Magnetic - Détection d'ouverture de contact Reed
 +
// -------------------------------------------------
 +
//
 +
// Exemple didactique dont le but est:
 +
// 1) De détecter l'ouverture de contact reed (switch magnetic) avec
 +
//    avec déparasitage logiciel.
 +
// 2) Reporte cette information dans une variable "counter" sur Particle Cloud
 +
//    (le nombre d'ouverture) permettant à un autre logiciel comme
 +
//    un SmartPhone de détecter l'événement.
 +
// 3) Reporte le statut actuel du senseur dans la variable "close".
 +
//    Permet de savoir si le contact/porte est fermé.
 +
//    Pratique par exemple pour la cabane de jardin, chambre froide,
 +
//    box du cheval (s'il est de sortie... donc porte ouverte), etc
 +
// 3) Offrir une fonction "reset" sur Particle Cloud permettant
 +
//    a un autre logiciel de remettre le compteur "counter" à zéro.
 +
//    Force la relecture de l'entrée digital et la mise à jour
 +
//    de la variable "open"
 +
//
 +
// Voyez le tutoriel MCHobby
 +
//  http://wiki.mchobby.be/index.php?title=Spark-Core-Switch-Magnetic
 +
// Produit disponible chez MCHobby:
 +
//  http://shop.mchobby.be/product.php?id_product=60
 +
//
 +
// contact magnétique/contact reed branché sur la broche D4
 +
#define btnPin 4
   −
== Montage ==
+
// Créer une variable qui pour stocker la valeur
Comme pour le bouton poussoir, le montage est élémentaire et utilise une résistance pull-down de 10 KOhms (brun, noir, orange) et une résistance de protection de 100 Ohms (brun, noir, brun).
+
// du compteur de pression
 +
int counter = 0;
 +
 
 +
// Créer les variables internes au programme
 +
int contactState; // etat du bouton
 +
 
 +
/* Exécuté une fois au démarrage */
 +
void setup()
 +
{
 +
  // Enregistrer la variable compteur sur Particle Cloud
 +
  Spark.variable("counter", &counter, INT );
 +
  // Publie l'état du contact  dans la variable "close" sur Particle Cloud
 +
  Spark.variable("close", &contactState, INT );
 +
 
 +
  // Enregistrer la fonction "reset compteur" sur Particle Cloud
 +
  Spark.function("reset", resetCounter );
 +
 
 +
  // Active la broche D4 comme entrée
 +
  pinMode(btnPin, INPUT);
 +
  // lecture de l'état initial
 +
  contactState = digitalRead( btnPin );
 +
}
   −
[[fichier:SPARK-MAGNETIC-SWITCH_bb.jpg|640px]]
+
/* la fonction loop() est executée encore et encore */
 +
void loop()
 +
{
 +
  int val, val2; // variable pour stocker la valeur lue sur la broche D4
 +
 
 +
  val = digitalRead( btnPin );
 +
  delay( 10 ); // delai de 10ms pour déparasitage logiciel
 +
  val2 = digitalRead( btnPin );
 +
 
 +
  // si val = val2 --> lecture de l'entrée est consistante
 +
  // l'état de l'entrée est définit avec certitude... ce n'est pas
 +
  // un parasite.
 +
  if( val == val2 ){
 +
     
 +
      // Si le contact a changé d'état? (passe du HIGH->LOW ou de LOW->HIGH)
 +
      if( val != contactState ){
 +
         
 +
          // Si le contact est ouvert
 +
          if( val == LOW ){
 +
             
 +
              counter = counter +1; // incrémenter le compteur
 +
          }
 +
         
 +
          // Se souvenir du nouvel état de l'entrée
 +
          contactState = val;
 +
      }
 +
 
 +
  }
 +
 
 +
}
   −
Lorsque le contact est fermé (la porte fermée), 3.3V est appliqué sur la broche D4... lorsque la porte est ouverte, le contact reed s'ouvre et la broche D4 est ramenée à la masse par la résistance pull-down.
+
// Cette fontion est appelée lorqu'il y a un appel correspondant sur l'API
 +
// Pas de chaine de commande.
 +
// a) Réinitialise le compteur "counter" à zéro.
 +
// b) mise-à-jour de la variable open.
 +
int resetCounter( String command ){
 +
    counter = 0;
 +
   
 +
    // relecture de l'entrée
 +
    contactState = digitalRead( btnPin );
 +
    delay( 10 ); // déparasitage logiciel
 +
    contactState = digitalRead( btnPin );
 +
   
 +
    return 1; // retour de valeur pour l'API
 +
}</nowiki>
    
== Faire un appel d'API avec CURL ==
 
== Faire un appel d'API avec CURL ==
Nous allons maintenant tester notre programme... nous allons donc faire des appels d'API sur Spark Cloud.
+
Nous allons maintenant tester notre programme... nous allons donc faire des appels d'API sur Particle Cloud.
    
Pour rappel, nous avons deux API dans notre programme:
 
Pour rappel, nous avons deux API dans notre programme:
 
* '''counter''' (variable) - permet de savoir combien de fois le contact magnétique à été ouvert.
 
* '''counter''' (variable) - permet de savoir combien de fois le contact magnétique à été ouvert.
* '''reset''' (function) - sans paramètre, permet de réinitialiser le compteur à 0.
+
* '''close''' (variable) - permet de savoir si le contact magnétic est fermé (close=1).
 +
* '''reset''' (function) - sans paramètre, permet de réinitialiser le compteur à 0 mais aussi de reforcer la lecture de l'entrée :-)
    
Dans les exemples Curl ci-dessous, le Core_ID est fixé à 0123456789abcdef et l'Access Token fixé à 123412341234, notre tuto sur la LED internet explique [[Spark-Core-NetLED#Faire_une_requ.C3.AAte_sur_l.27API|comment identifier votre CORE_ID et votre ACCESS TOKEN]].  
 
Dans les exemples Curl ci-dessous, le Core_ID est fixé à 0123456789abcdef et l'Access Token fixé à 123412341234, notre tuto sur la LED internet explique [[Spark-Core-NetLED#Faire_une_requ.C3.AAte_sur_l.27API|comment identifier votre CORE_ID et votre ACCESS TOKEN]].  
Ligne 61 : Ligne 157 :  
   "name": "counter",
 
   "name": "counter",
 
   "result": 5,
 
   "result": 5,
 +
  "coreInfo": {
 +
    "last_app": "",
 +
    "last_heard": "2014-12-31T15:53:55.238Z",
 +
    "connected": true,
 +
    "deviceID": "0123456789abcdef"
 +
  }
 +
}</nowiki>
 +
 +
=== L'état du contact ===
 +
Pour commencer, nous allons récupérer l'état du contact magnétique en utilisant curl (voyez nos précédents tutoriels concernant CURL).
 +
 +
<nowiki>curl -G https://api.spark.io/v1/devices/0123456789abcdef/close -d access_token=123412341234</nowiki>
 +
 +
Ce qui produit le résultat ci-dessous, où vous pouvez constater que le contact est actuellement ouvert (a priori, la porte est ouverte):
 +
 +
<nowiki>{
 +
  "cmd": "VarReturn",
 +
  "name": "close",
 +
  "result": 1,
 
   "coreInfo": {
 
   "coreInfo": {
 
     "last_app": "",
 
     "last_app": "",
Ligne 70 : Ligne 185 :     
=== Réinitialiser le compteur ===
 
=== Réinitialiser le compteur ===
Idéalement votre programme utilisant l'API Spark devrait prendre la valeur du compteur... puis surveiller le changement de cette valeur.
+
Idéalement votre programme utilisant l'API Particle devrait prendre la valeur du compteur... puis surveiller le changement de cette valeur.
    
Si le compteur augmente... c'est que l'on a ouvert le contact (la porte) :-)
 
Si le compteur augmente... c'est que l'on a ouvert le contact (la porte) :-)
Ligne 76 : Ligne 191 :  
Restons pragmatique... cette façon de faire n'est pas forcement confortable.  
 
Restons pragmatique... cette façon de faire n'est pas forcement confortable.  
   −
En conséquence, nous avons ajouté une fonction '''reset''' sur Spark Cloud pour réinitialiser le compteur (ps: j'ai volontairement laissé le paramètre "params", même s'il est vide).
+
En conséquence, nous avons ajouté une fonction '''reset''' sur Particle Cloud pour réinitialiser le compteur (ps: j'ai volontairement laissé le paramètre "params", même s'il est vide).
    
  <nowiki>curl https://api.spark.io/v1/devices/0123456789abcdef/reset -d access_token=123412341234 -d params=</nowiki>  
 
  <nowiki>curl https://api.spark.io/v1/devices/0123456789abcdef/reset -d access_token=123412341234 -d params=</nowiki>  
Ligne 90 : Ligne 205 :  
}</nowiki>
 
}</nowiki>
   −
La valeur 1 est retournée par l'exécution de la fonction sur le Spark... mais le compteur sera bien à zéro!  
+
La valeur 1 est retournée par l'exécution de la fonction sur le Particle... mais le compteur sera bien à zéro!  
 
  −
{{Spark-Core-Hacking-TRAILER}}
      
{{Spark-Core-Hacking-TRAILER}}
 
{{Spark-Core-Hacking-TRAILER}}
29 910

modifications

Menu de navigation