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