| /* Sensirion SHTC1 humidity and temperature sensor driver |
| * |
| * Copyright (C) 2014 Sensirion AG, Switzerland |
| * Author: Johannes Winkelmann <johannes.winkelmann@sensirion.com> |
| * |
| * This program is free software; you can redistribute it and/or modify |
| * it under the terms of the GNU General Public License as published by |
| * the Free Software Foundation; either version 2 of the License, or |
| * (at your option) any later version. |
| * |
| * This program is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU General Public License for more details. |
| * |
| */ |
| |
| #include <linux/module.h> |
| #include <linux/init.h> |
| #include <linux/slab.h> |
| #include <linux/i2c.h> |
| #include <linux/hwmon.h> |
| #include <linux/hwmon-sysfs.h> |
| #include <linux/err.h> |
| #include <linux/delay.h> |
| #include <linux/platform_data/shtc1.h> |
| |
| /* commands (high precision mode) */ |
| static const unsigned char shtc1_cmd_measure_blocking_hpm[] = { 0x7C, 0xA2 }; |
| static const unsigned char shtc1_cmd_measure_nonblocking_hpm[] = { 0x78, 0x66 }; |
| |
| /* commands (low precision mode) */ |
| static const unsigned char shtc1_cmd_measure_blocking_lpm[] = { 0x64, 0x58 }; |
| static const unsigned char shtc1_cmd_measure_nonblocking_lpm[] = { 0x60, 0x9c }; |
| |
| /* command for reading the ID register */ |
| static const unsigned char shtc1_cmd_read_id_reg[] = { 0xef, 0xc8 }; |
| |
| /* constants for reading the ID register */ |
| #define SHTC1_ID 0x07 |
| #define SHTC1_ID_REG_MASK 0x1f |
| |
| /* delays for non-blocking i2c commands, both in us */ |
| #define SHTC1_NONBLOCKING_WAIT_TIME_HPM 14400 |
| #define SHTC1_NONBLOCKING_WAIT_TIME_LPM 1000 |
| |
| #define SHTC1_CMD_LENGTH 2 |
| #define SHTC1_RESPONSE_LENGTH 6 |
| |
| struct shtc1_data { |
| struct i2c_client *client; |
| struct mutex update_lock; |
| bool valid; |
| unsigned long last_updated; /* in jiffies */ |
| |
| const unsigned char *command; |
| unsigned int nonblocking_wait_time; /* in us */ |
| |
| struct shtc1_platform_data setup; |
| |
| int temperature; /* 1000 * temperature in dgr C */ |
| int humidity; /* 1000 * relative humidity in %RH */ |
| }; |
| |
| static int shtc1_update_values(struct i2c_client *client, |
| struct shtc1_data *data, |
| char *buf, int bufsize) |
| { |
| int ret = i2c_master_send(client, data->command, SHTC1_CMD_LENGTH); |
| if (ret != SHTC1_CMD_LENGTH) { |
| dev_err(&client->dev, "failed to send command: %d\n", ret); |
| return ret < 0 ? ret : -EIO; |
| } |
| |
| /* |
| * In blocking mode (clock stretching mode) the I2C bus |
| * is blocked for other traffic, thus the call to i2c_master_recv() |
| * will wait until the data is ready. For non blocking mode, we |
| * have to wait ourselves. |
| */ |
| if (!data->setup.blocking_io) |
| usleep_range(data->nonblocking_wait_time, |
| data->nonblocking_wait_time + 1000); |
| |
| ret = i2c_master_recv(client, buf, bufsize); |
| if (ret != bufsize) { |
| dev_err(&client->dev, "failed to read values: %d\n", ret); |
| return ret < 0 ? ret : -EIO; |
| } |
| |
| return 0; |
| } |
| |
| /* sysfs attributes */ |
| static struct shtc1_data *shtc1_update_client(struct device *dev) |
| { |
| struct shtc1_data *data = dev_get_drvdata(dev); |
| struct i2c_client *client = data->client; |
| unsigned char buf[SHTC1_RESPONSE_LENGTH]; |
| int val; |
| int ret = 0; |
| |
| mutex_lock(&data->update_lock); |
| |
| if (time_after(jiffies, data->last_updated + HZ / 10) || !data->valid) { |
| ret = shtc1_update_values(client, data, buf, sizeof(buf)); |
| if (ret) |
| goto out; |
| |
| /* |
| * From datasheet: |
| * T = -45 + 175 * ST / 2^16 |
| * RH = 100 * SRH / 2^16 |
| * |
| * Adapted for integer fixed point (3 digit) arithmetic. |
| */ |
| val = be16_to_cpup((__be16 *)buf); |
| data->temperature = ((21875 * val) >> 13) - 45000; |
| val = be16_to_cpup((__be16 *)(buf + 3)); |
| data->humidity = ((12500 * val) >> 13); |
| |
| data->last_updated = jiffies; |
| data->valid = true; |
| } |
| |
| out: |
| mutex_unlock(&data->update_lock); |
| |
| return ret == 0 ? data : ERR_PTR(ret); |
| } |
| |
| static ssize_t temp1_input_show(struct device *dev, |
| struct device_attribute *attr, |
| char *buf) |
| { |
| struct shtc1_data *data = shtc1_update_client(dev); |
| if (IS_ERR(data)) |
| return PTR_ERR(data); |
| |
| return sprintf(buf, "%d\n", data->temperature); |
| } |
| |
| static ssize_t humidity1_input_show(struct device *dev, |
| struct device_attribute *attr, char *buf) |
| { |
| struct shtc1_data *data = shtc1_update_client(dev); |
| if (IS_ERR(data)) |
| return PTR_ERR(data); |
| |
| return sprintf(buf, "%d\n", data->humidity); |
| } |
| |
| static DEVICE_ATTR_RO(temp1_input); |
| static DEVICE_ATTR_RO(humidity1_input); |
| |
| static struct attribute *shtc1_attrs[] = { |
| &dev_attr_temp1_input.attr, |
| &dev_attr_humidity1_input.attr, |
| NULL |
| }; |
| |
| ATTRIBUTE_GROUPS(shtc1); |
| |
| static void shtc1_select_command(struct shtc1_data *data) |
| { |
| if (data->setup.high_precision) { |
| data->command = data->setup.blocking_io ? |
| shtc1_cmd_measure_blocking_hpm : |
| shtc1_cmd_measure_nonblocking_hpm; |
| data->nonblocking_wait_time = SHTC1_NONBLOCKING_WAIT_TIME_HPM; |
| |
| } else { |
| data->command = data->setup.blocking_io ? |
| shtc1_cmd_measure_blocking_lpm : |
| shtc1_cmd_measure_nonblocking_lpm; |
| data->nonblocking_wait_time = SHTC1_NONBLOCKING_WAIT_TIME_LPM; |
| } |
| } |
| |
| static int shtc1_probe(struct i2c_client *client, |
| const struct i2c_device_id *id) |
| { |
| int ret; |
| char id_reg[2]; |
| struct shtc1_data *data; |
| struct device *hwmon_dev; |
| struct i2c_adapter *adap = client->adapter; |
| struct device *dev = &client->dev; |
| |
| if (!i2c_check_functionality(adap, I2C_FUNC_I2C)) { |
| dev_err(dev, "plain i2c transactions not supported\n"); |
| return -ENODEV; |
| } |
| |
| ret = i2c_master_send(client, shtc1_cmd_read_id_reg, SHTC1_CMD_LENGTH); |
| if (ret != SHTC1_CMD_LENGTH) { |
| dev_err(dev, "could not send read_id_reg command: %d\n", ret); |
| return ret < 0 ? ret : -ENODEV; |
| } |
| ret = i2c_master_recv(client, id_reg, sizeof(id_reg)); |
| if (ret != sizeof(id_reg)) { |
| dev_err(dev, "could not read ID register: %d\n", ret); |
| return -ENODEV; |
| } |
| if ((id_reg[1] & SHTC1_ID_REG_MASK) != SHTC1_ID) { |
| dev_err(dev, "ID register doesn't match\n"); |
| return -ENODEV; |
| } |
| |
| data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL); |
| if (!data) |
| return -ENOMEM; |
| |
| data->setup.blocking_io = false; |
| data->setup.high_precision = true; |
| data->client = client; |
| |
| if (client->dev.platform_data) |
| data->setup = *(struct shtc1_platform_data *)dev->platform_data; |
| shtc1_select_command(data); |
| mutex_init(&data->update_lock); |
| |
| hwmon_dev = devm_hwmon_device_register_with_groups(dev, |
| client->name, |
| data, |
| shtc1_groups); |
| if (IS_ERR(hwmon_dev)) |
| dev_dbg(dev, "unable to register hwmon device\n"); |
| |
| return PTR_ERR_OR_ZERO(hwmon_dev); |
| } |
| |
| /* device ID table */ |
| static const struct i2c_device_id shtc1_id[] = { |
| { "shtc1", 0 }, |
| { "shtw1", 0 }, |
| { } |
| }; |
| MODULE_DEVICE_TABLE(i2c, shtc1_id); |
| |
| static struct i2c_driver shtc1_i2c_driver = { |
| .driver.name = "shtc1", |
| .probe = shtc1_probe, |
| .id_table = shtc1_id, |
| }; |
| |
| module_i2c_driver(shtc1_i2c_driver); |
| |
| MODULE_AUTHOR("Johannes Winkelmann <johannes.winkelmann@sensirion.com>"); |
| MODULE_DESCRIPTION("Sensirion SHTC1 humidity and temperature sensor driver"); |
| MODULE_LICENSE("GPL"); |