NOTE: Ce guide est en constante évolution. Nous ajoutons constamment du contenu et nous lui apportons des améliorations. S’il vous plaît partager vos commentaires et suggestions pour nous aider à nous améliorer. Nous sommes à votre écoute.
Présentation
Ce guide vous aidera à comprendre comment commencer à utiliser Cayenne et vous donner la liste la plus complète de toutes les fonctionnalités.
Comment Cayenne fonctionne
Cayenne est la première plate-forme de son genre, constructeur de projet IoT drag and drop qui permet aux développeurs de créer et héberger rapidement leurs projets d’objets connectés. Cayenne a été conçu pour l’Internet des objets. Il peut contrôler le matériel à distance, il peut afficher des données de capteurs, il peut stocker des données, analyser et faire beaucoup d’ autres choses cool.
Il y a plusieurs éléments importants dans la plate-forme:
- App Cayenne - configurer et contrôler vos projets IoT avec des widgets drag and drop à partir d’une application mobile.
- Portail en ligne Cayenne - Utilisez un navigateur pour configurer et contrôler vos projets IoT.
- Cayenne Cloud- En charge du traitement et du stockage des données de l’objet, et également en charge de la gestion des commandes utilisateurs, des actions, des déclencheurs et des alertes sur les capteurs.
- Agent Cayenne - permet la communication entre le serveur et le matériel pour la mise en œuvre des commandes entrantes et sortantes, les actions, les déclencheurs et les alertes.
Chaque fois que vous appuyez sur un bouton de l’application Cayenne ou du portail en ligne, l’action est traitée à travers le Cloud de Cayenne et trouve son chemin au matériel correspondant. cela fonctionne également dans le sens opposé. Vous pouvez utiliser l’application mobile de Cayenne ou le portail en ligne, c’est à vous de jouer. Toutes les modifications apportées au matériel via l’application mobile sont reflétées lors de l’affichage du portail en ligne et vice versa.
Caractéristiques :
- Connexion via Ethernet, Wi-Fi et cellulaire (application mobile uniquement)
- Découvrez et configurer un Raspberry Pi sur un réseau (Ethernet ou Wi-Fi uniquement)
- Tableau de bord personnalisable avec glisser-déposer des widgets
- L’accès à distance, redémarrage et l’arrêt d’un Raspberry Pi
- Ajouter et contrôler des capteurs, des actionneurs et des extensions connectés au Raspberry Pi
- Configurer les déclencheurs, les capteurs et les actionneurs pour les Raspberry Pi
- Configurer et recevoir des alertes de seuil via e-mail et sms
- Surveiller les historiques des objets des capteurs
- Tester à distance et configurer le matériel utilisant des commandes GPIO
- Arrive bientôt! Configuration des actions et des commandes récurrentes
Commencer
Ce guide vous aidera à commencer à utiliser Cayenne en quelques minutes. Nous allons couvrir rapidement les
points suivants:
-
Création de votre compte
-
Installation et configuration de Cayenne en utilisant un terminal
-
Configuration de votre premier capteur (Température)
-
Configurez votre premier actionneur (Switch LED)
-
Mise en place d’un déclencheur
Préparer votre Raspberry Pi
-
Allumez votre Raspberry Pi. Branchez l’adaptateur d’alimentation à votre Raspberry Pi.
-
Connectez le Pi à l’Internet. Connectez votre Raspberry Pi à Internet via un câble Ethernet. Ou, si vous avez déjà une configuration avec un dongle Wi-Fi cela fonctionne aussi.
-
Assurez - vous que le système d’exploitation Raspbian est installé. Cayenne fonctionne avec les versions Wheezy and Jessy OS de Raspbian. Assurez vous que un d’ entre eux est pré-installé. Si vous avez besoin d’installer le système d’exploitation Raspbian, cliquez ici.
Remarque: Il n’est pas nécessaire d’apporter des modifications de configuration au Pi. Cayenne gère automatiquement la mise en place et la configuration de votre Pi pour l’ utilisation. Toutefois, il est recommandé que vous augmentez le système de fichiers sur la carte flash si nécessaire. S’il vous plaît se référer à Raspi-config si vous avez besoin d’ informations supplémentaires sur l’ exécution de cette étape.
Création de votre compte
Pour utiliser le tableau de bord en ligne, vous devez d’ abord vous inscrire à un compte gratuit.
Pour commencer à créer votre compte, visitez la page d’inscription Cayenne.
Sur cette page Inscription, entrez votre nom, email et créer un mot de passe.
Votre compte est maintenant créé. Vous pouvez maintenant procéder à l’installation de Cayenne sur vos appareils Raspberry Pi.
Après vérification que votre Raspberry Pi soit allumé et connecté à Internet, cliquez sur Suivant pour lancer le processus d’installation.
Installation et configuration de Cayenne en utilisant un terminal
Avant de pouvoir gérer votre appareil Raspberry Pi en utilisant le portail en ligne, vous devez installer Cayenne sur l’appareil. Les instructions d’installation Cayenne sur votre appareil sont affichés à l’écran.
Suivez les instructions à l’écran pour démarrer le processus d’installation. Si vous avez besoin d’ aide supplémentaire sur cette étape, consultez le Tutorial Video .
Dès que le processus d’installation démarre, l’écran Installation apparaît automatiquement. De là, vous pouvez vérifier la fin du processus d’installation.
Cayenne s’installe sur votre Raspberry Pi en 4 étapes:
Etape 1: Installation des bibliothèques
Étape 2: Installation de l’ agent
Étape 3: Installation du logiciel
Etape 4: Installation des pilotes
Cela peut prendre jusqu’à 10 minutes. S’il vous plaît soyez patient.
Dès que le processus d’installation est terminée, le tableau de bord en ligne apparaîtra automatiquement. Votre Raspberry Pi est maintenant prêt à être utiliser!
Utilisation du glisser déposer sur le portail pour tout contrôler
Après l’ installation de Cayenne, votre Pi apparaît automatiquement dans le portail personnalisable via glisser déposer de Cayenne. Avec Cayenne tout est widget de sorte que vous pouvez changer l’apparence et déplacer les choses dans le look qui vous convient .
Les choses que vous pouvez faire incluent:
- Voir le CPU, la RAM et l’utilisation du stockage.
- L’accès à distance, redémarrage et l’arrêt de votre Pi.
- Configurer le matériel en utilisant des commandes GPIO.
- Configurer les paramètres du Raspberry Pi
- Personnaliser le type et le look du widgets
- Ajouter des materiels tels que des capteurs, des actionneurs(par exemple,des lumières,des moteurs) et les extensions du Raspberry Pi.
- Configurer les déclencheurs pour le Pi, les capteurs et les actionneurs
- Arrive bientôt! Planifier les actions et commandes
Configuration de votre premier capteur
Quelques remarques avant de commencer:
- Assurez-vous que Raspberry Pi est mis hors tension lors du branchement des fils.
- Lors de l’utilisation d’un câble plat GPIO, assurez-vous que le fil d’alimentation (il est une couleur différente de celle des autres) est reliée à l’angle de votre Raspberry Pi et au haut de votre Cobbler Pi.
- Le schéma fourni est juste un exemple de la façon de connecter le capteur. Il existe de nombreuses façons de connecter des capteurs et des extensions, donc essayer ce qui fonctionne le mieux pour vous!
- Quelques maquettes taille réelle de Breadboard (utilisés dans les diagrammes ci-dessous) ont une ligne électrique qui est séparé au milieu. Si tel est le cas, assurez-vous que vos capteurs sont connectés sur la même moitié du Breadboard que votre Cobbler Pi.
Connexion d’un capteur de température
Pour les besoins de ce guide, nous allons utiliser un BMP180 qui est un capteur de pression / température barométrique.
Étape 1: Connectez la puissance 3 volts de votre Cobbler Pi à la ligne d’alimentation de votre breadboard.
Étape 2: Connecter la broche BMP180 VIN à la ligne d’alimentation de votre breadboard.
Étape 3: Connectez la broche de terre(GND) de votre Cobbler Pi à la ligne de masse sur votre Breadboard.
Étape 4: Connecter la broche GND du BMP180 la ligne de masse sur votre Breadboard.
Étape 5: Connectez la broche SCL du BMP180 à la broche SCL du Pi Cobbler
Etape 6: Connecter la broche SDA du BMP180 à la broche SDA du Pi Cobbler
Etape 7: Vérifier doublement le câblage, la puissance du Pi, et ajoutez le capteur BMP180 à votre portail!
Utiliser le portail en ligne pour ajouter votre capteur
Une fois que votre capteur de température est branché et connecté à votre Raspberry Pi, vous pouvez l’ajouter comme un widget à Cayenne. Ajoutons le capteur BMP180 maintenant.
Dans le portail en ligne, recherchez le menu Add new et sélectionnez le périphérique d’ entrée.
Sur l’écran Ajout de périphérique, vous verrez les catégories contenant divers capteurs et périphériques qui peuvent être ajoutés. Cliquez sur la catégorie Température dans la liste des types de périphériques figurant sous Sensors .
Après avoir sélectionné la température, une liste de capteurs de température apparaît. Trouver le capteur BMP180 et cliquer dessus.
Pour ajouter notre nouveau widget du capteur au portail, nous aurons besoin dans un premier temps de renseigner quelques détails.
Nom : Entrez “Température” pour le nom de notre nouveau widget.
Widget : Sélectionnez le widget Valeur d’affichage depuis la liste des types d’affichage du widget.
Icône :. Sélectionnez l’icône du thermomètre dans la liste des icônes
Altitude : Entrez l’altitude actuelle où le dispositif est situé.
Cliquez sur Add Sensor pour terminer l’ajout de votre widget capteur de température. Vous serez alors redirigé vers le portail où vous verrez votre nouveau capteur de température ajouté.
Utilisation du portail pour contrôler votre actionneur
Une fois que votre widget température a été ajouté au portail, Cayenne va commencer à surveiller votre capteur. Vous pourrez vérifier l’état de votre capteur à tout moment en allant sur le portail en ligne.
Le Widget valeur d’ affichage choisi lors de la configuration de notre portail nous permet de voir directement la dernière valeur de température. Cayenne mettra constamment à jour cette valeur dès la reception de nouvelles données de capteur.
Essayons-le! Ouvrez le portail pour que le capteur de température s’affiche puis ** tenir dans votre main le capteur BMP180 **. Dès qu’un changement de température est reçu, la valeur de la température est mise à jour.
Configuration de votre premier actionneur
Quelques remarques avant de commencer:
- Assurez-vous que Raspberry Pi est mis hors tension lors du branchement des fils.
- Lors de l’utilisation d’un câble plat GPIO, assurez-vous que le fil d’alimentation (il est une couleur différente de celle des autres) est reliée à l’angle de votre Raspberry Pi et au haut de votre Cobbler Pi.
- Le schéma fourni est juste un exemple de la façon de connecter le capteur. Il existe de nombreuses façons de connecter des capteurs et des extensions, donc essayer ce qui fonctionne le mieux pour vous!
- Quelques maquettes taille réelle de Breadboard (utilisés dans les diagrammes ci-dessous) ont une ligne électrique qui est séparé au milieu. Si tel est le cas, assurez-vous que vos capteurs sont connectés sur la même moitié du Breadboard que votre Cobbler Pi.
Raccordement de l’actionneur
Pour les besoins de ce guide, nous allons utiliser une lumière LED pour que nous puissions contrôler l’actionneur via le Raspberry Pi comme un interrupteur afin de contrôler directement notre lumière.
Étape 1: Connectez le fil positif LED (le plus long des deux fils) de la résistance à une broche GPIO. Dans cet exemple, 17 GPIO.
Étape 2: Connecter le fil de terre LED (le plus court des deux fils) à la broche GND du Cobbler Pi.
Utiliser le portail en ligne pour ajouter votre actionneur
Une fois que votre LED est câblée et connectée à votre Raspberry Pi, vous pouvez l’ ajouter au portail Cayenne. Ajoutons un interrupteur pour contrôler notre lumière.
Dans le tableau de bord en ligne,recherchez le menu Add new et sélectionnez le périphérique d’ entrée.
Sur l’écran Ajout de périphérique, vous verrez les catégories contenant divers capteurs et périphériques qui peuvent être ajoutés. L’interrupteur que nous voulons ajouter est situé dans la catégorie Actuators.
Puisque nous voulons ajouter un interrupteur de lumière, recherchez le symbole lumière et cliquez dessus pour continuer.
Dans la liste des périphériques lumière qui apparaît, trouver et cliquer l’interrupteur de lumière.
Afin d’ajouter notre nouveau widget interrupteur au portail, nous aurons besoin dans un premier temps de renseigner quelques détails.
Nom : Entrez “Light Switch” pour le nom de notre nouveau widget.
Icône : Sélectionnez l’icône de la Lumière dans la liste d’icônes.
GPIO : Notre LED est directement relié au Raspberry Pi, alors assurez - vous que le GPIO intégré est sélectionné dans la liste GPIO.
Canal : Lors de la mise en place de notre LED au GPIO, la lumière a été câblée au pin 17. Sélectionnez 17 dans la liste des canaux
Inverser Logic : pour commencer nous voulons la lumière soit éteinte, puis allumer à l’activation du bouton, alors assurez - vous que le Invert Logic est réglé sur Non .
Cliquez sur Add sensor pour terminer l’ajout de votre interrupteur. Vous serez alors redirigé vers le portail où vous verrez votre nouveau actionneur ajouté.
Utilisation du portail pour contrôler votre actionneur
Maintenant que notre actionneur d’éclairage a été configuré et ajouté au tableau de bord, nous pouvons utiliser l’interrupteur pour contrôler notre lumière.
Le fait d’avoir créé notre actionneur de lumière comme un bouton, nous pouvons directement l’utiliser pour activer l’état de notre lumière.
Cliquez sur le symbole de l’interrupteur pour allumer la lumière.
Votre interrupteur va maintenant être basculée sur On et la LED sera éteinte. Notez comment l’icône du bouton indique le status mis à jour.
Vous pouvez basculer l’ interrupteur sur Off en cliquant à nouveau sur le symbole. L’icône du bouton est de nouveau mis à jour pour indiquer la mise hors tension.
Configuration de votre premier Triggers (Déclencheurs)
Avec l’utilisation de la fonctionnalité Alerte et Trigger, vous pourrez facilement créer et déclencher des actions sur et entre vos Pis, vos capteurs et actionneurs selon l’état de vos périphériques. Allumez les lumières quand quelqu’un vient à la maison, ou ouvrir les volets lorsque le soleil se lève. Cayenne permet de créer facilement de tels événements en vous guidant à travers ces étapes ci-dessous.
Créons notre premier déclencheur. Nous allons créer un déclencheur pour allumer notre lumière lorsque la température atteint une certaine valeur.
-
Pour créer un déclencheur, ouvrez le la fonction en sélectionnant Alerts and Triggers dans le menu de navigation.
-
Cliquez sur le bouton New Trigger pour créer un nouveau déclencheur.
-
L’écran de création de Trigger apparaît.
Sur cet écran, vous pouvez remplir tous les détails nécessaires à la création de votre trigger. Lors de la création d’un nouveau déclencheur, l’écran vide vous donne un aperçu du processus de création. Pour rendre ce processus facile, vous serez guidé pour créer facilement votre trigger et sélectionner les périphériques et les actions que vous voulez.
Exemple: SI mon périphérique détecte quelque chose, ALORS faire quelque chose en réponse.
-
Commençons par donner notre déclencheur un nom. Entrez “Température élevée, Allumez la lumière” dans le champ Nom du trigger.
-
Nous allons déclencher une action par rapport à notre capteur de température. Le capteur de température est situé sur le Raspberry Pi, alors faites 1 glisser-déposer du Raspberry Pi dans le champs IF.
-
Après avoir sélectionné le capteur de température, nous pouvons choisir si nous voulons déclencher une action si la température est au-dessus ou en-dessous d’une certaine valeur. Nous voulons réagir dans le cas d’une température élevée, nous allons donc sélectionné la température dans la liste et sélectionnez une valeur élevée de température dans les options présentées.
-
L’action que nous voulons initiée est que dès que la température est élevée, allumer notre lumière. Notre lumière est également situé sur le Raspberry Pi, donc faites un glisser-déposer de c epériphérique dans le champ THEN.
-
Nous pouvons maintenant choisir une action à faire sur le Raspberry Pi. Puisque nous voulons allumer la lumière, sélectionnez LightSwitch dans la liste des actions, puis choisissez Activé dans la liste des options disponibles.
-
Nous avons terminé! Cliquez sur Save Trigger pour terminer la configuration et revenir à la liste des Triggers où notre nouveau trigger est affiché.
strong text
-
Cayenne se synchronisera automatiquement le trigger avec le Pi et commencera à surveiller le capteur de température. Quand il atteindra la bonne température votre trigger sera exécuté automatiquement.