[PATCH 0/2] power: supply: Add Silicon Mitus SM5714 fuel gauge

[PATCH 0/2] power: supply: Add Silicon Mitus SM5714 fuel gauge

[Nizat Mikayilli via B4 Relay]

The Samsung Galaxy Tab S9 Wi-Fi uses the fuel gauge of the Silicon
Mitus SM5714. This series adds a binding and a small driver for it,
which reports the state of charge, voltage, current and status.

The fuel gauge node for the tablet will be sent with its board series:
https://lore.kernel.org/r/20261022-gts9wifi-dts-v4-0-a361428fe59c@dxdmail.cc

I tested it on the tablet, with the USB cable in and out, and the
power-supply selftest passes.

Signed-off-by: Nizat Mikayilli <nacht@dxdmail.cc>
---
Nizat Mikayilli (2):
      dt-bindings: power: supply: Add Silicon Mitus SM5714 fuel gauge
      power: supply: Add Silicon Mitus SM5714 fuel gauge driver

 .../supply/siliconmitus,sm5714-fuel-gauge.yaml     |  47 +++++
 MAINTAINERS                                        |   7 +
 drivers/power/supply/Kconfig                       |  10 +
 drivers/power/supply/Makefile                      |   1 +
 drivers/power/supply/sm5714-battery.c              | 221 +++++++++++++++++++++
 5 files changed, 286 insertions(+)
---
base-commit: 6628e7d4c6b25c8d18f1345e3a20d21829aae7e4
change-id: 20261108-b4-sm5714-fuel-gauge-ccbe7c191c0c

Best regards,
-- 
Nizat Mikayilli <nacht@dxdmail.cc>

[PATCH 1/2] dt-bindings: power: supply: Add Silicon Mitus SM5714 fuel gauge

[Nizat Mikayilli via B4 Relay]

From: Nizat Mikayilli <nacht@dxdmail.cc>

The Silicon Mitus SM5714 includes a MUIC, a charger and a fuel gauge,
each at its own I2C address. Add a binding for the fuel gauge as a
separate device, like the MAX77705 fuel gauge.

Signed-off-by: Nizat Mikayilli <nacht@dxdmail.cc>
---
 .../supply/siliconmitus,sm5714-fuel-gauge.yaml     | 47 ++++++++++++++++++++++
 MAINTAINERS                                        |  6 +++
 2 files changed, 53 insertions(+)

diff --git a/Documentation/devicetree/bindings/power/supply/siliconmitus,sm5714-fuel-gauge.yaml b/Documentation/devicetree/bindings/power/supply/siliconmitus,sm5714-fuel-gauge.yaml
new file mode 100644
index 000000000000..777b64bade5d
--- /dev/null
+++ b/Documentation/devicetree/bindings/power/supply/siliconmitus,sm5714-fuel-gauge.yaml
@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/power/supply/siliconmitus,sm5714-fuel-gauge.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Silicon Mitus SM5714 fuel gauge
+
+maintainers:
+  - Nizat Mikayilli <nacht@dxdmail.cc>
+
+description:
+  The Silicon Mitus SM5714 includes a MUIC, a battery charger with a flash LED
+  driver and a fuel gauge, each on its own I2C address. The fuel gauge measures
+  the battery voltage and current and estimates the state of charge.
+
+allOf:
+  - $ref: power-supply.yaml#
+
+properties:
+  compatible:
+    const: siliconmitus,sm5714-fuel-gauge
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        fuel-gauge@71 {
+            compatible = "siliconmitus,sm5714-fuel-gauge";
+            reg = <0x71>;
+            monitored-battery = <&battery>;
+        };
+    };
diff --git a/MAINTAINERS b/MAINTAINERS
index 93abbb315065..2875017d21c2 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -25713,6 +25713,12 @@ S:	Supported
 F:	Documentation/devicetree/bindings/net/wireless/silabs,wfx.yaml
 F:	drivers/net/wireless/silabs/
 
+SILICON MITUS SM5714 FUEL GAUGE DRIVER
+M:	Nizat Mikayilli <nacht@dxdmail.cc>
+L:	linux-pm@vger.kernel.org
+S:	Maintained
+F:	Documentation/devicetree/bindings/power/supply/siliconmitus,sm5714-fuel-gauge.yaml
+
 SILICON MOTION SM712 FRAME BUFFER DRIVER
 M:	Sudip Mukherjee <sudipm.mukherjee@gmail.com>
 M:	Teddy Wang <teddy.wang@siliconmotion.com>

-- 
2.56.0

[PATCH 2/2] power: supply: Add Silicon Mitus SM5714 fuel gauge driver

[Nizat Mikayilli via B4 Relay]

From: Nizat Mikayilli <nacht@dxdmail.cc>

Add a driver for the fuel gauge of the Silicon Mitus SM5714. The state
of charge, voltage and current are read through an SRAM window, and the
SRAM read address is the only register the driver writes. The status
is derived from the battery current, as in s2mu005-battery. The driver
does not load a battery model, so capacity is only reported once
Samsung's software has initialized the gauge. The register layout and
scaling come from Samsung's GPL driver for the Galaxy Tab S9.

Signed-off-by: Nizat Mikayilli <nacht@dxdmail.cc>
---
 MAINTAINERS                           |   1 +
 drivers/power/supply/Kconfig          |  10 ++
 drivers/power/supply/Makefile         |   1 +
 drivers/power/supply/sm5714-battery.c | 221 ++++++++++++++++++++++++++++++++++
 4 files changed, 233 insertions(+)

diff --git a/MAINTAINERS b/MAINTAINERS
index 2875017d21c2..d9f37c040453 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -25718,6 +25718,7 @@ M:	Nizat Mikayilli <nacht@dxdmail.cc>
 L:	linux-pm@vger.kernel.org
 S:	Maintained
 F:	Documentation/devicetree/bindings/power/supply/siliconmitus,sm5714-fuel-gauge.yaml
+F:	drivers/power/supply/sm5714-battery.c
 
 SILICON MOTION SM712 FRAME BUFFER DRIVER
 M:	Sudip Mukherjee <sudipm.mukherjee@gmail.com>
diff --git a/drivers/power/supply/Kconfig b/drivers/power/supply/Kconfig
index ee7dc5f2617a..c92d09a4f1c9 100644
--- a/drivers/power/supply/Kconfig
+++ b/drivers/power/supply/Kconfig
@@ -240,6 +240,16 @@ config BATTERY_S2MU005
 
 	  This driver, if built as a module, will be called s2mu005-fuel-gauge.
 
+config BATTERY_SM5714
+	tristate "Silicon Mitus SM5714 fuel gauge driver"
+	depends on I2C
+	help
+	  Say Y to enable support for the fuel gauge of the Silicon Mitus
+	  SM5714, which reports the battery state of charge, voltage and
+	  current.
+
+	  This driver, if built as a module, will be called sm5714-battery.
+
 config BATTERY_COLLIE
 	tristate "Sharp SL-5500 (collie) battery"
 	depends on SA1100_COLLIE && MCP_UCB1200
diff --git a/drivers/power/supply/Makefile b/drivers/power/supply/Makefile
index f3c0d1006c1a..459f9cbe5f30 100644
--- a/drivers/power/supply/Makefile
+++ b/drivers/power/supply/Makefile
@@ -41,6 +41,7 @@ obj-$(CONFIG_BATTERY_QCOM_BATTMGR)	+= qcom_battmgr.o
 obj-$(CONFIG_BATTERY_OLPC)	+= olpc_battery.o
 obj-$(CONFIG_BATTERY_SAMSUNG_SDI)	+= samsung-sdi-battery.o
 obj-$(CONFIG_BATTERY_S2MU005)	+= s2mu005-battery.o
+obj-$(CONFIG_BATTERY_SM5714)	+= sm5714-battery.o
 obj-$(CONFIG_BATTERY_COLLIE)	+= collie_battery.o
 obj-$(CONFIG_BATTERY_INGENIC)	+= ingenic-battery.o
 obj-$(CONFIG_BATTERY_INTEL_DC_TI) += intel_dc_ti_battery.o
diff --git a/drivers/power/supply/sm5714-battery.c b/drivers/power/supply/sm5714-battery.c
new file mode 100644
index 000000000000..bd8cb97d81df
--- /dev/null
+++ b/drivers/power/supply/sm5714-battery.c
@@ -0,0 +1,221 @@
+// SPDX-License-Identifier: GPL-2.0-only
+
+#include <linux/bits.h>
+#include <linux/err.h>
+#include <linux/i2c.h>
+#include <linux/math.h>
+#include <linux/minmax.h>
+#include <linux/module.h>
+#include <linux/mutex.h>
+#include <linux/power_supply.h>
+#include <linux/property.h>
+#include <linux/units.h>
+
+#define SM5714_FG_REG_DEVICE_ID		0x00
+#define SM5714_FG_REG_SYSTEM_STATUS	0x10
+#define SM5714_FG_REG_AUX_STAT		0x22
+#define SM5714_FG_REG_SRAM_RADDR	0x8c
+#define SM5714_FG_REG_SRAM_RDATA	0x8d
+
+#define SM5714_FG_SYSTEM_STATUS_INIT	BIT(12)
+#define SM5714_FG_AUX_STAT_CURRENT_X2_5	BIT(10)
+
+#define SM5714_FG_SRAM_SOC		0x00
+#define SM5714_FG_SRAM_VBAT		0x03
+#define SM5714_FG_SRAM_CURRENT		0x05
+#define SM5714_FG_SRAM_VBAT_AVG		0x08
+#define SM5714_FG_SRAM_CURRENT_AVG	0x09
+
+struct sm5714_fg {
+	struct i2c_client *client;
+	struct mutex lock; /* SRAM read address and data */
+};
+
+static int sm5714_fg_read_sram(struct sm5714_fg *fg, u8 addr)
+{
+	int ret;
+
+	guard(mutex)(&fg->lock);
+
+	ret = i2c_smbus_write_word_data(fg->client, SM5714_FG_REG_SRAM_RADDR, addr);
+	if (ret)
+		return ret;
+
+	return i2c_smbus_read_word_data(fg->client, SM5714_FG_REG_SRAM_RDATA);
+}
+
+static int sm5714_fg_sign_mag(int raw, int mul, int div)
+{
+	int val = mult_frac(raw & 0x7fff, mul, div);
+
+	return raw & BIT(15) ? -val : val;
+}
+
+static int sm5714_fg_get_voltage(struct sm5714_fg *fg, u8 addr, int *val)
+{
+	int ret;
+
+	ret = sm5714_fg_read_sram(fg, addr);
+	if (ret < 0)
+		return ret;
+
+	*val = 2700000 + sm5714_fg_sign_mag(ret, 10000, 109);
+
+	return 0;
+}
+
+static int sm5714_fg_get_current(struct sm5714_fg *fg, u8 addr, int *val)
+{
+	int aux, ret;
+
+	ret = sm5714_fg_read_sram(fg, addr);
+	if (ret < 0)
+		return ret;
+
+	aux = i2c_smbus_read_word_data(fg->client, SM5714_FG_REG_AUX_STAT);
+	if (aux < 0)
+		return aux;
+
+	*val = sm5714_fg_sign_mag(ret, MICRO, 2044);
+	if (aux & SM5714_FG_AUX_STAT_CURRENT_X2_5)
+		*val = *val * 5 / 2;
+
+	return 0;
+}
+
+static int sm5714_fg_get_capacity(struct sm5714_fg *fg, int *val)
+{
+	int ret;
+
+	ret = i2c_smbus_read_word_data(fg->client, SM5714_FG_REG_SYSTEM_STATUS);
+	if (ret < 0)
+		return ret;
+
+	if (!(ret & SM5714_FG_SYSTEM_STATUS_INIT))
+		return -ENODATA;
+
+	ret = sm5714_fg_read_sram(fg, SM5714_FG_SRAM_SOC);
+	if (ret < 0)
+		return ret;
+
+	*val = min(ret >> 8, 100);
+
+	return 0;
+}
+
+static int sm5714_fg_get_status(struct sm5714_fg *fg, int *val)
+{
+	int now, avg, capacity, ret;
+
+	ret = sm5714_fg_get_current(fg, SM5714_FG_SRAM_CURRENT, &now);
+	if (ret)
+		return ret;
+
+	ret = sm5714_fg_get_current(fg, SM5714_FG_SRAM_CURRENT_AVG, &avg);
+	if (ret)
+		return ret;
+
+	/* Use the average as well, to ride out noise around 0 A */
+	if (now < 0 && avg < 0)
+		*val = POWER_SUPPLY_STATUS_DISCHARGING;
+	else if (!now)
+		*val = POWER_SUPPLY_STATUS_NOT_CHARGING;
+	else if (!sm5714_fg_get_capacity(fg, &capacity) && capacity > 98)
+		*val = POWER_SUPPLY_STATUS_FULL;
+	else
+		*val = POWER_SUPPLY_STATUS_CHARGING;
+
+	return 0;
+}
+
+static const enum power_supply_property sm5714_fg_props[] = {
+	POWER_SUPPLY_PROP_STATUS,
+	POWER_SUPPLY_PROP_CAPACITY,
+	POWER_SUPPLY_PROP_VOLTAGE_NOW,
+	POWER_SUPPLY_PROP_VOLTAGE_AVG,
+	POWER_SUPPLY_PROP_CURRENT_NOW,
+	POWER_SUPPLY_PROP_CURRENT_AVG,
+};
+
+static int sm5714_fg_get_property(struct power_supply *psy,
+				  enum power_supply_property psp,
+				  union power_supply_propval *val)
+{
+	struct sm5714_fg *fg = power_supply_get_drvdata(psy);
+
+	switch (psp) {
+	case POWER_SUPPLY_PROP_STATUS:
+		return sm5714_fg_get_status(fg, &val->intval);
+	case POWER_SUPPLY_PROP_CAPACITY:
+		return sm5714_fg_get_capacity(fg, &val->intval);
+	case POWER_SUPPLY_PROP_VOLTAGE_NOW:
+		return sm5714_fg_get_voltage(fg, SM5714_FG_SRAM_VBAT, &val->intval);
+	case POWER_SUPPLY_PROP_VOLTAGE_AVG:
+		return sm5714_fg_get_voltage(fg, SM5714_FG_SRAM_VBAT_AVG, &val->intval);
+	case POWER_SUPPLY_PROP_CURRENT_NOW:
+		return sm5714_fg_get_current(fg, SM5714_FG_SRAM_CURRENT, &val->intval);
+	case POWER_SUPPLY_PROP_CURRENT_AVG:
+		return sm5714_fg_get_current(fg, SM5714_FG_SRAM_CURRENT_AVG, &val->intval);
+	default:
+		return -EINVAL;
+	}
+}
+
+static const struct power_supply_desc sm5714_fg_desc = {
+	.name = "sm5714-fuel-gauge",
+	.type = POWER_SUPPLY_TYPE_BATTERY,
+	.properties = sm5714_fg_props,
+	.num_properties = ARRAY_SIZE(sm5714_fg_props),
+	.get_property = sm5714_fg_get_property,
+};
+
+static int sm5714_fg_probe(struct i2c_client *client)
+{
+	struct power_supply_config psy_cfg = {};
+	struct device *dev = &client->dev;
+	struct power_supply *psy;
+	struct sm5714_fg *fg;
+	int ret;
+
+	fg = devm_kzalloc(dev, sizeof(*fg), GFP_KERNEL);
+	if (!fg)
+		return -ENOMEM;
+
+	fg->client = client;
+
+	ret = i2c_smbus_read_word_data(client, SM5714_FG_REG_DEVICE_ID);
+	if (ret < 0)
+		return dev_err_probe(dev, ret, "failed to read device ID\n");
+
+	ret = devm_mutex_init(dev, &fg->lock);
+	if (ret)
+		return ret;
+
+	psy_cfg.drv_data = fg;
+	psy_cfg.fwnode = dev_fwnode(dev);
+
+	psy = devm_power_supply_register(dev, &sm5714_fg_desc, &psy_cfg);
+	if (IS_ERR(psy))
+		return dev_err_probe(dev, PTR_ERR(psy), "failed to register power supply\n");
+
+	return 0;
+}
+
+static const struct of_device_id sm5714_fg_of_match[] = {
+	{ .compatible = "siliconmitus,sm5714-fuel-gauge" },
+	{ }
+};
+MODULE_DEVICE_TABLE(of, sm5714_fg_of_match);
+
+static struct i2c_driver sm5714_fg_driver = {
+	.driver = {
+		.name = "sm5714-fuel-gauge",
+		.of_match_table = sm5714_fg_of_match,
+	},
+	.probe = sm5714_fg_probe,
+};
+module_i2c_driver(sm5714_fg_driver);
+
+MODULE_AUTHOR("Nizat Mikayilli <nacht@dxdmail.cc>");
+MODULE_DESCRIPTION("Silicon Mitus SM5714 fuel gauge driver");
+MODULE_LICENSE("GPL");

-- 
2.56.0

[PATCH 0/2] power: supply: Add Silicon Mitus SM5714 fuel gauge

[Asdlerto Korry via B4 Relay]

The Silicon Mitus SM5714 is a power management chip for mobile phones
with a charger, a USB Type-C port controller, a MUIC and a fuel gauge,
each on its own I2C address. It is used in the Samsung Galaxy M52 5G
(SM7325).

This series adds a binding and a read-only driver for the fuel gauge
part. It reports the state of charge, the battery voltage and current
and the battery temperature. The temperature measured by the gauge
itself rises with the charge current, so an optional ADC channel can
point at the battery thermistor.

Tested on a Samsung Galaxy M52 5G with the driver backported to 7.1:
the voltage, open-circuit voltage and current match the out-of-tree
driver used before, and the status follows the cable (discharging when
unplugged, full when plugged in with a full battery).

The charger and Type-C parts of the chip, and the devicetree nodes for
the M52, will come in separate series.

Signed-off-by: Asdlerto Korry <korryasdlerto@gmail.com>
---
Asdlerto Korry (2):
      dt-bindings: power: supply: Add Silicon Mitus SM5714 fuel gauge
      power: supply: Add Silicon Mitus SM5714 fuel gauge driver

 .../supply/siliconmitus,sm5714-fuelgauge.yaml      |  53 ++++
 MAINTAINERS                                        |   7 +
 drivers/power/supply/Kconfig                       |  13 +
 drivers/power/supply/Makefile                      |   1 +
 drivers/power/supply/sm5714_fuel_gauge.c           | 315 +++++++++++++++++++++
 5 files changed, 389 insertions(+)
---
base-commit: 7649ba73f9e7e1e04d0b46213e39c79ae09dd55c
change-id: 20261111-sm5714-fuel-gauge-c3c617078240

Best regards,
-- 
Asdlerto Korry <korryasdlerto@gmail.com>

Re: [PATCH 1/2] dt-bindings: power: supply: Add Silicon Mitus SM5714 fuel gauge

[Krzysztof Kozlowski]

On Sun, Nov 08, 2026 at 12:22:25PM +0100, Nizat Mikayilli wrote:
> The Silicon Mitus SM5714 includes a MUIC, a charger and a fuel gauge,
> each at its own I2C address. Add a binding for the fuel gauge as a
> separate device, like the MAX77705 fuel gauge.
> 
> Signed-off-by: Nizat Mikayilli <nacht@dxdmail.cc>
> ---
>  .../supply/siliconmitus,sm5714-fuel-gauge.yaml     | 47 ++++++++++++++++++++++
>  MAINTAINERS                                        |  6 +++
>  2 files changed, 53 insertions(+)

Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>

Best regards,
Krzysztof

Re: [PATCH 0/2] power: supply: Add Silicon Mitus SM5714 fuel gauge

[Asdlerto Korry]

Hi Nizat,

I tested this series on a Samsung Galaxy M52 5G (SM-M526B, sm7325),
where the SM5714 fuel gauge sits at 0x71 on a QUP I2C bus.

The driver binds and the readings match what I get with the vendor
setup: on USB it reports Charging with a positive current, unplugged
it reports Discharging (around -400 mA, 3.80 V), and upower picks up
the battery and percentage correctly.

Tested-by: Asdlerto Korry <korryasdlerto@gmail.com> # Samsung Galaxy M52 5G

A few notes, none of them blocking:

- The capacity truncates (SOC >> 8). With the raw SOC at about 44.6 %
  it reports 44, while rounding would give 45. Rounding might match
  the vendor UI better, but either is fine.

- The M52 has a battery NTC on an ADC channel. If you're interested,
  I could send a follow-up on top of your series that adds TEMP through
  io-channels, and VOLTAGE_OCV from the gauge, once this is merged.

Thanks for working on this!

Asdlerto