Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Liu Ying <victor.liu@nxp.com>
To:     dri-devel@lists.freedesktop.org, devicetree@vger.kernel.org,
        linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org,
        linux-media@vger.kernel.org
Cc:     andrzej.hajda@intel.com, narmstrong@baylibre.com,
        robert.foss@linaro.org, Laurent.pinchart@ideasonboard.com,
        jonas@kwiboo.se, jernej.skrabec@gmail.com, airlied@linux.ie,
        daniel@ffwll.ch, robh+dt@kernel.org,
        krzysztof.kozlowski+dt@linaro.org, shawnguo@kernel.org,
        s.hauer@pengutronix.de, kernel@pengutronix.de, festevam@gmail.com,
        linux-imx@nxp.com, lee.jones@linaro.org, mchehab@kernel.org,
        marcel.ziswiler@toradex.com
Subject: [PATCH v9 05/14] dt-bindings: display: bridge: Add i.MX8qm/qxp display pixel link binding
Date:   Sat, 11 Jun 2022 22:14:12 +0800
Message-Id: <20220611141421.718743-6-victor.liu@nxp.com>
In-Reply-To: <20220611141421.718743-1-victor.liu@nxp.com>
References: <20220611141421.718743-1-victor.liu@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?jCB5SFbJSsqzQ5WgAQR8JpYHhRzR9iukt+XM0rprd7AjaY037rnmDqXA2TJq?=
 =?us-ascii?Q?uXcYps+gYAr7E5p9264hL8ZQl8X4wDm3aH7Z4+EDKSg9DJREv8zJTCeDuzN5?=
 =?us-ascii?Q?2YAmIkzTHtAuonPp8HoIVMgKONAJAwi0mnUfYJRMl6Gg/AZYUMfyO7GuUrbm?=
 =?us-ascii?Q?61VkQjzTK4Ux7P9OxsZxvT62CqH7ur47KnSF/YRLjj2yqeG75xqXF1EHWZCp?=
 =?us-ascii?Q?CsfRbxsEBCS77OiA21eEn9+KDJmuOceXCTCqFeT2fgHZkjwnxpsIub4H8ZVU?=
 =?us-ascii?Q?/ekZONc/sBYkToA0WcVk/avomfsrD6e6M0vaCs1jbFvJ98+7iN4hbsf0K1n8?=
 =?us-ascii?Q?M/ntuL+VXkSDGynJTMMUjHGjdWO3pfP7Le/4bvahIdAWwqjLv7Tmcp9/OVkP?=
 =?us-ascii?Q?6JLT4DiC/Yyl2HdYuCl6GlsjrJ6JXKQDuW73NJGmUx++VOF2nFXAECWyRaWe?=
 =?us-ascii?Q?/A8lTWoScRnR7XbmzWlzApuD2nuxgJIGuMsPGiTaHMYmOTtvNRs5h8ITWOzz?=
 =?us-ascii?Q?0h9KYN9ucD3PcSJkat6aBVxfNTTz9mytgxvp5En5HE+E974231xKi5/cLkpA?=
 =?us-ascii?Q?kIDXyfLdou9evFZpWam5nh6+J8SYi+iAD5NboUDpqy9eIG+YLxXVc6p7YhbU?=
 =?us-ascii?Q?rNjJAPtwNbpvQF7wfASQMkffkpI0L0hvYTcPVt0PyCfh5uVSacnrF6F1Fksn?=
 =?us-ascii?Q?JfA+XjOY6edVJRT0h/ivdvJOrp66WLg7/zQe3jaTJbLVXDMemOT0t9pgDi4z?=
 =?us-ascii?Q?re55BCi0+dHvCUOP9+tNeUwhinLOvs3T8a2RMX3gHpXiK5vCWjebDGxGE460?=
 =?us-ascii?Q?zgwaYhfUTKwvkXOoKXNDGQ72K8fKsZC1uIbOusImkfZMZHj8sj0HPRUVHVE0?=
 =?us-ascii?Q?+Ail/zzCRYG789zsYV11dnA5762ObJY+/suziF1qiYHWCC+vHxq0Plie49+Z?=
 =?us-ascii?Q?pu7m6sPgpA56bILMUcVX1H9xNOjINS1RAG4po9NSRWULrNmHUqnGLYFrPjDW?=
 =?us-ascii?Q?pJFhaBFiNkh/4xMYE/CNbH/XGtE58sW4531TvSWyKJrJXOXjh+iWRDEH15SW?=
 =?us-ascii?Q?9KJ8/PmC11r74cwCKA1KKyg0fDRGwaRaLwVaEeuI6r+hDy7voZSk7mof1CL9?=
 =?us-ascii?Q?esFfVOK5TauAxXpMqd5ANJ6hr2PsHNDBlsVbC7c2vZ8hAs/5n9vx7F85XVI2?=
 =?us-ascii?Q?V4mEixGUU0vHG6nUa3TNkMUJu9d2rE4GqnO4P+DITVBAjtiIySrB0u+KPNP+?=
 =?us-ascii?Q?9i9ec+/VV8IJ4MWB2ocmbc2iiP8cOC7PWz1Si5ETZez88TjkTiubeKmKdjyv?=
 =?us-ascii?Q?z5sLbuNn0zg9daEOHh+k8BpxudflQ7ZExHSYL0BqgUanIwpqq7syudWaNmLP?=
 =?us-ascii?Q?jhqd3nHI8qoHb0LkuRlIAZk83cwdOxDEtMt+0FPZT94XK0cjWxbU8UjnNQ40?=
 =?us-ascii?Q?pgN5Tq1iuCkgOfNS8EGTKpP4emqmzhbIsxvR+knzG/7006NV+ljvpL77i1cn?=
 =?us-ascii?Q?n5+azuB5MisWujN0Mhhkf+I6TzqUUTRumUEikyRo3cyEDOS3k3/4reprZ0OD?=
 =?us-ascii?Q?vpoxDz0APDE5scGW4sKQvX1jBcaHn30OqAvaMzYIPN8oOvIRghn9avqKAiC6?=
 =?us-ascii?Q?EfgLurFrI4Y9IbWI6xOE9A3fr2PVdHcOWUk7hVwpCz6g0r9J8TgmuAnMzOxk?=
 =?us-ascii?Q?02MwLLkfK/Pr3zjAbABf0hUVtTx3+tHn07IaIOdzLDzQufcATjDuSZNwnjxj?=
 =?us-ascii?Q?NQXV2+4p4A=3D=3D?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 5f60def6-147a-40e3-07ae-08da4bb48c49
X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Jun 2022 14:13:24.7545
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: nZcIHNtK4TtygxfYesi8oyHmSRX88jci3ir+lOK7CxROYb7uCJvpI2iCy3QgiY/I69GHRbGK7wabsJmPN8syxw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB8PR04MB6347
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

This patch adds bindings for i.MX8qm/qxp display pixel link.

Signed-off-by: Liu Ying <victor.liu@nxp.com>
---
v8->v9:
* Add 'fsl,dc-id' and 'fsl,dc-stream-id' properties. (Laurent)
* Drop Rob's R-b tag.

v7->v8:
* No change.

v6->v7:
* No change.

v5->v6:
* No change.

v4->v5:
* No change.

v3->v4:
* No change.

v2->v3:
* Add Rob's R-b tag.

v1->v2:
* Use graph schema. (Laurent)
* Require all four pixel link output ports. (Laurent)
* Mention pixel link is accessed via SCU firmware. (Rob)

 .../bridge/fsl,imx8qxp-pixel-link.yaml        | 144 ++++++++++++++++++
 1 file changed, 144 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-pixel-link.yaml

diff --git a/Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-pixel-link.yaml b/Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-pixel-link.yaml
new file mode 100644
index 000000000000..38ecc7926fad
--- /dev/null
+++ b/Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-pixel-link.yaml
@@ -0,0 +1,144 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/display/bridge/fsl,imx8qxp-pixel-link.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Freescale i.MX8qm/qxp Display Pixel Link
+
+maintainers:
+  - Liu Ying <victor.liu@nxp.com>
+
+description: |
+  The Freescale i.MX8qm/qxp Display Pixel Link(DPL) forms a standard
+  asynchronous linkage between pixel sources(display controller or
+  camera module) and pixel consumers(imaging or displays).
+  It consists of two distinct functions, a pixel transfer function and a
+  control interface.  Multiple pixel channels can exist per one control channel.
+  This binding documentation is only for pixel links whose pixel sources are
+  display controllers.
+
+  The i.MX8qm/qxp Display Pixel Link is accessed via System Controller Unit(SCU)
+  firmware.
+
+properties:
+  compatible:
+    enum:
+      - fsl,imx8qm-dc-pixel-link
+      - fsl,imx8qxp-dc-pixel-link
+
+  fsl,dc-id:
+    $ref: /schemas/types.yaml#/definitions/uint8
+    description: |
+      u8 value representing the display controller index that the pixel link
+      connects to.
+
+  fsl,dc-stream-id:
+    $ref: /schemas/types.yaml#/definitions/uint8
+    description: |
+      u8 value representing the display controller stream index that the pixel
+      link connects to.
+    enum: [0, 1]
+
+  ports:
+    $ref: /schemas/graph.yaml#/properties/ports
+
+    properties:
+      port@0:
+        $ref: /schemas/graph.yaml#/properties/port
+        description: The pixel link input port node from upstream video source.
+
+    patternProperties:
+      "^port@[1-4]$":
+        $ref: /schemas/graph.yaml#/properties/port
+        description: The pixel link output port node to downstream bridge.
+
+    required:
+      - port@0
+      - port@1
+      - port@2
+      - port@3
+      - port@4
+
+allOf:
+  - if:
+      properties:
+        compatible:
+          contains:
+            const: fsl,imx8qxp-dc-pixel-link
+    then:
+      properties:
+        fsl,dc-id:
+          const: 0
+
+  - if:
+      properties:
+        compatible:
+          contains:
+            const: fsl,imx8qm-dc-pixel-link
+    then:
+      properties:
+        fsl,dc-id:
+          enum: [0, 1]
+
+required:
+  - compatible
+  - fsl,dc-id
+  - fsl,dc-stream-id
+  - ports
+
+additionalProperties: false
+
+examples:
+  - |
+    dc0-pixel-link0 {
+        compatible = "fsl,imx8qxp-dc-pixel-link";
+        fsl,dc-id = /bits/ 8 <0>;
+        fsl,dc-stream-id = /bits/ 8 <0>;
+
+        ports {
+            #address-cells = <1>;
+            #size-cells = <0>;
+
+            /* from dc0 pixel combiner channel0 */
+            port@0 {
+                reg = <0>;
+
+                dc0_pixel_link0_dc0_pixel_combiner_ch0: endpoint {
+                    remote-endpoint = <&dc0_pixel_combiner_ch0_dc0_pixel_link0>;
+                };
+            };
+
+            /* to PXL2DPIs in MIPI/LVDS combo subsystems */
+            port@1 {
+                #address-cells = <1>;
+                #size-cells = <0>;
+                reg = <1>;
+
+                dc0_pixel_link0_mipi_lvds_0_pxl2dpi: endpoint@0 {
+                    reg = <0>;
+                    remote-endpoint = <&mipi_lvds_0_pxl2dpi_dc0_pixel_link0>;
+                };
+
+                dc0_pixel_link0_mipi_lvds_1_pxl2dpi: endpoint@1 {
+                    reg = <1>;
+                    remote-endpoint = <&mipi_lvds_1_pxl2dpi_dc0_pixel_link0>;
+                };
+            };
+
+            /* unused */
+            port@2 {
+                reg = <2>;
+            };
+
+            /* unused */
+            port@3 {
+                reg = <3>;
+            };
+
+            /* to imaging subsystem */
+            port@4 {
+                reg = <4>;
+            };
+        };
+    };
-- 
2.25.1