{"id":2222971,"url":"http://patchwork.ozlabs.org/api/patches/2222971/?format=json","web_url":"http://patchwork.ozlabs.org/project/rtc-linux/patch/20260414-s2mu005-pmic-v4-5-7fe7480577e6@disroot.org/","project":{"id":9,"url":"http://patchwork.ozlabs.org/api/projects/9/?format=json","name":"Linux RTC development","link_name":"rtc-linux","list_id":"linux-rtc.vger.kernel.org","list_email":"linux-rtc@vger.kernel.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<20260414-s2mu005-pmic-v4-5-7fe7480577e6@disroot.org>","list_archive_url":null,"date":"2026-04-14T06:32:57","name":"[v4,05/13] dt-bindings: mfd: s2mps11: add documentation for S2MU005 PMIC","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"67cd249fd6b28866cd7534f39d486b250d730f17","submitter":{"id":88698,"url":"http://patchwork.ozlabs.org/api/people/88698/?format=json","name":"Kaustabh Chakraborty","email":"kauschluss@disroot.org"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/rtc-linux/patch/20260414-s2mu005-pmic-v4-5-7fe7480577e6@disroot.org/mbox/","series":[{"id":499781,"url":"http://patchwork.ozlabs.org/api/series/499781/?format=json","web_url":"http://patchwork.ozlabs.org/project/rtc-linux/list/?series=499781","date":"2026-04-14T06:32:53","name":"Support for Samsung S2MU005 PMIC and its sub-devices","version":4,"mbox":"http://patchwork.ozlabs.org/series/499781/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2222971/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2222971/checks/","tags":{},"related":[],"headers":{"Return-Path":"\n <linux-rtc+bounces-6321-incoming=patchwork.ozlabs.org@vger.kernel.org>","X-Original-To":["incoming@patchwork.ozlabs.org","linux-rtc@vger.kernel.org"],"Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n secure) header.d=disroot.org header.i=@disroot.org header.a=rsa-sha256\n header.s=mail header.b=Pyy77qfe;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=2600:3c0a:e001:db::12fc:5321; helo=sea.lore.kernel.org;\n envelope-from=linux-rtc+bounces-6321-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)","smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=disroot.org header.i=@disroot.org\n header.b=\"Pyy77qfe\"","smtp.subspace.kernel.org;\n arc=none smtp.client-ip=178.21.23.139","smtp.subspace.kernel.org;\n dmarc=pass (p=reject dis=none) header.from=disroot.org","smtp.subspace.kernel.org;\n spf=pass smtp.mailfrom=disroot.org"],"Received":["from sea.lore.kernel.org (sea.lore.kernel.org\n [IPv6:2600:3c0a:e001:db::12fc:5321])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fvvjV22PFz1y2d\n\tfor <incoming@patchwork.ozlabs.org>; Tue, 14 Apr 2026 16:38:06 +1000 (AEST)","from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby sea.lore.kernel.org (Postfix) with ESMTP id D1F67305288D\n\tfor <incoming@patchwork.ozlabs.org>; Tue, 14 Apr 2026 06:33:47 +0000 (UTC)","from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 7E04936C9DF;\n\tTue, 14 Apr 2026 06:33:47 +0000 (UTC)","from layka.disroot.org (layka.disroot.org [178.21.23.139])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id CDDE432863D;\n\tTue, 14 Apr 2026 06:33:45 +0000 (UTC)","from [127.0.0.1] (localhost [127.0.0.1])\n\tby disroot.org (Postfix) with ESMTP id 638D225F15;\n\tTue, 14 Apr 2026 08:33:44 +0200 (CEST)","from layka.disroot.org ([127.0.0.1])\n by localhost (disroot.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id sOWCI78pXA_j; Tue, 14 Apr 2026 08:33:43 +0200 (CEST)"],"ARC-Seal":"i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1776148427; cv=none;\n b=D7p/ntFnT83O5KgCLSt61oYOarYGPoT2qWCJN7mri/5XMoXfXdQO1VQB/b5nma9bFowyzUQcSrMD3BOYjmI2e2ghhyEgdnfR14XQJYfmRVyEA2OO9S2LUyhmawm22LTF36ExrCEuMGDvk0t9kPhCpZFJWuM/xFjdZlCUnb7Lt6Y=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1776148427; c=relaxed/simple;\n\tbh=2qwRVJP+lQH9EugQffm+Xt/mUkGuhfh68ma2J9APgaU=;\n\th=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References:\n\t In-Reply-To:To:Cc;\n b=jX77ul80seyR4EB+GiuMOBFeLbGIqYw4AP/S2RpHlxw2YAZlrx6KCJlw4Gl9Xqi7k2xOZ5mV1ffkPtTKeyUsCot6JWlMsXytgji1lWYAi8gEXaFYBPOefhFe5C85b6WdhjVYDlzfNasliiiKdwNU28wFfcljcjvOXAJxlhSGbvk=","ARC-Authentication-Results":"i=1; smtp.subspace.kernel.org;\n dmarc=pass (p=reject dis=none) header.from=disroot.org;\n spf=pass smtp.mailfrom=disroot.org;\n dkim=pass (2048-bit key) header.d=disroot.org header.i=@disroot.org\n header.b=Pyy77qfe; arc=none smtp.client-ip=178.21.23.139","X-Virus-Scanned":"SPAM Filter at disroot.org","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail;\n\tt=1776148423; bh=2qwRVJP+lQH9EugQffm+Xt/mUkGuhfh68ma2J9APgaU=;\n\th=From:Date:Subject:References:In-Reply-To:To:Cc;\n\tb=Pyy77qfe6HA+fDuy5eqoq30ojh7j1fZJf8CPsNOqtp3XwFXl5nHaDOL8ufN/1CIhV\n\t akrSQT6gFE0OP3a65E3dBMIm2HkjGQsPL3CyQgWJRB0JH1yCy8zIGlQWhchulxIeu0\n\t JJc6NdaR4ir/13EdhJ/B1Z9ErHfudsoI7SCvfVWVd6xLqISg3u8ohtCZgC5GPnYunq\n\t bOx+dh4VZUHHz9G6bm6sB2zMyJ9Kf5eHCDwRM5TsCNZ+kjhgK+EWyeBySsFXTQQhmZ\n\t Sn7e1o3PgeM1GoGDbC1UmC+Jte64Z/G6JYT469KOtlEK41IThMqWSZJUT3QfOoNM/e\n\t voIXlwb3FGITw==","From":"Kaustabh Chakraborty <kauschluss@disroot.org>","Date":"Tue, 14 Apr 2026 12:02:57 +0530","Subject":"[PATCH v4 05/13] dt-bindings: mfd: s2mps11: add documentation for\n S2MU005 PMIC","Precedence":"bulk","X-Mailing-List":"linux-rtc@vger.kernel.org","List-Id":"<linux-rtc.vger.kernel.org>","List-Subscribe":"<mailto:linux-rtc+subscribe@vger.kernel.org>","List-Unsubscribe":"<mailto:linux-rtc+unsubscribe@vger.kernel.org>","MIME-Version":"1.0","Content-Type":"text/plain; charset=\"utf-8\"","Content-Transfer-Encoding":"7bit","Message-Id":"<20260414-s2mu005-pmic-v4-5-7fe7480577e6@disroot.org>","References":"<20260414-s2mu005-pmic-v4-0-7fe7480577e6@disroot.org>","In-Reply-To":"<20260414-s2mu005-pmic-v4-0-7fe7480577e6@disroot.org>","To":"Lee Jones <lee@kernel.org>, Pavel Machek <pavel@kernel.org>,\n  Rob Herring <robh@kernel.org>, Krzysztof Kozlowski <krzk+dt@kernel.org>,\n  Conor Dooley <conor+dt@kernel.org>, MyungJoo Ham <myungjoo.ham@samsung.com>,\n  Chanwoo Choi <cw00.choi@samsung.com>, Sebastian Reichel <sre@kernel.org>,\n  Krzysztof Kozlowski <krzk@kernel.org>,\n =?utf-8?q?Andr=C3=A9_Draszik?= <andre.draszik@linaro.org>,\n  Alexandre Belloni <alexandre.belloni@bootlin.com>,\n  Jonathan Corbet <corbet@lwn.net>, Shuah Khan <skhan@linuxfoundation.org>,\n  Nam Tran <trannamatk@gmail.com>,\n =?utf-8?b?xYF1a2FzeiBMZWJpZWR6acWEc2tp?= <kernel@lvkasz.us>","Cc":"linux-leds@vger.kernel.org, devicetree@vger.kernel.org,\n linux-kernel@vger.kernel.org, linux-pm@vger.kernel.org,\n linux-samsung-soc@vger.kernel.org, linux-rtc@vger.kernel.org,\n linux-doc@vger.kernel.org, Kaustabh Chakraborty <kauschluss@disroot.org>"},"content":"Samsung's S2MU005 PMIC includes subdevices for a charger, an MUIC (Micro\nUSB Interface Controller), and flash and RGB LED controllers.\n\nSince regulators are not supported by this device, unmark this property\nas required and instead set this in a per-device basis for ones which\nneed it.\n\nAdd the compatible and documentation for the S2MU005 PMIC. Also, add an\nexample for nodes for supported sub-devices, i.e. charger, extcon,\nflash, and rgb.\n\nSigned-off-by: Kaustabh Chakraborty <kauschluss@disroot.org>\n---\n .../devicetree/bindings/mfd/samsung,s2mps11.yaml   | 121 ++++++++++++++++++++-\n 1 file changed, 120 insertions(+), 1 deletion(-)","diff":"diff --git a/Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml b/Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml\nindex ac5d0c149796b..d3d305b9aa765 100644\n--- a/Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml\n+++ b/Documentation/devicetree/bindings/mfd/samsung,s2mps11.yaml\n@@ -26,12 +26,28 @@ properties:\n       - samsung,s2mps15-pmic\n       - samsung,s2mpu02-pmic\n       - samsung,s2mpu05-pmic\n+      - samsung,s2mu005-pmic\n \n   clocks:\n     $ref: /schemas/clock/samsung,s2mps11.yaml\n     description:\n       Child node describing clock provider.\n \n+  charger:\n+    $ref: /schemas/power/supply/samsung,s2mu005-charger.yaml\n+    description:\n+      Child node describing battery charger device.\n+\n+  extcon:\n+    $ref: /schemas/extcon/samsung,s2mu005-muic.yaml\n+    description:\n+      Child node describing extcon device.\n+\n+  flash:\n+    $ref: /schemas/leds/samsung,s2mu005-flash.yaml\n+    description:\n+      Child node describing flash LEDs.\n+\n   interrupts:\n     maxItems: 1\n \n@@ -43,6 +59,11 @@ properties:\n     description:\n       List of child nodes that specify the regulators.\n \n+  rgb:\n+    $ref: /schemas/leds/samsung,s2mu005-rgb.yaml\n+    description:\n+      Child node describing RGB LEDs.\n+\n   samsung,s2mps11-acokb-ground:\n     description: |\n       Indicates that ACOKB pin of S2MPS11 PMIC is connected to the ground so\n@@ -63,7 +84,6 @@ properties:\n required:\n   - compatible\n   - reg\n-  - regulators\n \n additionalProperties: false\n \n@@ -78,6 +98,8 @@ allOf:\n         regulators:\n           $ref: /schemas/regulator/samsung,s2mps11.yaml\n         samsung,s2mps11-wrstbi-ground: false\n+      required:\n+        - regulators\n \n   - if:\n       properties:\n@@ -89,6 +111,8 @@ allOf:\n         regulators:\n           $ref: /schemas/regulator/samsung,s2mps13.yaml\n         samsung,s2mps11-acokb-ground: false\n+      required:\n+        - regulators\n \n   - if:\n       properties:\n@@ -101,6 +125,8 @@ allOf:\n           $ref: /schemas/regulator/samsung,s2mps14.yaml\n         samsung,s2mps11-acokb-ground: false\n         samsung,s2mps11-wrstbi-ground: false\n+      required:\n+        - regulators\n \n   - if:\n       properties:\n@@ -113,6 +139,8 @@ allOf:\n           $ref: /schemas/regulator/samsung,s2mps15.yaml\n         samsung,s2mps11-acokb-ground: false\n         samsung,s2mps11-wrstbi-ground: false\n+      required:\n+        - regulators\n \n   - if:\n       properties:\n@@ -125,6 +153,8 @@ allOf:\n           $ref: /schemas/regulator/samsung,s2mpu02.yaml\n         samsung,s2mps11-acokb-ground: false\n         samsung,s2mps11-wrstbi-ground: false\n+      required:\n+        - regulators\n \n   - if:\n       properties:\n@@ -137,6 +167,18 @@ allOf:\n           $ref: /schemas/regulator/samsung,s2mpu05.yaml\n         samsung,s2mps11-acokb-ground: false\n         samsung,s2mps11-wrstbi-ground: false\n+      required:\n+        - regulators\n+\n+  - if:\n+      properties:\n+        compatible:\n+          contains:\n+            const: samsung,s2mu005-pmic\n+    then:\n+      properties:\n+        samsung,s2mps11-acokb-ground: false\n+        samsung,s2mps11-wrstbi-ground: false\n \n examples:\n   - |\n@@ -278,3 +320,80 @@ examples:\n             };\n         };\n     };\n+\n+  - |\n+    #include <dt-bindings/interrupt-controller/irq.h>\n+    #include <dt-bindings/leds/common.h>\n+\n+    i2c {\n+        #address-cells = <1>;\n+        #size-cells = <0>;\n+\n+        pmic@3d {\n+            compatible = \"samsung,s2mu005-pmic\";\n+            reg = <0x3d>;\n+            interrupt-parent = <&gpa2>;\n+            interrupts = <7 IRQ_TYPE_LEVEL_LOW>;\n+\n+            charger {\n+                compatible = \"samsung,s2mu005-charger\";\n+                monitored-battery = <&battery>;\n+\n+                port {\n+                    charger_to_muic: endpoint {\n+                        remote-endpoint = <&muic_to_charger>;\n+                    };\n+                };\n+            };\n+\n+            extcon {\n+                compatible = \"samsung,s2mu005-muic\";\n+\n+                connector {\n+                    compatible = \"usb-b-connector\";\n+                    label = \"micro-USB\";\n+                    type = \"micro\";\n+                };\n+\n+                port {\n+                    muic_to_charger: endpoint@0 {\n+                        reg = <0>;\n+                        remote-endpoint = <&charger_to_muic>;\n+                    };\n+\n+                    muic_to_usb: endpoint@1 {\n+                        reg = <1>;\n+                        remote-endpoint = <&usb_to_muic>;\n+                    };\n+                };\n+            };\n+\n+            flash {\n+                compatible = \"samsung,s2mu005-flash\";\n+                #address-cells = <1>;\n+                #size-cells = <0>;\n+\n+                led@0 {\n+                    reg = <0>;\n+                    label = \"back-cam:white:flash\";\n+                    color = <LED_COLOR_ID_WHITE>;\n+                    function = LED_FUNCTION_FLASH;\n+                };\n+\n+                led@1 {\n+                    reg = <1>;\n+                    label = \"front-cam:white:flash\";\n+                    color = <LED_COLOR_ID_WHITE>;\n+                    function = LED_FUNCTION_FLASH;\n+                };\n+            };\n+\n+            rgb {\n+                compatible = \"samsung,s2mu005-rgb\";\n+                label = \"notification:rgb:indicator\";\n+                color = <LED_COLOR_ID_RGB>;\n+                function = LED_FUNCTION_INDICATOR;\n+                linux,default-trigger = \"pattern\";\n+            };\n+        };\n+    };\n","prefixes":["v4","05/13"]}