1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* Sensirion SHT3x-DIS humidity and temperature sensor driver.
16 #include <linux/hwmon-sysfs.h>
45 /* delays for single-shot mode i2c commands, both in us */
56 #define SHT3X_MIN_TEMPERATURE  -45000
83 	/* 0.5 measurements per second */
85 	/* 1 measurements per second */
87 	/* 2 measurements per second */
89 	/* 4 measurements per second */
91 	/* 10 measurements per second */
97 	/* 0.5 measurements per second */
99 	/* 1 measurements per second */
101 	/* 2 measurements per second */
103 	/* 4 measurements per second */
105 	/* 10 measurements per second */
111 	/* 0.5 measurements per second */
113 	/* 1 measurements per second */
115 	/* 2 measurements per second */
117 	/* 4 measurements per second */
119 	/* 10 measurements per second */
198 	return number_of_modes - 1;  in get_mode_from_update_interval()
208 	mutex_lock(&data->i2c_lock);  in sht3x_read_from_command()
212 		ret = ret < 0 ? ret : -EIO;  in sht3x_read_from_command()
221 		ret = ret < 0 ? ret : -EIO;  in sht3x_read_from_command()
227 	mutex_unlock(&data->i2c_lock);  in sht3x_read_from_command()
235 	 * T = -45 + 175 * ST / 2^16  in sht3x_extract_temperature()
238 	return ((21875 * (int)raw) >> 13) - 45000;  in sht3x_extract_temperature()
251 static struct sht3x_data *sht3x_update_client(struct device *dev)  in sht3x_update_client()
254 	struct i2c_client *client = data->client;  in sht3x_update_client()
255 	u16 interval_ms = mode_to_update_interval[data->mode];  in sht3x_update_client()
261 	mutex_lock(&data->data_lock);  in sht3x_update_client()
263 	 * Only update cached readings once per update interval in periodic  in sht3x_update_client()
270 	if (time_after(jiffies, data->last_update + interval_jiffies)) {  in sht3x_update_client()
271 		ret = sht3x_read_from_command(client, data, data->command, buf,  in sht3x_update_client()
272 					      sizeof(buf), data->wait_time);  in sht3x_update_client()
277 		data->temperature = sht3x_extract_temperature(val);  in sht3x_update_client()
279 		data->humidity = sht3x_extract_humidity(val);  in sht3x_update_client()
280 		data->last_update = jiffies;  in sht3x_update_client()
284 	mutex_unlock(&data->data_lock);  in sht3x_update_client()
291 static int temp1_input_read(struct device *dev)  in temp1_input_read()
298 	return data->temperature;  in temp1_input_read()
301 static int humidity1_input_read(struct device *dev)  in humidity1_input_read()
308 	return data->humidity;  in humidity1_input_read()
323 	struct i2c_client *client = data->client;  in limits_update()
328 					      commands->read_command, buffer,  in limits_update()
337 		data->temperature_limits[index] = temperature;  in limits_update()
338 		data->humidity_limits[index] = humidity;  in limits_update()
344 static int temp1_limit_read(struct device *dev, int index)  in temp1_limit_read()
348 	return data->temperature_limits[index];  in temp1_limit_read()
351 static int humidity1_limit_read(struct device *dev, int index)  in humidity1_limit_read()
355 	return data->humidity_limits[index];  in humidity1_limit_read()
361 static size_t limit_write(struct device *dev,  in limit_write()
371 	struct i2c_client *client = data->client;  in limit_write()
376 	memcpy(position, commands->write_command, SHT3X_CMD_LENGTH);  in limit_write()
390 			 position - SHT3X_WORD_LEN,  in limit_write()
394 	mutex_lock(&data->i2c_lock);  in limit_write()
396 	mutex_unlock(&data->i2c_lock);  in limit_write()
399 		return ret < 0 ? ret : -EIO;  in limit_write()
401 	data->temperature_limits[index] = temperature;  in limit_write()
402 	data->humidity_limits[index] = humidity;  in limit_write()
407 static int temp1_limit_write(struct device *dev, int index, int val)  in temp1_limit_write()
415 	mutex_lock(&data->data_lock);  in temp1_limit_write()
417 			  data->humidity_limits[index]);  in temp1_limit_write()
418 	mutex_unlock(&data->data_lock);  in temp1_limit_write()
423 static int humidity1_limit_write(struct device *dev, int index, int val)  in humidity1_limit_write()
430 	mutex_lock(&data->data_lock);  in humidity1_limit_write()
431 	ret = limit_write(dev, index, data->temperature_limits[index],  in humidity1_limit_write()
433 	mutex_unlock(&data->data_lock);  in humidity1_limit_write()
441 	 * For single-shot mode, only non blocking mode is support,  in sht3x_select_command()
444 	if (data->mode > 0) {  in sht3x_select_command()
445 		data->command = sht3x_cmd_measure_periodic_mode;  in sht3x_select_command()
446 		data->wait_time = 0;  in sht3x_select_command()
448 		if (data->repeatability == high_repeatability) {  in sht3x_select_command()
449 			data->command = sht3x_cmd_measure_single_hpm;  in sht3x_select_command()
450 			data->wait_time = SHT3X_SINGLE_WAIT_TIME_HPM;  in sht3x_select_command()
451 		} else if (data->repeatability ==  medium_repeatability) {  in sht3x_select_command()
452 			data->command = sht3x_cmd_measure_single_mpm;  in sht3x_select_command()
453 			data->wait_time = SHT3X_SINGLE_WAIT_TIME_MPM;  in sht3x_select_command()
455 			data->command = sht3x_cmd_measure_single_lpm;  in sht3x_select_command()
456 			data->wait_time = SHT3X_SINGLE_WAIT_TIME_LPM;  in sht3x_select_command()
461 static int status_register_read(struct device *dev,  in status_register_read()
466 	struct i2c_client *client = data->client;  in status_register_read()
474 static int temp1_alarm_read(struct device *dev)  in temp1_alarm_read()
487 static int humidity1_alarm_read(struct device *dev)  in humidity1_alarm_read()
500 static ssize_t heater_enable_show(struct device *dev,  in heater_enable_show()
515 static ssize_t heater_enable_store(struct device *dev,  in heater_enable_store()
521 	struct i2c_client *client = data->client;  in heater_enable_store()
529 	mutex_lock(&data->i2c_lock);  in heater_enable_store()
538 	mutex_unlock(&data->i2c_lock);  in heater_enable_store()
543 static int update_interval_read(struct device *dev)  in update_interval_read()
547 	return mode_to_update_interval[data->mode];  in update_interval_read()
550 static int update_interval_write(struct device *dev, int val)  in update_interval_write()
556 	struct i2c_client *client = data->client;  in update_interval_write()
560 	mutex_lock(&data->data_lock);  in update_interval_write()
562 	if (mode == data->mode) {  in update_interval_write()
563 		mutex_unlock(&data->data_lock);  in update_interval_write()
567 	mutex_lock(&data->i2c_lock);  in update_interval_write()
574 	if (data->mode > 0) {  in update_interval_write()
579 		data->mode = 0;  in update_interval_write()
583 		if (data->repeatability == high_repeatability)  in update_interval_write()
584 			command = periodic_measure_commands_hpm[mode - 1];  in update_interval_write()
585 		else if (data->repeatability == medium_repeatability)  in update_interval_write()
586 			command = periodic_measure_commands_mpm[mode - 1];  in update_interval_write()
588 			command = periodic_measure_commands_lpm[mode - 1];  in update_interval_write()
597 	data->mode = mode;  in update_interval_write()
601 	mutex_unlock(&data->i2c_lock);  in update_interval_write()
602 	mutex_unlock(&data->data_lock);  in update_interval_write()
604 		return ret < 0 ? ret : -EIO;  in update_interval_write()
609 static ssize_t repeatability_show(struct device *dev,  in repeatability_show()
615 	return sysfs_emit(buf, "%d\n", data->repeatability);  in repeatability_show()
618 static ssize_t repeatability_store(struct device *dev,  in repeatability_store()
633 		return -EINVAL;  in repeatability_store()
635 	data->repeatability = val;  in repeatability_store()
680 		if (chip_data->chip_id == sts3x)  in sht3x_is_visible()
702 static int sht3x_read(struct device *dev, enum hwmon_sensor_types type,  in sht3x_read()
714 			return -EOPNOTSUPP;  in sht3x_read()
742 			return -EOPNOTSUPP;  in sht3x_read()
770 			return -EOPNOTSUPP;  in sht3x_read()
774 		return -EOPNOTSUPP;  in sht3x_read()
780 static int sht3x_write(struct device *dev, enum hwmon_sensor_types type,  in sht3x_write()
791 			return -EOPNOTSUPP;  in sht3x_write()
808 			return -EOPNOTSUPP;  in sht3x_write()
826 			return -EOPNOTSUPP;  in sht3x_write()
830 		return -EOPNOTSUPP;  in sht3x_write()
845 /* device ID table */
858 	struct device *hwmon_dev;  in sht3x_probe()
859 	struct i2c_adapter *adap = client->adapter;  in sht3x_probe()
860 	struct device *dev = &client->dev;  in sht3x_probe()
863 	 * we require full i2c support since the sht3x uses multi-byte read and  in sht3x_probe()
864 	 * writes as well as multi-byte commands which are not supported by  in sht3x_probe()
868 		return -ENODEV;  in sht3x_probe()
873 		return ret < 0 ? ret : -ENODEV;  in sht3x_probe()
877 		return -ENOMEM;  in sht3x_probe()
879 	data->repeatability = high_repeatability;  in sht3x_probe()
880 	data->mode = 0;  in sht3x_probe()
881 	data->last_update = jiffies - msecs_to_jiffies(3000);  in sht3x_probe()
882 	data->client = client;  in sht3x_probe()
883 	data->chip_id = i2c_match_id(sht3x_ids, client)->driver_data;  in sht3x_probe()
888 	mutex_init(&data->i2c_lock);  in sht3x_probe()
889 	mutex_init(&data->data_lock);  in sht3x_probe()
903 							 client->name,  in sht3x_probe()
909 		dev_dbg(dev, "unable to register hwmon device\n");  in sht3x_probe()