sif_si7021.h

Go to the documentation of this file.

/*
 *  Copyright (c) 2019, Cascoda Ltd.
 *  All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions are met:
 *  1. Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *  2. Redistributions in binary form must reproduce the above copyright
 *     notice, this list of conditions and the following disclaimer in the
 *     documentation and/or other materials provided with the distribution.
 *  3. Neither the name of the copyright holder nor the
 *     names of its contributors may be used to endorse or promote products
 *     derived from this software without specific prior written permission.
 *
 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 *  POSSIBILITY OF SUCH DAMAGE.
 */
#ifndef SIF_SI7021_H
#define SIF_SI7021_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* slave addresses */
#define SIF_SAD_SI7021 0x40 /* Si7021 temperature / humidity sensor */
 
/* master measurement (read access) modes */
enum sif_si7021_mode
{
    SIF_SI7021_MODE_HOLD_MASTER,
    /* master hold mode (clock streching, clock suspend) */ 
    SIF_SI7021_MODE_NACK_WAIT,
    /* no-hold master hold mode (wait while NACKs) */ 
    SIF_SI7021_MODE_TCONV_WAIT,
    /* wait for maximum conversion time */ 
};
 
/* measurement mode */
#define SIF_SI7021_MODE SIF_SI7021_MODE_HOLD_MASTER
 
/* max. conversion times for measurement [ms] */
#define SIF_SI7021_TCONV_MAX_TEMP 10 /* temperature */
#define SIF_SI7021_TCONV_MAX_HUM 20  /* humidity */
 
/* functions */
 
/******************************************************************************/
/***************************************************************************/ 
u8_t SIF_SI7021_ReadTemperature(void);                                        /* measure temperature, -128 to +127 'C */
 
/******************************************************************************/
/***************************************************************************/ 
u8_t SIF_SI7021_ReadHumidity(void);                                           /* measure humidity, 0 to 100 % */
 
/******************************************************************************/
/***************************************************************************/ 
void SIF_SI7021_Reset(void);                                                  /* device soft-reset */
 
/******************************************************************************/
/***************************************************************************/ 
u8_t SIF_SI7021_ReadID(void);                                                 /* device read device identification */
 
#ifdef __cplusplus
}
#endif
 
#endif // SIF_SI7021_H