From nobody Tue Dec 16 09:08:56 2025 Received: from mail-pj1-f51.google.com (mail-pj1-f51.google.com [209.85.216.51]) (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 6481932AAD3 for ; Mon, 15 Dec 2025 08:00:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765785608; cv=none; b=oy67rVIGqMecGmyt9oyyufk/pQJuPPkQask790gXZc3VUD7y4IjNQGORW9DgFWU6KAqZePIvLF25+XU1gicEsZWkCyyPCz8jfreOYFCKUMHj3TpjgFfZqXMv6iURHdBnwii2mCe65o7mb4333tZv6e2tWGGi7pzntCA6BqV1/mo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765785608; c=relaxed/simple; bh=MT6YvlTp/tym7jlAKKvWLPIyFq2L811XHmb/5S7F63A=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=fQJymkfTsH7Uk5ububEbWJ/4iwh85VJcxVGeav/bURkQeHuMWRe0fh4BuQUTf/HlrxSXbzCSwhDhI/CBmj0Gk4Hz8MhvuECVFSfaCTc0yNqxxiPOWOixSl1iDapRKBf6QXvK6hX8EaKlY9UUXxeNviZnCLDjsPJzKeYzBqk0IbE= 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=ZM2Fk8VT; arc=none smtp.client-ip=209.85.216.51 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="ZM2Fk8VT" Received: by mail-pj1-f51.google.com with SMTP id 98e67ed59e1d1-34c84ec3b6eso858629a91.3 for ; Mon, 15 Dec 2025 00:00:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1765785604; x=1766390404; 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=AB9GCG9Z4qz6LZxUZn1uvrlMkgDhqoAwRIBcW65zHlM=; b=ZM2Fk8VTa1KypiEMNVnkQGDXHhS478pVhlxIb/eBhichA0eJ66P2Grj4aIxYyUkhoW a4smlojo1X80BwRmvbxN1HLGpmjh9SzdPRXun7ytMn9NTXMd+eHues1HkrFKUz40Xhhf Awxjw4Vm1l25DApkEmNzPxDKoKnaaDRI2d+ma2nh+NnC1akuKlkX+35XWemYIOO8yzO9 Hr4kYxl4oRpUbrP+2uQXYKIUsKL+NbS4QVyGPoihpLucex8OmVBkkJzHxNSC6tijwIsQ R1e34/C+BcEf9+DLGV1KB9m0D5dqf8t99hWMKHwO0rk8g3oD74wbVUb7cau37omybFyr Yglg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765785604; x=1766390404; 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=AB9GCG9Z4qz6LZxUZn1uvrlMkgDhqoAwRIBcW65zHlM=; b=lBYXw7o6p5fLU+Lm9xL2CZHFbh2sGPoFsMAY5Rv/XHEaW6wDlEKlJ8p0bdvE+1uh8n I1nFAqvMSqUYv5w5rVIZmb5/942HTGe1swCbILAhq2ZliMKkBKDKkFtPweki8SE93uAw Qr+fYNFxM1HnkYYYugB5/ZGHaUY7z/v74+/GuPs6kG9QzMHGeLiOaXhDJjiITnqi8oj6 fpmUOTrqa1QFYaUMXWfT4A5+GjUtiDk0INPDFJnAWoyTfGGX5UnB91vAaKXUW/8Ku5HD vKBzF9C9Moa9fBsrSsvP5a3YKmzay4Q4YN6kDTHEFDREpkSoL/79Bkhs8otPzua+a3TS I/Xg== X-Forwarded-Encrypted: i=1; AJvYcCVZxXOMTqqCn0wcHYUj6Gz+aBylDdjzsWrTpqJ76rub01HloO6kQ7Hw4WDNC/wYiVSct2zfXdR7XV/vdXQ=@vger.kernel.org X-Gm-Message-State: AOJu0YyvGhj837/rNJp3wfQoUJxltSr3CDtrS77/BCsiF6rC7kMU7Zte qqlWKDyvJE+YDUCafqbJwSnWbMT8E/UZn7V4Ua26CA56P5hkaMV14iiu X-Gm-Gg: AY/fxX7J8BMzvMEpitmEnlEWxBMdiyNYrZ1CAtcV2++vRJUqQjBRjgBDj1cBqCJUTBO NAgAkn75SAvi6RanCgH3J3qVnoXJi/ZCalxzru5SRkzgajwAdHgotBB+tUmnvOaykvLsQ5gr9SQ orFugety8HoXMKMkYScjwZPQ/hwLSDCd6L8oJOsTzpbfwFTOm2A1ulrJJliD+nV4M7pWMGOLF2Z 7J1OlqtJD/97g5Y5n8cLEZ8vebHdQQezyZGi2aP6U+tSZMwTo4xviJ6fAVmltBVsAeJnhEZNrF6 /XgglfR9xIYUjh0WKst+e2YwpGRFzNmNCAWeUY0OwyGoCozzylypgzpkpZrt1cmZohoZRQ6w2Eb BfMk5rjq20SqAPSg4+a2EIbQ/GbANYw6fFkLEPA7gvpsrZD1IM3qaTlElwx1K5vhdWwUP/qf+UF vbcOxyMlUMXXPCgFgvdUscGw== X-Google-Smtp-Source: AGHT+IHXq6U+vTIbQsfvkxrFr56SYRwXtblPn+sgeZM7nEKQ8GZt2Mzq2fuD3DcFlMA7ExQdoI6fJQ== X-Received: by 2002:a05:701b:2719:b0:11d:c86c:652e with SMTP id a92af1059eb24-11f34ac540dmr6432564c88.5.1765785603490; Mon, 15 Dec 2025 00:00:03 -0800 (PST) Received: from fedora ([172.59.162.202]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-11f2e2ff624sm43637473c88.12.2025.12.15.00.00.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Dec 2025 00:00:03 -0800 (PST) From: Alex Tran To: Mauro Carvalho Chehab Cc: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Pavel Machek , Sakari Ailus , Laurent Pinchart , linux-media@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Alex Tran Subject: [PATCH v2 2/4] dt-bindings: media: i2c: et8ek8: document missing crc as optional property Date: Sun, 14 Dec 2025 23:58:33 -0800 Message-ID: X-Mailer: git-send-email 2.51.0 In-Reply-To: References: 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" Convert the et8ek8 sensor device tree binding from TXT to YAML format. Add the optional crc property to the endpoint node for the et8ek8 sensor. This property enables CRC checksums for the sensor bus and was added to match the new driver support for reading it from the device tree. Add documentation reference to MAINTAINERS file. Signed-off-by: Alex Tran --- .../bindings/media/i2c/toshiba,et8ek8.txt | 55 ----------- .../bindings/media/i2c/toshiba,et8ek8.yaml | 99 +++++++++++++++++++ MAINTAINERS | 1 + 3 files changed, 100 insertions(+), 55 deletions(-) delete mode 100644 Documentation/devicetree/bindings/media/i2c/toshiba,et8= ek8.txt create mode 100644 Documentation/devicetree/bindings/media/i2c/toshiba,et8= ek8.yaml diff --git a/Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.txt= b/Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.txt deleted file mode 100644 index 8d8e40c56..000000000 --- a/Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.txt +++ /dev/null @@ -1,55 +0,0 @@ -Toshiba et8ek8 5MP sensor - -Toshiba et8ek8 5MP sensor is an image sensor found in Nokia N900 device - -More detailed documentation can be found in -Documentation/devicetree/bindings/media/video-interfaces.txt . - - -Mandatory properties --------------------- - -- compatible: "toshiba,et8ek8" -- reg: I2C address (0x3e, or an alternative address) -- vana-supply: Analogue voltage supply (VANA), 2.8 volts -- clocks: External clock to the sensor -- reset-gpios: XSHUTDOWN GPIO. The XSHUTDOWN signal is active low. The sen= sor - is in hardware standby mode when the signal is in the low state. - - -Optional properties -------------------- - -- flash-leds: See ../video-interfaces.txt -- lens-focus: See ../video-interfaces.txt - - -Endpoint node mandatory properties ----------------------------------- - -- remote-endpoint: A phandle to the bus receiver's endpoint node. - - -Example -------- - -&i2c3 { - clock-frequency =3D <400000>; - - cam1: camera@3e { - compatible =3D "toshiba,et8ek8"; - reg =3D <0x3e>; - vana-supply =3D <&vaux4>; - - clocks =3D <&isp 0>; - assigned-clocks =3D <&isp 0>; - assigned-clock-rates =3D <9600000>; - - reset-gpio =3D <&gpio4 6 GPIO_ACTIVE_HIGH>; /* 102 */ - port { - csi_cam1: endpoint { - remote-endpoint =3D <&csi_out1>; - }; - }; - }; -}; diff --git a/Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.yam= l b/Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.yaml new file mode 100644 index 000000000..6e7f60ee9 --- /dev/null +++ b/Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.yaml @@ -0,0 +1,99 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/i2c/toshiba,et8ek8.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Toshiba et8ek8 5MP sensor + +maintainers: + - Pavel Machek + - Sakari Ailus + +description: + Toshiba et8ek8 5MP sensor is an image sensor found in Nokia N900 device + +properties: + compatible: + const: toshiba,et8ek8 + + reg: + description: + I2C address (0x3e, or an alternative address) + maxItems: 1 + + vana-supply: + description: + Analogue voltage supply (VANA), 2.8 volts + + clocks: + description: + External clock to the sensor + maxItems: 1 + + reset-gpios: + description: + XSHUTDOWN GPIO. The XSHUTDOWN signal is active low. The sensor + is in hardware standby mode when the signal is in the low state. + maxItems: 1 + + flash-leds: + $ref: /schemas/media/video-interfaces.yaml# + + lens-focus: + $ref: /schemas/media/video-interfaces.yaml# + + port: + $ref: /schemas/graph.yaml#/$defs/port-base + additionalProperties: false + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + unevaluatedProperties: false + + properties: + crc: + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 1 + description: + Enable CRC checksums. + + remote-endpoint: true + +required: + - compatible + - reg + - vana-supply + - clocks + - reset-gpios + - port + +additionalProperties: false + +examples: + - | + #include + + i2c { + #address-cells =3D <1>; + #size-cells =3D <0>; + + camera@3e { + compatible =3D "toshiba,et8ek8"; + reg =3D <0x3e>; + vana-supply =3D <&vaux4>; + clocks =3D <&isp 0>; + assigned-clocks =3D <&isp 0>; + assigned-clock-rates =3D <9600000>; + reset-gpios =3D <&gpio4 6 GPIO_ACTIVE_HIGH>; + + port { + csi_cam1: endpoint { + remote-endpoint =3D <&csi_out1>; + crc =3D <1>; + }; + }; + }; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 8aec054a6..6a9ce4d17 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -18308,6 +18308,7 @@ M: Sakari Ailus L: linux-media@vger.kernel.org S: Maintained F: Documentation/devicetree/bindings/media/i2c/adi,ad5820.yaml +F: Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.yaml F: drivers/media/i2c/ad5820.c F: drivers/media/i2c/et8ek8 =20 --=20 2.51.0