AdafruitIO_Definitions.h

Go to the documentation of this file.

#ifndef ADAFRUITIO_DEFINITIONS_H_
#define ADAFRUITIO_DEFINITIONS_H_

#define ADAFRUITIO_VERSION_MAJOR 4 
#define ADAFRUITIO_VERSION_MINOR 2 
#define ADAFRUITIO_VERSION_PATCH 1 

// forward declaration
class AdafruitIO_Data;

typedef void (*AdafruitIODataCallbackType)(
    AdafruitIO_Data *data); 
/**************************************************************************/
/**************************************************************************/
class AdafruitIOGroupCallback {
public:
  /**************************************************************************/
  /**************************************************************************/
  AdafruitIOGroupCallback(const char *f, AdafruitIODataCallbackType cb) {
    feed = f;
    dataCallback = cb;
    next_cb = 0;
  }

  /**************************************************************************/
  /**************************************************************************/
  AdafruitIOGroupCallback(AdafruitIODataCallbackType cb) {
    feed = 0;
    dataCallback = cb;
    next_cb = 0;
  }

  const char *feed; 
  AdafruitIODataCallbackType
      dataCallback; 
  AdafruitIOGroupCallback *next_cb; 
};

// Uncomment/comment to turn on/off debug output messages.
// #define AIO_DEBUG
// Uncomment/comment to turn on/off error output
// #define AIO_ERROR

// note: if you're using something like Zero or Due, change the below to
// SerialUSB
#define AIO_PRINTER Serial 

// Define actual debug output functions when necessary.
#ifdef AIO_DEBUG
#define AIO_DEBUG_PRINT(...)                                                   \
  { AIO_PRINTER.print(__VA_ARGS__); } 
#define AIO_DEBUG_PRINTLN(...)                                                 \
  { AIO_PRINTER.println(__VA_ARGS__); } 
#else
#define AIO_DEBUG_PRINT(...)                                                   \
  {} 
#define AIO_DEBUG_PRINTLN(...)                                                 \
  {} 
#endif

// Define actual error output functions when necessary.
#ifdef AIO_ERROR
#define AIO_ERROR_PRINT(...)                                                   \
  { AIO_PRINTER.print(__VA_ARGS__); } 
#define AIO_ERROR_PRINTLN(...)                                                 \
  { AIO_PRINTER.println(__VA_ARGS__); } 
#else
#define AIO_ERROR_PRINT(...)                                                   \
  {} 
#define AIO_ERROR_PRINTLN(...)                                                 \
  {} 
#endif

#define AIO_PING_INTERVAL 60000 
#define AIO_THROTTLE_RECONNECT_INTERVAL                                        \
  60000 
#define AIO_MQTT_CONNECTION_TIMEOUT                                            \
  60000 
#define AIO_NET_CONNECTION_TIMEOUT                                             \
  60000 
#define AIO_NET_DISCONNECT_WAIT                                                \
  300 

#define AIO_ERROR_TOPIC "/errors"      
#define AIO_THROTTLE_TOPIC "/throttle" 

/* NOTE: io.adafruit.com TLS/SSL certificate changes every 6months, and pinning
certificates is no longer recommended. Migrate to a larger MCU like ESP32
which can accomodate root certificates and verify chains of trust.  */
/* For older devices like ESP8266 you can generate the latest fingerprint with:
echo | openssl s_client -connect io.adafruit.com:443 | openssl x509 -fingerprint
-noout
*/
#define AIO_SSL_FINGERPRINT                                                    \
  "47 D2 CB 14 DF 38 97 59 C6 65 1A 1F 3E 00 1E 53 CC A5 17 E0" 

#define AIO_FEED_NAME_LENGTH                                                   \
  258 

#define AIO_DATA_LENGTH                                                        \
  45 
#define AIO_CSV_LENGTH                                                         \
  AIO_FEED_NAME_LENGTH +                                                       \
      4 


typedef enum {

  AIO_IDLE = 0,               // Waiting for connection establishement
  AIO_NET_DISCONNECTED = 1,   // Network disconnected
  AIO_DISCONNECTED = 2,       // Disconnected from Adafruit IO
  AIO_FINGERPRINT_UNKOWN = 3, // Unknown AIO_SSL_FINGERPRINT

  AIO_NET_CONNECT_FAILED = 10,  // Failed to connect to network
  AIO_CONNECT_FAILED = 11,      // Failed to connect to Adafruit IO
  AIO_FINGERPRINT_INVALID = 12, // Unknown AIO_SSL_FINGERPRINT
  AIO_AUTH_FAILED = 13, // Invalid Adafruit IO login credentials provided.
  AIO_SSID_INVALID =
      14, // SSID is "" or otherwise invalid, connection not attempted

  AIO_NET_CONNECTED = 20,           // Connected to Adafruit IO
  AIO_CONNECTED = 21,               // Connected to network
  AIO_CONNECTED_INSECURE = 22,      // Insecurely (non-SSL) connected to network
  AIO_FINGERPRINT_UNSUPPORTED = 23, // Unsupported AIO_SSL_FINGERPRINT
  AIO_FINGERPRINT_VALID = 24        // Valid AIO_SSL_FINGERPRINT

} aio_status_t;

typedef enum {

  AIO_TIME_SECONDS = 0, // Seconds MQTT feed
  AIO_TIME_MILLIS = 1,  // Milisecond MQTT feed
  AIO_TIME_ISO = 2      // ISO8601 MQTT Feed

} aio_time_format_t;

#endif /* ADAFRUITIO_DEFINITIONS_H_ */