Ligne 1 : |
Ligne 1 : |
| {{MCH-Aider}} | | {{MCH-Aider}} |
− |
| |
− | {{traduction}}
| |
| | | |
| == introduction == | | == introduction == |
Ligne 8 : |
Ligne 6 : |
| Nous avons déjà abordé la lecture d'une entrée digitale sur le Core et la publication d'une variable sur le Cloud dans notre tutoriel [[Spark-Core-Bouton|Bouton & Compteur]]. | | Nous avons déjà abordé la lecture d'une entrée digitale sur le Core et la publication d'une variable sur le Cloud dans notre tutoriel [[Spark-Core-Bouton|Bouton & Compteur]]. |
| | | |
− | Nous avons bien entendu complété nos tutoriels avec l'utilisation d'un contact reed/magnétique, lecture de température avec TMP36 ([[Spark.IO-Accueil|voir nos autres tutoriels Spark Core]] dans la page dédiée au Spark Core). | + | Nous avons bien entendu complété nos tutoriels avec l'utilisation d'un contact reed/magnétique, lecture de température avec TMP36 ([[Spark.IO-Accueil|voir nos autres tutoriels Spark Core]] dans la page dédiée au Particle Core). |
| | | |
| === Utiliser un Spark Core avec Raspberry-Pi === | | === Utiliser un Spark Core avec Raspberry-Pi === |
Ligne 15 : |
Ligne 13 : |
| [[Fichier:Spark-Python-Call-00.jpg|800px]] | | [[Fichier:Spark-Python-Call-00.jpg|800px]] |
| | | |
− | De quoi faciliter la réalisation de projet Domotique par les Makers, voici un exemple à base de [http://shop.mchobby.be/product.php?id_product=468 Raspberry-Pi B+] et un [http://shop.mchobby.be/product.php?id_product=549|écran 5 pouce tactile (en HDMI)]. | + | De quoi faciliter la réalisation de projet Domotique par les Makers, voici une idée à base de [http://shop.mchobby.be/product.php?id_product=468 Raspberry-Pi B+] et un [http://shop.mchobby.be/product.php?id_product=549|écran 5 pouce tactile (en HDMI)]. |
| | | |
− | Comme le langage de prédilection sur le Pi est Python, nous nous sommes mis en tête d'écrire une bibliothèque pour faciliter les accès à votre Core par l'intermédiaire de l'API du Spark Cloud. Voila, '''PyCall''' (Python Call) est né. | + | Comme le langage de prédilection sur le Pi est Python, nous nous sommes mis en tête d'écrire une bibliothèque pour faciliter les accès à votre Core par l'intermédiaire de l'API du Particle Cloud. Voila, '''PyCall''' (Python Call) est né. |
| | | |
| == Projet PyCall == | | == Projet PyCall == |
| PyCall est le code Python que nous avons publié sur GitHub. | | PyCall est le code Python que nous avons publié sur GitHub. |
| | | |
− | PyCall, ce sont des exemples utilisant la classe Python '''SparkApi''' pour accéder à l'API de Spark Cloud et la classe '''SparkCore''' pour adresser directement un core. | + | PyCall, ce sont des exemples utilisant la classe Python '''SparkApi''' pour accéder à l'API de Particle Cloud et la classe '''SparkCore''' pour adresser directement un core. |
| | | |
| Voir notre dépôt GitHub: | | Voir notre dépôt GitHub: |
Ligne 30 : |
Ligne 28 : |
| Nous avons bardé le répertoire d'exemple python exploitant les classes et démontrant qu'il est simple de prendre le contrôle de votre Spark Core depuis un Raspberry-Pi (ou n'importe quel OS capable d'exécuter du code Python). | | Nous avons bardé le répertoire d'exemple python exploitant les classes et démontrant qu'il est simple de prendre le contrôle de votre Spark Core depuis un Raspberry-Pi (ou n'importe quel OS capable d'exécuter du code Python). |
| | | |
− | Nous avons également placé une copie des programmes "Arduino/Wiring" utilisés sur le Spark Core... puisque c'est a ces programmes que nos scripts Python vont s'adresser. | + | Nous avons également placé une copie des programmes "Arduino/Wiring" utilisés sur le Particle Core... puisque c'est a ces programmes que nos scripts Python vont s'adresser. |
| | | |
| Nous avons également un script python '''core-tinkering.py''' spécifique pour contrôler le Core avec son programme par défaut (Tinker, celui installé en usine) mais nous y reviendrons plus tard. | | Nous avons également un script python '''core-tinkering.py''' spécifique pour contrôler le Core avec son programme par défaut (Tinker, celui installé en usine) mais nous y reviendrons plus tard. |
Ligne 60 : |
Ligne 58 : |
| * '''magneticswitch.py''' - fait des appels sur un core faisant fonctionner le programme magneticswitch.ino | | * '''magneticswitch.py''' - fait des appels sur un core faisant fonctionner le programme magneticswitch.ino |
| * '''core-info.py''' - Obtenir plus d'information sur un core. Les fonctions et les variables publiées. | | * '''core-info.py''' - Obtenir plus d'information sur un core. Les fonctions et les variables publiées. |
− | * '''core-tinkering.py''' - Comment définir une classe SparkCoreTinker et utiliser ses méthodes pour faciliter les appel sur l'API publié par le Spark Core. Exemple basé sur Tinker de SPARK :-) Vous pouvez donc contrôler directement Tinker depuis Python :-) | + | * '''core-tinkering.py''' - Comment définir une classe SparkCoreTinker et utiliser ses méthodes pour faciliter les appel sur l'API publié par le Particle Core. Exemple basé sur Tinker de PARTICLE :-) Vous pouvez donc contrôler directement Tinker depuis Python :-) |
| | | |
− | Les scripts plus orienté vers la gestion du compte Spark Core | + | Les scripts plus orienté vers la gestion du compte Particle Core |
− | * '''cores-list.py''' - Lister les Cores associé à votre compte Spark Cloud | + | * <font color="green">'''sparkapi-inifile-tls.py'''</font> Outils d'aide: collecte les infos pour sparkapi.ini |
− | * '''access-tokens-list.py''' - S'adresse à l' API pour lister tous les access token liés à votre compte Spark Cloud. | + | * '''cores-list.py''' - Lister les Cores associé à votre compte Particle Cloud |
− | * '''access-token-create.py''' - Crée/ajoute un access_token lié à votre compte Spark Cloud. Utilise le client_id 'xytest' | + | * '''access-tokens-list.py''' - S'adresse à l' API pour lister tous les access token liés à votre compte Particle Cloud. |
− | * '''access-token-delete.py''' - efface les access_token client_id 'xytest' lié à votre compte Spark Cloud. Note: Ne sais pas effacer la dernière entrée créée! | + | * '''access-token-create.py''' - Crée/ajoute un access_token lié à votre compte Particle Cloud. Utilise le client_id 'xytest' |
| + | * '''access-token-delete.py''' - efface les access_token client_id 'xytest' lié à votre compte Particle Cloud. Note: Ne sais pas effacer la dernière entrée créée! |
| | | |
| === SparkApi.ini === | | === SparkApi.ini === |
− | Pour vous connecter sur l'API du Spark Cloud, vous avez besoin d'un access_token. Et pour vous connecter sur votre Core, vous aurez besoin de son Core ID. | + | Pour vous connecter sur l'API du Particle Cloud, vous avez besoin d'un access_token. Et pour vous connecter sur votre Core, vous aurez besoin de son Core ID. |
| | | |
| Plutôt que de hardcoder ces valeurs ([http://shop.mchobby.be celles de MCHobby]) dans les exemples et les programmes, j'ai opté pour un fichier de configuration (SparkApi.ini) dans lequel vous devrez placer les valeurs adéquates (les vôtres bien entendu). | | Plutôt que de hardcoder ces valeurs ([http://shop.mchobby.be celles de MCHobby]) dans les exemples et les programmes, j'ai opté pour un fichier de configuration (SparkApi.ini) dans lequel vous devrez placer les valeurs adéquates (les vôtres bien entendu). |
Ligne 76 : |
Ligne 75 : |
| | | |
| Bien entendu, Je n'ai pas publié mon fichier SparkApi.ini. | | Bien entendu, Je n'ai pas publié mon fichier SparkApi.ini. |
− | Vous devez donc créer ce fichier SparkApi.ini à partir de sparkapi-sample.ini (disponibles dans les sources) et y encoder les paramètres de votre PROPRE compte Spark Cloud et le CORE_ID de votre propre Spark Core. | + | Vous devez donc créer ce fichier SparkApi.ini à partir de sparkapi-sample.ini (disponibles dans les sources) et y encoder les paramètres de votre PROPRE compte Spark Cloud et le CORE_ID de votre propre Particle Core. |
| | | |
| + | Voici une copie du fichier sparkapi-sample.ini, il reprend les informations nécessaires pour trouver votre access_token et core_id. |
| | | |
− | Voici une copie du fichier sparkapi-sample.ini
| + | {{ambox|text=Nous avons également créé le script [https://github.com/mchobby/SparkCoreTuto/blob/master/PyCall/sparkapi-inifile-tls.py sparkapi-inifile-tls.py] qui se connecte sur votre compte Particle pour y collecter l'access_token et les core_id disponibles}} |
| | | |
| <nowiki># Copiez le contenu de ce fichier dans sparkapi.ini et | | <nowiki># Copiez le contenu de ce fichier dans sparkapi.ini et |
| # adaptez les valeur access_token et core0 en fonction de votre propre | | # adaptez les valeur access_token et core0 en fonction de votre propre |
− | # compte Spark Cloud :-) | + | # compte Particle Cloud :-) |
| | | |
| [SPARK-API] | | [SPARK-API] |
− | # votre access token lié à votre compte Spark Cloud voir notre tuto | + | # votre access token lié à votre compte Particle Cloud voir notre tuto |
| # http://wiki.mchobby.be/index.php?title=Spark-Core-NetLED#Faire_une_requ.C3.AAte_sur_l.27API | | # http://wiki.mchobby.be/index.php?title=Spark-Core-NetLED#Faire_une_requ.C3.AAte_sur_l.27API |
| # pour identifier votre core_id et access_token | | # pour identifier votre core_id et access_token |
Ligne 92 : |
Ligne 92 : |
| | | |
| [CORES] | | [CORES] |
− | # Liste de un ou plusieurs de vos spark cores ici | + | # Liste de un ou plusieurs de vos particle cores ici |
− | # Vos cores sont lié à votre compte Spark Cloud (et donc votre access_token). | + | # Vos cores sont lié à votre compte Particle Cloud (et donc votre access_token). |
| # Voyez notre tuto pour identifier les core_id | | # Voyez notre tuto pour identifier les core_id |
| # http://wiki.mchobby.be/index.php?title=Spark-Core-NetLED#Faire_une_requ.C3.AAte_sur_l.27API | | # http://wiki.mchobby.be/index.php?title=Spark-Core-NetLED#Faire_une_requ.C3.AAte_sur_l.27API |
Ligne 126 : |
Ligne 126 : |
| [[Fichier:SPARK-BUTTON-00.jpg|320px]]<small><br />Voyez notre tutoriel [[Spark-Core-Bouton|Bouton & Compteur]] pour programmer votre Core</small> | | [[Fichier:SPARK-BUTTON-00.jpg|320px]]<small><br />Voyez notre tutoriel [[Spark-Core-Bouton|Bouton & Compteur]] pour programmer votre Core</small> |
| | | |
− | Le script buttoncounter.py permet d'accéder à la variable "counter" et la fonction "reset" publié le core (''buttoncounter.ino'') sur Spark Cloud. | + | Le script buttoncounter.py permet d'accéder à la variable "counter" et la fonction "reset" publié le core (''buttoncounter.ino'') sur Particle Cloud. |
| | | |
| Le [https://github.com/mchobby/SparkCoreTuto/blob/master/PyCall/buttoncounter.py script dans le dépôt] est très abondamment (trop) documenté pour faciliter la prise en main. Je vais donc en proposer une version allégée pour se concentrer sur l'essentiel. | | Le [https://github.com/mchobby/SparkCoreTuto/blob/master/PyCall/buttoncounter.py script dans le dépôt] est très abondamment (trop) documenté pour faciliter la prise en main. Je vais donc en proposer une version allégée pour se concentrer sur l'essentiel. |
Ligne 142 : |
Ligne 142 : |
| http://wiki.mchobby.be/index.php?title=Spark-Core-Bouton | | http://wiki.mchobby.be/index.php?title=Spark-Core-Bouton |
| | | |
− | Ou acheter Spark Core -- et soutenir nos travaux -- | + | Ou acheter Particle Core -- et soutenir nos travaux -- |
| http://shop.mchobby.be/category.php?id_category=54 | | http://shop.mchobby.be/category.php?id_category=54 |
| """ | | """ |
Ligne 168 : |
Ligne 168 : |
| | | |
| | | |
− | # Appeler la fonction "reset" publier sur Spark Cloud | + | # Appeler la fonction "reset" publier sur Particle Cloud |
| result = core.call( 'reset' ) | | result = core.call( 'reset' ) |
| if( result[0] == False ): | | if( result[0] == False ): |
Ligne 193 : |
Ligne 193 : |
| Si tinker n'est plus installé sur votre Core, vous pouvez le réinstaller: | | Si tinker n'est plus installé sur votre Core, vous pouvez le réinstaller: |
| * [[Spark.IO-Démarrer#les_boutons|En faisant un reset d'usine de votre Core]] | | * [[Spark.IO-Démarrer#les_boutons|En faisant un reset d'usine de votre Core]] |
− | * [[Spark.IO-CLI-BlinkLed|En utilisant la commande "spark flash nom_du_core tinker" dans Spark CLI]] | + | * [[Spark.IO-CLI-BlinkLed|En utilisant la commande "spark flash nom_du_core tinker" dans Particle CLI]] |
| * [http://docs.spark.io/tinker/#tinkering-with-tinker-the-tinker-firmware En suivant ces instructions] (''spark.io, anglais'') | | * [http://docs.spark.io/tinker/#tinkering-with-tinker-the-tinker-firmware En suivant ces instructions] (''spark.io, anglais'') |
| | | |
Ligne 212 : |
Ligne 212 : |
| # | | # |
| """core-tinkering.py | | """core-tinkering.py |
| + | Version épurée du script. Merci de vous rapporter à la version |
| + | GitHub pour les infos et licence applicable. |
| + | https://github.com/mchobby/SparkCoreTuto/blob/master/PyCall/core-tinkering.py |
| | | |
− | Appel d'API sur un Spark Core faisant fonctionner le programme | + | Appel d'API sur un Particle Core faisant fonctionner le programme tinker. |
− | tinker.
| |
| | | |
− | Permet d'utiliser les fonctions exposées par tinker. | + | Voir tutoriel: |
− | Permet de voir comment instancier une class dérivée de SparkCore et
| + | http://wiki.mchobby.be/index.php?title=Spark-Python-Call |
− | comment y implenter des fonctionnalités spécialisées.
| |
− | | |
− | Copyright 2015 DMeurisse <info@mchobby.be>
| |
− | | |
− | Voir tutoriel: | |
− | http://wiki.mchobby.be/index.php?title=Spark-Core-Bouton
| |
| | | |
− | Ou acheter Spark Core -- et soutenir nos travaux -- | + | Ou acheter Particle Core -- et soutenir nos travaux -- |
| | | |
| http://shop.mchobby.be/category.php?id_category=54 | | http://shop.mchobby.be/category.php?id_category=54 |
− |
| |
− | This program is free software; you can redistribute it and/or modify
| |
− | it under the terms of the GNU General Public License as published by
| |
− | the Free Software Foundation; either version 2 of the License, or
| |
− | (at your option) any later version.
| |
− |
| |
− | This program is distributed in the hope that it will be useful,
| |
− | but WITHOUT ANY WARRANTY; without even the implied warranty of
| |
− | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
| |
− | GNU General Public License for more details.
| |
− |
| |
− | You should have received a copy of the GNU General Public License
| |
− | along with this program; if not, write to the Free Software
| |
− | Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
| |
− | MA 02110-1301, USA.
| |
− |
| |
− | ------------------------------------------------------------------------
| |
− | History:
| |
− | 02 jan 2015 - Dominique - v 0.1 (première release)
| |
| """ | | """ |
| from sparkapi.sparkapi import SparkApi | | from sparkapi.sparkapi import SparkApi |
Ligne 253 : |
Ligne 230 : |
| import time | | import time |
| | | |
− | # Ouvre le fichier sparkapi.ini pour éviter de Hard Coder des données | + | # Ouvre le fichier sparkapi.ini |
− | # sensible comme l'access_token dans les programmes d'exemple publié sur
| |
− | # le Net.
| |
− | #
| |
− | # Créez votre propre fichier sparkapi.ini à partir du fichier
| |
− | # sparkapi-sample.ini
| |
| config = Config() | | config = Config() |
− |
| |
| | | |
| def main(): | | def main(): |
− | # Execute le programme qui récupère le nombre de pression sur
| |
− | # le Spark Core.
| |
| api = SparkApi( access_token = config.access_token, debug = False ) | | api = SparkApi( access_token = config.access_token, debug = False ) |
− | # ou utiliser directement votre access_token
| |
− | #api = SparkApi( access_token = '123412341234', debug = False )
| |
| | | |
− | # Créer un objet Core SPECIFIQUE à partir du core_id | + | # Créer un objet SparkCoreTinker pour un core_id donné |
− | # le core_id provient du fichier de configuration sparkapi.ini
| |
− | # dans la section [CORES]
| |
| core = api.get_core_by_class( config.cores['core0'], SparkCoreTinker ) | | core = api.get_core_by_class( config.cores['core0'], SparkCoreTinker ) |
− | # ou utiliser directement votre core_id
| |
− | #core = api.get_core_by_class( '0123456789abcdef', SparkCoreTinker )
| |
| | | |
| print( '--- Utilisation de la classe SparkCoreTinker ---' ) | | print( '--- Utilisation de la classe SparkCoreTinker ---' ) |
Ligne 295 : |
Ligne 258 : |
| # eteindre la broche D0 | | # eteindre la broche D0 |
| print( 'Extinction D0. digitalwrite D0 LOW = %i' % core.digitalwrite( 'D0', False ) ) | | print( 'Extinction D0. digitalwrite D0 LOW = %i' % core.digitalwrite( 'D0', False ) ) |
− |
| + | |
− | print( '--- appeler directement les fonctions Tinker ---' )
| |
− | # Faire une lecture en appelant directement la fonction d'API
| |
− | # "digitalread" de Tinker sur le Spark Core
| |
− | # retourne un tuple (connected, resultat_de_la_fonction)
| |
− | value = core.call( 'digitalread', 'D4' )
| |
− | print( 'le Core n est pas connecté' if value[0] == False else 'la fonction digitalread à répondu = %i' % value[1] )
| |
− | time.sleep( 2 )
| |
− |
| |
| return 0 | | return 0 |
| | | |
Ligne 309 : |
Ligne 264 : |
| main() | | main() |
| </nowiki> | | </nowiki> |
| + | |
| + | Code assez lisible n'est-ce pas. |
| + | Il produit le résultat suivant: |
| + | |
| + | [[Fichier:Spark-Python-Call-30.jpg]] |
| | | |
| {{Spark-Python-Call-TRAILER}} | | {{Spark-Python-Call-TRAILER}} |