Example of multiple event detection for LSM6DSL in X-NUCLEO-IKS01A2

Dependencies:   X_NUCLEO_IKS01A2 mbed

Fork of MultiEvent_IKS01A2 by ST Expansion SW Team

Multi Event Demo Application based on sensor expansion board X-NUCLEO-IKS01A2

Main function is to show how to detect the free fall, tap, double tap, tilt, wake up, 6D Orientation and step events using the sensor expansion board and send a notification using UART to a connected PC or Desktop and display it on terminal applications like TeraTerm.
After connection has been established:
- the user can simulate all the events and then view the notification using an hyper terminal.
- the user button can be used to enable/disable all hardware features.

Committer:
cparata
Date:
Thu Nov 24 15:42:24 2016 +0000
Revision:
0:763b80993db4
Add multi event example

Who changed what in which revision?

UserRevisionLine numberNew contents of line
cparata 0:763b80993db4 1 /**
cparata 0:763b80993db4 2 ******************************************************************************
cparata 0:763b80993db4 3 * @file HTS221_Driver.c
cparata 0:763b80993db4 4 * @author HESA Application Team
cparata 0:763b80993db4 5 * @version V1.1
cparata 0:763b80993db4 6 * @date 10-August-2016
cparata 0:763b80993db4 7 * @brief HTS221 driver file
cparata 0:763b80993db4 8 ******************************************************************************
cparata 0:763b80993db4 9 * @attention
cparata 0:763b80993db4 10 *
cparata 0:763b80993db4 11 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
cparata 0:763b80993db4 12 *
cparata 0:763b80993db4 13 * Redistribution and use in source and binary forms, with or without modification,
cparata 0:763b80993db4 14 * are permitted provided that the following conditions are met:
cparata 0:763b80993db4 15 * 1. Redistributions of source code must retain the above copyright notice,
cparata 0:763b80993db4 16 * this list of conditions and the following disclaimer.
cparata 0:763b80993db4 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
cparata 0:763b80993db4 18 * this list of conditions and the following disclaimer in the documentation
cparata 0:763b80993db4 19 * and/or other materials provided with the distribution.
cparata 0:763b80993db4 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
cparata 0:763b80993db4 21 * may be used to endorse or promote products derived from this software
cparata 0:763b80993db4 22 * without specific prior written permission.
cparata 0:763b80993db4 23 *
cparata 0:763b80993db4 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
cparata 0:763b80993db4 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
cparata 0:763b80993db4 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
cparata 0:763b80993db4 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
cparata 0:763b80993db4 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
cparata 0:763b80993db4 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
cparata 0:763b80993db4 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
cparata 0:763b80993db4 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
cparata 0:763b80993db4 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
cparata 0:763b80993db4 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
cparata 0:763b80993db4 34 *
cparata 0:763b80993db4 35 ******************************************************************************
cparata 0:763b80993db4 36 */
cparata 0:763b80993db4 37
cparata 0:763b80993db4 38 /* Includes ------------------------------------------------------------------*/
cparata 0:763b80993db4 39 #include "HTS221_Driver.h"
cparata 0:763b80993db4 40
cparata 0:763b80993db4 41 #ifdef __cplusplus
cparata 0:763b80993db4 42 extern "C" {
cparata 0:763b80993db4 43 #endif
cparata 0:763b80993db4 44
cparata 0:763b80993db4 45 #ifdef USE_FULL_ASSERT_HTS221
cparata 0:763b80993db4 46 #include <stdio.h>
cparata 0:763b80993db4 47 #endif
cparata 0:763b80993db4 48
cparata 0:763b80993db4 49
cparata 0:763b80993db4 50 /** @addtogroup Environmental_Sensor
cparata 0:763b80993db4 51 * @{
cparata 0:763b80993db4 52 */
cparata 0:763b80993db4 53
cparata 0:763b80993db4 54 /** @defgroup HTS221_DRIVER
cparata 0:763b80993db4 55 * @brief HTS221 DRIVER
cparata 0:763b80993db4 56 * @{
cparata 0:763b80993db4 57 */
cparata 0:763b80993db4 58
cparata 0:763b80993db4 59 /** @defgroup HTS221_Imported_Function_Prototypes
cparata 0:763b80993db4 60 * @{
cparata 0:763b80993db4 61 */
cparata 0:763b80993db4 62
cparata 0:763b80993db4 63 extern uint8_t HTS221_IO_Write( void *handle, uint8_t WriteAddr, uint8_t *pBuffer, uint16_t nBytesToWrite );
cparata 0:763b80993db4 64 extern uint8_t HTS221_IO_Read( void *handle, uint8_t ReadAddr, uint8_t *pBuffer, uint16_t nBytesToRead );
cparata 0:763b80993db4 65
cparata 0:763b80993db4 66 /**
cparata 0:763b80993db4 67 * @}
cparata 0:763b80993db4 68 */
cparata 0:763b80993db4 69
cparata 0:763b80993db4 70 /** @defgroup HTS221_Private_Function_Prototypes
cparata 0:763b80993db4 71 * @{
cparata 0:763b80993db4 72 */
cparata 0:763b80993db4 73
cparata 0:763b80993db4 74 /**
cparata 0:763b80993db4 75 * @}
cparata 0:763b80993db4 76 */
cparata 0:763b80993db4 77
cparata 0:763b80993db4 78 /** @defgroup HTS221_Private_Functions
cparata 0:763b80993db4 79 * @{
cparata 0:763b80993db4 80 */
cparata 0:763b80993db4 81
cparata 0:763b80993db4 82 /**
cparata 0:763b80993db4 83 * @}
cparata 0:763b80993db4 84 */
cparata 0:763b80993db4 85
cparata 0:763b80993db4 86 /** @defgroup HTS221_Public_Functions
cparata 0:763b80993db4 87 * @{
cparata 0:763b80993db4 88 */
cparata 0:763b80993db4 89
cparata 0:763b80993db4 90 /*******************************************************************************
cparata 0:763b80993db4 91 * Function Name : HTS221_ReadReg
cparata 0:763b80993db4 92 * Description : Generic Reading function. It must be fullfilled with either
cparata 0:763b80993db4 93 * : I2C or SPI reading functions
cparata 0:763b80993db4 94 * Input : Register Address
cparata 0:763b80993db4 95 * Output : Data Read
cparata 0:763b80993db4 96 * Return : None
cparata 0:763b80993db4 97 *******************************************************************************/
cparata 0:763b80993db4 98 HTS221_Error_et HTS221_ReadReg( void *handle, uint8_t RegAddr, uint16_t NumByteToRead, uint8_t *Data )
cparata 0:763b80993db4 99 {
cparata 0:763b80993db4 100
cparata 0:763b80993db4 101 if ( NumByteToRead > 1 ) RegAddr |= 0x80;
cparata 0:763b80993db4 102
cparata 0:763b80993db4 103 if ( HTS221_IO_Read( handle, RegAddr, Data, NumByteToRead ) )
cparata 0:763b80993db4 104 return HTS221_ERROR;
cparata 0:763b80993db4 105 else
cparata 0:763b80993db4 106 return HTS221_OK;
cparata 0:763b80993db4 107 }
cparata 0:763b80993db4 108
cparata 0:763b80993db4 109 /*******************************************************************************
cparata 0:763b80993db4 110 * Function Name : HTS221_WriteReg
cparata 0:763b80993db4 111 * Description : Generic Writing function. It must be fullfilled with either
cparata 0:763b80993db4 112 * : I2C or SPI writing function
cparata 0:763b80993db4 113 * Input : Register Address, Data to be written
cparata 0:763b80993db4 114 * Output : None
cparata 0:763b80993db4 115 * Return : None
cparata 0:763b80993db4 116 *******************************************************************************/
cparata 0:763b80993db4 117 HTS221_Error_et HTS221_WriteReg( void *handle, uint8_t RegAddr, uint16_t NumByteToWrite, uint8_t *Data )
cparata 0:763b80993db4 118 {
cparata 0:763b80993db4 119
cparata 0:763b80993db4 120 if ( NumByteToWrite > 1 ) RegAddr |= 0x80;
cparata 0:763b80993db4 121
cparata 0:763b80993db4 122 if ( HTS221_IO_Write( handle, RegAddr, Data, NumByteToWrite ) )
cparata 0:763b80993db4 123 return HTS221_ERROR;
cparata 0:763b80993db4 124 else
cparata 0:763b80993db4 125 return HTS221_OK;
cparata 0:763b80993db4 126 }
cparata 0:763b80993db4 127
cparata 0:763b80993db4 128 /**
cparata 0:763b80993db4 129 * @brief Get the version of this driver.
cparata 0:763b80993db4 130 * @param pxVersion pointer to a HTS221_DriverVersion_st structure that contains the version information.
cparata 0:763b80993db4 131 * This parameter is a pointer to @ref HTS221_DriverVersion_st.
cparata 0:763b80993db4 132 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 133 */
cparata 0:763b80993db4 134 HTS221_Error_et HTS221_Get_DriverVersion(HTS221_DriverVersion_st* version)
cparata 0:763b80993db4 135 {
cparata 0:763b80993db4 136 version->Major = HTS221_DRIVER_VERSION_MAJOR;
cparata 0:763b80993db4 137 version->Minor = HTS221_DRIVER_VERSION_MINOR;
cparata 0:763b80993db4 138 version->Point = HTS221_DRIVER_VERSION_POINT;
cparata 0:763b80993db4 139
cparata 0:763b80993db4 140 return HTS221_OK;
cparata 0:763b80993db4 141 }
cparata 0:763b80993db4 142
cparata 0:763b80993db4 143 /**
cparata 0:763b80993db4 144 * @brief Get device type ID.
cparata 0:763b80993db4 145 * @param *handle Device handle.
cparata 0:763b80993db4 146 * @param deviceid pointer to the returned device type ID.
cparata 0:763b80993db4 147 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 148 */
cparata 0:763b80993db4 149 HTS221_Error_et HTS221_Get_DeviceID(void *handle, uint8_t* deviceid)
cparata 0:763b80993db4 150 {
cparata 0:763b80993db4 151 if(HTS221_ReadReg(handle, HTS221_WHO_AM_I_REG, 1, deviceid))
cparata 0:763b80993db4 152 return HTS221_ERROR;
cparata 0:763b80993db4 153
cparata 0:763b80993db4 154 return HTS221_OK;
cparata 0:763b80993db4 155 }
cparata 0:763b80993db4 156
cparata 0:763b80993db4 157 /**
cparata 0:763b80993db4 158 * @brief Initializes the HTS221 with the specified parameters in HTS221_Init_st struct.
cparata 0:763b80993db4 159 * @param *handle Device handle.
cparata 0:763b80993db4 160 * @param pxInit pointer to a HTS221_Init_st structure that contains the configuration.
cparata 0:763b80993db4 161 * This parameter is a pointer to @ref HTS221_Init_st.
cparata 0:763b80993db4 162 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 163 */
cparata 0:763b80993db4 164 HTS221_Error_et HTS221_Set_InitConfig(void *handle, HTS221_Init_st* pxInit)
cparata 0:763b80993db4 165 {
cparata 0:763b80993db4 166 uint8_t buffer[3];
cparata 0:763b80993db4 167
cparata 0:763b80993db4 168 HTS221_assert_param(IS_HTS221_AVGH(pxInit->avg_h));
cparata 0:763b80993db4 169 HTS221_assert_param(IS_HTS221_AVGT(pxInit->avg_t));
cparata 0:763b80993db4 170 HTS221_assert_param(IS_HTS221_ODR(pxInit->odr));
cparata 0:763b80993db4 171 HTS221_assert_param(IS_HTS221_State(pxInit->bdu_status));
cparata 0:763b80993db4 172 HTS221_assert_param(IS_HTS221_State(pxInit->heater_status));
cparata 0:763b80993db4 173
cparata 0:763b80993db4 174 HTS221_assert_param(IS_HTS221_DrdyLevelType(pxInit->irq_level));
cparata 0:763b80993db4 175 HTS221_assert_param(IS_HTS221_OutputType(pxInit->irq_output_type));
cparata 0:763b80993db4 176 HTS221_assert_param(IS_HTS221_State(pxInit->irq_enable));
cparata 0:763b80993db4 177
cparata 0:763b80993db4 178 if(HTS221_ReadReg(handle, HTS221_AV_CONF_REG, 1, buffer))
cparata 0:763b80993db4 179 return HTS221_ERROR;
cparata 0:763b80993db4 180
cparata 0:763b80993db4 181 buffer[0] &= ~(HTS221_AVGH_MASK | HTS221_AVGT_MASK);
cparata 0:763b80993db4 182 buffer[0] |= (uint8_t)pxInit->avg_h;
cparata 0:763b80993db4 183 buffer[0] |= (uint8_t)pxInit->avg_t;
cparata 0:763b80993db4 184
cparata 0:763b80993db4 185 if(HTS221_WriteReg(handle, HTS221_AV_CONF_REG, 1, buffer))
cparata 0:763b80993db4 186 return HTS221_ERROR;
cparata 0:763b80993db4 187
cparata 0:763b80993db4 188 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 3, buffer))
cparata 0:763b80993db4 189 return HTS221_ERROR;
cparata 0:763b80993db4 190
cparata 0:763b80993db4 191 buffer[0] &= ~(HTS221_BDU_MASK | HTS221_ODR_MASK);
cparata 0:763b80993db4 192 buffer[0] |= (uint8_t)pxInit->odr;
cparata 0:763b80993db4 193 buffer[0] |= ((uint8_t)pxInit->bdu_status) << HTS221_BDU_BIT;
cparata 0:763b80993db4 194
cparata 0:763b80993db4 195 buffer[1] &= ~HTS221_HEATHER_BIT;
cparata 0:763b80993db4 196 buffer[1] |= ((uint8_t)pxInit->heater_status) << HTS221_HEATHER_BIT;
cparata 0:763b80993db4 197
cparata 0:763b80993db4 198 buffer[2] &= ~(HTS221_DRDY_H_L_MASK | HTS221_PP_OD_MASK | HTS221_DRDY_MASK);
cparata 0:763b80993db4 199 buffer[2] |= ((uint8_t)pxInit->irq_level) << HTS221_DRDY_H_L_BIT;
cparata 0:763b80993db4 200 buffer[2] |= (uint8_t)pxInit->irq_output_type;
cparata 0:763b80993db4 201 buffer[2] |= ((uint8_t)pxInit->irq_enable) << HTS221_DRDY_BIT;
cparata 0:763b80993db4 202
cparata 0:763b80993db4 203 if(HTS221_WriteReg(handle, HTS221_CTRL_REG1, 3, buffer))
cparata 0:763b80993db4 204 return HTS221_ERROR;
cparata 0:763b80993db4 205
cparata 0:763b80993db4 206 return HTS221_OK;
cparata 0:763b80993db4 207 }
cparata 0:763b80993db4 208
cparata 0:763b80993db4 209 /**
cparata 0:763b80993db4 210 * @brief Returns a HTS221_Init_st struct with the actual configuration.
cparata 0:763b80993db4 211 * @param *handle Device handle.
cparata 0:763b80993db4 212 * @param pxInit pointer to a HTS221_Init_st structure.
cparata 0:763b80993db4 213 * This parameter is a pointer to @ref HTS221_Init_st.
cparata 0:763b80993db4 214 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 215 */
cparata 0:763b80993db4 216 HTS221_Error_et HTS221_Get_InitConfig(void *handle, HTS221_Init_st* pxInit)
cparata 0:763b80993db4 217 {
cparata 0:763b80993db4 218 uint8_t buffer[3];
cparata 0:763b80993db4 219
cparata 0:763b80993db4 220 if(HTS221_ReadReg(handle, HTS221_AV_CONF_REG, 1, buffer))
cparata 0:763b80993db4 221 return HTS221_ERROR;
cparata 0:763b80993db4 222
cparata 0:763b80993db4 223 pxInit->avg_h = (HTS221_Avgh_et)(buffer[0] & HTS221_AVGH_MASK);
cparata 0:763b80993db4 224 pxInit->avg_t = (HTS221_Avgt_et)(buffer[0] & HTS221_AVGT_MASK);
cparata 0:763b80993db4 225
cparata 0:763b80993db4 226 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 3, buffer))
cparata 0:763b80993db4 227 return HTS221_ERROR;
cparata 0:763b80993db4 228
cparata 0:763b80993db4 229 pxInit->odr = (HTS221_Odr_et)(buffer[0] & HTS221_ODR_MASK);
cparata 0:763b80993db4 230 pxInit->bdu_status = (HTS221_State_et)((buffer[0] & HTS221_BDU_MASK) >> HTS221_BDU_BIT);
cparata 0:763b80993db4 231 pxInit->heater_status = (HTS221_State_et)((buffer[1] & HTS221_HEATHER_MASK) >> HTS221_HEATHER_BIT);
cparata 0:763b80993db4 232
cparata 0:763b80993db4 233 pxInit->irq_level = (HTS221_DrdyLevel_et)(buffer[2] & HTS221_DRDY_H_L_MASK);
cparata 0:763b80993db4 234 pxInit->irq_output_type = (HTS221_OutputType_et)(buffer[2] & HTS221_PP_OD_MASK);
cparata 0:763b80993db4 235 pxInit->irq_enable = (HTS221_State_et)((buffer[2] & HTS221_DRDY_MASK) >> HTS221_DRDY_BIT);
cparata 0:763b80993db4 236
cparata 0:763b80993db4 237 return HTS221_OK;
cparata 0:763b80993db4 238 }
cparata 0:763b80993db4 239
cparata 0:763b80993db4 240 /**
cparata 0:763b80993db4 241 * @brief De initialization function for HTS221.
cparata 0:763b80993db4 242 * This function put the HTS221 in power down, make a memory boot and clear the data output flags.
cparata 0:763b80993db4 243 * @param *handle Device handle.
cparata 0:763b80993db4 244 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 245 */
cparata 0:763b80993db4 246 HTS221_Error_et HTS221_DeInit(void *handle)
cparata 0:763b80993db4 247 {
cparata 0:763b80993db4 248 uint8_t buffer[4];
cparata 0:763b80993db4 249
cparata 0:763b80993db4 250 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 2, buffer))
cparata 0:763b80993db4 251 return HTS221_ERROR;
cparata 0:763b80993db4 252
cparata 0:763b80993db4 253 /* HTS221 in power down */
cparata 0:763b80993db4 254 buffer[0] |= 0x01 << HTS221_PD_BIT;
cparata 0:763b80993db4 255
cparata 0:763b80993db4 256 /* Make HTS221 boot */
cparata 0:763b80993db4 257 buffer[1] |= 0x01 << HTS221_BOOT_BIT;
cparata 0:763b80993db4 258
cparata 0:763b80993db4 259 if(HTS221_WriteReg(handle, HTS221_CTRL_REG1, 2, buffer))
cparata 0:763b80993db4 260 return HTS221_ERROR;
cparata 0:763b80993db4 261
cparata 0:763b80993db4 262 /* Dump of data output */
cparata 0:763b80993db4 263 if(HTS221_ReadReg(handle, HTS221_HR_OUT_L_REG, 4, buffer))
cparata 0:763b80993db4 264 return HTS221_ERROR;
cparata 0:763b80993db4 265
cparata 0:763b80993db4 266 return HTS221_OK;
cparata 0:763b80993db4 267 }
cparata 0:763b80993db4 268
cparata 0:763b80993db4 269 /**
cparata 0:763b80993db4 270 * @brief Read HTS221 output registers, and calculate humidity and temperature.
cparata 0:763b80993db4 271 * @param *handle Device handle.
cparata 0:763b80993db4 272 * @param humidity pointer to the returned humidity value that must be divided by 10 to get the value in [%].
cparata 0:763b80993db4 273 * @param temperature pointer to the returned temperature value that must be divided by 10 to get the value in ['C].
cparata 0:763b80993db4 274 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 275 */
cparata 0:763b80993db4 276 HTS221_Error_et HTS221_Get_Measurement(void *handle, uint16_t* humidity, int16_t* temperature)
cparata 0:763b80993db4 277 {
cparata 0:763b80993db4 278 if ( HTS221_Get_Temperature( handle, temperature ) == HTS221_ERROR ) return HTS221_ERROR;
cparata 0:763b80993db4 279 if ( HTS221_Get_Humidity( handle, humidity ) == HTS221_ERROR ) return HTS221_ERROR;
cparata 0:763b80993db4 280
cparata 0:763b80993db4 281 return HTS221_OK;
cparata 0:763b80993db4 282 }
cparata 0:763b80993db4 283
cparata 0:763b80993db4 284 /**
cparata 0:763b80993db4 285 * @brief Read HTS221 output registers. Humidity and temperature.
cparata 0:763b80993db4 286 * @param *handle Device handle.
cparata 0:763b80993db4 287 * @param humidity pointer to the returned humidity raw value.
cparata 0:763b80993db4 288 * @param temperature pointer to the returned temperature raw value.
cparata 0:763b80993db4 289 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 290 */
cparata 0:763b80993db4 291 HTS221_Error_et HTS221_Get_RawMeasurement(void *handle, int16_t* humidity, int16_t* temperature)
cparata 0:763b80993db4 292 {
cparata 0:763b80993db4 293 uint8_t buffer[4];
cparata 0:763b80993db4 294
cparata 0:763b80993db4 295 if(HTS221_ReadReg(handle, HTS221_HR_OUT_L_REG, 4, buffer))
cparata 0:763b80993db4 296 return HTS221_ERROR;
cparata 0:763b80993db4 297
cparata 0:763b80993db4 298 *humidity = (int16_t)((((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0]);
cparata 0:763b80993db4 299 *temperature = (int16_t)((((uint16_t)buffer[3]) << 8) | (uint16_t)buffer[2]);
cparata 0:763b80993db4 300
cparata 0:763b80993db4 301 return HTS221_OK;
cparata 0:763b80993db4 302 }
cparata 0:763b80993db4 303
cparata 0:763b80993db4 304 /**
cparata 0:763b80993db4 305 * @brief Read HTS221 Humidity output registers, and calculate humidity.
cparata 0:763b80993db4 306 * @param *handle Device handle.
cparata 0:763b80993db4 307 * @param Pointer to the returned humidity value that must be divided by 10 to get the value in [%].
cparata 0:763b80993db4 308 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 309 */
cparata 0:763b80993db4 310 HTS221_Error_et HTS221_Get_Humidity(void *handle, uint16_t* value)
cparata 0:763b80993db4 311 {
cparata 0:763b80993db4 312 int16_t H0_T0_out, H1_T0_out, H_T_out;
cparata 0:763b80993db4 313 int16_t H0_rh, H1_rh;
cparata 0:763b80993db4 314 uint8_t buffer[2];
cparata 0:763b80993db4 315 float tmp_f;
cparata 0:763b80993db4 316
cparata 0:763b80993db4 317 if(HTS221_ReadReg(handle, HTS221_H0_RH_X2, 2, buffer))
cparata 0:763b80993db4 318 return HTS221_ERROR;
cparata 0:763b80993db4 319 H0_rh = buffer[0] >> 1;
cparata 0:763b80993db4 320 H1_rh = buffer[1] >> 1;
cparata 0:763b80993db4 321
cparata 0:763b80993db4 322 if(HTS221_ReadReg(handle, HTS221_H0_T0_OUT_L, 2, buffer))
cparata 0:763b80993db4 323 return HTS221_ERROR;
cparata 0:763b80993db4 324 H0_T0_out = (((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0];
cparata 0:763b80993db4 325
cparata 0:763b80993db4 326 if(HTS221_ReadReg(handle, HTS221_H1_T0_OUT_L, 2, buffer))
cparata 0:763b80993db4 327 return HTS221_ERROR;
cparata 0:763b80993db4 328 H1_T0_out = (((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0];
cparata 0:763b80993db4 329
cparata 0:763b80993db4 330 if(HTS221_ReadReg(handle, HTS221_HR_OUT_L_REG, 2, buffer))
cparata 0:763b80993db4 331 return HTS221_ERROR;
cparata 0:763b80993db4 332 H_T_out = (((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0];
cparata 0:763b80993db4 333
cparata 0:763b80993db4 334 tmp_f = (float)(H_T_out - H0_T0_out) * (float)(H1_rh - H0_rh) / (float)(H1_T0_out - H0_T0_out) + H0_rh;
cparata 0:763b80993db4 335 tmp_f *= 10.0f;
cparata 0:763b80993db4 336
cparata 0:763b80993db4 337 *value = ( tmp_f > 1000.0f ) ? 1000
cparata 0:763b80993db4 338 : ( tmp_f < 0.0f ) ? 0
cparata 0:763b80993db4 339 : ( uint16_t )tmp_f;
cparata 0:763b80993db4 340
cparata 0:763b80993db4 341 return HTS221_OK;
cparata 0:763b80993db4 342 }
cparata 0:763b80993db4 343
cparata 0:763b80993db4 344 /**
cparata 0:763b80993db4 345 * @brief Read HTS221 humidity output registers.
cparata 0:763b80993db4 346 * @param *handle Device handle.
cparata 0:763b80993db4 347 * @param Pointer to the returned humidity raw value.
cparata 0:763b80993db4 348 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 349 */
cparata 0:763b80993db4 350 HTS221_Error_et HTS221_Get_HumidityRaw(void *handle, int16_t* value)
cparata 0:763b80993db4 351 {
cparata 0:763b80993db4 352 uint8_t buffer[2];
cparata 0:763b80993db4 353
cparata 0:763b80993db4 354 if(HTS221_ReadReg(handle, HTS221_HR_OUT_L_REG, 2, buffer))
cparata 0:763b80993db4 355 return HTS221_ERROR;
cparata 0:763b80993db4 356
cparata 0:763b80993db4 357 *value = (int16_t)((((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0]);
cparata 0:763b80993db4 358
cparata 0:763b80993db4 359 return HTS221_OK;
cparata 0:763b80993db4 360 }
cparata 0:763b80993db4 361
cparata 0:763b80993db4 362 /**
cparata 0:763b80993db4 363 * @brief Read HTS221 temperature output registers, and calculate temperature.
cparata 0:763b80993db4 364 * @param *handle Device handle.
cparata 0:763b80993db4 365 * @param Pointer to the returned temperature value that must be divided by 10 to get the value in ['C].
cparata 0:763b80993db4 366 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 367 */
cparata 0:763b80993db4 368 HTS221_Error_et HTS221_Get_Temperature(void *handle, int16_t *value)
cparata 0:763b80993db4 369 {
cparata 0:763b80993db4 370 int16_t T0_out, T1_out, T_out, T0_degC_x8_u16, T1_degC_x8_u16;
cparata 0:763b80993db4 371 int16_t T0_degC, T1_degC;
cparata 0:763b80993db4 372 uint8_t buffer[4], tmp;
cparata 0:763b80993db4 373 float tmp_f;
cparata 0:763b80993db4 374
cparata 0:763b80993db4 375 if(HTS221_ReadReg(handle, HTS221_T0_DEGC_X8, 2, buffer))
cparata 0:763b80993db4 376 return HTS221_ERROR;
cparata 0:763b80993db4 377 if(HTS221_ReadReg(handle, HTS221_T0_T1_DEGC_H2, 1, &tmp))
cparata 0:763b80993db4 378 return HTS221_ERROR;
cparata 0:763b80993db4 379
cparata 0:763b80993db4 380 T0_degC_x8_u16 = (((uint16_t)(tmp & 0x03)) << 8) | ((uint16_t)buffer[0]);
cparata 0:763b80993db4 381 T1_degC_x8_u16 = (((uint16_t)(tmp & 0x0C)) << 6) | ((uint16_t)buffer[1]);
cparata 0:763b80993db4 382 T0_degC = T0_degC_x8_u16 >> 3;
cparata 0:763b80993db4 383 T1_degC = T1_degC_x8_u16 >> 3;
cparata 0:763b80993db4 384
cparata 0:763b80993db4 385 if(HTS221_ReadReg(handle, HTS221_T0_OUT_L, 4, buffer))
cparata 0:763b80993db4 386 return HTS221_ERROR;
cparata 0:763b80993db4 387
cparata 0:763b80993db4 388 T0_out = (((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0];
cparata 0:763b80993db4 389 T1_out = (((uint16_t)buffer[3]) << 8) | (uint16_t)buffer[2];
cparata 0:763b80993db4 390
cparata 0:763b80993db4 391 if(HTS221_ReadReg(handle, HTS221_TEMP_OUT_L_REG, 2, buffer))
cparata 0:763b80993db4 392 return HTS221_ERROR;
cparata 0:763b80993db4 393
cparata 0:763b80993db4 394 T_out = (((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0];
cparata 0:763b80993db4 395
cparata 0:763b80993db4 396 tmp_f = (float)(T_out - T0_out) * (float)(T1_degC - T0_degC) / (float)(T1_out - T0_out) + T0_degC;
cparata 0:763b80993db4 397 tmp_f *= 10.0f;
cparata 0:763b80993db4 398
cparata 0:763b80993db4 399 *value = ( int16_t )tmp_f;
cparata 0:763b80993db4 400
cparata 0:763b80993db4 401 return HTS221_OK;
cparata 0:763b80993db4 402 }
cparata 0:763b80993db4 403
cparata 0:763b80993db4 404 /**
cparata 0:763b80993db4 405 * @brief Read HTS221 temperature output registers.
cparata 0:763b80993db4 406 * @param *handle Device handle.
cparata 0:763b80993db4 407 * @param Pointer to the returned temperature raw value.
cparata 0:763b80993db4 408 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 409 */
cparata 0:763b80993db4 410 HTS221_Error_et HTS221_Get_TemperatureRaw(void *handle, int16_t* value)
cparata 0:763b80993db4 411 {
cparata 0:763b80993db4 412 uint8_t buffer[2];
cparata 0:763b80993db4 413
cparata 0:763b80993db4 414 if(HTS221_ReadReg(handle, HTS221_TEMP_OUT_L_REG, 2, buffer))
cparata 0:763b80993db4 415 return HTS221_ERROR;
cparata 0:763b80993db4 416
cparata 0:763b80993db4 417 *value = (int16_t)((((uint16_t)buffer[1]) << 8) | (uint16_t)buffer[0]);
cparata 0:763b80993db4 418
cparata 0:763b80993db4 419 return HTS221_OK;
cparata 0:763b80993db4 420 }
cparata 0:763b80993db4 421
cparata 0:763b80993db4 422 /**
cparata 0:763b80993db4 423 * @brief Get the availability of new data for humidity and temperature.
cparata 0:763b80993db4 424 * @param *handle Device handle.
cparata 0:763b80993db4 425 * @param humidity pointer to the returned humidity data status [HTS221_SET/HTS221_RESET].
cparata 0:763b80993db4 426 * @param temperature pointer to the returned temperature data status [HTS221_SET/HTS221_RESET].
cparata 0:763b80993db4 427 * This parameter is a pointer to @ref HTS221_BitStatus_et.
cparata 0:763b80993db4 428 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 429 */
cparata 0:763b80993db4 430 HTS221_Error_et HTS221_Get_DataStatus(void *handle, HTS221_BitStatus_et* humidity, HTS221_BitStatus_et* temperature)
cparata 0:763b80993db4 431 {
cparata 0:763b80993db4 432 uint8_t tmp;
cparata 0:763b80993db4 433
cparata 0:763b80993db4 434 if(HTS221_ReadReg(handle, HTS221_STATUS_REG, 1, &tmp))
cparata 0:763b80993db4 435 return HTS221_ERROR;
cparata 0:763b80993db4 436
cparata 0:763b80993db4 437 *humidity = (HTS221_BitStatus_et)((tmp & HTS221_HDA_MASK) >> HTS221_H_DA_BIT);
cparata 0:763b80993db4 438 *temperature = (HTS221_BitStatus_et)(tmp & HTS221_TDA_MASK);
cparata 0:763b80993db4 439
cparata 0:763b80993db4 440 return HTS221_OK;
cparata 0:763b80993db4 441 }
cparata 0:763b80993db4 442
cparata 0:763b80993db4 443 /**
cparata 0:763b80993db4 444 * @brief Exit from power down mode.
cparata 0:763b80993db4 445 * @param *handle Device handle.
cparata 0:763b80993db4 446 * @param void.
cparata 0:763b80993db4 447 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 448 */
cparata 0:763b80993db4 449 HTS221_Error_et HTS221_Activate(void *handle)
cparata 0:763b80993db4 450 {
cparata 0:763b80993db4 451 uint8_t tmp;
cparata 0:763b80993db4 452
cparata 0:763b80993db4 453 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 454 return HTS221_ERROR;
cparata 0:763b80993db4 455
cparata 0:763b80993db4 456 tmp |= HTS221_PD_MASK;
cparata 0:763b80993db4 457
cparata 0:763b80993db4 458 if(HTS221_WriteReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 459 return HTS221_ERROR;
cparata 0:763b80993db4 460
cparata 0:763b80993db4 461 return HTS221_OK;
cparata 0:763b80993db4 462 }
cparata 0:763b80993db4 463
cparata 0:763b80993db4 464 /**
cparata 0:763b80993db4 465 * @brief Put the sensor in power down mode.
cparata 0:763b80993db4 466 * @param *handle Device handle.
cparata 0:763b80993db4 467 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 468 */
cparata 0:763b80993db4 469 HTS221_Error_et HTS221_DeActivate(void *handle)
cparata 0:763b80993db4 470 {
cparata 0:763b80993db4 471 uint8_t tmp;
cparata 0:763b80993db4 472
cparata 0:763b80993db4 473 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 474 return HTS221_ERROR;
cparata 0:763b80993db4 475
cparata 0:763b80993db4 476 tmp &= ~HTS221_PD_MASK;
cparata 0:763b80993db4 477
cparata 0:763b80993db4 478 if(HTS221_WriteReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 479 return HTS221_ERROR;
cparata 0:763b80993db4 480
cparata 0:763b80993db4 481 return HTS221_OK;
cparata 0:763b80993db4 482 }
cparata 0:763b80993db4 483
cparata 0:763b80993db4 484
cparata 0:763b80993db4 485
cparata 0:763b80993db4 486 /**
cparata 0:763b80993db4 487 * @brief Check if the single measurement has completed.
cparata 0:763b80993db4 488 * @param *handle Device handle.
cparata 0:763b80993db4 489 * @param tmp is set to 1, when the measure is completed
cparata 0:763b80993db4 490 * @retval Status [HTS221_ERROR, HTS221_OK]
cparata 0:763b80993db4 491 */
cparata 0:763b80993db4 492 HTS221_Error_et HTS221_IsMeasurementCompleted(void *handle, HTS221_BitStatus_et* Is_Measurement_Completed)
cparata 0:763b80993db4 493 {
cparata 0:763b80993db4 494 uint8_t tmp;
cparata 0:763b80993db4 495
cparata 0:763b80993db4 496 if(HTS221_ReadReg(handle, HTS221_STATUS_REG, 1, &tmp))
cparata 0:763b80993db4 497 return HTS221_ERROR;
cparata 0:763b80993db4 498
cparata 0:763b80993db4 499 if((tmp & (uint8_t)(HTS221_HDA_MASK | HTS221_TDA_MASK)) == (uint8_t)(HTS221_HDA_MASK | HTS221_TDA_MASK))
cparata 0:763b80993db4 500 *Is_Measurement_Completed = HTS221_SET;
cparata 0:763b80993db4 501 else
cparata 0:763b80993db4 502 *Is_Measurement_Completed = HTS221_RESET;
cparata 0:763b80993db4 503
cparata 0:763b80993db4 504 return HTS221_OK;
cparata 0:763b80993db4 505 }
cparata 0:763b80993db4 506
cparata 0:763b80993db4 507
cparata 0:763b80993db4 508 /**
cparata 0:763b80993db4 509 * @brief Set_ humidity and temperature average mode.
cparata 0:763b80993db4 510 * @param *handle Device handle.
cparata 0:763b80993db4 511 * @param avgh is the average mode for humidity, this parameter is @ref HTS221_Avgh_et.
cparata 0:763b80993db4 512 * @param avgt is the average mode for temperature, this parameter is @ref HTS221_Avgt_et.
cparata 0:763b80993db4 513 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 514 */
cparata 0:763b80993db4 515 HTS221_Error_et HTS221_Set_AvgHT(void *handle, HTS221_Avgh_et avgh, HTS221_Avgt_et avgt)
cparata 0:763b80993db4 516 {
cparata 0:763b80993db4 517 uint8_t tmp;
cparata 0:763b80993db4 518
cparata 0:763b80993db4 519 HTS221_assert_param(IS_HTS221_AVGH(avgh));
cparata 0:763b80993db4 520 HTS221_assert_param(IS_HTS221_AVGT(avgt));
cparata 0:763b80993db4 521
cparata 0:763b80993db4 522 if(HTS221_ReadReg(handle, HTS221_AV_CONF_REG, 1, &tmp))
cparata 0:763b80993db4 523 return HTS221_ERROR;
cparata 0:763b80993db4 524
cparata 0:763b80993db4 525 tmp &= ~(HTS221_AVGH_MASK | HTS221_AVGT_MASK);
cparata 0:763b80993db4 526 tmp |= (uint8_t)avgh;
cparata 0:763b80993db4 527 tmp |= (uint8_t)avgt;
cparata 0:763b80993db4 528
cparata 0:763b80993db4 529 if(HTS221_WriteReg(handle, HTS221_AV_CONF_REG, 1, &tmp))
cparata 0:763b80993db4 530 return HTS221_ERROR;
cparata 0:763b80993db4 531
cparata 0:763b80993db4 532 return HTS221_OK;
cparata 0:763b80993db4 533 }
cparata 0:763b80993db4 534
cparata 0:763b80993db4 535 /**
cparata 0:763b80993db4 536 * @brief Set humidity average mode.
cparata 0:763b80993db4 537 * @param *handle Device handle.
cparata 0:763b80993db4 538 * @param avgh is the average mode for humidity, this parameter is @ref HTS221_Avgh_et.
cparata 0:763b80993db4 539 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 540 */
cparata 0:763b80993db4 541 HTS221_Error_et HTS221_Set_AvgH(void *handle, HTS221_Avgh_et avgh)
cparata 0:763b80993db4 542 {
cparata 0:763b80993db4 543 uint8_t tmp;
cparata 0:763b80993db4 544
cparata 0:763b80993db4 545 HTS221_assert_param(IS_HTS221_AVGH(avgh));
cparata 0:763b80993db4 546
cparata 0:763b80993db4 547 if(HTS221_ReadReg(handle, HTS221_AV_CONF_REG, 1, &tmp))
cparata 0:763b80993db4 548 return HTS221_ERROR;
cparata 0:763b80993db4 549
cparata 0:763b80993db4 550 tmp &= ~HTS221_AVGH_MASK;
cparata 0:763b80993db4 551 tmp |= (uint8_t)avgh;
cparata 0:763b80993db4 552
cparata 0:763b80993db4 553 if(HTS221_WriteReg(handle, HTS221_AV_CONF_REG, 1, &tmp))
cparata 0:763b80993db4 554 return HTS221_ERROR;
cparata 0:763b80993db4 555
cparata 0:763b80993db4 556 return HTS221_OK;
cparata 0:763b80993db4 557 }
cparata 0:763b80993db4 558
cparata 0:763b80993db4 559 /**
cparata 0:763b80993db4 560 * @brief Set temperature average mode.
cparata 0:763b80993db4 561 * @param *handle Device handle.
cparata 0:763b80993db4 562 * @param avgt is the average mode for temperature, this parameter is @ref HTS221_Avgt_et.
cparata 0:763b80993db4 563 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 564 */
cparata 0:763b80993db4 565 HTS221_Error_et HTS221_Set_AvgT(void *handle, HTS221_Avgt_et avgt)
cparata 0:763b80993db4 566 {
cparata 0:763b80993db4 567 uint8_t tmp;
cparata 0:763b80993db4 568
cparata 0:763b80993db4 569 HTS221_assert_param(IS_HTS221_AVGT(avgt));
cparata 0:763b80993db4 570
cparata 0:763b80993db4 571 if(HTS221_ReadReg(handle, HTS221_AV_CONF_REG, 1, &tmp))
cparata 0:763b80993db4 572 return HTS221_ERROR;
cparata 0:763b80993db4 573
cparata 0:763b80993db4 574 tmp &= ~HTS221_AVGT_MASK;
cparata 0:763b80993db4 575 tmp |= (uint8_t)avgt;
cparata 0:763b80993db4 576
cparata 0:763b80993db4 577 if(HTS221_WriteReg(handle, HTS221_AV_CONF_REG, 1, &tmp))
cparata 0:763b80993db4 578 return HTS221_ERROR;
cparata 0:763b80993db4 579
cparata 0:763b80993db4 580 return HTS221_OK;
cparata 0:763b80993db4 581 }
cparata 0:763b80993db4 582
cparata 0:763b80993db4 583 /**
cparata 0:763b80993db4 584 * @brief Get humidity and temperature average mode.
cparata 0:763b80993db4 585 * @param *handle Device handle.
cparata 0:763b80993db4 586 * @param avgh pointer to the returned value with the humidity average mode.
cparata 0:763b80993db4 587 * @param avgt pointer to the returned value with the temperature average mode.
cparata 0:763b80993db4 588 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 589 */
cparata 0:763b80993db4 590 HTS221_Error_et HTS221_Get_AvgHT(void *handle, HTS221_Avgh_et* avgh, HTS221_Avgt_et* avgt)
cparata 0:763b80993db4 591 {
cparata 0:763b80993db4 592 uint8_t tmp;
cparata 0:763b80993db4 593
cparata 0:763b80993db4 594 if(HTS221_ReadReg(handle, HTS221_AV_CONF_REG, 1, &tmp))
cparata 0:763b80993db4 595 return HTS221_ERROR;
cparata 0:763b80993db4 596
cparata 0:763b80993db4 597 *avgh = (HTS221_Avgh_et)(tmp & HTS221_AVGH_MASK);
cparata 0:763b80993db4 598 *avgt = (HTS221_Avgt_et)(tmp & HTS221_AVGT_MASK);
cparata 0:763b80993db4 599
cparata 0:763b80993db4 600 return HTS221_OK;
cparata 0:763b80993db4 601 }
cparata 0:763b80993db4 602
cparata 0:763b80993db4 603 /**
cparata 0:763b80993db4 604 * @brief Set block data update mode.
cparata 0:763b80993db4 605 * @param *handle Device handle.
cparata 0:763b80993db4 606 * @param status can be HTS221_ENABLE: enable the block data update, output data registers are updated once both MSB and LSB are read.
cparata 0:763b80993db4 607 * @param status can be HTS221_DISABLE: output data registers are continuously updated.
cparata 0:763b80993db4 608 * This parameter is a @ref HTS221_BitStatus_et.
cparata 0:763b80993db4 609 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 610 */
cparata 0:763b80993db4 611 HTS221_Error_et HTS221_Set_BduMode(void *handle, HTS221_State_et status)
cparata 0:763b80993db4 612 {
cparata 0:763b80993db4 613 uint8_t tmp;
cparata 0:763b80993db4 614
cparata 0:763b80993db4 615 HTS221_assert_param(IS_HTS221_State(status));
cparata 0:763b80993db4 616
cparata 0:763b80993db4 617 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 618 return HTS221_ERROR;
cparata 0:763b80993db4 619
cparata 0:763b80993db4 620 tmp &= ~HTS221_BDU_MASK;
cparata 0:763b80993db4 621 tmp |= ((uint8_t)status) << HTS221_BDU_BIT;
cparata 0:763b80993db4 622
cparata 0:763b80993db4 623 if(HTS221_WriteReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 624 return HTS221_ERROR;
cparata 0:763b80993db4 625
cparata 0:763b80993db4 626 return HTS221_OK;
cparata 0:763b80993db4 627 }
cparata 0:763b80993db4 628
cparata 0:763b80993db4 629 /**
cparata 0:763b80993db4 630 * @brief Get block data update mode.
cparata 0:763b80993db4 631 * @param *handle Device handle.
cparata 0:763b80993db4 632 * @param Pointer to the returned value with block data update mode status.
cparata 0:763b80993db4 633 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 634 */
cparata 0:763b80993db4 635 HTS221_Error_et HTS221_Get_BduMode(void *handle, HTS221_State_et* status)
cparata 0:763b80993db4 636 {
cparata 0:763b80993db4 637 uint8_t tmp;
cparata 0:763b80993db4 638
cparata 0:763b80993db4 639 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 640 return HTS221_ERROR;
cparata 0:763b80993db4 641
cparata 0:763b80993db4 642 *status = (HTS221_State_et)((tmp & HTS221_BDU_MASK) >> HTS221_BDU_BIT);
cparata 0:763b80993db4 643
cparata 0:763b80993db4 644 return HTS221_OK;
cparata 0:763b80993db4 645 }
cparata 0:763b80993db4 646
cparata 0:763b80993db4 647 /**
cparata 0:763b80993db4 648 * @brief Enter or exit from power down mode.
cparata 0:763b80993db4 649 * @param *handle Device handle.
cparata 0:763b80993db4 650 * @param status can be HTS221_SET: HTS221 in power down mode.
cparata 0:763b80993db4 651 * @param status can be HTS221_REET: HTS221 in active mode.
cparata 0:763b80993db4 652 * This parameter is a @ref HTS221_BitStatus_et.
cparata 0:763b80993db4 653 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 654 */
cparata 0:763b80993db4 655 HTS221_Error_et HTS221_Set_PowerDownMode(void *handle, HTS221_BitStatus_et status)
cparata 0:763b80993db4 656 {
cparata 0:763b80993db4 657 uint8_t tmp;
cparata 0:763b80993db4 658
cparata 0:763b80993db4 659 HTS221_assert_param(IS_HTS221_BitStatus(status));
cparata 0:763b80993db4 660
cparata 0:763b80993db4 661 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 662 return HTS221_ERROR;
cparata 0:763b80993db4 663
cparata 0:763b80993db4 664 tmp &= ~HTS221_PD_MASK;
cparata 0:763b80993db4 665 tmp |= ((uint8_t)status) << HTS221_PD_BIT;
cparata 0:763b80993db4 666
cparata 0:763b80993db4 667 if(HTS221_WriteReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 668 return HTS221_ERROR;
cparata 0:763b80993db4 669
cparata 0:763b80993db4 670 return HTS221_OK;
cparata 0:763b80993db4 671 }
cparata 0:763b80993db4 672
cparata 0:763b80993db4 673 /**
cparata 0:763b80993db4 674 * @brief Get if HTS221 is in active mode or in power down mode.
cparata 0:763b80993db4 675 * @param *handle Device handle.
cparata 0:763b80993db4 676 * @param Pointer to the returned value with HTS221 status.
cparata 0:763b80993db4 677 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 678 */
cparata 0:763b80993db4 679 HTS221_Error_et HTS221_Get_PowerDownMode(void *handle, HTS221_BitStatus_et* status)
cparata 0:763b80993db4 680 {
cparata 0:763b80993db4 681 uint8_t tmp;
cparata 0:763b80993db4 682
cparata 0:763b80993db4 683 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 684 return HTS221_ERROR;
cparata 0:763b80993db4 685
cparata 0:763b80993db4 686 *status = (HTS221_BitStatus_et)((tmp & HTS221_PD_MASK) >> HTS221_PD_BIT);
cparata 0:763b80993db4 687
cparata 0:763b80993db4 688 return HTS221_OK;
cparata 0:763b80993db4 689 }
cparata 0:763b80993db4 690
cparata 0:763b80993db4 691 /**
cparata 0:763b80993db4 692 * @brief Set the output data rate mode.
cparata 0:763b80993db4 693 * @param *handle Device handle.
cparata 0:763b80993db4 694 * @param odr is the output data rate mode.
cparata 0:763b80993db4 695 * This parameter is a @ref HTS221_Odr_et.
cparata 0:763b80993db4 696 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 697 */
cparata 0:763b80993db4 698 HTS221_Error_et HTS221_Set_Odr(void *handle, HTS221_Odr_et odr)
cparata 0:763b80993db4 699 {
cparata 0:763b80993db4 700 uint8_t tmp;
cparata 0:763b80993db4 701
cparata 0:763b80993db4 702 HTS221_assert_param(IS_HTS221_ODR(odr));
cparata 0:763b80993db4 703
cparata 0:763b80993db4 704 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 705 return HTS221_ERROR;
cparata 0:763b80993db4 706
cparata 0:763b80993db4 707 tmp &= ~HTS221_ODR_MASK;
cparata 0:763b80993db4 708 tmp |= (uint8_t)odr;
cparata 0:763b80993db4 709
cparata 0:763b80993db4 710 if(HTS221_WriteReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 711 return HTS221_ERROR;
cparata 0:763b80993db4 712
cparata 0:763b80993db4 713 return HTS221_OK;
cparata 0:763b80993db4 714 }
cparata 0:763b80993db4 715
cparata 0:763b80993db4 716 /**
cparata 0:763b80993db4 717 * @brief Get the output data rate mode.
cparata 0:763b80993db4 718 * @param *handle Device handle.
cparata 0:763b80993db4 719 * @param Pointer to the returned value with output data rate mode.
cparata 0:763b80993db4 720 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 721 */
cparata 0:763b80993db4 722 HTS221_Error_et HTS221_Get_Odr(void *handle, HTS221_Odr_et* odr)
cparata 0:763b80993db4 723 {
cparata 0:763b80993db4 724 uint8_t tmp;
cparata 0:763b80993db4 725
cparata 0:763b80993db4 726 if(HTS221_ReadReg(handle, HTS221_CTRL_REG1, 1, &tmp))
cparata 0:763b80993db4 727 return HTS221_ERROR;
cparata 0:763b80993db4 728
cparata 0:763b80993db4 729 tmp &= HTS221_ODR_MASK;
cparata 0:763b80993db4 730 *odr = (HTS221_Odr_et)tmp;
cparata 0:763b80993db4 731
cparata 0:763b80993db4 732 return HTS221_OK;
cparata 0:763b80993db4 733 }
cparata 0:763b80993db4 734
cparata 0:763b80993db4 735 /**
cparata 0:763b80993db4 736 * @brief Reboot Memory Content.
cparata 0:763b80993db4 737 * @param *handle Device handle.
cparata 0:763b80993db4 738 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 739 */
cparata 0:763b80993db4 740 HTS221_Error_et HTS221_MemoryBoot(void *handle)
cparata 0:763b80993db4 741 {
cparata 0:763b80993db4 742 uint8_t tmp;
cparata 0:763b80993db4 743
cparata 0:763b80993db4 744 if(HTS221_ReadReg(handle, HTS221_CTRL_REG2, 1, &tmp))
cparata 0:763b80993db4 745 return HTS221_ERROR;
cparata 0:763b80993db4 746
cparata 0:763b80993db4 747 tmp |= HTS221_BOOT_MASK;
cparata 0:763b80993db4 748
cparata 0:763b80993db4 749 if(HTS221_WriteReg(handle, HTS221_CTRL_REG2, 1, &tmp))
cparata 0:763b80993db4 750 return HTS221_ERROR;
cparata 0:763b80993db4 751
cparata 0:763b80993db4 752 return HTS221_OK;
cparata 0:763b80993db4 753 }
cparata 0:763b80993db4 754
cparata 0:763b80993db4 755 /**
cparata 0:763b80993db4 756 * @brief Configure the internal heater.
cparata 0:763b80993db4 757 * @param *handle Device handle.
cparata 0:763b80993db4 758 * @param The status of the internal heater [HTS221_ENABLE/HTS221_DISABLE].
cparata 0:763b80993db4 759 * This parameter is a @ref HTS221_State_et.
cparata 0:763b80993db4 760 * @retval Error code [HTS221_OK, HTS221_ERROR]
cparata 0:763b80993db4 761 */
cparata 0:763b80993db4 762 HTS221_Error_et HTS221_Set_HeaterState(void *handle, HTS221_State_et status)
cparata 0:763b80993db4 763 {
cparata 0:763b80993db4 764 uint8_t tmp;
cparata 0:763b80993db4 765
cparata 0:763b80993db4 766 HTS221_assert_param(IS_HTS221_State(status));
cparata 0:763b80993db4 767
cparata 0:763b80993db4 768 if(HTS221_ReadReg(handle, HTS221_CTRL_REG2, 1, &tmp))
cparata 0:763b80993db4 769 return HTS221_ERROR;
cparata 0:763b80993db4 770
cparata 0:763b80993db4 771 tmp &= ~HTS221_HEATHER_MASK;
cparata 0:763b80993db4 772 tmp |= ((uint8_t)status) << HTS221_HEATHER_BIT;
cparata 0:763b80993db4 773
cparata 0:763b80993db4 774 if(HTS221_WriteReg(handle, HTS221_CTRL_REG2, 1, &tmp))
cparata 0:763b80993db4 775 return HTS221_ERROR;
cparata 0:763b80993db4 776
cparata 0:763b80993db4 777 return HTS221_OK;
cparata 0:763b80993db4 778 }
cparata 0:763b80993db4 779
cparata 0:763b80993db4 780 /**
cparata 0:763b80993db4 781 * @brief Get the internal heater.
cparata 0:763b80993db4 782 * @param *handle Device handle.
cparata 0:763b80993db4 783 * @param Pointer to the returned status of the internal heater [HTS221_ENABLE/HTS221_DISABLE].
cparata 0:763b80993db4 784 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 785 */
cparata 0:763b80993db4 786 HTS221_Error_et HTS221_Get_HeaterState(void *handle, HTS221_State_et* status)
cparata 0:763b80993db4 787 {
cparata 0:763b80993db4 788 uint8_t tmp;
cparata 0:763b80993db4 789
cparata 0:763b80993db4 790 if(HTS221_ReadReg(handle, HTS221_CTRL_REG2, 1, &tmp))
cparata 0:763b80993db4 791 return HTS221_ERROR;
cparata 0:763b80993db4 792
cparata 0:763b80993db4 793 *status = (HTS221_State_et)((tmp & HTS221_HEATHER_MASK) >> HTS221_HEATHER_BIT);
cparata 0:763b80993db4 794
cparata 0:763b80993db4 795 return HTS221_OK;
cparata 0:763b80993db4 796 }
cparata 0:763b80993db4 797
cparata 0:763b80993db4 798 /**
cparata 0:763b80993db4 799 * @brief Set ONE_SHOT bit to start a new conversion (ODR mode has to be 00).
cparata 0:763b80993db4 800 * Once the measurement is done, ONE_SHOT bit is self-cleared.
cparata 0:763b80993db4 801 * @param *handle Device handle.
cparata 0:763b80993db4 802 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 803 */
cparata 0:763b80993db4 804 HTS221_Error_et HTS221_StartOneShotMeasurement(void *handle)
cparata 0:763b80993db4 805 {
cparata 0:763b80993db4 806 uint8_t tmp;
cparata 0:763b80993db4 807
cparata 0:763b80993db4 808 if(HTS221_ReadReg(handle, HTS221_CTRL_REG2, 1, &tmp))
cparata 0:763b80993db4 809 return HTS221_ERROR;
cparata 0:763b80993db4 810
cparata 0:763b80993db4 811 tmp |= HTS221_ONE_SHOT_MASK;
cparata 0:763b80993db4 812
cparata 0:763b80993db4 813 if(HTS221_WriteReg(handle, HTS221_CTRL_REG2, 1, &tmp))
cparata 0:763b80993db4 814 return HTS221_ERROR;
cparata 0:763b80993db4 815
cparata 0:763b80993db4 816 return HTS221_OK;
cparata 0:763b80993db4 817
cparata 0:763b80993db4 818 }
cparata 0:763b80993db4 819
cparata 0:763b80993db4 820 /**
cparata 0:763b80993db4 821 * @brief Set level configuration of the interrupt pin DRDY.
cparata 0:763b80993db4 822 * @param *handle Device handle.
cparata 0:763b80993db4 823 * @param status can be HTS221_LOW_LVL: active level is LOW.
cparata 0:763b80993db4 824 * @param status can be HTS221_HIGH_LVL: active level is HIGH.
cparata 0:763b80993db4 825 * This parameter is a @ref HTS221_State_et.
cparata 0:763b80993db4 826 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 827 */
cparata 0:763b80993db4 828 HTS221_Error_et HTS221_Set_IrqActiveLevel(void *handle, HTS221_DrdyLevel_et value)
cparata 0:763b80993db4 829 {
cparata 0:763b80993db4 830 uint8_t tmp;
cparata 0:763b80993db4 831
cparata 0:763b80993db4 832 HTS221_assert_param(IS_HTS221_DrdyLevelType(value));
cparata 0:763b80993db4 833
cparata 0:763b80993db4 834 if(HTS221_ReadReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 835 return HTS221_ERROR;
cparata 0:763b80993db4 836
cparata 0:763b80993db4 837 tmp &= ~HTS221_DRDY_H_L_MASK;
cparata 0:763b80993db4 838 tmp |= (uint8_t)value;
cparata 0:763b80993db4 839
cparata 0:763b80993db4 840 if(HTS221_WriteReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 841 return HTS221_ERROR;
cparata 0:763b80993db4 842
cparata 0:763b80993db4 843 return HTS221_OK;
cparata 0:763b80993db4 844 }
cparata 0:763b80993db4 845
cparata 0:763b80993db4 846 /**
cparata 0:763b80993db4 847 * @brief Get level configuration of the interrupt pin DRDY.
cparata 0:763b80993db4 848 * @param *handle Device handle.
cparata 0:763b80993db4 849 * @param Pointer to the returned status of the level configuration [HTS221_ENABLE/HTS221_DISABLE].
cparata 0:763b80993db4 850 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 851 */
cparata 0:763b80993db4 852 HTS221_Error_et HTS221_Get_IrqActiveLevel(void *handle, HTS221_DrdyLevel_et* value)
cparata 0:763b80993db4 853 {
cparata 0:763b80993db4 854 uint8_t tmp;
cparata 0:763b80993db4 855
cparata 0:763b80993db4 856 if(HTS221_ReadReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 857 return HTS221_ERROR;
cparata 0:763b80993db4 858
cparata 0:763b80993db4 859 *value = (HTS221_DrdyLevel_et)(tmp & HTS221_DRDY_H_L_MASK);
cparata 0:763b80993db4 860
cparata 0:763b80993db4 861 return HTS221_OK;
cparata 0:763b80993db4 862 }
cparata 0:763b80993db4 863
cparata 0:763b80993db4 864 /**
cparata 0:763b80993db4 865 * @brief Set Push-pull/open drain configuration for the interrupt pin DRDY.
cparata 0:763b80993db4 866 * @param *handle Device handle.
cparata 0:763b80993db4 867 * @param value is the output type configuration.
cparata 0:763b80993db4 868 * This parameter is a @ref HTS221_OutputType_et.
cparata 0:763b80993db4 869 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 870 */
cparata 0:763b80993db4 871 HTS221_Error_et HTS221_Set_IrqOutputType(void *handle, HTS221_OutputType_et value)
cparata 0:763b80993db4 872 {
cparata 0:763b80993db4 873 uint8_t tmp;
cparata 0:763b80993db4 874
cparata 0:763b80993db4 875 HTS221_assert_param(IS_HTS221_OutputType(value));
cparata 0:763b80993db4 876
cparata 0:763b80993db4 877 if(HTS221_ReadReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 878 return HTS221_ERROR;
cparata 0:763b80993db4 879
cparata 0:763b80993db4 880 tmp &= ~HTS221_PP_OD_MASK;
cparata 0:763b80993db4 881 tmp |= (uint8_t)value;
cparata 0:763b80993db4 882
cparata 0:763b80993db4 883 if(HTS221_WriteReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 884 return HTS221_ERROR;
cparata 0:763b80993db4 885
cparata 0:763b80993db4 886 return HTS221_OK;
cparata 0:763b80993db4 887 }
cparata 0:763b80993db4 888
cparata 0:763b80993db4 889 /**
cparata 0:763b80993db4 890 * @brief Get the configuration for the interrupt pin DRDY.
cparata 0:763b80993db4 891 * @param *handle Device handle.
cparata 0:763b80993db4 892 * @param Pointer to the returned value with output type configuration.
cparata 0:763b80993db4 893 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 894 */
cparata 0:763b80993db4 895 HTS221_Error_et HTS221_Get_IrqOutputType(void *handle, HTS221_OutputType_et* value)
cparata 0:763b80993db4 896 {
cparata 0:763b80993db4 897 uint8_t tmp;
cparata 0:763b80993db4 898
cparata 0:763b80993db4 899 if(HTS221_ReadReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 900 return HTS221_ERROR;
cparata 0:763b80993db4 901
cparata 0:763b80993db4 902 *value = (HTS221_OutputType_et)(tmp & HTS221_PP_OD_MASK);
cparata 0:763b80993db4 903
cparata 0:763b80993db4 904 return HTS221_OK;
cparata 0:763b80993db4 905 }
cparata 0:763b80993db4 906
cparata 0:763b80993db4 907 /**
cparata 0:763b80993db4 908 * @brief Enable/disable the interrupt mode.
cparata 0:763b80993db4 909 * @param *handle Device handle.
cparata 0:763b80993db4 910 * @param status is the enable/disable for the interrupt mode.
cparata 0:763b80993db4 911 * This parameter is a @ref HTS221_State_et.
cparata 0:763b80993db4 912 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 913 */
cparata 0:763b80993db4 914 HTS221_Error_et HTS221_Set_IrqEnable(void *handle, HTS221_State_et status)
cparata 0:763b80993db4 915 {
cparata 0:763b80993db4 916 uint8_t tmp;
cparata 0:763b80993db4 917
cparata 0:763b80993db4 918 HTS221_assert_param(IS_HTS221_State(status));
cparata 0:763b80993db4 919
cparata 0:763b80993db4 920 if(HTS221_ReadReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 921 return HTS221_ERROR;
cparata 0:763b80993db4 922
cparata 0:763b80993db4 923 tmp &= ~HTS221_DRDY_MASK;
cparata 0:763b80993db4 924 tmp |= ((uint8_t)status) << HTS221_DRDY_BIT;
cparata 0:763b80993db4 925
cparata 0:763b80993db4 926 if(HTS221_WriteReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 927 return HTS221_ERROR;
cparata 0:763b80993db4 928
cparata 0:763b80993db4 929 return HTS221_OK;
cparata 0:763b80993db4 930 }
cparata 0:763b80993db4 931
cparata 0:763b80993db4 932 /**
cparata 0:763b80993db4 933 * @brief Get the interrupt mode.
cparata 0:763b80993db4 934 * @param *handle Device handle.
cparata 0:763b80993db4 935 * @param Pointer to the returned status of the interrupt mode configuration [HTS221_ENABLE/HTS221_DISABLE].
cparata 0:763b80993db4 936 * @retval Error code [HTS221_OK, HTS221_ERROR].
cparata 0:763b80993db4 937 */
cparata 0:763b80993db4 938 HTS221_Error_et HTS221_Get_IrqEnable(void *handle, HTS221_State_et* status)
cparata 0:763b80993db4 939 {
cparata 0:763b80993db4 940 uint8_t tmp;
cparata 0:763b80993db4 941
cparata 0:763b80993db4 942 if(HTS221_ReadReg(handle, HTS221_CTRL_REG3, 1, &tmp))
cparata 0:763b80993db4 943 return HTS221_ERROR;
cparata 0:763b80993db4 944
cparata 0:763b80993db4 945 *status = (HTS221_State_et)((tmp & HTS221_DRDY_MASK) >> HTS221_DRDY_BIT);
cparata 0:763b80993db4 946
cparata 0:763b80993db4 947 return HTS221_OK;
cparata 0:763b80993db4 948 }
cparata 0:763b80993db4 949
cparata 0:763b80993db4 950
cparata 0:763b80993db4 951 #ifdef USE_FULL_ASSERT_HTS221
cparata 0:763b80993db4 952 /**
cparata 0:763b80993db4 953 * @brief Reports the name of the source file and the source line number
cparata 0:763b80993db4 954 * where the assert_param error has occurred.
cparata 0:763b80993db4 955 * @param file: pointer to the source file name
cparata 0:763b80993db4 956 * @param line: assert_param error line source number
cparata 0:763b80993db4 957 * @retval : None
cparata 0:763b80993db4 958 */
cparata 0:763b80993db4 959 void HTS221_assert_failed(uint8_t* file, uint32_t line)
cparata 0:763b80993db4 960 {
cparata 0:763b80993db4 961 /* User can add his own implementation to report the file name and line number */
cparata 0:763b80993db4 962 printf("Wrong parameters value: file %s on line %d\r\n", file, (int)line);
cparata 0:763b80993db4 963
cparata 0:763b80993db4 964 /* Infinite loop */
cparata 0:763b80993db4 965 while (1)
cparata 0:763b80993db4 966 {
cparata 0:763b80993db4 967 }
cparata 0:763b80993db4 968 }
cparata 0:763b80993db4 969 #endif
cparata 0:763b80993db4 970
cparata 0:763b80993db4 971 #ifdef __cplusplus
cparata 0:763b80993db4 972 }
cparata 0:763b80993db4 973 #endif
cparata 0:763b80993db4 974
cparata 0:763b80993db4 975 /**
cparata 0:763b80993db4 976 * @}
cparata 0:763b80993db4 977 */
cparata 0:763b80993db4 978
cparata 0:763b80993db4 979 /**
cparata 0:763b80993db4 980 * @}
cparata 0:763b80993db4 981 */
cparata 0:763b80993db4 982
cparata 0:763b80993db4 983 /**
cparata 0:763b80993db4 984 * @}
cparata 0:763b80993db4 985 */
cparata 0:763b80993db4 986
cparata 0:763b80993db4 987 /******************* (C) COPYRIGHT 2013 STMicroelectronics *****END OF FILE****/