From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from outbound8.mail.transip.nl (outbound8.mail.transip.nl [136.144.136.8]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C3E922F069D; Thu, 4 Jun 2026 10:06:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=136.144.136.8 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1780567593; cv=none; b=VxKhkBOzzkAveQAZqkUPvHCWhAQNAdsj4N+1KMcEA9D1tVxfASZnUYhyVgnca6AIl+5xpzC9U0m9a6AUcQmNVTjJKFsFod+qdq6YEDNC3JF3MUUUJQOWYqdi44jSLMTJKHJfcCUcFcoduKqPQgH+6OX518hiF0Wdt5EwwRRcqd8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1780567593; c=relaxed/simple; bh=8/R1xH/1u5C7+If5wBxKvUwojFV7On6+CJuVfgKhiPY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=F1IYQG+PgVqIGDcMvGvFMbGauNVibAgUexLvmm1HCO8IBzNkkL1A5WDnhC/e9HlrrNdSTqFY1Dd1A5L3r1cqgZ/4Rlws2nzoyNlYAOobGrvyrHjQa3VYfwuOsJZzoH1XcNpsr18+KHL8GopeoHsS3Ua5lJnjZoQiqc/1LD9sF4Q= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=herrie.org; spf=pass smtp.mailfrom=herrie.org; dkim=pass (2048-bit key) header.d=herrie.org header.i=@herrie.org header.b=fSFyhpA+; arc=none smtp.client-ip=136.144.136.8 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=herrie.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=herrie.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=herrie.org header.i=@herrie.org header.b="fSFyhpA+" Received: from submission11.mail.transip.nl (unknown [10.103.8.162]) by outbound8.mail.transip.nl (Postfix) with ESMTP id 4gWKwD1cNRzY76hL; Thu, 4 Jun 2026 12:06:20 +0200 (CEST) Received: from herrie-desktop.. (180-93-184-31.ftth.glasoperator.nl [31.184.93.180]) by submission11.mail.transip.nl (Postfix) with ESMTPA id 4gWKwC4FQNz3R3nyt; Thu, 4 Jun 2026 12:06:19 +0200 (CEST) From: Herman van Hazendonk To: jic23@kernel.org Cc: dlechner@baylibre.com, nuno.sa@analog.com, andy@kernel.org, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, tomasborquez13@gmail.com, masneyb@onstation.org, linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Herman van Hazendonk Subject: [PATCH v3 2/3] dt-bindings: iio: light: isl29018: add isil,cover-comp-gain Date: Thu, 4 Jun 2026 12:06:16 +0200 Message-ID: <20260604100617.3486541-3-github.com@herrie.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20260604100617.3486541-1-github.com@herrie.org> References: <20260604100617.3486541-1-github.com@herrie.org> Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Scanned-By: ClueGetter at submission11.mail.transip.nl DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; s=transip-a; d=herrie.org; t=1780567579; h=from:subject:to:cc: references:in-reply-to:date:mime-version; bh=RCX5QQtXEBvtBWLLFqzdraDn9aAETLjRcUQQZV1kx+A=; b=fSFyhpA+wsc90ssyKSTAx1O8nlX3ddHD4AArSzsVIsglw72x2FrqtvIjIjXtevDa/GqyU/ Xvy11LJD7JotCyWsZ/l+NYSbnqs1hxlhnkcDPLWDHBd0dSZJHbEuh4CFJ7pAGItUom2MJg Xtr54/V3aDjW4pGR2EP0dfHhv9u9kph4Y4utDut57mqnXqmWG0pinLcEC4Op/CQQ9OSVcu Db7mabGK4YNDo8u1+3bx5XlQlvk1y64FM/CBc6xcyR5eSPnh+fx9DpQp+4GSdTjkQtiU/H xuaK9A23pP8lG2P90RSBxq0xRQJeyTO/hGnyWFz18FUWi+fK3KG8Jw023EBpNg== X-Report-Abuse-To: abuse@transip.nl Document the new optional property that seeds the ISL29018 calibration scale factor at boot from firmware, allowing boards with tinted cover glass to ship with correct luminance readings without a userspace helper. The value is a positive integer (minimum 1, maximum 65535) that is multiplied with the raw lux reading. Userspace can still override it at runtime through in_illuminance0_calibscale. Signed-off-by: Herman van Hazendonk --- .../devicetree/bindings/iio/light/isl29018.yaml | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/devicetree/bindings/iio/light/isl29018.yaml b/Documentation/devicetree/bindings/iio/light/isl29018.yaml index 0ea278b07d1c..92ea2742bbd3 100644 --- a/Documentation/devicetree/bindings/iio/light/isl29018.yaml +++ b/Documentation/devicetree/bindings/iio/light/isl29018.yaml @@ -34,6 +34,19 @@ properties: vcc-supply: description: Regulator that provides power to the sensor + isil,cover-comp-gain: + description: | + Multiplier applied to the ambient-light reading at startup to + compensate for optical loss in the board's cover glass. Boards + that mount the sensor under a tinted or coated window typically + need a value between a few and a few hundred. The value seeds + in_illuminance0_calibscale, so it can still be retuned at + runtime through sysfs. + $ref: /schemas/types.yaml#/definitions/uint32 + minimum: 1 + maximum: 65535 + default: 1 + required: - compatible - reg -- 2.43.0