Adds driver for digital Honeywell TruStability HSC and SSC series
pressure and temperature sensors.
Communication is one way. The sensor only requires 4 bytes worth of
clock pulses on both i2c and spi in order to push the data out.
The i2c address is hardcoded and depends on the part number.
There is no additional GPIO control.
Datasheet:
https://prod-edam.honeywell.com/content/dam/honeywell-edam/sps/siot/en-us/products/sensors/pressure-sensors/board-mount-pressure-sensors/trustability-hsc-series/documents/sps-siot-trustability-hsc-series-high-accuracy-board-mount-pressure-sensors-50099148-a-en-ciid-151133.pdf [HSC]
Datasheet:
https://prod-edam.honeywell.com/content/dam/honeywell-edam/sps/siot/en-us/products/sensors/pressure-sensors/board-mount-pressure-sensors/trustability-ssc-series/documents/sps-siot-trustability-ssc-series-standard-accuracy-board-mount-pressure-sensors-50099533-a-en-ciid-151134.pdf [SSC]
Signed-off-by: Petre Rodan <[email protected]>
---
V2: - No change
V3: huge cleanup based on Andy's review. Thanks!
- fixed pressure offset calculation for differential sensors
- rename driver from honeywell,hsc to honeywell,hsc030pa
- main probe() now uses strncmp for case-insensitive mathing
can't use match_string() because I ain't planning on splitting the
hsc_range_config struct.
V4: modifications based on Jonathan Cameron's review. Thanks!
- rename hsc_*_xfer() to hsc_*_recv()
- struct style changes
- bus driver only contains bus specific bits and bobs
- add alignment for SPI buffer
V5: modifications based on Andy's review
- fix indentation
- use function pointer typedef instead of explicit declaration
---
MAINTAINERS | 7 +
drivers/iio/pressure/Kconfig | 22 ++
drivers/iio/pressure/Makefile | 3 +
drivers/iio/pressure/hsc030pa.c | 426 ++++++++++++++++++++++++++++
drivers/iio/pressure/hsc030pa.h | 83 ++++++
drivers/iio/pressure/hsc030pa_i2c.c | 71 +++++
drivers/iio/pressure/hsc030pa_spi.c | 62 ++++
7 files changed, 674 insertions(+)
create mode 100644 drivers/iio/pressure/hsc030pa.c
create mode 100644 drivers/iio/pressure/hsc030pa.h
create mode 100644 drivers/iio/pressure/hsc030pa_i2c.c
create mode 100644 drivers/iio/pressure/hsc030pa_spi.c
diff --git a/MAINTAINERS b/MAINTAINERS
index 012df8ccf34e..6f993ee69d1b 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -9702,6 +9702,13 @@ F: lib/test_hmm*
F: mm/hmm*
F: tools/testing/selftests/mm/*hmm*
+HONEYWELL HSC030PA PRESSURE SENSOR SERIES IIO DRIVER
+M: Petre Rodan <[email protected]>
+L: [email protected]
+S: Maintained
+F: Documentation/devicetree/bindings/iio/pressure/honeywell,hsc030pa.yaml
+F: drivers/iio/pressure/hsc030pa*
+
HONEYWELL MPRLS0025PA PRESSURE SENSOR SERIES IIO DRIVER
M: Andreas Klinger <[email protected]>
L: [email protected]
diff --git a/drivers/iio/pressure/Kconfig b/drivers/iio/pressure/Kconfig
index 95efa32e4289..79adfd059c3a 100644
--- a/drivers/iio/pressure/Kconfig
+++ b/drivers/iio/pressure/Kconfig
@@ -109,6 +109,28 @@ config HP03
To compile this driver as a module, choose M here: the module
will be called hp03.
+config HSC030PA
+ tristate "Honeywell HSC/SSC TruStability pressure sensor series"
+ depends on (I2C || SPI_MASTER)
+ select HSC030PA_I2C if I2C
+ select HSC030PA_SPI if SPI_MASTER
+ help
+ Say Y here to build support for the Honeywell TruStability
+ HSC and SSC pressure and temperature sensor series.
+
+ To compile this driver as a module, choose M here: the module
+ will be called hsc030pa.
+
+config HSC030PA_I2C
+ tristate
+ depends on HSC030PA
+ depends on I2C
+
+config HSC030PA_SPI
+ tristate
+ depends on HSC030PA
+ depends on SPI_MASTER
+
config ICP10100
tristate "InvenSense ICP-101xx pressure and temperature sensor"
depends on I2C
diff --git a/drivers/iio/pressure/Makefile b/drivers/iio/pressure/Makefile
index 436aec7e65f3..b0f8b94662f2 100644
--- a/drivers/iio/pressure/Makefile
+++ b/drivers/iio/pressure/Makefile
@@ -15,6 +15,9 @@ obj-$(CONFIG_DPS310) += dps310.o
obj-$(CONFIG_IIO_CROS_EC_BARO) += cros_ec_baro.o
obj-$(CONFIG_HID_SENSOR_PRESS) += hid-sensor-press.o
obj-$(CONFIG_HP03) += hp03.o
+obj-$(CONFIG_HSC030PA) += hsc030pa.o
+obj-$(CONFIG_HSC030PA_I2C) += hsc030pa_i2c.o
+obj-$(CONFIG_HSC030PA_SPI) += hsc030pa_spi.o
obj-$(CONFIG_ICP10100) += icp10100.o
obj-$(CONFIG_MPL115) += mpl115.o
obj-$(CONFIG_MPL115_I2C) += mpl115_i2c.o
diff --git a/drivers/iio/pressure/hsc030pa.c b/drivers/iio/pressure/hsc030pa.c
new file mode 100644
index 000000000000..c3e30768a0d4
--- /dev/null
+++ b/drivers/iio/pressure/hsc030pa.c
@@ -0,0 +1,426 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Honeywell TruStability HSC Series pressure/temperature sensor
+ *
+ * Copyright (c) 2023 Petre Rodan <[email protected]>
+ *
+ * Datasheet: https://prod-edam.honeywell.com/content/dam/honeywell-edam/sps/siot/en-us/products/sensors/pressure-sensors/board-mount-pressure-sensors/trustability-hsc-series/documents/sps-siot-trustability-hsc-series-high-accuracy-board-mount-pressure-sensors-50099148-a-en-ciid-151133.pdf
+ */
+
+#include <linux/array_size.h>
+#include <linux/bitfield.h>
+#include <linux/bits.h>
+#include <linux/cleanup.h>
+#include <linux/init.h>
+#include <linux/math64.h>
+#include <linux/mod_devicetable.h>
+#include <linux/module.h>
+#include <linux/printk.h>
+#include <linux/regulator/consumer.h>
+#include <linux/string.h>
+#include <linux/types.h>
+#include <linux/units.h>
+
+#include <linux/iio/iio.h>
+#include <linux/iio/sysfs.h>
+
+#include <asm/unaligned.h>
+
+#include "hsc030pa.h"
+
+/*
+ * HSC_PRESSURE_TRIPLET_LEN - length for the string that defines the
+ * pressure range, measurement unit and type as per the part nomenclature.
+ * Consult honeywell,pressure-triplet in the bindings file for details.
+ */
+#define HSC_PRESSURE_TRIPLET_LEN 6
+#define HSC_STATUS_MASK GENMASK(7, 6)
+#define HSC_TEMPERATURE_MASK GENMASK(15, 5)
+#define HSC_PRESSURE_MASK GENMASK(29, 16)
+
+struct hsc_func_spec {
+ u32 output_min;
+ u32 output_max;
+};
+
+/*
+ * function A: 10% - 90% of 2^14
+ * function B: 5% - 95% of 2^14
+ * function C: 5% - 85% of 2^14
+ * function F: 4% - 94% of 2^14
+ */
+static const struct hsc_func_spec hsc_func_spec[] = {
+ [HSC_FUNCTION_A] = { .output_min = 1638, .output_max = 14746 },
+ [HSC_FUNCTION_B] = { .output_min = 819, .output_max = 15565 },
+ [HSC_FUNCTION_C] = { .output_min = 819, .output_max = 13926 },
+ [HSC_FUNCTION_F] = { .output_min = 655, .output_max = 15401 },
+};
+
+/**
+ * struct hsc_range_config - list of pressure ranges based on nomenclature
+ * @triplet: string that defines the range, measurement unit and type
+ * @pmin: lowest pressure that can be measured
+ * @pmax: highest pressure that can be measured
+ */
+struct hsc_range_config {
+ char triplet[HSC_PRESSURE_TRIPLET_LEN];
+ s32 pmin;
+ u32 pmax;
+};
+
+/* all min max limits have been converted to pascals */
+static const struct hsc_range_config hsc_range_config[] = {
+ { .triplet = "001BA", .pmin = 0, .pmax = 100000 },
+ { .triplet = "1.6BA", .pmin = 0, .pmax = 160000 },
+ { .triplet = "2.5BA", .pmin = 0, .pmax = 250000 },
+ { .triplet = "004BA", .pmin = 0, .pmax = 400000 },
+ { .triplet = "006BA", .pmin = 0, .pmax = 600000 },
+ { .triplet = "010BA", .pmin = 0, .pmax = 1000000 },
+ { .triplet = "1.6MD", .pmin = -160, .pmax = 160 },
+ { .triplet = "2.5MD", .pmin = -250, .pmax = 250 },
+ { .triplet = "004MD", .pmin = -400, .pmax = 400 },
+ { .triplet = "006MD", .pmin = -600, .pmax = 600 },
+ { .triplet = "010MD", .pmin = -1000, .pmax = 1000 },
+ { .triplet = "016MD", .pmin = -1600, .pmax = 1600 },
+ { .triplet = "025MD", .pmin = -2500, .pmax = 2500 },
+ { .triplet = "040MD", .pmin = -4000, .pmax = 4000 },
+ { .triplet = "060MD", .pmin = -6000, .pmax = 6000 },
+ { .triplet = "100MD", .pmin = -10000, .pmax = 10000 },
+ { .triplet = "160MD", .pmin = -16000, .pmax = 16000 },
+ { .triplet = "250MD", .pmin = -25000, .pmax = 25000 },
+ { .triplet = "400MD", .pmin = -40000, .pmax = 40000 },
+ { .triplet = "600MD", .pmin = -60000, .pmax = 60000 },
+ { .triplet = "001BD", .pmin = -100000, .pmax = 100000 },
+ { .triplet = "1.6BD", .pmin = -160000, .pmax = 160000 },
+ { .triplet = "2.5BD", .pmin = -250000, .pmax = 250000 },
+ { .triplet = "004BD", .pmin = -400000, .pmax = 400000 },
+ { .triplet = "2.5MG", .pmin = 0, .pmax = 250 },
+ { .triplet = "004MG", .pmin = 0, .pmax = 400 },
+ { .triplet = "006MG", .pmin = 0, .pmax = 600 },
+ { .triplet = "010MG", .pmin = 0, .pmax = 1000 },
+ { .triplet = "016MG", .pmin = 0, .pmax = 1600 },
+ { .triplet = "025MG", .pmin = 0, .pmax = 2500 },
+ { .triplet = "040MG", .pmin = 0, .pmax = 4000 },
+ { .triplet = "060MG", .pmin = 0, .pmax = 6000 },
+ { .triplet = "100MG", .pmin = 0, .pmax = 10000 },
+ { .triplet = "160MG", .pmin = 0, .pmax = 16000 },
+ { .triplet = "250MG", .pmin = 0, .pmax = 25000 },
+ { .triplet = "400MG", .pmin = 0, .pmax = 40000 },
+ { .triplet = "600MG", .pmin = 0, .pmax = 60000 },
+ { .triplet = "001BG", .pmin = 0, .pmax = 100000 },
+ { .triplet = "1.6BG", .pmin = 0, .pmax = 160000 },
+ { .triplet = "2.5BG", .pmin = 0, .pmax = 250000 },
+ { .triplet = "004BG", .pmin = 0, .pmax = 400000 },
+ { .triplet = "006BG", .pmin = 0, .pmax = 600000 },
+ { .triplet = "010BG", .pmin = 0, .pmax = 1000000 },
+ { .triplet = "100KA", .pmin = 0, .pmax = 100000 },
+ { .triplet = "160KA", .pmin = 0, .pmax = 160000 },
+ { .triplet = "250KA", .pmin = 0, .pmax = 250000 },
+ { .triplet = "400KA", .pmin = 0, .pmax = 400000 },
+ { .triplet = "600KA", .pmin = 0, .pmax = 600000 },
+ { .triplet = "001GA", .pmin = 0, .pmax = 1000000 },
+ { .triplet = "160LD", .pmin = -160, .pmax = 160 },
+ { .triplet = "250LD", .pmin = -250, .pmax = 250 },
+ { .triplet = "400LD", .pmin = -400, .pmax = 400 },
+ { .triplet = "600LD", .pmin = -600, .pmax = 600 },
+ { .triplet = "001KD", .pmin = -1000, .pmax = 1000 },
+ { .triplet = "1.6KD", .pmin = -1600, .pmax = 1600 },
+ { .triplet = "2.5KD", .pmin = -2500, .pmax = 2500 },
+ { .triplet = "004KD", .pmin = -4000, .pmax = 4000 },
+ { .triplet = "006KD", .pmin = -6000, .pmax = 6000 },
+ { .triplet = "010KD", .pmin = -10000, .pmax = 10000 },
+ { .triplet = "016KD", .pmin = -16000, .pmax = 16000 },
+ { .triplet = "025KD", .pmin = -25000, .pmax = 25000 },
+ { .triplet = "040KD", .pmin = -40000, .pmax = 40000 },
+ { .triplet = "060KD", .pmin = -60000, .pmax = 60000 },
+ { .triplet = "100KD", .pmin = -100000, .pmax = 100000 },
+ { .triplet = "160KD", .pmin = -160000, .pmax = 160000 },
+ { .triplet = "250KD", .pmin = -250000, .pmax = 250000 },
+ { .triplet = "400KD", .pmin = -400000, .pmax = 400000 },
+ { .triplet = "250LG", .pmin = 0, .pmax = 250 },
+ { .triplet = "400LG", .pmin = 0, .pmax = 400 },
+ { .triplet = "600LG", .pmin = 0, .pmax = 600 },
+ { .triplet = "001KG", .pmin = 0, .pmax = 1000 },
+ { .triplet = "1.6KG", .pmin = 0, .pmax = 1600 },
+ { .triplet = "2.5KG", .pmin = 0, .pmax = 2500 },
+ { .triplet = "004KG", .pmin = 0, .pmax = 4000 },
+ { .triplet = "006KG", .pmin = 0, .pmax = 6000 },
+ { .triplet = "010KG", .pmin = 0, .pmax = 10000 },
+ { .triplet = "016KG", .pmin = 0, .pmax = 16000 },
+ { .triplet = "025KG", .pmin = 0, .pmax = 25000 },
+ { .triplet = "040KG", .pmin = 0, .pmax = 40000 },
+ { .triplet = "060KG", .pmin = 0, .pmax = 60000 },
+ { .triplet = "100KG", .pmin = 0, .pmax = 100000 },
+ { .triplet = "160KG", .pmin = 0, .pmax = 160000 },
+ { .triplet = "250KG", .pmin = 0, .pmax = 250000 },
+ { .triplet = "400KG", .pmin = 0, .pmax = 400000 },
+ { .triplet = "600KG", .pmin = 0, .pmax = 600000 },
+ { .triplet = "001GG", .pmin = 0, .pmax = 1000000 },
+ { .triplet = "015PA", .pmin = 0, .pmax = 103421 },
+ { .triplet = "030PA", .pmin = 0, .pmax = 206843 },
+ { .triplet = "060PA", .pmin = 0, .pmax = 413685 },
+ { .triplet = "100PA", .pmin = 0, .pmax = 689476 },
+ { .triplet = "150PA", .pmin = 0, .pmax = 1034214 },
+ { .triplet = "0.5ND", .pmin = -125, .pmax = 125 },
+ { .triplet = "001ND", .pmin = -249, .pmax = 249 },
+ { .triplet = "002ND", .pmin = -498, .pmax = 498 },
+ { .triplet = "004ND", .pmin = -996, .pmax = 996 },
+ { .triplet = "005ND", .pmin = -1245, .pmax = 1245 },
+ { .triplet = "010ND", .pmin = -2491, .pmax = 2491 },
+ { .triplet = "020ND", .pmin = -4982, .pmax = 4982 },
+ { .triplet = "030ND", .pmin = -7473, .pmax = 7473 },
+ { .triplet = "001PD", .pmin = -6895, .pmax = 6895 },
+ { .triplet = "005PD", .pmin = -34474, .pmax = 34474 },
+ { .triplet = "015PD", .pmin = -103421, .pmax = 103421 },
+ { .triplet = "030PD", .pmin = -206843, .pmax = 206843 },
+ { .triplet = "060PD", .pmin = -413685, .pmax = 413685 },
+ { .triplet = "001NG", .pmin = 0, .pmax = 249 },
+ { .triplet = "002NG", .pmin = 0, .pmax = 498 },
+ { .triplet = "004NG", .pmin = 0, .pmax = 996 },
+ { .triplet = "005NG", .pmin = 0, .pmax = 1245 },
+ { .triplet = "010NG", .pmin = 0, .pmax = 2491 },
+ { .triplet = "020NG", .pmin = 0, .pmax = 4982 },
+ { .triplet = "030NG", .pmin = 0, .pmax = 7473 },
+ { .triplet = "001PG", .pmin = 0, .pmax = 6895 },
+ { .triplet = "005PG", .pmin = 0, .pmax = 34474 },
+ { .triplet = "015PG", .pmin = 0, .pmax = 103421 },
+ { .triplet = "030PG", .pmin = 0, .pmax = 206843 },
+ { .triplet = "060PG", .pmin = 0, .pmax = 413685 },
+ { .triplet = "100PG", .pmin = 0, .pmax = 689476 },
+ { .triplet = "150PG", .pmin = 0, .pmax = 1034214 },
+};
+
+/*
+ * hsc_measurement_is_valid() - validate last conversion via status bits
+ * @data: structure containing instantiated sensor data
+ * Return: true only if both status bits are zero
+ *
+ * the two MSB from the first transfered byte contain a status code
+ * 00 - normal operation, valid data
+ * 01 - device in factory programming mode
+ * 10 - stale data
+ * 11 - diagnostic condition
+ */
+static bool hsc_measurement_is_valid(struct hsc_data *data)
+{
+ return !(data->buffer[0] & HSC_STATUS_MASK);
+}
+
+static int hsc_get_measurement(struct hsc_data *data)
+{
+ const struct hsc_chip_data *chip = data->chip;
+ int ret;
+
+ guard(mutex)(&data->lock);
+ ret = data->recv_cb(data);
+ if (ret < 0)
+ return ret;
+
+ data->is_valid = chip->valid(data);
+ if (!data->is_valid)
+ return -EAGAIN;
+
+ return 0;
+}
+
+static int hsc_read_raw(struct iio_dev *indio_dev,
+ struct iio_chan_spec const *channel, int *val,
+ int *val2, long mask)
+{
+ struct hsc_data *data = iio_priv(indio_dev);
+ int ret;
+ u32 recvd;
+ int raw;
+
+ switch (mask) {
+ case IIO_CHAN_INFO_RAW:
+ ret = hsc_get_measurement(data);
+ if (ret)
+ return ret;
+
+ recvd = get_unaligned_be32(data->buffer);
+ switch (channel->type) {
+ case IIO_PRESSURE:
+ raw = FIELD_GET(HSC_PRESSURE_MASK, recvd);
+ *val = raw;
+ return IIO_VAL_INT;
+ case IIO_TEMP:
+ raw = FIELD_GET(HSC_TEMPERATURE_MASK, recvd);
+ *val = raw;
+ return IIO_VAL_INT;
+ default:
+ return -EINVAL;
+ }
+
+/*
+ * IIO ABI expects
+ * value = (conv + offset) * scale
+ *
+ * datasheet provides the following formula for determining the temperature
+ * temp[C] = conv * a + b
+ * where a = 200/2047; b = -50
+ *
+ * temp[C] = (conv + (b/a)) * a * (1000)
+ * =>
+ * scale = a * 1000 = .097703957 * 1000 = 97.703957
+ * offset = b/a = -50 / .097703957 = -50000000 / 97704
+ *
+ * based on the datasheet
+ * pressure = (conv - Omin) * Q + Pmin =
+ * ((conv - Omin) + Pmin/Q) * Q
+ * =>
+ * scale = Q = (Pmax - Pmin) / (Omax - Omin)
+ * offset = Pmin/Q - Omin = Pmin * (Omax - Omin) / (Pmax - Pmin) - Omin
+ */
+
+ case IIO_CHAN_INFO_SCALE:
+ switch (channel->type) {
+ case IIO_TEMP:
+ *val = 97;
+ *val2 = 703957;
+ return IIO_VAL_INT_PLUS_MICRO;
+ case IIO_PRESSURE:
+ *val = data->p_scale;
+ *val2 = data->p_scale_dec;
+ return IIO_VAL_INT_PLUS_NANO;
+ default:
+ return -EINVAL;
+ }
+
+ case IIO_CHAN_INFO_OFFSET:
+ switch (channel->type) {
+ case IIO_TEMP:
+ *val = -50000000;
+ *val2 = 97704;
+ return IIO_VAL_FRACTIONAL;
+ case IIO_PRESSURE:
+ *val = data->p_offset;
+ *val2 = data->p_offset_dec;
+ return IIO_VAL_INT_PLUS_MICRO;
+ default:
+ return -EINVAL;
+ }
+
+ default:
+ return -EINVAL;
+ }
+}
+
+static const struct iio_chan_spec hsc_channels[] = {
+ {
+ .type = IIO_PRESSURE,
+ .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
+ BIT(IIO_CHAN_INFO_SCALE) |
+ BIT(IIO_CHAN_INFO_OFFSET),
+ },
+ {
+ .type = IIO_TEMP,
+ .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
+ BIT(IIO_CHAN_INFO_SCALE) |
+ BIT(IIO_CHAN_INFO_OFFSET),
+ },
+};
+
+static const struct iio_info hsc_info = {
+ .read_raw = hsc_read_raw,
+};
+
+static const struct hsc_chip_data hsc_chip = {
+ .valid = hsc_measurement_is_valid,
+ .channels = hsc_channels,
+ .num_channels = ARRAY_SIZE(hsc_channels),
+};
+
+int hsc_common_probe(struct device *dev, void *client, hsc_recv_fn recv_fn,
+ const char *name)
+{
+ struct hsc_data *hsc;
+ struct iio_dev *indio_dev;
+ const char *triplet;
+ u64 tmp;
+ int index;
+ int found = 0;
+ int ret;
+
+ indio_dev = devm_iio_device_alloc(dev, sizeof(*hsc));
+ if (!indio_dev)
+ return -ENOMEM;
+
+ hsc = iio_priv(indio_dev);
+
+ hsc->chip = &hsc_chip;
+ hsc->recv_cb = recv_fn;
+ hsc->client = client;
+
+ ret = device_property_read_u32(dev, "honeywell,transfer-function",
+ &hsc->function);
+ if (ret)
+ return dev_err_probe(dev, ret,
+ "honeywell,transfer-function could not be read\n");
+ if (hsc->function > HSC_FUNCTION_F)
+ return dev_err_probe(dev, -EINVAL,
+ "honeywell,transfer-function %d invalid\n",
+ hsc->function);
+
+ ret = device_property_read_string(dev, "honeywell,pressure-triplet",
+ &triplet);
+ if (ret)
+ return dev_err_probe(dev, ret,
+ "honeywell,pressure-triplet could not be read\n");
+
+ if (strncmp(triplet, "NA", 2) == 0) {
+ ret = device_property_read_u32(dev, "honeywell,pmin-pascal",
+ &hsc->pmin);
+ if (ret)
+ return dev_err_probe(dev, ret,
+ "honeywell,pmin-pascal could not be read\n");
+ ret = device_property_read_u32(dev, "honeywell,pmax-pascal",
+ &hsc->pmax);
+ if (ret)
+ return dev_err_probe(dev, ret,
+ "honeywell,pmax-pascal could not be read\n");
+ } else {
+ for (index = 0; index < ARRAY_SIZE(hsc_range_config); index++) {
+ if (strncmp(hsc_range_config[index].triplet,
+ triplet,
+ HSC_PRESSURE_TRIPLET_LEN - 1) == 0) {
+ hsc->pmin = hsc_range_config[index].pmin;
+ hsc->pmax = hsc_range_config[index].pmax;
+ found = 1;
+ break;
+ }
+ }
+ if (hsc->pmin == hsc->pmax || !found)
+ return dev_err_probe(dev, -EINVAL,
+ "honeywell,pressure-triplet is invalid\n");
+ }
+
+ ret = devm_regulator_get_enable(dev, "vdd");
+ if (ret)
+ return dev_err_probe(dev, ret, "can't get vdd supply\n");
+
+ hsc->outmin = hsc_func_spec[hsc->function].output_min;
+ hsc->outmax = hsc_func_spec[hsc->function].output_max;
+
+ tmp = div_s64(((s64)(hsc->pmax - hsc->pmin)) * MICRO,
+ hsc->outmax - hsc->outmin);
+ hsc->p_scale = div_s64_rem(tmp, NANO, &hsc->p_scale_dec);
+ tmp = div_s64(((s64)hsc->pmin * (s64)(hsc->outmax - hsc->outmin)) *
+ MICRO, hsc->pmax - hsc->pmin);
+ tmp -= (s64)hsc->outmin * MICRO;
+ hsc->p_offset = div_s64_rem(tmp, MICRO, &hsc->p_offset_dec);
+
+ mutex_init(&hsc->lock);
+ indio_dev->name = name;
+ indio_dev->modes = INDIO_DIRECT_MODE;
+ indio_dev->info = &hsc_info;
+ indio_dev->channels = hsc->chip->channels;
+ indio_dev->num_channels = hsc->chip->num_channels;
+
+ return devm_iio_device_register(dev, indio_dev);
+}
+EXPORT_SYMBOL_NS(hsc_common_probe, IIO_HONEYWELL_HSC030PA);
+
+MODULE_AUTHOR("Petre Rodan <[email protected]>");
+MODULE_DESCRIPTION("Honeywell HSC and SSC pressure sensor core driver");
+MODULE_LICENSE("GPL");
diff --git a/drivers/iio/pressure/hsc030pa.h b/drivers/iio/pressure/hsc030pa.h
new file mode 100644
index 000000000000..a2005c4f6b8d
--- /dev/null
+++ b/drivers/iio/pressure/hsc030pa.h
@@ -0,0 +1,83 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Honeywell TruStability HSC Series pressure/temperature sensor
+ *
+ * Copyright (c) 2023 Petre Rodan <[email protected]>
+ */
+
+#ifndef _HSC030PA_H
+#define _HSC030PA_H
+
+#include <linux/mutex.h>
+#include <linux/property.h>
+#include <linux/types.h>
+
+/*
+ * get all conversions (4 bytes) in one go
+ * since transfers are not address-based
+*/
+#define HSC_REG_MEASUREMENT_RD_SIZE 4
+
+struct device;
+
+struct iio_chan_spec;
+struct iio_dev;
+
+struct hsc_data;
+struct hsc_chip_data;
+
+typedef int (*hsc_recv_fn)(struct hsc_data *);
+
+/**
+ * struct hsc_data
+ * @client: either i2c or spi kernel interface struct for current dev
+ * @chip: structure containing chip's channel properties
+ * @lock: lock protecting chip reads
+ * @recv: function that implements the chip reads
+ * @is_valid: false if last transfer has failed
+ * @buffer: raw conversion data
+ * @pmin: minimum measurable pressure limit
+ * @pmax: maximum measurable pressure limit
+ * @outmin: minimum raw pressure in counts (based on transfer function)
+ * @outmax: maximum raw pressure in counts (based on transfer function)
+ * @function: transfer function
+ * @p_scale: pressure scale
+ * @p_scale_dec: pressure scale, decimal places
+ * @p_offset: pressure offset
+ * @p_offset_dec: pressure offset, decimal places
+ */
+struct hsc_data {
+ void *client;
+ const struct hsc_chip_data *chip;
+ struct mutex lock;
+ hsc_recv_fn recv_cb;
+ bool is_valid;
+ u8 buffer[HSC_REG_MEASUREMENT_RD_SIZE] __aligned(IIO_DMA_MINALIGN);
+ s32 pmin;
+ s32 pmax;
+ u32 outmin;
+ u32 outmax;
+ u32 function;
+ s64 p_scale;
+ s32 p_scale_dec;
+ s64 p_offset;
+ s32 p_offset_dec;
+};
+
+struct hsc_chip_data {
+ bool (*valid)(struct hsc_data *data);
+ const struct iio_chan_spec *channels;
+ u8 num_channels;
+};
+
+enum hsc_func_id {
+ HSC_FUNCTION_A,
+ HSC_FUNCTION_B,
+ HSC_FUNCTION_C,
+ HSC_FUNCTION_F,
+};
+
+int hsc_common_probe(struct device *dev, void *client,
+ hsc_recv_fn recv_fn, const char *name);
+
+#endif
diff --git a/drivers/iio/pressure/hsc030pa_i2c.c b/drivers/iio/pressure/hsc030pa_i2c.c
new file mode 100644
index 000000000000..96e0d729de81
--- /dev/null
+++ b/drivers/iio/pressure/hsc030pa_i2c.c
@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Honeywell TruStability HSC Series pressure/temperature sensor
+ *
+ * Copyright (c) 2023 Petre Rodan <[email protected]>
+ *
+ * Datasheet: https://prod-edam.honeywell.com/content/dam/honeywell-edam/sps/siot/en-us/products/sensors/pressure-sensors/board-mount-pressure-sensors/trustability-hsc-series/documents/sps-siot-trustability-hsc-series-high-accuracy-board-mount-pressure-sensors-50099148-a-en-ciid-151133.pdf [hsc]
+ * Datasheet: https://prod-edam.honeywell.com/content/dam/honeywell-edam/sps/siot/en-us/products/sensors/pressure-sensors/board-mount-pressure-sensors/common/documents/sps-siot-i2c-comms-digital-output-pressure-sensors-tn-008201-3-en-ciid-45841.pdf [i2c related]
+ */
+
+#include <linux/errno.h>
+#include <linux/i2c.h>
+#include <linux/mod_devicetable.h>
+#include <linux/module.h>
+
+#include <linux/iio/iio.h>
+
+#include "hsc030pa.h"
+
+static int hsc_i2c_recv(struct hsc_data *data)
+{
+ struct i2c_client *client = data->client;
+ struct i2c_msg msg;
+ int ret;
+
+ msg.addr = client->addr;
+ msg.flags = client->flags | I2C_M_RD;
+ msg.len = HSC_REG_MEASUREMENT_RD_SIZE;
+ msg.buf = data->buffer;
+
+ ret = i2c_transfer(client->adapter, &msg, 1);
+
+ return (ret == 2) ? 0 : ret;
+}
+
+static int hsc_i2c_probe(struct i2c_client *client)
+{
+ const struct i2c_device_id *id = i2c_client_get_device_id(client);
+
+ if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C))
+ return -EOPNOTSUPP;
+
+ return hsc_common_probe(&client->dev, client, hsc_i2c_recv, id->name);
+}
+
+static const struct of_device_id hsc_i2c_match[] = {
+ {.compatible = "honeywell,hsc030pa"},
+ {}
+};
+MODULE_DEVICE_TABLE(of, hsc_i2c_match);
+
+static const struct i2c_device_id hsc_i2c_id[] = {
+ {"hsc030pa"},
+ {}
+};
+MODULE_DEVICE_TABLE(i2c, hsc_i2c_id);
+
+static struct i2c_driver hsc_i2c_driver = {
+ .driver = {
+ .name = "hsc030pa",
+ .of_match_table = hsc_i2c_match,
+ },
+ .probe = hsc_i2c_probe,
+ .id_table = hsc_i2c_id,
+};
+module_i2c_driver(hsc_i2c_driver);
+
+MODULE_AUTHOR("Petre Rodan <[email protected]>");
+MODULE_DESCRIPTION("Honeywell HSC and SSC pressure sensor i2c driver");
+MODULE_LICENSE("GPL");
+MODULE_IMPORT_NS(IIO_HONEYWELL_HSC030PA);
diff --git a/drivers/iio/pressure/hsc030pa_spi.c b/drivers/iio/pressure/hsc030pa_spi.c
new file mode 100644
index 000000000000..a18d9374a4dc
--- /dev/null
+++ b/drivers/iio/pressure/hsc030pa_spi.c
@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Honeywell TruStability HSC Series pressure/temperature sensor
+ *
+ * Copyright (c) 2023 Petre Rodan <[email protected]>
+ *
+ * Datasheet: https://prod-edam.honeywell.com/content/dam/honeywell-edam/sps/siot/en-us/products/sensors/pressure-sensors/board-mount-pressure-sensors/trustability-hsc-series/documents/sps-siot-trustability-hsc-series-high-accuracy-board-mount-pressure-sensors-50099148-a-en-ciid-151133.pdf
+ */
+
+#include <linux/mod_devicetable.h>
+#include <linux/module.h>
+#include <linux/spi/spi.h>
+#include <linux/stddef.h>
+
+#include <linux/iio/iio.h>
+
+#include "hsc030pa.h"
+
+static int hsc_spi_recv(struct hsc_data *data)
+{
+ struct spi_transfer xfer = {
+ .tx_buf = NULL,
+ .rx_buf = data->buffer,
+ .len = HSC_REG_MEASUREMENT_RD_SIZE,
+ };
+
+ return spi_sync_transfer(data->client, &xfer, 1);
+}
+
+static int hsc_spi_probe(struct spi_device *spi)
+{
+ const struct spi_device_id *id = spi_get_device_id(spi);
+
+ return hsc_common_probe(&spi->dev, spi, hsc_spi_recv, id->name);
+}
+
+static const struct of_device_id hsc_spi_match[] = {
+ {.compatible = "honeywell,hsc030pa"},
+ {}
+};
+MODULE_DEVICE_TABLE(of, hsc_spi_match);
+
+static const struct spi_device_id hsc_spi_id[] = {
+ {"hsc030pa"},
+ {}
+};
+MODULE_DEVICE_TABLE(spi, hsc_spi_id);
+
+static struct spi_driver hsc_spi_driver = {
+ .driver = {
+ .name = "hsc030pa",
+ .of_match_table = hsc_spi_match,
+ },
+ .probe = hsc_spi_probe,
+ .id_table = hsc_spi_id,
+};
+module_spi_driver(hsc_spi_driver);
+
+MODULE_AUTHOR("Petre Rodan <[email protected]>");
+MODULE_DESCRIPTION("Honeywell HSC and SSC pressure sensor spi driver");
+MODULE_LICENSE("GPL");
+MODULE_IMPORT_NS(IIO_HONEYWELL_HSC030PA);
--
2.41.0
On Wed, Nov 29, 2023 at 09:04:49AM +0200, Petre Rodan wrote:
> Adds driver for digital Honeywell TruStability HSC and SSC series
> pressure and temperature sensors.
> Communication is one way. The sensor only requires 4 bytes worth of
> clock pulses on both i2c and spi in order to push the data out.
> The i2c address is hardcoded and depends on the part number.
> There is no additional GPIO control.
Thank you for an update!
Much better now, only one important thing is left unaddressed, see below.
...
> + if (strncmp(triplet, "NA", 2) == 0) {
str_has_prefix()
...
> + for (index = 0; index < ARRAY_SIZE(hsc_range_config); index++) {
> + if (strncmp(hsc_range_config[index].triplet,
> + triplet,
> + HSC_PRESSURE_TRIPLET_LEN - 1) == 0) {
> + hsc->pmin = hsc_range_config[index].pmin;
> + hsc->pmax = hsc_range_config[index].pmax;
> + found = 1;
> + break;
> + }
> + }
> + if (hsc->pmin == hsc->pmax || !found)
> + return dev_err_probe(dev, -EINVAL,
> + "honeywell,pressure-triplet is invalid\n");
This one is important. I think I told already twice that this is NIH
device_property_match_property_string(). Please, use this API directly.
...
> + tmp = div_s64(((s64)(hsc->pmax - hsc->pmin)) * MICRO,
> + hsc->outmax - hsc->outmin);
> + hsc->p_scale = div_s64_rem(tmp, NANO, &hsc->p_scale_dec);
> + tmp = div_s64(((s64)hsc->pmin * (s64)(hsc->outmax - hsc->outmin)) *
> + MICRO, hsc->pmax - hsc->pmin);
I would leave MICRO on the previous line for better understanding the code.
...
> +#ifndef _HSC030PA_H
> +#define _HSC030PA_H
> +#include <linux/mutex.h>
> +#include <linux/property.h>
Is not used here.
> +#include <linux/types.h>
...
> +/*
> + * get all conversions (4 bytes) in one go
> + * since transfers are not address-based
> +*/
Missing space at the last line and missing capitalization and grammar period.
...
> +int hsc_common_probe(struct device *dev, void *client,
> + hsc_recv_fn recv_fn, const char *name);
Indentation is unusual on the second line, also you can use just "recv" as
parameter name. But both are minor and I leave them to you and maintainer.
...
> +static const struct of_device_id hsc_spi_match[] = {
> + {.compatible = "honeywell,hsc030pa"},
I believe Jonathan asks for inner spaces, like { ...foo... }.
> + {}
> +};
...
> +static const struct spi_device_id hsc_spi_id[] = {
> + {"hsc030pa"},
Ditto.
> + {}
> +};
--
With Best Regards,
Andy Shevchenko
Hello,
thank you for the code review.
On Wed, Nov 29, 2023 at 12:36:46PM +0200, Andy Shevchenko wrote:
> On Wed, Nov 29, 2023 at 09:04:49AM +0200, Petre Rodan wrote:
> ...
>
> > + for (index = 0; index < ARRAY_SIZE(hsc_range_config); index++) {
> > + if (strncmp(hsc_range_config[index].triplet,
> > + triplet,
> > + HSC_PRESSURE_TRIPLET_LEN - 1) == 0) {
> > + hsc->pmin = hsc_range_config[index].pmin;
> > + hsc->pmax = hsc_range_config[index].pmax;
> > + found = 1;
> > + break;
> > + }
> > + }
> > + if (hsc->pmin == hsc->pmax || !found)
> > + return dev_err_probe(dev, -EINVAL,
> > + "honeywell,pressure-triplet is invalid\n");
>
> This one is important. I think I told already twice that this is NIH
> device_property_match_property_string(). Please, use this API directly.
let me see if we are on the same frequency.
you told me to use match_string/sysfs_match_string.
using any of those assume having the strings in an array, which means I have to
clutter the code with 242 extra lines in order to split up hsc_range_config:
enum hsc_variants {
HSC001BA = 0,
HSC1_6BA = 1,
[ .. 115 lines skipped ]
HSC150PG = 117,
}
static const char * const hsc_triplet_variants[] = {
[HSC001BA] = "001BA",
[HSC1_6BA] = "1.6BA",
[ .. 115 lines skipped ]
[HSC150PG] = "150PG",
};
and change my structure to
static const struct hsc_range_config hsc_range_config[] = {
[HSC001BA] = { .pmin = 0, .pmax = 100000 },
[ .. 117 lines skipped ]
};
just to have the privilege of using match_string() on hsc_triplet_variants.
now, which is worse for maintenance? a handful of lines of code that do a
loop of strncmp or the clutter depicted above?
I can go either way, but I want to make sure you see where this leads.
> > +#ifndef _HSC030PA_H
> > +#define _HSC030PA_H
>
> > +#include <linux/mutex.h>
>
> > +#include <linux/property.h>
>
> Is not used here.
ok.
since we are here, can you please tell me how is mutex.h used outside of hsc030pa.c where it was included previously?
cheers,
peter
--
petre rodan
On Wed, Nov 29, 2023 at 03:51:54PM +0200, Petre Rodan wrote:
> On Wed, Nov 29, 2023 at 12:36:46PM +0200, Andy Shevchenko wrote:
> > On Wed, Nov 29, 2023 at 09:04:49AM +0200, Petre Rodan wrote:
...
> > > + for (index = 0; index < ARRAY_SIZE(hsc_range_config); index++) {
> > > + if (strncmp(hsc_range_config[index].triplet,
> > > + triplet,
> > > + HSC_PRESSURE_TRIPLET_LEN - 1) == 0) {
> > > + hsc->pmin = hsc_range_config[index].pmin;
> > > + hsc->pmax = hsc_range_config[index].pmax;
> > > + found = 1;
> > > + break;
> > > + }
> > > + }
> > > + if (hsc->pmin == hsc->pmax || !found)
> > > + return dev_err_probe(dev, -EINVAL,
> > > + "honeywell,pressure-triplet is invalid\n");
> >
> > This one is important. I think I told already twice that this is NIH
> > device_property_match_property_string(). Please, use this API directly.
>
> let me see if we are on the same frequency.
>
> you told me to use match_string/sysfs_match_string.
> using any of those assume having the strings in an array, which means I have to
> clutter the code with 242 extra lines in order to split up hsc_range_config:
>
> enum hsc_variants {
> HSC001BA = 0,
> HSC1_6BA = 1,
> [ .. 115 lines skipped ]
> HSC150PG = 117,
HSC_VARIANTS_MAX
> }
>
> static const char * const hsc_triplet_variants[] = {
static const char * const hsc_triplet_variants[HSC_VARIANTS_MAX] = {
> [HSC001BA] = "001BA",
> [HSC1_6BA] = "1.6BA",
> [ .. 115 lines skipped ]
> [HSC150PG] = "150PG",
> };
>
> and change my structure to
>
> static const struct hsc_range_config hsc_range_config[] = {
static const struct hsc_range_config hsc_range_config[HSC_VARIANTS_MAX] = {
> [HSC001BA] = { .pmin = 0, .pmax = 100000 },
> [ .. 117 lines skipped ]
> };
>
> just to have the privilege of using match_string() on hsc_triplet_variants.
> now, which is worse for maintenance? a handful of lines of code that do a
> loop of strncmp or the clutter depicted above?
>
> I can go either way, but I want to make sure you see where this leads.
That's the suggestion, yes.
...
> > > +#ifndef _HSC030PA_H
> > > +#define _HSC030PA_H
> >
> > > +#include <linux/mutex.h>
> >
> > > +#include <linux/property.h>
> >
> > Is not used here.
>
> ok.
> since we are here, can you please tell me how is mutex.h used outside of
> hsc030pa.c where it was included previously?
I'm not sure I understand you. Maybe I was unclear, sorry for that.
I meant the property.h is not used in the _header_ file. Am I mistaken?
--
With Best Regards,
Andy Shevchenko
On Wed, Nov 29, 2023 at 04:14:59PM +0200, Andy Shevchenko wrote:
> On Wed, Nov 29, 2023 at 03:51:54PM +0200, Petre Rodan wrote:
> > On Wed, Nov 29, 2023 at 12:36:46PM +0200, Andy Shevchenko wrote:
> > > On Wed, Nov 29, 2023 at 09:04:49AM +0200, Petre Rodan wrote:
...
> > just to have the privilege of using match_string() on hsc_triplet_variants.
> > now, which is worse for maintenance? a handful of lines of code that do a
> > loop of strncmp or the clutter depicted above?
> >
> > I can go either way, but I want to make sure you see where this leads.
>
> That's the suggestion, yes.
Btw, if you have any idea how to make a generic API that suits your and
similar cases, I'm all ears!
--
With Best Regards,
Andy Shevchenko