Example of tilt detection for LSM6DSL in X-NUCLEO-IKS01A2

Dependencies:   X_NUCLEO_IKS01A2 mbed

Fork of Tilt_IKS01A2 by ST Expansion SW Team

Tilt Detection Demo Application based on sensor expansion board X-NUCLEO-IKS01A2

Main function is to show how to detect the tilt event 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 try to tilt the board and then view the notification using an hyper terminal. When the tilt event is detected, the LED is switched on for a while.
- the user button can be used to enable/disable the tilt detection feature.

Committer:
cparata
Date:
Fri Aug 19 12:34:01 2016 +0000
Revision:
2:39ad2a393143
Parent:
0:489965565a0d
Add interfaces to all components

Who changed what in which revision?

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