Descrizione
esp_ifttt_maker è un componente per il framework esp-idf; il suo compito è interfacciarsi con il servizio Maker Webhooks di IFTTT per inviare eventi.
Installazione
Il codice sorgente di esp32_ifttt_maker è disponibile su Github.
Per poterlo utilizzare all’interno di un programma, è necessario innanzitutto scaricare la release più recente. All’interno della cartella che contiene il proprio progetto, creare la sottocartella components.
Al suo interno estrarre l’archivio scaricato da Github, in modo che :
Utilizzo
Per prima cosa è necessario includere nel proprio programma l’header file del componente:
#include "esp32_ifttt_maker.h" |
Quindi il componente va inizializzato con il metodo ifttt_maker_init a cui va passata la chiave del proprio account IFTTT:
ifttt_maker_init("myKey"); |
La chiave può essere recuperata accedendo alle impostazioni del servizio Maker Webhooks:
Per inviare un evento al servizio, è disponibile il metodo ifttt_maker_trigger, a cui passare il nome dell’evento:
ifttt_maker_trigger(char* event); |
Se è necessario passare anche dei parametri, si può utilizzare il metodo ifttt_maker_trigger_values che riceve in input il nome dell’evento, un array di parametri e il numero degli elementi contenuti in tale array:
ifttt_maker_trigger_values(char* event, char* vals[], int valc); |
Entrambi i metodi restituiscono un valore numerico che indica l’esito della chiamata. Le costanti possibili sono:
#define IFTTT_MAKER_OK 0 #define IFTTT_MAKER_ERR_DRBG_SEED 1 #define IFTTT_MAKER_ERR_CONNECTION 2 #define IFTTT_MAKER_ERR_SSL_DEFAULTS 3 #define IFTTT_MAKER_ERR_SEND 4 #define IFTTT_MAKER_ERR_KEY 5 #define IFTTT_MAKER_ERR_UNKNOWN 10 |
In generale quindi un valore = 0 indica esito positivo mentre uno > 0 indica un errore.
Demo
Un completo esempio che mostra l’utilizzo di questo componente è descritto in questo post.
Ecco un breve filmato dell’esempio in funzione (disponibili sottotitoli in italiano):
Changelog
Release 0.1
– Prima versione pubblica