From nobody Sat Oct 4 11:11:58 2025 Received: from mail-pg1-f180.google.com (mail-pg1-f180.google.com [209.85.215.180]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D1EC723815D; Mon, 18 Aug 2025 01:27:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480430; cv=none; b=Lc27r7T3sOfLc19N8LDlU6MpXEBeNR/yAGuXPaOTOaHDhGfcT5aAik2La3F5YskH7dwplkFMsReYEAcRBw+AwCZMTjMgQN3M2DAJhzDpoA31bF14GpSTydESikXxS9561vfA6MM7dn1ABdGYrvaVT4u5wDv7l/Dv+sfQ7bGyoi4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480430; c=relaxed/simple; bh=qpUFeImvIX2HIQysyDBYMMGyvp34QErh5XN92cx40w4=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=nCQT9an75PEI3XSaoRMl0yo09+oTb33Knn1Okb8SBQ5/Vr0/UE2yjhUUyAH3ht+AlLauhZZ3JNvYCQTSJP5n3b0H7Rp4tOaUgCeoZgqChjdSSMyVqFmF7151hVGGSxRzI6ElnAiRseGtfE4FVX2QmdTVLvLgh8xfyR7QzUG2JKg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=cxZuFNrp; arc=none smtp.client-ip=209.85.215.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="cxZuFNrp" Received: by mail-pg1-f180.google.com with SMTP id 41be03b00d2f7-b4716f46a2eso2535720a12.0; Sun, 17 Aug 2025 18:27:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755480428; x=1756085228; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=MulAQ/sNL6KVZcEs9zWwgkJgydQMoWTgBxU/Pdntzt4=; b=cxZuFNrpPgqQWztS2NDs2zpOKTvmVA/Wy6KHkIfjuPx/v0XdN1RHf3SMr021OI6DFl VhbuJxJ4OGNTmdaoEoDGj7Cldmr1C81hC+aswusQAeBUkOMISujLf0QGsm4ndcI90ky7 JxeJEjOEfPnRqLzyK9UnLc7S4bCwvysCDmv2j9Tgbo3NH9rvda9VwcpGH8CuLSoWwnVt scT+6QEYNPqCO2q9sV/GZ8iPRObw7cG8tFRaiiWfmh3HIzFZ72w9sfsvk7pKi7fqiUfQ cEOo+tKNVs5wH9MfppYKqfOK15aKGoQGFOxTVMLvaKAZ1h/+Skouz6TejVZGVl3Sa/Al j4cw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755480428; x=1756085228; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=MulAQ/sNL6KVZcEs9zWwgkJgydQMoWTgBxU/Pdntzt4=; b=oz3E3EHffwNs7U60P4DvWLz5r5Fp3GbJrggY+G6C9SLiu1s5+YltPY9ns93WSEXhtC kHTC7S9+v3yS0XOUywxTGFWflPd2eoY/0r3x63c1ujcerDREfiAz404R0x4AzvLYPErc OfW/phf52qcfi+9qTdvwGDgj2sVl1tfNsAGBIzPArpczhUz/mX3YirKtTKWnd+fPX70N QkwftIdAgZ4WqR+BAn1AkDaHHlBvT64gQjIFEnJi/NdQtVETvtUhC5CsU/qjFOZSNUI4 hWzXp0yy0YnQWKlsF5rWxImlWa5OSlCEx7QIONMhV4+OC1LvcziEjrI5KKpGT+eBVs/h e45w== X-Forwarded-Encrypted: i=1; AJvYcCV/ju9CZSqXX/l0cmn4BfQzTxPsICfxuxM8BD6nyhVTr2WcYf/8zMNiO2mIgQQQjtGO9RSFOi+m/oJphORF@vger.kernel.org, AJvYcCV8IHzj5SRxDf0q7ctJwVYEAxpe0hnrOQLeNL3XJCoHMzbM+fgd4RBeWxnjmFEmJEKGodaLnnyICoi2@vger.kernel.org, AJvYcCVyR9YQFiFRZBWwijjsGtmkg5G5HRBDJSuFuSutdOjoHcEu4Gq+TzRXQGNZVOGSFWomXuhrCnpH/tufvw==@vger.kernel.org, AJvYcCX1LG//DOQwfU05+NyxHBsSZRBbPXSfVIjClG7Daziags0pwLgPe8eJriaoHBzgtpaK9vVCFJ2zk9DY@vger.kernel.org X-Gm-Message-State: AOJu0Yyj2TZV2sQv9uRpU6HZI/OYzPgTTGfKmcNQqXWOYm/4ajeyB3Jb tEnGzsmc0N4HTqoQfYYnW0l1vMtsVjHm2y5LGcz0pv31CqYlNUvK6tQ7 X-Gm-Gg: ASbGnctDngU2RzEJC/Tns39JdE8kBOCt4yQzHdqVjhOzM/uO9GMGkrxz3sB7KjylMPX Ur/6t56lTmFi/DGWQtjsKNuPyGVv4BhVWDKkZhwpY2wYpvMeeuunUI6rrgm5fxIdPKur6jy1wB5 NQE0utuJQcKZzcuhHEqVhQN50SJtfe0P76tnx7se6IIei5hzC2HAq+sGrGcnodIoMryvxWa6LY7 6d2vjPBQT2jScYS57gjoGPDvB6uV2CR2Az++tTAFuQn+kPYalIiBRh6LeLlD5Q04yaOzFvKQpWP cOiA4ffop71DDOLO67ubMxfPDc3vV/mRVTxIpZJrxwVuXXwzq+xNX/atIi+N7LEakpv3zlEzcdf 5DfdaXocIKFlsEkrpfrwvv4MQj80T39ny3TEzCt53E5pgvVUTEyeJjEM= X-Google-Smtp-Source: AGHT+IHJNhstq0+kDFpFkYyuXuibPJguxk2kmg/ej40076uS98u5gXYePTG665jOOxjne+lfXGF+Yg== X-Received: by 2002:a17:903:22c4:b0:23f:b112:2eaa with SMTP id d9443c01a7336-2446d8fe30fmr145196185ad.41.1755480427914; Sun, 17 Aug 2025 18:27:07 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.116.199.205]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b472d5d7070sm6709620a12.15.2025.08.17.18.27.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Aug 2025 18:27:07 -0700 (PDT) From: Nam Tran To: lee@kernel.org Cc: pavel@kernel.org, rdunlap@infradead.org, christophe.jaillet@wanadoo.fr, krzk+dt@kernel.org, robh@kernel.org, conor+dt@kernel.org, corbet@lwn.net, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org, Nam Tran , Krzysztof Kozlowski Subject: [PATCH v13 RESEND 1/4] dt-bindings: leds: add TI/National Semiconductor LP5812 LED Driver Date: Mon, 18 Aug 2025 08:26:51 +0700 Message-Id: <20250818012654.143058-2-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250818012654.143058-1-trannamatk@gmail.com> References: <20250818012654.143058-1-trannamatk@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The LP5812 is a 4x3 RGB LED driver with an autonomous animation engine and time-cross-multiplexing (TCM) support for up to 12 LEDs or 4 RGB LEDs. It supports both analog (256 levels) and PWM (8-bit) dimming, including exponential PWM for smooth brightness control. Signed-off-by: Nam Tran Reviewed-by: Krzysztof Kozlowski --- .../devicetree/bindings/leds/ti,lp5812.yaml | 229 ++++++++++++++++++ MAINTAINERS | 6 + 2 files changed, 235 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/ti,lp5812.yaml diff --git a/Documentation/devicetree/bindings/leds/ti,lp5812.yaml b/Docume= ntation/devicetree/bindings/leds/ti,lp5812.yaml new file mode 100644 index 000000000000..848cd4f51901 --- /dev/null +++ b/Documentation/devicetree/bindings/leds/ti,lp5812.yaml @@ -0,0 +1,229 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/leds/ti,lp5812.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI LP5812 4x3 Matrix RGB LED Driver with Autonomous Control + +maintainers: + - Nam Tran + +description: | + The LP5812 is a 4x3 matrix RGB LED driver with I2C interface + and autonomous animation engine control. + For more product information please see the link below: + https://www.ti.com/product/LP5812#tech-docs + +properties: + compatible: + const: ti,lp5812 + + reg: + maxItems: 1 + + vcc-supply: + description: Regulator providing power to the 'VCC' pin. + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + +patternProperties: + "^led@[0-3]$": + type: object + $ref: common.yaml# + unevaluatedProperties: false + + properties: + reg: + minimum: 0 + maximum: 3 + + required: + - reg + + "^multi-led@[4-7]$": + type: object + $ref: leds-class-multicolor.yaml# + unevaluatedProperties: false + + properties: + reg: + minimum: 4 + maximum: 7 + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + + patternProperties: + "^led@[4-9a-f]$": + type: object + $ref: common.yaml# + unevaluatedProperties: false + + properties: + reg: + minimum: 4 + maximum: 15 + + required: + - reg + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + #include + + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + + led-controller@1b { + #address-cells =3D <1>; + #size-cells =3D <0>; + compatible =3D "ti,lp5812"; + reg =3D <0x1b>; + vcc-supply =3D <&vdd_3v3_reg>; + + led@0 { + reg =3D <0x0>; + label =3D "LED0"; + led-max-microamp =3D <25500>; + }; + + led@1 { + reg =3D <0x1>; + label =3D "LED1"; + led-max-microamp =3D <25500>; + }; + + led@2 { + reg =3D <0x2>; + label =3D "LED2"; + led-max-microamp =3D <25500>; + }; + + led@3 { + reg =3D <0x3>; + label =3D "LED3"; + led-max-microamp =3D <25500>; + }; + + multi-led@4 { + #address-cells =3D <1>; + #size-cells =3D <0>; + reg =3D <0x4>; + color =3D ; + label =3D "LED_A"; + + led@4 { + reg =3D <0x4>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@5 { + reg =3D <0x5>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@6 { + reg =3D <0x6>; + color =3D ; + led-max-microamp =3D <25500>; + }; + }; + + multi-led@5 { + #address-cells =3D <1>; + #size-cells =3D <0>; + reg =3D <0x5>; + color =3D ; + label =3D "LED_B"; + + led@7 { + reg =3D <0x7>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@8 { + reg =3D <0x8>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@9 { + reg =3D <0x9>; + color =3D ; + led-max-microamp =3D <25500>; + }; + }; + + multi-led@6 { + #address-cells =3D <1>; + #size-cells =3D <0>; + reg =3D <0x6>; + color =3D ; + label =3D "LED_C"; + + led@a { + reg =3D <0xa>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@b { + reg =3D <0xb>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@c { + reg =3D <0xc>; + color =3D ; + led-max-microamp =3D <25500>; + }; + }; + + multi-led@7 { + #address-cells =3D <1>; + #size-cells =3D <0>; + reg =3D <0x7>; + color =3D ; + label =3D "LED_D"; + + led@d { + reg =3D <0xd>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@e { + reg =3D <0xe>; + color =3D ; + led-max-microamp =3D <25500>; + }; + + led@f { + reg =3D <0xf>; + color =3D ; + led-max-microamp =3D <25500>; + }; + }; + }; + }; + +... diff --git a/MAINTAINERS b/MAINTAINERS index 4f03e230f3c5..99512777b890 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24823,6 +24823,12 @@ S: Supported F: Documentation/devicetree/bindings/iio/dac/ti,dac7612.yaml F: drivers/iio/dac/ti-dac7612.c =20 +TEXAS INSTRUMENTS' LP5812 RGB LED DRIVER +M: Nam Tran +L: linux-leds@vger.kernel.org +S: Maintained +F: Documentation/devicetree/bindings/leds/ti,lp5812.yaml + TEXAS INSTRUMENTS' LB8864 LED BACKLIGHT DRIVER M: Alexander Sverdlin L: linux-leds@vger.kernel.org --=20 2.25.1 From nobody Sat Oct 4 11:11:58 2025 Received: from mail-pj1-f52.google.com (mail-pj1-f52.google.com [209.85.216.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F1D0E230274; Mon, 18 Aug 2025 01:27:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480445; cv=none; b=V+DmgYbV81zUjZeoFzUcJ+K60HRHRC7CRqozi6zMaUjgZq3F7aKc3ttCjTRzhZ1Gce3aXrjj4Zkl2BTPluLfQPv8QP2UR5/fFExQJSmXD1N0dO4238mfhtK+rIsESCIQmiRoRF8CKqz3UuPcYuAiUe8c/Hvf22qczkXmLr3wcbk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480445; c=relaxed/simple; bh=H+IKFMEoXMe7Upp7or+qq+zfod/uMtBtw6qx73W+ZN4=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=uHtM6beyoSAPAQsDuNEJOosXlHQIY5xdOjnE9KyGcKmR3td1ryw8c2jDMzLc9ux01jeOvOJCKIdviZbHVYaTvydtDwHZS61stSWLmg1AUpV2AOa8hryQSeqQRfxaVvv1clG1Wzbir+jQtna0l9Ku1a2q0cTUa5NeHVrnBZTSG2U= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=lmL1cnmn; arc=none smtp.client-ip=209.85.216.52 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="lmL1cnmn" Received: by mail-pj1-f52.google.com with SMTP id 98e67ed59e1d1-323266b1d1aso1937638a91.0; Sun, 17 Aug 2025 18:27:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755480442; x=1756085242; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=CmjCRBjoGxlvUDr2Er4zp6PQKIxULc9/0J4o0Dl4450=; b=lmL1cnmnRRtec/eprYwkqLHq015rqnyEcJ/Coz0n5+XA1uzecPY4gWwiVKKGOEKGIB FDkoRRAoCVg1qiiHfTkRonkiISmwCr+Q2JwH1TmVP20YwclGbum5APOPtTyl1eWBBUk3 gE/B6WLO0Mg/iP3SsBFWnNcDR66DPpXL7YWnwEivHY/FD6UGTy7H41Tr9htDBBFcngyF uBhoWMgG82wZfY6CCr86j7czrSe0mPVPzDShMZKChi1otNjpohCVvVgWwSHSklQyaBBv aiPTlb0+0qMAMBCEZ20FS/urJU9IKV576FjLtQaVvE7snPxraHaO6SbNKjlSpPtCbF8A F1vg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755480442; x=1756085242; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=CmjCRBjoGxlvUDr2Er4zp6PQKIxULc9/0J4o0Dl4450=; b=u5a+foUoKM7z+0u760PIY8gLpKYvDzsFybjzuSZ5aZ7dUTOpS/5c0ubrGB4pdkujTV NJ73ATA/gyNtc+nfNNCrXT7I3+5LiXTwZXEriATOTRmYDqmhcUEOyVC4hTXhnNjh/V+q PvQqB9X6POxtqb0RiSbrvRqI3mSaTjL14eSr3eanRSosa+o6szPXR/Jyflj3D06OWAnu RTRbXykoXcZ5ZwfgI8R2wqnSi8GSRNQrHrTP2OGn/LBnL2dsd5I3nbUrQJ/jLF9qBkZX 2XJn0Y/L3wEhFiT8YIKydguGJ4d+kWbVej/1nUN8XQSchB3px/YT6btvdC8/ddjOpTDH i/QQ== X-Forwarded-Encrypted: i=1; AJvYcCUfYF3Mzfu2/YRf8OLCTQx6bjKPpsgjsbq+/qCCI2H5mWqcC6aPtYK2aS/Wgn9AgfU2AZIrwwYfYXXmDg==@vger.kernel.org, AJvYcCVV+kY0QxjZpca+veZy8/52+bbDpubhcWO4o8V0wf/wr1BL2DDEmXjAixxBKsDkURsBPu0PH/DWkwTx@vger.kernel.org, AJvYcCVq0uXjK7Vr1E0fuNiJ/Wm+6fLXQALpBrUBc+7V1Dyi2WMH7XSA/OiaSpkao/kuGPXouQGg3MVHoROtCfWv@vger.kernel.org, AJvYcCWFkHYhL6TjOmyEe2ys14CIMhUP7Qism0VBR11zlfeaYM8p19kWQteMl73A0IZ36vPukgAjjGC3G5jU@vger.kernel.org X-Gm-Message-State: AOJu0YylHpurxscIujZYMgZGHkceqNVixocuuY5q2x4gEDKCGTxgZpNk Xe1MKjVOo7XiD5AkjqriWdKNpItqTn8ys1Ji//cZ9qLqSMZJfkOAXdxY X-Gm-Gg: ASbGncuHchWGTl1USN4G43zHNzY0ScF5k51sifJNSwJyWs49PukPMbGBNXw4mAXPmrz qh6RaHuiNVzcUitkB1J3b+MDMDk8Rbm3CIpi3aObGVEX4LTbWjRU5FpDCVz+L6ktgcmal149isk TmiGTmm8hfT870FZcTnv5CIxMnfhbmxnXgBLpWMvwSHWvb33xGnRpeZDmu++zfU7EkyO+iqoFe2 zaOIrludCBC0cQpAD3jfB8fMvgcNMciXGP5+z2q5nJnueBgSMwbY8RJYCqykG+n97G68mBi3xfV LdwbB667cpGlo+iJTNda79moHXG1vP+v6Ux82sFR4WeRNS7Rqa65IUWz5aaJIT1IQ/fsaHUn/yW KAnVG0PeVVI/K1xveI1AL8p7WpRFwbyIFEqOTx/d2jmTa X-Google-Smtp-Source: AGHT+IGdOkaO8VfKvBOoQsqWJB+zLTLOWyL5rOjNvmQZved/YJOc7KARKGu/Se2pyX9+OEWh7jbfSA== X-Received: by 2002:a17:90b:2dd0:b0:31e:f351:bfec with SMTP id 98e67ed59e1d1-32341e5e0a4mr16929880a91.0.1755480441924; Sun, 17 Aug 2025 18:27:21 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.116.199.205]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b472d5d7070sm6709620a12.15.2025.08.17.18.27.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Aug 2025 18:27:21 -0700 (PDT) From: Nam Tran To: lee@kernel.org Cc: pavel@kernel.org, rdunlap@infradead.org, christophe.jaillet@wanadoo.fr, krzk+dt@kernel.org, robh@kernel.org, conor+dt@kernel.org, corbet@lwn.net, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org, Nam Tran Subject: [PATCH v13 RESEND 2/4] leds: add basic support for TI/National Semiconductor LP5812 LED Driver Date: Mon, 18 Aug 2025 08:26:52 +0700 Message-Id: <20250818012654.143058-3-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250818012654.143058-1-trannamatk@gmail.com> References: <20250818012654.143058-1-trannamatk@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The LP5812 is a 4x3 matrix RGB LED driver with an autonomous animation engine and time-cross-multiplexing (TCM) support for up to 12 LEDs or 4 RGB LEDs. Each LED can be configured through the related registers to realize vivid and fancy lighting effects. This patch adds minimal driver support for the LP5812, implementing only the essential functionality: I2C communication with the device, LED registration, brightness control in manual mode, and basic sysfs interfaces for LED configuration and fault monitoring. Signed-off-by: Nam Tran --- MAINTAINERS | 4 + drivers/leds/rgb/Kconfig | 13 + drivers/leds/rgb/Makefile | 1 + drivers/leds/rgb/leds-lp5812.c | 1086 ++++++++++++++++++++++++++++++++ drivers/leds/rgb/leds-lp5812.h | 164 +++++ 5 files changed, 1268 insertions(+) create mode 100644 drivers/leds/rgb/leds-lp5812.c create mode 100644 drivers/leds/rgb/leds-lp5812.h diff --git a/MAINTAINERS b/MAINTAINERS index 99512777b890..c2e1c02e206d 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24828,6 +24828,10 @@ M: Nam Tran L: linux-leds@vger.kernel.org S: Maintained F: Documentation/devicetree/bindings/leds/ti,lp5812.yaml +F: drivers/leds/rgb/Kconfig +F: drivers/leds/rgb/Makefile +F: drivers/leds/rgb/leds-lp5812.c +F: drivers/leds/rgb/leds-lp5812.h =20 TEXAS INSTRUMENTS' LB8864 LED BACKLIGHT DRIVER M: Alexander Sverdlin diff --git a/drivers/leds/rgb/Kconfig b/drivers/leds/rgb/Kconfig index 222d943d826a..28ef4c487367 100644 --- a/drivers/leds/rgb/Kconfig +++ b/drivers/leds/rgb/Kconfig @@ -26,6 +26,19 @@ config LEDS_KTD202X To compile this driver as a module, choose M here: the module will be called leds-ktd202x. =20 +config LEDS_LP5812 + tristate "LED support for Texas Instruments LP5812" + depends on I2C + help + If you say Y here you get support for TI LP5812 LED driver. + The LP5812 is a 4x3 matrix RGB LED driver with autonomous + animation engine control. + + To compile this driver as a module, choose M here: the + module will be called leds-lp5812. + + If unsure, say N. + config LEDS_NCP5623 tristate "LED support for NCP5623" depends on I2C diff --git a/drivers/leds/rgb/Makefile b/drivers/leds/rgb/Makefile index a501fd27f179..be45991f63f5 100644 --- a/drivers/leds/rgb/Makefile +++ b/drivers/leds/rgb/Makefile @@ -2,6 +2,7 @@ =20 obj-$(CONFIG_LEDS_GROUP_MULTICOLOR) +=3D leds-group-multicolor.o obj-$(CONFIG_LEDS_KTD202X) +=3D leds-ktd202x.o +obj-$(CONFIG_LEDS_LP5812) +=3D leds-lp5812.o obj-$(CONFIG_LEDS_NCP5623) +=3D leds-ncp5623.o obj-$(CONFIG_LEDS_PWM_MULTICOLOR) +=3D leds-pwm-multicolor.o obj-$(CONFIG_LEDS_QCOM_LPG) +=3D leds-qcom-lpg.o diff --git a/drivers/leds/rgb/leds-lp5812.c b/drivers/leds/rgb/leds-lp5812.c new file mode 100644 index 000000000000..fb5ea449761a --- /dev/null +++ b/drivers/leds/rgb/leds-lp5812.c @@ -0,0 +1,1086 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * LP5812 LED driver + * + * Copyright (C) 2025 Texas Instruments + * + * Author: Jared Zhou + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "leds-lp5812.h" + +static int lp5812_write(struct lp5812_chip *chip, u16 reg, u8 val) +{ + struct device *dev =3D &chip->client->dev; + struct i2c_msg msg; + u8 buf[2]; + u8 extracted_bits; + int ret; + + /* Extract register address bits 9 and 8 for Address Byte 1 */ + extracted_bits =3D (reg >> 8) & 0x03; + + /* Prepare payload: Address Byte 2 (bits [7:0]) and value to write */ + buf[0] =3D (u8)(reg & 0xFF); + buf[1] =3D val; + + /* Construct I2C message for a write operation */ + msg.addr =3D (chip->client->addr << 2) | extracted_bits; + msg.flags =3D 0; + msg.len =3D sizeof(buf); + msg.buf =3D buf; + + ret =3D i2c_transfer(chip->client->adapter, &msg, 1); + if (ret !=3D 1) { + dev_err(dev, "I2C write error, ret=3D%d\n", ret); + ret =3D ret < 0 ? ret : -EIO; + } else { + ret =3D 0; + } + + return ret; +} + +static int lp5812_read(struct lp5812_chip *chip, u16 reg, u8 *val) +{ + struct device *dev =3D &chip->client->dev; + struct i2c_msg msgs[2]; + u8 ret_val; + u8 extracted_bits; + u8 converted_reg; + int ret; + + /* Extract register address bits 9 and 8 for Address Byte 1 */ + extracted_bits =3D (reg >> 8) & 0x03; + + /* Lower 8 bits go in Address Byte 2 */ + converted_reg =3D (u8)(reg & 0xFF); + + /* Prepare I2C write message to set register address */ + msgs[0].addr =3D (chip->client->addr << 2) | extracted_bits; + msgs[0].flags =3D 0; + msgs[0].len =3D 1; + msgs[0].buf =3D &converted_reg; + + /* Prepare I2C read message to retrieve register value */ + msgs[1].addr =3D (chip->client->addr << 2) | extracted_bits; + msgs[1].flags =3D I2C_M_RD; + msgs[1].len =3D 1; + msgs[1].buf =3D &ret_val; + + ret =3D i2c_transfer(chip->client->adapter, msgs, 2); + if (ret !=3D 2) { + dev_err(dev, "I2C read error, ret=3D%d\n", ret); + *val =3D 0; + ret =3D ret < 0 ? ret : -EIO; + } else { + /* Store the value retrieved from the hardware */ + *val =3D ret_val; + ret =3D 0; + } + + return ret; +} + +static int lp5812_read_tsd_config_status(struct lp5812_chip *chip, u8 *reg= _val) +{ + return lp5812_read(chip, chip->cfg->reg_tsd_config_status.addr, reg_val); +} + +static int lp5812_update_regs_config(struct lp5812_chip *chip) +{ + u8 reg_val; + int ret; + + ret =3D lp5812_write(chip, chip->cfg->reg_cmd_update.addr, LP5812_UPDATE_= CMD_VAL); + if (ret) + return ret; + + ret =3D lp5812_read_tsd_config_status(chip, ®_val); /* Save register v= alue */ + if (ret) + return ret; + + return reg_val & 0x01; +} + +static int lp5812_fault_clear(struct lp5812_chip *chip, u8 value) +{ + u8 reg_val; + + if (value =3D=3D 0) + reg_val =3D LOD_CLEAR_VAL; + else if (value =3D=3D 1) + reg_val =3D LSD_CLEAR_VAL; + else if (value =3D=3D 2) + reg_val =3D TSD_CLEAR_VAL; + else if (value =3D=3D 3) + reg_val =3D FAULT_CLEAR_ALL; + else + return -EINVAL; + + return lp5812_write(chip, chip->cfg->reg_reset.addr, reg_val); +} + +static void set_mix_sel_led(struct lp5812_chip *chip, int mix_sel_led) +{ + if (mix_sel_led =3D=3D 0) + chip->u_drive_mode.s_drive_mode.mix_sel_led_0 =3D 1; + + if (mix_sel_led =3D=3D 1) + chip->u_drive_mode.s_drive_mode.mix_sel_led_1 =3D 1; + + if (mix_sel_led =3D=3D 2) + chip->u_drive_mode.s_drive_mode.mix_sel_led_2 =3D 1; + + if (mix_sel_led =3D=3D 3) + chip->u_drive_mode.s_drive_mode.mix_sel_led_3 =3D 1; +} + +static ssize_t parse_drive_mode(struct lp5812_chip *chip, char *str) +{ + char *sub_str; + int tcm_scan_num, mix_scan_num, mix_sel_led, scan_oder[4], i, ret; + + chip->u_drive_mode.s_drive_mode.mix_sel_led_0 =3D 0; + chip->u_drive_mode.s_drive_mode.mix_sel_led_1 =3D 0; + chip->u_drive_mode.s_drive_mode.mix_sel_led_2 =3D 0; + chip->u_drive_mode.s_drive_mode.mix_sel_led_3 =3D 0; + + sub_str =3D strsep(&str, ":"); + if (sysfs_streq(sub_str, "direct_mode")) { + chip->u_drive_mode.s_drive_mode.led_mode =3D 0; + } else if (sysfs_streq(sub_str, "tcmscan")) { + /* Get tcm scan number */ + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + ret =3D kstrtoint(sub_str, 0, &tcm_scan_num); + if (ret) + return ret; + if (tcm_scan_num < 0 || tcm_scan_num > 4) + return -EINVAL; + chip->u_drive_mode.s_drive_mode.led_mode =3D tcm_scan_num; + + for (i =3D 0; i < tcm_scan_num; i++) { + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + ret =3D kstrtoint(sub_str, 0, &scan_oder[i]); + if (ret) + return ret; + } + + chip->u_scan_order.s_scan_order.scan_order_0 =3D scan_oder[0]; + chip->u_scan_order.s_scan_order.scan_order_1 =3D scan_oder[1]; + chip->u_scan_order.s_scan_order.scan_order_2 =3D scan_oder[2]; + chip->u_scan_order.s_scan_order.scan_order_3 =3D scan_oder[3]; + } else if (sysfs_streq(sub_str, "mixscan")) { + /* Get mix scan number */ + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + ret =3D kstrtoint(sub_str, 0, &mix_scan_num); + if (ret) + return ret; + if (mix_scan_num < 0 || mix_scan_num > 3) + return -EINVAL; + + chip->u_drive_mode.s_drive_mode.led_mode =3D mix_scan_num + 4; + /* Get mix_sel_led */ + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + ret =3D kstrtoint(sub_str, 0, &mix_sel_led); + if (ret) + return ret; + if (mix_sel_led < 0 || mix_sel_led > 3) + return -EINVAL; + set_mix_sel_led(chip, mix_sel_led); + + for (i =3D 0; i < mix_scan_num; i++) { + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + ret =3D kstrtoint(sub_str, 0, &scan_oder[i]); + if (ret) + return ret; + if (scan_oder[i] =3D=3D mix_sel_led || scan_oder[i] < 0 || scan_oder[i]= > 3) + return -EINVAL; + } + chip->u_scan_order.s_scan_order.scan_order_0 =3D scan_oder[0]; + chip->u_scan_order.s_scan_order.scan_order_1 =3D scan_oder[1]; + chip->u_scan_order.s_scan_order.scan_order_2 =3D scan_oder[2]; + chip->u_scan_order.s_scan_order.scan_order_3 =3D scan_oder[3]; + } else { + return -EINVAL; + } + return 0; +} + +static int lp5812_set_drive_mode_scan_order(struct lp5812_chip *chip) +{ + u8 val; + int ret; + + /* Set led mode */ + val =3D chip->u_drive_mode.drive_mode_val; + ret =3D lp5812_write(chip, chip->cfg->reg_dev_config_1.addr, val); + if (ret) + return ret; + + /* Setup scan order */ + val =3D chip->u_scan_order.scan_order_val; + ret =3D lp5812_write(chip, chip->cfg->reg_dev_config_2.addr, val); + + return ret; +} + +static ssize_t dev_config_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + struct lp5812_led *led =3D i2c_get_clientdata(to_i2c_client(dev)); + struct lp5812_chip *chip =3D led->chip; + int ret; + + guard(mutex)(&chip->lock); + ret =3D parse_drive_mode(chip, (char *)buf); + if (ret) + return ret; + + ret =3D lp5812_set_drive_mode_scan_order(chip); + if (ret) + return ret; + + ret =3D lp5812_update_regs_config(chip); + if (ret) + return ret; + + return len; +} + +static ssize_t fault_clear_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + struct lp5812_led *led =3D i2c_get_clientdata(to_i2c_client(dev)); + struct lp5812_chip *chip =3D led->chip; + int fault_clear, ret; + + ret =3D kstrtoint(buf, 0, &fault_clear); + if (ret) + return ret; + + if (fault_clear < 0 || fault_clear > 3) + return -EINVAL; + + guard(mutex)(&chip->lock); + ret =3D lp5812_fault_clear(chip, fault_clear); + if (ret) + return -EIO; + + return len; +} + +static ssize_t tsd_config_status_show(struct device *dev, + struct device_attribute *attr, char *buf) +{ + struct lp5812_led *led =3D i2c_get_clientdata(to_i2c_client(dev)); + struct lp5812_chip *chip =3D led->chip; + int tsd_stat, config_stat, ret; + u8 reg_val; + + guard(mutex)(&chip->lock); + ret =3D lp5812_read(chip, chip->cfg->reg_tsd_config_status.addr, ®_val= ); + if (ret) + return -EIO; + tsd_stat =3D (reg_val >> 1) & 0x01; + config_stat =3D reg_val & 0x01; + + return sysfs_emit(buf, "%d %d\n", tsd_stat, config_stat); +} + +static ssize_t sw_reset_store(struct device *dev, struct device_attribute = *attr, + const char *buf, size_t len) +{ + struct lp5812_led *led =3D i2c_get_clientdata(to_i2c_client(dev)); + struct lp5812_chip *chip =3D led->chip; + int reset, ret; + + ret =3D kstrtoint(buf, 0, &reset); + if (ret) + return ret; + + if (reset !=3D 1) + return -EINVAL; + + guard(mutex)(&chip->lock); + ret =3D lp5812_write(chip, chip->cfg->reg_reset.addr, LP5812_RESET); + if (ret) + return -EIO; + + return len; +} + +static int lp5812_read_lod_status(struct lp5812_chip *chip, int led_number= , u8 *val) +{ + u8 reg_val; + u16 reg; + int ret; + + if (!val) + return -1; + + if (led_number < 0x8) + reg =3D chip->cfg->reg_lod_status_base.addr; + else + reg =3D chip->cfg->reg_lod_status_base.addr + 1; + + ret =3D lp5812_read(chip, reg, ®_val); + if (ret) + return ret; + + *val =3D (reg_val & (1 << (led_number % 8))) ? 1 : 0; + + return ret; +} + +static int lp5812_read_lsd_status(struct lp5812_chip *chip, int led_number= , u8 *val) +{ + u8 reg_val; + u16 reg; + int ret; + + if (!val) + return -1; + + if (led_number < 0x8) + reg =3D chip->cfg->reg_lsd_status_base.addr; + else + reg =3D chip->cfg->reg_lsd_status_base.addr + 1; + + ret =3D lp5812_read(chip, reg, ®_val); + if (ret) + return ret; + + *val =3D (reg_val & (1 << (led_number % 8))) ? 1 : 0; + + return ret; +} + +static int lp5812_set_led_mode(struct lp5812_chip *chip, int led_number, + enum control_mode mode) +{ + u8 reg_val; + u16 reg; + int ret; + + if (led_number <=3D 7) + reg =3D chip->cfg->reg_dev_config_3.addr; + else + reg =3D chip->cfg->reg_dev_config_4.addr; + + ret =3D lp5812_read(chip, reg, ®_val); + if (ret) + return ret; + + if (mode =3D=3D LP5812_MODE_MANUAL) + reg_val &=3D ~(1 << (led_number % 8)); + else + reg_val |=3D (1 << (led_number % 8)); + + ret =3D lp5812_write(chip, reg, reg_val); + if (ret) + return ret; + + ret =3D lp5812_update_regs_config(chip); + + return ret; +} + +static int lp5812_get_led_mode(struct lp5812_chip *chip, int led_number, + enum control_mode *mode) +{ + u8 reg_val; + u16 reg; + int ret; + + if (led_number <=3D 7) + reg =3D chip->cfg->reg_dev_config_3.addr; + else + reg =3D chip->cfg->reg_dev_config_4.addr; + + ret =3D lp5812_read(chip, reg, ®_val); + if (ret) + return ret; + + *mode =3D (reg_val & (1 << (led_number % 8))) ? LP5812_MODE_AUTONOMOUS : = LP5812_MODE_MANUAL; + return 0; +} + +static int lp5812_manual_dc_pwm_control(struct lp5812_chip *chip, int led_= number, + u8 val, enum dimming_type dimming_type) +{ + u16 led_base_reg; + int ret; + + if (dimming_type =3D=3D LP5812_DIMMING_ANALOG) + led_base_reg =3D chip->cfg->reg_manual_dc_base.addr; + else + led_base_reg =3D chip->cfg->reg_manual_pwm_base.addr; + ret =3D lp5812_write(chip, led_base_reg + led_number, val); + + return ret; +} + +static int lp5812_auto_dc(struct lp5812_chip *chip, + int led_number, u8 val) +{ + return lp5812_write(chip, chip->cfg->reg_auto_dc_base.addr + led_number, = val); +} + +static int lp5812_multicolor_brightness(struct lp5812_led *led) +{ + int ret, i; + struct lp5812_chip *chip =3D led->chip; + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led->mc_cdev.num_colors; i++) { + ret =3D lp5812_manual_dc_pwm_control(chip, led->mc_cdev.subled_info[i].c= hannel, + led->mc_cdev.subled_info[i].brightness, + LP5812_DIMMING_PWM); + if (ret) + return ret; + } + + return 0; +} + +static int lp5812_led_brightness(struct lp5812_led *led) +{ + struct lp5812_chip *chip =3D led->chip; + struct lp5812_led_config *led_cfg; + int ret; + + led_cfg =3D &chip->led_config[led->chan_nr]; + + guard(mutex)(&chip->lock); + ret =3D lp5812_manual_dc_pwm_control(chip, led_cfg->led_id[0], + led->brightness, LP5812_DIMMING_PWM); + + return ret; +} + +static ssize_t activate_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + struct lp5812_led *led; + struct lp5812_chip *chip; + struct lp5812_led_config *led_cfg; + char *sub_str, *str =3D (char *)buf; + u8 reg_val, chan_nr =3D 0; + u16 reg; + int val[LED_COLOR_ID_MAX]; + int i, ret; + + led =3D dev->platform_data; + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->led_config[chan_nr]; + for (i =3D 0; i < led_cfg->num_colors; i++) { + sub_str =3D strsep(&str, " "); + if (!sub_str) + return -EINVAL; + if (kstrtoint(sub_str, 0, &val[i])) + return -EINVAL; + if (val[i] !=3D 0 && val[i] !=3D 1) + return -EINVAL; + } + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led_cfg->num_colors; i++) { + if (led_cfg->led_id[i] < 0x8) + reg =3D chip->cfg->reg_led_en_1.addr; + else + reg =3D chip->cfg->reg_led_en_2.addr; + + ret =3D lp5812_read(chip, reg, ®_val); + if (ret) + return -EIO; + + if (val[i] =3D=3D 0) + reg_val &=3D ~(1 << (led_cfg->led_id[i] % 8)); + else + reg_val |=3D (1 << (led_cfg->led_id[i] % 8)); + + ret =3D lp5812_write(chip, reg, reg_val); + if (ret) + return -EIO; + } + + return len; +} + +static ssize_t led_current_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + struct lp5812_led *led; + struct lp5812_chip *chip; + struct lp5812_led_config *led_cfg; + enum control_mode mode; + char *sub_str, *str =3D (char *)buf; + u8 chan_nr =3D 0; + int val[LED_COLOR_ID_MAX]; + int i, ret; + + led =3D dev->platform_data; + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->led_config[chan_nr]; + for (i =3D 0; i < led_cfg->num_colors; i++) { + sub_str =3D strsep(&str, " "); + if (!sub_str) + return -EINVAL; + if (kstrtoint(sub_str, 0, &val[i])) + return -EINVAL; + } + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led_cfg->num_colors; i++) { + ret =3D lp5812_get_led_mode(chip, led_cfg->led_id[i], &mode); + if (ret) + return -EIO; + + if (mode =3D=3D 1) + ret =3D lp5812_auto_dc(chip, led_cfg->led_id[i], val[i]); + else + ret =3D lp5812_manual_dc_pwm_control(chip, led_cfg->led_id[i], + val[i], LP5812_DIMMING_ANALOG); + if (ret) + return -EIO; + } + + return len; +} + +static ssize_t lod_lsd_show(struct device *dev, + struct device_attribute *attr, + char *buf) +{ + struct lp5812_led *led; + struct lp5812_chip *chip; + struct lp5812_led_config *led_cfg; + u8 chan_nr =3D 0, i, lsd_status, lod_status; + int size =3D 0, ret; + + led =3D dev->platform_data; + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->led_config[chan_nr]; + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led_cfg->num_colors; i++) { + ret =3D lp5812_read_lsd_status(chip, led_cfg->led_id[i], &lsd_status); + if (!ret) + ret =3D lp5812_read_lod_status(chip, led_cfg->led_id[i], &lod_status); + if (ret) + return -EIO; + + size +=3D sysfs_emit_at(buf, size, "%d:%d %d\n", + led_cfg->led_id[i], lod_status, lsd_status); + } + return size; +} + +static ssize_t max_current_show(struct device *dev, + struct device_attribute *attr, + char *buf) +{ + struct lp5812_led *led; + struct lp5812_chip *chip; + u8 val; + int ret; + + led =3D dev->platform_data; + chip =3D led->chip; + + guard(mutex)(&chip->lock); + ret =3D lp5812_read(chip, chip->cfg->reg_dev_config_0.addr, &val); + if (ret) + return ret; + + return sysfs_emit(buf, "%d\n", (val & 0x01)); +} + +static DEVICE_ATTR_WO(led_current); +static DEVICE_ATTR_RO(max_current); +static DEVICE_ATTR_WO(activate); +static DEVICE_ATTR_RO(lod_lsd); + +static struct attribute *lp5812_led_attrs[] =3D { + &dev_attr_led_current.attr, + &dev_attr_max_current.attr, + &dev_attr_activate.attr, + &dev_attr_lod_lsd.attr, + NULL +}; +ATTRIBUTE_GROUPS(lp5812_led); + +static int lp5812_set_brightness(struct led_classdev *cdev, + enum led_brightness brightness) +{ + struct lp5812_led *led =3D container_of(cdev, struct lp5812_led, cdev); + + led->brightness =3D (u8)brightness; + return lp5812_led_brightness(led); +} + +static int lp5812_set_mc_brightness(struct led_classdev *cdev, + enum led_brightness brightness) +{ + struct led_classdev_mc *mc_dev =3D lcdev_to_mccdev(cdev); + struct lp5812_led *led =3D container_of(mc_dev, struct lp5812_led, mc_cde= v); + + led_mc_calc_color_components(&led->mc_cdev, brightness); + return lp5812_multicolor_brightness(led); +} + +static int lp5812_init_led(struct lp5812_led *led, struct lp5812_chip *chi= p, int chan) +{ + struct device *dev =3D &chip->client->dev; + struct mc_subled *mc_led_info; + struct led_classdev *led_cdev; + int i, ret; + + if (chip->led_config[chan].name) { + led->cdev.name =3D chip->led_config[chan].name; + } else { + led->cdev.name =3D devm_kasprintf(dev, GFP_KERNEL, "%s:channel%d", + chip->label ? : chip->client->name, chan); + if (!led->cdev.name) + return -ENOMEM; + } + + if (!chip->led_config[chan].is_sc_led) { + mc_led_info =3D devm_kcalloc(dev, + chip->led_config[chan].num_colors, + sizeof(*mc_led_info), GFP_KERNEL); + if (!mc_led_info) + return -ENOMEM; + + led_cdev =3D &led->mc_cdev.led_cdev; + led_cdev->name =3D led->cdev.name; + led_cdev->brightness_set_blocking =3D lp5812_set_mc_brightness; + led->mc_cdev.num_colors =3D chip->led_config[chan].num_colors; + for (i =3D 0; i < led->mc_cdev.num_colors; i++) { + mc_led_info[i].color_index =3D + chip->led_config[chan].color_id[i]; + mc_led_info[i].channel =3D + chip->led_config[chan].led_id[i]; + } + + led->mc_cdev.subled_info =3D mc_led_info; + } else { + led->cdev.brightness_set_blocking =3D lp5812_set_brightness; + } + + led->cdev.groups =3D lp5812_led_groups; + led->chan_nr =3D chan; + + if (chip->led_config[chan].is_sc_led) { + ret =3D devm_led_classdev_register(dev, &led->cdev); + if (ret =3D=3D 0) + led->cdev.dev->platform_data =3D led; + } else { + ret =3D devm_led_classdev_multicolor_register(dev, &led->mc_cdev); + if (ret =3D=3D 0) { + led->mc_cdev.led_cdev.dev->platform_data =3D led; + ret =3D sysfs_create_groups(&led->mc_cdev.led_cdev.dev->kobj, + lp5812_led_groups); + if (ret) + dev_err(dev, "sysfs_create_groups failed\n"); + } + } + + return ret; +} + +static int lp5812_register_leds(struct lp5812_led *led, struct lp5812_chip= *chip) +{ + struct lp5812_led *each; + int num_channels =3D chip->num_channels; + int ret, i, j; + + for (i =3D 0; i < num_channels; i++) { + each =3D led + i; + ret =3D lp5812_init_led(each, chip, i); + if (ret) + goto err_init_led; + + each->chip =3D chip; + + for (j =3D 0; j < chip->led_config[i].num_colors; j++) { + ret =3D lp5812_auto_dc(chip, chip->led_config[i].led_id[j], + chip->led_config[i].led_id[j]); + if (ret) + goto err_init_led; + + ret =3D lp5812_set_led_mode(chip, chip->led_config[i].led_id[j], + LP5812_MODE_MANUAL); + if (ret) + goto err_init_led; + } + } + + return 0; + +err_init_led: + return ret; +} + +static int lp5812_register_sysfs(struct lp5812_chip *chip) +{ + struct device *dev =3D &chip->client->dev; + const struct lp5812_device_config *cfg =3D chip->cfg; + int ret; + + ret =3D sysfs_create_group(&dev->kobj, cfg->dev_attr_group); + if (ret) + return ret; + + return 0; +} + +static void lp5812_unregister_sysfs(struct lp5812_led *led, struct lp5812_= chip *chip) +{ + struct device *dev =3D &chip->client->dev; + const struct lp5812_device_config *cfg =3D chip->cfg; + struct lp5812_led *each; + int i; + + sysfs_remove_group(&dev->kobj, cfg->dev_attr_group); + + for (i =3D 0; i < chip->num_channels; i++) { + if (!chip->led_config[i].is_sc_led) { + each =3D led + i; + sysfs_remove_groups(&each->mc_cdev.led_cdev.dev->kobj, lp5812_led_group= s); + } + } +} + +static int lp5812_init_device(struct lp5812_chip *chip) +{ + int ret; + + usleep_range(1000, 1100); + + ret =3D lp5812_write(chip, chip->cfg->reg_chip_en.addr, (u8)1); + if (ret) { + dev_err(&chip->client->dev, "lp5812_enable_disable failed\n"); + return ret; + } + + ret =3D lp5812_write(chip, chip->cfg->reg_dev_config_12.addr, 0x0B); + if (ret) { + dev_err(&chip->client->dev, "write 0x0B to DEV_CONFIG12 failed\n"); + return ret; + } + + ret =3D lp5812_update_regs_config(chip); + if (ret) { + dev_err(&chip->client->dev, "lp5812_update_regs_config failed\n"); + return ret; + } + + return 0; +} + +static void lp5812_deinit_device(struct lp5812_chip *chip) +{ + lp5812_write(chip, chip->cfg->reg_led_en_1.addr, 0); + lp5812_write(chip, chip->cfg->reg_led_en_2.addr, 0); + lp5812_write(chip, chip->cfg->reg_chip_en.addr, 0); +} + +static int lp5812_parse_led_channel(struct device_node *np, + struct lp5812_led_config *cfg, + int led_index, int color_number) +{ + int color_id =3D 0, reg, ret; + + ret =3D of_property_read_u32(np, "reg", ®); + if (ret) + return ret; + + cfg[led_index].led_id[color_number] =3D reg; + + of_property_read_u8(np, "led-max-microamp", + &cfg[led_index].max_current[color_number]); + + of_property_read_u32(np, "color", &color_id); + cfg[led_index].color_id[color_number] =3D color_id; + + return 0; +} + +static int lp5812_parse_led(struct device_node *np, + struct lp5812_led_config *cfg, + int led_index) +{ + int num_colors =3D 0, ret; + + of_property_read_string(np, "label", &cfg[led_index].name); + + ret =3D of_property_read_u32(np, "reg", &cfg[led_index].chan_nr); + if (ret) + return ret; + + for_each_available_child_of_node_scoped(np, child) { + ret =3D lp5812_parse_led_channel(child, cfg, led_index, num_colors); + if (ret) + return ret; + num_colors++; + } + + if (num_colors =3D=3D 0) { + ret =3D lp5812_parse_led_channel(np, cfg, led_index, 0); + if (ret) + return ret; + num_colors =3D 1; + cfg[led_index].is_sc_led =3D true; + } else { + cfg[led_index].is_sc_led =3D false; + } + + cfg[led_index].num_colors =3D num_colors; + + return 0; +} + +static int lp5812_of_populate_pdata(struct device *dev, + struct device_node *np, + struct lp5812_chip *chip) +{ + struct lp5812_led_config *cfg; + int num_channels, i =3D 0, ret; + + num_channels =3D of_get_available_child_count(np); + if (num_channels =3D=3D 0) { + dev_err(dev, "no LED channels\n"); + return -EINVAL; + } + + cfg =3D devm_kcalloc(dev, num_channels, sizeof(*cfg), GFP_KERNEL); + if (!cfg) + return -ENOMEM; + + chip->led_config =3D &cfg[0]; + chip->num_channels =3D num_channels; + + for_each_available_child_of_node_scoped(np, child) { + ret =3D lp5812_parse_led(child, cfg, i); + if (ret) + return -EINVAL; + i++; + } + + of_property_read_string(np, "label", &chip->label); + return 0; +} + +static int lp5812_probe(struct i2c_client *client) +{ + struct lp5812_chip *chip; + struct device_node *np =3D dev_of_node(&client->dev); + struct lp5812_led *led; + int ret; + + if (!np) + return -EINVAL; + + chip =3D devm_kzalloc(&client->dev, sizeof(*chip), GFP_KERNEL); + if (!chip) + return -ENOMEM; + + chip->cfg =3D i2c_get_match_data(client); + ret =3D lp5812_of_populate_pdata(&client->dev, np, chip); + if (ret) + return ret; + + led =3D devm_kcalloc(&client->dev, chip->num_channels, sizeof(*led), GFP_= KERNEL); + if (!led) + return -ENOMEM; + + chip->client =3D client; + mutex_init(&chip->lock); + i2c_set_clientdata(client, led); + + ret =3D lp5812_init_device(chip); + if (ret) + return ret; + + ret =3D lp5812_register_leds(led, chip); + if (ret) + goto err_out; + + ret =3D lp5812_register_sysfs(chip); + if (ret) + goto err_out; + + return 0; + +err_out: + lp5812_deinit_device(chip); + return ret; +} + +static void lp5812_remove(struct i2c_client *client) +{ + struct lp5812_led *led =3D i2c_get_clientdata(client); + + lp5812_unregister_sysfs(led, led->chip); + lp5812_deinit_device(led->chip); +} + +static LP5812_DEV_ATTR_WO(dev_config); +static LP5812_DEV_ATTR_WO(sw_reset); +static LP5812_DEV_ATTR_WO(fault_clear); +static LP5812_DEV_ATTR_RO(tsd_config_status); + +static struct attribute *lp5812_chip_attributes[] =3D { + &dev_attr_fault_clear.attr, + &dev_attr_sw_reset.attr, + &dev_attr_dev_config.attr, + &dev_attr_tsd_config_status.attr, + NULL +}; + +static const struct attribute_group lp5812_group =3D { + .name =3D "lp5812_chip_setup", + .attrs =3D lp5812_chip_attributes +}; + +/* Chip specific configurations */ +static struct lp5812_device_config lp5812_cfg =3D { + .reg_reset =3D { + .addr =3D LP5812_REG_RESET, + .val =3D LP5812_RESET + }, + .reg_chip_en =3D { + .addr =3D LP5812_REG_ENABLE, + .val =3D LP5812_ENABLE_DEFAULT + }, + .reg_dev_config_0 =3D { + .addr =3D LP5812_DEV_CONFIG0, + .val =3D 0 + }, + .reg_dev_config_1 =3D { + .addr =3D LP5812_DEV_CONFIG1, + .val =3D 0 + }, + .reg_dev_config_2 =3D { + .addr =3D LP5812_DEV_CONFIG2, + .val =3D 0 + }, + .reg_dev_config_3 =3D { + .addr =3D LP5812_DEV_CONFIG3, + .val =3D 0 + }, + .reg_dev_config_4 =3D { + .addr =3D LP5812_DEV_CONFIG4, + .val =3D 0 + }, + .reg_dev_config_5 =3D { + .addr =3D LP5812_DEV_CONFIG5, + .val =3D 0 + }, + .reg_dev_config_6 =3D { + .addr =3D LP5812_DEV_CONFIG6, + .val =3D 0 + }, + .reg_dev_config_7 =3D { + .addr =3D LP5812_DEV_CONFIG7, + .val =3D 0 + }, + .reg_dev_config_12 =3D { + .addr =3D LP5812_DEV_CONFIG12, + .val =3D LP5812_DEV_CONFIG12_DEFAULT + }, + .reg_cmd_update =3D { + .addr =3D LP5812_CMD_UPDATE, + .val =3D 0 + }, + .reg_tsd_config_status =3D { + .addr =3D LP5812_TSD_CONFIG_STATUS, + .val =3D 0 + }, + .reg_led_en_1 =3D { + .addr =3D LP5812_LED_EN_1, + .val =3D 0 + }, + .reg_led_en_2 =3D { + .addr =3D LP5812_LED_EN_2, + .val =3D 0 + }, + .reg_fault_clear =3D { + .addr =3D LP5812_FAULT_CLEAR, + .val =3D 0 + }, + .reg_manual_dc_base =3D { + .addr =3D LP5812_MANUAL_DC_BASE, + .val =3D 0 + }, + .reg_auto_dc_base =3D { + .addr =3D LP5812_AUTO_DC_BASE, + .val =3D 0 + }, + .reg_manual_pwm_base =3D { + .addr =3D LP5812_MANUAL_PWM_BASE, + .val =3D 0 + }, + .reg_lod_status_base =3D { + .addr =3D LP5812_LOD_STATUS, + .val =3D 0 + }, + .reg_lsd_status_base =3D { + .addr =3D LP5812_LSD_STATUS, + .val =3D 0 + }, + + .dev_attr_group =3D &lp5812_group +}; + +static const struct of_device_id of_lp5812_match[] =3D { + { .compatible =3D "ti,lp5812", .data =3D &lp5812_cfg }, + {/* NULL */} +}; + +MODULE_DEVICE_TABLE(of, of_lp5812_match); + +static struct i2c_driver lp5812_driver =3D { + .driver =3D { + .name =3D "lp5812", + .of_match_table =3D of_lp5812_match, + }, + .probe =3D lp5812_probe, + .remove =3D lp5812_remove, +}; + +module_i2c_driver(lp5812_driver); + +MODULE_DESCRIPTION("Texas Instruments LP5812 LED Driver"); +MODULE_AUTHOR("Jared Zhou"); +MODULE_LICENSE("GPL"); diff --git a/drivers/leds/rgb/leds-lp5812.h b/drivers/leds/rgb/leds-lp5812.h new file mode 100644 index 000000000000..c98bbb8ced9d --- /dev/null +++ b/drivers/leds/rgb/leds-lp5812.h @@ -0,0 +1,164 @@ +/* SPDX-License-Identifier: GPL-2.0-only */ +/* + * LP5812 Driver Header + * + * Copyright (C) 2025 Texas Instruments + * + * Author: Jared Zhou + */ + +#ifndef _LP5812_H_ +#define _LP5812_H_ + +#include +#include +#include +#include +#include +#include +#include +#include + +#define LP5812_REG_ENABLE 0x0000 +#define LP5812_REG_RESET 0x0023 +#define LP5812_DEV_CONFIG0 0x0001 +#define LP5812_DEV_CONFIG1 0x0002 +#define LP5812_DEV_CONFIG2 0x0003 +#define LP5812_DEV_CONFIG3 0x0004 +#define LP5812_DEV_CONFIG4 0x0005 +#define LP5812_DEV_CONFIG5 0x0006 +#define LP5812_DEV_CONFIG6 0x0007 +#define LP5812_DEV_CONFIG7 0x0008 +#define LP5812_DEV_CONFIG8 0x0009 +#define LP5812_DEV_CONFIG9 0x000A +#define LP5812_DEV_CONFIG10 0x000B +#define LP5812_DEV_CONFIG11 0x000c +#define LP5812_DEV_CONFIG12 0x000D +#define LP5812_CMD_UPDATE 0x0010 +#define LP5812_LED_EN_1 0x0020 +#define LP5812_LED_EN_2 0x0021 +#define LP5812_FAULT_CLEAR 0x0022 +#define LP5812_MANUAL_DC_BASE 0x0030 +#define LP5812_AUTO_DC_BASE 0x0050 +#define LP5812_MANUAL_PWM_BASE 0x0040 + +#define LP5812_TSD_CONFIG_STATUS 0x0300 +#define LP5812_LOD_STATUS 0x0301 +#define LP5812_LSD_STATUS 0x0303 + +#define LP5812_ENABLE_DEFAULT 0x01 +#define FAULT_CLEAR_ALL 0x07 +#define TSD_CLEAR_VAL 0x04 +#define LSD_CLEAR_VAL 0x02 +#define LOD_CLEAR_VAL 0x01 +#define LP5812_RESET 0x66 +#define LP5812_DEV_CONFIG12_DEFAULT 0x08 + +#define LP5812_UPDATE_CMD_VAL 0x55 + +#define LP5812_DEV_ATTR_RW(name) \ + DEVICE_ATTR_RW(name) +#define LP5812_DEV_ATTR_RO(name) \ + DEVICE_ATTR_RO(name) +#define LP5812_DEV_ATTR_WO(name) \ + DEVICE_ATTR_WO(name) + +enum control_mode { + LP5812_MODE_MANUAL =3D 0, + LP5812_MODE_AUTONOMOUS +}; + +enum dimming_type { + LP5812_DIMMING_ANALOG, + LP5812_DIMMING_PWM +}; + +union u_scan_order { + struct { + u8 scan_order_0:2; + u8 scan_order_1:2; + u8 scan_order_2:2; + u8 scan_order_3:2; + } s_scan_order; + u8 scan_order_val; +}; + +union u_drive_mode { + struct { + u8 mix_sel_led_0:1; + u8 mix_sel_led_1:1; + u8 mix_sel_led_2:1; + u8 mix_sel_led_3:1; + u8 led_mode:3; + u8 pwm_fre:1; + } s_drive_mode; + u8 drive_mode_val; +}; + +struct lp5812_reg { + u16 addr; + union { + u8 val; + u8 mask; + u8 shift; + }; +}; + +struct lp5812_led_config { + bool is_sc_led; + const char *name; + u8 color_id[LED_COLOR_ID_MAX]; + u8 max_current[LED_COLOR_ID_MAX]; + int chan_nr; + int num_colors; + int led_id[LED_COLOR_ID_MAX]; +}; + +struct lp5812_chip { + u8 num_channels; + struct i2c_client *client; + struct mutex lock; /* Protects register access */ + struct lp5812_led_config *led_config; + const char *label; + const struct lp5812_device_config *cfg; + union u_scan_order u_scan_order; + union u_drive_mode u_drive_mode; +}; + +struct lp5812_led { + u8 brightness; + int chan_nr; + struct led_classdev cdev; + struct led_classdev_mc mc_cdev; + struct lp5812_chip *chip; +}; + +struct lp5812_device_config { + const struct lp5812_reg reg_reset; + const struct lp5812_reg reg_chip_en; + const struct lp5812_reg reg_dev_config_0; + const struct lp5812_reg reg_dev_config_1; + const struct lp5812_reg reg_dev_config_2; + const struct lp5812_reg reg_dev_config_3; + const struct lp5812_reg reg_dev_config_4; + const struct lp5812_reg reg_dev_config_5; + const struct lp5812_reg reg_dev_config_6; + const struct lp5812_reg reg_dev_config_7; + const struct lp5812_reg reg_dev_config_12; + const struct lp5812_reg reg_cmd_update; + + const struct lp5812_reg reg_led_en_1; + const struct lp5812_reg reg_led_en_2; + const struct lp5812_reg reg_fault_clear; + const struct lp5812_reg reg_manual_dc_base; + const struct lp5812_reg reg_auto_dc_base; + const struct lp5812_reg reg_manual_pwm_base; + const struct lp5812_reg reg_tsd_config_status; + const struct lp5812_reg reg_lod_status_base; + const struct lp5812_reg reg_lsd_status_base; + + /* Additional device specific attributes */ + const struct attribute_group *dev_attr_group; +}; + +#endif /*_LP5812_H_*/ --=20 2.25.1 From nobody Sat Oct 4 11:11:58 2025 Received: from mail-pj1-f41.google.com (mail-pj1-f41.google.com [209.85.216.41]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DFB4623C4E1; Mon, 18 Aug 2025 01:27:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.41 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480450; cv=none; b=mSjDXkjenZDsRsuEVfsBsOnFdgqpe15HNdt7PrHasTuw/5JWMcnJRkG7fI2Y0wtkKorMj+fjLFK2g2Jxqo63BxgWh9rgFdQtMLivTGjxA2SQeVQOaPrqF5sNQ1HkZfbCsa0wqyF5WX8nL+cqFOUZhC+CS/chJtsBk7deSpJ9qUg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480450; c=relaxed/simple; bh=YYfnwaU2YOGJ7AFmccYeg2FiCUU+20P3ULo5LK90Sjw=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=mCJztR84nqLmq15BBfow7jscYswRDKwKPGowUfhfhcIsWGqS+NooRGtBTS5M0hNgmyBfj719rXHsrX7WX6m3stCckEMD4jZzjzOlKLUUuhK329bZ1/QddNN/jMzgkZ39nRdMeEnA7os5Jpd8yQAagf8h+5ob/HyLfjSgI+4hFfc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Jfz/Cicf; arc=none smtp.client-ip=209.85.216.41 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Jfz/Cicf" Received: by mail-pj1-f41.google.com with SMTP id 98e67ed59e1d1-32326e5f0bfso2926085a91.3; Sun, 17 Aug 2025 18:27:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755480448; x=1756085248; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=X2hhQ1eT+/gKOxmT2TqJqg2gW8rdjYFSQOxpgEIgX34=; b=Jfz/Cicf1PM/SYF/2O0i+OsRXnJ7KHHQ0wW6/0t5tG5aJS8CpSPI1aQsN2tRSG3dF7 1FBX6aWj6LMMHxh2P7yIqVBhQXl62ynnx4VGawb3aW7ZU7bEHHnMlhCJy4TJ3F6C810i aeVuCmbugqQvdJ0xUUZ6yqzIgW+hw6XERzuOhI7yYBvK8i6BQZ9xSB/ijCHUsXPgXyiG qRR1noSwMt8vmvg30vMKaBcfjCZggUVUu+BTOJaHOZn5+d1HP8IDrI0HH4uChi9JFm0C U9tF342SFFe6CdcWpOyWqXPH6WmBa0OYI1Zjk28o9ofklsRHJVf0ijFl/IBtv0UwXBD9 CrDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755480448; x=1756085248; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=X2hhQ1eT+/gKOxmT2TqJqg2gW8rdjYFSQOxpgEIgX34=; b=Z9U8CYNl+u+UV39jS5PZuUiR5gquMw0DoEqZo+6K+g9KFTeQmZMFqYcydy4kkKgqQF NxGxoVfb3ZriGTfjCt35Nprla0PFIF42gSZJpUH8E0AZTkyHhOoav8YRx9JagU9UH645 h0wEYdkelaJFNYohadt+RHkYz8nCYYN4LU2VLaVpKgKwxSP3+ZDih0L+RXBbyr0GpMLJ TTERbgH7T88rPLWThRi78MJtWkaga0wXmBEeWQXSgg7qm0+MEoIKQZ/B155HdpCbwBL2 T+oi4K4VE94pw9a0deDpVnTeYr5SxRFOYPiZ3cWyQ0waFBUKTYRUvqlKNLfAIXffLVxv ju4w== X-Forwarded-Encrypted: i=1; AJvYcCUy0YQs1Uw3jni8b7ZuVlMC6CyF5l77E+Puro5O9oBYPl4jbk3sna+IcccPqU3EO6s6ZGVqau6sSRnn99lN@vger.kernel.org, AJvYcCWQOTHF8CypDXeXKtKtM9OnS8hj6H6RNxddfL+h6O+i/+o/tfrenJVr+NZFHjKbjeB1mzkel5y9DcFt@vger.kernel.org, AJvYcCXQ4bIuws5i3vXfM5dq9oUjdnm87OsC1Y26EPQM10zsO4rnRdRfmLkWn+3lR3mHWxAPXug0pezTMZi85g==@vger.kernel.org, AJvYcCXrl+1MNb/NbA6mnaktu0+0UCEawEaWFMmgkW5jWWU2LCep5q1SCUwYRWD8QQ16CaWPp+CZ0mrXjsDj@vger.kernel.org X-Gm-Message-State: AOJu0YypRds2hFcGAhiQAR2ZenF/rDPp/j7ZEZn82r7xOepCkgO16abU 0Z2VR6N6qwr8bgSMrbTW7RSM6fqN8jXtZQcNSh/fbbs3utT9NXRRM5KILl6Mjw== X-Gm-Gg: ASbGncv0c3UXY6tnxaMCd4gxfSYX26SKKNb9j6lmelWeyJTjiOXoo1U2BfS8fJejnb/ owNuuXx5LaJh+dmY1dsb03BdQmSgIl9dJQKmP0Lusf4u2LrcZA2NfN0A3+Ihw8vzsLCFuznk27Z 6r6aL1hhgRRWvU+Shj4qakooCBUXWB0q0Zt/HEnMyMn4nQXOM3YtyhMNOwjZo7TgIMT3e2/5hDe NOxEs3SJJgpGR9RpXQPgvD9Qn3WoypBRwh6YtgGOCK0RiGkVEt1JDr9r6TLgOaAfjsF8NgbKAs3 eD5cMbsKc2L0IqXl7HHmSag/D+tDOOFVJf6Mq1LuulfJ5XWpFHnEAxlasfcBatWinWN7Ndrv/tV RQOqcHEuFKYhViv7lJoLca9AUcJf+FnBqhA== X-Google-Smtp-Source: AGHT+IH29YsWQf1oh2epVxhCygpiFpX5VBbG4hj3ehj+oVtzPIXVR/302uaFOxNNDFTvw0lq9C8Low== X-Received: by 2002:a17:90b:3c42:b0:312:e76f:5213 with SMTP id 98e67ed59e1d1-3234215b3eamr14610518a91.28.1755480448020; Sun, 17 Aug 2025 18:27:28 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.116.199.205]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b472d5d7070sm6709620a12.15.2025.08.17.18.27.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Aug 2025 18:27:27 -0700 (PDT) From: Nam Tran To: lee@kernel.org Cc: pavel@kernel.org, rdunlap@infradead.org, christophe.jaillet@wanadoo.fr, krzk+dt@kernel.org, robh@kernel.org, conor+dt@kernel.org, corbet@lwn.net, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org, Nam Tran Subject: [PATCH v13 RESEND 3/4] docs: ABI: Document LP5812 LED sysfs interfaces Date: Mon, 18 Aug 2025 08:26:53 +0700 Message-Id: <20250818012654.143058-4-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250818012654.143058-1-trannamatk@gmail.com> References: <20250818012654.143058-1-trannamatk@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The LP5812 is a 4x3 matrix RGB LED driver with autonomous animation engine control. This patch documents the basic sysfs interfaces provided by the driver, including LED activation, current control, fault status, and simple chip-level operations such as software reset and fault clearing. Signed-off-by: Nam Tran --- .../ABI/testing/sysfs-bus-i2c-devices-lp5812 | 32 +++++++++++++++++++ .../ABI/testing/sysfs-class-led-lp5812 | 32 +++++++++++++++++++ MAINTAINERS | 2 ++ 3 files changed, 66 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-bus-i2c-devices-lp5812 create mode 100644 Documentation/ABI/testing/sysfs-class-led-lp5812 diff --git a/Documentation/ABI/testing/sysfs-bus-i2c-devices-lp5812 b/Docum= entation/ABI/testing/sysfs-bus-i2c-devices-lp5812 new file mode 100644 index 000000000000..d0d622753be8 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-lp5812 @@ -0,0 +1,32 @@ +What: /sys/bus/i2c/devices/.../lp5812_chip_setup/dev_config +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Configures drive mode and scan order. (WO) + Some valid values: tcmscan:4:0:1:2:3 (default), tcmscan:3:0:1:2, mixscan= :2:2:0:3, mixscan:3:0:1:2:3 + +What: /sys/bus/i2c/devices/.../lp5812_chip_setup/sw_reset +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Triggers a software reset of the device. (WO) + 1 - resets device + 0 - does not reset device + +What: /sys/bus/i2c/devices/.../lp5812_chip_setup/fault_clear +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Clears fault status. (WO) + 1 - clears fault status + 0 - does not clear fault status + +What: /sys/bus/i2c/devices/.../lp5812_chip_setup/tsd_config_status +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Report the current thermal shutdown config status. (RO) diff --git a/Documentation/ABI/testing/sysfs-class-led-lp5812 b/Documentati= on/ABI/testing/sysfs-class-led-lp5812 new file mode 100644 index 000000000000..93eeecc60864 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-class-led-lp5812 @@ -0,0 +1,32 @@ +What: /sys/class/leds/led_/activate +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Activate or deactivate the specified LED channel. (WO) + 1 - Activate + 0 - Deactivate + +What: /sys/class/leds/led_/led_current +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + DC current level. (WO) + Valid values: 0 - 255 + +What: /sys/class/leds/led_/max_current +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Shows maximum DC current bit setting. (RO) + 0 (default) means the LED maximum current is set to 25.5 mA. + 1 means the LED maximum current is set to 51 mA. + +What: /sys/class/leds/led_/lod_lsd +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + 0 0 mean no lod and lsd fault detected, 1 1 mean lod and lsd fault detec= ted (RO) diff --git a/MAINTAINERS b/MAINTAINERS index c2e1c02e206d..608a7f3feb07 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24827,6 +24827,8 @@ TEXAS INSTRUMENTS' LP5812 RGB LED DRIVER M: Nam Tran L: linux-leds@vger.kernel.org S: Maintained +F: Documentation/ABI/testing/sysfs-bus-i2c-devices-lp5812 +F: Documentation/ABI/testing/sysfs-class-led-lp5812 F: Documentation/devicetree/bindings/leds/ti,lp5812.yaml F: drivers/leds/rgb/Kconfig F: drivers/leds/rgb/Makefile --=20 2.25.1 From nobody Sat Oct 4 11:11:58 2025 Received: from mail-pf1-f182.google.com (mail-pf1-f182.google.com [209.85.210.182]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 51D8223C4E1; Mon, 18 Aug 2025 01:27:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480456; cv=none; b=A9EdZ2x6+FpWNT4VgdlZ+IJUgdoQ/8As2eMB6s8eMCv/SoKMQIb2U8s3dfpOCirSC7J2jwf2jgqfjVaJ+xRfekdj5ELDKqY8SLfFzflfaCoMAtrYxdtK43PCvXY9IZ+qvnpQ0RfEfqrFqZRvOzY+awO3hZopXNwpBBUKPvkcr+c= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1755480456; c=relaxed/simple; bh=ZVmPBePIfMrVHilLCY3efrpm9cVERQhSNA6dF6YblyA=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version:Content-Type; b=t8QEj2QdeYdigs0i3JQ0CWavuwXTNA0xeQ2HtjIJ9XORAGRTpdh2s/hrofcGNngXJqR35+JHqjDycZiQksLJt8A9fFMpoACiOj9qb4NF//tX38E0W6T8ndqePtdXLFAM8TdMJLLvYYHSrTgt1hP6/OuWEbBSQiGSWuheHlEuFmU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=C0DKkNGl; arc=none smtp.client-ip=209.85.210.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="C0DKkNGl" Received: by mail-pf1-f182.google.com with SMTP id d2e1a72fcca58-76e6cbb991aso199323b3a.1; Sun, 17 Aug 2025 18:27:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1755480455; x=1756085255; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=y4sEwWCKhE9o9XO4kAyIp50H0a35S3OvWlZDhc+P+nk=; b=C0DKkNGlmgjCt4e7My3p7CALy4Pgo8JI4pEqxPFo2xBtu57RNHhp8Ab8Yg7+QFI7Es lrklvVjtNIZnmMGOCdrhZSmIAXUrTefGLOmJmjnIAX8Z1iQ3jNOBKhGU3mMvnhEQkq8d 0c0SaE1/2XeXKJmN/96kf1IESv+TfvSxjZ1DLM3wpSeQi0mQrIKFdSXunQOljOSum2A7 KdLt01eoy+d2cJ1otV++xI1Z6UHZzHAKBfmAzjk70K6SpIESdTqa3WjIJPr2Aq01KDLf fbRPRVRp7I0Z2FSZLrCq3h8f6hAJuwAyOydJFUpwagJpxAdhh/hOf67ubCJIsNoUzZE2 JNmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1755480455; x=1756085255; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=y4sEwWCKhE9o9XO4kAyIp50H0a35S3OvWlZDhc+P+nk=; b=lEpqWcicI5tTEtbuxAO1t+H+w2yKl6Hj8aruortdcwSQAkhzhhqUOfxqCFF/+vyZMm xgzT7pz+ecLk1T3Mt+p13uLbyhK/+/57ZJ0kEhhoSy0LAcQ+DuovvYzH7PSZtvEexDS9 fTYIm+k7Y38BYBShWW6b9PMZn3HcqnFKmMt3KkJLZGbGyPRJegi+5NgY9tqFpDEq4kmC 2fCDlp82lNGNe+Epbh52TmX9hdC60fETDDBruzyt9q+VU3XscI/CZYA6WDvuojiotNBF UOs03bB6cbC5QNVc4AB5R0YFdY/jqTjDmat7DK/awXVA/HZKlPJf5WsoTD6rO8TaiGPE 5A+g== X-Forwarded-Encrypted: i=1; AJvYcCW3623lao7kEW3MJYhcOtQTuHwtUyA7G7ESnT8FLBjHQdf9bNydOjNu3rqsDnx/9M8N2WmdYg2qp0NP@vger.kernel.org, AJvYcCWcq5HY5N/dApNkd7htgW3iNztRV+Q2g8eoR0KFxhqOL4cofbP2jUlHx6KvcJvyVqg60daIBKsWmbW+DPvL@vger.kernel.org, AJvYcCWyIn460NyaZF0b2z+Ec1M3OlvBmFHdtTbg7jwlivMDI3s2TD6/aaaqsi1Kecb2nml82slxeyJb0ZovOw==@vger.kernel.org, AJvYcCX+q37BhW9LX85gZd4EC7Kji3AAtp35GweZ2E3YQ0oD8lxnrobOoe5orCpFPmdr5hemmayL+ySzrgTQ@vger.kernel.org X-Gm-Message-State: AOJu0YzUxuGbu+fzhbDoFn/NJK5VjTDPhqXgI+y9TX2qOpR2+xgtPHAj m5hMSJ/7llAOuRFbsKzOtXtBl4LyjJ13ouYgn0NUV8tdfUJe6gCqKZSh X-Gm-Gg: ASbGncvQDcXIJ7NCumMkk+LRvR3b8CzUrwRdpFyF/Mgwi1/oIYz85OLCgDLSSzqrMM8 fltABF9DkW5lc1ED5L5UHC5De8ffjFgYjB1QdUT3eHUYbGzoVC0G+R0VjQTfCx4fnKDrwi3nowf qlu8oaxcsGvHpa62bIPykbc10/7Ylb6jz5IBxv+kRctXVenHR5TsQipLSONlQKAYX/nHbmUjD1b rjG3s1uVK/3E9qsD1bqoq63rCJgECjmrfY0/WC42mqUpqOsnnUgDbcfaIr+50/7q8V3iGqTyQV+ 8wVg9Yh2/cLoLo3UOpq7p+BC6Z1rdgWY8Yh+qoW4qhJUKNf8Py9aYZU7ydMY2E/4HmDWnDko5n3 F0bpHVFRUogWjV74rvX9EA/onBeyRR+6ptQ== X-Google-Smtp-Source: AGHT+IEgXDKUjPvb/XntPJ8pVPGK/cIPn/RC7YCkx1B+xX2nLMXiMsDBQ68Vplx3QL/ZiwpBS0T8iA== X-Received: by 2002:a05:6a20:734b:b0:204:432e:5fa4 with SMTP id adf61e73a8af0-240d2ecc10bmr16294408637.23.1755480454625; Sun, 17 Aug 2025 18:27:34 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.116.199.205]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b472d5d7070sm6709620a12.15.2025.08.17.18.27.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 17 Aug 2025 18:27:34 -0700 (PDT) From: Nam Tran To: lee@kernel.org Cc: pavel@kernel.org, rdunlap@infradead.org, christophe.jaillet@wanadoo.fr, krzk+dt@kernel.org, robh@kernel.org, conor+dt@kernel.org, corbet@lwn.net, linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org, Nam Tran Subject: [PATCH v13 RESEND 4/4] docs: leds: Document TI LP5812 LED driver Date: Mon, 18 Aug 2025 08:26:54 +0700 Message-Id: <20250818012654.143058-5-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250818012654.143058-1-trannamatk@gmail.com> References: <20250818012654.143058-1-trannamatk@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable The driver provides sysfs interfaces to control and configure the LP5812 device and its LED channels. The documetation describes the chip's capabilities, sysfs interface, and usage examples. Signed-off-by: Nam Tran --- Documentation/leds/index.rst | 1 + Documentation/leds/leds-lp5812.rst | 46 ++++++++++++++++++++++++++++++ MAINTAINERS | 1 + 3 files changed, 48 insertions(+) create mode 100644 Documentation/leds/leds-lp5812.rst diff --git a/Documentation/leds/index.rst b/Documentation/leds/index.rst index 76fae171039c..bebf44004278 100644 --- a/Documentation/leds/index.rst +++ b/Documentation/leds/index.rst @@ -25,6 +25,7 @@ LEDs leds-lp5523 leds-lp5562 leds-lp55xx + leds-lp5812 leds-mlxcpld leds-mt6370-rgb leds-sc27xx diff --git a/Documentation/leds/leds-lp5812.rst b/Documentation/leds/leds-l= p5812.rst new file mode 100644 index 000000000000..7d464334557c --- /dev/null +++ b/Documentation/leds/leds-lp5812.rst @@ -0,0 +1,46 @@ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +Kernel driver for lp5812 +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +* TI/National Semiconductor LP5812 LED Driver +* Datasheet: https://www.ti.com/product/LP5812#tech-docs + +Authors: Jared Zhou + +Description +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +The LP5812 is a 4x3 matrix LED driver with support for both manual and +autonomous animation control. This driver provides sysfs interfaces to +control and configure the LP5812 device and its LED channels. + +Sysfs Interface +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +LP5812 device exposes a chip-level sysfs group: + /sys/bus/i2c/devices//lp5812_chip_setup/ + +The following attributes are available at chip level: + - dev_config: Configure drive mode and scan order (RW) + - sw_reset: Reset the hardware (WO) + - fault_clear: Clear any device faults (WO) + - tsd_config_status: Read thermal shutdown config status (RO) + +Each LED channel is exposed as: + /sys/class/leds/led_/ + +Each LED exposes the following attributes: + - activate: Activate or deactivate the LED (WO) + - led_current: DC current value (0=E2=80=93255) (WO) + - max_current: maximum DC current bit setting (RO) + - lod_lsd: lod and lsd fault detected status (RO) + +Example Usage +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +To control led_A in manual mode:: + echo "tcmscan:4:0:1:2:3" > /sys/bus/i2c/devices/.../lp5812_chip_setup/= dev_config + echo 1 1 1 > /sys/class/leds/LED_A/activate + echo 100 100 100 > /sys/class/leds/LED_A/led_current + echo 50 50 50 > /sys/class/leds/LED_A/multi_intensity + echo 255 > /sys/class/leds/LED_A/brightness diff --git a/MAINTAINERS b/MAINTAINERS index 608a7f3feb07..42af71c7634d 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24830,6 +24830,7 @@ S: Maintained F: Documentation/ABI/testing/sysfs-bus-i2c-devices-lp5812 F: Documentation/ABI/testing/sysfs-class-led-lp5812 F: Documentation/devicetree/bindings/leds/ti,lp5812.yaml +F: Documentation/leds/leds-lp5812.rst F: drivers/leds/rgb/Kconfig F: drivers/leds/rgb/Makefile F: drivers/leds/rgb/leds-lp5812.c --=20 2.25.1