hwmon: (pmbus/max17616) add driver for max17616

Add support for MAX17616/MAX17616A current-limiter with
overvoltage/surge, undervoltage, reverse polarity, loss of ground
protection with PMBus interface. The PMBus interface allows monitoring
of input/output voltages, output current and temperature.

Signed-off-by: Kim Seer Paller <kimseer.paller@analog.com>
Link: https://lore.kernel.org/r/20250930-upstream-max17616-v1-2-1525a85f126c@analog.com
[groeck: Fixed htmldocs 'WARNING: Title underline too short'
 as reported by Kriish Sharma <kriish.sharma2006@gmail.com>]
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
This commit is contained in:
Kim Seer Paller
2025-09-30 13:02:21 +08:00
committed by Guenter Roeck
parent 1288ea95ed
commit 77ed12d163
6 changed files with 148 additions and 0 deletions

View File

@@ -151,6 +151,7 @@ Hardware Monitoring Kernel Drivers
max1619
max16601
max1668
max17616
max197
max20730
max20751

View File

@@ -0,0 +1,62 @@
.. SPDX-License-Identifier: GPL-2.0
Kernel driver max17616
======================
Supported chips:
* Analog Devices MAX17616/MAX17616A
Prefix: 'max17616'
Addresses scanned: -
Datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/max17616-max17616a.pdf
Author:
- Kim Seer Paller <kimseer.paller@analog.com>
Description
-----------
This driver supports hardware monitoring for Analog Devices MAX17616/MAX17616A
Current-Limiter with OV/Surge, UV, Reverse Polarity, Loss of Ground Protection
with PMBus Interface.
The MAX17616/MAX17616A is a 3V to 80V, 7A current-limiter with overvoltage,
surge, undervoltage, reverse polarity, and loss of ground protection. Through
the PMBus interface, the device can monitor input/output voltages, output current
and 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_alarm Input voltage alarm
in2_label "vout1"
in2_input Measured output voltage
curr1_label "iout1"
curr1_input Measured output current.
curr1_alarm Output current alarm
temp1_input Measured temperature
temp1_alarm Chip temperature alarm
================= ========================================

View File

@@ -15171,6 +15171,8 @@ L: linux-hwmon@vger.kernel.org
S: Supported
W: https://ez.analog.com/linux-software-drivers
F: Documentation/devicetree/bindings/hwmon/pmbus/adi,max17616.yaml
F: Documentation/hwmon/max17616.rst
F: drivers/hwmon/pmbus/max17616.c
MAX2175 SDR TUNER DRIVER
M: Ramesh Shanmugasundaram <rashanmu@gmail.com>

View File

@@ -320,6 +320,15 @@ config SENSORS_MAX16601
This driver can also be built as a module. If so, the module will
be called max16601.
config SENSORS_MAX17616
tristate "Analog Devices MAX17616/MAX17616A"
help
If you say yes here you get hardware monitoring support for Analog
Devices MAX17616/MAX17616A.
This driver can also be built as a module. If so, the module will
be called max17616.
config SENSORS_MAX20730
tristate "Maxim MAX20710, MAX20730, MAX20734, MAX20743"
help

View File

@@ -31,6 +31,7 @@ obj-$(CONFIG_SENSORS_LTC4286) += ltc4286.o
obj-$(CONFIG_SENSORS_MAX15301) += max15301.o
obj-$(CONFIG_SENSORS_MAX16064) += max16064.o
obj-$(CONFIG_SENSORS_MAX16601) += max16601.o
obj-$(CONFIG_SENSORS_MAX17616) += max17616.o
obj-$(CONFIG_SENSORS_MAX20730) += max20730.o
obj-$(CONFIG_SENSORS_MAX20751) += max20751.o
obj-$(CONFIG_SENSORS_MAX31785) += max31785.o

View File

@@ -0,0 +1,73 @@
// SPDX-License-Identifier: GPL-2.0
/*
* Hardware monitoring driver for Analog Devices MAX17616/MAX17616A
*
* 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"
static struct pmbus_driver_info max17616_info = {
.pages = 1,
.format[PSC_VOLTAGE_IN] = direct,
.m[PSC_VOLTAGE_IN] = 512,
.b[PSC_VOLTAGE_IN] = -18,
.R[PSC_VOLTAGE_IN] = -1,
.format[PSC_VOLTAGE_OUT] = direct,
.m[PSC_VOLTAGE_OUT] = 512,
.b[PSC_VOLTAGE_OUT] = -18,
.R[PSC_VOLTAGE_OUT] = -1,
.format[PSC_CURRENT_OUT] = direct,
.m[PSC_CURRENT_OUT] = 5845,
.b[PSC_CURRENT_OUT] = 80,
.R[PSC_CURRENT_OUT] = -1,
.format[PSC_TEMPERATURE] = direct,
.m[PSC_TEMPERATURE] = 71,
.b[PSC_TEMPERATURE] = 19653,
.R[PSC_TEMPERATURE] = -1,
.func[0] = PMBUS_HAVE_VIN | PMBUS_HAVE_VOUT | PMBUS_HAVE_IOUT |
PMBUS_HAVE_TEMP | PMBUS_HAVE_STATUS_VOUT |
PMBUS_HAVE_STATUS_IOUT | PMBUS_HAVE_STATUS_INPUT |
PMBUS_HAVE_STATUS_TEMP,
};
static int max17616_probe(struct i2c_client *client)
{
return pmbus_do_probe(client, &max17616_info);
}
static const struct i2c_device_id max17616_id[] = {
{ "max17616" },
{ }
};
MODULE_DEVICE_TABLE(i2c, max17616_id);
static const struct of_device_id max17616_of_match[] = {
{ .compatible = "adi,max17616" },
{ }
};
MODULE_DEVICE_TABLE(of, max17616_of_match);
static struct i2c_driver max17616_driver = {
.driver = {
.name = "max17616",
.of_match_table = max17616_of_match,
},
.probe = max17616_probe,
.id_table = max17616_id,
};
module_i2c_driver(max17616_driver);
MODULE_AUTHOR("Kim Seer Paller <kimseer.paller@analog.com>");
MODULE_DESCRIPTION("PMBus driver for Analog Devices MAX17616/MAX17616A");
MODULE_LICENSE("GPL");
MODULE_IMPORT_NS("PMBUS");