From nobody Thu Oct 9 08:47:47 2025 Received: from mail-pl1-f173.google.com (mail-pl1-f173.google.com [209.85.214.173]) (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 462942F546E; Wed, 18 Jun 2025 18:32:20 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.173 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271541; cv=none; b=ck94qOIhbYTp9oEpR04QusEtbK60k1WQZoY08yGFz8N9wcB3jx7BKxDsHzs6tNALycb9Z92vBjefJUXzU8d9JhVSJvUohDI8g03KHr16zpmz0G5vzThKDV6Fz+LpZZe2lQ0X2lHHD7sudhwWwfDdI5MXJm+iql2Kq8p/9CDXm+U= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271541; c=relaxed/simple; bh=rQ8rKPRPuhNzi+10f3RB1hk4xDUou7WqAHnmwgJS++s=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=E5o0BZBopKNb8MMx2zXT9RhMZWqt+WJkOgjamusQvmEy4Zt9y9juiIg9jEpNTHhjGNn7GPYIsDeMj7EUL65Ws0uPfp5cb25KpddfeodetiTE9GEbkkrj3uGkkEqWXBQv7Mu1uvfl5OXH4czkknU95//jmKUneiRzjCC5a8Z09uY= 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=dN3+Rix5; arc=none smtp.client-ip=209.85.214.173 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="dN3+Rix5" Received: by mail-pl1-f173.google.com with SMTP id d9443c01a7336-235f9ea8d08so80495ad.1; Wed, 18 Jun 2025 11:32:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750271539; x=1750876339; 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=vfuOuLlvFWpXGbmrHs0nb56FLv7lFfN7MxTtN2N8paI=; b=dN3+Rix53xpWyjfPzP6pBTgLGPgkXFPGRl5WuuXSUMViJEhujJnZpVyS4vb/YjrR33 ksUasDjYd6tS8GAOmMgKS3W1l4DI97Rf7740c2A3WCFYth57d+dk/A8rq0XzLueoMuYh 1h5ywTQeDSXLepNQKQW2dXeYaHGdMP/L/R2XjGE6kH5ztAm6oRfnLRN/tvTYfeKKsYkg Q4K3V7oEUSWH1pTQ48cC8Dg0ZczZTERtp8vTVucg4uzUV5oCiVU28IHS4R0MiupMb/iK Ax70WHbANeC+PHRq40UTTEnSUOk7Oua3dU00OSCjK4WC4IRml4PMqoZjCZ9xwwFvUpUt 9LWQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750271539; x=1750876339; 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=vfuOuLlvFWpXGbmrHs0nb56FLv7lFfN7MxTtN2N8paI=; b=V9ROq6GmfjMhl2Y4Mmn9/wXd7BI7UkPs7nIs4h1Inwel16DEEVMcwSXqPGtSLgz6gc fIUzQJE66874ZA3m6cvYfabODj1kGhOg2aGowB8OECs/G0E9KpSkdntcdkye4eT5DYpj lpciSqa1iRyxe4rhbo/r5bTno7apDN0LBNF6aHRDD/4EkYmYBbkNL7YkqUW474kTF34Z OEG1JjIEvH/ykMKl7YNo/iybca4uMt97mfX6Y6csEmfQKVZwNxaH17uLjlSnWpYh/Q78 7Z1AKQTkIc4P5hUb2s9DZpMw+F8MbNU8rgCENWIi9rJAEFg7nlrRhRPj85K8XjUe+4/B lgAA== X-Forwarded-Encrypted: i=1; AJvYcCUQLk3HNyRpJxxwabUJhv48nEB0cVVO0f0gBaODmSeGcX8UL07lcMfGDjdJLuqaMS1Lv6AOdNm+frSl@vger.kernel.org, AJvYcCVE81547Wtk10qw6UPRmRuyhFyjDzWCCopdl+2f2Fdx+Yp1ouX2+cSK1cSJsUqPXINxUDbB2tIQBMYVPw==@vger.kernel.org, AJvYcCVo35xGEUwIuf2lPjfD2Fj2gK1wokHBe+/bJgGosoekZWlrI8QElGXlesD56m6qKb/r47qAADkI7Ky1@vger.kernel.org, AJvYcCWQ8tW6YUmpv7ZSgZhFwu1G2S/7aWDMv/EbhVc+T3HuJzYVad1xIBlqSZfBsnqe0/Yl7IZW5zcnKTta26gx@vger.kernel.org X-Gm-Message-State: AOJu0YzBTlym6lmtA7m3ikzgGDHeq3lCQ+GwD9XXHFfTxIpxxDbkTyJp OgK20IOtRclfkwwZqXX4YIk/nsph5c+u9ZevBp0iT01NIRoefFYYCdfv X-Gm-Gg: ASbGncuy6ViKI1s1cnHtVT5xIe1sTr8oqiOcVXXr4sk/YGk3BIh4YC8aLmgWSTSf3xQ 59O79vqD4AxkdQpBheurs/KrVM6d9uXHm1E20F4/FI+YiUIIvD7sFCRPvr6nok3dU3maTeg5eOk ZkMBQ46DbSb+huup74Gafv76yjRaXMBiCcVaucj69IsYPQlgMaIElrRN9xOO9UCcTeqUmKdAHUX 7lA0+oFyF3ncqwZu9PG3WqCQMH/DMzeOk41r+8/pCeC4yhj0rRi82a9pQQspWTByl1d+8PkWvnV Dp4dZ0CYc0b/bhLYknYI87Djgrao2FnCsot4G1twnVVliSR91Eyh+6daXquXQXbGDaaLI7YgHLQ KG8AbZnA= X-Google-Smtp-Source: AGHT+IFXaoihja+Dnl4eWPsU3l/PmPRnuo6G/0OsH2wJRe/k/breVcsuFKyD07chMflgd6rbDEwuvA== X-Received: by 2002:a17:902:cf0e:b0:234:d7b2:2aa9 with SMTP id d9443c01a7336-2366b1221femr289050945ad.29.1750271539383; Wed, 18 Jun 2025 11:32:19 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.113.163.91]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b2fe1639f97sm9606454a12.6.2025.06.18.11.32.16 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 18 Jun 2025 11:32:18 -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 v10 1/4] dt-bindings: leds: add TI/National Semiconductor LP5812 LED Driver Date: Thu, 19 Jun 2025 01:32:02 +0700 Message-Id: <20250618183205.113344-2-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250618183205.113344-1-trannamatk@gmail.com> References: <20250618183205.113344-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 a92290fffa16..83a779dc9bcd 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24561,6 +24561,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 Thu Oct 9 08:47:47 2025 Received: from mail-pg1-f178.google.com (mail-pg1-f178.google.com [209.85.215.178]) (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 BB8672F4A0E; Wed, 18 Jun 2025 18:32:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.178 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271551; cv=none; b=FpOlMmmrE5XtgmqM9mB+tPdJfz//XV3cfzuRJENEDQXmJVd5PEEly8JregewbcSUYxD7Dw8OLH8nVsha0B2F7kaJC0Fzoa6BxDkdYR+6k03lWYlysLBkRsC5K13vOrmMdVIITj9GSkFtCcaZgXIsdAqhfFzRPPfpuIc4hhI9UrU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271551; c=relaxed/simple; bh=rDc+/O5jMWgMBeX9HrSjAVVUk7DTE7axCvmxxXSgz00=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=c8jexCWTYZlJGXNRSupCwUl/wTgIp5Rp3TUeCOdnAZ6meqnxRzNzVt1pu55bzD4m5EDZ7OvJIUMobbiY6OnyevlE5hcgu5Pdqho/plvATRVdP3YQwODMylLabgdU3lsiMzzl0LG4etBAxHaz4/B57sLzUCE1H+By6b+AmzfkDR4= 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=lWkH6QXx; arc=none smtp.client-ip=209.85.215.178 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="lWkH6QXx" Received: by mail-pg1-f178.google.com with SMTP id 41be03b00d2f7-b2c4476d381so954735a12.0; Wed, 18 Jun 2025 11:32:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750271547; x=1750876347; 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=TYEubrBgC1FGSXNJiXcHxb9Cdnt/wR/K/3A6+gudDPA=; b=lWkH6QXxIzSckgbXR1P2GqbMHGwBtRKG4paLFo1pRVdsP+fCcrM1A2nCktQg3UAmgn ChJ9VJwLLV2mforH+wR2dTSbf0HrTzlWrRMYSTjUbndLQHz6Pkx0Pr4GfRNgqLYvNVxS MObdxAbvGyhlXiMg7z7xW3soOOArRpTORPdovVMtbuPOQyBgiJzHXcjlVOeFezh17/FD +9LdsaCZDDxMVHrB+ivs6KBwwC+96h/4s9lPUHyKbcSbz8509vI6T9LbjhnQ1/TCMX8v 7/YJkaVNzRgebyYDFVTbds9nrxDTSwAME3rtjWjOUNJxl08d16VOA9EDf/w/xRd8s7fS eryw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750271547; x=1750876347; 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=TYEubrBgC1FGSXNJiXcHxb9Cdnt/wR/K/3A6+gudDPA=; b=nvF6yQmVL0X0OD27noNF/HhTzn5ahKNpG6qCAtV40vlokaYiYZJgmY0srBAgDA0Ckw ZtyLkYHjgNs33OhpN97fbVZUsPF1lrzMFrVdge7oDcB3WzhYLkEVPm2O1G/V2sd1ua0L zxk7SJy4bMuX4C2kB2sWqWwRUfTqC6oKbaZ7xoMhvRC7YJVnLwodxNzrZBz4+P5LoBUy NMJcaTPbQTzuTTEXN+bM6KysF1vfpagRaoDuDxX/sNJLblDbEPe568BzS6UiZs8UYjqA +8KxNxOOg6UWKObX4Wfj5+yW0RBKh5ysLRmLqxWIs1fEoQopQscYcu898cL1vBOG4CuN P8qQ== X-Forwarded-Encrypted: i=1; AJvYcCUaCtAY6L1qRXHc0ulEp16psgWWQaT+Bktn7VRdJGn5ubTxzHTjte0D96kaLloafL4WJPKUltLw5emjoiZk@vger.kernel.org, AJvYcCUi7xmoYUBGyOnzfxnJje7ARI6fIk66s9fRtCm+j23QVakTroQo7nAfyahETz+C7PbShthLGTG7XAz5@vger.kernel.org, AJvYcCXRwcw8ggNHO5/yaOnCdo63zI2SUD1soN7XecLfsKBnuFjrQtpzB0R+YVigBBLahbo8us+yanFvWZQF@vger.kernel.org, AJvYcCXtmpaBVsUgeQtNzIhB+VJh3OmxGv2cycKy9VdOppiCP/eZiCtBOTeBXFHJfZSUwgc91oOz5eEbTmpbNA==@vger.kernel.org X-Gm-Message-State: AOJu0YxsL7y2rBxY/fzlUAdIzaqNoCLzgN9Z6ZFUXdrou+g5O75HGDAm 7mDwOJYN6Kgn2H8MoQi0bA4FGZfpn5u5vqsjyyOIK636sRz1vp/A1VJy1XAQ7Q== X-Gm-Gg: ASbGncu6waH27eAVi4KK8g/OkmdNjNW1J6jjwrA5msUlX0JbuY0jRRIwj4wlx548qog b2rHOFnP8RWbrG/MJguL73Y2Gt72zLeooRBT8is5FrLwDfHd7GsJGxHjx7YOVh1X99KYULP8bau fmWKk5egFWvUKaj38218SKX/lQeDjSwDh+kEUJVd7RHAhUzlUc6J7AoNOFwKZDOY+kF8895pwPI syrd8fQxJfgNUIlaoWNNIU4WogjJ6FKbcW1MxS3WeTfnhurvgTG6BL0ITJUmNsTeWPwL4sCdV2W STN9+bFfk7KP82xuYFxq3yb/CP/3j/Um50N/S0aoN1Q0MvbERhZb64zNHpccLhiB7B4ROjqc X-Google-Smtp-Source: AGHT+IGFmWabzFb3rEz2AxmnKn3XTg2u3QqTvT4Bs8KG9pN7Mdt97MZtXka/nnSmnHjF3puDvGfGcg== X-Received: by 2002:a05:6a21:998a:b0:21f:53e4:1919 with SMTP id adf61e73a8af0-22011139735mr927465637.3.1750271546427; Wed, 18 Jun 2025 11:32:26 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.113.163.91]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b2fe1639f97sm9606454a12.6.2025.06.18.11.32.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 18 Jun 2025 11:32:25 -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 v10 2/4] leds: add TI/National Semiconductor LP5812 LED Driver Date: Thu, 19 Jun 2025 01:32:03 +0700 Message-Id: <20250618183205.113344-3-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250618183205.113344-1-trannamatk@gmail.com> References: <20250618183205.113344-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. Signed-off-by: Nam Tran --- MAINTAINERS | 4 + drivers/leds/rgb/Kconfig | 13 + drivers/leds/rgb/Makefile | 1 + drivers/leds/rgb/leds-lp5812.c | 1943 ++++++++++++++++++++++++++++++++ drivers/leds/rgb/leds-lp5812.h | 227 ++++ 5 files changed, 2188 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 83a779dc9bcd..b4eb3265c800 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24566,6 +24566,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..799c5c24685c --- /dev/null +++ b/drivers/leds/rgb/leds-lp5812.c @@ -0,0 +1,1943 @@ +// 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" + +#define LP5812_SC_LED "SC_LED" +#define LP5812_MC_LED "MC_LED" + +#define LP5812_AUTO_PAUSE_ADDR(chan) (LP5812_AEU_BASE + (chan) * 26) +#define LP5812_AUTO_PLAYBACK_ADDR(chan) (LP5812_AEU_BASE + (chan) * 260 += 1) +#define LP5812_AEU_PWM_ADDR(chan, aeu, pwm_chan) \ + (LP5812_AEU_BASE + (chan) * 26 + ((aeu) - 1) * 8 + 2 + (pwm_chan) - 1) +#define LP5812_AEU_SLOPE_TIME_ADDR(chan, aeu, slope_chan) \ + (LP5812_AEU_BASE + (chan) * 26 + ((aeu) - 1) * 8 + 2 + 5 + ((slope_chan) = / 2)) +#define LP5812_AEU_PLAYBACK_ADDR(chan, aeu) \ + (LP5812_AEU_BASE + (chan) * 26 + ((aeu) - 1) * 8 + 2 + 5 + 2) + +#define to_lp5812_led(x) container_of(x, struct lp5812_data, kobj) +#define to_anim_engine_unit(x) container_of(x, struct anim_engine_unit, ko= bj) + +static int lp5812_read_tsd_config_status(struct lp5812_chip *chip, u8 *reg= _val); + +/* Begin common functions */ +static struct lp5812_led *cdev_to_lp5812_led(struct led_classdev *cdev) +{ + return container_of(cdev, struct lp5812_led, cdev); +} + +static struct lp5812_led *mcled_cdev_to_lp5812_led(struct led_classdev_mc = *mc_cdev) +{ + return container_of(mc_cdev, struct lp5812_led, mc_cdev); +} + +static struct lp5812_led *dev_to_lp5812_led(struct device *dev) +{ + return cdev_to_lp5812_led(dev_get_drvdata(dev)); +} + +static struct lp5812_led *dev_to_lp5812_led_mc(struct device *dev) +{ + return mcled_cdev_to_lp5812_led(dev_get_drvdata(dev)); +} + +static int lp5812_write(struct lp5812_chip *chip, u16 reg, u8 val) +{ + int ret; + struct i2c_msg msg; + struct device *dev =3D &chip->i2c_cl->dev; + u8 extracted_bits; /* save 9th and 8th bit of reg address */ + u8 buf[2] =3D {(u8)(reg & 0xFF), val}; + + extracted_bits =3D (reg >> 8) & 0x03; + msg.addr =3D (chip->i2c_cl->addr << 2) | extracted_bits; + msg.flags =3D 0; + msg.len =3D sizeof(buf); + msg.buf =3D buf; + + ret =3D i2c_transfer(chip->i2c_cl->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) +{ + int ret; + u8 ret_val; /* lp5812_chip return value */ + u8 extracted_bits; /* save 9th and 8th bit of reg address */ + u8 converted_reg; /* extracted 8bit from reg */ + struct device *dev =3D &chip->i2c_cl->dev; + struct i2c_msg msgs[2]; + + extracted_bits =3D (reg >> 8) & 0x03; + converted_reg =3D (u8)(reg & 0xFF); + + msgs[0].addr =3D (chip->i2c_cl->addr << 2) | extracted_bits; + msgs[0].flags =3D 0; + msgs[0].len =3D 1; + msgs[0].buf =3D &converted_reg; + + msgs[1].addr =3D (chip->i2c_cl->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->i2c_cl->adapter, msgs, 2); + if (ret !=3D 2) { + dev_err(dev, "Read reg value error, ret=3D%d\n", ret); + *val =3D 0; + ret =3D ret < 0 ? ret : -EIO; + } else { + *val =3D ret_val; + ret =3D 0; + } + + return ret; +} + +static int lp5812_parse_common_child(struct device_node *child, + struct lp5812_led_config *cfg, + int child_number, int color_number) +{ + int reg, ret; + + ret =3D of_property_read_u32(child, "reg", ®); + if (ret) + return ret; + + cfg[child_number].led_id[color_number] =3D reg; + + of_property_read_u8(child, "led-max-microamp", + &cfg[child_number].max_current[color_number]); + + return 0; +} + +static int lp5812_parse_multi_led_child(struct device_node *child, + struct lp5812_led_config *cfg, + int child_number, int color_number) +{ + int color_id, ret; + + ret =3D of_property_read_u32(child, "color", &color_id); + if (ret) + return ret; + + cfg[child_number].color_id[color_number] =3D color_id; + return 0; +} + +static int lp5812_parse_multi_led(struct device_node *np, + struct lp5812_led_config *cfg, + int child_number) +{ + int num_colors =3D 0, ret; + + for_each_available_child_of_node_scoped(np, child) { + ret =3D lp5812_parse_common_child(child, cfg, + child_number, num_colors); + if (ret) + return ret; + + ret =3D lp5812_parse_multi_led_child(child, cfg, child_number, + num_colors); + if (ret) + return ret; + + num_colors++; + } + + cfg[child_number].num_colors =3D num_colors; + cfg[child_number].is_sc_led =3D 0; + + return 0; +} + +static int lp5812_parse_single_led(struct device_node *np, + struct lp5812_led_config *cfg, + int child_number) +{ + int ret; + + ret =3D lp5812_parse_common_child(np, cfg, child_number, 0); + if (ret) + return ret; + + cfg[child_number].num_colors =3D 1; + cfg[child_number].is_sc_led =3D 1; + + return 0; +} + +static int lp5812_parse_logical_led(struct device_node *np, + struct lp5812_led_config *cfg, + int child_number) +{ + int chan_nr, ret; + + of_property_read_string(np, "label", &cfg[child_number].name); + + ret =3D of_property_read_u32(np, "reg", &chan_nr); + if (ret) + return ret; + + cfg[child_number].chan_nr =3D chan_nr; + + if (of_node_name_eq(np, "multi-led")) + return lp5812_parse_multi_led(np, cfg, child_number); + else + return lp5812_parse_single_led(np, cfg, child_number); +} + +static struct lp5812_data *lp5812_of_populate_pdata(struct device *dev, + struct device_node *np, + struct lp5812_chip *chip) +{ + struct lp5812_data *pdata; + struct lp5812_led_config *cfg; + int num_channels, i =3D 0, ret; + + pdata =3D devm_kzalloc(dev, sizeof(*pdata), GFP_KERNEL); + if (!pdata) + return ERR_PTR(-ENOMEM); + + num_channels =3D of_get_available_child_count(np); + if (num_channels =3D=3D 0) { + dev_err(dev, "no LED channels\n"); + return ERR_PTR(-EINVAL); + } + + cfg =3D devm_kcalloc(dev, num_channels, sizeof(*cfg), GFP_KERNEL); + if (!cfg) + return ERR_PTR(-ENOMEM); + + pdata->led_config =3D &cfg[0]; + pdata->num_channels =3D num_channels; + + for_each_available_child_of_node_scoped(np, child) { + ret =3D lp5812_parse_logical_led(child, cfg, i); + if (ret) + return ERR_PTR(-EINVAL); + i++; + } + + of_property_read_string(np, "label", &pdata->label); + + return pdata; +} + +/* End common functions */ + +/* Begin device functions */ +static int lp5812_update_regs_config(struct lp5812_chip *chip) +{ + int ret; + u8 reg_val; /* save register value */ + + 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); + if (ret =3D=3D 0) + return (int)(reg_val & 0x01); + + return ret; +} + +static int lp5812_disable_all_leds(struct lp5812_chip *chip) +{ + int ret; + + ret =3D lp5812_write(chip, chip->cfg->reg_led_en_1.addr, 0x00); + if (ret) + return ret; + ret =3D lp5812_write(chip, chip->cfg->reg_led_en_2.addr, 0x00); + if (ret) + return ret; + + return ret; +} + +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 int lp5812_device_command(struct lp5812_chip *chip, enum device_com= mand command) +{ + switch (command) { + case LP5812_DEV_CMD_UPDATE: + return lp5812_write(chip, chip->cfg->reg_cmd_update.addr, LP5812_UPDATE_= CMD_VAL); + case LP5812_DEV_CMD_START: + return lp5812_write(chip, chip->cfg->reg_cmd_start.addr, LP5812_START_CM= D_VAL); + case LP5812_DEV_CMD_STOP: + return lp5812_write(chip, chip->cfg->reg_cmd_stop.addr, LP5812_STOP_CMD_= VAL); + case LP5812_DEV_CMD_PAUSE: + return lp5812_write(chip, chip->cfg->reg_cmd_pause.addr, LP5812_PAUSE_CM= D_VAL); + case LP5812_DEV_CMD_CONTINUE: + return lp5812_write(chip, chip->cfg->reg_cmd_continue.addr, + LP5812_CONTINUE_CMD_VAL); + default: + return -EINVAL; + } +} + +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 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) +{ + int ret; + struct lp5812_led *led =3D i2c_get_clientdata(to_i2c_client(dev)); + struct lp5812_chip *chip =3D led->chip; + + 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; + + ret =3D lp5812_disable_all_leds(chip); + if (ret) + return ret; + + return len; +} + +static ssize_t device_command_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; + enum device_command cmd; + + if (sysfs_streq(buf, "update")) + cmd =3D LP5812_DEV_CMD_UPDATE; + else if (sysfs_streq(buf, "start")) + cmd =3D LP5812_DEV_CMD_START; + else if (sysfs_streq(buf, "stop")) + cmd =3D LP5812_DEV_CMD_STOP; + else if (sysfs_streq(buf, "pause")) + cmd =3D LP5812_DEV_CMD_PAUSE; + else if (sysfs_streq(buf, "continue")) + cmd =3D LP5812_DEV_CMD_CONTINUE; + else + return -EINVAL; + + guard(mutex)(&chip->lock); + lp5812_device_command(led->chip, cmd); + 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) +{ + u8 reg_val; + int tsd_stat, config_stat, ret; + struct lp5812_led *led =3D i2c_get_clientdata(to_i2c_client(dev)); + struct lp5812_chip *chip =3D led->chip; + + 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) +{ + int reset, ret; + struct lp5812_led *led =3D i2c_get_clientdata(to_i2c_client(dev)); + struct lp5812_chip *chip =3D led->chip; + + 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 void lp5812_deinit_device(struct lp5812_chip *chip) +{ + (void)lp5812_disable_all_leds(chip); + (void)lp5812_write(chip, chip->cfg->reg_chip_en.addr, (u8)0); +} + +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->i2c_cl->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->i2c_cl->dev, "write 0x0B to DEV_CONFIG12 failed\n"); + return ret; + } + + ret =3D lp5812_update_regs_config(chip); + if (ret) { + dev_err(&chip->i2c_cl->dev, "lp5812_update_regs_config failed\n"); + return ret; + } + + return 0; +} + +/* End device functions */ + +/* Begin led functions*/ +static int lp5812_read_lod_status(struct lp5812_chip *chip, int led_number= , u8 *val) +{ + int ret; + u16 reg; + u8 reg_val; + + 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) +{ + int ret; + u16 reg; + u8 reg_val; + + 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) +{ + int ret; + u16 reg; + u8 reg_val; + + 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) +{ + int ret; + u16 reg; + u8 reg_val; + + 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_set_pwm_dimming_scale(struct lp5812_chip *chip, int led_= number, + enum pwm_dimming_scale scale) +{ + int ret; + u16 reg; + u8 reg_val; + + if (led_number <=3D 7) + reg =3D chip->cfg->reg_dev_config_5.addr; + else + reg =3D chip->cfg->reg_dev_config_6.addr; + + ret =3D lp5812_read(chip, reg, ®_val); + if (ret) + return ret; + if (scale =3D=3D LP5812_PWM_DIMMING_SCALE_LINEAR) + 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_set_phase_align(struct lp5812_chip *chip, int led_number, + int phase_align_val) +{ + int ret, bit_pos; + u16 reg; + u8 reg_val; + + reg =3D chip->cfg->reg_dev_config_7.addr + (led_number / 4); + bit_pos =3D (led_number % 4) * 2; + + ret =3D lp5812_read(chip, reg, ®_val); + if (ret) + return ret; + reg_val |=3D (phase_align_val << bit_pos); + ret =3D lp5812_write(chip, reg, reg_val); + if (ret) + return ret; + ret =3D lp5812_update_regs_config(chip); + + return ret; +} + +static ssize_t lp5812_auto_time_pause_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len, bool start) +{ + struct lp5812_led *led; + struct lp5812_chip *chip; + struct lp5812_led_config *led_cfg; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0, curr_val; + int i, ret, val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + u16 reg; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->led_config[chan_nr]; + for (i =3D 0; i < led_cfg->num_colors; i++) { + sub_str =3D strsep(&str, " "); + if (kstrtoint(sub_str, 0, &val[i])) + return -EINVAL; + } + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led_cfg->num_colors; i++) { + reg =3D LP5812_AUTO_PAUSE_ADDR(led_cfg->led_id[i]); + + /* get original value of slope time */ + ret =3D lp5812_read(chip, reg, &curr_val); + if (ret) + return ret; + + if (start =3D=3D 1) + curr_val =3D (curr_val & 0x0F) | (val[i] << 4); + else + curr_val =3D (curr_val & 0xF0) | (val[i]); + + ret =3D lp5812_write(chip, reg, curr_val); + if (ret) + return -EIO; + } + + return len; +} + +static int lp5812_manual_dc_pwm_control(struct lp5812_chip *chip, int led_= number, + u8 val, enum dimming_type dimming_type) +{ + int ret; + u16 led_base_reg; + + 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) +{ + struct lp5812_chip *chip =3D led->chip; + int ret, i; + + 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) + break; + } + + return ret; +} + +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->pdata->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 mode_parse(const char *buf, enum control_mode *val) +{ + if (sysfs_streq(buf, "manual")) + *val =3D LP5812_MODE_MANUAL; + else if (sysfs_streq(buf, "autonomous")) + *val =3D LP5812_MODE_AUTONOMOUS; + else + return -EINVAL; + + return 0; +} + +static ssize_t mode_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; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0; + enum control_mode val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + int i, ret; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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 (mode_parse(sub_str, &val[i])) + return -EINVAL; + } + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led_cfg->num_colors; i++) { + ret =3D lp5812_set_led_mode(chip, led_cfg->led_id[i], val[i]); + if (ret) + return -EIO; + } + + return len; +} + +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; + const char *name =3D dev->platform_data; + int val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + int i, ret; + u16 reg; + u8 reg_val, chan_nr =3D 0; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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 pwm_dimming_parse(const char *buf, enum pwm_dimming_scale *= val) +{ + if (sysfs_streq(buf, "linear")) + *val =3D LP5812_PWM_DIMMING_SCALE_LINEAR; + else if (sysfs_streq(buf, "exponential")) + *val =3D LP5812_PWM_DIMMING_SCALE_EXPONENTIAL; + else + return -EINVAL; + + return 0; +} + +static ssize_t pwm_dimming_scale_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; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0; + enum pwm_dimming_scale val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + int i, ret; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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 (pwm_dimming_parse(sub_str, &val[i])) + return -EINVAL; + } + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led_cfg->num_colors; i++) { + ret =3D lp5812_set_pwm_dimming_scale(chip, led_cfg->led_id[i], val[i]); + if (ret) + return -EIO; + } + + return len; +} + +static ssize_t pwm_align_parse(const char *buf, enum control_mode *val) +{ + if (sysfs_streq(buf, "forward")) + *val =3D 0; + else if (sysfs_streq(buf, "middle")) + *val =3D 2; + else if (sysfs_streq(buf, "backward")) + *val =3D 3; + else + return -EINVAL; + + return 0; +} + +static ssize_t pwm_phase_align_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; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0; + enum control_mode val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + int i, ret; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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 (pwm_align_parse(sub_str, &val[i])) + return -EINVAL; + } + + guard(mutex)(&chip->lock); + for (i =3D 0; i < led_cfg->num_colors; i++) { + ret =3D lp5812_set_phase_align(chip, led_cfg->led_id[i], val[i]); + 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; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0; + enum control_mode mode; + int val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + int i, ret; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0, i, lsd_status, lod_status; + int size =3D 0, ret; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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; + const char *name =3D dev->platform_data; + u8 val; + int ret; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + 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 ssize_t auto_time_pause_at_start_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_auto_time_pause_store(dev, attr, buf, len, 1); +} + +static ssize_t auto_time_pause_at_stop_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_auto_time_pause_store(dev, attr, buf, len, 0); +} + +static ssize_t auto_playback_eau_number_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; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0, curr_val; + int val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + int i, ret; + u16 reg; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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++) { + reg =3D LP5812_AUTO_PLAYBACK_ADDR(led_cfg->led_id[i]); + + /* get original value of slope time */ + ret =3D lp5812_read(chip, reg, &curr_val); + if (ret) + return ret; + + curr_val =3D (curr_val & 0x0F) | (val[i] << 4); + + ret =3D lp5812_write(chip, reg, curr_val); + if (ret) + return -EIO; + } + + return len; +} + +static ssize_t auto_playback_time_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; + const char *name =3D dev->platform_data; + u8 chan_nr =3D 0, curr_val; + int val[LED_COLOR_ID_MAX]; + char *sub_str, *str =3D (char *)buf; + int i, ret; + u16 reg; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->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++) { + reg =3D LP5812_AUTO_PLAYBACK_ADDR(led_cfg->led_id[i]); + + /* get original value of slope time */ + ret =3D lp5812_read(chip, reg, &curr_val); + if (ret) + return ret; + + curr_val =3D (curr_val & 0xF0) | (val[i]); + + ret =3D lp5812_write(chip, reg, curr_val); + if (ret) + return -EIO; + } + + return len; +} + +static ssize_t aeu_playback_time_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; + const char *name =3D dev->platform_data; + int val[LED_COLOR_ID_MAX]; + int aeu; + u8 chan_nr =3D 0, curr_val; + char *sub_str, *str =3D (char *)buf; + int i, ret; + u16 reg; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->led_config[chan_nr]; + + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + if (kstrtoint(&sub_str[3], 0, &aeu)) + return -EINVAL; + + guard(mutex)(&chip->lock); + 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] < 0 || val[i] > 3) + return -EINVAL; + + reg =3D LP5812_AEU_PLAYBACK_ADDR(led_cfg->led_id[i], aeu); + + ret =3D lp5812_read(chip, reg, &curr_val); + if (ret) + return ret; + + ret =3D lp5812_write(chip, reg, (curr_val & 0xFC) | val[i]); + if (ret) + return -EIO; + } + + return len; +} + +static ssize_t lp5812_aeu_pwm_store(struct device *dev, + struct device_attribute *attr, + u8 pwm_chan, + const char *buf, size_t len) +{ + struct lp5812_led *led; + struct lp5812_chip *chip; + struct lp5812_led_config *led_cfg; + const char *name =3D dev->platform_data; + int val[LED_COLOR_ID_MAX]; + int aeu; + u8 chan_nr =3D 0; + char *sub_str, *str =3D (char *)buf; + int i, ret; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->led_config[chan_nr]; + + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + if (kstrtoint(&sub_str[3], 0, &aeu)) + return -EINVAL; + + pr_info("AEU =3D %d", aeu); + + guard(mutex)(&chip->lock); + 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] < 0 || val[i] > 255) + return -EINVAL; + + ret =3D lp5812_write(chip, + LP5812_AEU_PWM_ADDR(led_cfg->led_id[i], aeu, pwm_chan), + val[i]); + if (ret) + return -EIO; + } + + return len; +} + +static ssize_t aeu_pwm1_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_pwm_store(dev, attr, LP5812_AEU_PWM1, buf, len); +} + +static ssize_t aeu_pwm2_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_pwm_store(dev, attr, LP5812_AEU_PWM2, buf, len); +} + +static ssize_t aeu_pwm3_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_pwm_store(dev, attr, LP5812_AEU_PWM3, buf, len); +} + +static ssize_t aeu_pwm4_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_pwm_store(dev, attr, LP5812_AEU_PWM4, buf, len); +} + +static ssize_t aeu_pwm5_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_pwm_store(dev, attr, LP5812_AEU_PWM5, buf, len); +} + +static ssize_t lp5812_aeu_slope_time(struct device *dev, + struct device_attribute *attr, + enum slope_time_num slope_chan, + const char *buf, size_t len) +{ + struct lp5812_led *led; + struct lp5812_chip *chip; + struct lp5812_led_config *led_cfg; + const char *name =3D dev->platform_data; + int val[LED_COLOR_ID_MAX]; + u8 chan_nr =3D 0; + char *sub_str, *str =3D (char *)buf; + int i, ret, aeu; + union slope_time slope_time_val; + u16 reg; + + if (strcmp(name, LP5812_SC_LED) =3D=3D 0) + led =3D dev_to_lp5812_led(dev); + else + led =3D dev_to_lp5812_led_mc(dev); + + chan_nr =3D led->chan_nr; + chip =3D led->chip; + led_cfg =3D &chip->pdata->led_config[chan_nr]; + + sub_str =3D strsep(&str, ":"); + if (!sub_str) + return -EINVAL; + if (kstrtoint(&sub_str[3], 0, &aeu)) + return -EINVAL; + + pr_info("AEU =3D %d", aeu); + + guard(mutex)(&chip->lock); + 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] < 0 || val[i] > 15) + return -EINVAL; + + reg =3D LP5812_AEU_SLOPE_TIME_ADDR(led_cfg->led_id[i], aeu, slope_chan); + + /* get original value of slope time */ + ret =3D lp5812_read(chip, reg, &slope_time_val.time_val); + if (ret) + return ret; + + /* Update new value for slope time*/ + if (slope_chan =3D=3D LP5812_SLOPE_TIME_T1 || slope_chan =3D=3D LP5812_S= LOPE_TIME_T3) + slope_time_val.s_time.first =3D val[i]; + if (slope_chan =3D=3D LP5812_SLOPE_TIME_T2 || slope_chan =3D=3D LP5812_S= LOPE_TIME_T4) + slope_time_val.s_time.second =3D val[i]; + + /* Save updated value to hardware */ + ret =3D lp5812_write(chip, reg, slope_time_val.time_val); + if (ret) + return ret; + } + + return len; +} + +static ssize_t aeu_slop_time_t1_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_slope_time(dev, attr, LP5812_SLOPE_TIME_T1, buf, len); +} + +static ssize_t aeu_slop_time_t2_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_slope_time(dev, attr, LP5812_SLOPE_TIME_T2, buf, len); +} + +static ssize_t aeu_slop_time_t3_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_slope_time(dev, attr, LP5812_SLOPE_TIME_T3, buf, len); +} + +static ssize_t aeu_slop_time_t4_store(struct device *dev, + struct device_attribute *attr, + const char *buf, size_t len) +{ + return lp5812_aeu_slope_time(dev, attr, LP5812_SLOPE_TIME_T4, buf, len); +} + +/* End led function */ + +static DEVICE_ATTR_WO(led_current); +static DEVICE_ATTR_RO(max_current); +static DEVICE_ATTR_WO(mode); +static DEVICE_ATTR_WO(activate); +static DEVICE_ATTR_WO(pwm_dimming_scale); +static DEVICE_ATTR_WO(pwm_phase_align); +static DEVICE_ATTR_WO(auto_time_pause_at_start); +static DEVICE_ATTR_WO(auto_time_pause_at_stop); +static DEVICE_ATTR_WO(auto_playback_eau_number); +static DEVICE_ATTR_WO(auto_playback_time); +static DEVICE_ATTR_WO(aeu_playback_time); +static DEVICE_ATTR_WO(aeu_pwm1); +static DEVICE_ATTR_WO(aeu_pwm2); +static DEVICE_ATTR_WO(aeu_pwm3); +static DEVICE_ATTR_WO(aeu_pwm4); +static DEVICE_ATTR_WO(aeu_pwm5); +static DEVICE_ATTR_WO(aeu_slop_time_t1); +static DEVICE_ATTR_WO(aeu_slop_time_t2); +static DEVICE_ATTR_WO(aeu_slop_time_t3); +static DEVICE_ATTR_WO(aeu_slop_time_t4); +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_mode.attr, + &dev_attr_activate.attr, + &dev_attr_pwm_dimming_scale.attr, + &dev_attr_pwm_phase_align.attr, + &dev_attr_auto_time_pause_at_start.attr, + &dev_attr_auto_time_pause_at_stop.attr, + &dev_attr_auto_playback_eau_number.attr, + &dev_attr_auto_playback_time.attr, + &dev_attr_aeu_playback_time.attr, + &dev_attr_aeu_pwm1.attr, + &dev_attr_aeu_pwm2.attr, + &dev_attr_aeu_pwm3.attr, + &dev_attr_aeu_pwm4.attr, + &dev_attr_aeu_pwm5.attr, + &dev_attr_aeu_slop_time_t1.attr, + &dev_attr_aeu_slop_time_t2.attr, + &dev_attr_aeu_slop_time_t3.attr, + &dev_attr_aeu_slop_time_t4.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 cdev_to_lp5812_led(cdev); + const struct lp5812_device_config *cfg =3D led->chip->cfg; + + led->brightness =3D (u8)brightness; + return cfg->brightness_fn(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 mcled_cdev_to_lp5812_led(mc_dev); + const struct lp5812_device_config *cfg =3D led->chip->cfg; + + led_mc_calc_color_components(&led->mc_cdev, brightness); + return cfg->multicolor_brightness_fn(led); +} + +static int lp5812_init_led(struct lp5812_led *led, struct lp5812_chip *chi= p, int chan) +{ + struct lp5812_data *pdata =3D chip->pdata; + struct device *dev =3D &chip->i2c_cl->dev; + struct mc_subled *mc_led_info; + struct led_classdev *led_cdev; + int i, ret =3D 0; + + if (pdata->led_config[chan].name) { + led->cdev.name =3D pdata->led_config[chan].name; + } else { + led->cdev.name =3D devm_kasprintf(dev, GFP_KERNEL, "%s:channel%d", + pdata->label ? : chip->i2c_cl->name, chan); + if (!led->cdev.name) + return -ENOMEM; + } + + if (pdata->led_config[chan].is_sc_led =3D=3D 0) { + mc_led_info =3D devm_kcalloc(dev, + pdata->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 pdata->led_config[chan].num_colors; + for (i =3D 0; i < led->mc_cdev.num_colors; i++) { + mc_led_info[i].color_index =3D + pdata->led_config[chan].color_id[i]; + mc_led_info[i].channel =3D + pdata->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 (pdata->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 devm_kstrdup(dev, LP5812_SC_LED, GFP_K= ERNEL); + if (!led->cdev.dev->platform_data) + return -ENOMEM; + } + } 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 + devm_kstrdup(dev, LP5812_MC_LED, GFP_KERNEL); + if (!led->mc_cdev.led_cdev.dev->platform_data) + return -ENOMEM; + + 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"); + } + } + + if (ret) { + dev_err(dev, "led register err: %d\n", ret); + return ret; + } + + return 0; +} + +static int lp5812_register_leds(struct lp5812_led *led, struct lp5812_chip= *chip) +{ + int num_channels =3D chip->pdata->num_channels; + struct lp5812_led *each; + 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->pdata->led_config[i].num_colors; j++) { + ret =3D lp5812_auto_dc(chip, chip->pdata->led_config[i].led_id[j], + chip->pdata->led_config[i].led_id[j]); + 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->i2c_cl->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->i2c_cl->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->pdata->num_channels; i++) { + if (!chip->pdata->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_probe(struct i2c_client *client) +{ + struct lp5812_chip *chip; + int ret; + const struct i2c_device_id *id =3D i2c_client_get_device_id(client); + struct lp5812_data *pdata =3D dev_get_platdata(&client->dev); + struct device_node *np =3D dev_of_node(&client->dev); + struct lp5812_led *led; + + chip =3D devm_kzalloc(&client->dev, sizeof(*chip), GFP_KERNEL); + if (!chip) + return -ENOMEM; + + chip->cfg =3D i2c_get_match_data(client); + + if (!pdata) { + if (np) { + pdata =3D lp5812_of_populate_pdata(&client->dev, np, + chip); + if (IS_ERR(pdata)) + return PTR_ERR(pdata); + } else { + return dev_err_probe(&client->dev, -EINVAL, "no platform data\n"); + } + } + + led =3D devm_kcalloc(&client->dev, + pdata->num_channels, sizeof(*led), GFP_KERNEL); + if (!led) + return -ENOMEM; + + chip->i2c_cl =3D client; + chip->pdata =3D pdata; + + mutex_init(&chip->lock); + + i2c_set_clientdata(client, led); + + ret =3D lp5812_init_device(chip); + if (ret) + goto err_init; + + dev_info(&client->dev, "%s Programmable led chip found\n", id->name); + + ret =3D lp5812_register_leds(led, chip); + if (ret) + goto err_out; + + ret =3D lp5812_register_sysfs(chip); + if (ret) { + dev_err_probe(&client->dev, ret, "registering sysfs failed\n"); + goto err_out; + } + + return 0; + +err_out: + lp5812_deinit_device(chip); +err_init: + 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); + + dev_info(&client->dev, "Removed driver\n"); +} + +static LP5812_DEV_ATTR_WO(dev_config); +static LP5812_DEV_ATTR_WO(device_command); +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_device_command.attr, + &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_cmd_start =3D { + .addr =3D LP5812_CMD_START, + .val =3D 0 + }, + .reg_cmd_stop =3D { + .addr =3D LP5812_CMD_STOP, + .val =3D 0 + }, + .reg_cmd_pause =3D { + .addr =3D LP5812_CMD_PAUSE, + .val =3D 0 + }, + .reg_cmd_continue =3D { + .addr =3D LP5812_CMD_CONTINUE, + .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_aeu_base =3D { + .addr =3D LP5812_AEU_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 + }, + + .brightness_fn =3D lp5812_led_brightness, + .multicolor_brightness_fn =3D lp5812_multicolor_brightness, + + .dev_attr_group =3D &lp5812_group +}; + +static const struct i2c_device_id lp5812_id[] =3D { + { "lp5812", .driver_data =3D (kernel_ulong_t)&lp5812_cfg }, + { } +}; + +MODULE_DEVICE_TABLE(i2c, lp5812_id); + +#ifdef CONFIG_OF +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); +#endif + +static struct i2c_driver lp5812_driver =3D { + .driver =3D { + .name =3D "lp5812", + .of_match_table =3D of_match_ptr(of_lp5812_match), + }, + .probe =3D lp5812_probe, + .remove =3D lp5812_remove, + .id_table =3D lp5812_id, +}; + +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..23e333fc02bf --- /dev/null +++ b/drivers/leds/rgb/leds-lp5812.h @@ -0,0 +1,227 @@ +/* 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_CMD_START 0x0011 +#define LP5812_CMD_STOP 0x0012 +#define LP5812_CMD_PAUSE 0x0013 +#define LP5812_CMD_CONTINUE 0x0014 +#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_AEU_BASE 0x0080 + +#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_START_CMD_VAL 0xFF +#define LP5812_STOP_CMD_VAL 0xAA +#define LP5812_PAUSE_CMD_VAL 0x33 +#define LP5812_CONTINUE_CMD_VAL 0xCC + +#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 +}; + +enum pwm_dimming_scale { + LP5812_PWM_DIMMING_SCALE_LINEAR =3D 0, + LP5812_PWM_DIMMING_SCALE_EXPONENTIAL +}; + +enum device_command { + LP5812_DEV_CMD_NONE, + LP5812_DEV_CMD_UPDATE, + LP5812_DEV_CMD_START, + LP5812_DEV_CMD_STOP, + LP5812_DEV_CMD_PAUSE, + LP5812_DEV_CMD_CONTINUE +}; + +enum slope_time_num { + LP5812_SLOPE_TIME_T1 =3D 0, + LP5812_SLOPE_TIME_T2, + LP5812_SLOPE_TIME_T3, + LP5812_SLOPE_TIME_T4 +}; + +enum aeu_pwm_num { + LP5812_AEU_PWM1 =3D 1, + LP5812_AEU_PWM2, + LP5812_AEU_PWM3, + LP5812_AEU_PWM4, + LP5812_AEU_PWM5 +}; + +union slope_time { + struct { + u8 first:4; + u8 second:4; + } __packed s_time; + u8 time_val; +}; /* type for start/stop pause time and slope time */ + +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; + +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_cmd_start; + const struct lp5812_reg reg_cmd_stop; + const struct lp5812_reg reg_cmd_pause; + const struct lp5812_reg reg_cmd_continue; + + 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_aeu_base; + const struct lp5812_reg reg_lod_status_base; + const struct lp5812_reg reg_lsd_status_base; + + /* set LED brightness */ + int (*brightness_fn)(struct lp5812_led *led); + + /* set multicolor LED brightness */ + int (*multicolor_brightness_fn)(struct lp5812_led *led); + + /* additional device specific attributes */ + const struct attribute_group *dev_attr_group; +}; + +struct lp5812_led_config { + const char *name; + int led_id[LED_COLOR_ID_MAX]; + u8 color_id[LED_COLOR_ID_MAX]; + u8 max_current[LED_COLOR_ID_MAX]; + int num_colors; + u8 chan_nr; + bool is_sc_led; +}; + +struct lp5812_data { + struct lp5812_led_config *led_config; + u8 num_channels; + const char *label; +}; + +struct lp5812_chip { + struct i2c_client *i2c_cl; + struct mutex lock; /* Protects reg access */ + struct lp5812_data *pdata; + const struct lp5812_device_config *cfg; + union u_scan_order u_scan_order; + union u_drive_mode u_drive_mode; +}; + +struct lp5812_led { + int chan_nr; + struct led_classdev cdev; + struct led_classdev_mc mc_cdev; + u8 brightness; + struct lp5812_chip *chip; +}; + +#endif /*_LP5812_H_*/ --=20 2.25.1 From nobody Thu Oct 9 08:47:47 2025 Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) (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 501DB2F94BF; Wed, 18 Jun 2025 18:32:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.169 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271555; cv=none; b=mc741WPO3hZG7EulIp7BV131g5Enx2rr69ddSUwKUjUJVXbCQ1nfd3GllkNa3qJwcbFDOovJqcM2lbchNSUVDeo04kmcxgNo0gkO9M7xzW2rwcdAszwfRKYmL6hYGzRTJAu+R0Wr4B1WCWz4MjdlCkGj67R8Szqwem5zaHXcTik= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271555; c=relaxed/simple; bh=Vl2YaMKjly/V1W36xIR4JIP4lS7i+8jGRYUWL/eIeyY=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=eRgRzBQiBlaokgRqRSfJeXnNLu3RygkmCoaNIMX90eA+agCWK7PEJHzkA9SI1WW/G8DNIY98lqMaJKqIpvOMuqDRI4fm9mXfgDtbmoKSSpqn+ecOJTSw0GeBzI1O6uneR+cLLTI+zehOH5OxUGc/XU3mVfoiIZItVBXwGT43+PQ= 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=hrg5jnSG; arc=none smtp.client-ip=209.85.214.169 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="hrg5jnSG" Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-234f17910d8so46145ad.3; Wed, 18 Jun 2025 11:32:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750271552; x=1750876352; 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=hBxIn0XqrDJ/+zfvzzgIjEfOUJRZPwb+TvxglfGh4nE=; b=hrg5jnSGhAWN3DYHweTeV/3SzHUwVRC5ebZHytp8AE0vKr6TjmeSsLjt2ZDyzDsNS0 Khr5qJPbS29ca0XduQXEa2xPT3AuWdlpLEymFC7fnlJSTujFP77wvViPB+Wg7Vm4crdl F3PfMCVLBdjmxUBwB11qj6caKljXd8sEjVe6Wxh5wL59+zNK6/CurISjAJNmpoOMYBFB xrgjkGTr2KPYD/GT2MXwvba9awmSNzFsuvQT2xgpcIghPVzOLqV65ISs0aPFJnG7eWAC ydbEVH2T9Fm24jtt2aibSZCx5OsOCqcC7iqkuBsnE0QIjHFkgcAh8BqpXUNXH6YwSl4w O7dw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750271552; x=1750876352; 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=hBxIn0XqrDJ/+zfvzzgIjEfOUJRZPwb+TvxglfGh4nE=; b=NPw+fKp3VWEHzsF2lXF8hdf9jCu8Z+p8xvM9g2813PaKSsgAT3OzwgRDvrToQqIa1a 0ccB4osXp+CseeT+5mpZIWzl7jHKWfe9/jboU6JTtLe9RixCsra2QXkYT/6lcXeOClA5 YxuqlR6GFKUsZaIKriso819BVhnfHosTQDe62xSh04+STe3gME+x0+esZQ3geVxur0k9 QNa1DSRSH4nDJpbPrZZNNIcfzyZBc3BpQr71goMBT0pGwHIGaogEwk9tjW21fBy5TdG8 UwSXP2/Bmmv2NRds2ovpoNZOmr4HYxcyxDbRjGkVLjobcEUCwQtTPe5hHhJCZqcteq9t UIdw== X-Forwarded-Encrypted: i=1; AJvYcCUluNujFARS7WFKD+p/npQPJ7y9DfJIGCngDS/KCubu6yjYGqwHhkW4K96ybWALSBAm5WfLKsnu/jKuqQ==@vger.kernel.org, AJvYcCUremGXUbq+IHYW3WknfKO1BYV4hQxz4mvFEFdZsKkUfWQ2UqzgmebKPqkGYpNHHMv7sAs4QcGZzSal@vger.kernel.org, AJvYcCXCKtz8zugzxNFoi8S347aRI/SMP8/l7bcjYquSBbC2Iero+QjrVOc3i9EIEheGFAcAvtZGbbJccC34@vger.kernel.org, AJvYcCXNUqCl3Q1yTyMx5x+8ruKzbqZVa5JAhejdQN/CLFReLdmkr7iyC0ekgquNcqrcGKrQADcv4fNEddakBNsN@vger.kernel.org X-Gm-Message-State: AOJu0YyduPOxmQwxguTsqQk8UtTGBqSXbFRLeKuLmB0j5KYpdXG+Itbo STp2gR21KWTJQprs0cYoYHeFkG77sps3hYNDTDLvAme8E1Sn3r/k9pHB X-Gm-Gg: ASbGncuAciNfeKyoqKkR38F/D4c7QJPzRygii2UNpygae9+GzvUszQclRugb29CNlbP nCC+oXwuSr6DVth6MQsAbQY1P2ACDlg5NOwZ3UMg/oM25FChBtdINkByqAt18sukKbgguCbWGEb 0D0nJ20HvsL6pSW0pk6Q5p6gk6tI6YWJRpMjs00Sx936yWNhw6t+FgUDcXSk8RA7vg1XIfaSJmH ajwJQgSPYLUdIW6EeKDxczLu+kGvOM8Otm+67640ava5SMs5XDNyc5LALrpzoUK7zDj5kY/S4LO YzmLqlFN5mqVOGdqLdnXB8SgI7Cl8yr3/VnGePo5vABPRtowFosgsyLTmZAU8pDTDVhXl33PFQc QDu+9zIo= X-Google-Smtp-Source: AGHT+IGY0bmVW8S9wEQ7CqAOAw/XBjkKnKcbvuDIA1uUYEVeRAn5EwKwHHZoweywRB6ZyrC0oMoEfg== X-Received: by 2002:a17:903:2347:b0:235:91a:4d with SMTP id d9443c01a7336-2366b0185e5mr250951485ad.23.1750271552362; Wed, 18 Jun 2025 11:32:32 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.113.163.91]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b2fe1639f97sm9606454a12.6.2025.06.18.11.32.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 18 Jun 2025 11:32:31 -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 v10 3/4] docs: ABI: Document LP5812 LED sysfs interfaces Date: Thu, 19 Jun 2025 01:32:04 +0700 Message-Id: <20250618183205.113344-4-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250618183205.113344-1-trannamatk@gmail.com> References: <20250618183205.113344-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. The driver provides interfaces to configure LED modes manual/autonomous, set PWM/DC values, and manage autonomous animation engines. Signed-off-by: Nam Tran --- .../ABI/testing/sysfs-bus-i2c-devices-lp5812 | 40 ++++++ .../ABI/testing/sysfs-class-led-lp5812 | 120 ++++++++++++++++++ MAINTAINERS | 2 + 3 files changed, 162 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..a8b1d5c52a82 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-lp5812 @@ -0,0 +1,40 @@ +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/device_command +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Issues device-level commands. (WO) + Valid values: "update", "start", "stop", "pause", "continue" + +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..a6cb49fb523f --- /dev/null +++ b/Documentation/ABI/testing/sysfs-class-led-lp5812 @@ -0,0 +1,120 @@ +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_/mode +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Selects LED operation mode. (WO) + Valid values: "manual", "autonomous" + +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_/pwm_dimming_scale +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + PWM dimming scale type. (WO) + Valid values: "linear", "exponential" + +What: /sys/class/leds/led_/pwm_phase_align +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Configures PWM phase alignment. (WO) + Valid values: "forward", "middle", "backward" + +What: /sys/class/leds/led_/auto_time_pause_at_start +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Controls start pause time. (WO) + Valid values: 0 - 15 + +What: /sys/class/leds/led_/auto_time_pause_at_stop +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Controls stop pause time. (WO) + Valid values: 0 - 15 + +What: /sys/class/leds/led_/auto_playback_eau_number +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Active AEU number of led_ selection. (WO) + Valid values: 0 - 3 + 0 - only use AEU1 + 1 - use AEU1 and AEU2 + 2 - use AEU1, AEU2 and AEU3 + 3 - use AEU1, AEU2 and AEU3 (the same as 2) + +What: /sys/class/leds/led_/auto_playback_time +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + Animation pattern playback times of led_. (WO) + Valid values: 0 - 15 + 0 - 14 means 0 - 14 times, 15 means infinite times + +What: /sys/class/leds/led_/aeu_playback_time +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + AEU pattern playback times of led_. (WO) + Format: aeu: where x (1 - 3) indicates the AEU number, + y (0 - 3) indicates the number of playback times. + +What: /sys/class/leds/led_/aeu_pwm_ +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + AEU PWM duty cycle setting. (WO) + Format: aeu: where x (1 - 3) indicates the AEU number, + y (0 - 255) indicates pwm value. + +What: /sys/class/leds/led_/aeu_slop_time_ +Date: July 2025 +KernelVersion: 6.17 +Contact: Nam Tran +Description: + AEU slop time setting. (WO) + Format: aeu: where x (1 - 3) indicates the AEU number, + y (0 - 15) indicates the slop time value. + +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 b4eb3265c800..cdba86f1768b 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24565,6 +24565,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 Thu Oct 9 08:47:47 2025 Received: from mail-pf1-f174.google.com (mail-pf1-f174.google.com [209.85.210.174]) (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 795D92FBFE9; Wed, 18 Jun 2025 18:32:38 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.174 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271560; cv=none; b=RNJVQesMZkJt1mqv/T/1mbc9VlH/kBgHE071aA6V20Dnu9UlA1kurgrmq42NT7dfNcDCOwBrCGD/xZTcFiJey1ivauBVHBdvZNcut/7YFAZWzARqep7l054UgsDOmWqqrio59Jp5QLOb1c51XMu9Rrl+BWjWTPR3/Zd1iRJYoNI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1750271560; c=relaxed/simple; bh=56Sl/nGt3m5t3J5G+VzsIzv0+c8kzRwGZwhJI4NYYaI=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version:Content-Type; b=jsjyfm9dLrY15Bq8yqBa/NVTKlfW0hKJmq8eWvLz+7R9U7AtUe3ynzweXRcba6DbnEe0odA89JPYPTX7eM+8y+DRtqiMwCTycbejes/UMLzyWUpscnhSaq6HAii9HOtkKlmXUw7ZZVe7LSbgIabtaPK9YiLIttp+Pq+JtJKcbcw= 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=OKTxxZ3I; arc=none smtp.client-ip=209.85.210.174 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="OKTxxZ3I" Received: by mail-pf1-f174.google.com with SMTP id d2e1a72fcca58-748e81d37a7so747379b3a.1; Wed, 18 Jun 2025 11:32:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1750271558; x=1750876358; 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=4V9Yp9AA3hWAb7aqFhJTn2UKytTjSMNN61SVrfVNk7w=; b=OKTxxZ3IydbBvJX/2jgRuEZAXPYyx4z3R4NgD8mc+VKQc7pQdG2aon6cGDdZZ732rH nagfNVSmqoZCOj/Mb9bEl0bF1qmhy7MvnFowem10cQiiJwjRyQPaD1WvS9Et3PmG/KwJ BRr56p7E5nw84abAPp1MxVHyghn4/heYYch3SG3alwpoC5tfSMjL4f+I0fAX+4rF+ciV OtQC5Qa15bjJyiTzknzykR7IMHU50t/W5oPHg5sKpHj4t2leWNYe3W/DLw3qi90qyOvu AN0Lbhp8p6WP372LvUs0TOl9owHCLewX4dpU0ba8s2ix/c2ZO/gezZLwk2ia276PbuqG PNJQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1750271558; x=1750876358; 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=4V9Yp9AA3hWAb7aqFhJTn2UKytTjSMNN61SVrfVNk7w=; b=Rt2eItVlUcWTdRhyCnItAeP0JmRGtmLAkiaoSOGsiu+GmUApbDEV3x/SdXpEJipPHN 6h6AvpzakGCW3GMIsgdB7dTlbR9qkCp+z6tu+nhsyGSifJhrClvjhYYJhT+JS6zd/zWA 2eRvO0Yp4J13uDjCKQaaN+USDauyorPdYwYV9gK/z2SbTmQo2cnVwb0jbeYRAxvpokKO owe67tXx3J7vRb4MqosRy9vabQqBDyM0s2gGzhHROs18K860FjEUeMx88aQ5L4mEfeLb bsMYA8Me13SJRIoCWJk7lxu/4sI8+QS0rGf6R43FMZMsPzpvrDSN6cbwsI47bRxoa+bU 05Wg== X-Forwarded-Encrypted: i=1; AJvYcCVwtTIR/ffZdDaFyJ70kPAYHU4XWjKu9Ph98o76eGJ2cscV9yed6cnsivsxAKky3Z7hZKkLoYqFs3uTBLXt@vger.kernel.org, AJvYcCWPJLgBhUFYtt33C6yCEp+H1lZRdeTVUlKhMzXVChvEi/qRuAwsF9/fZE4WiqDvHzaRMDOTz9QDENit@vger.kernel.org, AJvYcCWeCgH24jjbT11t7uZFeR0n3O8daYqjMPKDouDhp4QgqzlcA+mcJDGHQhczZCP6wIWUb8HsUDUG3sow@vger.kernel.org, AJvYcCXowv50OTZkxuB+d8UAGWjRS0MJnEnD/hDfPZmgB65fN0Bx8WEFtmqT9I/wFZZFZCSiNty5rOApbNz7NQ==@vger.kernel.org X-Gm-Message-State: AOJu0Yw/MLYjd31UvJuFDUDgYPmcIWzO++p6r0CLXpP8CwWgoa9EgMN5 m1BHvwUVQ1VGoNrH42VHuTHzUA6sfb1QpfrblzPcUccnzdgDAMwiKBxU X-Gm-Gg: ASbGncvFF2JrceHmh85qFp++qm6qJQ+ZB4hPM1e63VDp69TmK0LveBlqq18Nctuc80y jTcwGVnJNozpdQiCcyLYLv3/+rQtKAPOv958KIUiJA1F625oSOQHl0H+jLvGAOB07smifiXXNnF IOT6Qle05xhWvjhNaS3JCJatGr1GVkJpx1k1Zyq8odn1t8X1Q8FNVXMvRGNWqVl9I7uzINBKz6d q+m4Oj+A6Rs3N35Oq0YtwvbJya9gFwmL00WHuQllRobm++l++kDi6F4dLCnIgNejvYe6zC3i8M5 FxmIgsR+/FPJcOV0T9PC9EOVUCq8r6ETbU+FrsV346K9ZmUDbPTQLuI0+0o0448ffF6uSrB0 X-Google-Smtp-Source: AGHT+IHxG9XbUgbsz3AXCKtUbw40NVDtwgtcYywPrcmxo7eCIXNYVplLkQY/by6iIoiecAYOBHQWHg== X-Received: by 2002:a05:6a21:329e:b0:1f5:97c3:41b9 with SMTP id adf61e73a8af0-21fbd505d57mr25020541637.5.1750271557612; Wed, 18 Jun 2025 11:32:37 -0700 (PDT) Received: from DESKTOP-P76LG1N.lan ([42.113.163.91]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b2fe1639f97sm9606454a12.6.2025.06.18.11.32.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 18 Jun 2025 11:32:37 -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 v10 4/4] docs: leds: Document TI LP5812 LED driver Date: Thu, 19 Jun 2025 01:32:05 +0700 Message-Id: <20250618183205.113344-5-trannamatk@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250618183205.113344-1-trannamatk@gmail.com> References: <20250618183205.113344-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 | 84 ++++++++++++++++++++++++++++++ MAINTAINERS | 1 + 3 files changed, 86 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..4538cfdf415d --- /dev/null +++ b/Documentation/leds/leds-lp5812.rst @@ -0,0 +1,84 @@ +=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. It provides features such as: + +- PWM dimming and DC current control +- Slope time configuration +- Autonomous Engine Unit (AEU) for LED animation playback +- Flexible scan and drive mode configuration + +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) + - device_command: Issue device-wide commands (WO) + - 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) + - mode: manual or autonomous mode (WO) + - led_current: DC current value (0=E2=80=93255) (WO) + - max_current: maximum DC current bit setting (RO) + - pwm_dimming_scale: linear or exponential (WO) + - pwm_phase_align: PWM alignment mode (WO) + - auto_time_pause_at_start: config start pause time (WO) + - auto_time_pause_at_stop: config stop pause time (WO) + - auto_playback_eau_number: Activate AEU number (WO) + - auto_playback_time: Animation pattern playback times (WO) + - aeu_playback_time: playback times for the specific AEU (WO) + - aeu_pwm_: PWM duty cycle setting for the specific AEU (WO) + - aeu_slop_time_: slop time setting for the specific AEU (WO) + - 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 1 1 1 > /sys/class/leds/LED_A/activate + echo manual manual manual > /sys/class/leds/LED_A/mode + echo 100 100 100 > /sys/class/leds/LED_A/led_current + echo 50 50 50 > /sys/class/leds/LED_A/multi-intensity + +To control led_A in autonomous mode:: + echo 1 1 1 > /sys/bus/i2c/drivers/lp5812/xxxx/led_A/activate + echo autonomous autonomous autonomous > /sys/class/leds/LED_A/mode + echo linear exponential linear > /sys/class/leds/led_/pwm_dimming_= scale + echo forward forward backward > /sys/class/leds/led_/pwm_phase_ali= gn + echo 0 0 0 > /sys/class/leds/led_A/auto_playback_eau_number # only use= AEU1 + echo 10 10 10 > /sys/class/leds/led_A/auto_time_pause_at_start + echo 10 10 10 > /sys/class/leds/led_A/auto_time_pause_at_stop + echo 15 15 15 > /sys/class/leds/led_A/auto_playback_time + echo aeu1:100 100 100 > /sys/class/leds/led_A/aeu_pwm1 + echo aeu1:100 100 100 > /sys/class/leds/led_A/aeu_pwm2 + echo aeu1:100 100 100 > /sys/class/leds/led_A/aeu_pwm3 + echo aeu1:100 100 100 > /sys/class/leds/led_A/aeu_pwm4 + echo aeu1:100 100 100 > /sys/class/leds/led_A/aeu_pwm5 + echo aeu1:5 5 5 > /sys/class/leds/led_A/aeu_slop_time_t1 + echo aeu1:5 5 5 > /sys/class/leds/led_A/aeu_slop_time_t2 + echo aeu1:5 5 5 > /sys/class/leds/led_A/aeu_slop_time_t3 + echo aeu1:5 5 5 > /sys/class/leds/led_A/aeu_slop_time_t4 + echo aeu1:1 1 1 > /sys/class/leds/led_A/aeu_playback_time + echo start > /sys/bus/i2c/drivers/lp5812/xxxx/lp5812_chip_setup/device= _command diff --git a/MAINTAINERS b/MAINTAINERS index cdba86f1768b..4fefc7fb7a9a 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -24568,6 +24568,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