{"id":2227504,"url":"http://patchwork.ozlabs.org/api/patches/2227504/?format=json","web_url":"http://patchwork.ozlabs.org/project/rtc-linux/patch/20260424-s2mu005-pmic-v5-9-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-9-fcbc9da5a004@disroot.org>","list_archive_url":null,"date":"2026-04-23T19:39:08","name":"[v5,09/11] Documentation: leds: document pattern behavior of Samsung S2M series PMIC RGB LEDs","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"0d8c3b17512697956107cd8fd6c0a856c6c0d7ae","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-9-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/2227504/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2227504/checks/","tags":{},"related":[],"headers":{"Return-Path":"\n ","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=V9qNgPx/;\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-6405-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=\"V9qNgPx/\"","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 4g1n0J72JNz1yDD\n\tfor ; Fri, 24 Apr 2026 05:56:16 +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 67ACA310843D\n\tfor ; Thu, 23 Apr 2026 19:51:05 +0000 (UTC)","from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 7755539E6F3;\n\tThu, 23 Apr 2026 19:50:53 +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 DEE592D6E66;\n\tThu, 23 Apr 2026 19:50:51 +0000 (UTC)","from mail01.disroot.lan (localhost [127.0.0.1])\n\tby disroot.org (Postfix) with ESMTP id B03F926E9C;\n\tThu, 23 Apr 2026 21:50:50 +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 bDkFWnvNcfR4; Thu, 23 Apr 2026 21:50:50 +0200 (CEST)"],"ARC-Seal":"i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1776973853; cv=none;\n b=b3M0RWdcLZWltE/cMxMg1C1CapzmZbPbt0tvzSCI3wvCqPQiMO9LURgPQ1dx6/NIqWtn9zU+syo28HU7UAekvjwqxq18aT4ssNoo94o1TCCeq9mPE0M4JdeyCesu55vKaCBvWDCjsOC26RN+fkq/DSR/dpENKC7POz/fmEEpXA4=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1776973853; c=relaxed/simple;\n\tbh=/WI5uPKkfnHPmN5fRkoq5GqgK1SkJOYa870eu3oI8o0=;\n\th=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References:\n\t In-Reply-To:To:Cc;\n b=ulRQSK0em3ByBdFklxWRJ1606PAX6IKW5j2GuxA5hIdBsoVukHfBszHTghGlcs+7AZh3njfieII73U6ZPA3hbF9eryw4J6Lo9Sh7lwNsrPrVzqF6/XzKPBwLjaTTBoEGnY+RJrzEga1Hbg8YPcgHQpBpUqnznHM4iFXlgMCW2lk=","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=V9qNgPx/; 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=1776973850; bh=/WI5uPKkfnHPmN5fRkoq5GqgK1SkJOYa870eu3oI8o0=;\n\th=From:Date:Subject:References:In-Reply-To:To:Cc;\n\tb=V9qNgPx/PVZpEn405NnrFuyeGXy6/0u/GNLYvtMe5Tr8GtD+zabDASXQrUYa8KV9w\n\t QMzV/1RhWoKvUTV5CYYrU3d9Ukr2/78RsM56ntSiuy59lZZQSl7zVY65h18YjYBxyQ\n\t aJ/tqPjCxGmfb6rBmGOOgn+mCuYCA8Rs16P/gv6gMOxLqh8jTEBNSo46B2EoJkqZnx\n\t hA3VitnLvM/HNcBbQUSx1YGFNdmeXPT+/uSFjTINeQSsV3xGSGdE8SwP20Cw526hhW\n\t JviWNIA6IhMWAgBnrZgjaIM41LWeKLzouzxyaChki1LN9YbLUxJq9j3eQr1tn+ZtD0\n\t EOh1InaGrf50Q==","From":"Kaustabh Chakraborty ","Date":"Fri, 24 Apr 2026 01:09:08 +0530","Subject":"[PATCH v5 09/11] Documentation: leds: document pattern behavior of\n Samsung S2M series PMIC RGB LEDs","Precedence":"bulk","X-Mailing-List":"linux-rtc@vger.kernel.org","List-Id":"","List-Subscribe":"","List-Unsubscribe":"","MIME-Version":"1.0","Content-Type":"text/plain; charset=\"utf-8\"","Content-Transfer-Encoding":"7bit","Message-Id":"<20260424-s2mu005-pmic-v5-9-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 , Pavel Machek ,\n Rob Herring , Krzysztof Kozlowski ,\n Conor Dooley , MyungJoo Ham ,\n Chanwoo Choi , Sebastian Reichel ,\n Krzysztof Kozlowski ,\n =?utf-8?q?Andr=C3=A9_Draszik?= ,\n Alexandre Belloni ,\n Jonathan Corbet , Shuah Khan ,\n Nam Tran ,\n =?utf-8?b?xYF1a2FzeiBMZWJpZWR6acWEc2tp?= ","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 "},"content":"Add documentation to describe how hardware patterns (as defined by the\ndocumentation of led-class-multicolor) are parsed and implemented by the\nSamsung S2M series PMIC RGB LED driver.\n\nSigned-off-by: Kaustabh Chakraborty \n---\n Documentation/leds/index.rst | 1 +\n Documentation/leds/leds-s2m-rgb.rst | 60 +++++++++++++++++++++++++++++++++++++\n 2 files changed, 61 insertions(+)","diff":"diff --git a/Documentation/leds/index.rst b/Documentation/leds/index.rst\nindex bebf440042787..23fa9ff7aaf4b 100644\n--- a/Documentation/leds/index.rst\n+++ b/Documentation/leds/index.rst\n@@ -28,6 +28,7 @@ LEDs\n leds-lp5812\n leds-mlxcpld\n leds-mt6370-rgb\n+ leds-s2m-rgb\n leds-sc27xx\n leds-st1202\n leds-qcom-lpg\ndiff --git a/Documentation/leds/leds-s2m-rgb.rst b/Documentation/leds/leds-s2m-rgb.rst\nnew file mode 100644\nindex 0000000000000..4f89a8c89ea86\n--- /dev/null\n+++ b/Documentation/leds/leds-s2m-rgb.rst\n@@ -0,0 +1,60 @@\n+.. SPDX-License-Identifier: GPL-2.0\n+\n+======================================\n+Samsung S2M Series PMIC RGB LED Driver\n+======================================\n+\n+Description\n+-----------\n+\n+The RGB LED on the S2M series PMIC hardware features a three-channel LED that\n+is grouped together as a single device. Furthermore, it supports 8-bit\n+brightness control for each channel. This LED is typically used as a status\n+indicator in mobile devices. It also supports various parameters for hardware\n+patterns.\n+\n+The hardware pattern can be programmed using the \"pattern\" trigger, using the\n+hw_pattern attribute.\n+\n+/sys/class/leds//repeat\n+----------------------------\n+\n+The hardware supports only indefinitely repeating patterns. The repeat\n+attribute must be set to -1 for hardware patterns to function.\n+\n+/sys/class/leds//hw_pattern\n+--------------------------------\n+\n+Specify a hardware pattern for the RGB LEDs.\n+\n+The pattern is a series of brightness levels and durations in milliseconds.\n+There should be only one non-zero brightness level. Unlike the results\n+described in leds-trigger-pattern, the transitions between on and off states\n+are smoothed out by the hardware.\n+\n+Simple pattern::\n+\n+ \"255 3000 0 1000\"\n+\n+ 255 -+ ''''''-. .-'''''''-.\n+ | '. .' '.\n+ | \\ / \\\n+ | '. .' '.\n+ | '-.......-' '-\n+ 0 -+-------+-------+-------+-------+-------+-------+--> time (s)\n+ 0 1 2 3 4 5 6\n+\n+As described in leds-trigger-pattern, it is also possible to use zero-length\n+entries to disable the ramping mechanism.\n+\n+On-Off pattern::\n+\n+ \"255 1000 255 0 0 1000 0 0\"\n+\n+ 255 -+ ------+ +-------+ +-------+\n+ | | | | | |\n+ | | | | | |\n+ | | | | | |\n+ | +-------+ +-------+ +-------\n+ 0 -+-------+-------+-------+-------+-------+-------+--> time (s)\n+ 0 1 2 3 4 5 6\n","prefixes":["v5","09/11"]}