// ********************************************************************************** // Driver definition for French Teleinfo // ********************************************************************************** // Creative Commons Attrib Share-Alike License // You are free to use/extend this library but please abide with the CC-BY-SA license: // http://creativecommons.org/licenses/by-sa/4.0/ // // For any explanation about teleinfo ou use , see my blog // http://hallard.me/category/tinfo // // Code based on following datasheet // http://www.erdf.fr/sites/default/files/ERDF-NOI-CPT_02E.pdf // // Written by Charles-Henri Hallard (http://hallard.me) // // History : V1.00 2015-06-14 - First release // // All text above must be included in any redistribution. // // ********************************************************************************** #ifndef LibTeleinfo_h #define LibTeleinfo_h #ifdef __arm__ #include #include #include #include #define boolean bool #endif #ifdef ARDUINO #include #endif // Using ESP8266 ? #ifdef ESP8266 //#include "stdlib_noniso.h" #include #endif // Define this if you want library to be verbose //#define TI_DEBUG // I prefix debug macro to be sure to use specific for THIS library // debugging, this should not interfere with main sketch or other // libraries #ifdef TI_DEBUG #ifdef ESP8266 #define TI_Debug(x) Serial1.print(x) #define TI_Debugln(x) Serial1.println(x) #define TI_Debugf(...) Serial1.printf(__VA_ARGS__) #define TI_Debugflush Serial1.flush #else #define TI_Debug(x) Serial.print(x) #define TI_Debugln(x) Serial.println(x) #define TI_Debugf(...) Serial.printf(__VA_ARGS__) #define TI_Debugflush Serial.flush #endif #else #define TI_Debug(x) #define TI_Debugln(x) #define TI_Debugf(...) #define TI_Debugflush #endif // Linked list structure containing all values received typedef struct _ValueList ValueList; struct _ValueList { ValueList *next; // next element uint8_t checksum;// checksum uint8_t flags; // specific flags char * name; // LABEL of value name char * value; // value }; // Library state machine enum _State_e { TINFO_INIT, // We're in init TINFO_WAIT_STX, // We're waiting for STX TINFO_WAIT_ETX, // We had STX, We're waiting for ETX TINFO_READY // We had STX AND ETX, So we're OK }; // what we done with received value (also for callback flags) #define TINFO_FLAGS_NONE 0x00 #define TINFO_FLAGS_NOTHING 0x01 #define TINFO_FLAGS_ADDED 0x02 #define TINFO_FLAGS_EXIST 0x04 #define TINFO_FLAGS_UPDATED 0x08 // Local buffer for one line of teleinfo #define TINFO_BUFSIZE 64 // Teleinfo start and end of frame characters #define TINFO_STX 0x02 #define TINFO_ETX 0x03 #define TINFO_SGR '\n' // start of group #define TINFO_EGR '\r' // End of group class TInfo { public: TInfo(); void init(); _State_e process (char c); void attachADPS(void (*_fn_ADPS)(uint8_t phase)); void attachData(void (*_fn_data)(ValueList * valueslist, uint8_t state)); void attachNewFrame(void (*_fn_new_frame)(ValueList * valueslist)); void attachUpdatedFrame(void (*_fn_updated_frame)(ValueList * valueslist)); ValueList * getList(void); uint8_t valuesDump(void); char * valueGet(char * name, char * value); boolean listDelete(); private: uint8_t clearBuffer(); ValueList * valueAdd (char * name, char * value, uint8_t checksum, uint8_t * valuestate); int labelCount(); unsigned char calcChecksum(char *etiquette, char *valeur) ; void customLabel( char * plabel, char * pvalue) ; ValueList * checkLine(char * pline) ; _State_e _state; // Teleinfo machine state ValueList _valueslist; // Linked list of teleinfo values char _recv_buff[TINFO_BUFSIZE]; // line receive buffer uint8_t _recv_idx; // index in receive buffer boolean _frame_updated; // Data on the frame has been updated void (*_fn_ADPS)(uint8_t phase); void (*_fn_data)(ValueList * valueslist, uint8_t state); void (*_fn_new_frame)(ValueList * valueslist); void (*_fn_updated_frame)(ValueList * valueslist); //volatile uint8_t *dcport; //uint8_t dcpinmask; }; #endif