* [PATCH v2 0/2] hwmon: Add support for TI TPS389006/TPS389008
@ 2026-11-17 23:45 ` Luna Hart via B4 Relay
0 siblings, 0 replies; 8+ messages in thread
From: Luna Hart @ 2026-11-17 23:45 UTC (permalink / raw)
To: Guenter Roeck, Rob Herring, Krzysztof Kozlowski, Conor Dooley,
Jonathan Corbet, Shuah Khan, Randy Dunlap
Cc: linux-hwmon, devicetree, linux-kernel, linux-doc, Flaviu Nistor,
Uwe Kleine-König, Luna Hart
This series adds a devicetree binding and a hwmon driver for the TI
TPS389006 and TPS389008 I2C voltage supervisors and monitors, with 6 and
8 channels.
The driver reports the voltage measured by the ADC of each channel, and
can enable or disable the monitoring of a channel. The devicetree can
select the voltage range (1x or 4x) of each channel. Otherwise, the
power on state for the scale is used (likely OTP values).
This v2 patch set addresses v1 review comments, and handles parts with
an OTP configuration. There is no single register to indicate if a
channel or chip uses custom OTP values. Thus we assume any OTP
programmable register to have a deliberately set value. We have taken
care to preserve the init state of channels based on the value of
their monitor enable register. Triggering a fault by modifying channel
settings with monitoring enabled may have additional consequences
depending on the hardware layout.
Tested on a TI J784S4 based board with a TPS389006, on a 7.3 based
kernel.
Signed-off-by: Luna Hart <lhart.opensource@witekio.com>
---
Changes in v2:
- Drop the TPS389004, no datasheet or part listing could be found for it
- dt-bindings: rename the file to ti,tps389006.yaml and vmon@N to channel@N
- dt-bindings: child nodes no longer select the channels, unconnected
inputs are marked with status = "disabled"
- dt-bindings: replace ti,4x-scaling with ti,vrange-multiplier = <1|4>,
absent keeps the range programmed in the chip
- dt-bindings: document NIRQ and the MON1-MON8 numbering, drop redundant
descriptions
- dt-bindings: no fallback compatible, the parts differ in channel count
- hwmon: fix the VRANGE_MULT address, it is in bank 1 (0x11f)
- hwmon: never change the range of a channel that is monitoring at probe,
and respect the configuration write protection
- hwmon: return -ENODATA while the ACT pin is low
- hwmon: fail probe when no match data is found (GENMASK(-1, 0))
- hwmon: cleanups: use the regmap cache instead of a local copy, drop
<linux/mod_devicetable.h>, "{ }" terminators, /* */ comments,
devm_kzalloc_obj(), channel counts in Kconfig, sorted Kconfig/Makefile
- Link to v1: https://lore.kernel.org/r/20260929-lhart-dev-tps38900x-v1-0-7045c5894152@witekio.com
---
Luna Hart (2):
dt-bindings: hwmon: Add TI TPS389006/TPS389008
hwmon: (tps38900x) Add driver for TI TPS389006/TPS389008
.../devicetree/bindings/hwmon/ti,tps389006.yaml | 114 +++++++
Documentation/hwmon/index.rst | 1 +
Documentation/hwmon/tps38900x.rst | 80 +++++
MAINTAINERS | 8 +
drivers/hwmon/Kconfig | 12 +
drivers/hwmon/Makefile | 1 +
drivers/hwmon/tps38900x.c | 361 +++++++++++++++++++++
7 files changed, 577 insertions(+)
---
base-commit: 28c252b708a9d223192cbf848d320cf6d0f7ed3a
change-id: 20260929-lhart-dev-tps38900x-f932bcdb4057
Best regards,
--
Luna Hart <lhart.opensource@witekio.com>
^ permalink raw reply [flat|nested] 8+ messages in thread* [PATCH v2 0/2] hwmon: Add support for TI TPS389006/TPS389008 @ 2026-11-17 23:45 ` Luna Hart via B4 Relay 0 siblings, 0 replies; 8+ messages in thread From: Luna Hart via B4 Relay @ 2026-11-17 23:45 UTC (permalink / raw) To: Guenter Roeck, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Jonathan Corbet, Shuah Khan, Randy Dunlap Cc: linux-hwmon, devicetree, linux-kernel, linux-doc, Flaviu Nistor, Uwe Kleine-König, Luna Hart This series adds a devicetree binding and a hwmon driver for the TI TPS389006 and TPS389008 I2C voltage supervisors and monitors, with 6 and 8 channels. The driver reports the voltage measured by the ADC of each channel, and can enable or disable the monitoring of a channel. The devicetree can select the voltage range (1x or 4x) of each channel. Otherwise, the power on state for the scale is used (likely OTP values). This v2 patch set addresses v1 review comments, and handles parts with an OTP configuration. There is no single register to indicate if a channel or chip uses custom OTP values. Thus we assume any OTP programmable register to have a deliberately set value. We have taken care to preserve the init state of channels based on the value of their monitor enable register. Triggering a fault by modifying channel settings with monitoring enabled may have additional consequences depending on the hardware layout. Tested on a TI J784S4 based board with a TPS389006, on a 7.3 based kernel. Signed-off-by: Luna Hart <lhart.opensource@witekio.com> --- Changes in v2: - Drop the TPS389004, no datasheet or part listing could be found for it - dt-bindings: rename the file to ti,tps389006.yaml and vmon@N to channel@N - dt-bindings: child nodes no longer select the channels, unconnected inputs are marked with status = "disabled" - dt-bindings: replace ti,4x-scaling with ti,vrange-multiplier = <1|4>, absent keeps the range programmed in the chip - dt-bindings: document NIRQ and the MON1-MON8 numbering, drop redundant descriptions - dt-bindings: no fallback compatible, the parts differ in channel count - hwmon: fix the VRANGE_MULT address, it is in bank 1 (0x11f) - hwmon: never change the range of a channel that is monitoring at probe, and respect the configuration write protection - hwmon: return -ENODATA while the ACT pin is low - hwmon: fail probe when no match data is found (GENMASK(-1, 0)) - hwmon: cleanups: use the regmap cache instead of a local copy, drop <linux/mod_devicetable.h>, "{ }" terminators, /* */ comments, devm_kzalloc_obj(), channel counts in Kconfig, sorted Kconfig/Makefile - Link to v1: https://lore.kernel.org/r/20260929-lhart-dev-tps38900x-v1-0-7045c5894152@witekio.com --- Luna Hart (2): dt-bindings: hwmon: Add TI TPS389006/TPS389008 hwmon: (tps38900x) Add driver for TI TPS389006/TPS389008 .../devicetree/bindings/hwmon/ti,tps389006.yaml | 114 +++++++ Documentation/hwmon/index.rst | 1 + Documentation/hwmon/tps38900x.rst | 80 +++++ MAINTAINERS | 8 + drivers/hwmon/Kconfig | 12 + drivers/hwmon/Makefile | 1 + drivers/hwmon/tps38900x.c | 361 +++++++++++++++++++++ 7 files changed, 577 insertions(+) --- base-commit: 28c252b708a9d223192cbf848d320cf6d0f7ed3a change-id: 20260929-lhart-dev-tps38900x-f932bcdb4057 Best regards, -- Luna Hart <lhart.opensource@witekio.com> ^ permalink raw reply [flat|nested] 8+ messages in thread
* [PATCH v2 1/2] dt-bindings: hwmon: Add TI TPS389006/TPS389008 2026-11-17 23:45 ` Luna Hart via B4 Relay @ 2026-11-17 23:45 ` Luna Hart via B4 Relay -1 siblings, 0 replies; 8+ messages in thread From: Luna Hart @ 2026-11-17 23:45 UTC (permalink / raw) To: Guenter Roeck, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Jonathan Corbet, Shuah Khan, Randy Dunlap Cc: linux-hwmon, devicetree, linux-kernel, linux-doc, Flaviu Nistor, Uwe Kleine-König, Luna Hart Add a binding for the TI TPS389006 and TPS389008 I2C voltage supervisors and monitors, which provide 6 and 8 voltage inputs respectively. Each input may be described by an optional child node, containing additional properties including the label and voltage monitoring range. Inputs that are not connected can be marked with status set to "disabled". Based on an earlier binding by Flaviu Nistor. Signed-off-by: Luna Hart <lhart.opensource@witekio.com> --- .../devicetree/bindings/hwmon/ti,tps389006.yaml | 114 +++++++++++++++++++++ 1 file changed, 114 insertions(+) diff --git a/Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml b/Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml new file mode 100644 index 0000000000000000000000000000000000000000..2a26f6623adf06d1df38d5bc3683b5d2e06f3c0f --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml @@ -0,0 +1,114 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/hwmon/ti,tps389006.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI TPS389006/TPS389008 voltage supervisor and monitor + +maintainers: + - Luna Hart <lhart.opensource@witekio.com> + +description: | + Voltage supervisor and monitor from TI (TPS389006, TPS389008) on I2C bus. + + Datasheets: + https://www.ti.com/lit/ds/symlink/tps389006.pdf + https://www.ti.com/lit/ds/symlink/tps389006-q1.pdf + +properties: + compatible: + enum: + - ti,tps389006 + - ti,tps389008 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + description: NIRQ fault interrupt output (active low). + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + +patternProperties: + "^channel@[0-7]$": + description: + A monitored input. Inputs that are not connected can be marked with + status set to "disabled". + type: object + additionalProperties: false + + properties: + reg: + description: Input index, 0 for MON1 up to 7 for MON8. + enum: [ 0, 1, 2, 3, 4, 5, 6, 7 ] + + label: + description: Name of the input source. + + ti,vrange-multiplier: + description: + Voltage monitoring range of the input. 1 selects 0.2V to 1.475V in + 5mV steps, 4 selects 0.8V to 5.5V in 20mV steps. If absent, the + range programmed in the device is used. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [ 1, 4 ] + + required: + - reg + +required: + - compatible + - reg + +allOf: + - if: + properties: + compatible: + const: ti,tps389006 + then: + patternProperties: + "^channel@[67]$": false + +additionalProperties: false + +examples: + - | + #include <dt-bindings/interrupt-controller/irq.h> + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + voltage-monitor@30 { + compatible = "ti,tps389008"; + reg = <0x30>; + interrupt-parent = <&gpio1>; + interrupts = <12 IRQ_TYPE_LEVEL_LOW>; + #address-cells = <1>; + #size-cells = <0>; + + channel@0 { + reg = <0x0>; + label = "input0"; + ti,vrange-multiplier = <4>; + }; + + channel@1 { + reg = <0x1>; + label = "input1"; + ti,vrange-multiplier = <1>; + }; + + channel@7 { + reg = <0x7>; + + status = "disabled"; + }; + }; + }; -- 2.47.3 ^ permalink raw reply related [flat|nested] 8+ messages in thread
* [PATCH v2 1/2] dt-bindings: hwmon: Add TI TPS389006/TPS389008 @ 2026-11-17 23:45 ` Luna Hart via B4 Relay 0 siblings, 0 replies; 8+ messages in thread From: Luna Hart via B4 Relay @ 2026-11-17 23:45 UTC (permalink / raw) To: Guenter Roeck, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Jonathan Corbet, Shuah Khan, Randy Dunlap Cc: linux-hwmon, devicetree, linux-kernel, linux-doc, Flaviu Nistor, Uwe Kleine-König, Luna Hart From: Luna Hart <lhart.opensource@witekio.com> Add a binding for the TI TPS389006 and TPS389008 I2C voltage supervisors and monitors, which provide 6 and 8 voltage inputs respectively. Each input may be described by an optional child node, containing additional properties including the label and voltage monitoring range. Inputs that are not connected can be marked with status set to "disabled". Based on an earlier binding by Flaviu Nistor. Signed-off-by: Luna Hart <lhart.opensource@witekio.com> --- .../devicetree/bindings/hwmon/ti,tps389006.yaml | 114 +++++++++++++++++++++ 1 file changed, 114 insertions(+) diff --git a/Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml b/Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml new file mode 100644 index 0000000000000000000000000000000000000000..2a26f6623adf06d1df38d5bc3683b5d2e06f3c0f --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml @@ -0,0 +1,114 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/hwmon/ti,tps389006.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI TPS389006/TPS389008 voltage supervisor and monitor + +maintainers: + - Luna Hart <lhart.opensource@witekio.com> + +description: | + Voltage supervisor and monitor from TI (TPS389006, TPS389008) on I2C bus. + + Datasheets: + https://www.ti.com/lit/ds/symlink/tps389006.pdf + https://www.ti.com/lit/ds/symlink/tps389006-q1.pdf + +properties: + compatible: + enum: + - ti,tps389006 + - ti,tps389008 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + description: NIRQ fault interrupt output (active low). + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + +patternProperties: + "^channel@[0-7]$": + description: + A monitored input. Inputs that are not connected can be marked with + status set to "disabled". + type: object + additionalProperties: false + + properties: + reg: + description: Input index, 0 for MON1 up to 7 for MON8. + enum: [ 0, 1, 2, 3, 4, 5, 6, 7 ] + + label: + description: Name of the input source. + + ti,vrange-multiplier: + description: + Voltage monitoring range of the input. 1 selects 0.2V to 1.475V in + 5mV steps, 4 selects 0.8V to 5.5V in 20mV steps. If absent, the + range programmed in the device is used. + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [ 1, 4 ] + + required: + - reg + +required: + - compatible + - reg + +allOf: + - if: + properties: + compatible: + const: ti,tps389006 + then: + patternProperties: + "^channel@[67]$": false + +additionalProperties: false + +examples: + - | + #include <dt-bindings/interrupt-controller/irq.h> + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + voltage-monitor@30 { + compatible = "ti,tps389008"; + reg = <0x30>; + interrupt-parent = <&gpio1>; + interrupts = <12 IRQ_TYPE_LEVEL_LOW>; + #address-cells = <1>; + #size-cells = <0>; + + channel@0 { + reg = <0x0>; + label = "input0"; + ti,vrange-multiplier = <4>; + }; + + channel@1 { + reg = <0x1>; + label = "input1"; + ti,vrange-multiplier = <1>; + }; + + channel@7 { + reg = <0x7>; + + status = "disabled"; + }; + }; + }; -- 2.47.3 ^ permalink raw reply related [flat|nested] 8+ messages in thread
* Re: [PATCH v2 1/2] dt-bindings: hwmon: Add TI TPS389006/TPS389008 2026-11-17 23:45 ` Luna Hart via B4 Relay (?) @ 2026-11-17 23:48 ` sashiko-bot -1 siblings, 0 replies; 8+ messages in thread From: sashiko-bot @ 2026-11-17 23:48 UTC (permalink / raw) To: Luna Hart; +Cc: linux-hwmon > From: Luna Hart <lhart.opensource@witekio.com> > > Add a binding for the TI TPS389006 and TPS389008 I2C voltage > supervisors and monitors, which provide 6 and 8 voltage inputs > respectively. Each input may be described by an optional child node, > containing additional properties including the label and voltage > monitoring range. Inputs that are not connected can be marked with > status set to "disabled". > > Based on an earlier binding by Flaviu Nistor. > > Signed-off-by: Luna Hart <lhart.opensource@witekio.com> Sashiko has reviewed this patch and found no issues. -- Sashiko AI review · https://sashiko.dev/#/patchset/20261117-lhart-dev-tps38900x-v2-0-e5730523d3ee@witekio.com?part=1 ^ permalink raw reply [flat|nested] 8+ messages in thread
* [PATCH v2 2/2] hwmon: (tps38900x) Add driver for TI TPS389006/TPS389008 2026-11-17 23:45 ` Luna Hart via B4 Relay @ 2026-11-17 23:45 ` Luna Hart via B4 Relay -1 siblings, 0 replies; 8+ messages in thread From: Luna Hart @ 2026-11-17 23:45 UTC (permalink / raw) To: Guenter Roeck, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Jonathan Corbet, Shuah Khan, Randy Dunlap Cc: linux-hwmon, devicetree, linux-kernel, linux-doc, Flaviu Nistor, Uwe Kleine-König, Luna Hart Add support for the TI TPS389006/TPS389008 I2C voltage supervisors and monitors. This initial implementation supports enabling ADC monitoring from the chip and reading back the measured voltage in millivolts. All functionality is provided over sysfs. The voltage range of each channel is taken from the chip configuration, and device tree may be used to further configure each voltage channel. This work is based on an initial implementation by Flaviu Nistor. Signed-off-by: Luna Hart <lhart.opensource@witekio.com> --- Documentation/hwmon/index.rst | 1 + Documentation/hwmon/tps38900x.rst | 80 +++++++++ MAINTAINERS | 8 + drivers/hwmon/Kconfig | 12 ++ drivers/hwmon/Makefile | 1 + drivers/hwmon/tps38900x.c | 361 ++++++++++++++++++++++++++++++++++++++ 6 files changed, 463 insertions(+) diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst index d73d1d5919dde28e45b2daf9eef7b12133b6073e..33d676783bdb3967d8b8732b1332d2aa0757b77e 100644 --- a/Documentation/hwmon/index.rst +++ b/Documentation/hwmon/index.rst @@ -284,6 +284,7 @@ Hardware Monitoring Kernel Drivers tmp513 tps23861 tps25990 + tps38900x tps40422 tps53679 tps546d24 diff --git a/Documentation/hwmon/tps38900x.rst b/Documentation/hwmon/tps38900x.rst new file mode 100644 index 0000000000000000000000000000000000000000..6e5b7153b2710227a00aaf289feb145368267c5c --- /dev/null +++ b/Documentation/hwmon/tps38900x.rst @@ -0,0 +1,80 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later + +Kernel Driver tps38900x +======================= + +Supported chips: + + * Texas Instruments TPS389006 + + Prefix: 'tps389006' + + Addresses scanned: - + + Datasheet: https://www.ti.com/lit/ds/symlink/tps389006.pdf + + * Texas Instruments TPS389008 + + Prefix: 'tps389008' + + Addresses scanned: - + + Datasheet: https://www.ti.com/lit/ds/symlink/tps389006-q1.pdf + +Author: + + - Luna Hart <lhart.opensource@witekio.com> + +Description +----------- + +This driver implements support for the TI TPS38900x family of voltage +supervisors and monitors. Supported chips include the TPS389006 (6 channels) +and TPS389008 (8 channels). + +The driver currently supports reading out current voltage levels from the ADCs. + +All ADC measurements are 8 bit, and there are 2 supported measurement scales. + + - 1x scaling: 200 to 1475 mV (5 mV steps) + - 4x scaling: 800 to 5500 mV (20 mV steps) + +The scale of each channel is taken from the chip configuration at probe time, +unless the device tree selects one with the ti,vrange-multiplier property. +Channels already monitoring at probe time, such as ones enabled by the factory +OTP configuration, keep their scale. + +Channel inN is the MON(N+1) input of the datasheet. By default, all channels +are exposed. A channel can be hidden by setting status = "disabled" in its +device tree child node. + +Known Issues +------------ + +Interrupts, limits/alarms, and sequenced readings functions of the tps38900x +family are not implemented. + +The ADC is stopped while the ACT pin is low, and inX_input then returns +-ENODATA. The ADC is also stopped in DEEP SLEEP, where inX_input returns the +last measured value. + +Sysfs entries +------------- + +The complete list of sysfs attributes provided for each channel. Channels 0-5 +are available on the TPS389006, channels 0-7 on the TPS389008. + +=============================== ======= ======================================== +Name Perm Description +=============================== ======= ======================================== +in[0-7]_input RO Voltage channel input. Returns -ENODATA + if the channel is disabled or the ACT + pin is low. +in[0-7]_label RO Voltage channel label, if set in the + device tree. +in[0-7]_enable RW Voltage channel enable. This controls + the chip's monitoring of the channel, + not only the readout. Read-only if the + configuration registers are write + protected (PROT1/PROT2). +=============================== ======= ======================================== diff --git a/MAINTAINERS b/MAINTAINERS index 610fd1f5568c9107673ae692cdb616d30cc6750d..c896d13f1cf501a6123b5b35e22a4ee8448aa370 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -27808,6 +27808,14 @@ F: Documentation/devicetree/bindings/hwmon/ti,tps23861.yaml F: Documentation/hwmon/tps23861.rst F: drivers/hwmon/tps23861.c +TEXAS INSTRUMENTS TPS38900X VOLTAGE SUPERVISOR DRIVER +M: Luna Hart <lhart.opensource@witekio.com> +L: linux-hwmon@vger.kernel.org +S: Maintained +F: Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml +F: Documentation/hwmon/tps38900x.rst +F: drivers/hwmon/tps38900x.c + TEXAS INSTRUMENTS TPS6131X FLASH LED DRIVER M: Matthias Fend <matthias.fend@emfend.at> L: linux-leds@vger.kernel.org diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig index 98467961f840588c15b601e60972d8d327e76e72..e5e23dc3afb2dced1751d2b2bd9d57d72e57b0e9 100644 --- a/drivers/hwmon/Kconfig +++ b/drivers/hwmon/Kconfig @@ -2622,6 +2622,18 @@ config SENSORS_TMP513 This driver can also be built as a module. If so, the module will be called tmp513. +config SENSORS_TPS38900X + tristate "Texas Instruments TPS389006/TPS389008 voltage supervisors" + depends on I2C + select REGMAP_I2C + help + If you say yes here you get support for Texas Instruments + TPS389006 (6 channels) and TPS389008 (8 channels) voltage + supervisors and monitors. + + This driver can also be built as a module. If so, the module + will be called tps38900x. + config SENSORS_TSC1641 tristate "ST Microelectronics TSC1641 Power Monitor" depends on I2C diff --git a/drivers/hwmon/Makefile b/drivers/hwmon/Makefile index f49aee1045e21280321a9861b37da401426facd7..2a6cef6777ee7b635d3883506fdef4ccbf9e2e7f 100644 --- a/drivers/hwmon/Makefile +++ b/drivers/hwmon/Makefile @@ -248,6 +248,7 @@ obj-$(CONFIG_SENSORS_TMP401) += tmp401.o obj-$(CONFIG_SENSORS_TMP421) += tmp421.o obj-$(CONFIG_SENSORS_TMP464) += tmp464.o obj-$(CONFIG_SENSORS_TMP513) += tmp513.o +obj-$(CONFIG_SENSORS_TPS38900X) += tps38900x.o obj-$(CONFIG_SENSORS_TSC1641) += tsc1641.o obj-$(CONFIG_SENSORS_VEXPRESS) += vexpress-hwmon.o obj-$(CONFIG_SENSORS_VIA_CPUTEMP)+= via-cputemp.o diff --git a/drivers/hwmon/tps38900x.c b/drivers/hwmon/tps38900x.c new file mode 100644 index 0000000000000000000000000000000000000000..ff29467d0f55aef3941fb26b7e2788fcdd5ce51e --- /dev/null +++ b/drivers/hwmon/tps38900x.c @@ -0,0 +1,361 @@ +// SPDX-License-Identifier: GPL-2.0-or-later +/* + * Driver for Texas Instruments TPS389006/TPS389008 i2c voltage + * supervisor and monitor. + * + * Author: Luna Hart <lhart.opensource@witekio.com> + * + * Datasheet: https://www.ti.com/lit/ds/symlink/tps389006.pdf + * Datasheet: https://www.ti.com/lit/ds/symlink/tps389006-q1.pdf + */ + +#include <linux/bitops.h> +#include <linux/bits.h> +#include <linux/hwmon.h> +#include <linux/i2c.h> +#include <linux/module.h> +#include <linux/of.h> +#include <linux/regmap.h> + +#define TPS38900X_MAX_CHANNELS 8 +#define TPS38900X_BANK_LEN 0x100 + +/* Registers, stored over 2 banks of 256 bytes. */ +#define TPS38900X_VMON_STAT 0x30 +#define TPS38900X_MON_LVL(ch) (0x40 + (ch)) +#define TPS38900X_BANK_SEL 0xf0 +#define TPS38900X_PROT1 0xf1 +#define TPS38900X_PROT2 0xf2 +#define TPS38900X_MON_CH_EN 0x11e +#define TPS38900X_VRANGE_MULT 0x11f + +/* ACT pin state, the ADC is stopped while it is low */ +#define TPS38900X_ST_ACTSHDN BIT(2) + +/* Write protection groups, locked when set in both PROT1 and PROT2. */ +#define TPS38900X_PROT_CFG BIT(3) + +#define TPS38900X_LSB_MV 5 +#define TPS38900X_OFFSET_MV 200 + +struct tps38900x_data { + struct regmap *regmap; + const char *label[TPS38900X_MAX_CHANNELS]; + /* bitmask of channels exposed through hwmon */ + u8 channel_present; + /* write protected register groups */ + u8 prot; +}; + +static umode_t tps38900x_is_visible(const void *data, + enum hwmon_sensor_types type, u32 attr, + int channel) +{ + const struct tps38900x_data *priv = data; + + if (!(priv->channel_present & BIT(channel))) + return 0; + + switch (attr) { + case hwmon_in_input: + return 0444; + case hwmon_in_enable: + return priv->prot & TPS38900X_PROT_CFG ? 0444 : 0644; + case hwmon_in_label: + return priv->label[channel] ? 0444 : 0; + } + + return 0; +} + +static int tps38900x_read(struct device *dev, enum hwmon_sensor_types type, + u32 attr, int channel, long *val) +{ + struct tps38900x_data *priv = dev_get_drvdata(dev); + unsigned int regval, vrange; + int ret; + + switch (attr) { + case hwmon_in_input: + ret = regmap_read(priv->regmap, TPS38900X_MON_CH_EN, ®val); + if (ret) + return ret; + + if (!(regval & BIT(channel))) + return -ENODATA; + + ret = regmap_read(priv->regmap, TPS38900X_VMON_STAT, ®val); + if (ret) + return ret; + + if (!(regval & TPS38900X_ST_ACTSHDN)) + return -ENODATA; + + ret = regmap_read(priv->regmap, TPS38900X_VRANGE_MULT, &vrange); + if (ret) + return ret; + + ret = regmap_read(priv->regmap, TPS38900X_MON_LVL(channel), + ®val); + if (ret) + return ret; + + *val = regval * TPS38900X_LSB_MV + TPS38900X_OFFSET_MV; + if (vrange & BIT(channel)) + *val *= 4; + return 0; + case hwmon_in_enable: + ret = regmap_read(priv->regmap, TPS38900X_MON_CH_EN, ®val); + if (ret) + return ret; + + *val = !!(regval & BIT(channel)); + return 0; + } + + return -EOPNOTSUPP; +} + +static int tps38900x_write(struct device *dev, enum hwmon_sensor_types type, + u32 attr, int channel, long enable) +{ + struct tps38900x_data *priv = dev_get_drvdata(dev); + + switch (attr) { + case hwmon_in_enable: + if (enable != 0 && enable != 1) + return -EINVAL; + + return regmap_update_bits(priv->regmap, TPS38900X_MON_CH_EN, + BIT(channel), + enable ? BIT(channel) : 0); + } + + return -EOPNOTSUPP; +} + +static int tps38900x_read_string(struct device *dev, + enum hwmon_sensor_types type, u32 attr, + int channel, const char **str) +{ + struct tps38900x_data *priv = dev_get_drvdata(dev); + + switch (attr) { + case hwmon_in_label: + *str = priv->label[channel]; + return 0; + } + + return -EOPNOTSUPP; +} + +static const struct hwmon_ops tps38900x_hwmon_ops = { + .is_visible = tps38900x_is_visible, + .read = tps38900x_read, + .write = tps38900x_write, + .read_string = tps38900x_read_string, +}; + +#define TPS38900X_IN_CONFIG (HWMON_I_INPUT | HWMON_I_ENABLE | HWMON_I_LABEL) + +static const struct hwmon_channel_info *const tps38900x_info[] = { + HWMON_CHANNEL_INFO(in, TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG, + TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG, + TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG, + TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG), + NULL +}; + +static const struct hwmon_chip_info tps38900x_chip_info = { + .ops = &tps38900x_hwmon_ops, + .info = tps38900x_info, +}; + +static const struct regmap_range_cfg tps38900x_bank_range = { + .name = "tps38900x-mem-bank", + .range_min = 0x00, + .range_max = 2 * TPS38900X_BANK_LEN - 1, + .selector_reg = TPS38900X_BANK_SEL, + .selector_mask = BIT(0), + .window_start = 0, + .window_len = TPS38900X_BANK_LEN, +}; + +static bool tps38900x_volatile_reg(struct device *dev, unsigned int reg) +{ + if (reg == TPS38900X_VMON_STAT) + return true; + + /* ADC results region is volatile */ + if (reg >= TPS38900X_MON_LVL(0) && + reg < TPS38900X_MON_LVL(TPS38900X_MAX_CHANNELS)) + return true; + + return false; +} + +static const struct regmap_config tps38900x_regmap_config = { + .reg_bits = 8, + .val_bits = 8, + .max_register = 2 * TPS38900X_BANK_LEN - 1, + .ranges = &tps38900x_bank_range, + .num_ranges = 1, + .volatile_reg = tps38900x_volatile_reg, + .cache_type = REGCACHE_MAPLE, +}; + +static int tps38900x_parse_dt_channels(struct device *dev, + struct tps38900x_data *priv, + unsigned int num_channels, + u8 *range_set, u8 *range_4x) +{ + u32 reg, mult; + int ret; + + /* All channels are exposed unless their DT node is disabled. */ + priv->channel_present = GENMASK(num_channels - 1, 0); + + /* Walk disabled nodes too, the fwnode iterators would skip them. */ + for_each_child_of_node_scoped(dev->of_node, child) { + ret = of_property_read_u32(child, "reg", ®); + if (ret) + return dev_err_probe(dev, ret, + "missing reg property\n"); + + if (reg >= num_channels) + return dev_err_probe(dev, -EINVAL, + "reg out of range: %u (max %u)\n", + reg, num_channels - 1); + + if (!of_device_is_available(child)) { + priv->channel_present &= ~BIT(reg); + continue; + } + + if (!of_property_read_u32(child, "ti,vrange-multiplier", + &mult)) { + if (mult != 1 && mult != 4) + return dev_err_probe(dev, -EINVAL, + "invalid ti,vrange-multiplier: %u\n", + mult); + *range_set |= BIT(reg); + if (mult == 4) + *range_4x |= BIT(reg); + } + + of_property_read_string(child, "label", &priv->label[reg]); + } + + return 0; +} + +static int tps38900x_probe(struct i2c_client *client) +{ + struct device *dev = &client->dev; + struct tps38900x_data *priv; + struct device *hwmon_dev; + unsigned int num_channels, prot1, prot2, vrange, mon_en; + u8 range_set = 0, range_4x = 0; + unsigned long ignored; + unsigned int ch; + u8 change; + int ret; + + if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_BYTE_DATA)) + return -ENODEV; + + num_channels = (uintptr_t)i2c_get_match_data(client); + if (!num_channels) + return dev_err_probe(dev, -ENODEV, "unsupported device\n"); + + priv = devm_kzalloc_obj(dev, *priv); + if (!priv) + return -ENOMEM; + + priv->regmap = devm_regmap_init_i2c(client, &tps38900x_regmap_config); + if (IS_ERR(priv->regmap)) + return dev_err_probe(dev, PTR_ERR(priv->regmap), + "failed to allocate register map\n"); + + ret = regmap_read(priv->regmap, TPS38900X_PROT1, &prot1); + if (!ret) + ret = regmap_read(priv->regmap, TPS38900X_PROT2, &prot2); + if (ret) + return dev_err_probe(dev, ret, + "failed to read write protection\n"); + priv->prot = prot1 & prot2; + + ret = regmap_read(priv->regmap, TPS38900X_VRANGE_MULT, &vrange); + if (ret) + return dev_err_probe(dev, ret, + "failed to read voltage range\n"); + + ret = regmap_read(priv->regmap, TPS38900X_MON_CH_EN, &mon_en); + if (ret) + return dev_err_probe(dev, ret, + "failed to read channel enables\n"); + + ret = tps38900x_parse_dt_channels(dev, priv, num_channels, + &range_set, &range_4x); + if (ret) + return ret; + + /* Channels without a DT range keep the one the chip is programmed with. */ + change = (vrange ^ range_4x) & range_set; + + /* + * Changing the range of a monitored channel changes the meaning of its + * thresholds and can trigger a fault, so leave it as is. + */ + ignored = change & mon_en; + for_each_set_bit(ch, &ignored, TPS38900X_MAX_CHANNELS) + dev_warn(dev, "channel %u is monitoring, ignoring ti,vrange-multiplier\n", + ch); + change &= ~ignored; + + if (change && (priv->prot & TPS38900X_PROT_CFG)) { + dev_warn(dev, "voltage range is write protected\n"); + change = 0; + } + + if (change) { + ret = regmap_update_bits(priv->regmap, TPS38900X_VRANGE_MULT, + change, range_4x); + if (ret) + return dev_err_probe(dev, ret, + "failed to write voltage range\n"); + } + + hwmon_dev = devm_hwmon_device_register_with_info(dev, client->name, priv, + &tps38900x_chip_info, NULL); + + return PTR_ERR_OR_ZERO(hwmon_dev); +} + +static const struct i2c_device_id tps38900x_id[] = { + { .name = "tps389006", .driver_data = 6 }, + { .name = "tps389008", .driver_data = 8 }, + { } +}; +MODULE_DEVICE_TABLE(i2c, tps38900x_id); + +static const struct of_device_id tps38900x_of_match[] = { + { .compatible = "ti,tps389006", .data = (void *)6 }, + { .compatible = "ti,tps389008", .data = (void *)8 }, + { } +}; +MODULE_DEVICE_TABLE(of, tps38900x_of_match); + +static struct i2c_driver tps38900x_driver = { + .driver = { + .name = "tps38900x", + .of_match_table = tps38900x_of_match, + }, + .probe = tps38900x_probe, + .id_table = tps38900x_id, +}; +module_i2c_driver(tps38900x_driver); + +MODULE_AUTHOR("Luna Hart <lhart.opensource@witekio.com>"); +MODULE_DESCRIPTION("TI TPS389006/TPS389008 voltage supervisor and monitor driver"); +MODULE_LICENSE("GPL"); -- 2.47.3 ^ permalink raw reply related [flat|nested] 8+ messages in thread
* [PATCH v2 2/2] hwmon: (tps38900x) Add driver for TI TPS389006/TPS389008 @ 2026-11-17 23:45 ` Luna Hart via B4 Relay 0 siblings, 0 replies; 8+ messages in thread From: Luna Hart via B4 Relay @ 2026-11-17 23:45 UTC (permalink / raw) To: Guenter Roeck, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Jonathan Corbet, Shuah Khan, Randy Dunlap Cc: linux-hwmon, devicetree, linux-kernel, linux-doc, Flaviu Nistor, Uwe Kleine-König, Luna Hart From: Luna Hart <lhart.opensource@witekio.com> Add support for the TI TPS389006/TPS389008 I2C voltage supervisors and monitors. This initial implementation supports enabling ADC monitoring from the chip and reading back the measured voltage in millivolts. All functionality is provided over sysfs. The voltage range of each channel is taken from the chip configuration, and device tree may be used to further configure each voltage channel. This work is based on an initial implementation by Flaviu Nistor. Signed-off-by: Luna Hart <lhart.opensource@witekio.com> --- Documentation/hwmon/index.rst | 1 + Documentation/hwmon/tps38900x.rst | 80 +++++++++ MAINTAINERS | 8 + drivers/hwmon/Kconfig | 12 ++ drivers/hwmon/Makefile | 1 + drivers/hwmon/tps38900x.c | 361 ++++++++++++++++++++++++++++++++++++++ 6 files changed, 463 insertions(+) diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst index d73d1d5919dde28e45b2daf9eef7b12133b6073e..33d676783bdb3967d8b8732b1332d2aa0757b77e 100644 --- a/Documentation/hwmon/index.rst +++ b/Documentation/hwmon/index.rst @@ -284,6 +284,7 @@ Hardware Monitoring Kernel Drivers tmp513 tps23861 tps25990 + tps38900x tps40422 tps53679 tps546d24 diff --git a/Documentation/hwmon/tps38900x.rst b/Documentation/hwmon/tps38900x.rst new file mode 100644 index 0000000000000000000000000000000000000000..6e5b7153b2710227a00aaf289feb145368267c5c --- /dev/null +++ b/Documentation/hwmon/tps38900x.rst @@ -0,0 +1,80 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later + +Kernel Driver tps38900x +======================= + +Supported chips: + + * Texas Instruments TPS389006 + + Prefix: 'tps389006' + + Addresses scanned: - + + Datasheet: https://www.ti.com/lit/ds/symlink/tps389006.pdf + + * Texas Instruments TPS389008 + + Prefix: 'tps389008' + + Addresses scanned: - + + Datasheet: https://www.ti.com/lit/ds/symlink/tps389006-q1.pdf + +Author: + + - Luna Hart <lhart.opensource@witekio.com> + +Description +----------- + +This driver implements support for the TI TPS38900x family of voltage +supervisors and monitors. Supported chips include the TPS389006 (6 channels) +and TPS389008 (8 channels). + +The driver currently supports reading out current voltage levels from the ADCs. + +All ADC measurements are 8 bit, and there are 2 supported measurement scales. + + - 1x scaling: 200 to 1475 mV (5 mV steps) + - 4x scaling: 800 to 5500 mV (20 mV steps) + +The scale of each channel is taken from the chip configuration at probe time, +unless the device tree selects one with the ti,vrange-multiplier property. +Channels already monitoring at probe time, such as ones enabled by the factory +OTP configuration, keep their scale. + +Channel inN is the MON(N+1) input of the datasheet. By default, all channels +are exposed. A channel can be hidden by setting status = "disabled" in its +device tree child node. + +Known Issues +------------ + +Interrupts, limits/alarms, and sequenced readings functions of the tps38900x +family are not implemented. + +The ADC is stopped while the ACT pin is low, and inX_input then returns +-ENODATA. The ADC is also stopped in DEEP SLEEP, where inX_input returns the +last measured value. + +Sysfs entries +------------- + +The complete list of sysfs attributes provided for each channel. Channels 0-5 +are available on the TPS389006, channels 0-7 on the TPS389008. + +=============================== ======= ======================================== +Name Perm Description +=============================== ======= ======================================== +in[0-7]_input RO Voltage channel input. Returns -ENODATA + if the channel is disabled or the ACT + pin is low. +in[0-7]_label RO Voltage channel label, if set in the + device tree. +in[0-7]_enable RW Voltage channel enable. This controls + the chip's monitoring of the channel, + not only the readout. Read-only if the + configuration registers are write + protected (PROT1/PROT2). +=============================== ======= ======================================== diff --git a/MAINTAINERS b/MAINTAINERS index 610fd1f5568c9107673ae692cdb616d30cc6750d..c896d13f1cf501a6123b5b35e22a4ee8448aa370 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -27808,6 +27808,14 @@ F: Documentation/devicetree/bindings/hwmon/ti,tps23861.yaml F: Documentation/hwmon/tps23861.rst F: drivers/hwmon/tps23861.c +TEXAS INSTRUMENTS TPS38900X VOLTAGE SUPERVISOR DRIVER +M: Luna Hart <lhart.opensource@witekio.com> +L: linux-hwmon@vger.kernel.org +S: Maintained +F: Documentation/devicetree/bindings/hwmon/ti,tps389006.yaml +F: Documentation/hwmon/tps38900x.rst +F: drivers/hwmon/tps38900x.c + TEXAS INSTRUMENTS TPS6131X FLASH LED DRIVER M: Matthias Fend <matthias.fend@emfend.at> L: linux-leds@vger.kernel.org diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig index 98467961f840588c15b601e60972d8d327e76e72..e5e23dc3afb2dced1751d2b2bd9d57d72e57b0e9 100644 --- a/drivers/hwmon/Kconfig +++ b/drivers/hwmon/Kconfig @@ -2622,6 +2622,18 @@ config SENSORS_TMP513 This driver can also be built as a module. If so, the module will be called tmp513. +config SENSORS_TPS38900X + tristate "Texas Instruments TPS389006/TPS389008 voltage supervisors" + depends on I2C + select REGMAP_I2C + help + If you say yes here you get support for Texas Instruments + TPS389006 (6 channels) and TPS389008 (8 channels) voltage + supervisors and monitors. + + This driver can also be built as a module. If so, the module + will be called tps38900x. + config SENSORS_TSC1641 tristate "ST Microelectronics TSC1641 Power Monitor" depends on I2C diff --git a/drivers/hwmon/Makefile b/drivers/hwmon/Makefile index f49aee1045e21280321a9861b37da401426facd7..2a6cef6777ee7b635d3883506fdef4ccbf9e2e7f 100644 --- a/drivers/hwmon/Makefile +++ b/drivers/hwmon/Makefile @@ -248,6 +248,7 @@ obj-$(CONFIG_SENSORS_TMP401) += tmp401.o obj-$(CONFIG_SENSORS_TMP421) += tmp421.o obj-$(CONFIG_SENSORS_TMP464) += tmp464.o obj-$(CONFIG_SENSORS_TMP513) += tmp513.o +obj-$(CONFIG_SENSORS_TPS38900X) += tps38900x.o obj-$(CONFIG_SENSORS_TSC1641) += tsc1641.o obj-$(CONFIG_SENSORS_VEXPRESS) += vexpress-hwmon.o obj-$(CONFIG_SENSORS_VIA_CPUTEMP)+= via-cputemp.o diff --git a/drivers/hwmon/tps38900x.c b/drivers/hwmon/tps38900x.c new file mode 100644 index 0000000000000000000000000000000000000000..ff29467d0f55aef3941fb26b7e2788fcdd5ce51e --- /dev/null +++ b/drivers/hwmon/tps38900x.c @@ -0,0 +1,361 @@ +// SPDX-License-Identifier: GPL-2.0-or-later +/* + * Driver for Texas Instruments TPS389006/TPS389008 i2c voltage + * supervisor and monitor. + * + * Author: Luna Hart <lhart.opensource@witekio.com> + * + * Datasheet: https://www.ti.com/lit/ds/symlink/tps389006.pdf + * Datasheet: https://www.ti.com/lit/ds/symlink/tps389006-q1.pdf + */ + +#include <linux/bitops.h> +#include <linux/bits.h> +#include <linux/hwmon.h> +#include <linux/i2c.h> +#include <linux/module.h> +#include <linux/of.h> +#include <linux/regmap.h> + +#define TPS38900X_MAX_CHANNELS 8 +#define TPS38900X_BANK_LEN 0x100 + +/* Registers, stored over 2 banks of 256 bytes. */ +#define TPS38900X_VMON_STAT 0x30 +#define TPS38900X_MON_LVL(ch) (0x40 + (ch)) +#define TPS38900X_BANK_SEL 0xf0 +#define TPS38900X_PROT1 0xf1 +#define TPS38900X_PROT2 0xf2 +#define TPS38900X_MON_CH_EN 0x11e +#define TPS38900X_VRANGE_MULT 0x11f + +/* ACT pin state, the ADC is stopped while it is low */ +#define TPS38900X_ST_ACTSHDN BIT(2) + +/* Write protection groups, locked when set in both PROT1 and PROT2. */ +#define TPS38900X_PROT_CFG BIT(3) + +#define TPS38900X_LSB_MV 5 +#define TPS38900X_OFFSET_MV 200 + +struct tps38900x_data { + struct regmap *regmap; + const char *label[TPS38900X_MAX_CHANNELS]; + /* bitmask of channels exposed through hwmon */ + u8 channel_present; + /* write protected register groups */ + u8 prot; +}; + +static umode_t tps38900x_is_visible(const void *data, + enum hwmon_sensor_types type, u32 attr, + int channel) +{ + const struct tps38900x_data *priv = data; + + if (!(priv->channel_present & BIT(channel))) + return 0; + + switch (attr) { + case hwmon_in_input: + return 0444; + case hwmon_in_enable: + return priv->prot & TPS38900X_PROT_CFG ? 0444 : 0644; + case hwmon_in_label: + return priv->label[channel] ? 0444 : 0; + } + + return 0; +} + +static int tps38900x_read(struct device *dev, enum hwmon_sensor_types type, + u32 attr, int channel, long *val) +{ + struct tps38900x_data *priv = dev_get_drvdata(dev); + unsigned int regval, vrange; + int ret; + + switch (attr) { + case hwmon_in_input: + ret = regmap_read(priv->regmap, TPS38900X_MON_CH_EN, ®val); + if (ret) + return ret; + + if (!(regval & BIT(channel))) + return -ENODATA; + + ret = regmap_read(priv->regmap, TPS38900X_VMON_STAT, ®val); + if (ret) + return ret; + + if (!(regval & TPS38900X_ST_ACTSHDN)) + return -ENODATA; + + ret = regmap_read(priv->regmap, TPS38900X_VRANGE_MULT, &vrange); + if (ret) + return ret; + + ret = regmap_read(priv->regmap, TPS38900X_MON_LVL(channel), + ®val); + if (ret) + return ret; + + *val = regval * TPS38900X_LSB_MV + TPS38900X_OFFSET_MV; + if (vrange & BIT(channel)) + *val *= 4; + return 0; + case hwmon_in_enable: + ret = regmap_read(priv->regmap, TPS38900X_MON_CH_EN, ®val); + if (ret) + return ret; + + *val = !!(regval & BIT(channel)); + return 0; + } + + return -EOPNOTSUPP; +} + +static int tps38900x_write(struct device *dev, enum hwmon_sensor_types type, + u32 attr, int channel, long enable) +{ + struct tps38900x_data *priv = dev_get_drvdata(dev); + + switch (attr) { + case hwmon_in_enable: + if (enable != 0 && enable != 1) + return -EINVAL; + + return regmap_update_bits(priv->regmap, TPS38900X_MON_CH_EN, + BIT(channel), + enable ? BIT(channel) : 0); + } + + return -EOPNOTSUPP; +} + +static int tps38900x_read_string(struct device *dev, + enum hwmon_sensor_types type, u32 attr, + int channel, const char **str) +{ + struct tps38900x_data *priv = dev_get_drvdata(dev); + + switch (attr) { + case hwmon_in_label: + *str = priv->label[channel]; + return 0; + } + + return -EOPNOTSUPP; +} + +static const struct hwmon_ops tps38900x_hwmon_ops = { + .is_visible = tps38900x_is_visible, + .read = tps38900x_read, + .write = tps38900x_write, + .read_string = tps38900x_read_string, +}; + +#define TPS38900X_IN_CONFIG (HWMON_I_INPUT | HWMON_I_ENABLE | HWMON_I_LABEL) + +static const struct hwmon_channel_info *const tps38900x_info[] = { + HWMON_CHANNEL_INFO(in, TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG, + TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG, + TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG, + TPS38900X_IN_CONFIG, TPS38900X_IN_CONFIG), + NULL +}; + +static const struct hwmon_chip_info tps38900x_chip_info = { + .ops = &tps38900x_hwmon_ops, + .info = tps38900x_info, +}; + +static const struct regmap_range_cfg tps38900x_bank_range = { + .name = "tps38900x-mem-bank", + .range_min = 0x00, + .range_max = 2 * TPS38900X_BANK_LEN - 1, + .selector_reg = TPS38900X_BANK_SEL, + .selector_mask = BIT(0), + .window_start = 0, + .window_len = TPS38900X_BANK_LEN, +}; + +static bool tps38900x_volatile_reg(struct device *dev, unsigned int reg) +{ + if (reg == TPS38900X_VMON_STAT) + return true; + + /* ADC results region is volatile */ + if (reg >= TPS38900X_MON_LVL(0) && + reg < TPS38900X_MON_LVL(TPS38900X_MAX_CHANNELS)) + return true; + + return false; +} + +static const struct regmap_config tps38900x_regmap_config = { + .reg_bits = 8, + .val_bits = 8, + .max_register = 2 * TPS38900X_BANK_LEN - 1, + .ranges = &tps38900x_bank_range, + .num_ranges = 1, + .volatile_reg = tps38900x_volatile_reg, + .cache_type = REGCACHE_MAPLE, +}; + +static int tps38900x_parse_dt_channels(struct device *dev, + struct tps38900x_data *priv, + unsigned int num_channels, + u8 *range_set, u8 *range_4x) +{ + u32 reg, mult; + int ret; + + /* All channels are exposed unless their DT node is disabled. */ + priv->channel_present = GENMASK(num_channels - 1, 0); + + /* Walk disabled nodes too, the fwnode iterators would skip them. */ + for_each_child_of_node_scoped(dev->of_node, child) { + ret = of_property_read_u32(child, "reg", ®); + if (ret) + return dev_err_probe(dev, ret, + "missing reg property\n"); + + if (reg >= num_channels) + return dev_err_probe(dev, -EINVAL, + "reg out of range: %u (max %u)\n", + reg, num_channels - 1); + + if (!of_device_is_available(child)) { + priv->channel_present &= ~BIT(reg); + continue; + } + + if (!of_property_read_u32(child, "ti,vrange-multiplier", + &mult)) { + if (mult != 1 && mult != 4) + return dev_err_probe(dev, -EINVAL, + "invalid ti,vrange-multiplier: %u\n", + mult); + *range_set |= BIT(reg); + if (mult == 4) + *range_4x |= BIT(reg); + } + + of_property_read_string(child, "label", &priv->label[reg]); + } + + return 0; +} + +static int tps38900x_probe(struct i2c_client *client) +{ + struct device *dev = &client->dev; + struct tps38900x_data *priv; + struct device *hwmon_dev; + unsigned int num_channels, prot1, prot2, vrange, mon_en; + u8 range_set = 0, range_4x = 0; + unsigned long ignored; + unsigned int ch; + u8 change; + int ret; + + if (!i2c_check_functionality(client->adapter, I2C_FUNC_SMBUS_BYTE_DATA)) + return -ENODEV; + + num_channels = (uintptr_t)i2c_get_match_data(client); + if (!num_channels) + return dev_err_probe(dev, -ENODEV, "unsupported device\n"); + + priv = devm_kzalloc_obj(dev, *priv); + if (!priv) + return -ENOMEM; + + priv->regmap = devm_regmap_init_i2c(client, &tps38900x_regmap_config); + if (IS_ERR(priv->regmap)) + return dev_err_probe(dev, PTR_ERR(priv->regmap), + "failed to allocate register map\n"); + + ret = regmap_read(priv->regmap, TPS38900X_PROT1, &prot1); + if (!ret) + ret = regmap_read(priv->regmap, TPS38900X_PROT2, &prot2); + if (ret) + return dev_err_probe(dev, ret, + "failed to read write protection\n"); + priv->prot = prot1 & prot2; + + ret = regmap_read(priv->regmap, TPS38900X_VRANGE_MULT, &vrange); + if (ret) + return dev_err_probe(dev, ret, + "failed to read voltage range\n"); + + ret = regmap_read(priv->regmap, TPS38900X_MON_CH_EN, &mon_en); + if (ret) + return dev_err_probe(dev, ret, + "failed to read channel enables\n"); + + ret = tps38900x_parse_dt_channels(dev, priv, num_channels, + &range_set, &range_4x); + if (ret) + return ret; + + /* Channels without a DT range keep the one the chip is programmed with. */ + change = (vrange ^ range_4x) & range_set; + + /* + * Changing the range of a monitored channel changes the meaning of its + * thresholds and can trigger a fault, so leave it as is. + */ + ignored = change & mon_en; + for_each_set_bit(ch, &ignored, TPS38900X_MAX_CHANNELS) + dev_warn(dev, "channel %u is monitoring, ignoring ti,vrange-multiplier\n", + ch); + change &= ~ignored; + + if (change && (priv->prot & TPS38900X_PROT_CFG)) { + dev_warn(dev, "voltage range is write protected\n"); + change = 0; + } + + if (change) { + ret = regmap_update_bits(priv->regmap, TPS38900X_VRANGE_MULT, + change, range_4x); + if (ret) + return dev_err_probe(dev, ret, + "failed to write voltage range\n"); + } + + hwmon_dev = devm_hwmon_device_register_with_info(dev, client->name, priv, + &tps38900x_chip_info, NULL); + + return PTR_ERR_OR_ZERO(hwmon_dev); +} + +static const struct i2c_device_id tps38900x_id[] = { + { .name = "tps389006", .driver_data = 6 }, + { .name = "tps389008", .driver_data = 8 }, + { } +}; +MODULE_DEVICE_TABLE(i2c, tps38900x_id); + +static const struct of_device_id tps38900x_of_match[] = { + { .compatible = "ti,tps389006", .data = (void *)6 }, + { .compatible = "ti,tps389008", .data = (void *)8 }, + { } +}; +MODULE_DEVICE_TABLE(of, tps38900x_of_match); + +static struct i2c_driver tps38900x_driver = { + .driver = { + .name = "tps38900x", + .of_match_table = tps38900x_of_match, + }, + .probe = tps38900x_probe, + .id_table = tps38900x_id, +}; +module_i2c_driver(tps38900x_driver); + +MODULE_AUTHOR("Luna Hart <lhart.opensource@witekio.com>"); +MODULE_DESCRIPTION("TI TPS389006/TPS389008 voltage supervisor and monitor driver"); +MODULE_LICENSE("GPL"); -- 2.47.3 ^ permalink raw reply related [flat|nested] 8+ messages in thread
* Re: [PATCH v2 2/2] hwmon: (tps38900x) Add driver for TI TPS389006/TPS389008 2026-11-17 23:45 ` Luna Hart via B4 Relay (?) @ 2026-11-17 23:51 ` sashiko-bot -1 siblings, 0 replies; 8+ messages in thread From: sashiko-bot @ 2026-11-17 23:51 UTC (permalink / raw) To: Luna Hart; +Cc: linux-hwmon > From: Luna Hart <lhart.opensource@witekio.com> > > Add support for the TI TPS389006/TPS389008 I2C voltage supervisors and > monitors. This initial implementation supports enabling ADC monitoring > from the chip and reading back the measured voltage in millivolts. All > functionality is provided over sysfs. The voltage range of each channel > is taken from the chip configuration, and device tree may be used to > further configure each voltage channel. > > This work is based on an initial implementation by Flaviu Nistor. > > Signed-off-by: Luna Hart <lhart.opensource@witekio.com> Sashiko has reviewed this patch and found no issues. -- Sashiko AI review · https://sashiko.dev/#/patchset/20261117-lhart-dev-tps38900x-v2-0-e5730523d3ee@witekio.com?part=2 ^ permalink raw reply [flat|nested] 8+ messages in thread
end of thread, other threads:[~2026-11-17 23:51 UTC | newest] Thread overview: 8+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2026-11-17 23:45 [PATCH v2 0/2] hwmon: Add support for TI TPS389006/TPS389008 Luna Hart 2026-11-17 23:45 ` Luna Hart via B4 Relay 2026-11-17 23:45 ` [PATCH v2 1/2] dt-bindings: hwmon: Add " Luna Hart 2026-11-17 23:45 ` Luna Hart via B4 Relay 2026-11-17 23:48 ` sashiko-bot 2026-11-17 23:45 ` [PATCH v2 2/2] hwmon: (tps38900x) Add driver for " Luna Hart 2026-11-17 23:45 ` Luna Hart via B4 Relay 2026-11-17 23:51 ` sashiko-bot
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.