Skip to content

Commit

Permalink
hwmon: (pmbus/lt3074): add support for lt3074
Browse files Browse the repository at this point in the history
Add hardware monitoring and regulator support for LT3074. The LT3074 is an
ultrafast, ultralow noise 3A, 5.5V dropout linear regulator. The PMBus
serial interface allows telemetry for input/output voltage, bias voltage,
output current, and die temperature.

Signed-off-by: Cedric Encarnacion <[email protected]>
  • Loading branch information
cencarna committed Jan 7, 2025
1 parent 31c7598 commit b2caddb
Show file tree
Hide file tree
Showing 5 changed files with 233 additions and 0 deletions.
1 change: 1 addition & 0 deletions Documentation/hwmon/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,7 @@ Hardware Monitoring Kernel Drivers
lm95234
lm95245
lochnagar
lt3074
lt7182s
ltc2992
ltc2945
Expand Down
72 changes: 72 additions & 0 deletions Documentation/hwmon/lt3074.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
.. SPDX-License-Identifier: GPL-2.0
Kernel driver lt3074
=====================

Supported chips:

* Analog Devices LT3074

Prefix: 'lt3074'

Addresses scanned: -

Datasheet: https://www.analog.com/en/products/lt3074.html

Authors: Cedric Encarnacion <[email protected]>


Description
-----------

This driver supports hardware monitoring for Analog Devices LT3074 Linear
Regulator with PMBus interface.

The LT3074 is a low voltage, ultra-low noise and ultra-fast transient
response linear regulator with PMBus serial interface. PMBus telemetry
feature provides information regarding the output voltage and current,
input voltage, bias voltage and die temperature.

The driver is a client driver to the core PMBus driver. Please see
Documentation/hwmon/pmbus.rst for details on PMBus client drivers.

Usage Notes
-----------

This driver does not auto-detect devices. You will have to instantiate
the devices explicitly. Please see Documentation/i2c/instantiating-devices.rst
for details.

Platform data support
---------------------

The driver supports standard PMBus driver platform data.

Sysfs entries
----------------

================= ========================================
in1_label "vin"
in1_input Measured input voltage
in1_max Input overvoltage warning limit
in1_max_alarm Input overvoltage warning status
in1_min Input undervoltage warning limit
in1_min_alarm Input undervoltage warning status
in2_label "vmon"
in2_input Measured bias voltage
in2_max Bias overvoltage warning limit
in2_min Bias undervoltage warning limit
in3_label "vout1"
in3_input Measured output voltage
in3_max Output overvoltage warning limit
in3_max_alarm Output overvoltage warning status
in3_min Output undervoltage warning limit
in3_min_alarm Output undervoltage warning status
curr1_label "iout1"
curr1_input Measured output current.
curr1_crit Output overcurrent fault limit
curr1_crit_alarm Output overcurrent fault status
temp1_input Measured temperature
temp1_max Maximum temperature limit
temp1_max_alarm Overtemperature warning status
================= ========================================
18 changes: 18 additions & 0 deletions drivers/hwmon/pmbus/Kconfig
Original file line number Diff line number Diff line change
Expand Up @@ -200,6 +200,24 @@ config SENSORS_LM25066_REGULATOR
If you say yes here you get regulator support for National
Semiconductor LM25066, LM5064, and LM5066.

config SENSORS_LT3074
tristate "Analog Devices LT3074"
help
If you say yes here you get hardware monitoring support for Analog
Devices LT3074.

This driver can also be built as a module. If so, the module will
be called lt3074.

config SENSORS_LT3074_REGULATOR
tristate "Regulator support for LT3074"
depends on SENSORS_LT3074 && REGULATOR
help
If you say yes here you get regulator support for Analog Devices
LT3074. The LT3074 is a low voltage, ultralow noise, high PSRR,
dropout linear regulator. The device supplies up to 3A with a
typical dropout voltage of 45mV.

config SENSORS_LT7182S
tristate "Analog Devices LT7182S"
help
Expand Down
1 change: 1 addition & 0 deletions drivers/hwmon/pmbus/Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ obj-$(CONFIG_SENSORS_IR38064) += ir38064.o
obj-$(CONFIG_SENSORS_IRPS5401) += irps5401.o
obj-$(CONFIG_SENSORS_ISL68137) += isl68137.o
obj-$(CONFIG_SENSORS_LM25066) += lm25066.o
obj-$(CONFIG_SENSORS_LT3074) += lt3074.o
obj-$(CONFIG_SENSORS_LT7182S) += lt7182s.o
obj-$(CONFIG_SENSORS_LTC2978) += ltc2978.o
obj-$(CONFIG_SENSORS_LTC3815) += ltc3815.o
Expand Down
141 changes: 141 additions & 0 deletions drivers/hwmon/pmbus/lt3074.c
Original file line number Diff line number Diff line change
@@ -0,0 +1,141 @@
// SPDX-License-Identifier: GPL-2.0
/*
* Hardware monitoring driver for Analog Devices LT3074
*
* Copyright (C) 2025 Analog Devices, Inc.
*/
#include <linux/err.h>
#include <linux/i2c.h>
#include <linux/mod_devicetable.h>
#include <linux/module.h>

#include "pmbus.h"

#define LT3074_MFR_READ_VBIAS 0xc6
#define LT3074_MFR_BIAS_OV_WARN_LIMIT 0xc7
#define LT3074_MFR_BIAS_UV_WARN_LIMIT 0xc8
#define LT3074_MFR_SPECIAL_ID 0xe7

#define LT3074_SPECIAL_ID_VALUE 0x1c1d

#if IS_ENABLED(CONFIG_SENSORS_LT3074_REGULATOR)
static const struct regulator_desc lt3074_reg_desc[] = {
PMBUS_REGULATOR("vout", 0),
};
#endif

static int lt3074_read_word_data(struct i2c_client *client, int page,
int phase, int reg)
{
int ret;

switch (reg) {
case PMBUS_VIRT_READ_VMON:
ret = pmbus_read_word_data(client, page, phase,
LT3074_MFR_READ_VBIAS);
break;
case PMBUS_VIRT_VMON_UV_WARN_LIMIT:
ret = pmbus_read_word_data(client, page, phase,
LT3074_MFR_BIAS_UV_WARN_LIMIT);
break;
case PMBUS_VIRT_VMON_OV_WARN_LIMIT:
ret = pmbus_read_word_data(client, page, phase,
LT3074_MFR_BIAS_OV_WARN_LIMIT);
break;
default:
ret = -ENODATA;
break;
}

return ret;
}

static int lt3074_write_word_data(struct i2c_client *client, int page,
int reg, u16 word)
{
int ret;

switch (reg) {
case PMBUS_VIRT_VMON_UV_WARN_LIMIT:
ret = pmbus_write_word_data(client, 0,
LT3074_MFR_BIAS_UV_WARN_LIMIT,
word);
break;
case PMBUS_VIRT_VMON_OV_WARN_LIMIT:
ret = pmbus_write_word_data(client, 0,
LT3074_MFR_BIAS_OV_WARN_LIMIT,
word);
break;
default:
ret = -ENODATA;
break;
}

return ret;
}

static struct pmbus_driver_info lt3074_info = {
.pages = 1,
.format[PSC_VOLTAGE_IN] = linear,
.format[PSC_VOLTAGE_OUT] = linear,
.format[PSC_CURRENT_OUT] = linear,
.format[PSC_TEMPERATURE] = linear,
.func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_VOUT | PMBUS_HAVE_IOUT |
PMBUS_HAVE_TEMP | PMBUS_HAVE_VMON |
PMBUS_HAVE_STATUS_VOUT | PMBUS_HAVE_STATUS_IOUT |
PMBUS_HAVE_STATUS_INPUT | PMBUS_HAVE_STATUS_TEMP,
.read_word_data = lt3074_read_word_data,
.write_word_data = lt3074_write_word_data,
#if IS_ENABLED(CONFIG_SENSORS_LT3074_REGULATOR)
.num_regulators = 1,
.reg_desc = lt3074_reg_desc,
#endif
};

static int lt3074_probe(struct i2c_client *client)
{
int ret;
struct device *dev = &client->dev;

if (!i2c_check_functionality(client->adapter,
I2C_FUNC_SMBUS_READ_WORD_DATA))
return -ENODEV;

ret = i2c_smbus_read_word_data(client, LT3074_MFR_SPECIAL_ID);
if (ret != LT3074_SPECIAL_ID_VALUE) {
dev_err(dev, "ID 0x%x did not match the device\n", ret);
return -ENODEV;
}

return pmbus_do_probe(client, &lt3074_info);
}

static const struct i2c_device_id lt3074_id[] = {
{ "lt3074", 0 },
{}
};

MODULE_DEVICE_TABLE(i2c, lt3074_id);

static const struct of_device_id lt3074_of_match[] = {
{ .compatible = "adi,lt3074" },
{}
};

MODULE_DEVICE_TABLE(of, lt3074_of_match);

static struct i2c_driver lt3074_driver = {
.driver = {
.name = "lt3074",
.of_match_table = of_match_ptr(lt3074_of_match),
},
.probe = lt3074_probe,
.id_table = lt3074_id,
};

module_i2c_driver(lt3074_driver);

MODULE_AUTHOR("Cedric Encarnacion <[email protected]>");
MODULE_DESCRIPTION("PMBus driver for Analog Devices LT3074");
MODULE_LICENSE("GPL");
MODULE_IMPORT_NS(PMBUS);

0 comments on commit b2caddb

Please sign in to comment.