{"id":2222977,"url":"http://patchwork.ozlabs.org/api/patches/2222977/?format=json","web_url":"http://patchwork.ozlabs.org/project/rtc-linux/patch/20260414-s2mu005-pmic-v4-11-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-11-7fe7480577e6@disroot.org>","list_archive_url":null,"date":"2026-04-14T06:33:03","name":"[v4,11/13] 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/20260414-s2mu005-pmic-v4-11-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/2222977/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2222977/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=E+ciTgOa;\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-6327-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=\"E+ciTgOa\"","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 4fvvmF5xg5z1xtJ\n\tfor ; Tue, 14 Apr 2026 16:40: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 C53B230E218C\n\tfor ; Tue, 14 Apr 2026 06:34:31 +0000 (UTC)","from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 55F2E36EA8B;\n\tTue, 14 Apr 2026 06:34:30 +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 EA66136DA02;\n\tTue, 14 Apr 2026 06:34:28 +0000 (UTC)","from [127.0.0.1] (localhost [127.0.0.1])\n\tby disroot.org (Postfix) with ESMTP id 9ABFE265EB;\n\tTue, 14 Apr 2026 08:34:27 +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 UbqiwFGVGqkq; Tue, 14 Apr 2026 08:34:27 +0200 (CEST)"],"ARC-Seal":"i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1776148470; cv=none;\n b=qDRAA5rWxNBzbgprw+a2u+fCP/Qpfk8FEpIGYVhwSrLsM7hnAooDhMNd0lEzE2RkN3Er4pdhI53XVvl/f0nVJy7uSv0KiAZGzLatVwTP2viP67redfbnn2AEV5qeqOKRCgzmOqS7A38KbCj3nBfwM8cyhXw5zfjg4xfLnET530c=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1776148470; 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=lJ/G1ox+/Iytfg4y7jt2PbMlzatGfwdXS9X56MOJvSJ8P9fTJhLL/t/Hn+uFqphSuNKd94mnkVvSD5MZlGNMsU5wvrSljN9uPdSxUt0AfQ3QUTnpn/hhDdzn1W/xORRdqra61V0+UphJE5KuI3lJUvLrn1wAA8xiwrlbMgBYTYE=","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=E+ciTgOa; 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=1776148467; bh=/WI5uPKkfnHPmN5fRkoq5GqgK1SkJOYa870eu3oI8o0=;\n\th=From:Date:Subject:References:In-Reply-To:To:Cc;\n\tb=E+ciTgOa1EC3mpDRvuPcWPMu8qW8SpVjiO15VOPpIP0n3X9ui5lrBNsIWDGSKKwb5\n\t 0XDq6UHfWG9gwk13J36R2VmBq2mUPH6qMPAX05rNwnDhknvSv19UgK4ZVe0zxyAu1S\n\t 4nzpmT8iOsX6WH+oiLdCST1xseNt+9O9Q/kVRr+2Dzf4XaHFmzP2ECYFgCCb1UQH3q\n\t ShYe161FuVxSjYvVD9jtJCz1wnfU3wKUPMC8VUsuLHOTQ6D9zj7XX3edmgTfZvGDUm\n\t UjwCZGCl2eqHk4HMvLHs7y+KsZ3huNAQ/BJQo5fQMFTANMJa83jarpZrNGP1pGuXJD\n\t AKts4jA2yAdcA==","From":"Kaustabh Chakraborty ","Date":"Tue, 14 Apr 2026 12:03:03 +0530","Subject":"[PATCH v4 11/13] 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":"<20260414-s2mu005-pmic-v4-11-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 , 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":["v4","11/13"]}