xref: /linux/drivers/iio/light/veml6070.c (revision 7f15c46a57c31956591f85b713d7e63cccb25556)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * veml6070.c - Support for Vishay VEML6070 UV A light sensor
4  *
5  * Copyright 2016 Peter Meerwald-Stadler <pmeerw@pmeerw.net>
6  *
7  * IIO driver for VEML6070 (7-bit I2C slave addresses 0x38 and 0x39)
8  *
9  * TODO: integration time, ACK signal
10  */
11 
12 #include <linux/module.h>
13 #include <linux/i2c.h>
14 #include <linux/mutex.h>
15 #include <linux/err.h>
16 #include <linux/delay.h>
17 
18 #include <linux/iio/iio.h>
19 #include <linux/iio/sysfs.h>
20 
21 #define VEML6070_DRV_NAME "veml6070"
22 
23 #define VEML6070_ADDR_CONFIG_DATA_MSB 0x38 /* read: MSB data, write: config */
24 #define VEML6070_ADDR_DATA_LSB	0x39 /* LSB data */
25 
26 #define VEML6070_COMMAND_ACK	BIT(5) /* raise interrupt when over threshold */
27 #define VEML6070_COMMAND_IT	GENMASK(3, 2) /* bit mask integration time */
28 #define VEML6070_COMMAND_RSRVD	BIT(1) /* reserved, set to 1 */
29 #define VEML6070_COMMAND_SD	BIT(0) /* shutdown mode when set */
30 
31 #define VEML6070_IT_10	0x04 /* integration time 1x */
32 
33 struct veml6070_data {
34 	struct i2c_client *client1;
35 	struct i2c_client *client2;
36 	u8 config;
37 	struct mutex lock;
38 };
39 
40 static int veml6070_read(struct veml6070_data *data)
41 {
42 	int ret;
43 	u8 msb, lsb;
44 
45 	guard(mutex)(&data->lock);
46 
47 	/* disable shutdown */
48 	ret = i2c_smbus_write_byte(data->client1,
49 	    data->config & ~VEML6070_COMMAND_SD);
50 	if (ret < 0)
51 		return ret;
52 
53 	msleep(125 + 10); /* measurement takes up to 125 ms for IT 1x */
54 
55 	ret = i2c_smbus_read_byte(data->client2); /* read MSB, address 0x39 */
56 	if (ret < 0)
57 		return ret;
58 
59 	msb = ret;
60 
61 	ret = i2c_smbus_read_byte(data->client1); /* read LSB, address 0x38 */
62 	if (ret < 0)
63 		return ret;
64 
65 	lsb = ret;
66 
67 	/* shutdown again */
68 	ret = i2c_smbus_write_byte(data->client1, data->config);
69 	if (ret < 0)
70 		return ret;
71 
72 	ret = (msb << 8) | lsb;
73 
74 	return 0;
75 }
76 
77 static const struct iio_chan_spec veml6070_channels[] = {
78 	{
79 		.type = IIO_INTENSITY,
80 		.modified = 1,
81 		.channel2 = IIO_MOD_LIGHT_UV,
82 		.info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
83 	},
84 	{
85 		.type = IIO_UVINDEX,
86 		.info_mask_separate = BIT(IIO_CHAN_INFO_PROCESSED),
87 	}
88 };
89 
90 static int veml6070_to_uv_index(unsigned val)
91 {
92 	/*
93 	 * conversion of raw UV intensity values to UV index depends on
94 	 * integration time (IT) and value of the resistor connected to
95 	 * the RSET pin (default: 270 KOhm)
96 	 */
97 	unsigned uvi[11] = {
98 		187, 373, 560, /* low */
99 		746, 933, 1120, /* moderate */
100 		1308, 1494, /* high */
101 		1681, 1868, 2054}; /* very high */
102 	int i;
103 
104 	for (i = 0; i < ARRAY_SIZE(uvi); i++)
105 		if (val <= uvi[i])
106 			return i;
107 
108 	return 11; /* extreme */
109 }
110 
111 static int veml6070_read_raw(struct iio_dev *indio_dev,
112 				struct iio_chan_spec const *chan,
113 				int *val, int *val2, long mask)
114 {
115 	struct veml6070_data *data = iio_priv(indio_dev);
116 	int ret;
117 
118 	switch (mask) {
119 	case IIO_CHAN_INFO_RAW:
120 	case IIO_CHAN_INFO_PROCESSED:
121 		ret = veml6070_read(data);
122 		if (ret < 0)
123 			return ret;
124 		if (mask == IIO_CHAN_INFO_PROCESSED)
125 			*val = veml6070_to_uv_index(ret);
126 		else
127 			*val = ret;
128 		return IIO_VAL_INT;
129 	default:
130 		return -EINVAL;
131 	}
132 }
133 
134 static const struct iio_info veml6070_info = {
135 	.read_raw = veml6070_read_raw,
136 };
137 
138 static void veml6070_i2c_unreg(void *p)
139 {
140 	struct veml6070_data *data = p;
141 
142 	i2c_unregister_device(data->client2);
143 }
144 
145 static int veml6070_probe(struct i2c_client *client)
146 {
147 	struct veml6070_data *data;
148 	struct iio_dev *indio_dev;
149 	int ret;
150 
151 	indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
152 	if (!indio_dev)
153 		return -ENOMEM;
154 
155 	data = iio_priv(indio_dev);
156 	i2c_set_clientdata(client, indio_dev);
157 	data->client1 = client;
158 	mutex_init(&data->lock);
159 
160 	indio_dev->info = &veml6070_info;
161 	indio_dev->channels = veml6070_channels;
162 	indio_dev->num_channels = ARRAY_SIZE(veml6070_channels);
163 	indio_dev->name = VEML6070_DRV_NAME;
164 	indio_dev->modes = INDIO_DIRECT_MODE;
165 
166 	ret = devm_regulator_get_enable(&client->dev, "vdd");
167 	if (ret < 0)
168 		return ret;
169 
170 	data->client2 = i2c_new_dummy_device(client->adapter, VEML6070_ADDR_DATA_LSB);
171 	if (IS_ERR(data->client2))
172 		return dev_err_probe(&client->dev, PTR_ERR(data->client2),
173 				     "i2c device for second chip address failed\n");
174 
175 	data->config = VEML6070_IT_10 | VEML6070_COMMAND_RSRVD |
176 		VEML6070_COMMAND_SD;
177 	ret = i2c_smbus_write_byte(data->client1, data->config);
178 	if (ret < 0)
179 		return ret;
180 
181 	ret = devm_add_action_or_reset(&client->dev, veml6070_i2c_unreg, data);
182 	if (ret < 0)
183 		return ret;
184 
185 	return devm_iio_device_register(&client->dev, indio_dev);
186 }
187 
188 static const struct i2c_device_id veml6070_id[] = {
189 	{ "veml6070" },
190 	{ }
191 };
192 MODULE_DEVICE_TABLE(i2c, veml6070_id);
193 
194 static const struct of_device_id veml6070_of_match[] = {
195 	{ .compatible = "vishay,veml6070" },
196 	{ }
197 };
198 MODULE_DEVICE_TABLE(of, veml6070_of_match);
199 
200 static struct i2c_driver veml6070_driver = {
201 	.driver = {
202 		.name   = VEML6070_DRV_NAME,
203 		.of_match_table = veml6070_of_match,
204 	},
205 	.probe = veml6070_probe,
206 	.id_table = veml6070_id,
207 };
208 
209 module_i2c_driver(veml6070_driver);
210 
211 MODULE_AUTHOR("Peter Meerwald-Stadler <pmeerw@pmeerw.net>");
212 MODULE_DESCRIPTION("Vishay VEML6070 UV A light sensor driver");
213 MODULE_LICENSE("GPL");
214