From nobody Tue Dec 16 08:51:45 2025 Received: from mail-pf1-f180.google.com (mail-pf1-f180.google.com [209.85.210.180]) (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 4DB3B327BE1 for ; Mon, 15 Dec 2025 08:00:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765785611; cv=none; b=G5fuMnYZIwyz4EOnUB3n27zei0NANyDLBN/PLad0/aTYQmT8ttvgAhXmLemOwyW+jniJM+Tc3xNW6W3YlY80WyrS09f2IFgZ+b/NqfZ6qXAavuQB+dAuB4ZN2+3GeCXduJWbj2rtOvs3rjfNJSG+DmQFWVzUOQeLDzMA46eWSSI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765785611; c=relaxed/simple; bh=QCz6aFbAKxYNVGwc04303xaq8oUpPnl7l7rMqJKXeEU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=g2CpUwQOy4v4b0OmWfjKr26J9076ia3TsWn6TLsA2rBMF/GGiitstWpFT6u3rCw58jg9rre6QyTbB13BNrOcxHin4f53MNC/GMuuA+HKzL/yJ3i++B43cwKQIdbTvkN3HZ2MN0YfJpV6EcCNuOmcpwSNxPAMhqUBdzUcjbeJ/lY= 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=W2qFYxlI; arc=none smtp.client-ip=209.85.210.180 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="W2qFYxlI" Received: by mail-pf1-f180.google.com with SMTP id d2e1a72fcca58-7b9c17dd591so2515607b3a.3 for ; Mon, 15 Dec 2025 00:00:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1765785608; x=1766390408; 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=7tSlML4uKCCHRjDgUuA5+Z7+nq0n6j206qyzOtMJBNM=; b=W2qFYxlIY7Oolf+Uhey01GwQjGsU7XOoLW3+3VF4qCN2Ww36oATuSXc3iYsX81WG4S AdlzlLm8IXTsTG4xoHhBdt9Dyiz4mtj73X3bnacuWAu5GjkqKLPB8kWcYWESQtWfr300 h8VYA5GjU6wsbMNfGi68rLqpFRX7PI3j+C53k+N7hYLGer3C//emU35+UvEX0isiYtTX T5SHEyt6A9OhUM1oPcVMhon17LAQ6G8AfMCG2rvyHFSS/tXuglt7VCS6/iYZ/Fapryxq F03JiaHx9qSyVKUix4+tZz7QJbSt8tJ1eAuUw08FKOJjahmT2wnlPBK39BvZNN4UEUcn 23mw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765785608; x=1766390408; 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=7tSlML4uKCCHRjDgUuA5+Z7+nq0n6j206qyzOtMJBNM=; b=fiP3EiW3FiBVBJ+63jXRiJhXiY9JYd6r7JgDhCTg3AZzY8iHcqDXCM3zwzOl02wrIQ HadYAD6rdvXTJaJdFEU2ybG3yEitYJjVZIfDDoNXFpBSDw6EUA56HGM2r40SbLqP0rIh dPVdNBqPgHyDcPq7SNHuSX8aNZ/KSRW0Bp4P5EjEhnz3/dchb8gZq8r2hCBID6ZbB1Eu 4IYr55t3qJTfvgF2Yj/yPEAPwo+pk0Y3V0KmHWx5VV5SwFWbmz5JgW5ptCWg8cdsGCIR FcHhJ1x2JevJ0WVcki+TWxBeMSmuckZpsS2Gk/iWa1LZzSNYQw2TNpuWZ6fP9AoHH42W ZESA== X-Forwarded-Encrypted: i=1; AJvYcCUXBUM5PlOlTcs9c6Pe7vxvTdQesTf+9Ti1MhzP7FVVj66RN3PjQLRk/X/6n7XffGx8leEs5HK/EBEV77Q=@vger.kernel.org X-Gm-Message-State: AOJu0YwFJ1TrDMBd5YdCmtRoVidJqKoJcncuy3udriW3QyYLU0keghf6 u++EdDP202vUKYud7gt8qfSqHW6h/AHupSHZKp8qnoT0XVejg1or+MiM X-Gm-Gg: AY/fxX7IYs31SqAbpYzP1TZJh4FQe6YaBxIKBwPjs1YGorhzSgXCN8rnh/L32Go8yaY SJkia/Qjcw4I5w5guVWaDtj0n0prRiUAarxmY/3ob74jCUBVw1nArrjyem/5qcKR/PvfIoUJ0pC xD1usvmUoC7wZd/9eUiZdxGrW618Mv4RN92zQ19r71cEOfhbH3eMqAZ1gyCgCKRJfwrW9eGakBn iyOX4AJi6Be8HYi4Mricd+osrkOp7UnjAGJ6b2HnnZNaGVgTA9kQWugAKcptrqLfM+BbnZkfT08 wxJnyAqz6UcHUfNCfh84RfXCZuGWrpW/cJbkh2BRE6zflNA/WZCjWLCqSk33NinwBNS9N0mhfpF tUEXtJ+SgPNC5bsMXlMBIlELgNKlmCgcTnjV3IUDKY2IFPGNbs510QkLPySnVPlVQdWtj6xmqDA K990R3vg01j/E= X-Google-Smtp-Source: AGHT+IHvfP5fbQNkStJwNn99uM97HKzJkrR2L4hGBv1RulgL1zBQt7w33jX/ynI+qGQSHpIEgrwTOg== X-Received: by 2002:a05:7022:7f03:b0:11c:fe15:f66d with SMTP id a92af1059eb24-11f349c5bbdmr5406985c88.17.1765785607633; Mon, 15 Dec 2025 00:00:07 -0800 (PST) Received: from fedora ([172.59.162.202]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-11f2e2ff624sm43637473c88.12.2025.12.15.00.00.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Dec 2025 00:00:07 -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 4/4] dt-bindings: media: omap3isp: document missing crc as optional property Date: Sun, 14 Dec 2025 23:58:35 -0800 Message-ID: <99fea6935f255661a2c41adc11ba5f85d17e3bf4.1765782992.git.alex.t.tran@gmail.com> 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 OMAP3 ISP device tree binding from TXT format to YAML. Add the optional crc property to the endpoint node for the omap3isp receiver. This property enables CRC checksums for the bus and was added to match the new driver support for reading it from the device tree. Signed-off-by: Alex Tran --- .../devicetree/bindings/media/ti,omap3isp.txt | 71 ------- .../bindings/media/ti,omap3isp.yaml | 196 ++++++++++++++++++ 2 files changed, 196 insertions(+), 71 deletions(-) delete mode 100644 Documentation/devicetree/bindings/media/ti,omap3isp.txt create mode 100644 Documentation/devicetree/bindings/media/ti,omap3isp.yaml diff --git a/Documentation/devicetree/bindings/media/ti,omap3isp.txt b/Docu= mentation/devicetree/bindings/media/ti,omap3isp.txt deleted file mode 100644 index ac23de855..000000000 --- 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 000000000..b86c3aa71 --- /dev/null +++ b/Documentation/devicetree/bindings/media/ti,omap3isp.yaml @@ -0,0 +1,196 @@ +# 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 + description: the ISP interrupt specifier + + iommus: + maxItems: 1 + description: phandle and IOMMU specifier for the IOMMU that serves the= ISP + + 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: + description: | + The lane polarity (required on CSI-2): + 0 - not inverted + 1 - inverted + minItems: 2 + maxItems: 3 + items: + enum: [0, 1] + + data-lanes: + description: Data lanes (required on CSI-2) + minItems: 1 + maxItems: 2 + items: + minimum: 1 + maximum: 3 + + clock-lanes: + description: The clock lane (required on CSI-2) + maxItems: 1 + items: + minimum: 1 + maximum: 3 + + crc: + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 1 + description: + Enable CRC checksums. + + 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: + description: | + The lane polarity (required on CSI-2): + 0 - not inverted + 1 - inverted + minItems: 2 + maxItems: 3 + items: + enum: [0, 1] + + data-lanes: + description: Data lanes (required on CSI-2) + minItems: 1 + maxItems: 2 + items: + minimum: 1 + maximum: 3 + + clock-lanes: + description: The clock lane (required on CSI-2) + maxItems: 1 + items: + minimum: 1 + maximum: 3 + + crc: + $ref: /schemas/types.yaml#/definitions/uint32 + enum: [0, 1] + default: 1 + description: + Enable CRC checksums. + +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>; + + ports { + #address-cells =3D <1>; + #size-cells =3D <0>; + }; + }; --=20 2.51.0