{"id":2227498,"url":"http://patchwork.ozlabs.org/api/patches/2227498/?format=json","web_url":"http://patchwork.ozlabs.org/project/rtc-linux/patch/20260424-s2mu005-pmic-v5-3-fcbc9da5a004@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":"<20260424-s2mu005-pmic-v5-3-fcbc9da5a004@disroot.org>","list_archive_url":null,"date":"2026-04-23T19:39:02","name":"[v5,03/11] dt-bindings: mfd: add documentation for S2MU005 PMIC","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"0c7aa12da3a4754626b8b05616a1e5af1fcc1224","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/20260424-s2mu005-pmic-v5-3-fcbc9da5a004@disroot.org/mbox/","series":[{"id":501238,"url":"http://patchwork.ozlabs.org/api/series/501238/?format=json","web_url":"http://patchwork.ozlabs.org/project/rtc-linux/list/?series=501238","date":"2026-04-23T19:39:00","name":"Support for Samsung S2MU005 PMIC and its sub-devices","version":5,"mbox":"http://patchwork.ozlabs.org/series/501238/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2227498/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2227498/checks/","tags":{},"related":[],"headers":{"Return-Path":"\n <linux-rtc+bounces-6399-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=NElyZ6pj;\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-6399-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=\"NElyZ6pj\"","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)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g1mvx0QcPz1y2d\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 24 Apr 2026 05:52:29 +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 90EBD3030EAE\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 23 Apr 2026 19:50:12 +0000 (UTC)","from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 13F4538422E;\n\tThu, 23 Apr 2026 19:50:12 +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 878BC30FC27;\n\tThu, 23 Apr 2026 19:50:10 +0000 (UTC)","from mail01.disroot.lan (localhost [127.0.0.1])\n\tby disroot.org (Postfix) with ESMTP id 34ED226DA5;\n\tThu, 23 Apr 2026 21:50:09 +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 HApEscDIVU-H; Thu, 23 Apr 2026 21:50:08 +0200 (CEST)"],"ARC-Seal":"i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1776973812; cv=none;\n b=iFqstCsjUVoDAl1Nklq9AYkhJtHOVcs7Xa6RFEPIDL9mQYpsTZtHzQc60yqAlLhx/jzwB5NltJ2hbddj57zTwsoJLgmzASE+7TrDljwBdYAH2KFta9qvtDFkqcI7BWDoYGkUpMMS0p9fRzQBgUtSZ3kjOFMvQgLVzsYMgkg3VjE=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1776973812; c=relaxed/simple;\n\tbh=wG5aVvMxMI0cXNDURk14EaW5rpeeJXdYvxDtGL++Q0g=;\n\th=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References:\n\t In-Reply-To:To:Cc;\n b=MYgE4++cFvyhP5adMqvEdX96ASzh+YZ5sc/+Bnpf1d9LttgFfp/Fm4SiY2k1DWGTN6F3CBXsl+LpmieH715Fn3sOwGHIJvHtusmu01rnFHeBCMZdsxpu+gHJnJZ8pQu53jE1bSKEG4UiObLisz49Ix/EKBSfVCCHCJQ6/FNLKBk=","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=NElyZ6pj; 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=1776973808; bh=wG5aVvMxMI0cXNDURk14EaW5rpeeJXdYvxDtGL++Q0g=;\n\th=From:Date:Subject:References:In-Reply-To:To:Cc;\n\tb=NElyZ6pj03bOT5FcS/NuhOQ5Fuwn1uTVjnm/xuGHCbMIxwHPHVcH5/UoPP0QqyALM\n\t Z4b7/mNAefz1ctpR1mZNPICfK849+zS0bhPj+Z6EFECcnYaI/9aCnIl4DyqVrYJz4E\n\t Q70Rxxz3+wSuA1qz4NxZL15Yo4lxC+sj22mMJOju9uyZQ10HOsWIs5wQseS33piaXL\n\t c6a3Fuava/hawCEHd2Tb1B2TveZg0oGTBYCHJNeg4+8ZSvmQNkf0uHS6A7Xq8wxYgQ\n\t xdktrc0rAJvAcGaovovw7EcnQT9heRfyGYowUYc03y5B7J9149vX3KHKqAKR5lnXqS\n\t rXEpVsDjf9KJw==","From":"Kaustabh Chakraborty <kauschluss@disroot.org>","Date":"Fri, 24 Apr 2026 01:09:02 +0530","Subject":"[PATCH v5 03/11] dt-bindings: mfd: add documentation for S2MU005\n 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":"<20260424-s2mu005-pmic-v5-3-fcbc9da5a004@disroot.org>","References":"<20260424-s2mu005-pmic-v5-0-fcbc9da5a004@disroot.org>","In-Reply-To":"<20260424-s2mu005-pmic-v5-0-fcbc9da5a004@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\nAdd the compatible and documentation for the S2MU005 PMIC. Also, add an\nexample for nodes for supported sub-devices, i.e. MUIC, flash LEDs, and\nRGB LEDs. Charger sub-device uses the node of the parent.\n\nSigned-off-by: Kaustabh Chakraborty <kauschluss@disroot.org>\n---\n .../bindings/mfd/samsung,s2mu005-pmic.yaml         | 120 +++++++++++++++++++++\n 1 file changed, 120 insertions(+)","diff":"diff --git a/Documentation/devicetree/bindings/mfd/samsung,s2mu005-pmic.yaml b/Documentation/devicetree/bindings/mfd/samsung,s2mu005-pmic.yaml\nnew file mode 100644\nindex 0000000000000..0e6afb7d2017b\n--- /dev/null\n+++ b/Documentation/devicetree/bindings/mfd/samsung,s2mu005-pmic.yaml\n@@ -0,0 +1,120 @@\n+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause\n+%YAML 1.2\n+---\n+$id: http://devicetree.org/schemas/mfd/samsung,s2mu005-pmic.yaml#\n+$schema: http://devicetree.org/meta-schemas/core.yaml#\n+\n+title: Samsung S2MU005 Power Management IC\n+\n+maintainers:\n+  - Kaustabh Chakraborty <kauschluss@disroot.org>\n+\n+description: |\n+  The S2MU005 is a companion power management IC which includes subdevices for\n+  a charger controller, an MUIC (Micro USB Interface Controller), and flash and\n+  RGB LED controllers.\n+\n+allOf:\n+  - $ref: /schemas/power/supply/power-supply.yaml#\n+\n+properties:\n+  compatible:\n+    const: samsung,s2mu005-pmic\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+  muic:\n+    $ref: /schemas/extcon/samsung,s2mu005-muic.yaml#\n+    description:\n+      Child node describing MUIC device.\n+\n+  multi-led:\n+    type: object\n+\n+    allOf:\n+      - $ref: /schemas/leds/leds-class-multicolor.yaml#\n+\n+    properties:\n+      compatible:\n+        const: samsung,s2mu005-rgb\n+\n+    required:\n+      - compatible\n+\n+    unevaluatedProperties: false\n+\n+  reg:\n+    maxItems: 1\n+\n+required:\n+  - compatible\n+  - reg\n+\n+unevaluatedProperties: false\n+\n+examples:\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+            monitored-battery = <&battery>;\n+\n+            flash {\n+                compatible = \"samsung,s2mu005-flash\";\n+                #address-cells = <1>;\n+                #size-cells = <0>;\n+\n+                led@0 {\n+                    reg = <0>;\n+                    color = <LED_COLOR_ID_WHITE>;\n+                    function = LED_FUNCTION_FLASH;\n+                };\n+\n+                led@1 {\n+                    reg = <1>;\n+                    color = <LED_COLOR_ID_WHITE>;\n+                    function = LED_FUNCTION_FLASH;\n+                    function-enumerator = <1>;\n+                };\n+            };\n+\n+            muic {\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_usb: endpoint {\n+                        remote-endpoint = <&usb_to_muic>;\n+                    };\n+                };\n+            };\n+\n+            multi-led {\n+                compatible = \"samsung,s2mu005-rgb\";\n+                color = <LED_COLOR_ID_RGB>;\n+                function = LED_FUNCTION_INDICATOR;\n+                linux,default-trigger = \"pattern\";\n+            };\n+        };\n+    };\n","prefixes":["v5","03/11"]}