drivers/tmp117: TMP117 driver

drivers/include/tmp117.h

@@ -0,0 +1,161 @@
+/*
+ * SPDX-FileCopyrightText: 2026 UGA
+ * SPDX-License-Identifier: LGPL-2.1-only
+ */
+
+#pragma once
+
+/**
+ * @defgroup    drivers_tmp117
+ * @ingroup     drivers_sensors
+ * @brief       Driver for TMP117 temperature sensor
+ *
+ * @{
+ * @file
+ * @brief		Parameters definition for the TMP117 temperature sensor
+ * @author      léo cordier <leo.cordier@univ-grenoble-alpes.fr>
+ */
+
+#include "periph/i2c.h"
+#include <errno.h>
+#include <stdbool.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief   Named return values
+ */
+enum {
+    TMP117_OK           =  0,       /**< everything was fine */
+    TMP117_DATAREADY    =  1,       /**< data is ready to be read */
+    TMP117_NOI2C        = -EIO,     /**< I2C communication failed */
+    TMP117_NODEV        = -ENODEV,  /**< no TMP117 device found on the bus */
+    TMP117_NODATA       = -ENODATA  /**< no data available */
+};
+
+/**
+ * @brief   TMP117 conversion modes
+ */
+typedef enum {
+    TMP117_CONV_CC  = 0,    /**< continuous conversion mode */
+    TMP117_CONV_SD  = 1,    /**< shutdown conversion mode */
+    TMP117_CONV_OS  = 3     /**< one shot conversion mode */
+} tmp117_conv_mode_t;
+
+/**
+ * @brief   TMP117 conversion cycle
+ */
+typedef enum {
+    TMP117_CONV_CYCLE_15_MS     = 0,    /**< 15.5ms conversion cycle */
+    TMP117_CONV_CYCLE_125_MS    = 1,    /**< 125ms conversion cycle */
+    TMP117_CONV_CYCLE_250_MS    = 2,    /**< 250ms conversion cycle */
+    TMP117_CONV_CYCLE_500_MS    = 3,    /**< 500ms conversion cycle */
+    TMP117_CONV_CYCLE_1_S       = 4,    /**< 1s conversion cycle */
+    TMP117_CONV_CYCLE_4_S       = 5,    /**< 4s conversion cycle */
+    TMP117_CONV_CYCLE_8_S       = 6,    /**< 8s conversion cycle */
+    TMP117_CONV_CYCLE_16_S      = 7,    /**< 16s conversion cycle */
+} tmp117_conv_cycle_t;
+
+/**
+ * @brief   TMP117 averaging value
+ */
+typedef enum {
+    TMP117_NO_AVG   = 0,    /**< no averaging */
+    TMP117_AVG_8    = 1,    /**< 8 Averaged conversions */
+    TMP117_AVG_32   = 2,    /**< 32 Averaged conversions */
+    TMP117_AVG_64   = 3,    /**< 64 Averaged conversions */
+} tmp117_avg_t;
+
+/**
+ * @brief   TMP117 parameters structure
+ */
+typedef struct {
+    i2c_t i2c;                      /**< i2c peripheral */
+    uint8_t addr;                   /**< i2c address */
+    tmp117_conv_mode_t conv_mode;   /**< conversion mode */
+    tmp117_conv_cycle_t conv_cycle; /**< conversion cycle time */
+    tmp117_avg_t avg;               /**< data averaging*/
+}tmp117_params_t;
+
+/**
+ * @brief   TMP117 sensor structure
+ */
+typedef struct {
+    tmp117_params_t params;
+    bool is_initialized;
+} tmp117_t;
+
+/**
+ * @brief   Initializes a TMP117 device
+ *
+ * @param[in,out] dev  device descriptor
+ * @param[in] params   device configuration
+ *
+ * @retval TMP117_OK on success
+ * @retval TMP117_NODEV if no device is found on the bus
+ * @retval TMP117_NOI2C if other error occurs
+ */
+int tmp117_init(tmp117_t *dev, const tmp117_params_t *params);
+
+/**
+ * @brief Reads the temperature from the sensor.
+ *
+ * @param[in, out] dev device descriptor
+ * @param[out] value read value in centi-celsius
+ *
+ * @return TMP117_OK on success
+ * @return TMP117_I2C if other error occurs
+ */
+int tmp117_read_temperature(tmp117_t *dev, int16_t *value);
+
+/**
+ * @brief Update the conversion mode of the sensor.
+ *
+ * @param[in, out] dev device descriptor
+ * @param[in] mode conversion mode value
+ *
+ * @return TMP117_OK on success
+ * @return TMP117_I2C if other error occurs
+ */
+int tmp117_set_conversion_mode(tmp117_t *dev, tmp117_conv_mode_t mode);
+
+/**
+ * @brief Update the conversion cycle of the sensor.
+ *
+ * @param[in, out] dev device descriptor
+ * @param[in] cycle conversion cycle value
+ *
+ * @return TMP117_OK on success
+ * @return TMP117_I2C if other error occurs
+ */
+int tmp117_set_conversion_cycle(tmp117_t *dev, tmp117_conv_cycle_t cycle);
+
+/**
+ * @brief Update the averaging value of the sensor.
+ *
+ * @param[in, out] dev device descriptor
+ * @param[in] avg averaging value
+ *
+ * @return TMP117_OK on success
+ * @return TMP117_I2C if other error occurs
+ */
+int tmp117_set_averaging(tmp117_t *dev, tmp117_avg_t avg);
+
+/**
+ * @brief Check if the sensor have a new temperature measure available.
+ *
+ * @param[in, out] dev device descriptor
+ *
+ * @return TMP117_DATAREADY a new data is available
+ * @return TMP117_OK no new data available
+ * @return TMP117_I2C if other error occurs
+ */
+int tmp117_is_data_ready(tmp117_t *dev);
+
+#ifdef __cplusplus
+}
+#endif
+
+/** @} */

drivers/saul/init_devs/auto_init_tmp117.c

@@ -0,0 +1,66 @@
+/*
+ * SPDX-FileCopyrightText: 2026 UGA
+ * SPDX-License-Identifier: LGPL-2.1-only
+ */
+
+/**
+ * @ingroup     sys_auto_init_saul
+ * @{
+ *
+ * @file
+ * @brief       Auto initialization of TMP117 temperature sensor
+ *
+ * @author      léo cordier <leo.cordier@univ-grenoble-alpes.fr>
+ *
+ * @}
+ */
+#include "assert.h"
+#include "log.h"
+#include "saul_reg.h"
+#include "container.h"
+
+#include "tmp117.h"
+#include "tmp117_params.h"
+
+/**
+ * @brief   Define the number of configured sensors
+ */
+#define TMP117_NUM     ARRAY_SIZE(tmp117_params)
+
+/**
+ * @brief   Allocate memory for the device descriptors
+ */
+static tmp117_t tmp117_devs[TMP117_NUM];
+
+/**
+ * @brief   Memory for the SAUL registry entries
+ */
+static saul_reg_t saul_entries[TMP117_NUM];
+
+/**
+ * @brief   Define the number of saul info
+ */
+#define TMP117_INFO_NUM     ARRAY_SIZE(tmp117_saul_info)
+
+/**
+ * @brief   Reference the driver struct
+ */
+extern const saul_driver_t tmp117_saul_driver;
+
+void auto_init_tmp117(void)
+{
+    assert(TMP117_NUM == TMP117_INFO_NUM);
+
+    for (unsigned i = 0; i < TMP117_NUM; i++) {
+        LOG_DEBUG("[auto_init_saul] initializing tmp117 #%u\n", i);
+
+        if (tmp117_init(&tmp117_devs[i], &tmp117_params[i]) != TMP117_OK) {
+            LOG_ERROR("[auto_init_saul] error initializing tmp117 #%u\n", i);
+            continue;
+        }
+        saul_entries[i].dev = &(tmp117_devs[i]);
+        saul_entries[i].name = tmp117_saul_info[i].name;
+        saul_entries[i].driver = &tmp117_saul_driver;
+        saul_reg_add(&(saul_entries[i]));
+    }
+}

drivers/saul/init_devs/init.c

@@ -359,6 +359,10 @@ void saul_init_devs(void)
         extern void auto_init_tmp00x(void);
         auto_init_tmp00x();
     }
+    if (IS_USED(MODULE_TMP117)) {
+        extern void auto_init_tmp117(void);
+        auto_init_tmp117();
+    }
     if (IS_USED(MODULE_TSL2561)) {
         extern void auto_init_tsl2561(void);
         auto_init_tsl2561();

drivers/tmp117/Makefile

@@ -0,0 +1 @@
+include $(RIOTMAKE)/driver_with_saul.mk

drivers/tmp117/Makefile.dep

@@ -0,0 +1 @@
+FEATURES_REQUIRED += periph_i2c

drivers/tmp117/Makefile.include

@@ -0,0 +1,2 @@
+USEMODULE_INCLUDES_tmp117 := $(LAST_MAKEFILEDIR)/include
+USEMODULE_INCLUDES += $(USEMODULE_INCLUDES_tmp117)

drivers/tmp117/include/tmp117_params.h

@@ -0,0 +1,84 @@
+/*
+ * SPDX-FileCopyrightText: 2026 UGA
+ * SPDX-License-Identifier: LGPL-2.1-only
+ */
+
+#pragma once
+
+/**
+ * @defgroup    drivers_tmp117
+ * @ingroup     drivers_sensors
+ * @brief       Driver for TMP117 temperature sensor
+ *
+ * @{
+ * @file
+ * @brief		Parameters definition for the TMP117 temperature sensor
+ * @author      léo cordier <leo.cordier@univ-grenoble-alpes.fr>
+ */
+
+#include "board.h"
+#include "tmp117.h"
+#include "saul_reg.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief   Default configuration parameters for TMP117 sensors
+ * @{
+ */
+#ifndef TMP117_PARAM_I2C
+#  define TMP117_PARAM_I2C      (I2C_DEV(0))                /**< default TMP117 i2c peripheral */
+#endif
+#ifndef TMP117_PARAM_ADDR
+#  define TMP117_PARAM_ADDR     (0x48)                      /**< default TMP117 i2c address */
+#endif
+#ifndef TMP117_PARAM_CONV_MODE
+#  define TMP117_PARAM_CONV_MODE    TMP117_CONV_CC          /**< default TMP117 conversion mode */
+#endif
+#ifndef TMP117_PARAM_CONV_CYCLE
+#  define TMP117_PARAM_CONV_CYCLE   TMP117_CONV_CYCLE_1_S   /**< default TMP117 conversion cycle */
+#endif
+#ifndef TMP117_PARAM_AVG
+#  define TMP117_PARAM_AVG          TMP117_AVG_8            /**< default TMP117 averaging */
+#endif
+
+#ifndef TMP117_PARAMS
+#  define TMP117_PARAMS       { .i2c = TMP117_PARAM_I2C, \
+                                .addr = TMP117_PARAM_ADDR, \
+                                .conv_mode = TMP117_PARAM_CONV_MODE, \
+                                .conv_cycle = TMP117_PARAM_CONV_CYCLE, \
+                                .avg = TMP117_PARAM_AVG }   /**< default TMP117 parameters */
+#endif
+/** @} */
+
+#ifndef TMP117_SAUL_INFO
+/**
+ * @brief   The SAUL info to register the TMP117 device driver instances with
+ */
+#define TMP117_SAUL_INFO           { .name = "tmp117" }
+#endif
+/**@}*/
+
+/**
+ * @brief   Allocation of TMP117 configuration
+ */
+static const tmp117_params_t tmp117_params[] =
+{
+    TMP117_PARAMS
+};
+
+/**
+ * @brief   Additional meta information to keep in the SAUL registry
+ */
+static const saul_reg_info_t tmp117_saul_info[] =
+{
+    TMP117_SAUL_INFO
+};
+
+#ifdef __cplusplus
+}
+#endif
+
+/** @} */