From nobody Fri Dec 19 21:49:39 2025 Received: from mail-pl1-f194.google.com (mail-pl1-f194.google.com [209.85.214.194]) (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 7DFB71FCFEF for ; Sun, 9 Nov 2025 03:22:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.194 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762658579; cv=none; b=MaZ3ku5S/1p9jy5ISTIXq3l2gP6VlxD6hpcjbaYFUSKrDuQnuAODXrJQW3VPjHeaONKZbaTPXvNI5BUB0T6NrI0zMO6R45z1ai/erwQt+UKgQ+mhQSB6lw5NsOlSgQU9NBcO6AweEFTgAOQFwN0b/+Z/2LX4jkMhvwYV6PHbYo4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762658579; c=relaxed/simple; bh=vPxJ/by/abaOom4AmLg1ViOmOazh60+nNoiMNG82d74=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=dgIcSbwErkmZ+FXShT34vq2+gP1iyawJAWlhHl1f8JlSjqV+nh+8l0Py5MPgCUDA6iMEAuT/q1Mn5xzcsSK8PgVGShLSRWl6aqaCiGkcGRM9aHCG+aBRNS8+xutnApOR5BVYI0mZuzwGSZ1GmZFS4YKmB3uVl1WfgFSvhSrcmpA= 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=hfddiPDC; arc=none smtp.client-ip=209.85.214.194 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="hfddiPDC" Received: by mail-pl1-f194.google.com with SMTP id d9443c01a7336-297eca3d0a3so8355805ad.0 for ; Sat, 08 Nov 2025 19:22:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1762658577; x=1763263377; 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=Y6/p/VFD5rODc41UaByBAjykLqoESbzOCT7V1sUMyAw=; b=hfddiPDCarXNEqvx+7tfRgkgfELETkr8OyRsosTfj4Ta10Kb5r0pH5+h24qTjspwTU 1utRdfvoqgcGfTfuBvsxs+hD/JgLxZUn3dqTHcLO0R1kReBQojGSe3+XYSG/zuo0TVrg qF8zEvu0tH7i/AZ8Oyb9jwsL7EItUqFUYhSsOpr7sCvy3vmGHuEI6Pb873yaZGIX5pCs NyXOWRFRoKhsaafSqAUYFEfF0p98y+4iCVqqepKYmwU6LkyRHdD+MWE/5FQyPTOPyi7c gpxJ36a3eAQqU/gNN30WPsuVvw1UWZx2Vhtod1E+lp5Uctm4MmmnGlY0wFWy1juttwVo dECw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762658577; x=1763263377; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=Y6/p/VFD5rODc41UaByBAjykLqoESbzOCT7V1sUMyAw=; b=rmIUmp4EtValZOvgkYbn6Gjw50akt0G5xeWL5ZO/OrBOBTM20X5aB0I5s3LOio5+66 zyWPgwDFq9OMM9WiH/HLgugmVEhHmpNGm47ertZ1GCfxMmkVbkImBzP3p2HgjZa4OQtq EnZPCti8WoobPD83pNvTchg15I+/oCalP2i8EOVNnRXW7x9HoRHcMnUH36X0abbbFaUU BZBjx1nTylYyvQD18eLlP4SMxGGc4fpFvAc+h+Nl4kxpLkMruS6qIZ3Czh1BEVl3rTrO e8RxTI1Y0xMVnrHz9pCtRSCQT624pK0tgmc3eqEIml+Pj3QiM677xvTh4bZPZIq3E8c+ ltQQ== X-Forwarded-Encrypted: i=1; AJvYcCWahVycNGTxs6D6pOq/KPFz3xT9L7gGXKpxCYEKeky7u8yFuyAgQO/HZcmQxz5BDlfK9/wj8PfaA8n2R7c=@vger.kernel.org X-Gm-Message-State: AOJu0Yz5B0TNvI7mtqrLsk9elgZjsdqeGLbhCMUYMH4ZHJQC9WNvNIRj m/BYF51an8guq6xfDmEKtUYdbJaPD7cKL/K6X+tZ7jci8I66d2xJsEr9 X-Gm-Gg: ASbGnctnaFNSV2zimF+1eu6BZjdjIX5ij198K1hD5up/04zylKtIztDI8rGUeAXonXw k9j761BdN/fzttJ6At/cAQEOZFZkpplAcR50ik8dyfvgyzqy5gL7QTKr+1PMJUzxko0Y7J+Jirv EP7JauU1jts4lLJdG9b9Vxk1W4mdV3yO3OXslkPU0dI/vERXT++pIeipXskoZ5RwDcUbVQpoIbw QAS/1h4qYMotpljTcd62ux/FSQCHfLa5+asjcd9IJUN/9im9330MYbKOwcM1G5Sq8hjG4nTsHAy 3wAxOIIkfZDQvh0sqh2aWXAAyUBo5jDNihti8fk+K42Vk2G5B3goMXm7dyfeo38nKiCf2+IOH3U Lde3mQT/YeYYYeplBLXvmBPl22Pif1m2hOCTuB91qmVimxXA6eKka+H9apjTYZ8xsPf0jH3Ljsk IwCow68kE= X-Google-Smtp-Source: AGHT+IGjUSrbW6m1DH+9XkPyVh7AhctSYExE5kfh2YwM8eVJ3y2QK60XKY2TAgRvk2wScpvMqkmDcw== X-Received: by 2002:a17:903:3ba4:b0:295:70bd:b04b with SMTP id d9443c01a7336-297e5708ef8mr48929025ad.55.1762658576771; Sat, 08 Nov 2025 19:22:56 -0800 (PST) Received: from VM-0-14-ubuntu.. ([43.134.26.72]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-296509682casm101941215ad.22.2025.11.08.19.22.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 08 Nov 2025 19:22:56 -0800 (PST) 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 v3 1/2] dt-bindings: leds: backlight: Add Awinic AW99706 backlight Date: Sun, 9 Nov 2025 11:22:39 +0800 Message-ID: <20251109032240.3422503-2-caojunjie650@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251109032240.3422503-1-caojunjie650@gmail.com> References: <20251109032240.3422503-1-caojunjie650@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" Add Awinic AW99706 backlight binding documentation. Signed-off-by: Junjie Cao Reviewed-by: Daniel Thompson (RISCstar) Reviewed-by: Krzysztof Kozlowski --- Changes in v3: - breaking a long line (Krzysztof) - rename backlight node (Krzysztof) - Link to v2: https://lore.kernel.org/linux-leds/20251103110648.878325-2-ca= ojunjie650@gmail.com Changes in v2: - use proper units for properties (Krzysztof) - drop non-fixed properties (Krzysztof) - add properties(max-brightness, default-brightness) (Krzysztof) - Link to v1: https://lore.kernel.org/linux-leds/20251026123923.1531727-2-c= aojunjie650@gmail.com .../leds/backlight/awinic,aw99706.yaml | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 Documentation/devicetree/bindings/leds/backlight/awinic= ,aw99706.yaml diff --git a/Documentation/devicetree/bindings/leds/backlight/awinic,aw9970= 6.yaml b/Documentation/devicetree/bindings/leds/backlight/awinic,aw99706.ya= ml new file mode 100644 index 000000000..f48ce7a34 --- /dev/null +++ b/Documentation/devicetree/bindings/leds/backlight/awinic,aw99706.yaml @@ -0,0 +1,101 @@ +# 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 =3D Bypass mode. + 1 =3D DC mode. + 2 =3D MIX mode(PWM at low brightness and DC at high brightness). + 3 =3D MIX-26k mode(MIX mode with different PWM frequency). + enum: [ 0, 1, 2, 3 ] + default: 1 + + awinic,sw-freq-hz: + description: Boost switching frequency in Hz. + enum: [ 300000, 400000, 500000, 600000, 660000, 750000, 850000, 100000= 0, + 1200000, 1330000, 1500000, 1700000 ] + default: 750000 + + awinic,sw-ilmt-microamp: + description: Switching current limitation in uA. + enum: [ 1500000, 2000000, 2500000, 3000000 ] + default: 3000000 + + awinic,iled-max-microamp: + description: Maximum LED current setting in uA. + minimum: 5000 + maximum: 50000 + multipleOf: 500 + default: 20000 + + awinic,uvlo-thres-microvolt: + description: UVLO(Under Voltage Lock Out) in uV. + enum: [ 2200000, 5000000 ] + default: 2200000 + + awinic,ramp-ctl: + $ref: /schemas/types.yaml#/definitions/uint32 + description: > + Select ramp control and filter of the device. + 0 =3D Fade in/fade out. + 1 =3D Light filter. + 2 =3D Medium filter. + 3 =3D Heavy filter. + enum: [ 0, 1, 2, 3 ] + default: 2 + +required: + - compatible + - reg + - enable-gpios + +unevaluatedProperties: false + +examples: + - | + #include + + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + + backlight@76 { + compatible =3D "awinic,aw99706"; + reg =3D <0x76>; + enable-gpios =3D <&tlmm 88 GPIO_ACTIVE_HIGH>; + default-brightness =3D <2047>; + max-brightness =3D <4095>; + awinic,dim-mode =3D <1>; + awinic,sw-freq-hz =3D <750000>; + awinic,sw-ilmt-microamp =3D <3000000>; + awinic,uvlo-thres-microvolt =3D <2200000>; + awinic,iled-max-microamp =3D <20000>; + awinic,ramp-ctl =3D <2>; + }; + }; + +... --=20 2.51.1.dirty From nobody Fri Dec 19 21:49:39 2025 Received: from mail-pg1-f193.google.com (mail-pg1-f193.google.com [209.85.215.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 16C05202C48 for ; Sun, 9 Nov 2025 03:23:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.193 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762658593; cv=none; b=AsZEHyubc48WsS778YeleWoDln3XLMG7F2SldwdJTqeyP/gtG6LJyro8M7ww8rD/PSHM51mLEPqcdq8wbpztjS1Xf7J2iWjKc+dcVBgSk+MOLTeTU/Nh2kjrCJhbmoDQIzkt6QyPUU97m96L24FGU/jHeAXgOpPcTeWFZdFz7M4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1762658593; c=relaxed/simple; bh=YVLqfum1BAAKlGsSRZIjDSmyHOyPK1PdyQSPWYYd/fQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=owkEfmTvu/bGOj0UrDj1ndrEC4/5aox3JKtjdXiHqg18S39qWwOkicCs4wJX9Jmtr1li6ng9sAe7bbR6THOrFwdmE8giGyickygcHyCCBJKngepFzZEbbcCqmhknWe25H3A7Xih22+1dT+ly5tmhxKkp0WciSKE+AQ8PpOC46K0= 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=ZNFlf1L/; arc=none smtp.client-ip=209.85.215.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="ZNFlf1L/" Received: by mail-pg1-f193.google.com with SMTP id 41be03b00d2f7-b593def09e3so1216184a12.2 for ; Sat, 08 Nov 2025 19:23:10 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1762658590; x=1763263390; 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=L8Lxev0djixy9MiMQMuaiErplBM2LofZg7oyG1h4PDM=; b=ZNFlf1L/RJQR+u+xDYzkkwC0sdfxComAb7J4XXnBtv1U7smL9sNrsBjrNVc4jBCK69 ISTVvVvdhbvFpUvkjNChAs99YN9JXdhNphIUSxj1ReUI5JlJNoHBepV5+dJgjiS4/uUP OI58vOUpcrcvL+SwnQsty/+1NOCZ+sVvzqbuU9svRRZtbHRxTO6Pwy1s+2hTXAzVeav3 kSRyz3ixaKrYcM9mcdALQzOTW96cV8gjc/8L7dWbBtuuawHlRiVU9iA4L1uYB8x9oAV2 GotzEzxsPx8aU1dzjju/ZjvlbB+NxH+FwLxwPm9ZUtRbYsbxCWIc7as5MXlS0+4I91u2 H6UA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1762658590; x=1763263390; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=L8Lxev0djixy9MiMQMuaiErplBM2LofZg7oyG1h4PDM=; b=OVStzn8/hRsIM8OW0o6TVfS9m/qWa2JeNHW4etsqAKffPmEg3z6g+l6wmodD0jV3Wh SuoEK5wlrVAWO21gwUzRg580mVa1zYsYMTSarsU1loWJgzbMnTTE5z0rKMwB2U4l4ibz m51lAuesVZkEVPRVbW4O+T2CzDX1fXC7kyjOJh6Erj2wuAO5vYW7L3kvrQAtwfmWUdaL f1gpbsUCPRJlm4LHnQeRpTAtFRvPIOEXuwg5aX0TVjerQI7UPSzVGtIvQzcMWhQvNbm+ xz1isGs99sZi31QWOcAE/1fN0tH4QeqPBoch1Z8avNEW/Qghbex+JmjU0yOl4nysT/2F xVMA== X-Forwarded-Encrypted: i=1; AJvYcCUAdm/NoGxTNv4bsJ0l+HKv1KvaU/H1VRLfSEBKwdisK6c/euQ/eAvZJAjA0DfIF5fRpNzd7ReSlViZ9F4=@vger.kernel.org X-Gm-Message-State: AOJu0Yz3w3d7/JPnEJe0t7SQCJ9CkQYbAJsuGbY+20vHkBVxAyzR7F6Z O3bMiALZTzWYtHzi1Uh0mZy4doNqDpT6FtAHFhJFqTLKPeAMjZyza6cY X-Gm-Gg: ASbGncurB8xroVXnhm5eHY95fB5k+Z5i3AbGgZdfTVwFlSRM1/ZWkY0+ivjpFtYRIe1 ODMUsmr9u/UzgnVkzwrcsUlstD8irBy7N0ffwPfHKxfecpKhXiB2FrfH+Ciz47dDap/KHuBn/C8 iVmATHxHY55UbxhBX1bhGXKSN+W/w4nwNe9HAQZQXzCSvDU2BYzByMIi+eW1BkpmwpSg78zGEIz sRQrEcVEpVLtDtDV+5rlMNvm8ZyljIJw7oOZO6Vn/85a37qMOUKRmhHacGuRvQxgrM8IBVKDIut J2HwgadZfXZ3IeBrlDIFOf49aTZTyIBhvonk3Hl8NTRqfRw6ysjODE8UquG8chSMXjtIugycD0m Oao3UbZSL991jKsHuuaB3NlR1usIoChO2ThtHLykoMSz7miH3pL5ghJqjywhJW1QDHoGeB27UWv IsyDWoVBZzTViIFrxIEA== X-Google-Smtp-Source: AGHT+IHWyxEth7lvLIjHWsWLpxJukt5TrFTFGxSDRl3q2aJOImJwMSGsB7mtDtH/MmgVzF1+nMDHJg== X-Received: by 2002:a17:902:e5cb:b0:296:3f23:b93b with SMTP id d9443c01a7336-297e5403a5bmr62045855ad.2.1762658590115; Sat, 08 Nov 2025 19:23:10 -0800 (PST) Received: from VM-0-14-ubuntu.. ([43.134.26.72]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-296509682casm101941215ad.22.2025.11.08.19.23.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 08 Nov 2025 19:23:09 -0800 (PST) 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 , Pengyu Luo Subject: [PATCH v3 2/2] backlight: aw99706: Add support for Awinic AW99706 backlight Date: Sun, 9 Nov 2025 11:22:40 +0800 Message-ID: <20251109032240.3422503-3-caojunjie650@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251109032240.3422503-1-caojunjie650@gmail.com> References: <20251109032240.3422503-1-caojunjie650@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" Add support for Awinic AW99706 backlight, which can be found in tablet and notebook backlight, one case is the Lenovo Legion Y700 Gen4. This driver refers to the official datasheets and android driver, they can be found in [1]. [1] https://www.awinic.com/en/productDetail/AW99706QNR Signed-off-by: Junjie Cao Tested-by: Pengyu Luo Signed-off-by: Pengyu Luo Reviewed-by: Daniel Thompson (RISCstar) --- Changes in v3: - remove the shift field (Daniel) - use FIELD_PREP() to replace FIELD_MODIFY() (Daniel) - include init table into aw99706_device (Daniel) - make aw99706_regs static (Krzysztof) - return -ENODEV if it is a unknown chip id (Krzysztof) - use __ffs() to handle shift, since mask is not compiletime in for loop - reorder functions and structs - Link to v2: https://lore.kernel.org/linux-leds/20251103110648.878325-3-ca= ojunjie650@gmail.com Changes in v2: - add handler for max-brightness and default-brightness - use proper units for properties (Krzysztof) - drop non-fixed properties (Krzysztof) - include default values in the aw99706_dt_props table (Daniel) - warn when a property value from DT is invalid (Daniel) - drop warning when optional properties are missing (Daniel) - add a function pointer into the aw99706_dt_props table to handle lookup (= Daniel) - use a lookup function instead of hardcoding the formula for the iLED max = (Daniel) - move BL enalbe handler into aw99706_update_brightness (Daniel) - Link to v1: https://lore.kernel.org/linux-leds/20251026123923.1531727-3-c= aojunjie650@gmail.com MAINTAINERS | 6 + drivers/video/backlight/Kconfig | 8 + drivers/video/backlight/Makefile | 1 + drivers/video/backlight/aw99706.c | 471 ++++++++++++++++++++++++++++++ 4 files changed, 486 insertions(+) create mode 100644 drivers/video/backlight/aw99706.c diff --git a/MAINTAINERS b/MAINTAINERS index be21f1fa8..551d8328e 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -4140,6 +4140,12 @@ S: Maintained F: Documentation/devicetree/bindings/iio/adc/avia-hx711.yaml F: drivers/iio/adc/hx711.c =20 +AWINIC AW99706 WLED BACKLIGHT DRIVER +M: Junjie Cao +S: Maintained +F: Documentation/devicetree/bindings/leds/backlight/awinic,aw99706.yaml +F: drivers/video/backlight/aw99706.c + AX.25 NETWORK LAYER L: linux-hams@vger.kernel.org S: Orphan diff --git a/drivers/video/backlight/Kconfig b/drivers/video/backlight/Kcon= fig index d9374d208..35c7bfad0 100644 --- a/drivers/video/backlight/Kconfig +++ b/drivers/video/backlight/Kconfig @@ -156,6 +156,14 @@ config BACKLIGHT_ATMEL_LCDC If in doubt, it's safe to enable this option; it doesn't kick in unless the board's description says it's wired that way. =20 +config BACKLIGHT_AW99706 + tristate "Backlight Driver for Awinic AW99706" + depends on I2C + select REGMAP_I2C + help + If you have a LCD backlight connected to the WLED output of AW99706 + WLED output, say Y here to enable this driver. + config BACKLIGHT_EP93XX tristate "Cirrus EP93xx Backlight Driver" depends on FB_EP93XX diff --git a/drivers/video/backlight/Makefile b/drivers/video/backlight/Mak= efile index dfbb169bf..a5d62b018 100644 --- a/drivers/video/backlight/Makefile +++ b/drivers/video/backlight/Makefile @@ -25,6 +25,7 @@ obj-$(CONFIG_BACKLIGHT_ADP8870) +=3D adp8870_bl.o obj-$(CONFIG_BACKLIGHT_APPLE) +=3D apple_bl.o obj-$(CONFIG_BACKLIGHT_APPLE_DWI) +=3D apple_dwi_bl.o obj-$(CONFIG_BACKLIGHT_AS3711) +=3D as3711_bl.o +obj-$(CONFIG_BACKLIGHT_AW99706) +=3D aw99706.o obj-$(CONFIG_BACKLIGHT_BD6107) +=3D bd6107.o obj-$(CONFIG_BACKLIGHT_CLASS_DEVICE) +=3D backlight.o obj-$(CONFIG_BACKLIGHT_DA903X) +=3D da903x_bl.o diff --git a/drivers/video/backlight/aw99706.c b/drivers/video/backlight/aw= 99706.c new file mode 100644 index 000000000..b7c1d24b1 --- /dev/null +++ b/drivers/video/backlight/aw99706.c @@ -0,0 +1,471 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * aw99706 - Backlight driver for the AWINIC AW99706 + * + * Copyright (C) 2025 Junjie Cao + * Copyright (C) 2025 Pengyu Luo + * + * Based on vendor driver: + * Copyright (c) 2023 AWINIC Technology CO., LTD + */ + +#include +#include +#include +#include +#include +#include +#include +#include + +#define AW99706_MAX_BRT_LVL 4095 +#define AW99706_REG_MAX 0x1F +#define AW99706_ID 0x07 + +/* registers list */ +#define AW99706_CFG0_REG 0x00 +#define AW99706_DIM_MODE_MASK GENMASK(1, 0) + +#define AW99706_CFG1_REG 0x01 +#define AW99706_SW_FREQ_MASK GENMASK(3, 0) +#define AW99706_SW_ILMT_MASK GENMASK(5, 4) + +#define AW99706_CFG2_REG 0x02 +#define AW99706_ILED_MAX_MASK GENMASK(6, 0) +#define AW99706_UVLOSEL_MASK BIT(7) + +#define AW99706_CFG3_REG 0x03 +#define AW99706_CFG4_REG 0x04 +#define AW99706_BRT_MSB_MASK GENMASK(3, 0) + +#define AW99706_CFG5_REG 0x05 +#define AW99706_BRT_LSB_MASK GENMASK(7, 0) + +#define AW99706_CFG6_REG 0x06 +#define AW99706_RAMP_CTL_MASK GENMASK(7, 6) + +#define AW99706_CFG7_REG 0x07 +#define AW99706_CFG8_REG 0x08 +#define AW99706_CFG9_REG 0x09 +#define AW99706_CFGA_REG 0x0A +#define AW99706_CFGB_REG 0x0B +#define AW99706_CFGC_REG 0x0C +#define AW99706_CFGD_REG 0x0D +#define AW99706_FLAG_REG 0x10 +#define AW99706_BACKLIGHT_EN_MASK BIT(7) + +#define AW99706_CHIPID_REG 0x11 +#define AW99706_LED_OPEN_FLAG_REG 0x12 +#define AW99706_LED_SHORT_FLAG_REG 0x13 +#define AW99706_MTPLDOSEL_REG 0x1E +#define AW99706_MTPRUN_REG 0x1F + +#define RESV 0 + +/* Boost switching frequency table, in Hz */ +static const u32 aw99706_sw_freq_tbl[] =3D { + RESV, RESV, RESV, RESV, 300000, 400000, 500000, 600000, + 660000, 750000, 850000, 1000000, 1200000, 1330000, 1500000, 1700000 +}; + +/* Switching current limitation table, in uA */ +static const u32 aw99706_sw_ilmt_tbl[] =3D { + 1500000, 2000000, 2500000, 3000000 +}; + +/* ULVO threshold table, in uV */ +static const u32 aw99706_ulvo_thres_tbl[] =3D { + 2200000, 5000000 +}; + +struct aw99706_dt_prop { + const char * const name; + int (*lookup)(const struct aw99706_dt_prop *prop, u32 dt_val, u8 *val); + const u32 * const lookup_tbl; + u8 tbl_size; + u8 reg; + u8 mask; + u32 def_val; +}; + +static int aw99706_dt_property_lookup(const struct aw99706_dt_prop *prop, + u32 dt_val, u8 *val) +{ + int i; + + if (!prop->lookup_tbl) { + *val =3D dt_val; + return 0; + } + + for (i =3D 0; i < prop->tbl_size; i++) + if (prop->lookup_tbl[i] =3D=3D dt_val) + break; + + *val =3D i; + + return i =3D=3D prop->tbl_size ? -1 : 0; +} + +#define MIN_ILED_MAX 5000 +#define MAX_ILED_MAX 50000 +#define STEP_ILED_MAX 500 + +static int +aw99706_dt_property_iled_max_convert(const struct aw99706_dt_prop *prop, + u32 dt_val, u8 *val) +{ + if (dt_val > MAX_ILED_MAX || dt_val < MIN_ILED_MAX) + return -1; + + *val =3D (dt_val - MIN_ILED_MAX) / STEP_ILED_MAX; + + return (dt_val - MIN_ILED_MAX) % STEP_ILED_MAX; +} + +static const struct aw99706_dt_prop aw99706_dt_props[] =3D { + { + "awinic,dim-mode", aw99706_dt_property_lookup, + NULL, 0, + AW99706_CFG0_REG, AW99706_DIM_MODE_MASK, 1, + }, + { + "awinic,sw-freq", aw99706_dt_property_lookup, + aw99706_sw_freq_tbl, ARRAY_SIZE(aw99706_sw_freq_tbl), + AW99706_CFG1_REG, AW99706_SW_FREQ_MASK, 750000, + }, + { + "awinic,sw-ilmt", aw99706_dt_property_lookup, + aw99706_sw_ilmt_tbl, ARRAY_SIZE(aw99706_sw_ilmt_tbl), + AW99706_CFG1_REG, AW99706_SW_ILMT_MASK, 3000000, + }, + { + "awinic,iled-max", aw99706_dt_property_iled_max_convert, + NULL, 0, + AW99706_CFG2_REG, AW99706_ILED_MAX_MASK, 20000, + + }, + { + "awinic,uvlo-thres", aw99706_dt_property_lookup, + aw99706_ulvo_thres_tbl, ARRAY_SIZE(aw99706_ulvo_thres_tbl), + AW99706_CFG2_REG, AW99706_UVLOSEL_MASK, 2200000, + }, + { + "awinic,ramp-ctl", aw99706_dt_property_lookup, + NULL, 0, + AW99706_CFG6_REG, AW99706_RAMP_CTL_MASK, 2, + } +}; + +struct reg_init_data { + u8 reg; + u8 mask; + u8 val; +}; + +struct aw99706_device { + struct i2c_client *client; + struct device *dev; + struct regmap *regmap; + struct backlight_device *bl_dev; + struct gpio_desc *hwen_gpio; + struct reg_init_data init_tbl[ARRAY_SIZE(aw99706_dt_props)]; + bool bl_enable; +}; + +enum reg_access { + REG_NONE_ACCESS =3D 0, + REG_RD_ACCESS =3D 1, + REG_WR_ACCESS =3D 2, +}; + +static const u8 aw99706_regs[AW99706_REG_MAX + 1] =3D { + [AW99706_CFG0_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG1_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG2_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG3_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG4_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG5_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG6_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG7_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG8_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFG9_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFGA_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFGB_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFGC_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_CFGD_REG] =3D REG_RD_ACCESS | REG_WR_ACCESS, + [AW99706_FLAG_REG] =3D REG_RD_ACCESS, + [AW99706_CHIPID_REG] =3D REG_RD_ACCESS, + [AW99706_LED_OPEN_FLAG_REG] =3D REG_RD_ACCESS, + [AW99706_LED_SHORT_FLAG_REG] =3D REG_RD_ACCESS, + + /* + * Write bit is dropped here, writing BIT(0) to MTPLDOSEL will unlock + * Multi-time Programmable (MTP). + */ + [AW99706_MTPLDOSEL_REG] =3D REG_RD_ACCESS, + [AW99706_MTPRUN_REG] =3D REG_NONE_ACCESS, +}; + +static bool aw99706_readable_reg(struct device *dev, unsigned int reg) +{ + return aw99706_regs[reg] & REG_RD_ACCESS; +} + +static bool aw99706_writeable_reg(struct device *dev, unsigned int reg) +{ + return aw99706_regs[reg] & REG_WR_ACCESS; +} + +static inline int aw99706_i2c_read(struct aw99706_device *aw, u8 reg, + unsigned int *val) +{ + return regmap_read(aw->regmap, reg, val); +} + +static inline int aw99706_i2c_write(struct aw99706_device *aw, u8 reg, u8 = val) +{ + return regmap_write(aw->regmap, reg, val); +} + +static inline int aw99706_i2c_update_bits(struct aw99706_device *aw, u8 re= g, + u8 mask, u8 val) +{ + return regmap_update_bits(aw->regmap, reg, mask, val); +} + +static void aw99706_dt_parse(struct aw99706_device *aw, + struct backlight_properties *bl_props) +{ + const struct aw99706_dt_prop *prop; + u32 dt_val; + int ret, i; + u8 val; + + for (i =3D 0; i < ARRAY_SIZE(aw99706_dt_props); i++) { + prop =3D &aw99706_dt_props[i]; + ret =3D device_property_read_u32(aw->dev, prop->name, &dt_val); + if (ret < 0) + dt_val =3D prop->def_val; + + if (prop->lookup(prop, dt_val, &val)) { + dev_warn(aw->dev, "invalid value %d for property %s, using default valu= e %d\n", + dt_val, prop->name, prop->def_val); + + prop->lookup(prop, prop->def_val, &val); + } + + aw->init_tbl[i].reg =3D prop->reg; + aw->init_tbl[i].mask =3D prop->mask; + aw->init_tbl[i].val =3D val << __ffs(prop->mask); + } + + bl_props->brightness =3D AW99706_MAX_BRT_LVL >> 1; + bl_props->max_brightness =3D AW99706_MAX_BRT_LVL; + device_property_read_u32(aw->dev, "default-brightness", + &bl_props->brightness); + device_property_read_u32(aw->dev, "max-brightness", + &bl_props->max_brightness); + + if (bl_props->max_brightness > AW99706_MAX_BRT_LVL) + bl_props->max_brightness =3D AW99706_MAX_BRT_LVL; + + if (bl_props->brightness > bl_props->max_brightness) + bl_props->brightness =3D bl_props->max_brightness; +} + +static int aw99706_hw_init(struct aw99706_device *aw) +{ + int ret, i; + + gpiod_set_value_cansleep(aw->hwen_gpio, 1); + + for (i =3D 0; i < ARRAY_SIZE(aw->init_tbl); i++) { + ret =3D aw99706_i2c_update_bits(aw, aw->init_tbl[i].reg, + aw->init_tbl[i].mask, + aw->init_tbl[i].val); + if (ret < 0) { + dev_err(aw->dev, "Failed to write init data %d\n", ret); + return ret; + } + } + + return 0; +} + +static int aw99706_bl_enable(struct aw99706_device *aw, bool en) +{ + int ret; + u8 val; + + val =3D FIELD_PREP(AW99706_BACKLIGHT_EN_MASK, en); + ret =3D aw99706_i2c_update_bits(aw, AW99706_CFGD_REG, + AW99706_BACKLIGHT_EN_MASK, val); + if (ret) + dev_err(aw->dev, "Failed to enable backlight!\n"); + + return ret; +} + +static int aw99706_update_brightness(struct aw99706_device *aw, u32 brt_lv= l) +{ + bool bl_enable_now =3D !!brt_lvl; + int ret; + + ret =3D aw99706_i2c_write(aw, AW99706_CFG4_REG, + (brt_lvl >> 8) & AW99706_BRT_MSB_MASK); + if (ret < 0) + return ret; + + ret =3D aw99706_i2c_write(aw, AW99706_CFG5_REG, + brt_lvl & AW99706_BRT_LSB_MASK); + if (ret < 0) + return ret; + + if (aw->bl_enable !=3D bl_enable_now) { + ret =3D aw99706_bl_enable(aw, bl_enable_now); + if (!ret) + aw->bl_enable =3D bl_enable_now; + } + + return ret; +} + +static int aw99706_bl_update_status(struct backlight_device *bl) +{ + struct aw99706_device *aw =3D bl_get_data(bl); + + return aw99706_update_brightness(aw, bl->props.brightness); +} + +static const struct backlight_ops aw99706_bl_ops =3D { + .options =3D BL_CORE_SUSPENDRESUME, + .update_status =3D aw99706_bl_update_status, +}; + +static const struct regmap_config aw99706_regmap_config =3D { + .reg_bits =3D 8, + .val_bits =3D 8, + .max_register =3D AW99706_REG_MAX, + .writeable_reg =3D aw99706_writeable_reg, + .readable_reg =3D aw99706_readable_reg, +}; + +static int aw99706_chip_id_read(struct aw99706_device *aw) +{ + int ret; + unsigned int val; + + ret =3D aw99706_i2c_read(aw, AW99706_CHIPID_REG, &val); + if (ret < 0) + return ret; + + return val; +} + +static int aw99706_probe(struct i2c_client *client) +{ + struct device *dev =3D &client->dev; + struct aw99706_device *aw; + struct backlight_device *bl_dev; + struct backlight_properties props =3D {}; + int ret =3D 0; + + aw =3D devm_kzalloc(dev, sizeof(*aw), GFP_KERNEL); + if (!aw) + return -ENOMEM; + + aw->client =3D client; + aw->dev =3D dev; + i2c_set_clientdata(client, aw); + + aw->regmap =3D devm_regmap_init_i2c(client, &aw99706_regmap_config); + if (IS_ERR(aw->regmap)) + return dev_err_probe(dev, PTR_ERR(aw->regmap), + "Failed to init regmap\n"); + + ret =3D aw99706_chip_id_read(aw); + if (ret !=3D AW99706_ID) + return dev_err_probe(dev, -ENODEV, + "Unknown chip id 0x%02x\n", ret); + + aw99706_dt_parse(aw, &props); + + aw->hwen_gpio =3D devm_gpiod_get(aw->dev, "enable", GPIOD_OUT_LOW); + if (IS_ERR(aw->hwen_gpio)) + return dev_err_probe(dev, PTR_ERR(aw->hwen_gpio), + "Failed to get enable gpio\n"); + + ret =3D aw99706_hw_init(aw); + if (ret < 0) + return dev_err_probe(dev, ret, + "Failed to initialize the chip\n"); + + props.type =3D BACKLIGHT_RAW; + props.scale =3D BACKLIGHT_SCALE_LINEAR; + + bl_dev =3D devm_backlight_device_register(dev, "aw99706-backlight", dev, + aw, &aw99706_bl_ops, &props); + if (IS_ERR(bl_dev)) + return dev_err_probe(dev, PTR_ERR(bl_dev), + "Failed to register backlight!\n"); + + aw->bl_dev =3D bl_dev; + + return 0; +} + +static void aw99706_remove(struct i2c_client *client) +{ + struct aw99706_device *aw =3D i2c_get_clientdata(client); + + aw99706_update_brightness(aw, 0); + + msleep(50); + + gpiod_set_value_cansleep(aw->hwen_gpio, 0); +} + +static int aw99706_suspend(struct device *dev) +{ + struct aw99706_device *aw =3D dev_get_drvdata(dev); + + return aw99706_update_brightness(aw, 0); +} + +static int aw99706_resume(struct device *dev) +{ + struct aw99706_device *aw =3D dev_get_drvdata(dev); + + return aw99706_hw_init(aw); +} + +static SIMPLE_DEV_PM_OPS(aw99706_pm_ops, aw99706_suspend, aw99706_resume); + +static const struct i2c_device_id aw99706_ids[] =3D { + { "aw99706" }, + { } +}; +MODULE_DEVICE_TABLE(i2c, aw99706_ids); + +static const struct of_device_id aw99706_match_table[] =3D { + { .compatible =3D "awinic,aw99706", }, + { } +}; +MODULE_DEVICE_TABLE(of, aw99706_match_table); + +static struct i2c_driver aw99706_i2c_driver =3D { + .probe =3D aw99706_probe, + .remove =3D aw99706_remove, + .id_table =3D aw99706_ids, + .driver =3D { + .name =3D "aw99706", + .of_match_table =3D aw99706_match_table, + .pm =3D &aw99706_pm_ops, + }, +}; + +module_i2c_driver(aw99706_i2c_driver); + +MODULE_LICENSE("GPL v2"); +MODULE_DESCRIPTION("BackLight driver for aw99706"); --=20 2.51.1.dirty