1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* Sensirion SHT3x-DIS humidity and temperature sensor driver.
17 #include <linux/hwmon-sysfs.h>
47 /* delays for single-shot mode i2c commands, both in us */
58 #define SHT3X_MIN_TEMPERATURE  -45000
201 	return number_of_modes - 1;  in get_mode_from_update_interval()
211 	mutex_lock(&data->i2c_lock);  in sht3x_read_from_command()
215 		ret = ret < 0 ? ret : -EIO;  in sht3x_read_from_command()
224 		ret = ret < 0 ? ret : -EIO;  in sht3x_read_from_command()
230 	mutex_unlock(&data->i2c_lock);  in sht3x_read_from_command()
238 	 * T = -45 + 175 * ST / 2^16  in sht3x_extract_temperature()
241 	return ((21875 * (int)raw) >> 13) - 45000;  in sht3x_extract_temperature()
257 	struct i2c_client *client = data->client;  in sht3x_update_client()
258 	u16 interval_ms = mode_to_update_interval[data->mode];  in sht3x_update_client()
264 	mutex_lock(&data->data_lock);  in sht3x_update_client()
267 	 * mode. In single shot mode the sensor measures values on demand, so  in sht3x_update_client()
273 	if (time_after(jiffies, data->last_update + interval_jiffies)) {  in sht3x_update_client()
274 		ret = sht3x_read_from_command(client, data, data->command, buf,  in sht3x_update_client()
275 					      sizeof(buf), data->wait_time);  in sht3x_update_client()
280 		data->temperature = sht3x_extract_temperature(val);  in sht3x_update_client()
282 		data->humidity = sht3x_extract_humidity(val);  in sht3x_update_client()
283 		data->last_update = jiffies;  in sht3x_update_client()
287 	mutex_unlock(&data->data_lock);  in sht3x_update_client()
301 	*temp = data->temperature;  in temp1_input_read()
312 	*humidity = data->humidity;  in humidity1_input_read()
328 	struct i2c_client *client = data->client;  in limits_update()
333 					      commands->read_command, buffer,  in limits_update()
342 		data->temperature_limits[index] = temperature;  in limits_update()
343 		data->humidity_limits[index] = humidity;  in limits_update()
353 	return data->temperature_limits[index];  in temp1_limit_read()
360 	return data->humidity_limits[index];  in humidity1_limit_read()
376 	struct i2c_client *client = data->client;  in limit_write()
381 	memcpy(position, commands->write_command, SHT3X_CMD_LENGTH);  in limit_write()
395 			 position - SHT3X_WORD_LEN,  in limit_write()
399 	mutex_lock(&data->i2c_lock);  in limit_write()
401 	mutex_unlock(&data->i2c_lock);  in limit_write()
404 		return ret < 0 ? ret : -EIO;  in limit_write()
406 	data->temperature_limits[index] = temperature;  in limit_write()
407 	data->humidity_limits[index] = humidity;  in limit_write()
420 	mutex_lock(&data->data_lock);  in temp1_limit_write()
422 			  data->humidity_limits[index]);  in temp1_limit_write()
423 	mutex_unlock(&data->data_lock);  in temp1_limit_write()
435 	mutex_lock(&data->data_lock);  in humidity1_limit_write()
436 	ret = limit_write(dev, index, data->temperature_limits[index],  in humidity1_limit_write()
438 	mutex_unlock(&data->data_lock);  in humidity1_limit_write()
446 	 * For single-shot mode, only non blocking mode is support,  in sht3x_select_command()
449 	if (data->mode > 0) {  in sht3x_select_command()
450 		data->command = sht3x_cmd_measure_periodic_mode;  in sht3x_select_command()
451 		data->wait_time = 0;  in sht3x_select_command()
453 		if (data->repeatability == high_repeatability) {  in sht3x_select_command()
454 			data->command = sht3x_cmd_measure_single_hpm;  in sht3x_select_command()
455 			data->wait_time = SHT3X_SINGLE_WAIT_TIME_HPM;  in sht3x_select_command()
456 		} else if (data->repeatability ==  medium_repeatability) {  in sht3x_select_command()
457 			data->command = sht3x_cmd_measure_single_mpm;  in sht3x_select_command()
458 			data->wait_time = SHT3X_SINGLE_WAIT_TIME_MPM;  in sht3x_select_command()
460 			data->command = sht3x_cmd_measure_single_lpm;  in sht3x_select_command()
461 			data->wait_time = SHT3X_SINGLE_WAIT_TIME_LPM;  in sht3x_select_command()
471 	struct i2c_client *client = data->client;  in status_register_read()
526 	struct i2c_client *client = data->client;  in heater_enable_store()
534 	mutex_lock(&data->i2c_lock);  in heater_enable_store()
543 	mutex_unlock(&data->i2c_lock);  in heater_enable_store()
552 	return mode_to_update_interval[data->mode];  in update_interval_read()
561 	struct i2c_client *client = data->client;  in update_interval_write()
565 	mutex_lock(&data->data_lock);  in update_interval_write()
567 	if (mode == data->mode) {  in update_interval_write()
568 		mutex_unlock(&data->data_lock);  in update_interval_write()
572 	mutex_lock(&data->i2c_lock);  in update_interval_write()
577 	 * to single shot (mode = 0).  in update_interval_write()
579 	if (data->mode > 0) {  in update_interval_write()
584 		data->mode = 0;  in update_interval_write()
588 		if (data->repeatability == high_repeatability)  in update_interval_write()
589 			command = periodic_measure_commands_hpm[mode - 1];  in update_interval_write()
590 		else if (data->repeatability == medium_repeatability)  in update_interval_write()
591 			command = periodic_measure_commands_mpm[mode - 1];  in update_interval_write()
593 			command = periodic_measure_commands_lpm[mode - 1];  in update_interval_write()
602 	data->mode = mode;  in update_interval_write()
606 	mutex_unlock(&data->i2c_lock);  in update_interval_write()
607 	mutex_unlock(&data->data_lock);  in update_interval_write()
609 		return ret < 0 ? ret : -EIO;  in update_interval_write()
620 	return sysfs_emit(buf, "%d\n", data->repeatability);  in repeatability_show()
638 		return -EINVAL;  in repeatability_store()
640 	data->repeatability = val;  in repeatability_store()
685 		if (chip_data->chip_id == sts3x)  in sht3x_is_visible()
720 			return -EOPNOTSUPP;  in sht3x_read()
750 			return -EOPNOTSUPP;  in sht3x_read()
780 			return -EOPNOTSUPP;  in sht3x_read()
784 		return -EOPNOTSUPP;  in sht3x_read()
801 			return -EOPNOTSUPP;  in sht3x_write()
818 			return -EOPNOTSUPP;  in sht3x_write()
836 			return -EOPNOTSUPP;  in sht3x_write()
840 		return -EOPNOTSUPP;  in sht3x_write()
848 	struct i2c_client *client = data->client;  in sht3x_serial_number_read()
857 	data->serial_number = (buffer[0] << 24) | (buffer[1] << 16) |  in sht3x_serial_number_read()
860 	debugfs_create_u32("serial_number", 0444, client->debugfs, &data->serial_number);  in sht3x_serial_number_read()
879 	struct i2c_adapter *adap = client->adapter;  in sht3x_probe()
880 	struct device *dev = &client->dev;  in sht3x_probe()
883 	 * we require full i2c support since the sht3x uses multi-byte read and  in sht3x_probe()
884 	 * writes as well as multi-byte commands which are not supported by  in sht3x_probe()
888 		return -ENODEV;  in sht3x_probe()
893 		return ret < 0 ? ret : -ENODEV;  in sht3x_probe()
897 		return -ENOMEM;  in sht3x_probe()
899 	data->repeatability = high_repeatability;  in sht3x_probe()
900 	data->mode = 0;  in sht3x_probe()
901 	data->last_update = jiffies - msecs_to_jiffies(3000);  in sht3x_probe()
902 	data->client = client;  in sht3x_probe()
903 	data->chip_id = (uintptr_t)i2c_get_match_data(client);  in sht3x_probe()
908 	mutex_init(&data->i2c_lock);  in sht3x_probe()
909 	mutex_init(&data->data_lock);  in sht3x_probe()
922 	hwmon_dev = devm_hwmon_device_register_with_info(dev, client->name, data,  in sht3x_probe()