phydat.h

Go to the documentation of this file.

/*
 * Copyright (C) 2015 Freie Universität Berlin
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#ifndef PHYDAT_H
#define PHYDAT_H
 
#include <stddef.h>
#include <stdint.h>
#include "kernel_defines.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define PHYDAT_DIM                  (3U)
 
#define PHYDAT_SCALE_STR_MAXLEN     (sizeof("*E-128\0"))
 
enum {
    /* generic values */
    UNIT_UNDEF,     
    UNIT_NONE,      
    /* temperature */
    UNIT_TEMP_C,    
    UNIT_TEMP_F,    
    UNIT_TEMP_K,    
    /* illuminance */
    UNIT_LUX,       
    /* dimension */
    UNIT_M,         
    UNIT_M2,        
    UNIT_M3,        
    /* kinetic */
    UNIT_G,         
    UNIT_DPS,       
    /* weight */
    UNIT_GR,        
    /* electricity */
    UNIT_A,         
    UNIT_V,         
    UNIT_W,         
    UNIT_GS,        
    UNIT_DBM,       
    UNIT_COULOMB,   
    UNIT_F,         
    UNIT_OHM,       
    /* electrochemical */
    UNIT_PH,        
    /* pressure */
    UNIT_BAR,       
    UNIT_PA,        
    /* light */
    UNIT_CD,        
    /* logical */
    UNIT_BOOL,      
    UNIT_CTS,       
    UNIT_PERCENT,   
    UNIT_PERMILL,   
    UNIT_PPM,       
    UNIT_PPB,       
    /* aggregate values */
    UNIT_TIME,      
    UNIT_DATE,      
    /* mass concentration */
    UNIT_GPM3,      
    /* number concentration */
    UNIT_CPM3       
    /* extend this list as needed */
};
 
typedef struct {
    int16_t val[PHYDAT_DIM];    
    uint8_t unit;               
    int8_t scale;               
} phydat_t;
 
#define PHYDAT_MIN  (INT16_MIN)
 
#define PHYDAT_MAX  (INT16_MAX)
 
void phydat_dump(phydat_t *data, uint8_t dim);
 
const char *phydat_unit_to_str(uint8_t unit);
 
const char *phydat_unit_to_str_verbose(uint8_t unit);
 
char phydat_prefix_from_scale(int8_t scale);
 
void phydat_fit(phydat_t *dat, const int32_t *values, unsigned int dim);
 
size_t phydat_to_json(const phydat_t *data, size_t dim, char *buf);
 
#ifdef __cplusplus
}
#endif
 
#endif /* PHYDAT_H */