From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f193.google.com (mail-pl1-f193.google.com [209.85.214.193]) (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 D50691D5CFE for ; Sun, 26 Oct 2025 12:39:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.193 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761482379; cv=none; b=laFC95x++D19Ng0W2QEFLTh8vFhfZZcNxwd8AUaWg4A994qQWwOYpzbmr03oOTo1zGrh7u3+9XsUQfE2ST/Kdt7aiIXGbG6/CVlpOe6uhXBoSdl7Rl3TyBqTGpecg2dnGkokA7wKA88FzS966KlowbBrIiVn7s38YdobtVMqezQ= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1761482379; c=relaxed/simple; bh=FwahnmFI+RANUbP/ccocpD49/vz2nmfLhC6tjHp5sWQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=jyv+wr5Q9OzmonWJ8yQL5cx2a+812ha7tgno0gkxlI8Eiv7rYSLmlcEYq07dAfj0mTJYeCWCgh+epFDPivnuiZcEcrrFzgh5Ixe5wa/sMt/mJh+yVzlVpfIPvLyvcxfsFR9MkgZERY/BgInywHpvNcmUbIyP2WYKG9aWeJmPZHg= 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=NjVnWuQJ; arc=none smtp.client-ip=209.85.214.193 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="NjVnWuQJ" Received: by mail-pl1-f193.google.com with SMTP id d9443c01a7336-290a3a4c7ecso41064795ad.0 for ; Sun, 26 Oct 2025 05:39:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1761482376; x=1762087176; 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=ieZihMLOOLBctZi12lxn8LR/iyKa5pG/boJ+0OiRR90=; b=NjVnWuQJkHnC0qeAII8x/wOD8/oIn4gEQOhkkLDRqz1f6wIIN5HtU+eGYrHUIXVCGN hgfyeFpJCAzoKDguTh8apmZ/RptddfLj6uKo2h0UPGLOa9NBh0gSCSzDEyiEHygflyeS FPb1tZq8QQKzCoNDVCnZgFnx9p3avbtRwtRe0wmHozy4rdh6vtD58/nWWZeuYwGdL7uG MjpESRxUdg3RPQOOktbgKXwsLQ/iR2kUR4yU64keyB6ZnU+gJwEbriLO6Jaoj2Fdrhsy h6aT/aRpkZ2eai+1eXQPK2A7CeuB/vhVWUXCHBLAY4vo74dkrJIZw5Jljr1/ZbeeDpGJ 7DOA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1761482376; x=1762087176; 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=ieZihMLOOLBctZi12lxn8LR/iyKa5pG/boJ+0OiRR90=; b=u4ZK9Yesb9id+wTarv8QcYgzdT0BnKpgidnR/xCpA3jqIDzsNop6dlH19KFaC5I/Cu gz7xzdZdR2tLBH1qDIpx+Acb0JukFQCPDM8ipKlt6j0cozEkwraS82Xm8NiC77BM9pkq PHmqxg/H5z9kP9fGNyIQNTGJuksMRmS/sKf0Y2g/7OfS2a3ZS/Ldm5Pf9TVzWfJv1kY0 oNkKylnSTIpirdCqMAm4eMF3iWoXHwUFs3WSrL/9qwG6pQnKE4UeZUL3pHvIHA/oLBsm T4eKUokkdoRegPVZGrIPpaxb1JTQMvFbEU/tBk6SZXgYulXsok5XGIdDa8uzHvCd9LK5 H1uw== X-Forwarded-Encrypted: i=1; AJvYcCWp9h080hju4rnkTrYtn3RQe7T/gkUhbzQITJe0vt8q2kN1ioD+Rqol90mmJW2boSNosvQuWcp1oRQ1xQ==@vger.kernel.org X-Gm-Message-State: AOJu0YyWOiCAb9toPqVyTxxKz9cmH6nZEfEmzTGsj6Fy82QlWaxuRMvt n1hCAzkt4hfNxLLoLVNdentwf+mlk4q9D+eIC9jnMnuCljTzq1OieCO3 X-Gm-Gg: ASbGncthdnjlUFZ4JPMeg5/3VAV09rpxtzzNemvgD2l/+4NXeBsP8I0JRbvIvdjb+1L XYv7tgDiZxmDqy+iDjW+7lzSPm2ZEVdyx8oIdhxktdvq0L78ryQWFP+oJIxStudG6Yrw+hqAx3C 11MpU4r7ywZShVmLNIXKluwWkQEhmVBgcSiOZCWSVsoqzi2AoQVPJwAkbApX2f9XtCdZLpbrvuX V8ABsyHgfU5xEoxPZN3dZkxR9wGOUnpgmOGQLhoIC4P8lus0CLQ5pO8FUp6cApMhDNK2om+GNfX HI3U25zEHp1UroeNxQ1VqisOew50EK4PaD3wxbM3Q1Wf4rJY0vVdWshjyduK/zgnz5hlLt4kxY7 A1VP1IIUk0SEci8MIFKML+aZypFqgqcUryM5JfHu/GlRPC8ZRsIaefnGLoRnpNarJ9yQBbFfkai 2gpNul8MY3mWwOXWg8gQ== X-Google-Smtp-Source: AGHT+IHGs4DwXfP6nWqnbQ+7R8SWiz+qxqpgqaWLkFf+omIN7sI48ep3gWUkRscpSyoQrMau23dXqg== X-Received: by 2002:a17:903:19cb:b0:24c:7b94:2f87 with SMTP id d9443c01a7336-290c9ca6707mr410391015ad.14.1761482376103; Sun, 26 Oct 2025 05:39:36 -0700 (PDT) Received: from VM-0-14-ubuntu.. ([43.134.26.72]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-33fed7d2869sm5119634a91.7.2025.10.26.05.39.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 26 Oct 2025 05:39:35 -0700 (PDT) From: Junjie Cao To: Lee Jones , Daniel Thompson , Jingoo Han , Pavel Machek , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Helge Deller Cc: dri-devel@lists.freedesktop.org, linux-leds@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-fbdev@vger.kernel.org, Junjie Cao Subject: [PATCH 1/2] dt-bindings: leds: backlight: Add Awinic AW99706 backlight Date: Sun, 26 Oct 2025 20:39:22 +0800 Message-ID: <20251026123923.1531727-2-caojunjie650@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251026123923.1531727-1-caojunjie650@gmail.com> References: <20251026123923.1531727-1-caojunjie650@gmail.com> Precedence: bulk X-Mailing-List: linux-fbdev@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add Awinic AW99706 backlight binding documentation. Signed-off-by: Junjie Cao --- .../leds/backlight/awinic,aw99706.yaml | 135 ++++++++++++++++++ 1 file changed, 135 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/backlight/awinic,aw99706.yaml diff --git a/Documentation/devicetree/bindings/leds/backlight/awinic,aw99706.yaml b/Documentation/devicetree/bindings/leds/backlight/awinic,aw99706.yaml new file mode 100644 index 000000000..640af3891 --- /dev/null +++ b/Documentation/devicetree/bindings/leds/backlight/awinic,aw99706.yaml @@ -0,0 +1,135 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/leds/backlight/awinic,aw99706.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Awinic AW99706 6-channel WLED Backlight Driver + +maintainers: + - Junjie Cao + +allOf: + - $ref: common.yaml# + +properties: + compatible: + const: awinic,aw99706 + + reg: + maxItems: 1 + + enable-gpios: + description: GPIO to use to enable/disable the backlight (HWEN pin). + maxItems: 1 + + awinic,dim-mode: + $ref: /schemas/types.yaml#/definitions/uint32 + description: > + Select dimming mode of the device. + 0 = Bypass mode. + 1 = DC mode. + 2 = MIX mode. + 3 = MIX-26k. + enum: [0, 1, 2, 3] + default: 1 + + awinic,sw-freq: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Boost switching frequency in kHz. + enum: [300, 400, 500, 600, 660, 750, 850, 1000, 1200, 1330, 1500, 1700] + default: 750 + + awinic,sw-ilmt: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Switching current limitation in mA. + enum: [1500, 2000, 2500, 3000] + default: 3000 + + awinic,iled-max: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Maximum LED current setting in uA. + minimum: 5000 + maximum: 50000 + multipleOf: 500 + default: 20000 + + awinic,uvlo-thres: + $ref: /schemas/types.yaml#/definitions/uint32 + description: UVLO(Under Voltage Lock Out) in mV. + enum: [2200, 5000] + default: 2200 + + awinic,fade-time: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Fade In/Out Time(per step) in us. + enum: [8, 16, 32, 64, 128, 256, 512, 1024] + default: 16 + + awinic,slope-time: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Slope time in ms. + enum: [8, 24, 48, 96, 200, 300, 400, 500] + default: 300 + + awinic,ramp-ctl: + $ref: /schemas/types.yaml#/definitions/uint32 + description: > + Select ramp control and filter of the device. + 0 = Fade in/fade out. + 1 = Light filter. + 2 = Medium filter. + 3 = Heavy filter. + enum: [0, 1, 2, 3] + default: 2 + + awinic,brt-mode: + $ref: /schemas/types.yaml#/definitions/uint32 + description: > + Select brightness control of the device. + 0 = PWM. + 1 = IIC. + 2 = IIC x PWM. + 3 = IIC x PWM(P-ramp). + enum: [0, 1, 2, 3] + default: 1 + + awinic,onoff-time: + $ref: /schemas/types.yaml#/definitions/uint32 + description: Turn on/off time(per step) in ns. + enum: [250, 500, 1000, 2000, 4000, 8000, 16000] + default: 2000 + +required: + - compatible + - reg + - enable-gpios + +unevaluatedProperties: false + +examples: + - | + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + aw99706@76 { + compatible = "awinic,aw99706"; + reg = <0x76>; + enable-gpios = <&tlmm 88 GPIO_ACTIVE_HIGH>; + awinic,dim-mode = <1>; + awinic,sw-ilmt = <3000>; + awinic,sw-freq = <750>; + awinic,uvlo-thres = <2200>; + awinic,iled-max = <23500>; + awinic,ramp-ctl = <2>; + awinic,slope-time = <96>; + awinic,fade-time = <16>; + awinic,brt-mode = <1>; + awinic,onoff-time = <2000>; + }; + }; + +... -- 2.51.1.dirty