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 v8 00/14] Add some DRM bridge drivers support for i.MX8qm/qxp SoCs
Date:   Thu,  9 Jun 2022 14:49:17 +0800
Message-Id: <20220609064931.3068601-1-victor.liu@nxp.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?QkNrbGdKdmVWdnRqSldac1hmb0pMaTltWm9vWk12U2Y1bElkM2p3aWRVWG52?=
 =?utf-8?B?ZUpDUEZ6WEJDZWp5clpDbnNac3lhcHVRbmV2Rlhoc0MwbVdRbjFrWWpaZjlJ?=
 =?utf-8?B?ZXhwNkNkL205anJLdzlqaU8rcEhlcDZyMGNpeUJNSjBWcjJaMXFhUkFoRkpF?=
 =?utf-8?B?b2xyTDc4WlVsVHIxekxYeUMvQXBpQUpMZkJETW9GckNneU5KTVpHWEFBMS8y?=
 =?utf-8?B?K1g4RUJqZEpuRXVPWVlwdGs2aVU2YlBzTXNmdUh2UGlpZ1JCVjZuQm13U1dS?=
 =?utf-8?B?MUxJdzZyMUVHYldDMlFRdWdxMzIwYUxmRVdPeVptOE5uZXdWUk1sdkVVQklB?=
 =?utf-8?B?Lzh0cHB2eEtIYnJZNE5JVWYvcmNGalhwNXAvckJkekE5WE9vdmNpMk9wTW05?=
 =?utf-8?B?MmJpYWEwNWdkM3A4OTN6NmVKc0R1dFJ3OUM0ajZUWjU0WVhwWlc4MlJSYk1Q?=
 =?utf-8?B?dXpjU1p1bWtFK0F6QnJDeS80ZHdTN0pjV0JsZ3VaN1VDK1p6SkJYS0hqNzEr?=
 =?utf-8?B?OGVVSUNqeFVDQVlwc0JWRTJ5R0RnTUtmVzlWVmZ3ek5JY2c5NkYxYzAzVlZS?=
 =?utf-8?B?Q2pDV2tMQlBDeCtORU1HTitrNVlCMkdKU0NWbHJLcmlMdkRTN3ZUaFI2QkdF?=
 =?utf-8?B?N2ZleTE0Q2JrS1RSR3o4Kzd1YWtuSEtOK1FWb2V1cy8wbkVVYTFvODNubHUw?=
 =?utf-8?B?Uld3dzZ2OHIvY21ZT1dCOGQrTkhQT2czdytwYVVNSHpTeDYrVHc5R3hoYlYr?=
 =?utf-8?B?dm1JT1NLcVFEazJ0TDNIVXgwemhJMTcxQVM4N0QrRmUybUx2bHJVbmZoVlZ6?=
 =?utf-8?B?Y1J2VjZIZk1mR0dyM2w2RzlwV2dyeGJ2SGVjSkhqczNtMUVFamMyS0JxSGlW?=
 =?utf-8?B?bDBLQ0s1dyt6RDJXcTNYTWFibE1Id0l0TCtKRVMzNDNnSCtXZ21Za0p3d21O?=
 =?utf-8?B?b1kxT0Q0UEVIWkc5NU1XY1hVMjdzdTEwTUJmbEtZcmFGa0FwWkJnQnBtNGM0?=
 =?utf-8?B?TEhXcytTd0Z2T3kvcmQ5aEpwYmhqcnVoa1VsTWNsb21JZ05URHBxV0VLTnBi?=
 =?utf-8?B?VGw1dGliN25jS250V1pqR3dHNEtVTWg1QlJkRzZoc2o0dHpqem16M0kvbGV5?=
 =?utf-8?B?WHdURGljMUN5Z2hvRzJLOC9za3hRcFhnQ1I4SDQ0WitMMGJ2cmpVWks3dVFJ?=
 =?utf-8?B?Zmt0ekJmRittNWtiV2tHNCsrMnMrZThKUHpPRjA1dG5vYko0bmUrbkU4UVlw?=
 =?utf-8?B?bUx6Um8zTU44bE9Ga25iNlhyV25sdTVRT013NzdncGlZcnZqaHhKOHZGcC93?=
 =?utf-8?B?a3pYZTM3d3dQUVZ4bVlSajlaMHJNTUQ1Q1pQZXh3T25MR2gxVlQzOWlFUmdz?=
 =?utf-8?B?dklScnVjV3dOYWpZV1FzVmpKYklTNEJoZytEaEZkSHF1RjZqNXFGU2JCZ01l?=
 =?utf-8?B?V2hhTStWTlJhaGZ5UkNxa1liRmx4Y3QxemMxWnFwaFRSb2R5bjRwSnlNbm9L?=
 =?utf-8?B?a05UcnI4N1ltbTVBaDJ4b0ZLQTNOWmJTT3daaU9LVGQwbnJYTWhxbEFkdlla?=
 =?utf-8?B?aVZHSi9DaDI0U3Z5bnIyQWtNenR5OG9lOWhVc3Q0VTZ2RytvR1pGNmxmOTB6?=
 =?utf-8?B?OXIrMEpuZTZucHdkbEVoTlQ4SnlXdHByT1B4M1Y4MnZMam5KZVpuWGhxYy8x?=
 =?utf-8?B?ODdrR29yblRZREdlaE8wWnJldGREdjJJS25jK3JUQzBsZ21yekpFci9uTEdR?=
 =?utf-8?B?MldBeE1QemlzOWFrWFdsQkNsYllBazZXWTgwMHVKNktmcEtPQ2pRUWZmTTZl?=
 =?utf-8?B?Zk1NUWdKTGhwSS9qazJWZjNSWStTdFpURXQ4UTBCNXBEd1ZyV3lIUjI3THRW?=
 =?utf-8?B?eE1kY2V0Q0V2aGNYTm9YbjM2eVlmMzZRaHhGZ1VnUzYvNDlGd3dWSTFsS3kx?=
 =?utf-8?B?VTRlZHZOTmptZTJoa203MVBZbTl0emRQc1RjY1FNTXpVeFZjN001RmNWQWx5?=
 =?utf-8?B?c1FJWDNQWlAxRUhUcHBoVFUweWlEcmdjUnFwck56Vm1WVGxRa3FkcGU0NWE4?=
 =?utf-8?B?OGdEL3JrVWhxNmxsZVErdXFFaVlVK1JjYndDYlJJT1g5bElzZU9KTUVMRDhY?=
 =?utf-8?B?ZkpwbTBxVkhuN21oWlhmWnkxZm84YnZSSk50eTdmMHZIUEVaUUkyYnJ5K3BK?=
 =?utf-8?B?cG54dFRiUjRYY0ZZcmRUclJ1R1hUV2ZPTUNVZ25qdGl6Z3FoVklkZHNBTFRi?=
 =?utf-8?B?ZGtMdE1QS3pURHlXajhKdzZLTEZWVnd5TUc4aTJlVGFTMzNaODVGZVZyR2Vj?=
 =?utf-8?B?TWptLy9TeGY2ZmJSZjBKVjVrbzRXOG9lZk5WSHJ0eFVqNG45NUF4UT09?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 2695af9e-7389-491c-4a5c-08da49e400a4
X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Jun 2022 06:48:04.1609
 (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: ePkJ2gsQse8Bp15ADiC6wRQ/jtqi3ocsSzrfA0HD18NLl+8dea/nmzFTATptXbdAhlnAIA72oGsTcMhEakG99Q==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR04MB4041
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,
        URIBL_BLOCKED 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

Hi,

This is the v8 series to add some DRM bridge drivers support
for i.MX8qm/qxp SoCs.

The bridges may chain one by one to form display pipes to support
LVDS displays.  The relevant display controller is DPU embedded in
i.MX8qm/qxp SoCs.

The DPU KMS driver can be found at:
https://patchwork.kernel.org/project/dri-devel/list/?series=629908&state=%2A&archive=both

This series supports the following display pipes:
1) i.MX8qxp:
prefetch eng -> DPU -> pixel combiner -> pixel link ->
pixel link to DPI(PXL2DPI) -> LVDS display bridge(LDB)

2) i.MX8qm:
prefetch eng -> DPU -> pixel combiner -> pixel link -> LVDS display bridge(LDB)


Patch 1/14 and 2/14 add bus formats used by pixel combiner.

Patch 9/14 adds a helper for LDB bridge drivers.

Patch 3/14 ~ 8/14 and 10/14 ~ 12/14 add drm bridge drivers and
dt-bindings support for the bridges.

Patch 13/14 adds dt-binding for Control and Status Registers module(a syscon
used by PXL2DPI and LDB), which references the PXL2DPI and LDB schemas.

Patch 14/14 updates MAINTAINERS.


I've tested this series with a koe,tx26d202vm0bwa dual link LVDS panel and
a LVDS to HDMI bridge(with a downstream drm bridge driver).

Marcel Ziswiler has tested v6 with two LVDS panels(single link LT170410-2WHC
and dual link LP156WF1) on Toradex Colibri iMX8X.


Welcome comments, thanks.


v7->v8:
* Rebase upon v5.19-rc1.
* Use devm_drm_of_get_bridge() in patch 9/14 due to the rebase.
* Reorder the patch for adding dt-binding for Control and Status Registers
  module as patch 13/14, as it references PXL2DPI and LDB schemas in this
  series.

v6->v7:
* Fix complaints from 'checkpatch.pl --strict' on the LDB DRM bridge helper
  driver(patch 10/14) and some DRM bridge drivers(patch 9/14, 12/14 and 13/14).
  (Robert)
* Fix complaints from 'checkpatch --strict' on the rest DRM bridge
  drivers(patch 4/14 and 6/14).
* A trivial indentation fix for patch 9/14. (Robert)
* Add Robert's R-b tags on patch 9/14, 10/14, 12/14, 13/14 and 14/14.
* Add Marcel's T-b tags on all DRM bridge drivers.
* Add Rob's R-b tag on patch 7/14 for CSR module dt-binding.

v5->v6:
* Fix data organizations in documentation(patch 2/14) for
  MEDIA_BUS_FMT_RGB{666,888}_1X30-CPADLO. (Laurent)
* Add Laurent's R-b tags on patch 1/14 and 2/14.
* Drop 'select' schema from the CSR dt-binding documentation(patch 7/14). (Rob)
* Add Rob's R-b tag on patch 8/14.

v4->v5:
* Drop the patch 'phy: Add LVDS configuration options'. (Robert)
* Add Robert's R-b tags on patch 1/14, 2/14, 4/14 and 6/14.
* Drop the 'PC_BUF_PARA_REG' register definition from the pixel combiner bridge
  driver(patch 4/14). (Robert)
* Make a comment occupy a line in the pixel link bridge driver(patch 6/14).
  (Robert)
* Introduce a new patch(patch 7/14) to add dt-binding for Control and Status
  Registers module. (Rob)
* Make imx-ldb-helper be a pure object to be linked with i.MX8qxp LDB bridge
  driver and i.MX8qm LDB bridge driver, instead of a module.  Correspondingly,
  rename 'imx8{qm, qxp}-ldb.c' to 'imx8{qm, qxp}-ldb-drv.c'. (Robert)
* Move 'imx_ldb_helper.h' to 'drivers/gpu/drm/bridge/imx/imx-ldb-helper.h'.
  (Robert)
* s/__FSL_IMX_LDB__/__IMX_LDB_HELPER__/  for 'imx-ldb-helper.h'.

v3->v4:
* Use 'fsl,sc-resource' DT property to get the SCU resource ID associated with
  the PXL2DPI instance instead of using alias ID. (Rob)
* Add Rob's R-b tag on patch 11/14.

v2->v3:
* Drop 'fsl,syscon' DT properties from fsl,imx8qxp-ldb.yaml and
  fsl,imx8qxp-pxl2dpi.yaml. (Rob)
* Mention the CSR module controls LDB and PXL2DPI in fsl,imx8qxp-ldb.yaml and
  fsl,imx8qxp-pxl2dpi.yaml.
* Call syscon_node_to_regmap() to get regmaps from LDB bridge helper driver
  and PXL2DPI bridger driver instead of syscon_regmap_lookup_by_phandle().
* Drop two macros from pixel link bridge driver which help define functions
  and define them directly.
* Properly disable all pixel link controls to POR value by calling
  imx8qxp_pixel_link_disable_all_controls() from
  imx8qxp_pixel_link_bridge_probe().
* Add Rob's R-b tags on patch 4/14 and 6/14.

v1->v2:
* Rebase the series upon the latest drm-misc-next branch(5.11-rc2 based).
* Use graph schema in the dt-bindings of the bridges. (Laurent)
* Require all four pixel link output ports in fsl,imx8qxp-pixel-link.yaml.
  (Laurent)
* Side note i.MX8qm/qxp LDB official name 'pixel mapper' in fsl,imx8qxp-ldb.yaml.
  (Laurent)
* Mention pixel link is accessed via SCU firmware in fsl,imx8qxp-pixel-link.yaml.
  (Rob)
* Use enum instead of oneOf + const for the reg property of pixel combiner
  channels in fsl,imx8qxp-pixel-combiner.yaml. (Rob)
* Rewrite the function to find the next bridge in pixel link bridge driver
  by properly using OF APIs and dropping unnecessary DT validation. (Rob)
* Drop unnecessary port availability check in i.MX8qxp pixel link to DPI
  bridge driver.
* Drop unnecessary DT validation from i.MX8qxp LDB bridge driver.
* Use of_graph_get_endpoint_by_regs() and of_graph_get_remote_endpoint() to
  get the input remote endpoint in imx8qxp_ldb_set_di_id() of i.MX8qxp LDB
  bridge driver.
* Avoid using companion_port OF node after putting it in
  imx8qxp_ldb_parse_dt_companion() of i.MX8qxp LDB bridge driver.
* Drop unnecessary check for maximum available LDB channels from
  i.MX8qm LDB bridge driver.
* Mention i.MX8qm/qxp LDB official name 'pixel mapper' in i.MX8qm/qxp LDB
  bridge drivers and Kconfig help messages.

Liu Ying (14):
  media: uapi: Add some RGB bus formats for i.MX8qm/qxp pixel combiner
  media: docs: Add some RGB bus formats for i.MX8qm/qxp pixel combiner
  dt-bindings: display: bridge: Add i.MX8qm/qxp pixel combiner binding
  drm/bridge: imx: Add i.MX8qm/qxp pixel combiner support
  dt-bindings: display: bridge: Add i.MX8qm/qxp display pixel link
    binding
  drm/bridge: imx: Add i.MX8qm/qxp display pixel link support
  dt-bindings: display: bridge: Add i.MX8qxp pixel link to DPI binding
  drm/bridge: imx: Add i.MX8qxp pixel link to DPI support
  drm/bridge: imx: Add LDB driver helper support
  dt-bindings: display: bridge: Add i.MX8qm/qxp LVDS display bridge
    binding
  drm/bridge: imx: Add LDB support for i.MX8qxp
  drm/bridge: imx: Add LDB support for i.MX8qm
  dt-bindings: mfd: Add i.MX8qm/qxp Control and Status Registers module
    binding
  MAINTAINERS: add maintainer for DRM bridge drivers for i.MX SoCs

 .../display/bridge/fsl,imx8qxp-ldb.yaml       | 173 +++++
 .../bridge/fsl,imx8qxp-pixel-combiner.yaml    | 144 ++++
 .../bridge/fsl,imx8qxp-pixel-link.yaml        | 106 +++
 .../display/bridge/fsl,imx8qxp-pxl2dpi.yaml   | 108 +++
 .../bindings/mfd/fsl,imx8qxp-csr.yaml         | 192 +++++
 .../media/v4l/subdev-formats.rst              | 156 ++++
 MAINTAINERS                                   |  10 +
 drivers/gpu/drm/bridge/Kconfig                |   2 +
 drivers/gpu/drm/bridge/Makefile               |   1 +
 drivers/gpu/drm/bridge/imx/Kconfig            |  42 +
 drivers/gpu/drm/bridge/imx/Makefile           |   9 +
 drivers/gpu/drm/bridge/imx/imx-ldb-helper.c   | 220 ++++++
 drivers/gpu/drm/bridge/imx/imx-ldb-helper.h   |  96 +++
 drivers/gpu/drm/bridge/imx/imx8qm-ldb-drv.c   | 587 ++++++++++++++
 drivers/gpu/drm/bridge/imx/imx8qxp-ldb-drv.c  | 722 ++++++++++++++++++
 .../drm/bridge/imx/imx8qxp-pixel-combiner.c   | 448 +++++++++++
 .../gpu/drm/bridge/imx/imx8qxp-pixel-link.c   | 429 +++++++++++
 drivers/gpu/drm/bridge/imx/imx8qxp-pxl2dpi.c  | 487 ++++++++++++
 include/uapi/linux/media-bus-format.h         |   6 +-
 19 files changed, 3937 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-ldb.yaml
 create mode 100644 Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-pixel-combiner.yaml
 create mode 100644 Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-pixel-link.yaml
 create mode 100644 Documentation/devicetree/bindings/display/bridge/fsl,imx8qxp-pxl2dpi.yaml
 create mode 100644 Documentation/devicetree/bindings/mfd/fsl,imx8qxp-csr.yaml
 create mode 100644 drivers/gpu/drm/bridge/imx/Kconfig
 create mode 100644 drivers/gpu/drm/bridge/imx/Makefile
 create mode 100644 drivers/gpu/drm/bridge/imx/imx-ldb-helper.c
 create mode 100644 drivers/gpu/drm/bridge/imx/imx-ldb-helper.h
 create mode 100644 drivers/gpu/drm/bridge/imx/imx8qm-ldb-drv.c
 create mode 100644 drivers/gpu/drm/bridge/imx/imx8qxp-ldb-drv.c
 create mode 100644 drivers/gpu/drm/bridge/imx/imx8qxp-pixel-combiner.c
 create mode 100644 drivers/gpu/drm/bridge/imx/imx8qxp-pixel-link.c
 create mode 100644 drivers/gpu/drm/bridge/imx/imx8qxp-pxl2dpi.c

-- 
2.25.1