From nobody Sun Feb 8 21:06:16 2026 Received: from mail-dy1-f172.google.com (mail-dy1-f172.google.com [74.125.82.172]) (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 A941C301489 for ; Wed, 24 Dec 2025 22:00:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766613617; cv=none; b=JxWS2C4E4J4SvOkKmkowgkFrvQ7pZJQDRjvFEQtB4tDUZOVuYpFkAgL/fHGW7nuBCBtHAdO/PBbzNC4d0JN2+8La0bSSs5mn10Xrh1V5Iei/6/Gb1/n6q5eUSC7njL09Cr0/uItrQeWb5g7GydH8UNPdL3N0L6PV4EkQYuO5UuM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766613617; c=relaxed/simple; bh=aKWT1s5XXurLtC43G3pL5aSf28bI9FrnmYBjxMP+Ydw=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=gEdOFnVeYJPKFs54ha/auiaRwgTKuOD9Mfv3VMdimT+3TiMAF6nIukUwAjgzdTu/eAOE4FNw7RhpMXVCetzrNUoh/Jn5UIY092AEkXM4jmXJq/+JusRxIQujt5Z6yl7LReb4R3QRCA1hG9wCBOwJAgy0g7+t45NItso7YDVl3yU= 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=cRjj2arn; arc=none smtp.client-ip=74.125.82.172 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="cRjj2arn" Received: by mail-dy1-f172.google.com with SMTP id 5a478bee46e88-2ae24015dc0so6423743eec.1 for ; Wed, 24 Dec 2025 14:00:15 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766613615; x=1767218415; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=3bi3r/lddmRdZ339dbw+mk/Ac8K1qVhYyB6AaKyzY7U=; b=cRjj2arna7SGUg1ago1e92R6ENdqUVD5aFYfe90S/aDNmaxewwPVT55zUh+oYFJPze rglqfPC20aR7d+Fd4q/syDMbn4LmWzm1OnWlWP/cE7EVxgVrwIOjndFbvuaiAJliRN27 cvbkAONpoCXpIIm5hMGb3IgFCLNZZJXGQQZ3lbQfweIJ5qDb06O9NGipiqsLg7/gN+Uu ggxw9RVEyhiwFS3IbfGKyL6F1jxDntXrWcHGY9SPVU4YK00rY2K67vKW+wCcqwejhcSL AfzDeHrDq7IpImNE6h5Ph61So91Vd+JjOBypK2+8hl4Obztvf/ydbwZ4XYLMkUaq/7GJ +7Sg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766613615; x=1767218415; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=3bi3r/lddmRdZ339dbw+mk/Ac8K1qVhYyB6AaKyzY7U=; b=QSOIyKfJUyMfA2WAwqtBUCmFQ5XhetcBcm6bfA+MpX27cw/qwHyP1IvlOW6WMEK8KP 6VPuKfaCKIzqeaNlcLXYhrPrbLDjTP0x2VNmOgYzDmICudSp809SLyEadU8Cj0nbRW0S woqoVRkFMo+LRGGA8SxVJnaWjgs91TcKXMj2J37dMxcdsBovBwa8yssXO6SCqACdI9uC iacYGFQyogT5Msvk1f2PFcnS4ZE+0MEgoYMVzYnizkZuceHZt0EuuE5vTOwhFJzjnED9 vJyX7lGSbdf7r3+X6A9AUKGMViEf3evvZOcIfHLrmvjoIgv/5BOeukZ7xMYXeXZGEWn3 BpVg== X-Forwarded-Encrypted: i=1; AJvYcCVSO7Sq2p/eTPaW9IbrDUA/5PetPW52j+SN/zyHJJuACAo0TeIMjLZldD+fraaZJyZEEBSpWC5uohpbubk=@vger.kernel.org X-Gm-Message-State: AOJu0YxL5AlnCVW1PUvSeY7rcnkQl/vxYe7ibV+/+39cy682bemjGLPq nEG6ovqTbT5W225aRc0JUBYpmKMYiEjwW1rY8ClqIkQVzTMA/qhyGCoFgmX2NQ== X-Gm-Gg: AY/fxX6QK+MvaUBRfhWlILdBa3pah005nZtHq4dJWfQNf4FBimv+ZqGe6ceonh59FHE dtRdOJYOYwEP/rxr67Jyw0roPMAEF4uQrO7RiUHQ3+6SnL4RijRAe9ClgiC5xm5ZY9u2p1Cu8wS ZVCKuBdH5/V8nwWpop1F1Erf0Y08KAVsPLjw2jF6gt0EvUaZ6mPMObUmlIi0buH1XsFYam5zBZj +hsv4VTzbRmAMpn6boA0NWnSASiZRO6Hua+gquHGc1174FNovSsiRuiK8S5WC0nkFjSi3PTyFQ8 ijncQx0lPLMzzC0NVo9pNCy1vEjhfezbQlGP6eAPsE5Gd87f3rVBhoMeGdpzdEfPt1INDzC7HwV AXDmwj/r7SuNMclZfo6+pLoG7OvAHBwGeQ1ZkI/pB/W6AalTYUXHtue2193Wk3WzHFCZVqGGy/y cUGe01a98aiktLZmKq8eCReA== X-Google-Smtp-Source: AGHT+IGoHlJZks2rdSFVjlZ+Z0yLSpEpVq1Zsq6IU0wJUUHPixPZen6GBXVpt5JBO3a5D0xfokl5VA== X-Received: by 2002:a05:693c:8119:b0:2b0:4b17:c383 with SMTP id 5a478bee46e88-2b05e66bb9dmr11438936eec.11.1766613614625; Wed, 24 Dec 2025 14:00:14 -0800 (PST) Received: from [192.168.5.77] ([172.59.162.202]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-2b05ff8634csm46610293eec.3.2025.12.24.14.00.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 24 Dec 2025 14:00:14 -0800 (PST) From: Alex Tran Date: Wed, 24 Dec 2025 13:59:58 -0800 Subject: [PATCH v2 1/2] media: dt-bindings: i2c: toshiba,et8ek8: Convert to DT schema 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 Message-Id: <20251224-dt-bindings-et8ek8-omap3isp-v2-1-0728cc1fee27@gmail.com> References: <20251224-dt-bindings-et8ek8-omap3isp-v2-0-0728cc1fee27@gmail.com> In-Reply-To: <20251224-dt-bindings-et8ek8-omap3isp-v2-0-0728cc1fee27@gmail.com> To: Mauro Carvalho Chehab , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Pavel Machek , Sakari Ailus , Laurent Pinchart Cc: Pavel Machek , linux-media@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Alex Tran X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=5177; i=alex.t.tran@gmail.com; h=from:subject:message-id; bh=aKWT1s5XXurLtC43G3pL5aSf28bI9FrnmYBjxMP+Ydw=; b=owEBbQKS/ZANAwAKAXT5fTREJs3IAcsmYgBpTGJrHcinxiL2rav0CQURHPgpKJ23R2Jdrjr81 mvtLDv8nVqJAjMEAAEKAB0WIQQAohViG04SVxUVrcd0+X00RCbNyAUCaUxiawAKCRB0+X00RCbN yOkBEADDoSORKG/GWkzJZZvDxwtqt6VgYlbfhHTC6k4ORlKUqmT//b8XyIdUWl6LlKDuJ88CT3e g0rP1ak90i3eReHggVJMYXPmH1AsmzBa4Mw6HollHJ17rHr6fsbC+Htus6ZqHgMYStfiIpJStwi J1S4h5hs9TsYLWU4dDeLAvRub3b7imUBsWqUfwUxUXEZh8rBvaH4sP3bkY7HoRgMVXA7rZfsSmy GFnl+e0fUka3sCnERZlYPaIOxRLOOhzePWhKLYVnC01s/UaP5NHSPKk6CaKU+aiFPzhq7a4ECXF 9bCnchR5uxFotfaFvjPdE6SsNPNRLWljzrQAFPDCRPy1hCqiBnIwWrNqaXZg7J48UJuHKbakzBk aZaqZWCb515Me6BWMqvd1N8Vd8kwE5zZFxfrL8M7A2UU2GZIpLxwpjVAOosmqhJk+IsyJaYWBtQ iUZLDGzER0aJfDYtFbF66JLprWa+6w67P/5ac1qW54UWUeoHJ4rqWqP6qe4THFmGe0FO0O03FQ6 yB6FwMnSnXVr6oM/VW5VCxrgwsJpzisCgUfQQWw5FYqrYFxy2B1bspQQ77p0LpX0d+tBgrm/VwI Qt9igHUQKY3mrzOlsLIYiPPMwYX3pPDAzpNakaS3ECNFZmEOn3b8LRHOOrn66tLZhRptp1+JDH2 ZJ8dfYoDsuTfYCQ== X-Developer-Key: i=alex.t.tran@gmail.com; a=openpgp; fpr=00A215621B4E12571515ADC774F97D344426CDC8 Convert binding for toshiba,et8ek8 from TXT to YAML format. Update MAINTAINERS file accordingly. The binding references video-interface-devices.yaml to inherit flash-leds and lens-focus properties. Signed-off-by: Alex Tran --- .../bindings/media/i2c/toshiba,et8ek8.txt | 55 -------------- .../bindings/media/i2c/toshiba,et8ek8.yaml | 88 ++++++++++++++++++= ++++ MAINTAINERS | 1 + 3 files changed, 89 insertions(+), 55 deletions(-) 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 8d8e40c5687283d2f582895542cc9b765983d025..000000000000000000000000000= 0000000000000 --- 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 0000000000000000000000000000000000000000..78e07955a2ed75c976122596445= 93fee90235c64 --- /dev/null +++ b/Documentation/devicetree/bindings/media/i2c/toshiba,et8ek8.yaml @@ -0,0 +1,88 @@ +# 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 + +allOf: + - $ref: /schemas/media/video-interface-devices.yaml# + +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: + 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: true + lens-focus: true + + port: + $ref: /schemas/graph.yaml#/$defs/port-base + additionalProperties: false + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + unevaluatedProperties: false + +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>; + flash-leds =3D <&led>; + lens-focus =3D <&vcm>; + + port { + csi_cam1: endpoint { + remote-endpoint =3D <&csi_out1>; + }; + }; + }; + }; diff --git a/MAINTAINERS b/MAINTAINERS index dc731d37c8feeff25613c59fe9c929927dadaa7e..50722537d5483611eea3c8af6c6= 8ae0ec5e4aee8 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -18582,6 +18582,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 From nobody Sun Feb 8 21:06:16 2026 Received: from mail-pf1-f181.google.com (mail-pf1-f181.google.com [209.85.210.181]) (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 331DF3081A4 for ; Wed, 24 Dec 2025 22:00:17 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.181 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766613619; cv=none; b=qYC/rfnjGfkRFJae9VxXYzkJqgTJWOMFTm5+3wY/WCfy8QGbN5wmA0W+Ud7ttlC9GPU7SBldibwfRgIQbEmj8SOt1LZV42KE7fNDZbcJkjeRc5ZJoG2y3brfMkT2VG2YS0jl9E/evzceiyf1l3+1zV8LX+9iOKPTifl/9O+LW30= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1766613619; c=relaxed/simple; bh=dn4qDZdDpU1VrgzXfez3SR3IkgUWnRNxBpL/LcMJRDg=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=nmKB2+ts7DdSCC62rYjLEr7fY4k01z5YVMZj+A28mM5TqUQImUuUyuXim1JiASdQ/K6ImPoHcyjND+Wb29Nc+ytdNjPX/Mg84lK0PvUviazBIxIRLjLTV1Aq3Ga/7Dpcm7Xww6Pkq84neghvpgglEBy17zyG+Trhpma0ZxtPgXc= 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=Br7C1O5J; arc=none smtp.client-ip=209.85.210.181 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="Br7C1O5J" Received: by mail-pf1-f181.google.com with SMTP id d2e1a72fcca58-7f121c00dedso8360050b3a.0 for ; Wed, 24 Dec 2025 14:00:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1766613616; x=1767218416; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=TCUT94w0VeyaMmTXy6p9kTp5D3//iqDd06KvUuU4WS0=; b=Br7C1O5JR758yKxC36VsU8PgLD5JdUEZmwjFbcRh0n5DuEbXNvpk4b1mNbuK5eApTG srkTfMgnU3A1AOM96FnsH+a3g/LhHUTXZEVQF3HcJ+BsM/golR8OjG1YCay16GuO8VEf 2b/iyAQGOspWFqjfymtGTShmtgbelQiGwwh0G9GdelRpFd2+4jbzfrYdKOf+LdDYRMc1 RBJAh8dD/Z/s8hqhNlb5mObDjKPG5Gkc0uu5ij1rZh565+GfAkRnEA4pG6xoP/XYdnEu 4hQK2yHtzhb+nDIYrTmxJJs7hqb5jSEPKd6cTsW85EmOwncUXY2dfGAqBEnVIrfqC8IE 9bow== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1766613616; x=1767218416; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-gg:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=TCUT94w0VeyaMmTXy6p9kTp5D3//iqDd06KvUuU4WS0=; b=Lavp/X7uM44h7TQ6BGaRhlb83O3YelC9imBSY9tZX7nV8EQOqaJS6/SWkWGsLeu/Zt hmxBo1lEbnKKhg9vL2kAPzfmGrOjOGE7aoIi7lvQGxtWdmsVeRjMpqtCJ8DObJ12rBpw ZnuJD2YQj+N90mmvh+AJQMu2Kfhsyh2rLtWDw5G66G+CP4BoAJH95lEt+ryv6nt3avLq NjpjmANy/Xh8F1RG2GVCYney2iDTaQpUus43lwTCi/8Q6oW6MuRkLf7eiRIdQAUZUMaA Y0AupgqvjBrWBK+VoHiATwUcOQXu+ha5lZWP0tcdSyx+8MI8jCQaa7HdYrnvg77GH9yu ViEA== X-Forwarded-Encrypted: i=1; AJvYcCXYW2LIuhuu4IVjHl5rSZVK52R52LKAqYaXFHCM4q93+aWA7FXiq18wXNzlBC4Nhm6YBtPvJRS3q11yl+w=@vger.kernel.org X-Gm-Message-State: AOJu0YweYdfcwJEUUziSi+wIC8/b8XPP8sZy2MP2ToVDY5JwmUdwbbpW DLkRGHuIcP8Pw9LrBTqYBbWWNeMp8tFmw3lAnfLQUorcZDDEMtrVElh/ X-Gm-Gg: AY/fxX5maNlWJZR6J+a5mgqKKHhCZLPItGfF1OLJDQibhi77M6N+XItgCFm7HtJ//SC /A+hSa03W9P5bnJAQ1OMvUsobsEReqU/gzxCDsuG5guPLNoBDPKiTCS0PkVqz+qLl3Zn3iKjSTV P8NEG1KYLKGRQwfhXYmZYNX+TuW+DWjj+i/245udTUrzhIYfqF8YzU4zd400xQmEwPnyOiGgq5F fWNePczLYwGwsctPzabrABGEXc20RlfbjHuAmqpoFDaYTokX84w1Nv/xDCk6XPCWURvc3o4DBPk XxlUv09DdVMM+CXLfFWyJaywW78FP0hPHWiELBqeEo0Gouc+XLVriXMEtMFqEppoJ5sqfeukgGu m9i8zX3AlKFsT+Ioq+fZ15uM58WhC7AnaB9+BW5bVo9KVK+CgTs9QAvv9/PJTkfVUTZqqxN1cA0 CcUSHvAmomxH5/czsf6zTjcA== X-Google-Smtp-Source: AGHT+IFz9wv6QdTk99v9SU+hpMyVwkzVR7B3nRW/uv6OpuoWPrEAVznS4sDhdt9/RKoddSg8dRjcaw== X-Received: by 2002:a05:7022:370f:b0:119:e56b:c758 with SMTP id a92af1059eb24-121722e30c6mr13153813c88.29.1766613616226; Wed, 24 Dec 2025 14:00:16 -0800 (PST) Received: from [192.168.5.77] ([172.59.162.202]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-2b05ff8634csm46610293eec.3.2025.12.24.14.00.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 24 Dec 2025 14:00:15 -0800 (PST) From: Alex Tran Date: Wed, 24 Dec 2025 13:59:59 -0800 Subject: [PATCH v2 2/2] media: dt-bindings: ti,omap3isp: Convert to DT schema 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 Message-Id: <20251224-dt-bindings-et8ek8-omap3isp-v2-2-0728cc1fee27@gmail.com> References: <20251224-dt-bindings-et8ek8-omap3isp-v2-0-0728cc1fee27@gmail.com> In-Reply-To: <20251224-dt-bindings-et8ek8-omap3isp-v2-0-0728cc1fee27@gmail.com> To: Mauro Carvalho Chehab , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Pavel Machek , Sakari Ailus , Laurent Pinchart Cc: Pavel Machek , linux-media@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Alex Tran X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=8339; i=alex.t.tran@gmail.com; h=from:subject:message-id; bh=dn4qDZdDpU1VrgzXfez3SR3IkgUWnRNxBpL/LcMJRDg=; b=owEBbQKS/ZANAwAKAXT5fTREJs3IAcsmYgBpTGJrxKo6IhDwyejlSNL1tmQ+1ISOUpHriD7+O p4kqnB5frKJAjMEAAEKAB0WIQQAohViG04SVxUVrcd0+X00RCbNyAUCaUxiawAKCRB0+X00RCbN yD2eEAC2a04xZq73XFYFPzF8nRl3xtZtKIeZn09gvMKpANTgpu6efibxasgLaBdG8TIVuII3Wej klhgwZ4EO0xxvyZvk7zjXuISVSak+6Th/jWbFwG6DsnhXUBd/kPoraJqkY95jdndw+Ya8MZeNSJ UFSKy4d7zVtNYzCY1tgboY4fLvUH7r7DWxz3P8YInyueT17XC8OIv4MXWZX7nCSWpa2wr/nPcig 6yl6VlPuryYg7ja+BQ4uTlfMpDrWrrdHEImFMAmIZLVDKtrQvPhnCqmQtQk4LJ0/UYE6p0vnRWZ 3B+AMsw9QR7ncQsPguQmVVzsTbT3J63UWUxpMNg4dDS34XmaHNKPcAheNq3PCo57L6EEVYjXU5u z3cMEQW1qtdijAWPT6w2Qd0QdI2i8hvEuvtFmCTaywkwj1irvkAlaDstOFqbNcKuMjWNY3/Te6S cjHejMvgaei9bY5L26YSA3kV1yguhimuWPK4ZVhazvEbnJHyt2TXN3WurrYleIJlgMZnwz6srM2 Aeeyw6Xw21G4RcfarqokCiRVbYTDY5t5pNkkH/2w7E6BSOCrzzDLYCadUo6Vgaw9A6lxI6aY87q +nvp0aVAVDQB9/9YRTLwFA+0DfzSNuBH3Xq2oIcSyf5AHn7XRM+mEJc7kZfQGvCy6DboxAMX2dT m3K6jWYN8tlDpmg== X-Developer-Key: i=alex.t.tran@gmail.com; a=openpgp; fpr=00A215621B4E12571515ADC774F97D344426CDC8 Convert binding for ti,omap3isp from TXT to YAML format. Signed-off-by: Alex Tran --- .../devicetree/bindings/media/ti,omap3isp.txt | 71 -------- .../devicetree/bindings/media/ti,omap3isp.yaml | 189 +++++++++++++++++= ++++ 2 files changed, 189 insertions(+), 71 deletions(-) diff --git a/Documentation/devicetree/bindings/media/ti,omap3isp.txt b/Docu= mentation/devicetree/bindings/media/ti,omap3isp.txt deleted file mode 100644 index ac23de8556412c52710f46c3ea015d2976c96dad..000000000000000000000000000= 0000000000000 --- a/Documentation/devicetree/bindings/media/ti,omap3isp.txt +++ /dev/null @@ -1,71 +0,0 @@ -OMAP 3 ISP Device Tree bindings -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D - -The DT definitions can be found in include/dt-bindings/media/omap3-isp.h. - -Required properties -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -compatible : must contain "ti,omap3-isp" - -reg : the two registers sets (physical address and length) for the - ISP. The first set contains the core ISP registers up to - the end of the SBL block. The second set contains the - CSI PHYs and receivers registers. -interrupts : the ISP interrupt specifier -iommus : phandle and IOMMU specifier for the IOMMU that serves the ISP -syscon : the phandle and register offset to the Complex I/O or CSI-PHY - register -ti,phy-type : 0 -- OMAP3ISP_PHY_TYPE_COMPLEX_IO (e.g. 3430) - 1 -- OMAP3ISP_PHY_TYPE_CSIPHY (e.g. 3630) -#clock-cells : Must be 1 --- the ISP provides two external clocks, - cam_xclka and cam_xclkb, at indices 0 and 1, - respectively. Please find more information on common - clock bindings in ../clock/clock-bindings.txt. - -Port nodes (optional) ---------------------- - -More documentation on these bindings is available in -video-interfaces.txt in the same directory. - -reg : The interface: - 0 - parallel (CCDC) - 1 - CSIPHY1 -- CSI2C / CCP2B on 3630; - CSI1 -- CSIb on 3430 - 2 - CSIPHY2 -- CSI2A / CCP2B on 3630; - CSI2 -- CSIa on 3430 - -Optional properties -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -vdd-csiphy1-supply : voltage supply of the CSI-2 PHY 1 -vdd-csiphy2-supply : voltage supply of the CSI-2 PHY 2 - -Endpoint nodes --------------- - -lane-polarities : lane polarity (required on CSI-2) - 0 -- not inverted; 1 -- inverted -data-lanes : an array of data lanes from 1 to 3. The length can - be either 1 or 2. (required on CSI-2) -clock-lanes : the clock lane (from 1 to 3). (required on CSI-2) - - -Example -=3D=3D=3D=3D=3D=3D=3D - - isp@480bc000 { - compatible =3D "ti,omap3-isp"; - reg =3D <0x480bc000 0x12fc - 0x480bd800 0x0600>; - interrupts =3D <24>; - iommus =3D <&mmu_isp>; - syscon =3D <&scm_conf 0x2f0>; - ti,phy-type =3D ; - #clock-cells =3D <1>; - ports { - #address-cells =3D <1>; - #size-cells =3D <0>; - }; - }; diff --git a/Documentation/devicetree/bindings/media/ti,omap3isp.yaml b/Doc= umentation/devicetree/bindings/media/ti,omap3isp.yaml new file mode 100644 index 0000000000000000000000000000000000000000..6137ac1e1c4432b9cc3102c5aa5= 69e0c9930df42 --- /dev/null +++ b/Documentation/devicetree/bindings/media/ti,omap3isp.yaml @@ -0,0 +1,189 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/ti,omap3isp.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments OMAP 3 Image Signal Processor (ISP) + +maintainers: + - Laurent Pinchart + - Sakari Ailus + +description: + The OMAP 3 ISP is an image signal processor present in OMAP 3 SoCs. + +properties: + compatible: + const: ti,omap3-isp + + reg: + items: + - description: Core ISP registers up to the end of the SBL block + - description: CSI PHYs and receivers registers + + interrupts: + maxItems: 1 + + iommus: + maxItems: 1 + + syscon: + $ref: /schemas/types.yaml#/definitions/phandle-array + items: + - items: + - description: phandle to System Control Module + - description: register offset to Complex I/O or CSI-PHY register + description: + Phandle and register offset to the Complex I/O or CSI-PHY register + + ti,phy-type: + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + description: + 0 - OMAP3ISP_PHY_TYPE_COMPLEX_IO (e.g. OMAP 3430) + 1 - OMAP3ISP_PHY_TYPE_CSIPHY (e.g. OMAP 3630) + + '#clock-cells': + const: 1 + description: + The ISP provides two external clocks, cam_xclka and cam_xclkb, + at indices 0 and 1 respectively. + + vdd-csiphy1-supply: + description: Voltage supply of the CSI-2 PHY 1 + + vdd-csiphy2-supply: + description: Voltage supply of the CSI-2 PHY 2 + + ports: + $ref: /schemas/graph.yaml#/properties/ports + + properties: + port@0: + $ref: /schemas/graph.yaml#/$defs/port-base + unevaluatedProperties: false + description: Parallel (CCDC) interface + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + unevaluatedProperties: false + + port@1: + $ref: /schemas/graph.yaml#/$defs/port-base + unevaluatedProperties: false + description: | + CSIPHY1 interface: + OMAP 3630: CSI2C / CCP2B + OMAP 3430: CSI1 (CSIb) + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + unevaluatedProperties: false + + properties: + lane-polarities: + minItems: 2 + maxItems: 3 + + data-lanes: + minItems: 1 + maxItems: 2 + items: + minimum: 1 + maximum: 3 + + clock-lanes: + minimum: 1 + maximum: 3 + + port@2: + $ref: /schemas/graph.yaml#/$defs/port-base + unevaluatedProperties: false + description: | + CSIPHY2 interface: + OMAP 3630: CSI2A / CCP2B + OMAP 3430: CSI2 (CSIa) + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + unevaluatedProperties: false + + properties: + lane-polarities: + minItems: 2 + maxItems: 3 + + data-lanes: + minItems: 1 + maxItems: 2 + items: + minimum: 1 + maximum: 3 + + clock-lanes: + minimum: 1 + maximum: 3 + +required: + - compatible + - reg + - interrupts + - iommus + - syscon + - ti,phy-type + - '#clock-cells' + +additionalProperties: false + +examples: + - | + #include + + isp@480bc000 { + compatible =3D "ti,omap3-isp"; + reg =3D <0x480bc000 0x12fc>, + <0x480bd800 0x0600>; + interrupts =3D <24>; + iommus =3D <&mmu_isp>; + syscon =3D <&scm_conf 0x2f0>; + ti,phy-type =3D ; + #clock-cells =3D <1>; + vdd-csiphy1-supply =3D <&vaux2>; + vdd-csiphy2-supply =3D <&vaux2>; + + ports { + #address-cells =3D <1>; + #size-cells =3D <0>; + + port@0 { + reg =3D <0>; + parallel_ep: endpoint { + remote-endpoint =3D <¶llel>; + }; + }; + + port@1 { + reg =3D <1>; + csi1_ep: endpoint { + remote-endpoint =3D <&smia_1>; + clock-lanes =3D <1>; + data-lanes =3D <2>; + lane-polarities =3D <0 0>; + }; + }; + + port@2 { + reg =3D <2>; + csi2a_ep: endpoint { + remote-endpoint =3D <&smia_2>; + clock-lanes =3D <2>; + data-lanes =3D <1 3>; + lane-polarities =3D <1 1 1>; + }; + }; + }; + }; --=20 2.51.0