Main Content

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version en anglais.

Application TimeControl

L'application TimeControl fonctionne avec d'autres applications ThingSpeak™ : MATLAB Analysis, ThingHTTP, ThingTweet, ou TalkBack pour effectuer une action à un moment précis ou sur un horaire régulier. Vous pouvez utiliser TimeControl avec :

  • ThingHTTP pour communiquer avec des appareils, des sites Web ou des services Web.

  • MATLAB® Analyse pour agir sur vos données.

  • ThingTweet pour envoyer des alertes via Twitter®.

  • Talkback pour mettre en file d'attente les commandes d'un appareil.

Par exemple, vous pouvez effectuer une requête ThingHTTP qui appelle quelqu'un via Twilio®, contrôle un appareil ou se connecte à un thermostat qui accepte les requêtes HTTP.

Remarque

Le nombre de TimeControls est limité à 12 par utilisateur.

Planifier des actions avec TimeControl

  1. Connectez-vous à ThingSpeak.

  2. Sélectionnez Apps > TimeControl.

  3. Cliquez sur New TimeControl.

  4. Modifier les paramètres TimeControl :

    • Name : Entrez un nom unique pour ce TimeControl.

    • Time Zone : Le fuseau horaire est basé sur les paramètres de votre compte. Pour modifier le fuseau horaire de votre profil, cliquez sur Modifier.

    • Frequency : Choisissez si TimeControl s'exécute une fois ou à intervalles réguliers.

      Remarque

      Les utilisateurs disposant d'une licence gratuite doivent se connecter à ThingSpeak au moins une fois tous les 60 jours pour que les contrôles de temps récurrents restent actifs.

    • Recurrence : Choisissez un modèle de récurrence.

      • Week : Chaque jour de la semaine spécifié.

      • Day : À une heure précise tous les jours.

      • Hour : À un intervalle horaire spécifié. Vous ne pouvez pas spécifier l'heure de début de votre TimeControl lorsque la récurrence est définie sur Hour.

      • Minute : À un intervalle de minutes spécifié. Vous ne pouvez pas spécifier l'heure de début de votre TimeControl lorsque la récurrence est définie sur Minute.

    • Time : Entrez l'heure à laquelle TimeControl s'exécute. Pour la récurrence Hour et Minute, ThingSpeak planifie automatiquement votre TimeControl . L'heure de début est reprogrammée chaque fois que vous modifiez votre TimeControl. Assurez-vous de vérifier l'heure et la date de début après avoir enregistré votre TimeControl.

    • Fuzzy Time : Sélectionnez le nombre de minutes autour d'une heure planifiée pour l'exécution de TimeControl . L'intervalle de base doit être d'au moins 12 minutes pour un temps flou de 5 minutes et d'au moins 30 minutes pour un temps flou de 10 minutes.

    • Action : Sélectionnez l'action à déclencher lorsque les paramètres spécifiés sont remplis.

      • MATLAB Analysis : Exécutez le code planifié.

      • ThingHTTP : Connectez-vous à un serveur Web et lisez ou écrivez des données.

      • ThingTweet : Tweetez sur un compte Twitter spécifié.

      • TalkBack : Mettez en file d'attente les commandes à envoyer à votre appareil.

Exécuter un TimeControl

Les serveurs ThingSpeak exécutent automatiquement un TimeControl à l'heure spécifiée, en fonction de votre fuseau horaire. Assurez-vous que votre fuseau horaire est correctement spécifié dans votre ThingSpeak profile. Gardez à l'esprit que plusieurs TimeControls qui déclenchent l'écriture sur le même canal doivent toujours respecter les limites de mise à jour des messages.

Conseil

TimeControl fonctionne selon un cycle strict de 24 heures. Modifiez votre TimeControl pour tenir compte des changements d'heure d'été.

Clés de rechange

Vous pouvez transmettre des données à vos applications à l'aide de clés de remplacement. Le tableau suivant récapitule les clés de remplacement standard et personnalisées que vous pouvez utiliser. Certaines clés sont spécifiques à un type particulier de requête, comme indiqué dans la dernière colonne.

CléDescriptionExempleUtiliser avec
%%YOUR_CUSTOM_LABEL%%ThingHTTP remplace cette valeur de remplacement personnalisée par des données dans la requête déclencheur portant le libellé "YOUR_CUSTOM_LABEL".field1=%%YOUR_CUSTOM_LABEL%%Données POST : YOUR_CUSTOM_LABEL=1234.RESULTAT : field1=1234.N'importe quelle requête
%%channel_CHANNEL_ID_field_FIELD_NUMBER%%La dernière valeur du canal et du champ spécifiés. Les requêtes de remplacement vers des canaux privés n'appartenant pas au même utilisateur que la requête ThingHTTP renvoient des valeurs vides.The latest value is %%channel_12_field_1%%.RESULTAT : The latest value is 2.5.N'importe quelle requête
%%datetime%%La date et l'heure complètes d'exécution de TimeControl ou React.The date and time the event occurred is %%datetime%%.RESULTAT : The date and time the event occurred is 24/09/2014 17h32.TimeControl ou React
%%day%%Le nom du jour de la semaine où TimeControl a été exécuté.The day the event occurred is %%jour%%.RESULTAT : The day the event occurred is Mercredi.TimeControl
%%day_index%% L'indice de base zéro du jour de la semaine commençant le dimanche.The number of days used this week is %%day_index%%.RESULTAT : The number of days used this week is 3.TimeControl
%%hour%%L'heure de la journée à laquelle TimeControl s'est exécuté.The hour that the event occurred is %%heure%%.RESULTAT : The hour that the event occurred is 5.TimeControl
%%minute%%La minute de l'heure d'exécution du TimeControl .The minute the event occurred is %%minute%%.RESULTAT : The minute the event occurred is 30.TimeControl
%%trigger%%La valeur qui a déclenché React.It is way too hot in here at %%trigger%% C.RESULTAT : It is way too hot in here at 40 C.React
%%channel_id%%L'ID du canal qui a déclenché React.The channel that tweets is %%channel_id%%.RESULTAT : The channel that tweets is 1256.React

Mettre à jour l'état du canal à l'aide de ThingHTTP

Cet exemple montre comment mettre à jour un canal ThingSpeak "field1". Un TimeControl déclenche une requête ThingHTTP pour mettre à jour les données du canal à une heure spécifiée avec un message d'état et un horodatage.

Créer une requête ThingHTTP

Dans ThingHTTP, saisissez le nom ThingSpeak Channel Updater avec ces paramètres :

  • URL : https://api.thingspeak.com/update

  • Method : POST

  • Body : 

    api_key=THINGSPEAK_WRITE_KEY&field1=TimeControl%20test&status=Executed at %%time%%.

Créer un TimeControl

Nommez le TimeControl et entrez ces paramètres :

  • Cochez la case One Time.

  • Sélectionnez le jour actuel.

  • Sélectionnez une heure et une minute dans un futur proche.

  • Sélectionnez ThingHTTP comme action.

  • Dans le champ then perform ThingHTTP, sélectionnez le ThingHTTP que vous avez créé pour déclencher ce TimeControl.

  • Enregistrez le TimeControl.

À l'heure et à la minute spécifiées, vérifiez que votre canal se met à jour automatiquement.

Application TimeControl avec erreurs de code d'analyse MATLAB

Les TimeControls qui déclenchent MATLAB Le code d'analyse avec des erreurs cesse de s'exécuter après le déclenchement de plusieurs erreurs consécutives. Vous pouvez choisir de recevoir une alerte par email en cochant la case Notify me via email if this MATLAB Analysis fails when triggered by TimeControl or React dans l'application MATLAB Analyse.