1 /*
2  * Copyright (c) 2021 Jimmy Johnson <catch22@fastmail.net>
3  * Copyright (c) 2022 T-Mobile USA, Inc.
4  *
5  * SPDX-License-Identifier: Apache-2.0
6  */
7 
8 #ifndef ZEPHYR_DRIVERS_SENSOR_TMP108_TMP108_H_
9 #define ZEPHYR_DRIVERS_SENSOR_TMP108_TMP108_H_
10 
11 #include <stdint.h>
12 
13 #include <zephyr/drivers/i2c.h>
14 #include <zephyr/drivers/sensor.h>
15 #include <zephyr/drivers/gpio.h>
16 #include <zephyr/drivers/sensor/tmp108.h>
17 
18 #define TI_TMP108_REG_TEMP		0x00   /** Temperature register */
19 #define TI_TMP108_REG_CONF		0x01   /** Configuration register */
20 #define TI_TMP108_REG_LOW_LIMIT		0x02   /** Low alert set register */
21 #define TI_TMP108_REG_HIGH_LIMIT	0x03   /** High alert set register */
22 
23 #define AMS_AS6212_CONF                                                                            \
24 	{.CONF_CR0 = 0x0040,                                                                       \
25 	 .CONF_CR1 = 0x0080,                                                                       \
26 	 .CONF_SLEEP = 0x0100,                                                                     \
27 	 .CONF_M1 = 0x0000,                                                                        \
28 	 .CONF_TM = 0x0200,                                                                        \
29 	 .CONF_M0 = 0x8000,                                                                        \
30 	 .CONF_RST = 0x0080,                                                                       \
31 	 .TEMP_MULT = 15625,                                                                       \
32 	 .TEMP_DIV = 2,                                                                            \
33 	 IF_ENABLED(CONFIG_TMP108_ALERT_INTERRUPTS, (.CONF_POL = 0x0400))}
34 
35 #define TI_TMP108_CONF                                                                             \
36 	{.CONF_M0 = 0x0100,                                                                        \
37 	 .CONF_M1 = 0x0200,                                                                        \
38 	 .CONF_TM = 0x0400,                                                                        \
39 	 .CONF_CR0 = 0x2000,                                                                       \
40 	 .CONF_CR1 = 0x4000,                                                                       \
41 	 .CONF_RST = 0x0022,                                                                       \
42 	 .TEMP_MULT = 15625,                                                                       \
43 	 .TEMP_DIV = 4,                                                                            \
44 	 IF_ENABLED(CONFIG_TMP108_ALERT_INTERRUPTS,                                                \
45 		    (.CONF_HYS0 = 0x0010, .CONF_HYS1 = 0x0020, .CONF_POL = 0x0080))}
46 
47 #define TI_TMP108_MODE_SHUTDOWN(x) 0
48 #define TI_TMP108_MODE_ONE_SHOT(x) (TI_TMP108_CONF_M0(x) | TI_TMP108_CONF_SLEEP(x))
49 #define TI_TMP108_MODE_CONTINUOUS(x) TI_TMP108_CONF_M1(x)
50 #define TI_TMP108_MODE_MASK(x)	~(TI_TMP108_CONF_M0(x) | \
51 				  TI_TMP108_CONF_M1(x) | \
52 				  TI_TMP108_CONF_SLEEP(x))
53 
54 #define TI_TMP108_FREQ_4_SECS(x) 0
55 #define TI_TMP108_FREQ_1_HZ(x) TI_TMP108_GET_CONF(x, CONF_CR0)
56 #define TI_TMP108_FREQ_4_HZ(x) TI_TMP108_GET_CONF(x, CONF_CR1)
57 #define TI_TMP108_FREQ_16_HZ(x)	(TI_TMP108_GET_CONF(x, CONF_CR1) | \
58 				TI_TMP108_GET_CONF(x, CONF_CR0))
59 #define TI_TMP108_FREQ_MASK(x)	~(TI_TMP108_GET_CONF(x, CONF_CR1) | \
60 				TI_TMP108_GET_CONF(x, CONF_CR0))
61 
62 #define TI_TMP108_CONF_POL_LOW(x) 0
63 #define TI_TMP108_CONF_POL_HIGH(x) TI_TMP108_GET_CONF(x, CONF_POL)
64 #define TI_TMP108_CONF_POL_MASK(x) ~(TI_TMP108_GET_CONF(x, CONF_POL))
65 
66 #define TI_TMP108_CONF_TM_CMP(x) 0
67 #define TI_TMP108_CONF_TM_INT(x) TI_TMP108_GET_CONF(x, CONF_TM)
68 #define TI_TMP108_CONF_TM_MASK(x) ~(TI_TMP108_GET_CONF(x, CONF_TM))
69 
70 #define TI_TMP108_HYSTER_0_C(x)	0
71 #define TI_TMP108_HYSTER_1_C(x)	TI_TMP108_GET_CONF(x, CONF_HYS0)
72 #define TI_TMP108_HYSTER_2_C(x)	TI_TMP108_GET_CONF(x, CONF_HYS1)
73 #define TI_TMP108_HYSTER_4_C(x)	(TI_TMP108_GET_CONF(x, CONF_HYS1) | \
74 				TI_TMP108_GET_CONF(x, CONF_HYS0))
75 #define TI_TMP108_HYSTER_MASK(x) ~(TI_TMP108_GET_CONF(x, CONF_HYS1) | \
76 				 TI_TMP108_GET_CONF(x, CONF_HYS0))
77 
78 #define TI_TMP108_CONF_M1(x) TI_TMP108_GET_CONF(x, CONF_M1)
79 #define TI_TMP108_CONF_M0(x) TI_TMP108_GET_CONF(x, CONF_M0)
80 #define TI_TMP108_CONF_SLEEP(x) TI_TMP108_GET_CONF(x, CONF_SLEEP)
81 
82 #define TMP108_TEMP_MULTIPLIER(x)	TI_TMP108_GET_CONF(x, TEMP_MULT)
83 #define TMP108_TEMP_DIVISOR(x)	TI_TMP108_GET_CONF(x, TEMP_DIV)
84 #define TMP108_CONF_RST(x)	TI_TMP108_GET_CONF(x, CONF_RST)
85 
86 #define TI_TMP108_CONF_NA 0x0000
87 
88 struct tmp_108_reg_def {
89 	uint16_t CONF_M0;    /** Mode 1 configuration bit */
90 	uint16_t CONF_M1;    /** Mode 2 configuration bit */
91 	uint16_t CONF_SLEEP; /** Sleep mode configuration bit */
92 	uint16_t CONF_CR0;   /** Conversion rate 1 configuration bit */
93 	uint16_t CONF_CR1;   /** Conversion rate 2 configuration bit */
94 	uint16_t CONF_TM;    /** Thermostat mode setting bit */
95 	int32_t TEMP_MULT;   /** Temperature multiplier */
96 	int32_t TEMP_DIV;    /** Temperature divisor */
97 	uint16_t CONF_RST;   /** default reset values on init */
98 #ifdef CONFIG_TMP108_ALERT_INTERRUPTS
99 	uint16_t CONF_POL;  /** Alert pin Polarity configuration bit */
100 	uint16_t CONF_HYS1; /** Temperature hysteresis config 1 bit  */
101 	uint16_t CONF_HYS0; /** Temperature hysteresis config 2 bit */
102 #endif
103 };
104 
105 #define TI_TMP108_GET_CONF(x, cfg) ((struct tmp108_config *)(x->config))->reg_def.cfg
106 
107 struct tmp108_config {
108 	const struct i2c_dt_spec i2c_spec;
109 	struct tmp_108_reg_def reg_def;
110 #ifdef CONFIG_TMP108_ALERT_INTERRUPTS
111 	const struct gpio_dt_spec alert_gpio;
112 #endif /* CONFIG_TMP108_ALERT_INTERRUPTS */
113 };
114 
115 struct tmp108_data {
116 	int16_t sample;
117 
118 	bool one_shot_mode;
119 
120 #ifdef CONFIG_TMP108_ALERT_INTERRUPTS
121 	const struct device *tmp108_dev;
122 
123 	const struct sensor_trigger *temp_alert_trigger;
124 	sensor_trigger_handler_t temp_alert_handler;
125 
126 	struct gpio_callback temp_alert_gpio_cb;
127 #endif /* CONFIG_TMP108_ALERT_INTERRUPTS */
128 };
129 
130 int tmp_108_trigger_set(const struct device *dev,
131 			const struct sensor_trigger *trig,
132 			sensor_trigger_handler_t handler);
133 
134 int tmp108_reg_read(const struct device *dev, uint8_t reg, uint16_t *val);
135 
136 int ti_tmp108_read_temp(const struct device *dev);
137 void tmp108_trigger_handle_one_shot(struct k_work *work);
138 void tmp108_trigger_handle_alert(const struct device *port,
139 				 struct gpio_callback *cb,
140 				 gpio_port_pins_t pins);
141 
142 #endif /*  ZEPHYR_DRIVERS_SENSOR_TMP108_TMP108_H_ */
143