101 lines
2.5 KiB
C
101 lines
2.5 KiB
C
/**
|
|
* Reading related functions
|
|
*
|
|
* @package vzlogger
|
|
* @copyright Copyright (c) 2011, The volkszaehler.org project
|
|
* @license http://www.gnu.org/licenses/gpl.txt GNU Public License
|
|
* @author Steffen Vogel <info@steffenvogel.de>
|
|
*/
|
|
/*
|
|
* This file is part of volkzaehler.org
|
|
*
|
|
* volkzaehler.org is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* any later version.
|
|
*
|
|
* volkzaehler.org is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with volkszaehler.org. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef _READING_H_
|
|
#define _READING_H_
|
|
|
|
#include <sys/time.h>
|
|
|
|
#include "obis.h"
|
|
|
|
#define MAX_IDENTIFIER_LEN 255
|
|
|
|
typedef union reading_id {
|
|
obis_id_t obis;
|
|
char *string;
|
|
char *uuid;
|
|
int channel;
|
|
} reading_id_t;
|
|
|
|
typedef struct reading {
|
|
double value;
|
|
struct timeval time;
|
|
reading_id_t identifier;
|
|
|
|
struct reading *next; /* pointer for linked list */
|
|
} reading_t;
|
|
|
|
/* prototypes */
|
|
|
|
enum meter_procotol; /* forward declaration */
|
|
|
|
/**
|
|
* Manages memory for string identifiers
|
|
*
|
|
* @param str string to lookup in the registry
|
|
* @return pointer to string in the regstry
|
|
*/
|
|
char * reading_id_registry(const char *str);
|
|
|
|
/**
|
|
* Parse two reading identifiers in a given protocol context
|
|
*
|
|
* @return result like in strcmp()
|
|
*/
|
|
int reading_id_compare(enum meter_procotol prot, reading_id_t a, reading_id_t b);
|
|
|
|
/**
|
|
* Parse identifier by a given string and protocol
|
|
*
|
|
* @param protocol the given protocol context in which the string should be parsed
|
|
* @param string the string-encoded identifier
|
|
* @return 0 on success, < 0 on error
|
|
*/
|
|
int reading_id_parse(enum meter_procotol protocol, reading_id_t *id, const char *string);
|
|
|
|
/**
|
|
* Print identifier to buffer for debugging/dump
|
|
*
|
|
* @return the amount of bytes used in buffer
|
|
*/
|
|
size_t reading_id_unparse(enum meter_procotol protocol, reading_id_t identifier, char *buffer, size_t n);
|
|
|
|
/**
|
|
* Converts timeval structure to double
|
|
*
|
|
* @param tv the timeval structure
|
|
* @return the double value
|
|
*/
|
|
double tvtod(struct timeval tv);
|
|
|
|
/**
|
|
* Converts double to timeval structure
|
|
*
|
|
* @param ts the double value
|
|
* @return the timeval strucure
|
|
*/
|
|
struct timeval dtotv(double ts);
|
|
|
|
#endif /* _READING_H_ */
|