From patchwork Wed Nov 29 07:04:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Petre Rodan X-Patchwork-Id: 13472322 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=subdimension.ro header.i=@subdimension.ro header.b="VyuGzLgl" Received: from mail.subdimension.ro (unknown [IPv6:2a01:7e01:e001:1d1::2]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E11BD1710; Tue, 28 Nov 2023 23:04:46 -0800 (PST) Received: from localhost.localdomain (unknown [188.24.94.216]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mail.subdimension.ro (Postfix) with ESMTPSA id 2A50A28EE6F; Wed, 29 Nov 2023 07:04:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=subdimension.ro; s=skycaves; t=1701241485; bh=h0pBAX0b5fBffudVLMqu5Z24kyPYo9GeCNP/h2sstmI=; h=From:To:Cc:Subject:Date; b=VyuGzLgldxb26pZpPREj4KMaMrGJiiqoauV/m3QJzEXo4KPAr0SFJltFBZ3D8v1oz NPg403n4SBsTqRrlT4JEdFs6x044746tffVDYA1qgSU3k7auQkPJ87dYmcD5+fiSLN EeazDwvOJI9KIy5s3aPOYpw7cb7JCo3PshVokfak= From: Petre Rodan To: linux-kernel@vger.kernel.org, linux-iio@vger.kernel.org, devicetree@vger.kernel.org Cc: Petre Rodan , Conor Dooley , Lars-Peter Clausen , Rob Herring , Krzysztof Kozlowski , linux-kernel-mentees@lists.linuxfoundation.org, Jonathan Cameron Subject: [PATCH v5 1/2] dt-bindings: iio: pressure: add honeywell,hsc030 Date: Wed, 29 Nov 2023 09:04:30 +0200 Message-ID: <20231129070432.1437-1-petre.rodan@subdimension.ro> X-Mailer: git-send-email 2.41.0 Precedence: bulk X-Mailing-List: linux-iio@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Adds binding 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 Reviewed-by: Krzysztof Kozlowski --- V2: - fix yaml struct - cleanup based on Krzysztof's review V3: - rename range_str -> honeywell,pressure-triplet to define the string containing the pressure range, measurement unit and type - honeywell,pmax-pascal becomes uint32 V4: - added enum to honeywell,transfer-function V5: - removed pmin-pascal, pmax-pascal $ref - added pmin-pascal, pmax-pascal constraints --- .../iio/pressure/honeywell,hsc030pa.yaml | 142 ++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/pressure/honeywell,hsc030pa.yaml diff --git a/Documentation/devicetree/bindings/iio/pressure/honeywell,hsc030pa.yaml b/Documentation/devicetree/bindings/iio/pressure/honeywell,hsc030pa.yaml new file mode 100644 index 000000000000..65a24ed67b3c --- /dev/null +++ b/Documentation/devicetree/bindings/iio/pressure/honeywell,hsc030pa.yaml @@ -0,0 +1,142 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/pressure/honeywell,hsc030pa.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Honeywell TruStability HSC and SSC pressure sensor series + +description: | + support for Honeywell TruStability HSC and SSC digital pressure sensor + series. + + These sensors have either an I2C, an SPI or an analog interface. Only the + digital versions are supported by this driver. + + There are 118 models with different pressure ranges available in each family. + The vendor calls them "HSC series" and "SSC series". All of them have an + identical programming model but differ in pressure range, unit and transfer + function. + + To support different models one needs to specify the pressure range as well + as the transfer function. Pressure range can either be provided via + pressure-triplet (directly extracted from the part number) or in case it's + a custom chip via numerical range limits converted to pascals. + + The transfer function defines the ranges of raw conversion values delivered + by the sensor. pmin-pascal and pmax-pascal corespond to the minimum and + maximum pressure that can be measured. + + Please note that in case of an SPI-based sensor, the clock signal should not + exceed 800kHz and the MOSI signal is not required. + + Specifications about the devices can be found at: + 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 + 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 + +maintainers: + - Petre Rodan + +properties: + compatible: + const: honeywell,hsc030pa + + reg: + maxItems: 1 + + honeywell,transfer-function: + description: | + Transfer function which defines the range of valid values delivered by + the sensor. + 0 - A, 10% to 90% of 2^14 + 1 - B, 5% to 95% of 2^14 + 2 - C, 5% to 85% of 2^14 + 3 - F, 4% to 94% of 2^14 + enum: [0, 1, 2, 3] + $ref: /schemas/types.yaml#/definitions/uint32 + + honeywell,pressure-triplet: + description: | + Case-sensitive five character string that defines pressure range, unit + and type as part of the device nomenclature. In the unlikely case of a + custom chip, set to "NA" and provide pmin-pascal and pmax-pascal. + enum: [001BA, 1.6BA, 2.5BA, 004BA, 006BA, 010BA, 1.6MD, 2.5MD, 004MD, + 006MD, 010MD, 016MD, 025MD, 040MD, 060MD, 100MD, 160MD, 250MD, + 400MD, 600MD, 001BD, 1.6BD, 2.5BD, 004BD, 2.5MG, 004MG, 006MG, + 010MG, 016MG, 025MG, 040MG, 060MG, 100MG, 160MG, 250MG, 400MG, + 600MG, 001BG, 1.6BG, 2.5BG, 004BG, 006BG, 010BG, 100KA, 160KA, + 250KA, 400KA, 600KA, 001GA, 160LD, 250LD, 400LD, 600LD, 001KD, + 1.6KD, 2.5KD, 004KD, 006KD, 010KD, 016KD, 025KD, 040KD, 060KD, + 100KD, 160KD, 250KD, 400KD, 250LG, 400LG, 600LG, 001KG, 1.6KG, + 2.5KG, 004KG, 006KG, 010KG, 016KG, 025KG, 040KG, 060KG, 100KG, + 160KG, 250KG, 400KG, 600KG, 001GG, 015PA, 030PA, 060PA, 100PA, + 150PA, 0.5ND, 001ND, 002ND, 004ND, 005ND, 010ND, 020ND, 030ND, + 001PD, 005PD, 015PD, 030PD, 060PD, 001NG, 002NG, 004NG, 005NG, + 010NG, 020NG, 030NG, 001PG, 005PG, 015PG, 030PG, 060PG, 100PG, + 150PG, NA] + $ref: /schemas/types.yaml#/definitions/string + + honeywell,pmin-pascal: + description: | + Minimum pressure value the sensor can measure in pascal. + To be specified only if honeywell,pressure-triplet is set to "NA". + + honeywell,pmax-pascal: + description: | + Maximum pressure value the sensor can measure in pascal. + To be specified only if honeywell,pressure-triplet is set to "NA". + + vdd-supply: + description: + Provide VDD power to the sensor (either 3.3V or 5V depending on the chip) + + spi-max-frequency: + maximum: 800000 + +required: + - compatible + - reg + - honeywell,transfer-function + - honeywell,pressure-triplet + +additionalProperties: false + +dependentSchemas: + honeywell,pmin-pascal: + properties: + honeywell,pressure-triplet: + const: NA + honeywell,pmax-pascal: + properties: + honeywell,pressure-triplet: + const: NA + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + pressure@28 { + compatible = "honeywell,hsc030pa"; + reg = <0x28>; + honeywell,transfer-function = <0>; + honeywell,pressure-triplet = "030PA"; + }; + }; + - | + spi { + #address-cells = <1>; + #size-cells = <0>; + + pressure@0 { + compatible = "honeywell,hsc030pa"; + reg = <0>; + spi-max-frequency = <800000>; + honeywell,transfer-function = <0>; + honeywell,pressure-triplet = "NA"; + honeywell,pmin-pascal = <0>; + honeywell,pmax-pascal = <200000>; + }; + }; +... From patchwork Wed Nov 29 07:04:49 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Petre Rodan X-Patchwork-Id: 13472323 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=subdimension.ro header.i=@subdimension.ro header.b="X/WKf5mz" Received: from mail.subdimension.ro (skycaves.subdimension.ro [172.104.132.142]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 604E2DC; Tue, 28 Nov 2023 23:04:56 -0800 (PST) Received: from localhost.localdomain (unknown [188.24.94.216]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mail.subdimension.ro (Postfix) with ESMTPSA id B325028EE6F; Wed, 29 Nov 2023 07:04:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=subdimension.ro; s=skycaves; t=1701241495; bh=jO/cOpKAXSdj92nv2+9gKUCzfPwvxj0fC9NRM/mVFWk=; h=From:To:Cc:Subject:Date; b=X/WKf5mzlAmIAFmk8/ca2B49skQCnob0vHJeoiOqcH5DGuJ/CYHgTEKhwiRVfMIla 1Sv1XFnm301Xpf32UISnE+/kuIOPFIZHeyPPUPP+NzapfyfTOqqOcc3sZjqEbZHL5H bZhadHq4WOei5vnrSI/NZoj4vwrRUcMT060LVmI4= From: Petre Rodan To: linux-kernel@vger.kernel.org, linux-iio@vger.kernel.org Cc: Petre Rodan , Jonathan Cameron , Lars-Peter Clausen , Andy Shevchenko , Angel Iglesias , Matti Vaittinen , Andreas Klinger , Rob Herring , Krzysztof Kozlowski Subject: [PATCH v5 2/2] iio: pressure: driver for Honeywell HSC/SSC series pressure sensors Date: Wed, 29 Nov 2023 09:04:49 +0200 Message-ID: <20231129070452.1521-1-petre.rodan@subdimension.ro> X-Mailer: git-send-email 2.41.0 Precedence: bulk X-Mailing-List: linux-iio@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 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 --- 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 +L: linux-iio@vger.kernel.org +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 L: linux-iio@vger.kernel.org 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 + * + * 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 +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +#include + +#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 "); +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 + */ + +#ifndef _HSC030PA_H +#define _HSC030PA_H + +#include +#include +#include + +/* + * 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 + * + * 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 +#include +#include +#include + +#include + +#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 "); +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 + * + * 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 +#include +#include +#include + +#include + +#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 "); +MODULE_DESCRIPTION("Honeywell HSC and SSC pressure sensor spi driver"); +MODULE_LICENSE("GPL"); +MODULE_IMPORT_NS(IIO_HONEYWELL_HSC030PA);