drivers/sensors/tmp112: Add support for TMP112 temperature sensor

Add support for the Texas Instruments TMP112 I2C/SMBus digital
temperature sensor. Also add a new defconfig that includes
support for a TMP112 sensor and extend the existing documentation
to include its description.

Signed-off-by: Niccolò Maggioni <[email protected]>

Author: nmaggioni

Documentation/platforms/arm/rp2040/boards/raspberrypi-pico/index.rst

@@ -48,42 +48,42 @@ Pad   Signal     Notes
 ===== ========== ==========
 1     GPIO0      Default TX for UART0 serial console
 2     GPIO1      Default RX for UART0 serial console
-3     Ground                                         
-4     GPIO2                                          
-5     GPIO3                                          
+3     Ground
+4     GPIO2
+5     GPIO3
 6     GPIO4      Default SDA for I2C0
 7     GPIO5      Default SCL for I2C0
-8     Ground                                         
+8     Ground
 9     GPIO6      Default SDA for I2C1
 10    GPIO7      Default SCL for I2C1
 11    GPIO8      Default RX for SPI1
 12    GPIO9      Default CSn for SPI1
-13    Ground                                         
+13    Ground
 14    GPIO10     Default SCK for SPI1
 15    GPIO11     Default TX for SPI1
-16    GPIO12                                         
-17    GPIO13                                         
-18    Ground                                         
-19    GPIO14                                         
-20    GPIO15                                         
+16    GPIO12
+17    GPIO13
+18    Ground
+19    GPIO14
+20    GPIO15
 21    GPIO16     Default RX for SPI0
 22    GPIO17     Default CSn for SPI0
-23    Ground                                         
+23    Ground
 24    GPIO18     Default SCK for SPI0
 25    GPIO19     Default TX for SPI0
 26    GPIO20     Default TX for UART1 serial console
 27    GPIO21     Default RX for UART1 serial console
-28    Ground                                         
-29    GPIO22                                         
-30    Run                                            
+28    Ground
+29    GPIO22
+30    Run
 31    GPIO26     ADC0
 32    GPIO27     ADC1
 33    AGND       Analog Ground
 34    GPIO28     ADC2
 35    ADC_VREF   Analog reference voltage
 36    3V3        Power output to peripherals
 37    3V3_EN     Pull to ground to turn off.
-38    Ground                                         
+38    Ground
 39    VSYS       +5V Supply to board
 40    VBUS       Connected to USB +5V
 ===== ========== ==========
@@ -217,7 +217,7 @@ LCD1602 Segment LCD Display (I2C).
    :widths: auto
    :header-rows: 1
 
-   * - PCF8574 BackPack 
+   * - PCF8574 BackPack
      - Raspberry Pi Pico
    * - GND
      - GND (Pin 3 or 38 or ...)
@@ -263,7 +263,7 @@ card support enabled.
 
    * - SD card slot
      - Raspberry Pi Pico
-   * - DAT2          
+   * - DAT2
      - Not connected
    * - DAT3/CS
      - GP17 (SPI0 CSn) (Pin 22)
@@ -277,7 +277,7 @@ card support enabled.
      - GND (Pin 3 or 38 or ...)
    * - DAT0/DO
      - GP16 (SPI0 RX)  (Pin 21)
-   * - DAT1          
+   * - DAT1
      - Not connected
 
 Card hot swapping is not supported.
@@ -300,7 +300,7 @@ for SSD1306 OLED display (I2C) test configuration.
      - 3V3 OUT (Pin 36)
    * - SDA
      - GP4 (I2C0 SDA) (Pin 6)
-   * - SCL   
+   * - SCL
      - GP5 (I2C0 SCL) (Pin 7)
 
 st7735
@@ -332,6 +332,34 @@ ST7735 SPI LCD.
    * - RESET
      - GP10 (Pin 14)
 
+tmp112
+------
+
+NuttShell configuration (console enabled in USB Port, at 115200 bps) with support for Texas Instruments TMP112 sensor:
+
+.. list-table:: TMP112 connections
+   :widths: auto
+   :header-rows: 1
+
+   * - TMP112
+     - Raspberry Pi Pico
+   * - GND
+     - GND (Pin 3 or 38 or ...)
+   * - VCC
+     - 3V3 OUT (Pin 36)
+   * - SDA
+     - GP4 (I2C0 SDA) (Pin 6)
+   * - SCL
+     - GP5 (I2C0 SCL) (Pin 7)
+   * - ADD0
+     - GND (Pin 3 or 38 or ...)
+
+.. code-block:: console
+
+   nsh> tmp112
+   Sensor #1 = 27.688 degrees Celsius
+   nsh>
+
 usbmsc
 ------
 

boards/arm/rp2040/common/include/rp2040_tmp112.h

@@ -0,0 +1,89 @@
+/****************************************************************************
+ * boards/arm/rp2040/common/include/rp2040_tmp112.h
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.  The
+ * ASF licenses this file to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance with the
+ * License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ *
+ ****************************************************************************/
+
+#ifndef __BOARDS_ARM_RP2040_COMMON_INCLUDE_RP2040_TMP112_H
+#define __BOARDS_ARM_RP2040_COMMON_INCLUDE_RP2040_TMP112_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+#include <nuttx/i2c/i2c_master.h>
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Type Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Data
+ ****************************************************************************/
+
+#ifdef __cplusplus
+#define EXTERN extern "C"
+extern "C"
+{
+#else
+#define EXTERN extern
+#endif
+
+/****************************************************************************
+ * Inline Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: board_tmp112_initialize
+ *
+ * Description:
+ *   Initialize and register the TMP112 temperature sensor driver.
+ *
+ * Input Parameters:
+ *   i2c   - An instance of the I2C interface to use.
+ *   devno - The device number, used to build the device path as /dev/tempN.
+ *   addr  - The I2C address to use.
+ *
+ * Returned Value:
+ *   Zero (OK) on success; a negated errno value on failure.
+ *
+ ****************************************************************************/
+
+int board_tmp112_initialize(FAR struct i2c_master_s *i2c, int devno,
+                            uint8_t addr);
+
+#undef EXTERN
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __BOARDS_ARM_RP2040_COMMON_INCLUDE_RP2040_TMP112_H */

boards/arm/rp2040/common/src/Make.defs

@@ -109,6 +109,10 @@ ifeq ($(CONFIG_SENSORS_MAX6675),y)
   CSRCS += rp2040_max6675.c
 endif
 
+ifeq ($(CONFIG_SENSORS_TMP112),y)
+  CSRCS += rp2040_tmp112.c
+endif
+
 DEPPATH += --dep-path src
 VPATH += :src
 CFLAGS += ${INCDIR_PREFIX}$(TOPDIR)$(DELIM)arch$(DELIM)$(CONFIG_ARCH)$(DELIM)src$(DELIM)board$(DELIM)src

boards/arm/rp2040/common/src/rp2040_common_bringup.c

@@ -90,6 +90,12 @@
 #include "rp2040_max6675.h"
 #endif
 
+#ifdef CONFIG_SENSORS_TMP112
+#include <nuttx/sensors/tmp112.h>
+#include "rp2040_tmp112.h"
+#include "rp2040_i2c.h"
+#endif
+
 #ifdef CONFIG_RP2040_PWM
 #include "rp2040_pwm.h"
 #include "rp2040_pwmdev.h"
@@ -569,6 +575,17 @@ int rp2040_common_bringup(void)
     }
 #endif
 
+#ifdef CONFIG_SENSORS_TMP112
+  /* Try to register TMP112 device at I2C0 with a common address */
+
+  ret = board_tmp112_initialize(rp2040_i2cbus_initialize(0), 0,
+                                TMP112_ADDR_1);
+  if (ret < 0)
+    {
+      syslog(LOG_ERR, "Failed to initialize TMP112 driver: %d\n", ret);
+    }
+#endif
+
 #ifdef CONFIG_VIDEO_FB
   ret = fb_register(0, 0);
   if (ret < 0)

boards/arm/rp2040/common/src/rp2040_tmp112.c

@@ -0,0 +1,105 @@
+/****************************************************************************
+ * boards/arm/rp2040/common/src/rp2040_tmp112.c
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.  The
+ * ASF licenses this file to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance with the
+ * License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+ * License for the specific language governing permissions and limitations
+ * under the License.
+ *
+ ****************************************************************************/
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <stdio.h>
+#include <debug.h>
+
+#include <nuttx/arch.h>
+#include <nuttx/sensors/tmp112.h>
+
+#include "rp2040_i2c.h"
+#include "rp2040_tmp112.h"
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Types
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Function Prototypes
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Data
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Data
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: board_tmp112_initialize
+ *
+ * Description:
+ *   Initialize and register the TMP112 temperature sensor driver.
+ *
+ * Input Parameters:
+ *   i2c   - An instance of the I2C interface to use.
+ *   devno - The device number, used to build the device path as /dev/tempN.
+ *   addr  - The I2C address to use.
+ *
+ * Returned Value:
+ *   Zero (OK) on success; a negated errno value on failure.
+ *
+ ****************************************************************************/
+
+int board_tmp112_initialize(FAR struct i2c_master_s *i2c, int devno,
+                            uint8_t addr)
+{
+  char devpath[11];
+  int ret;
+
+  sninfo("Initializing TMP112 with address %#4x\n", addr);
+
+  if (i2c)
+    {
+      snprintf(devpath, sizeof(devpath), "/dev/temp%d", devno);
+      ret = tmp112_register(devpath, i2c, addr);
+      if (ret < 0)
+        {
+          snerr("ERROR: Error registering TMP112 at /dev/temp%d\n", devno);
+        }
+    }
+  else
+    {
+      ret = -ENODEV;
+    }
+
+  return ret;
+}