Example of single tap and double tap detection for LSM6DSL in X-NUCLEO-IKS01A2

Dependencies:   X_NUCLEO_IKS01A2 mbed

Fork of SingleDoubleTap_IKS01A2 by ST Expansion SW Team

Single and Double Tap Demo Application based on sensor expansion board X-NUCLEO-IKS01A2

Main function is to show how to detect the single and double tap 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 try to tap the board and then view the notification using an hyper terminal. When the single tap is detected, the LED is switched on for a while.
- the user can press the user button to pass from the single tap detection to the double tap detection feature. The user can try to double tap the board and then view the notification using an hyper terminal. When the double tap is detected, the LED is switched on twice for a while.
- the user can press again the user button to disable the single and double tap detection feature.
- the user can press the user button to enable again the single tap detection feature and so on.

Committer:
cparata
Date:
Fri Aug 19 12:31:21 2016 +0000
Revision:
2:21a191bd1998
Parent:
0:e4f89df7a7a5
Add interfaces to all components

Who changed what in which revision?

UserRevisionLine numberNew contents of line
cparata 0:e4f89df7a7a5 1 /**
cparata 0:e4f89df7a7a5 2 ******************************************************************************
cparata 0:e4f89df7a7a5 3 * @file HTS221_Driver.h
cparata 0:e4f89df7a7a5 4 * @author HESA Application Team
cparata 0:e4f89df7a7a5 5 * @version V1.1
cparata 0:e4f89df7a7a5 6 * @date 10-August-2016
cparata 0:e4f89df7a7a5 7 * @brief HTS221 driver header file
cparata 0:e4f89df7a7a5 8 ******************************************************************************
cparata 0:e4f89df7a7a5 9 * @attention
cparata 0:e4f89df7a7a5 10 *
cparata 0:e4f89df7a7a5 11 * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
cparata 0:e4f89df7a7a5 12 *
cparata 0:e4f89df7a7a5 13 * Redistribution and use in source and binary forms, with or without modification,
cparata 0:e4f89df7a7a5 14 * are permitted provided that the following conditions are met:
cparata 0:e4f89df7a7a5 15 * 1. Redistributions of source code must retain the above copyright notice,
cparata 0:e4f89df7a7a5 16 * this list of conditions and the following disclaimer.
cparata 0:e4f89df7a7a5 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
cparata 0:e4f89df7a7a5 18 * this list of conditions and the following disclaimer in the documentation
cparata 0:e4f89df7a7a5 19 * and/or other materials provided with the distribution.
cparata 0:e4f89df7a7a5 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
cparata 0:e4f89df7a7a5 21 * may be used to endorse or promote products derived from this software
cparata 0:e4f89df7a7a5 22 * without specific prior written permission.
cparata 0:e4f89df7a7a5 23 *
cparata 0:e4f89df7a7a5 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
cparata 0:e4f89df7a7a5 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
cparata 0:e4f89df7a7a5 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
cparata 0:e4f89df7a7a5 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
cparata 0:e4f89df7a7a5 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
cparata 0:e4f89df7a7a5 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
cparata 0:e4f89df7a7a5 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
cparata 0:e4f89df7a7a5 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
cparata 0:e4f89df7a7a5 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
cparata 0:e4f89df7a7a5 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
cparata 0:e4f89df7a7a5 34 *
cparata 0:e4f89df7a7a5 35 ******************************************************************************
cparata 0:e4f89df7a7a5 36 */
cparata 0:e4f89df7a7a5 37
cparata 0:e4f89df7a7a5 38 /* Define to prevent recursive inclusion -------------------------------------*/
cparata 0:e4f89df7a7a5 39 #ifndef __HTS221_DRIVER__H
cparata 0:e4f89df7a7a5 40 #define __HTS221_DRIVER__H
cparata 0:e4f89df7a7a5 41
cparata 0:e4f89df7a7a5 42 #include <stdint.h>
cparata 0:e4f89df7a7a5 43
cparata 0:e4f89df7a7a5 44 #ifdef __cplusplus
cparata 0:e4f89df7a7a5 45 extern "C" {
cparata 0:e4f89df7a7a5 46 #endif
cparata 0:e4f89df7a7a5 47
cparata 0:e4f89df7a7a5 48 /* Uncomment the line below to expanse the "assert_param" macro in the drivers code */
cparata 0:e4f89df7a7a5 49 #define USE_FULL_ASSERT_HTS221
cparata 0:e4f89df7a7a5 50
cparata 0:e4f89df7a7a5 51 /* Exported macro ------------------------------------------------------------*/
cparata 0:e4f89df7a7a5 52 #ifdef USE_FULL_ASSERT_HTS221
cparata 0:e4f89df7a7a5 53
cparata 0:e4f89df7a7a5 54 /**
cparata 0:e4f89df7a7a5 55 * @brief The assert_param macro is used for function's parameters check.
cparata 0:e4f89df7a7a5 56 * @param expr: If expr is false, it calls assert_failed function which reports
cparata 0:e4f89df7a7a5 57 * the name of the source file and the source line number of the call
cparata 0:e4f89df7a7a5 58 * that failed. If expr is true, it returns no value.
cparata 0:e4f89df7a7a5 59 * @retval None
cparata 0:e4f89df7a7a5 60 */
cparata 0:e4f89df7a7a5 61 #define HTS221_assert_param(expr) ((expr) ? (void)0 : HTS221_assert_failed((uint8_t *)__FILE__, __LINE__))
cparata 0:e4f89df7a7a5 62 /* Exported functions ------------------------------------------------------- */
cparata 0:e4f89df7a7a5 63 void HTS221_assert_failed(uint8_t* file, uint32_t line);
cparata 0:e4f89df7a7a5 64 #else
cparata 0:e4f89df7a7a5 65 #define HTS221_assert_param(expr) ((void)0)
cparata 0:e4f89df7a7a5 66 #endif /* USE_FULL_ASSERT_HTS221 */
cparata 0:e4f89df7a7a5 67
cparata 0:e4f89df7a7a5 68 /** @addtogroup Environmental_Sensor
cparata 0:e4f89df7a7a5 69 * @{
cparata 0:e4f89df7a7a5 70 */
cparata 0:e4f89df7a7a5 71
cparata 0:e4f89df7a7a5 72 /** @addtogroup HTS221_DRIVER
cparata 0:e4f89df7a7a5 73 * @{
cparata 0:e4f89df7a7a5 74 */
cparata 0:e4f89df7a7a5 75
cparata 0:e4f89df7a7a5 76 /* Exported Types -------------------------------------------------------------*/
cparata 0:e4f89df7a7a5 77 /** @defgroup HTS221_Exported_Types
cparata 0:e4f89df7a7a5 78 * @{
cparata 0:e4f89df7a7a5 79 */
cparata 0:e4f89df7a7a5 80
cparata 0:e4f89df7a7a5 81
cparata 0:e4f89df7a7a5 82 /**
cparata 0:e4f89df7a7a5 83 * @brief Error code type.
cparata 0:e4f89df7a7a5 84 */
cparata 0:e4f89df7a7a5 85 typedef enum {HTS221_OK = (uint8_t)0, HTS221_ERROR = !HTS221_OK} HTS221_Error_et;
cparata 0:e4f89df7a7a5 86
cparata 0:e4f89df7a7a5 87 /**
cparata 0:e4f89df7a7a5 88 * @brief State type.
cparata 0:e4f89df7a7a5 89 */
cparata 0:e4f89df7a7a5 90 typedef enum {HTS221_DISABLE = (uint8_t)0, HTS221_ENABLE = !HTS221_DISABLE} HTS221_State_et;
cparata 0:e4f89df7a7a5 91 #define IS_HTS221_State(MODE) ((MODE == HTS221_ENABLE) || (MODE == HTS221_DISABLE))
cparata 0:e4f89df7a7a5 92
cparata 0:e4f89df7a7a5 93 /**
cparata 0:e4f89df7a7a5 94 * @brief Bit status type.
cparata 0:e4f89df7a7a5 95 */
cparata 0:e4f89df7a7a5 96 typedef enum {HTS221_RESET = (uint8_t)0, HTS221_SET = !HTS221_RESET} HTS221_BitStatus_et;
cparata 0:e4f89df7a7a5 97 #define IS_HTS221_BitStatus(MODE) ((MODE == HTS221_RESET) || (MODE == HTS221_SET))
cparata 0:e4f89df7a7a5 98
cparata 0:e4f89df7a7a5 99 /**
cparata 0:e4f89df7a7a5 100 * @brief Humidity average.
cparata 0:e4f89df7a7a5 101 */
cparata 0:e4f89df7a7a5 102 typedef enum
cparata 0:e4f89df7a7a5 103 {
cparata 0:e4f89df7a7a5 104 HTS221_AVGH_4 = (uint8_t)0x00, /*!< Internal average on 4 samples */
cparata 0:e4f89df7a7a5 105 HTS221_AVGH_8 = (uint8_t)0x01, /*!< Internal average on 8 samples */
cparata 0:e4f89df7a7a5 106 HTS221_AVGH_16 = (uint8_t)0x02, /*!< Internal average on 16 samples */
cparata 0:e4f89df7a7a5 107 HTS221_AVGH_32 = (uint8_t)0x03, /*!< Internal average on 32 samples */
cparata 0:e4f89df7a7a5 108 HTS221_AVGH_64 = (uint8_t)0x04, /*!< Internal average on 64 samples */
cparata 0:e4f89df7a7a5 109 HTS221_AVGH_128 = (uint8_t)0x05, /*!< Internal average on 128 samples */
cparata 0:e4f89df7a7a5 110 HTS221_AVGH_256 = (uint8_t)0x06, /*!< Internal average on 256 samples */
cparata 0:e4f89df7a7a5 111 HTS221_AVGH_512 = (uint8_t)0x07 /*!< Internal average on 512 samples */
cparata 0:e4f89df7a7a5 112 } HTS221_Avgh_et;
cparata 0:e4f89df7a7a5 113 #define IS_HTS221_AVGH(AVGH) ((AVGH == HTS221_AVGH_4) || (AVGH == HTS221_AVGH_8) || \
cparata 0:e4f89df7a7a5 114 (AVGH == HTS221_AVGH_16) || (AVGH == HTS221_AVGH_32) || \
cparata 0:e4f89df7a7a5 115 (AVGH == HTS221_AVGH_64) || (AVGH == HTS221_AVGH_128) || \
cparata 0:e4f89df7a7a5 116 (AVGH == HTS221_AVGH_256) || (AVGH == HTS221_AVGH_512))
cparata 0:e4f89df7a7a5 117
cparata 0:e4f89df7a7a5 118 /**
cparata 0:e4f89df7a7a5 119 * @brief Temperature average.
cparata 0:e4f89df7a7a5 120 */
cparata 0:e4f89df7a7a5 121 typedef enum
cparata 0:e4f89df7a7a5 122 {
cparata 0:e4f89df7a7a5 123 HTS221_AVGT_2 = (uint8_t)0x00, /*!< Internal average on 2 samples */
cparata 0:e4f89df7a7a5 124 HTS221_AVGT_4 = (uint8_t)0x08, /*!< Internal average on 4 samples */
cparata 0:e4f89df7a7a5 125 HTS221_AVGT_8 = (uint8_t)0x10, /*!< Internal average on 8 samples */
cparata 0:e4f89df7a7a5 126 HTS221_AVGT_16 = (uint8_t)0x18, /*!< Internal average on 16 samples */
cparata 0:e4f89df7a7a5 127 HTS221_AVGT_32 = (uint8_t)0x20, /*!< Internal average on 32 samples */
cparata 0:e4f89df7a7a5 128 HTS221_AVGT_64 = (uint8_t)0x28, /*!< Internal average on 64 samples */
cparata 0:e4f89df7a7a5 129 HTS221_AVGT_128 = (uint8_t)0x30, /*!< Internal average on 128 samples */
cparata 0:e4f89df7a7a5 130 HTS221_AVGT_256 = (uint8_t)0x38 /*!< Internal average on 256 samples */
cparata 0:e4f89df7a7a5 131 } HTS221_Avgt_et;
cparata 0:e4f89df7a7a5 132 #define IS_HTS221_AVGT(AVGT) ((AVGT == HTS221_AVGT_2) || (AVGT == HTS221_AVGT_4) || \
cparata 0:e4f89df7a7a5 133 (AVGT == HTS221_AVGT_8) || (AVGT == HTS221_AVGT_16) || \
cparata 0:e4f89df7a7a5 134 (AVGT == HTS221_AVGT_32) || (AVGT == HTS221_AVGT_64) || \
cparata 0:e4f89df7a7a5 135 (AVGT == HTS221_AVGT_128) || (AVGT == HTS221_AVGT_256))
cparata 0:e4f89df7a7a5 136
cparata 0:e4f89df7a7a5 137 /**
cparata 0:e4f89df7a7a5 138 * @brief Output data rate configuration.
cparata 0:e4f89df7a7a5 139 */
cparata 0:e4f89df7a7a5 140 typedef enum
cparata 0:e4f89df7a7a5 141 {
cparata 0:e4f89df7a7a5 142 HTS221_ODR_ONE_SHOT = (uint8_t)0x00, /*!< Output Data Rate: one shot */
cparata 0:e4f89df7a7a5 143 HTS221_ODR_1HZ = (uint8_t)0x01, /*!< Output Data Rate: 1Hz */
cparata 0:e4f89df7a7a5 144 HTS221_ODR_7HZ = (uint8_t)0x02, /*!< Output Data Rate: 7Hz */
cparata 0:e4f89df7a7a5 145 HTS221_ODR_12_5HZ = (uint8_t)0x03, /*!< Output Data Rate: 12.5Hz */
cparata 0:e4f89df7a7a5 146 } HTS221_Odr_et;
cparata 0:e4f89df7a7a5 147 #define IS_HTS221_ODR(ODR) ((ODR == HTS221_ODR_ONE_SHOT) || (ODR == HTS221_ODR_1HZ) || \
cparata 0:e4f89df7a7a5 148 (ODR == HTS221_ODR_7HZ) || (ODR == HTS221_ODR_12_5HZ))
cparata 0:e4f89df7a7a5 149
cparata 0:e4f89df7a7a5 150
cparata 0:e4f89df7a7a5 151 /**
cparata 0:e4f89df7a7a5 152 * @brief Push-pull/Open Drain selection on DRDY pin.
cparata 0:e4f89df7a7a5 153 */
cparata 0:e4f89df7a7a5 154 typedef enum
cparata 0:e4f89df7a7a5 155 {
cparata 0:e4f89df7a7a5 156 HTS221_PUSHPULL = (uint8_t)0x00, /*!< DRDY pin in push pull */
cparata 0:e4f89df7a7a5 157 HTS221_OPENDRAIN = (uint8_t)0x40 /*!< DRDY pin in open drain */
cparata 0:e4f89df7a7a5 158 } HTS221_OutputType_et;
cparata 0:e4f89df7a7a5 159 #define IS_HTS221_OutputType(MODE) ((MODE == HTS221_PUSHPULL) || (MODE == HTS221_OPENDRAIN))
cparata 0:e4f89df7a7a5 160
cparata 0:e4f89df7a7a5 161 /**
cparata 0:e4f89df7a7a5 162 * @brief Active level of DRDY pin.
cparata 0:e4f89df7a7a5 163 */
cparata 0:e4f89df7a7a5 164 typedef enum
cparata 0:e4f89df7a7a5 165 {
cparata 0:e4f89df7a7a5 166 HTS221_HIGH_LVL = (uint8_t)0x00, /*!< HIGH state level for DRDY pin */
cparata 0:e4f89df7a7a5 167 HTS221_LOW_LVL = (uint8_t)0x80 /*!< LOW state level for DRDY pin */
cparata 0:e4f89df7a7a5 168 } HTS221_DrdyLevel_et;
cparata 0:e4f89df7a7a5 169 #define IS_HTS221_DrdyLevelType(MODE) ((MODE == HTS221_HIGH_LVL) || (MODE == HTS221_LOW_LVL))
cparata 0:e4f89df7a7a5 170
cparata 0:e4f89df7a7a5 171 /**
cparata 0:e4f89df7a7a5 172 * @brief Driver Version Info structure definition.
cparata 0:e4f89df7a7a5 173 */
cparata 0:e4f89df7a7a5 174 typedef struct
cparata 0:e4f89df7a7a5 175 {
cparata 0:e4f89df7a7a5 176 uint8_t Major;
cparata 0:e4f89df7a7a5 177 uint8_t Minor;
cparata 0:e4f89df7a7a5 178 uint8_t Point;
cparata 0:e4f89df7a7a5 179 } HTS221_DriverVersion_st;
cparata 0:e4f89df7a7a5 180
cparata 0:e4f89df7a7a5 181
cparata 0:e4f89df7a7a5 182 /**
cparata 0:e4f89df7a7a5 183 * @brief HTS221 Init structure definition.
cparata 0:e4f89df7a7a5 184 */
cparata 0:e4f89df7a7a5 185 typedef struct
cparata 0:e4f89df7a7a5 186 {
cparata 0:e4f89df7a7a5 187 HTS221_Avgh_et avg_h; /*!< Humidity average */
cparata 0:e4f89df7a7a5 188 HTS221_Avgt_et avg_t; /*!< Temperature average */
cparata 0:e4f89df7a7a5 189 HTS221_Odr_et odr; /*!< Output data rate */
cparata 0:e4f89df7a7a5 190 HTS221_State_et bdu_status; /*!< HTS221_ENABLE/HTS221_DISABLE the block data update */
cparata 0:e4f89df7a7a5 191 HTS221_State_et heater_status; /*!< HTS221_ENABLE/HTS221_DISABLE the internal heater */
cparata 0:e4f89df7a7a5 192
cparata 0:e4f89df7a7a5 193 HTS221_DrdyLevel_et irq_level; /*!< HTS221_HIGH_LVL/HTS221_LOW_LVL the level for DRDY pin */
cparata 0:e4f89df7a7a5 194 HTS221_OutputType_et irq_output_type; /*!< Output configuration for DRDY pin */
cparata 0:e4f89df7a7a5 195 HTS221_State_et irq_enable; /*!< HTS221_ENABLE/HTS221_DISABLE interrupt on DRDY pin */
cparata 0:e4f89df7a7a5 196 } HTS221_Init_st;
cparata 0:e4f89df7a7a5 197
cparata 0:e4f89df7a7a5 198 /**
cparata 0:e4f89df7a7a5 199 * @}
cparata 0:e4f89df7a7a5 200 */
cparata 0:e4f89df7a7a5 201
cparata 0:e4f89df7a7a5 202
cparata 0:e4f89df7a7a5 203 /* Exported Constants ---------------------------------------------------------*/
cparata 0:e4f89df7a7a5 204 /** @defgroup HTS221_Exported_Constants
cparata 0:e4f89df7a7a5 205 * @{
cparata 0:e4f89df7a7a5 206 */
cparata 0:e4f89df7a7a5 207
cparata 0:e4f89df7a7a5 208 /**
cparata 0:e4f89df7a7a5 209 * @brief Bitfield positioning.
cparata 0:e4f89df7a7a5 210 */
cparata 0:e4f89df7a7a5 211 #define HTS221_BIT(x) ((uint8_t)x)
cparata 0:e4f89df7a7a5 212
cparata 0:e4f89df7a7a5 213 /**
cparata 0:e4f89df7a7a5 214 * @brief I2C address.
cparata 0:e4f89df7a7a5 215 */
cparata 0:e4f89df7a7a5 216 #define HTS221_I2C_ADDRESS (uint8_t)0xBE
cparata 0:e4f89df7a7a5 217
cparata 0:e4f89df7a7a5 218 /**
cparata 0:e4f89df7a7a5 219 * @brief Driver version.
cparata 0:e4f89df7a7a5 220 */
cparata 0:e4f89df7a7a5 221 #define HTS221_DRIVER_VERSION_MAJOR (uint8_t)1
cparata 0:e4f89df7a7a5 222 #define HTS221_DRIVER_VERSION_MINOR (uint8_t)1
cparata 0:e4f89df7a7a5 223 #define HTS221_DRIVER_VERSION_POINT (uint8_t)0
cparata 0:e4f89df7a7a5 224
cparata 0:e4f89df7a7a5 225 /**
cparata 0:e4f89df7a7a5 226 * @addtogroup HTS221_Registers
cparata 0:e4f89df7a7a5 227 * @{
cparata 0:e4f89df7a7a5 228 */
cparata 0:e4f89df7a7a5 229
cparata 0:e4f89df7a7a5 230
cparata 0:e4f89df7a7a5 231 /**
cparata 0:e4f89df7a7a5 232 * @brief Device Identification register.
cparata 0:e4f89df7a7a5 233 * \code
cparata 0:e4f89df7a7a5 234 * Read
cparata 0:e4f89df7a7a5 235 * Default value: 0xBC
cparata 0:e4f89df7a7a5 236 * 7:0 This read-only register contains the device identifier for HTS221.
cparata 0:e4f89df7a7a5 237 * \endcode
cparata 0:e4f89df7a7a5 238 */
cparata 0:e4f89df7a7a5 239 #define HTS221_WHO_AM_I_REG (uint8_t)0x0F
cparata 0:e4f89df7a7a5 240
cparata 0:e4f89df7a7a5 241 /**
cparata 0:e4f89df7a7a5 242 * @brief Device Identification value.
cparata 0:e4f89df7a7a5 243 */
cparata 0:e4f89df7a7a5 244 #define HTS221_WHO_AM_I_VAL (uint8_t)0xBC
cparata 0:e4f89df7a7a5 245
cparata 0:e4f89df7a7a5 246
cparata 0:e4f89df7a7a5 247 /**
cparata 0:e4f89df7a7a5 248 * @brief Humidity and temperature average mode register.
cparata 0:e4f89df7a7a5 249 * \code
cparata 0:e4f89df7a7a5 250 * Read/write
cparata 0:e4f89df7a7a5 251 * Default value: 0x1B
cparata 0:e4f89df7a7a5 252 * 7:6 Reserved.
cparata 0:e4f89df7a7a5 253 * 5:3 AVGT2-AVGT1-AVGT0: Select the temperature internal average.
cparata 0:e4f89df7a7a5 254 *
cparata 0:e4f89df7a7a5 255 * AVGT2 | AVGT1 | AVGT0 | Nr. Internal Average
cparata 0:e4f89df7a7a5 256 * ----------------------------------------------------
cparata 0:e4f89df7a7a5 257 * 0 | 0 | 0 | 2
cparata 0:e4f89df7a7a5 258 * 0 | 0 | 1 | 4
cparata 0:e4f89df7a7a5 259 * 0 | 1 | 0 | 8
cparata 0:e4f89df7a7a5 260 * 0 | 1 | 1 | 16
cparata 0:e4f89df7a7a5 261 * 1 | 0 | 0 | 32
cparata 0:e4f89df7a7a5 262 * 1 | 0 | 1 | 64
cparata 0:e4f89df7a7a5 263 * 1 | 1 | 0 | 128
cparata 0:e4f89df7a7a5 264 * 1 | 1 | 1 | 256
cparata 0:e4f89df7a7a5 265 *
cparata 0:e4f89df7a7a5 266 * 2:0 AVGH2-AVGH1-AVGH0: Select humidity internal average.
cparata 0:e4f89df7a7a5 267 * AVGH2 | AVGH1 | AVGH0 | Nr. Internal Average
cparata 0:e4f89df7a7a5 268 * ------------------------------------------------------
cparata 0:e4f89df7a7a5 269 * 0 | 0 | 0 | 4
cparata 0:e4f89df7a7a5 270 * 0 | 0 | 1 | 8
cparata 0:e4f89df7a7a5 271 * 0 | 1 | 0 | 16
cparata 0:e4f89df7a7a5 272 * 0 | 1 | 1 | 32
cparata 0:e4f89df7a7a5 273 * 1 | 0 | 0 | 64
cparata 0:e4f89df7a7a5 274 * 1 | 0 | 1 | 128
cparata 0:e4f89df7a7a5 275 * 1 | 1 | 0 | 256
cparata 0:e4f89df7a7a5 276 * 1 | 1 | 1 | 512
cparata 0:e4f89df7a7a5 277 *
cparata 0:e4f89df7a7a5 278 * \endcode
cparata 0:e4f89df7a7a5 279 */
cparata 0:e4f89df7a7a5 280 #define HTS221_AV_CONF_REG (uint8_t)0x10
cparata 0:e4f89df7a7a5 281
cparata 0:e4f89df7a7a5 282 #define HTS221_AVGT_BIT HTS221_BIT(3)
cparata 0:e4f89df7a7a5 283 #define HTS221_AVGH_BIT HTS221_BIT(0)
cparata 0:e4f89df7a7a5 284
cparata 0:e4f89df7a7a5 285 #define HTS221_AVGH_MASK (uint8_t)0x07
cparata 0:e4f89df7a7a5 286 #define HTS221_AVGT_MASK (uint8_t)0x38
cparata 0:e4f89df7a7a5 287
cparata 0:e4f89df7a7a5 288 /**
cparata 0:e4f89df7a7a5 289 * @brief Control register 1.
cparata 0:e4f89df7a7a5 290 * \code
cparata 0:e4f89df7a7a5 291 * Read/write
cparata 0:e4f89df7a7a5 292 * Default value: 0x00
cparata 0:e4f89df7a7a5 293 * 7 PD: power down control. 0 - power down mode; 1 - active mode.
cparata 0:e4f89df7a7a5 294 * 6:3 Reserved.
cparata 0:e4f89df7a7a5 295 * 2 BDU: block data update. 0 - continuous update; 1 - output registers not updated until MSB and LSB reading.
cparata 0:e4f89df7a7a5 296 * 1:0 ODR1, ODR0: output data rate selection.
cparata 0:e4f89df7a7a5 297 *
cparata 0:e4f89df7a7a5 298 * ODR1 | ODR0 | Humidity output data-rate(Hz) | Pressure output data-rate(Hz)
cparata 0:e4f89df7a7a5 299 * ----------------------------------------------------------------------------------
cparata 0:e4f89df7a7a5 300 * 0 | 0 | one shot | one shot
cparata 0:e4f89df7a7a5 301 * 0 | 1 | 1 | 1
cparata 0:e4f89df7a7a5 302 * 1 | 0 | 7 | 7
cparata 0:e4f89df7a7a5 303 * 1 | 1 | 12.5 | 12.5
cparata 0:e4f89df7a7a5 304 *
cparata 0:e4f89df7a7a5 305 * \endcode
cparata 0:e4f89df7a7a5 306 */
cparata 0:e4f89df7a7a5 307 #define HTS221_CTRL_REG1 (uint8_t)0x20
cparata 0:e4f89df7a7a5 308
cparata 0:e4f89df7a7a5 309 #define HTS221_PD_BIT HTS221_BIT(7)
cparata 0:e4f89df7a7a5 310 #define HTS221_BDU_BIT HTS221_BIT(2)
cparata 0:e4f89df7a7a5 311 #define HTS221_ODR_BIT HTS221_BIT(0)
cparata 0:e4f89df7a7a5 312
cparata 0:e4f89df7a7a5 313 #define HTS221_PD_MASK (uint8_t)0x80
cparata 0:e4f89df7a7a5 314 #define HTS221_BDU_MASK (uint8_t)0x04
cparata 0:e4f89df7a7a5 315 #define HTS221_ODR_MASK (uint8_t)0x03
cparata 0:e4f89df7a7a5 316
cparata 0:e4f89df7a7a5 317 /**
cparata 0:e4f89df7a7a5 318 * @brief Control register 2.
cparata 0:e4f89df7a7a5 319 * \code
cparata 0:e4f89df7a7a5 320 * Read/write
cparata 0:e4f89df7a7a5 321 * Default value: 0x00
cparata 0:e4f89df7a7a5 322 * 7 BOOT: Reboot memory content. 0: normal mode; 1: reboot memory content. Self-cleared upon completation.
cparata 0:e4f89df7a7a5 323 * 6:2 Reserved.
cparata 0:e4f89df7a7a5 324 * 1 HEATHER: 0: heater enable; 1: heater disable.
cparata 0:e4f89df7a7a5 325 * 0 ONE_SHOT: 0: waiting for start of conversion; 1: start for a new dataset. Self-cleared upon completation.
cparata 0:e4f89df7a7a5 326 * \endcode
cparata 0:e4f89df7a7a5 327 */
cparata 0:e4f89df7a7a5 328 #define HTS221_CTRL_REG2 (uint8_t)0x21
cparata 0:e4f89df7a7a5 329
cparata 0:e4f89df7a7a5 330 #define HTS221_BOOT_BIT HTS221_BIT(7)
cparata 0:e4f89df7a7a5 331 #define HTS221_HEATHER_BIT HTS221_BIT(1)
cparata 0:e4f89df7a7a5 332 #define HTS221_ONESHOT_BIT HTS221_BIT(0)
cparata 0:e4f89df7a7a5 333
cparata 0:e4f89df7a7a5 334 #define HTS221_BOOT_MASK (uint8_t)0x80
cparata 0:e4f89df7a7a5 335 #define HTS221_HEATHER_MASK (uint8_t)0x02
cparata 0:e4f89df7a7a5 336 #define HTS221_ONE_SHOT_MASK (uint8_t)0x01
cparata 0:e4f89df7a7a5 337
cparata 0:e4f89df7a7a5 338 /**
cparata 0:e4f89df7a7a5 339 * @brief Control register 3.
cparata 0:e4f89df7a7a5 340 * \code
cparata 0:e4f89df7a7a5 341 * Read/write
cparata 0:e4f89df7a7a5 342 * Default value: 0x00
cparata 0:e4f89df7a7a5 343 * 7 DRDY_H_L: Interrupt edge. 0: active high, 1: active low.
cparata 0:e4f89df7a7a5 344 * 6 PP_OD: Push-Pull/OpenDrain selection on interrupt pads. 0: push-pull; 1: open drain.
cparata 0:e4f89df7a7a5 345 * 5:3 Reserved.
cparata 0:e4f89df7a7a5 346 * 2 DRDY: interrupt config. 0: disable, 1: enable.
cparata 0:e4f89df7a7a5 347 * \endcode
cparata 0:e4f89df7a7a5 348 */
cparata 0:e4f89df7a7a5 349 #define HTS221_CTRL_REG3 (uint8_t)0x22
cparata 0:e4f89df7a7a5 350
cparata 0:e4f89df7a7a5 351 #define HTS221_DRDY_H_L_BIT HTS221_BIT(7)
cparata 0:e4f89df7a7a5 352 #define HTS221_PP_OD_BIT HTS221_BIT(6)
cparata 0:e4f89df7a7a5 353 #define HTS221_DRDY_BIT HTS221_BIT(2)
cparata 0:e4f89df7a7a5 354
cparata 0:e4f89df7a7a5 355 #define HTS221_DRDY_H_L_MASK (uint8_t)0x80
cparata 0:e4f89df7a7a5 356 #define HTS221_PP_OD_MASK (uint8_t)0x40
cparata 0:e4f89df7a7a5 357 #define HTS221_DRDY_MASK (uint8_t)0x04
cparata 0:e4f89df7a7a5 358
cparata 0:e4f89df7a7a5 359 /**
cparata 0:e4f89df7a7a5 360 * @brief Status register.
cparata 0:e4f89df7a7a5 361 * \code
cparata 0:e4f89df7a7a5 362 * Read
cparata 0:e4f89df7a7a5 363 * Default value: 0x00
cparata 0:e4f89df7a7a5 364 * 7:2 Reserved.
cparata 0:e4f89df7a7a5 365 * 1 H_DA: Humidity data available. 0: new data for humidity is not yet available; 1: new data for humidity is available.
cparata 0:e4f89df7a7a5 366 * 0 T_DA: Temperature data available. 0: new data for temperature is not yet available; 1: new data for temperature is available.
cparata 0:e4f89df7a7a5 367 * \endcode
cparata 0:e4f89df7a7a5 368 */
cparata 0:e4f89df7a7a5 369 #define HTS221_STATUS_REG (uint8_t)0x27
cparata 0:e4f89df7a7a5 370
cparata 0:e4f89df7a7a5 371 #define HTS221_H_DA_BIT HTS221_BIT(1)
cparata 0:e4f89df7a7a5 372 #define HTS221_T_DA_BIT HTS221_BIT(0)
cparata 0:e4f89df7a7a5 373
cparata 0:e4f89df7a7a5 374 #define HTS221_HDA_MASK (uint8_t)0x02
cparata 0:e4f89df7a7a5 375 #define HTS221_TDA_MASK (uint8_t)0x01
cparata 0:e4f89df7a7a5 376
cparata 0:e4f89df7a7a5 377 /**
cparata 0:e4f89df7a7a5 378 * @brief Humidity data (LSB).
cparata 0:e4f89df7a7a5 379 * \code
cparata 0:e4f89df7a7a5 380 * Read
cparata 0:e4f89df7a7a5 381 * Default value: 0x00.
cparata 0:e4f89df7a7a5 382 * HOUT7 - HOUT0: Humidity data LSB (2's complement).
cparata 0:e4f89df7a7a5 383 * \endcode
cparata 0:e4f89df7a7a5 384 */
cparata 0:e4f89df7a7a5 385 #define HTS221_HR_OUT_L_REG (uint8_t)0x28
cparata 0:e4f89df7a7a5 386
cparata 0:e4f89df7a7a5 387 /**
cparata 0:e4f89df7a7a5 388 * @brief Humidity data (MSB).
cparata 0:e4f89df7a7a5 389 * \code
cparata 0:e4f89df7a7a5 390 * Read
cparata 0:e4f89df7a7a5 391 * Default value: 0x00.
cparata 0:e4f89df7a7a5 392 * HOUT15 - HOUT8: Humidity data MSB (2's complement).
cparata 0:e4f89df7a7a5 393 * \endcode
cparata 0:e4f89df7a7a5 394 */
cparata 0:e4f89df7a7a5 395 #define HTS221_HR_OUT_H_REG (uint8_t)0x29
cparata 0:e4f89df7a7a5 396
cparata 0:e4f89df7a7a5 397
cparata 0:e4f89df7a7a5 398 /**
cparata 0:e4f89df7a7a5 399 * @brief Temperature data (LSB).
cparata 0:e4f89df7a7a5 400 * \code
cparata 0:e4f89df7a7a5 401 * Read
cparata 0:e4f89df7a7a5 402 * Default value: 0x00.
cparata 0:e4f89df7a7a5 403 * TOUT7 - TOUT0: temperature data LSB.
cparata 0:e4f89df7a7a5 404 * \endcode
cparata 0:e4f89df7a7a5 405 */
cparata 0:e4f89df7a7a5 406 #define HTS221_TEMP_OUT_L_REG (uint8_t)0x2A
cparata 0:e4f89df7a7a5 407
cparata 0:e4f89df7a7a5 408 /**
cparata 0:e4f89df7a7a5 409 * @brief Temperature data (MSB).
cparata 0:e4f89df7a7a5 410 * \code
cparata 0:e4f89df7a7a5 411 * Read
cparata 0:e4f89df7a7a5 412 * Default value: 0x00.
cparata 0:e4f89df7a7a5 413 * TOUT15 - TOUT8: temperature data MSB.
cparata 0:e4f89df7a7a5 414 * \endcode
cparata 0:e4f89df7a7a5 415 */
cparata 0:e4f89df7a7a5 416 #define HTS221_TEMP_OUT_H_REG (uint8_t)0x2B
cparata 0:e4f89df7a7a5 417
cparata 0:e4f89df7a7a5 418 /**
cparata 0:e4f89df7a7a5 419 * @brief Calibration registers.
cparata 0:e4f89df7a7a5 420 * \code
cparata 0:e4f89df7a7a5 421 * Read
cparata 0:e4f89df7a7a5 422 * \endcode
cparata 0:e4f89df7a7a5 423 */
cparata 0:e4f89df7a7a5 424 #define HTS221_H0_RH_X2 (uint8_t)0x30
cparata 0:e4f89df7a7a5 425 #define HTS221_H1_RH_X2 (uint8_t)0x31
cparata 0:e4f89df7a7a5 426 #define HTS221_T0_DEGC_X8 (uint8_t)0x32
cparata 0:e4f89df7a7a5 427 #define HTS221_T1_DEGC_X8 (uint8_t)0x33
cparata 0:e4f89df7a7a5 428 #define HTS221_T0_T1_DEGC_H2 (uint8_t)0x35
cparata 0:e4f89df7a7a5 429 #define HTS221_H0_T0_OUT_L (uint8_t)0x36
cparata 0:e4f89df7a7a5 430 #define HTS221_H0_T0_OUT_H (uint8_t)0x37
cparata 0:e4f89df7a7a5 431 #define HTS221_H1_T0_OUT_L (uint8_t)0x3A
cparata 0:e4f89df7a7a5 432 #define HTS221_H1_T0_OUT_H (uint8_t)0x3B
cparata 0:e4f89df7a7a5 433 #define HTS221_T0_OUT_L (uint8_t)0x3C
cparata 0:e4f89df7a7a5 434 #define HTS221_T0_OUT_H (uint8_t)0x3D
cparata 0:e4f89df7a7a5 435 #define HTS221_T1_OUT_L (uint8_t)0x3E
cparata 0:e4f89df7a7a5 436 #define HTS221_T1_OUT_H (uint8_t)0x3F
cparata 0:e4f89df7a7a5 437
cparata 0:e4f89df7a7a5 438
cparata 0:e4f89df7a7a5 439 /**
cparata 0:e4f89df7a7a5 440 * @}
cparata 0:e4f89df7a7a5 441 */
cparata 0:e4f89df7a7a5 442
cparata 0:e4f89df7a7a5 443
cparata 0:e4f89df7a7a5 444 /**
cparata 0:e4f89df7a7a5 445 * @}
cparata 0:e4f89df7a7a5 446 */
cparata 0:e4f89df7a7a5 447
cparata 0:e4f89df7a7a5 448
cparata 0:e4f89df7a7a5 449 /* Exported Functions -------------------------------------------------------------*/
cparata 0:e4f89df7a7a5 450 /** @defgroup HTS221_Exported_Functions
cparata 0:e4f89df7a7a5 451 * @{
cparata 0:e4f89df7a7a5 452 */
cparata 0:e4f89df7a7a5 453
cparata 0:e4f89df7a7a5 454 HTS221_Error_et HTS221_ReadReg( void *handle, uint8_t RegAddr, uint16_t NumByteToRead, uint8_t *Data );
cparata 0:e4f89df7a7a5 455 HTS221_Error_et HTS221_WriteReg( void *handle, uint8_t RegAddr, uint16_t NumByteToWrite, uint8_t *Data );
cparata 0:e4f89df7a7a5 456
cparata 0:e4f89df7a7a5 457 HTS221_Error_et HTS221_Get_DriverVersion(HTS221_DriverVersion_st* version);
cparata 0:e4f89df7a7a5 458 HTS221_Error_et HTS221_Get_DeviceID(void *handle, uint8_t* deviceid);
cparata 0:e4f89df7a7a5 459
cparata 0:e4f89df7a7a5 460 HTS221_Error_et HTS221_Set_InitConfig(void *handle, HTS221_Init_st* pxInit);
cparata 0:e4f89df7a7a5 461 HTS221_Error_et HTS221_Get_InitConfig(void *handle, HTS221_Init_st* pxInit);
cparata 0:e4f89df7a7a5 462 HTS221_Error_et HTS221_DeInit(void *handle);
cparata 0:e4f89df7a7a5 463 HTS221_Error_et HTS221_IsMeasurementCompleted(void *handle, HTS221_BitStatus_et* Is_Measurement_Completed);
cparata 0:e4f89df7a7a5 464
cparata 0:e4f89df7a7a5 465 HTS221_Error_et HTS221_Get_Measurement(void *handle, uint16_t* humidity, int16_t* temperature);
cparata 0:e4f89df7a7a5 466 HTS221_Error_et HTS221_Get_RawMeasurement(void *handle, int16_t* humidity, int16_t* temperature);
cparata 0:e4f89df7a7a5 467 HTS221_Error_et HTS221_Get_Humidity(void *handle, uint16_t* value);
cparata 0:e4f89df7a7a5 468 HTS221_Error_et HTS221_Get_HumidityRaw(void *handle, int16_t* value);
cparata 0:e4f89df7a7a5 469 HTS221_Error_et HTS221_Get_TemperatureRaw(void *handle, int16_t* value);
cparata 0:e4f89df7a7a5 470 HTS221_Error_et HTS221_Get_Temperature(void *handle, int16_t* value);
cparata 0:e4f89df7a7a5 471 HTS221_Error_et HTS221_Get_DataStatus(void *handle, HTS221_BitStatus_et* humidity, HTS221_BitStatus_et* temperature);
cparata 0:e4f89df7a7a5 472 HTS221_Error_et HTS221_Activate(void *handle);
cparata 0:e4f89df7a7a5 473 HTS221_Error_et HTS221_DeActivate(void *handle);
cparata 0:e4f89df7a7a5 474
cparata 0:e4f89df7a7a5 475 HTS221_Error_et HTS221_Set_AvgHT(void *handle, HTS221_Avgh_et avgh, HTS221_Avgt_et avgt);
cparata 0:e4f89df7a7a5 476 HTS221_Error_et HTS221_Set_AvgH(void *handle, HTS221_Avgh_et avgh);
cparata 0:e4f89df7a7a5 477 HTS221_Error_et HTS221_Set_AvgT(void *handle, HTS221_Avgt_et avgt);
cparata 0:e4f89df7a7a5 478 HTS221_Error_et HTS221_Get_AvgHT(void *handle, HTS221_Avgh_et* avgh, HTS221_Avgt_et* avgt);
cparata 0:e4f89df7a7a5 479 HTS221_Error_et HTS221_Set_BduMode(void *handle, HTS221_State_et status);
cparata 0:e4f89df7a7a5 480 HTS221_Error_et HTS221_Get_BduMode(void *handle, HTS221_State_et* status);
cparata 0:e4f89df7a7a5 481 HTS221_Error_et HTS221_Set_PowerDownMode(void *handle, HTS221_BitStatus_et status);
cparata 0:e4f89df7a7a5 482 HTS221_Error_et HTS221_Get_PowerDownMode(void *handle, HTS221_BitStatus_et* status);
cparata 0:e4f89df7a7a5 483 HTS221_Error_et HTS221_Set_Odr(void *handle, HTS221_Odr_et odr);
cparata 0:e4f89df7a7a5 484 HTS221_Error_et HTS221_Get_Odr(void *handle, HTS221_Odr_et* odr);
cparata 0:e4f89df7a7a5 485 HTS221_Error_et HTS221_MemoryBoot(void *handle);
cparata 0:e4f89df7a7a5 486 HTS221_Error_et HTS221_Set_HeaterState(void *handle, HTS221_State_et status);
cparata 0:e4f89df7a7a5 487 HTS221_Error_et HTS221_Get_HeaterState(void *handle, HTS221_State_et* status);
cparata 0:e4f89df7a7a5 488 HTS221_Error_et HTS221_StartOneShotMeasurement(void *handle);
cparata 0:e4f89df7a7a5 489 HTS221_Error_et HTS221_Set_IrqActiveLevel(void *handle, HTS221_DrdyLevel_et status);
cparata 0:e4f89df7a7a5 490 HTS221_Error_et HTS221_Get_IrqActiveLevel(void *handle, HTS221_DrdyLevel_et* status);
cparata 0:e4f89df7a7a5 491 HTS221_Error_et HTS221_Set_IrqOutputType(void *handle, HTS221_OutputType_et value);
cparata 0:e4f89df7a7a5 492 HTS221_Error_et HTS221_Get_IrqOutputType(void *handle, HTS221_OutputType_et* value);
cparata 0:e4f89df7a7a5 493 HTS221_Error_et HTS221_Set_IrqEnable(void *handle, HTS221_State_et status);
cparata 0:e4f89df7a7a5 494 HTS221_Error_et HTS221_Get_IrqEnable(void *handle, HTS221_State_et* status);
cparata 0:e4f89df7a7a5 495
cparata 0:e4f89df7a7a5 496 /**
cparata 0:e4f89df7a7a5 497 * @}
cparata 0:e4f89df7a7a5 498 */
cparata 0:e4f89df7a7a5 499
cparata 0:e4f89df7a7a5 500 /**
cparata 0:e4f89df7a7a5 501 * @}
cparata 0:e4f89df7a7a5 502 */
cparata 0:e4f89df7a7a5 503
cparata 0:e4f89df7a7a5 504 /**
cparata 0:e4f89df7a7a5 505 * @}
cparata 0:e4f89df7a7a5 506 */
cparata 0:e4f89df7a7a5 507
cparata 0:e4f89df7a7a5 508 #ifdef __cplusplus
cparata 0:e4f89df7a7a5 509 }
cparata 0:e4f89df7a7a5 510 #endif
cparata 0:e4f89df7a7a5 511
cparata 0:e4f89df7a7a5 512 #endif /* __HTS221_DRIVER__H */
cparata 0:e4f89df7a7a5 513
cparata 0:e4f89df7a7a5 514 /******************* (C) COPYRIGHT 2013 STMicroelectronics *****END OF FILE****/