29 922
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 5 :
Ligne 5 : − + − + − + − + − Send the source code file as "file" in request body.</nowiki>+ − The API request should be encoded as multipart/form-data with a file field populated. Your filename does not matter. In particular, the extension can be .c, .cpp, .ino, or anything else your prefer.+ − This API request will submit your firmware to be compiled into a Spark binary, after which, if compilation was successful, the binary will be flashed to your Core wirelessly.+ − + − + − There are three possible response formats:+ − + − + − + − + − + Ligne 37 :
Ligne 37 : − + Ligne 44 :
Ligne 44 : − +
Spark-Could-API-FirmwareCheckAndFlash (voir la source)
Version du 16 janvier 2015 à 16:12
, 16 janvier 2015 à 16:12aucun résumé de modification
== Vérifier et flasher un nouveau Firmware ==
== Vérifier et flasher un nouveau Firmware ==
{{bloc-etroit|text=All your Spark firmware coding can happen entirely in the build section of the website. However, if you prefer to use your own text editor or IDE, you can! It just means that instead of hitting the "Flash" or "Verify" buttons, you'll make API calls that reference a file.}}
{{bloc-etroit|text=Vous pouvez réaliser le coding et la mise-à-jour de vos firmware directement dans Spark Build. Cependant, vous pouvez également utiliser votre propre éditeur de texte ou IDE! Cela signifie que vous voulez Flasher ou Verifier votre code alors vous devrez faire un appel d'API qui référence ce fichier.}}
== Flasher un Core avec du Code Source ==
== Flasher un Core avec du Code Source ==
{{bloc-etroit|text=If you have written a source code file that defines setup() and loop() functions, you can flash it to your Spark Core with an HTTP PUT request.}}
{{bloc-etroit|text=Si vous avez écrit un fichier contenant du code source contenant une fonction setup() et loop(), vous pouvez le flasher sur votre Core avec une requête HTTP PUT.}}
<nowiki># HTTP REQUEST DEFINITION
<nowiki># DEFINITION DE LA REQUETE HTTP
PUT /v1/devices/{DEVICE_ID}
PUT /v1/devices/{CORE_ID}
Content-Type: multipart/form-data
Content-Type: multipart/form-data
Envoyer le fichier code source en tant que "fichier" dans le corps de la requête.</nowiki>
La requête d'API devrait être encodée en tant que multipart/form-data avec un champ 'file' remplit. Le nom du fichier n'a aucune important. En particulier l'extension peut être .c, .cpp, .ino, ou n'importe quoi d'autre si vous préférez.
Cette requête d'API soumettra votre firmware au compilateur pour générer un binaire Spark, après quoi, si la compilation est réussie, le binaire sera flashé sur votre Core via la connexion WiFi.
<nowiki># EXAMPLE REQUEST IN TERMINAL
<nowiki># EXEMPLE DE REQUETE DANS UN TERMINAL
# Flash a Core with a file called "my-firmware-app.cpp"
# Flasher un Core avec un fichier qui s'appelle "my-firmware-app.cpp"
curl -X PUT -F file=@my-firmware-app.cpp \
curl -X PUT -F file=@my-firmware-app.cpp \
"https://api.spark.io/v1/devices/0123456789abcdef01234567?access_token=1234123412341234123412341234123412341234"</nowiki>
"https://api.spark.io/v1/devices/0123456789abcdef01234567?access_token=1234123412341234123412341234123412341234"</nowiki>
Il y a trois formats de réponse possible:
* A successful response, in which both compilation and flashing succeed.
* Une réponse positive (succès) dans laquelle la compilation et le flashage ont réussit.
** Note that the LED on your Core will blink magenta while updating.
** Notez que la LED de votre Core va clignoter en magenta pendant la mise-à-jour.
* A failure due to compilation errors.
* Un échec causé par une erreur de compilation.
* A failure due to inability to transmit the binary to the core.
* Un échec causé par l'impossibilité de transmettre le binaire sur le Core.
<nowiki>// EXAMPLE SUCCESSFUL RESPONSE
<nowiki>// EXEMPLE DE REPONSE POSITIVE (SUCCES)
{
{
"ok": true,
"ok": true,
}
}
// EXAMPLE COMPILE FAILURE RESPONSE
// EXEMPLE DE REPONSE AVEC ERREUR DE COMPILATION
{
{
"ok": false,
"ok": false,
}
}
// EXAMPLE FLASH FAILURE RESPONSE
// EXEMPLE DE REPONSE AVEC ERREUR DE FLASH
{
{
"ok": false,
"ok": false,