29 917
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − − {{traduction}} Ligne 48 :
Ligne 46 : − + − + Ligne 125 :
Ligne 123 : − + + Ligne 132 :
Ligne 131 : − + − + + + − Calls a function on one of your cores, use <code>spark list</code> to see which cores are online, and what functions are available.+ − + − Retrieves a variable value from one of your cores, use <code>spark list</code> to see which cores are online, and what variables are available.+ − + − Pulls the value of a variable at a set interval, and optionally display a timestamp+ + + − + − + − + − + + + + + + + − Retrieves your core id when the core is connected via USB and in listening mode (flashing blue).+ − + − + Ligne 177 :
Ligne 186 : − Subscribes to published events on the cloud, and pipes them to the console. Special core name "mine" will subscribe to events from just your cores.+ − + + + + Ligne 185 :
Ligne 197 : + + + + + + + + + + + + + + + + − Shows currently connected Spark Core's acting as serial devices over USB+ − + − Starts listening to the specified serial device, and echoes to the terminal+ − + + +
Spark.IO-CLI-CommandReference (voir la source)
Version du 28 décembre 2014 à 13:17
, 28 décembre 2014 à 13:17aucun résumé de modification
{{Spark.IO-CLI-NAV}}
{{Spark.IO-CLI-NAV}}
== Introduction ==
== Introduction ==
=== spark core rename ===
=== spark core rename ===
Assigner un nouveau nom à un Core déja associé.
Assigner un nouveau nom à un Core déja associé au compte Spark Cloud.
<nowiki># Comment Changer ne nom de votre core
<nowiki># Comment renommer votre core
$ spark core rename 0123456789ABCDEFGHI "pirate frosting"</nowiki>
$ spark core rename 0123456789ABCDEFGHI "pirate frosting"</nowiki>
library1.cpp</nowiki>
library1.cpp</nowiki>
=== example spark.ignore ===
=== Exemple de spark.ignore ===
spark.ignore est un fichier texte standard avec une ligne par fichier à exclure. Le CLI l'utiliseras pour essayer de déterminer les fichier à exclure/ignorer lorsque vous compilerez votre application.
<nowiki># spark.ignore
<nowiki># spark.ignore
old_version.cpp</nowiki>
old_version.cpp</nowiki>
=== Compiling one or more source files ===
=== Compiler un ou plusieurs fichiers ===
<nowiki># how to compile a list of source files
<nowiki># Comment compiler une liste de fichier source
$ spark compile app.ino library1.cpp library1.h</nowiki>
$ spark compile app.ino library1.cpp library1.h</nowiki>
== Appels ==
== Appels ==
L'un des plus grands intérêts de l'infrastructure Spark Cloud est de pouvoir appeler des fonctions sur votre Core ou obtenir la valeur de certaines variables publiées sur Spark Cloud.
=== spark call ===
=== spark call ===
Appel d'une fonction sur l'un de vos Cores (''to call'' signifie ''appeler''), utilisez <code>spark list</code> pour identifier les cores qui sont en ligne et les fonctions disponibles.
<nowiki># how to call a function on your core
<nowiki># Comment appeler une fonction sur votre Core
$ spark call 0123456789ABCDEFGHI digitalWrite "D7,HIGH"
$ spark call 0123456789ABCDEFGHI digitalWrite "D7,HIGH"
1</nowiki>
1</nowiki>
=== spark get ===
=== spark get ===
Retrouver ka valeur d'une variable d'un de vos Cores, utilisez <code>spark list</code> pour identifier les cores qui sont en ligne et les fonctions disponibles.
<nowiki># how to get a variable value from a core
<nowiki># Comment obtenir une variable depuis un Core
$ spark get 0123456789ABCDEFGHI temperature
$ spark get 0123456789ABCDEFGHI temperature
72.1</nowiki>
72.1</nowiki>
=== spark monitor ===
=== spark monitor ===
Entasser les différentes valeurs d'une variable à intervalle déterminé et optionnellement afficher le [http://fr.wikipedia.org/wiki/Horodatage timestamp] (''timestamp: une valeur d'horodatage, wikipedia, français'').
'''Le monitoring permet d'interroger un ou plusieurs cores'''.
* Minimum delay for now is 500 (there is a check anyway if you keyed anything less)
* Le délai minimum est 500 (le CLI vérifie la valeur encodée et rectifie si nécessaire)
* hitting CTRL + C in the console will exit the monitoring
* Pressez CTRL + C dans la console pour pour sortie du monitoring
<nowiki># how to poll for a variable value from one or more cores continuously
<nowiki># Comment interroger la valeur d'une variable d'un ou plusieurs Cores continuellement
$ spark monitor 0123456789ABCDEFGHI temperature 5000
$ spark monitor 0123456789ABCDEFGHI temperature 5000
$ spark monitor 0123456789ABCDEFGHI temperature 5000 --time
$ spark monitor 0123456789ABCDEFGHI temperature 5000 --time
$ spark monitor all temperature 5000
$ spark monitor all temperature 5000
$ spark monitor all temperature 5000 --time
$ spark monitor all temperature 5000 --time
$ spark monitor all temperature 5000 --time > my_temperatures.csv</nowiki>
$ spark monitor all temperature 5000 --time > mes_temperatures.csv</nowiki>
Notes:
* l'option '''--time''' ajoute le timestamp dans le résultat du monitoring.
* l'option '''all''' permet d'interroger tous les Cores enregistré dans le compte (tout ceux visible dans "spark list").
* l'option '''5000''' est le délai de mise-à-jour en millisecondes (donc 5 secondes)
* l'option '''> mes_temperatures.csv''' permet de rediriger les informations vers un [http://fr.wikipedia.org/wiki/Comma-separated_values fichier csv] (''comma separated value, wikipedia, français'') supporté par tous les tableurs.
== Outils ==
== Outils ==
=== spark identify ===
=== spark identify ===
Permet d'obtenir le CORE ID lorsqu'il est connecté via USB et en mode ''listening'' (flash en bleu).
<nowiki># helps get your core id via usb and serial
<nowiki># Permet d'obtenir le CORE ID via USB et port série
# make sure your core is connected and blinking blue
# Assurez vous que le Core est connecté et clignote en bleu
$ spark identify
$ spark identify
$ spark identify 1
$ spark identify 1
=== spark subscribe ===
=== spark subscribe ===
Souscrire à un événement publié sur le Cloud et l'envoyer (''pipe'') vers la console. Le nom de Core spécial "mine" (''le mien'') va souscrire aux événements de vos cores.
<nowiki># opens a connection to the API so you can stream events coming from your cores
Si vous connaissez le nom de l'événement qui vous intéresse, vous pouvez le spécifier à l'emplacement 'eventName' (qui signifie littéralement ''nom de l'événement'')
<nowiki># Ouvrir une connexion sur l'API pour surveiller le flux des événements provenant de vos cores
$ spark subscribe
$ spark subscribe
$ spark subscribe mine
$ spark subscribe mine
$ spark subscribe eventName CoreName
$ spark subscribe eventName CoreName
$ spark subscribe eventName 0123456789ABCDEFGHI</nowiki>
$ spark subscribe eventName 0123456789ABCDEFGHI</nowiki>
{{underline|Exemple:}}
Dans cet exemple, nous saisissons la commande:
<nowiki>spark subscribe mine</nowiki>
Puis nous faisons un Reset de notre Core en pressant le bouton "reset".... voici ce que nous obtenons en retour dans la console
<nowiki>$ spark subscribe mine
Subscribing to all events from my personal stream (my cores only)
Listening to: /v1/devices/events
{"name":"spark/status","data":"online","ttl":"60","published_at":"2014-12-28T12:55:54.116Z","coreid":"54xxxxxxxxxxxxxxxxxxxx67"}
{"name":"spark/cc3000-patch-version","data":"1.29","ttl":"60","published_at":"2014-12-28T12:55:54.242Z","coreid":"54xxxxxxxxxxxxxxxxxxxx67"}</nowiki>
Vous noterez la structure des informations (format JSON) contenant par ailleurs le nom de l'événement (voyez l'élément ''name'') ainsi que l'identification du core (voyez l'élément ''coreid'').
=== spark serial list ===
=== spark serial list ===
Affiche le Spark Core actuellement connecté comme périphérique série via USB
<nowiki># shows a list of cores connected via serial usb
<nowiki># Affiche une liste des Cores connectés via USB Série
$ spark serial list</nowiki>
$ spark serial list</nowiki>
=== spark serial monitor ===
=== spark serial monitor ===
Commence l'écoute du périphérique série spécifié et renvoie les informations sur le terminal (Faire un ''écho'' sur le terminal)
<nowiki># opens a read-only serial monitor for a particular core
<nowiki># Ouvrir un moniteur série en lecture seule pour un Core spécifique
$ spark serial monitor
$ spark serial monitor
$ spark serial monitor 1
$ spark serial monitor 1
# Windows affiche le port série comme un COMx
$ spark serial monitor COM3
$ spark serial monitor COM3
# Sous Mac, le port série est affiché comme un /dev/
$ spark serial monitor /dev/cu.usbmodem12345</nowiki>
$ spark serial monitor /dev/cu.usbmodem12345</nowiki>