xref: /linux/drivers/iio/chemical/bme680.h (revision 9d2fe9cd02ca5f1e70a7eff0262fb3668a27db0c)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef BME680_H_
3 #define BME680_H_
4 
5 #include <linux/regmap.h>
6 
7 #define BME680_REG_CHIP_ID			0xD0
8 #define   BME680_CHIP_ID_VAL			0x61
9 #define BME680_REG_SOFT_RESET			0xE0
10 #define   BME680_CMD_SOFTRESET			0xB6
11 #define BME680_REG_STATUS			0x73
12 #define   BME680_SPI_MEM_PAGE_BIT		BIT(4)
13 #define     BME680_SPI_MEM_PAGE_1_VAL		1
14 
15 #define BME680_REG_TEMP_MSB			0x22
16 #define BME680_REG_PRESS_MSB			0x1F
17 #define BME680_REG_HUMIDITY_MSB			0x25
18 #define BME680_REG_GAS_MSB			0x2A
19 #define BME680_REG_GAS_R_LSB			0x2B
20 #define   BME680_GAS_STAB_BIT			BIT(4)
21 #define   BME680_GAS_RANGE_MASK			GENMASK(3, 0)
22 
23 #define BME680_REG_CTRL_HUMIDITY		0x72
24 #define   BME680_OSRS_HUMIDITY_MASK		GENMASK(2, 0)
25 
26 #define BME680_REG_CTRL_MEAS			0x74
27 #define   BME680_OSRS_TEMP_MASK			GENMASK(7, 5)
28 #define   BME680_OSRS_PRESS_MASK		GENMASK(4, 2)
29 #define   BME680_MODE_MASK			GENMASK(1, 0)
30 #define     BME680_MODE_FORCED			1
31 #define     BME680_MODE_SLEEP			0
32 
33 #define BME680_REG_CONFIG			0x75
34 #define   BME680_FILTER_MASK			GENMASK(4, 2)
35 #define     BME680_FILTER_COEFF_VAL		BIT(1)
36 
37 /* TEMP/PRESS/HUMID reading skipped */
38 #define BME680_MEAS_SKIPPED			0x8000
39 
40 #define BME680_MAX_OVERFLOW_VAL			0x40000000
41 #define BME680_HUM_REG_SHIFT_VAL		4
42 #define BME680_BIT_H1_DATA_MASK			GENMASK(3, 0)
43 
44 #define   BME680_RHRANGE_MASK			GENMASK(5, 4)
45 #define BME680_REG_RES_HEAT_VAL			0x00
46 #define   BME680_RSERROR_MASK			GENMASK(7, 4)
47 #define BME680_REG_RES_HEAT_0			0x5A
48 #define BME680_REG_GAS_WAIT_0			0x64
49 #define BME680_ADC_GAS_RES			GENMASK(15, 6)
50 #define BME680_AMB_TEMP				25
51 
52 #define BME680_REG_CTRL_GAS_1			0x71
53 #define   BME680_RUN_GAS_MASK			BIT(4)
54 #define   BME680_NB_CONV_MASK			GENMASK(3, 0)
55 
56 #define BME680_REG_MEAS_STAT_0			0x1D
57 #define   BME680_NEW_DATA_BIT			BIT(7)
58 #define   BME680_GAS_MEAS_BIT			BIT(6)
59 #define   BME680_MEAS_BIT			BIT(5)
60 
61 #define BME680_TEMP_NUM_BYTES			3
62 #define BME680_PRESS_NUM_BYTES			3
63 #define BME680_HUMID_NUM_BYTES			2
64 #define BME680_GAS_NUM_BYTES			2
65 
66 #define BME680_MEAS_TRIM_MASK			GENMASK(24, 4)
67 
68 /* Datasheet Section 1.1, Table 1 */
69 #define BME680_STARTUP_TIME_US			2000
70 
71 /* Calibration Parameters */
72 #define BME680_T2_LSB_REG	0x8A
73 #define BME680_H2_MSB_REG	0xE1
74 #define BME680_GH3_REG		0xEE
75 
76 #define BME680_CALIB_RANGE_1_LEN               23
77 #define BME680_CALIB_RANGE_2_LEN               14
78 #define BME680_CALIB_RANGE_3_LEN               5
79 
80 extern const struct regmap_config bme680_regmap_config;
81 
82 int bme680_core_probe(struct device *dev, struct regmap *regmap,
83 		      const char *name);
84 
85 #endif  /* BME680_H_ */
86