/** ****************************************************************************** * @file iis2dlpc_reg.c * @author Sensors Software Solution Team * @brief IIS2DLPC driver file ****************************************************************************** * @attention * *

© Copyright (c) 2021 STMicroelectronics. * All rights reserved.

* * This software component is licensed by ST under BSD 3-Clause license, * the "License"; You may not use this file except in compliance with the * License. You may obtain a copy of the License at: * opensource.org/licenses/BSD-3-Clause * ****************************************************************************** */ #include "iis2dlpc_reg.h" /** * @defgroup IIS2DLPC * @brief This file provides a set of functions needed to drive the * iis2dlpc enanced inertial module. * @{ * */ /** * @defgroup IIS2DLPC_Interfaces_Functions * @brief This section provide a set of functions used to read and * write a generic register of the device. * MANDATORY: return 0 -> no Error. * @{ * */ /** * @brief Read generic device register * * @param ctx read / write interface definitions(ptr) * @param reg register to read * @param data pointer to buffer that store the data read(ptr) * @param len number of consecutive register to read * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t __weak iis2dlpc_read_reg(const stmdev_ctx_t *ctx, uint8_t reg, uint8_t *data, uint16_t len) { int32_t ret; if (ctx == NULL) return -1; ret = ctx->read_reg(ctx->handle, reg, data, len); return ret; } /** * @brief Write generic device register * * @param ctx read / write interface definitions(ptr) * @param reg register to write * @param data pointer to data to write in register reg(ptr) * @param len number of consecutive register to write * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t __weak iis2dlpc_write_reg(const stmdev_ctx_t *ctx, uint8_t reg, uint8_t *data, uint16_t len) { int32_t ret; if (ctx == NULL) return -1; ret = ctx->write_reg(ctx->handle, reg, data, len); return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Sensitivity * @brief These functions convert raw-data into engineering units. * @{ * */ float_t iis2dlpc_from_fs2_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.061f; } float_t iis2dlpc_from_fs4_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.122f; } float_t iis2dlpc_from_fs8_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.244f; } float_t iis2dlpc_from_fs16_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.488f; } float_t iis2dlpc_from_fs2_lp1_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.061f; } float_t iis2dlpc_from_fs4_lp1_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.122f; } float_t iis2dlpc_from_fs8_lp1_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.244f; } float_t iis2dlpc_from_fs16_lp1_to_mg(int16_t lsb) { return ((float_t)lsb) * 0.488f; } float_t iis2dlpc_from_lsb_to_celsius(int16_t lsb) { return (((float_t)lsb / 256.0f) + 25.0f); } /** * @} * */ /** * @defgroup IIS2DLPC_Data_Generation * @brief This section groups all the functions concerning * data generation * @{ * */ /** * @brief Select accelerometer operating modes.[set] * * @param ctx read / write interface definitions * @param val change the values of mode / lp_mode in reg CTRL1 * and low_noise in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_power_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_mode_t val) { iis2dlpc_ctrl1_t ctrl1; iis2dlpc_ctrl6_t ctrl6; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL1, (uint8_t *) &ctrl1, 1); if (ret == 0) { ctrl1.mode = ((uint8_t) val & 0x0CU) >> 2; ctrl1.lp_mode = (uint8_t) val & 0x03U ; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL1, (uint8_t *) &ctrl1, 1); } if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) &ctrl6, 1); } if (ret == 0) { ctrl6.low_noise = ((uint8_t) val & 0x10U) >> 4; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) &ctrl6, 1); } else { ret = ret; } return ret; } /** * @brief Select accelerometer operating modes.[get] * * @param ctx read / write interface definitions * @param val change the values of mode / lp_mode in reg CTRL1 * and low_noise in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_power_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_mode_t *val) { iis2dlpc_ctrl1_t ctrl1; iis2dlpc_ctrl6_t ctrl6; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL1, (uint8_t *) &ctrl1, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) &ctrl6, 1); switch (((ctrl6.low_noise << 4) + (ctrl1.mode << 2) + ctrl1.lp_mode)) { case IIS2DLPC_HIGH_PERFORMANCE: *val = IIS2DLPC_HIGH_PERFORMANCE; break; case IIS2DLPC_CONT_LOW_PWR_4: *val = IIS2DLPC_CONT_LOW_PWR_4; break; case IIS2DLPC_CONT_LOW_PWR_3: *val = IIS2DLPC_CONT_LOW_PWR_3; break; case IIS2DLPC_CONT_LOW_PWR_2: *val = IIS2DLPC_CONT_LOW_PWR_2; break; case IIS2DLPC_CONT_LOW_PWR_12bit: *val = IIS2DLPC_CONT_LOW_PWR_12bit; break; case IIS2DLPC_SINGLE_LOW_PWR_4: *val = IIS2DLPC_SINGLE_LOW_PWR_4; break; case IIS2DLPC_SINGLE_LOW_PWR_3: *val = IIS2DLPC_SINGLE_LOW_PWR_3; break; case IIS2DLPC_SINGLE_LOW_PWR_2: *val = IIS2DLPC_SINGLE_LOW_PWR_2; break; case IIS2DLPC_SINGLE_LOW_PWR_12bit: *val = IIS2DLPC_SINGLE_LOW_PWR_12bit; break; case IIS2DLPC_HIGH_PERFORMANCE_LOW_NOISE: *val = IIS2DLPC_HIGH_PERFORMANCE_LOW_NOISE; break; case IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_4: *val = IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_4; break; case IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_3: *val = IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_3; break; case IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_2: *val = IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_2; break; case IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_12bit: *val = IIS2DLPC_CONT_LOW_PWR_LOW_NOISE_12bit; break; case IIS2DLPC_SINGLE_LOW_PWR_LOW_NOISE_4: *val = IIS2DLPC_SINGLE_LOW_PWR_LOW_NOISE_4; break; case IIS2DLPC_SINGLE_LOW_PWR_LOW_NOISE_3: *val = IIS2DLPC_SINGLE_LOW_PWR_LOW_NOISE_3; break; case IIS2DLPC_SINGLE_LOW_PWR_LOW_NOISE_2: *val = IIS2DLPC_SINGLE_LOW_PWR_LOW_NOISE_2; break; case IIS2DLPC_SINGLE_LOW_LOW_NOISE_PWR_12bit: *val = IIS2DLPC_SINGLE_LOW_LOW_NOISE_PWR_12bit; break; default: *val = IIS2DLPC_HIGH_PERFORMANCE; break; } } return ret; } /** * @brief Accelerometer data rate selection.[set] * * @param ctx read / write interface definitions * @param val change the values of odr in reg CTRL1 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_data_rate_set(const stmdev_ctx_t *ctx, iis2dlpc_odr_t val) { iis2dlpc_ctrl1_t ctrl1; iis2dlpc_ctrl3_t ctrl3; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL1, (uint8_t *) &ctrl1, 1); if (ret == 0) { ctrl1.odr = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL1, (uint8_t *) &ctrl1, 1); } if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) &ctrl3, 1); } if (ret == 0) { ctrl3.slp_mode = ((uint8_t) val & 0x30U) >> 4; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) &ctrl3, 1); } else { ret = ret; } return ret; } /** * @brief Accelerometer data rate selection.[get] * * @param ctx read / write interface definitions * @param val Get the values of odr in reg CTRL1 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_data_rate_get(const stmdev_ctx_t *ctx, iis2dlpc_odr_t *val) { iis2dlpc_ctrl1_t ctrl1; iis2dlpc_ctrl3_t ctrl3; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL1, (uint8_t *) &ctrl1, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) &ctrl3, 1); switch ((ctrl3.slp_mode << 4) + ctrl1.odr) { case IIS2DLPC_XL_ODR_OFF: *val = IIS2DLPC_XL_ODR_OFF; break; case IIS2DLPC_XL_ODR_1Hz6_LP_ONLY: *val = IIS2DLPC_XL_ODR_1Hz6_LP_ONLY; break; case IIS2DLPC_XL_ODR_12Hz5: *val = IIS2DLPC_XL_ODR_12Hz5; break; case IIS2DLPC_XL_ODR_25Hz: *val = IIS2DLPC_XL_ODR_25Hz; break; case IIS2DLPC_XL_ODR_50Hz: *val = IIS2DLPC_XL_ODR_50Hz; break; case IIS2DLPC_XL_ODR_100Hz: *val = IIS2DLPC_XL_ODR_100Hz; break; case IIS2DLPC_XL_ODR_200Hz: *val = IIS2DLPC_XL_ODR_200Hz; break; case IIS2DLPC_XL_ODR_400Hz: *val = IIS2DLPC_XL_ODR_400Hz; break; case IIS2DLPC_XL_ODR_800Hz: *val = IIS2DLPC_XL_ODR_800Hz; break; case IIS2DLPC_XL_ODR_1k6Hz: *val = IIS2DLPC_XL_ODR_1k6Hz; break; case IIS2DLPC_XL_SET_SW_TRIG: *val = IIS2DLPC_XL_SET_SW_TRIG; break; case IIS2DLPC_XL_SET_PIN_TRIG: *val = IIS2DLPC_XL_SET_PIN_TRIG; break; default: *val = IIS2DLPC_XL_ODR_OFF; break; } } return ret; } /** * @brief Block data update.[set] * * @param ctx read / write interface definitions * @param val change the values of bdu in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_block_data_update_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); if (ret == 0) { reg.bdu = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); } return ret; } /** * @brief Block data update.[get] * * @param ctx read / write interface definitions * @param val change the values of bdu in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_block_data_update_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); *val = reg.bdu; return ret; } /** * @brief Accelerometer full-scale selection.[set] * * @param ctx read / write interface definitions * @param val change the values of fs in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_full_scale_set(const stmdev_ctx_t *ctx, iis2dlpc_fs_t val) { iis2dlpc_ctrl6_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) ®, 1); if (ret == 0) { reg.fs = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) ®, 1); } return ret; } /** * @brief Accelerometer full-scale selection.[get] * * @param ctx read / write interface definitions * @param val Get the values of fs in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_full_scale_get(const stmdev_ctx_t *ctx, iis2dlpc_fs_t *val) { iis2dlpc_ctrl6_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) ®, 1); switch (reg.fs) { case IIS2DLPC_2g: *val = IIS2DLPC_2g; break; case IIS2DLPC_4g: *val = IIS2DLPC_4g; break; case IIS2DLPC_8g: *val = IIS2DLPC_8g; break; case IIS2DLPC_16g: *val = IIS2DLPC_16g; break; default: *val = IIS2DLPC_2g; break; } return ret; } /** * @brief The STATUS_REG register of the device.[get] * * @param ctx read / write interface definitions * @param val union of registers from STATUS to * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_status_reg_get(const stmdev_ctx_t *ctx, iis2dlpc_status_t *val) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_STATUS, (uint8_t *) val, 1); return ret; } /** * @brief Accelerometer new data available.[get] * * @param ctx read / write interface definitions * @param val change the values of drdy in reg STATUS * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_flag_data_ready_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_status_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_STATUS, (uint8_t *) ®, 1); *val = reg.drdy; return ret; } /** * @brief Read all the interrupt/status flag of the device.[get] * * @param ctx read / write interface definitions * @param val registers STATUS_DUP, WAKE_UP_SRC, * TAP_SRC, SIXD_SRC, ALL_INT_SRC * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_all_sources_get(const stmdev_ctx_t *ctx, iis2dlpc_all_sources_t *val) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_STATUS_DUP, (uint8_t *) val, 5); return ret; } /** * @brief Accelerometer X-axis user offset correction expressed in two’s * complement, weight depends on bit USR_OFF_W. The value must be * in the range [-127 127].[set] * * @param ctx read / write interface definitions * @param buff buffer that contains data to write * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_usr_offset_x_set(const stmdev_ctx_t *ctx, uint8_t *buff) { int32_t ret; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_X_OFS_USR, buff, 1); return ret; } /** * @brief Accelerometer X-axis user offset correction expressed in two’s * complement, weight depends on bit USR_OFF_W. The value must be * in the range [-127 127].[get] * * @param ctx read / write interface definitions * @param buff buffer that stores data read * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_usr_offset_x_get(const stmdev_ctx_t *ctx, uint8_t *buff) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_X_OFS_USR, buff, 1); return ret; } /** * @brief Accelerometer Y-axis user offset correction expressed in two’s * complement, weight depends on bit USR_OFF_W. The value must be * in the range [-127 127].[set] * * @param ctx read / write interface definitions * @param buff buffer that contains data to write * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_usr_offset_y_set(const stmdev_ctx_t *ctx, uint8_t *buff) { int32_t ret; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_Y_OFS_USR, buff, 1); return ret; } /** * @brief Accelerometer Y-axis user offset correction expressed in two’s * complement, weight depends on bit USR_OFF_W. The value must be * in the range [-127 127].[get] * * @param ctx read / write interface definitions * @param buff buffer that stores data read * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_usr_offset_y_get(const stmdev_ctx_t *ctx, uint8_t *buff) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_Y_OFS_USR, buff, 1); return ret; } /** * @brief Accelerometer Z-axis user offset correction expressed in two’s * complement, weight depends on bit USR_OFF_W. The value must be * in the range [-127 127].[set] * * @param ctx read / write interface definitions * @param buff buffer that contains data to write * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_usr_offset_z_set(const stmdev_ctx_t *ctx, uint8_t *buff) { int32_t ret; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_Z_OFS_USR, buff, 1); return ret; } /** * @brief Accelerometer Z-axis user offset correction expressed in two’s * complement, weight depends on bit USR_OFF_W. The value must be * in the range [-127 127].[get] * * @param ctx read / write interface definitions * @param buff buffer that stores data read * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_usr_offset_z_get(const stmdev_ctx_t *ctx, uint8_t *buff) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_Z_OFS_USR, buff, 1); return ret; } /** * @brief Weight of XL user offset bits of registers X_OFS_USR, * Y_OFS_USR, Z_OFS_USR.[set] * * @param ctx read / write interface definitions * @param val change the values of usr_off_w in * reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_offset_weight_set(const stmdev_ctx_t *ctx, iis2dlpc_usr_off_w_t val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); if (ret == 0) { reg.usr_off_w = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } return ret; } /** * @brief Weight of XL user offset bits of registers X_OFS_USR, * Y_OFS_USR, Z_OFS_USR.[get] * * @param ctx read / write interface definitions * @param val Get the values of usr_off_w in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_offset_weight_get(const stmdev_ctx_t *ctx, iis2dlpc_usr_off_w_t *val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); switch (reg.usr_off_w) { case IIS2DLPC_LSb_977ug: *val = IIS2DLPC_LSb_977ug; break; case IIS2DLPC_LSb_15mg6: *val = IIS2DLPC_LSb_15mg6; break; default: *val = IIS2DLPC_LSb_977ug; break; } return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Data_Output * @brief This section groups all the data output functions. * @{ * */ /** * @brief Temperature data output register (r). L and H registers * together express a 16-bit word in two’s complement.[get] * * @param ctx read / write interface definitions * @param buff buffer that stores data read * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_temperature_raw_get(const stmdev_ctx_t *ctx, int16_t *val) { uint8_t buff[2]; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_OUT_T_L, buff, 2); *val = (int16_t)buff[1]; *val = (*val * 256) + (int16_t)buff[0]; return ret; } /** * @brief Linear acceleration output register. The value is expressed as * a 16-bit word in two’s complement.[get] * * @param ctx read / write interface definitions * @param buff buffer that stores data read * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_acceleration_raw_get(const stmdev_ctx_t *ctx, int16_t *val) { uint8_t buff[6]; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_OUT_X_L, buff, 6); val[0] = (int16_t)buff[1]; val[0] = (val[0] * 256) + (int16_t)buff[0]; val[1] = (int16_t)buff[3]; val[1] = (val[1] * 256) + (int16_t)buff[2]; val[2] = (int16_t)buff[5]; val[2] = (val[2] * 256) + (int16_t)buff[4]; return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Common * @brief This section groups common useful functions. * @{ * */ /** * @brief Device Who am I.[get] * * @param ctx read / write interface definitions * @param buff buffer that stores data read * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_device_id_get(const stmdev_ctx_t *ctx, uint8_t *buff) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WHO_AM_I, buff, 1); return ret; } /** * @brief Register address automatically incremented during multiple byte * access with a serial interface.[set] * * @param ctx read / write interface definitions * @param val change the values of if_add_inc in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_auto_increment_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); if (ret == 0) { reg.if_add_inc = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); } return ret; } /** * @brief Register address automatically incremented during multiple * byte access with a serial interface.[get] * * @param ctx read / write interface definitions * @param val change the values of if_add_inc in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_auto_increment_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); *val = reg.if_add_inc; return ret; } /** * @brief Software reset. Restore the default values in user registers.[set] * * @param ctx read / write interface definitions * @param val change the values of soft_reset in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_reset_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); if (ret == 0) { reg.soft_reset = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); } return ret; } /** * @brief Software reset. Restore the default values in user registers.[get] * * @param ctx read / write interface definitions * @param val change the values of soft_reset in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_reset_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); *val = reg.soft_reset; return ret; } /** * @brief Reboot memory content. Reload the calibration parameters.[set] * * @param ctx read / write interface definitions * @param val change the values of boot in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_boot_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); if (ret == 0) { reg.boot = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); } return ret; } /** * @brief Reboot memory content. Reload the calibration parameters.[get] * * @param ctx read / write interface definitions * @param val change the values of boot in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_boot_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); *val = reg.boot; return ret; } /** * @brief Sensor self-test enable.[set] * * @param ctx read / write interface definitions * @param val change the values of st in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_self_test_set(const stmdev_ctx_t *ctx, iis2dlpc_st_t val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); if (ret == 0) { reg.st = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); } return ret; } /** * @brief Sensor self-test enable.[get] * * @param ctx read / write interface definitions * @param val Get the values of st in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_self_test_get(const stmdev_ctx_t *ctx, iis2dlpc_st_t *val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); switch (reg.st) { case IIS2DLPC_XL_ST_DISABLE: *val = IIS2DLPC_XL_ST_DISABLE; break; case IIS2DLPC_XL_ST_POSITIVE: *val = IIS2DLPC_XL_ST_POSITIVE; break; case IIS2DLPC_XL_ST_NEGATIVE: *val = IIS2DLPC_XL_ST_NEGATIVE; break; default: *val = IIS2DLPC_XL_ST_DISABLE; break; } return ret; } /** * @brief Data-ready pulsed / letched mode.[set] * * @param ctx read / write interface definitions * @param val change the values of drdy_pulsed in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_data_ready_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_drdy_pulsed_t val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); if (ret == 0) { reg.drdy_pulsed = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } return ret; } /** * @brief Data-ready pulsed / letched mode.[get] * * @param ctx read / write interface definitions * @param val Get the values of drdy_pulsed in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_data_ready_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_drdy_pulsed_t *val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); switch (reg.drdy_pulsed) { case IIS2DLPC_DRDY_LATCHED: *val = IIS2DLPC_DRDY_LATCHED; break; case IIS2DLPC_DRDY_PULSED: *val = IIS2DLPC_DRDY_PULSED; break; default: *val = IIS2DLPC_DRDY_LATCHED; break; } return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Filters * @brief This section group all the functions concerning the filters * configuration. * @{ * */ /** * @brief Accelerometer filtering path for outputs.[set] * * @param ctx read / write interface definitions * @param val change the values of fds in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_filter_path_set(const stmdev_ctx_t *ctx, iis2dlpc_fds_t val) { iis2dlpc_ctrl6_t ctrl6; iis2dlpc_ctrl7_t ctrl_reg7; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) &ctrl6, 1); if (ret == 0) { ctrl6.fds = ((uint8_t) val & 0x10U) >> 4; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) &ctrl6, 1); } if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) &ctrl_reg7, 1); } if (ret == 0) { ctrl_reg7.usr_off_on_out = (uint8_t) val & 0x01U; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) &ctrl_reg7, 1); } else { ret = ret; } return ret; } /** * @brief Accelerometer filtering path for outputs.[get] * * @param ctx read / write interface definitions * @param val Get the values of fds in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_filter_path_get(const stmdev_ctx_t *ctx, iis2dlpc_fds_t *val) { iis2dlpc_ctrl6_t ctrl6; iis2dlpc_ctrl7_t ctrl_reg7; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) &ctrl6, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) &ctrl_reg7, 1); switch ((ctrl6.fds << 4) + ctrl_reg7.usr_off_on_out) { case IIS2DLPC_LPF_ON_OUT: *val = IIS2DLPC_LPF_ON_OUT; break; case IIS2DLPC_USER_OFFSET_ON_OUT: *val = IIS2DLPC_USER_OFFSET_ON_OUT; break; case IIS2DLPC_HIGH_PASS_ON_OUT: *val = IIS2DLPC_HIGH_PASS_ON_OUT; break; default: *val = IIS2DLPC_LPF_ON_OUT; break; } } return ret; } /** * @brief Accelerometer cutoff filter frequency. Valid for low and high * pass filter.[set] * * @param ctx read / write interface definitions * @param val change the values of bw_filt in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_filter_bandwidth_set(const stmdev_ctx_t *ctx, iis2dlpc_bw_filt_t val) { iis2dlpc_ctrl6_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) ®, 1); if (ret == 0) { reg.bw_filt = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) ®, 1); } return ret; } /** * @brief Accelerometer cutoff filter frequency. Valid for low and * high pass filter.[get] * * @param ctx read / write interface definitions * @param val Get the values of bw_filt in reg CTRL6 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_filter_bandwidth_get(const stmdev_ctx_t *ctx, iis2dlpc_bw_filt_t *val) { iis2dlpc_ctrl6_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL6, (uint8_t *) ®, 1); switch (reg.bw_filt) { case IIS2DLPC_ODR_DIV_2: *val = IIS2DLPC_ODR_DIV_2; break; case IIS2DLPC_ODR_DIV_4: *val = IIS2DLPC_ODR_DIV_4; break; case IIS2DLPC_ODR_DIV_10: *val = IIS2DLPC_ODR_DIV_10; break; case IIS2DLPC_ODR_DIV_20: *val = IIS2DLPC_ODR_DIV_20; break; default: *val = IIS2DLPC_ODR_DIV_2; break; } return ret; } /** * @brief Enable HP filter reference mode.[set] * * @param ctx read / write interface definitions * @param val change the values of hp_ref_mode in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_reference_mode_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); if (ret == 0) { reg.hp_ref_mode = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } return ret; } /** * @brief Enable HP filter reference mode.[get] * * @param ctx read / write interface definitions * @param val change the values of hp_ref_mode in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_reference_mode_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); *val = reg.hp_ref_mode; return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Serial_Interface * @brief This section groups all the functions concerning main serial * interface management (not auxiliary) * @{ * */ /** * @brief SPI Serial Interface Mode selection.[set] * * @param ctx read / write interface definitions * @param val change the values of sim in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_spi_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_sim_t val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); if (ret == 0) { reg.sim = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); } return ret; } /** * @brief SPI Serial Interface Mode selection.[get] * * @param ctx read / write interface definitions * @param val Get the values of sim in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_spi_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_sim_t *val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); switch (reg.sim) { case IIS2DLPC_SPI_4_WIRE: *val = IIS2DLPC_SPI_4_WIRE; break; case IIS2DLPC_SPI_3_WIRE: *val = IIS2DLPC_SPI_3_WIRE; break; default: *val = IIS2DLPC_SPI_4_WIRE; break; } return ret; } /** * @brief Disable / Enable I2C interface.[set] * * @param ctx read / write interface definitions * @param val change the values of i2c_disable in * reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_i2c_interface_set(const stmdev_ctx_t *ctx, iis2dlpc_i2c_disable_t val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); if (ret == 0) { reg.i2c_disable = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); } return ret; } /** * @brief Disable / Enable I2C interface.[get] * * @param ctx read / write interface definitions * @param val Get the values of i2c_disable in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_i2c_interface_get(const stmdev_ctx_t *ctx, iis2dlpc_i2c_disable_t *val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); switch (reg.i2c_disable) { case IIS2DLPC_I2C_ENABLE: *val = IIS2DLPC_I2C_ENABLE; break; case IIS2DLPC_I2C_DISABLE: *val = IIS2DLPC_I2C_DISABLE; break; default: *val = IIS2DLPC_I2C_ENABLE; break; } return ret; } /** * @brief Disconnect CS pull-up.[set] * * @param ctx read / write interface definitions * @param val change the values of cs_pu_disc in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_cs_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_cs_pu_disc_t val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); if (ret == 0) { reg.cs_pu_disc = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); } return ret; } /** * @brief Disconnect CS pull-up.[get] * * @param ctx read / write interface definitions * @param val Get the values of cs_pu_disc in reg CTRL2 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_cs_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_cs_pu_disc_t *val) { iis2dlpc_ctrl2_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL2, (uint8_t *) ®, 1); switch (reg.cs_pu_disc) { case IIS2DLPC_PULL_UP_CONNECT: *val = IIS2DLPC_PULL_UP_CONNECT; break; case IIS2DLPC_PULL_UP_DISCONNECT: *val = IIS2DLPC_PULL_UP_DISCONNECT; break; default: *val = IIS2DLPC_PULL_UP_CONNECT; break; } return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Interrupt_Pins * @brief This section groups all the functions that manage interrupt pins * @{ * */ /** * @brief Interrupt active-high/low.[set] * * @param ctx read / write interface definitions * @param val change the values of h_lactive in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_polarity_set(const stmdev_ctx_t *ctx, iis2dlpc_h_lactive_t val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); if (ret == 0) { reg.h_lactive = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); } return ret; } /** * @brief Interrupt active-high/low.[get] * * @param ctx read / write interface definitions * @param val Get the values of h_lactive in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_polarity_get(const stmdev_ctx_t *ctx, iis2dlpc_h_lactive_t *val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); switch (reg.h_lactive) { case IIS2DLPC_ACTIVE_HIGH: *val = IIS2DLPC_ACTIVE_HIGH; break; case IIS2DLPC_ACTIVE_LOW: *val = IIS2DLPC_ACTIVE_LOW; break; default: *val = IIS2DLPC_ACTIVE_HIGH; break; } return ret; } /** * @brief Latched/pulsed interrupt.[set] * * @param ctx read / write interface definitions * @param val change the values of lir in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_int_notification_set(const stmdev_ctx_t *ctx, iis2dlpc_lir_t val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); if (ret == 0) { reg.lir = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); } return ret; } /** * @brief Latched/pulsed interrupt.[get] * * @param ctx read / write interface definitions * @param val Get the values of lir in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_int_notification_get(const stmdev_ctx_t *ctx, iis2dlpc_lir_t *val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); switch (reg.lir) { case IIS2DLPC_INT_PULSED: *val = IIS2DLPC_INT_PULSED; break; case IIS2DLPC_INT_LATCHED: *val = IIS2DLPC_INT_LATCHED; break; default: *val = IIS2DLPC_INT_PULSED; break; } return ret; } /** * @brief Push-pull/open drain selection on interrupt pads.[set] * * @param ctx read / write interface definitions * @param val change the values of pp_od in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_pp_od_t val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); if (ret == 0) { reg.pp_od = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); } return ret; } /** * @brief Push-pull/open drain selection on interrupt pads.[get] * * @param ctx read / write interface definitions * @param val Get the values of pp_od in reg CTRL3 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_pp_od_t *val) { iis2dlpc_ctrl3_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL3, (uint8_t *) ®, 1); switch (reg.pp_od) { case IIS2DLPC_PUSH_PULL: *val = IIS2DLPC_PUSH_PULL; break; case IIS2DLPC_OPEN_DRAIN: *val = IIS2DLPC_OPEN_DRAIN; break; default: *val = IIS2DLPC_PUSH_PULL; break; } return ret; } /** * @brief Select the signal that need to route on int1 pad.[set] * * @param ctx read / write interface definitions * @param val register CTRL4_INT1_PAD_CTRL. * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_int1_route_set(const stmdev_ctx_t *ctx, iis2dlpc_ctrl4_int1_pad_ctrl_t *val) { iis2dlpc_ctrl5_int2_pad_ctrl_t ctrl5_int2_pad_ctrl; iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL5_INT2_PAD_CTRL, (uint8_t *) &ctrl5_int2_pad_ctrl, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } if (ret == 0) { if ((ctrl5_int2_pad_ctrl.int2_sleep_state | ctrl5_int2_pad_ctrl.int2_sleep_chg | val->int1_tap | val->int1_ff | val->int1_wu | val->int1_single_tap | val->int1_6d) != PROPERTY_DISABLE) { reg.interrupts_enable = PROPERTY_ENABLE; } else { reg.interrupts_enable = PROPERTY_DISABLE; } ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL4_INT1_PAD_CTRL, (uint8_t *) val, 1); } if (ret == 0) { ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } else { ret = ret; } return ret; } /** * @brief Select the signal that need to route on int1 pad.[get] * * @param ctx read / write interface definitions * @param val register CTRL4_INT1_PAD_CTRL. * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_int1_route_get(const stmdev_ctx_t *ctx, iis2dlpc_ctrl4_int1_pad_ctrl_t *val) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL4_INT1_PAD_CTRL, (uint8_t *) val, 1); return ret; } /** * @brief Select the signal that need to route on int2 pad.[set] * * @param ctx read / write interface definitions * @param val register CTRL5_INT2_PAD_CTRL. * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_int2_route_set(const stmdev_ctx_t *ctx, iis2dlpc_ctrl5_int2_pad_ctrl_t *val) { iis2dlpc_ctrl7_t ctrl_reg7; iis2dlpc_ctrl4_int1_pad_ctrl_t ctrl4_int1_pad; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL4_INT1_PAD_CTRL, (uint8_t *)&ctrl4_int1_pad, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) &ctrl_reg7, 1); } if (ret == 0) { if ((val->int2_sleep_state | val->int2_sleep_chg | ctrl4_int1_pad.int1_tap | ctrl4_int1_pad.int1_ff | ctrl4_int1_pad.int1_wu | ctrl4_int1_pad.int1_single_tap | ctrl4_int1_pad.int1_6d) != PROPERTY_DISABLE) { ctrl_reg7.interrupts_enable = PROPERTY_ENABLE; } else { ctrl_reg7.interrupts_enable = PROPERTY_DISABLE; } ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL5_INT2_PAD_CTRL, (uint8_t *) val, 1); } if (ret == 0) { ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) &ctrl_reg7, 1); } else { ret = ret; } return ret; } /** * @brief Select the signal that need to route on int2 pad.[get] * * @param ctx read / write interface definitions * @param val register CTRL5_INT2_PAD_CTRL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_pin_int2_route_get(const stmdev_ctx_t *ctx, iis2dlpc_ctrl5_int2_pad_ctrl_t *val) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL5_INT2_PAD_CTRL, (uint8_t *) val, 1); return ret; } /** * @brief All interrupt signals become available on INT1 pin.[set] * * @param ctx read / write interface definitions * @param val change the values of int2_on_int1 in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_all_on_int1_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); if (ret == 0) { reg.int2_on_int1 = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } return ret; } /** * @brief All interrupt signals become available on INT1 pin.[get] * * @param ctx read / write interface definitions * @param val change the values of int2_on_int1 in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_all_on_int1_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); *val = reg.int2_on_int1; return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Wake_Up_Event * @brief This section groups all the functions that manage the Wake * Up event generation. * @{ * */ /** * @brief Threshold for wakeup.1 LSB = FS_XL / 64.[set] * * @param ctx read / write interface definitions * @param val change the values of wk_ths in reg WAKE_UP_THS * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_wkup_threshold_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_wake_up_ths_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) ®, 1); if (ret == 0) { reg.wk_ths = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) ®, 1); } return ret; } /** * @brief Threshold for wakeup.1 LSB = FS_XL / 64.[get] * * @param ctx read / write interface definitions * @param val change the values of wk_ths in reg WAKE_UP_THS * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_wkup_threshold_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_wake_up_ths_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) ®, 1); *val = reg.wk_ths; return ret; } /** * @brief Wake up duration event.1LSb = 1 / ODR.[set] * * @param ctx read / write interface definitions * @param val change the values of wake_dur in reg WAKE_UP_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_wkup_dur_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_wake_up_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) ®, 1); if (ret == 0) { reg.wake_dur = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) ®, 1); } return ret; } /** * @brief Wake up duration event.1LSb = 1 / ODR.[get] * * @param ctx read / write interface definitions * @param val change the values of wake_dur in reg WAKE_UP_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_wkup_dur_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_wake_up_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) ®, 1); *val = reg.wake_dur; return ret; } /** * @brief Data sent to wake-up interrupt function.[set] * * @param ctx read / write interface definitions * @param val change the values of usr_off_on_wu in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_wkup_feed_data_set(const stmdev_ctx_t *ctx, iis2dlpc_usr_off_on_wu_t val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); if (ret == 0) { reg.usr_off_on_wu = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } return ret; } /** * @brief Data sent to wake-up interrupt function.[get] * * @param ctx read / write interface definitions * @param val Get the values of usr_off_on_wu in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_wkup_feed_data_get(const stmdev_ctx_t *ctx, iis2dlpc_usr_off_on_wu_t *val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); switch (reg.usr_off_on_wu) { case IIS2DLPC_HP_FEED: *val = IIS2DLPC_HP_FEED; break; case IIS2DLPC_USER_OFFSET_FEED: *val = IIS2DLPC_USER_OFFSET_FEED; break; default: *val = IIS2DLPC_HP_FEED; break; } return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Activity/Inactivity_Detection * @brief This section groups all the functions concerning * activity/inactivity detection. * @{ * */ /** * @brief Config activity / inactivity or * stationary / motion detection.[set] * * @param ctx read / write interface definitions * @param val change the values of sleep_on / stationary in * reg WAKE_UP_THS / WAKE_UP_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_act_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_sleep_on_t val) { iis2dlpc_wake_up_ths_t wake_up_ths; iis2dlpc_wake_up_dur_t wake_up_dur; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) &wake_up_ths, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) &wake_up_dur, 1); } if (ret == 0) { wake_up_ths.sleep_on = (uint8_t) val & 0x01U; wake_up_dur.stationary = ((uint8_t)val & 0x02U) >> 1; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) &wake_up_ths, 2); } else { ret = ret; } return ret; } /** * @brief Config activity / inactivity or * stationary / motion detection. [get] * * @param ctx read / write interface definitions * @param val Get the values of sleep_on in reg WAKE_UP_THS * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_act_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_sleep_on_t *val) { iis2dlpc_wake_up_ths_t wake_up_ths; iis2dlpc_wake_up_dur_t wake_up_dur;; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) &wake_up_ths, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) &wake_up_dur, 1); switch ((wake_up_dur.stationary << 1) + wake_up_ths.sleep_on) { case IIS2DLPC_NO_DETECTION: *val = IIS2DLPC_NO_DETECTION; break; case IIS2DLPC_DETECT_ACT_INACT: *val = IIS2DLPC_DETECT_ACT_INACT; break; case IIS2DLPC_DETECT_STAT_MOTION: *val = IIS2DLPC_DETECT_STAT_MOTION; break; default: *val = IIS2DLPC_NO_DETECTION; break; } } return ret; } /** * @brief Duration to go in sleep mode (1 LSb = 512 / ODR).[set] * * @param ctx read / write interface definitions * @param val change the values of sleep_dur in reg WAKE_UP_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_act_sleep_dur_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_wake_up_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) ®, 1); if (ret == 0) { reg.sleep_dur = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) ®, 1); } return ret; } /** * @brief Duration to go in sleep mode (1 LSb = 512 / ODR).[get] * * @param ctx read / write interface definitions * @param val change the values of sleep_dur in reg WAKE_UP_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_act_sleep_dur_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_wake_up_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) ®, 1); *val = reg.sleep_dur; return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Tap_Generator * @brief This section groups all the functions that manage the tap * and double tap event generation. * @{ * */ /** * @brief Threshold for tap recognition.[set] * * @param ctx read / write interface definitions * @param val change the values of tap_thsx in reg TAP_THS_X * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_threshold_x_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_x_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); if (ret == 0) { reg.tap_thsx = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); } return ret; } /** * @brief Threshold for tap recognition.[get] * * @param ctx read / write interface definitions * @param val change the values of tap_thsx in reg TAP_THS_X * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_threshold_x_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_x_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); *val = reg.tap_thsx; return ret; } /** * @brief Threshold for tap recognition.[set] * * @param ctx read / write interface definitions * @param val change the values of tap_thsy in reg TAP_THS_Y * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_threshold_y_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_y_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Y, (uint8_t *) ®, 1); if (ret == 0) { reg.tap_thsy = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_Y, (uint8_t *) ®, 1); } return ret; } /** * @brief Threshold for tap recognition.[get] * * @param ctx read / write interface definitions * @param val change the values of tap_thsy in reg TAP_THS_Y * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_threshold_y_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_y_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Y, (uint8_t *) ®, 1); *val = reg.tap_thsy; return ret; } /** * @brief Selection of axis priority for TAP detection.[set] * * @param ctx read / write interface definitions * @param val change the values of tap_prior in reg TAP_THS_Y * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_axis_priority_set(const stmdev_ctx_t *ctx, iis2dlpc_tap_prior_t val) { iis2dlpc_tap_ths_y_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Y, (uint8_t *) ®, 1); if (ret == 0) { reg.tap_prior = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_Y, (uint8_t *) ®, 1); } return ret; } /** * @brief Selection of axis priority for TAP detection.[get] * * @param ctx read / write interface definitions * @param val Get the values of tap_prior in reg TAP_THS_Y * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_axis_priority_get(const stmdev_ctx_t *ctx, iis2dlpc_tap_prior_t *val) { iis2dlpc_tap_ths_y_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Y, (uint8_t *) ®, 1); switch (reg.tap_prior) { case IIS2DLPC_XYZ: *val = IIS2DLPC_XYZ; break; case IIS2DLPC_YXZ: *val = IIS2DLPC_YXZ; break; case IIS2DLPC_XZY: *val = IIS2DLPC_XZY; break; case IIS2DLPC_ZYX: *val = IIS2DLPC_ZYX; break; case IIS2DLPC_YZX: *val = IIS2DLPC_YZX; break; case IIS2DLPC_ZXY: *val = IIS2DLPC_ZXY; break; default: *val = IIS2DLPC_XYZ; break; } return ret; } /** * @brief Threshold for tap recognition.[set] * * @param ctx read / write interface definitions * @param val change the values of tap_thsz in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_threshold_z_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); if (ret == 0) { reg.tap_thsz = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); } return ret; } /** * @brief Threshold for tap recognition.[get] * * @param ctx read / write interface definitions * @param val change the values of tap_thsz in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_threshold_z_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); *val = reg.tap_thsz; return ret; } /** * @brief Enable Z direction in tap recognition.[set] * * @param ctx read / write interface definitions * @param val change the values of tap_z_en in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_detection_on_z_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); if (ret == 0) { reg.tap_z_en = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); } return ret; } /** * @brief Enable Z direction in tap recognition.[get] * * @param ctx read / write interface definitions * @param val change the values of tap_z_en in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_detection_on_z_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); *val = reg.tap_z_en; return ret; } /** * @brief Enable Y direction in tap recognition.[set] * * @param ctx read / write interface definitions * @param val change the values of tap_y_en in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_detection_on_y_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); if (ret == 0) { reg.tap_y_en = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); } return ret; } /** * @brief Enable Y direction in tap recognition.[get] * * @param ctx read / write interface definitions * @param val change the values of tap_y_en in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_detection_on_y_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); *val = reg.tap_y_en; return ret; } /** * @brief Enable X direction in tap recognition.[set] * * @param ctx read / write interface definitions * @param val change the values of tap_x_en in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_detection_on_x_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); if (ret == 0) { reg.tap_x_en = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); } return ret; } /** * @brief Enable X direction in tap recognition.[get] * * @param ctx read / write interface definitions * @param val change the values of tap_x_en in reg TAP_THS_Z * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_detection_on_x_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_z_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_Z, (uint8_t *) ®, 1); *val = reg.tap_x_en; return ret; } /** * @brief Maximum duration is the maximum time of an overthreshold signal * detection to be recognized as a tap event. The default value * of these bits is 00b which corresponds to 4*ODR_XL time. * If the SHOCK[1:0] bits are set to a different value, 1LSB * corresponds to 8*ODR_XL time.[set] * * @param ctx read / write interface definitions * @param val change the values of shock in reg INT_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_shock_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_int_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); if (ret == 0) { reg.shock = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); } return ret; } /** * @brief Maximum duration is the maximum time of an overthreshold signal * detection to be recognized as a tap event. The default value * of these bits is 00b which corresponds to 4*ODR_XL time. * If the SHOCK[1:0] bits are set to a different value, 1LSB * corresponds to 8*ODR_XL time.[get] * * @param ctx read / write interface definitions * @param val change the values of shock in reg INT_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_shock_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_int_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); *val = reg.shock; return ret; } /** * @brief Quiet time is the time after the first detected tap in which * there must not be any overthreshold event. * The default value of these bits is 00b which corresponds * to 2*ODR_XL time. If the QUIET[1:0] bits are set to a different * value, 1LSB corresponds to 4*ODR_XL time.[set] * * @param ctx read / write interface definitions * @param val change the values of quiet in reg INT_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_quiet_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_int_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); if (ret == 0) { reg.quiet = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); } return ret; } /** * @brief Quiet time is the time after the first detected tap in which * there must not be any overthreshold event. * The default value of these bits is 00b which corresponds * to 2*ODR_XL time. If the QUIET[1:0] bits are set to a different * value, 1LSB corresponds to 4*ODR_XL time.[get] * * @param ctx read / write interface definitions * @param val change the values of quiet in reg INT_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_quiet_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_int_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); *val = reg.quiet; return ret; } /** * @brief When double tap recognition is enabled, this register expresses * the maximum time between two consecutive detected taps to * determine a double tap event. * The default value of these bits is 0000b which corresponds * to 16*ODR_XL time. If the DUR[3:0] bits are set to a different * value, 1LSB corresponds to 32*ODR_XL time.[set] * * @param ctx read / write interface definitions * @param val change the values of latency in reg INT_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_dur_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_int_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); if (ret == 0) { reg.latency = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); } return ret; } /** * @brief When double tap recognition is enabled, this register expresses * the maximum time between two consecutive detected taps to * determine a double tap event. * The default value of these bits is 0000b which corresponds * to 16*ODR_XL time. If the DUR[3:0] bits are set to a different * value, 1LSB corresponds to 32*ODR_XL time.[get] * * @param ctx read / write interface definitions * @param val change the values of latency in reg INT_DUR * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_dur_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_int_dur_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_INT_DUR, (uint8_t *) ®, 1); *val = reg.latency; return ret; } /** * @brief Single/double-tap event enable.[set] * * @param ctx read / write interface definitions * @param val change the values of single_double_tap in reg WAKE_UP_THS * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_single_double_tap_t val) { iis2dlpc_wake_up_ths_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) ®, 1); if (ret == 0) { reg.single_double_tap = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) ®, 1); } return ret; } /** * @brief Single/double-tap event enable.[get] * * @param ctx read / write interface definitions * @param val Get the values of single_double_tap in reg WAKE_UP_THS * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_single_double_tap_t *val) { iis2dlpc_wake_up_ths_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_THS, (uint8_t *) ®, 1); switch (reg.single_double_tap) { case IIS2DLPC_ONLY_SINGLE: *val = IIS2DLPC_ONLY_SINGLE; break; case IIS2DLPC_BOTH_SINGLE_DOUBLE: *val = IIS2DLPC_BOTH_SINGLE_DOUBLE; break; default: *val = IIS2DLPC_ONLY_SINGLE; break; } return ret; } /** * @brief Read the tap / double tap source register.[get] * * @param ctx read / write interface definitions * @param iis2dlpc_tap_src: union of registers from TAP_SRC to * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_tap_src_get(const stmdev_ctx_t *ctx, iis2dlpc_tap_src_t *val) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_SRC, (uint8_t *) val, 1); return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Six_Position_Detection(6D/4D) * @brief This section groups all the functions concerning six * position detection (6D). * @{ * */ /** * @brief Threshold for 4D/6D function.[set] * * @param ctx read / write interface definitions * @param val change the values of 6d_ths in reg TAP_THS_X * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_6d_threshold_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_x_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); if (ret == 0) { reg._6d_ths = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); } return ret; } /** * @brief Threshold for 4D/6D function.[get] * * @param ctx read / write interface definitions * @param val change the values of 6d_ths in reg TAP_THS_X * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_6d_threshold_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_x_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); *val = reg._6d_ths; return ret; } /** * @brief 4D orientation detection enable.[set] * * @param ctx read / write interface definitions * @param val change the values of 4d_en in reg TAP_THS_X * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_4d_mode_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_tap_ths_x_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); if (ret == 0) { reg._4d_en = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); } return ret; } /** * @brief 4D orientation detection enable.[get] * * @param ctx read / write interface definitions * @param val change the values of 4d_en in reg TAP_THS_X * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_4d_mode_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_tap_ths_x_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_TAP_THS_X, (uint8_t *) ®, 1); *val = reg._4d_en; return ret; } /** * @brief Read the 6D tap source register.[get] * * @param ctx read / write interface definitions * @param val union of registers from SIXD_SRC * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_6d_src_get(const stmdev_ctx_t *ctx, iis2dlpc_sixd_src_t *val) { int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_SIXD_SRC, (uint8_t *) val, 1); return ret; } /** * @brief Data sent to 6D interrupt function.[set] * * @param ctx read / write interface definitions * @param val change the values of lpass_on6d in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_6d_feed_data_set(const stmdev_ctx_t *ctx, iis2dlpc_lpass_on6d_t val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); if (ret == 0) { reg.lpass_on6d = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); } return ret; } /** * @brief Data sent to 6D interrupt function.[get] * * @param ctx read / write interface definitions * @param val Get the values of lpass_on6d in reg CTRL_REG7 * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_6d_feed_data_get(const stmdev_ctx_t *ctx, iis2dlpc_lpass_on6d_t *val) { iis2dlpc_ctrl7_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_CTRL7, (uint8_t *) ®, 1); switch (reg.lpass_on6d) { case IIS2DLPC_ODR_DIV_2_FEED: *val = IIS2DLPC_ODR_DIV_2_FEED; break; case IIS2DLPC_LPF2_FEED: *val = IIS2DLPC_LPF2_FEED; break; default: *val = IIS2DLPC_ODR_DIV_2_FEED; break; } return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Free_Fall * @brief This section group all the functions concerning * the free fall detection. * @{ * */ /** * @brief Wake up duration event(1LSb = 1 / ODR).[set] * * @param ctx read / write interface definitions * @param val change the values of ff_dur in reg * WAKE_UP_DUR /F REE_FALL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_ff_dur_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_wake_up_dur_t wake_up_dur; iis2dlpc_free_fall_t free_fall; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) &wake_up_dur, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FREE_FALL, (uint8_t *) &free_fall, 1); } if (ret == 0) { wake_up_dur.ff_dur = ((uint8_t) val & 0x20U) >> 5; free_fall.ff_dur = (uint8_t) val & 0x1FU; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) &wake_up_dur, 1); } if (ret == 0) { ret = iis2dlpc_write_reg(ctx, IIS2DLPC_FREE_FALL, (uint8_t *) &free_fall, 1); } return ret; } /** * @brief Wake up duration event(1LSb = 1 / ODR).[get] * * @param ctx read / write interface definitions * @param val change the values of ff_dur in * reg WAKE_UP_DUR /F REE_FALL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_ff_dur_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_wake_up_dur_t wake_up_dur; iis2dlpc_free_fall_t free_fall; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_WAKE_UP_DUR, (uint8_t *) &wake_up_dur, 1); if (ret == 0) { ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FREE_FALL, (uint8_t *) &free_fall, 1); *val = (wake_up_dur.ff_dur << 5) + free_fall.ff_dur; } return ret; } /** * @brief Free fall threshold setting.[set] * * @param ctx read / write interface definitions * @param val change the values of ff_ths in reg FREE_FALL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_ff_threshold_set(const stmdev_ctx_t *ctx, iis2dlpc_ff_ths_t val) { iis2dlpc_free_fall_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FREE_FALL, (uint8_t *) ®, 1); if (ret == 0) { reg.ff_ths = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_FREE_FALL, (uint8_t *) ®, 1); } return ret; } /** * @brief Free fall threshold setting.[get] * * @param ctx read / write interface definitions * @param val Get the values of ff_ths in reg FREE_FALL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_ff_threshold_get(const stmdev_ctx_t *ctx, iis2dlpc_ff_ths_t *val) { iis2dlpc_free_fall_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FREE_FALL, (uint8_t *) ®, 1); switch (reg.ff_ths) { case IIS2DLPC_FF_TSH_5LSb_FS2g: *val = IIS2DLPC_FF_TSH_5LSb_FS2g; break; case IIS2DLPC_FF_TSH_7LSb_FS2g: *val = IIS2DLPC_FF_TSH_7LSb_FS2g; break; case IIS2DLPC_FF_TSH_8LSb_FS2g: *val = IIS2DLPC_FF_TSH_8LSb_FS2g; break; case IIS2DLPC_FF_TSH_10LSb_FS2g: *val = IIS2DLPC_FF_TSH_10LSb_FS2g; break; case IIS2DLPC_FF_TSH_11LSb_FS2g: *val = IIS2DLPC_FF_TSH_11LSb_FS2g; break; case IIS2DLPC_FF_TSH_13LSb_FS2g: *val = IIS2DLPC_FF_TSH_13LSb_FS2g; break; case IIS2DLPC_FF_TSH_15LSb_FS2g: *val = IIS2DLPC_FF_TSH_15LSb_FS2g; break; case IIS2DLPC_FF_TSH_16LSb_FS2g: *val = IIS2DLPC_FF_TSH_16LSb_FS2g; break; default: *val = IIS2DLPC_FF_TSH_5LSb_FS2g; break; } return ret; } /** * @} * */ /** * @defgroup IIS2DLPC_Fifo * @brief This section group all the functions concerning the fifo usage * @{ * */ /** * @brief FIFO watermark level selection.[set] * * @param ctx read / write interface definitions * @param val change the values of fth in reg FIFO_CTRL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_fifo_watermark_set(const stmdev_ctx_t *ctx, uint8_t val) { iis2dlpc_fifo_ctrl_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FIFO_CTRL, (uint8_t *) ®, 1); if (ret == 0) { reg.fth = val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_FIFO_CTRL, (uint8_t *) ®, 1); } return ret; } /** * @brief FIFO watermark level selection.[get] * * @param ctx read / write interface definitions * @param val change the values of fth in reg FIFO_CTRL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_fifo_watermark_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_fifo_ctrl_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FIFO_CTRL, (uint8_t *) ®, 1); *val = reg.fth; return ret; } /** * @brief FIFO mode selection.[set] * * @param ctx read / write interface definitions * @param val change the values of fmode in reg FIFO_CTRL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_fifo_mode_set(const stmdev_ctx_t *ctx, iis2dlpc_fmode_t val) { iis2dlpc_fifo_ctrl_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FIFO_CTRL, (uint8_t *) ®, 1); if (ret == 0) { reg.fmode = (uint8_t) val; ret = iis2dlpc_write_reg(ctx, IIS2DLPC_FIFO_CTRL, (uint8_t *) ®, 1); } return ret; } /** * @brief FIFO mode selection.[get] * * @param ctx read / write interface definitions * @param val Get the values of fmode in reg FIFO_CTRL * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_fifo_mode_get(const stmdev_ctx_t *ctx, iis2dlpc_fmode_t *val) { iis2dlpc_fifo_ctrl_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FIFO_CTRL, (uint8_t *) ®, 1); switch (reg.fmode) { case IIS2DLPC_BYPASS_MODE: *val = IIS2DLPC_BYPASS_MODE; break; case IIS2DLPC_FIFO_MODE: *val = IIS2DLPC_FIFO_MODE; break; case IIS2DLPC_STREAM_TO_FIFO_MODE: *val = IIS2DLPC_STREAM_TO_FIFO_MODE; break; case IIS2DLPC_BYPASS_TO_STREAM_MODE: *val = IIS2DLPC_BYPASS_TO_STREAM_MODE; break; case IIS2DLPC_STREAM_MODE: *val = IIS2DLPC_STREAM_MODE; break; default: *val = IIS2DLPC_BYPASS_MODE; break; } return ret; } /** * @brief Number of unread samples stored in FIFO.[get] * * @param ctx read / write interface definitions * @param val change the values of diff in reg FIFO_SAMPLES * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_fifo_data_level_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_fifo_samples_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FIFO_SAMPLES, (uint8_t *) ®, 1); *val = reg.diff; return ret; } /** * @brief FIFO overrun status.[get] * * @param ctx read / write interface definitions * @param val change the values of fifo_ovr in reg FIFO_SAMPLES * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_fifo_ovr_flag_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_fifo_samples_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FIFO_SAMPLES, (uint8_t *) ®, 1); *val = reg.fifo_ovr; return ret; } /** * @brief FIFO threshold status flag.[get] * * @param ctx read / write interface definitions * @param val change the values of fifo_fth in reg FIFO_SAMPLES * @retval interface status (MANDATORY: return 0 -> no Error) * */ int32_t iis2dlpc_fifo_wtm_flag_get(const stmdev_ctx_t *ctx, uint8_t *val) { iis2dlpc_fifo_samples_t reg; int32_t ret; ret = iis2dlpc_read_reg(ctx, IIS2DLPC_FIFO_SAMPLES, (uint8_t *) ®, 1); *val = reg.fifo_fth; return ret; } /** * @} * */ /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/