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 <nicco.maggioni+nuttx@gmail.com>

include/nuttx/sensors/tmp112.h

@@ -0,0 +1,117 @@
+/****************************************************************************
+ * include/nuttx/sensors/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 __INCLUDE_NUTTX_SENSORS_TMP112_H
+#define __INCLUDE_NUTTX_SENSORS_TMP112_H
+
+#if defined(CONFIG_I2C) && defined(CONFIG_SENSORS_TMP112)
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+#include <nuttx/i2c/i2c_master.h>
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+#define TMP112_REG_CONFIG  0x01
+#define TMP112_REG_TEMP    0x00
+
+/* Addresses for the Alert-only and Address+Alert versions of this IC.
+ * Typically include:
+ *      - TMP112D0 (X2SON-5 package)
+ *      - TMP112D1 (X2SON-5 package)
+ *      - TMP112D2 (X2SON-5 package)
+ *      - TMP112D3 (X2SON-5 package)
+ *      - TMP112A  (SOT563-6 package)
+ *      - TMP112B  (SOT563-6 package)
+ *      - TMP112D  (SOT563-6 package)
+ *      - TMP112N  (SOT563-6 package)
+ */
+
+#define TMP112_ADDR_1      0x48
+#define TMP112_ADDR_2      0x49
+#define TMP112_ADDR_3      0x4A
+#define TMP112_ADDR_4      0x4B
+
+/* Addresses for the Address-only version of this IC.
+ * Typically includes:
+ *      - TMP112D (X2SON-5 package)
+ */
+
+#define TMP112_ALT_ADDR_1  0x40
+#define TMP112_ALT_ADDR_2  0x41
+#define TMP112_ALT_ADDR_3  0x42
+#define TMP112_ALT_ADDR_4  0x43
+
+/* Configuration ************************************************************/
+
+/* Prerequisites:
+ *
+ * CONFIG_SENSORS_TMP112
+ *   Enables support for the TMP112 driver
+ */
+
+/****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
+#ifdef __cplusplus
+#define EXTERN  extern "C"
+extern "C"
+{
+#else
+#define EXTERN  extern
+#endif
+
+/****************************************************************************
+ * Name: tmp112_register
+ *
+ * Description:
+ *   Register the TMP112 character device as 'devpath'
+ *
+ * Input Parameters:
+ *   devpath - The full path to the driver to register. E.g., "/dev/temp0"
+ *   i2c     - An instance of the I2C interface to use.
+ *   addr    - The I2C address to use.
+ *             When multiple sensors are connected to the same bus, each one
+ *             must be electrically configured to use a different I2C
+ *             address as specified in the datasheet.
+ *
+ * Returned Value:
+ *   Zero (OK) on success; a negated errno value on failure.
+ *
+ ****************************************************************************/
+
+int tmp112_register(FAR const char *devpath, FAR struct i2c_master_s *i2c,
+                    uint8_t addr);
+
+#undef EXTERN
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* CONFIG_I2C && CONFIG_SENSORS_TMP112 */
+#endif /* __INCLUDE_NUTTX_SENSORS_TMP112_H */