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:     linux-kernel@vger.kernel.org, devicetree@vger.kernel.org,
        dri-devel@lists.freedesktop.org,
        linux-arm-kernel@lists.infradead.org
Cc:     kishon@ti.com, vkoul@kernel.org, robh+dt@kernel.org,
        a.hajda@samsung.com, narmstrong@baylibre.com,
        Laurent.pinchart@ideasonboard.com, jonas@kwiboo.se,
        jernej.skrabec@siol.net, airlied@linux.ie, daniel@ffwll.ch,
        shawnguo@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de,
        festevam@gmail.com, linux-imx@nxp.com, agx@sigxcpu.org,
        robert.chiras@nxp.com, martin.kepplinger@puri.sm,
        robert.foss@linaro.org
Subject: [PATCH v6 2/5] phy: Add LVDS configuration options
Date:   Sat,  2 Apr 2022 12:03:22 +0800
Message-Id: <20220402040325.2465222-3-victor.liu@nxp.com>
In-Reply-To: <20220402040325.2465222-1-victor.liu@nxp.com>
References: <20220402040325.2465222-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?71RD+7bDpNHAOzAKKkLSog1YUNnqBZRyG0sTWArQ7/T6+mgNUsrK/JE6jAFY?=
 =?us-ascii?Q?FJYvjHsYjy1juPpZVTfI/2qGtpEJJycWnxy7Gj8yVk9/0neTf/jzkAQPbS4t?=
 =?us-ascii?Q?ZBk++dRGnlJUwq0wfoB2L1uptqM/VvsL3XvA9nbGSfiw8E71L8+BW/pwMvPp?=
 =?us-ascii?Q?cYTQ1m56ZEKkot2kwZJ+i/UpeIYUIODIuk08+/gCFFs4Hlc0GXF0738Vn6kt?=
 =?us-ascii?Q?YSoOyMm7/w4PSmW6dlmJYYkhoe5y1P5RkcoClf9sPH/gDvHHiKuJvLJj4Iks?=
 =?us-ascii?Q?0CupEvLf7mbdTUT6SvT+ysYoZvSU9Q917wd2SBKYqAziwe6jVEy9D50jat2O?=
 =?us-ascii?Q?QkoBHQhbZo644zC8yRf7YeO0yLHoh1n7g3XiKih6Xbg79VAlVWiSeY6zsWNr?=
 =?us-ascii?Q?8xpih5ESwOlH1U1TkP3u2TI+EuW04zI6+a4kTDXe4TlAfmfDosJzDIIcfjSa?=
 =?us-ascii?Q?apbgdz6nKhQY9CzgnjwSvg3kgP2Rfx0IOf07wz84cYQlzMAhNpMZjdk1ZqQv?=
 =?us-ascii?Q?Maqo4DcxJnCCP47wp9lWEQBHpYSF00UFVuAVVuEpDQLzUGV2SkxmgLWHCmGl?=
 =?us-ascii?Q?YEMFYuANhgezEbSDCc1+FPhq071BjVSFr57FfJHwc1VkWFqLBXV7k3PKPp22?=
 =?us-ascii?Q?r8jnK8toxZJDLLEbv8FCandL2nhKdsRFg2BNEa1e5spEI9PQjtoTnFmWGP0h?=
 =?us-ascii?Q?IVDJZzLjw7WWXalDfuBbB7Mz61g+pqgsgbFnTcpK5q9e36PDXOqHard9oPac?=
 =?us-ascii?Q?WJS/TTaAQMjHiV9hDfuo2doVm5RJuZp5CDmGhnsgpZyyS/f7PmNOcxMZShXw?=
 =?us-ascii?Q?gQu7lcHgZQYYPM1ZAn7Hd/gwqC+rzED1SmzZK4b44gqulAmQCrDPB3rJo6Ou?=
 =?us-ascii?Q?rKHRoMHUUxpqPH74wsKyLff/1HfOhCpKpX/klLW+ZygOqlpBU5EFuAQJtQOm?=
 =?us-ascii?Q?ZXGnLMdD7x8vYWqLsXJajMWHHLR4RiItguyHgtXZv4mcsgkJNrLuFV6Qmcs7?=
 =?us-ascii?Q?jlLup1+rdbQp2ISvjaB8t7oU1L6ZSzr9GcaNrYIPD92i2UlJc8wwtXFImJeL?=
 =?us-ascii?Q?KYpUL/9PBujMJe2fsKOuHafpj9zZbuxYxGvHauJffc56ULYjJsmtY5BljCok?=
 =?us-ascii?Q?6BMOAePhzpx6rajmKT+NJUGW855QcVStlH2i3XPHlIx6cwl5+SNxYcsBVqOF?=
 =?us-ascii?Q?u/G+v6agVyGcG6wZLAzRh/kdiuUe/6McLPBe5q9PTBR6o6Axjc16Hsz9UCbl?=
 =?us-ascii?Q?LVrttzrwdlBcUfePAJtVPvQaWg2g5KT8zyuMjup+UgeASuV7KHrZoPUGbYcC?=
 =?us-ascii?Q?QU0biCkgzfULkuwZPtXrrWvUchLWdnXatI75F7zjyqVEBurpDt07mSHKha07?=
 =?us-ascii?Q?RIwzZvAerXj78Raw/FHq1GaR1CYlMsD/hqNVi87pql1x2y6HMPi6WVlTCCjj?=
 =?us-ascii?Q?LulVbuvjFSf5hqkiVYKDo99ehd9ospoLfAhm+N81ie5l5tKXo+ZIcPQeP8yD?=
 =?us-ascii?Q?CZdkFcnV0ihQGVBeoRWdvgZ7UfAJjxy3Hiz+OcSmSTa4Elg49Czwmxew0GoH?=
 =?us-ascii?Q?gW66uuuSPUXiKxZAkpLO8U35FKbMIWIM+FvQIQga84tChwWGZpz2wwa82D+Y?=
 =?us-ascii?Q?46mVnuRKN8ATOWKV6WCbRzGS4eFSGKu4fX1BfANFuA/OK+GW63hXpCPmMAa2?=
 =?us-ascii?Q?/x94ahgojewEJzKG9hpkdyLBlq7jPazP0PhyPdcWOJghejO79PHPfiYbDAD2?=
 =?us-ascii?Q?MXvwwlOtsg=3D=3D?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 3434764e-ac0e-4fc5-091a-08da145d8e46
X-MS-Exchange-CrossTenant-AuthSource: AM7PR04MB7046.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Apr 2022 04:02:08.0782
 (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: g9QTPly80UCZjB4BS2wAz57X6Ltk5LjOLBGsX/xNi8Wpjx1KI2cdV9IQ1oi5BUU97E3QwqhaZNkq6buiwB8I8w==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR04MB3210
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_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 allows LVDS PHYs to be configured through
the generic functions and through a custom structure
added to the generic union.

The parameters added here are based on common LVDS PHY
implementation practices.  The set of parameters
should cover all potential users.

Cc: Kishon Vijay Abraham I <kishon@ti.com>
Cc: Vinod Koul <vkoul@kernel.org>
Cc: NXP Linux Team <linux-imx@nxp.com>
Signed-off-by: Liu Ying <victor.liu@nxp.com>
---
v5->v6:
* Rebase upon v5.17-rc1.

v4->v5:
* Align kernel-doc style to include/linux/phy/phy.h. (Vinod)
* Trivial tweaks.
* Drop Robert's R-b tag.

v3->v4:
* Add Robert's R-b tag.

v2->v3:
* No change.

v1->v2:
* No change.

 include/linux/phy/phy-lvds.h | 32 ++++++++++++++++++++++++++++++++
 include/linux/phy/phy.h      |  4 ++++
 2 files changed, 36 insertions(+)
 create mode 100644 include/linux/phy/phy-lvds.h

diff --git a/include/linux/phy/phy-lvds.h b/include/linux/phy/phy-lvds.h
new file mode 100644
index 000000000000..7a2f4747f624
--- /dev/null
+++ b/include/linux/phy/phy-lvds.h
@@ -0,0 +1,32 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Copyright 2020 NXP
+ */
+
+#ifndef __PHY_LVDS_H_
+#define __PHY_LVDS_H_
+
+/**
+ * struct phy_configure_opts_lvds - LVDS configuration set
+ * @bits_per_lane_and_dclk_cycle:	Number of bits per data lane and
+ *					differential clock cycle.
+ * @differential_clk_rate:		Clock rate, in Hertz, of the LVDS
+ *					differential clock.
+ * @lanes:				Number of active, consecutive,
+ *					data lanes, starting from lane 0,
+ *					used for the transmissions.
+ * @is_slave:				Boolean, true if the phy is a slave
+ *					which works together with a master
+ *					phy to support dual link transmission,
+ *					otherwise a regular phy or a master phy.
+ *
+ * This structure is used to represent the configuration state of a LVDS phy.
+ */
+struct phy_configure_opts_lvds {
+	unsigned int	bits_per_lane_and_dclk_cycle;
+	unsigned long	differential_clk_rate;
+	unsigned int	lanes;
+	bool		is_slave;
+};
+
+#endif /* __PHY_LVDS_H_ */
diff --git a/include/linux/phy/phy.h b/include/linux/phy/phy.h
index f3286f4cd306..b1413757fcc3 100644
--- a/include/linux/phy/phy.h
+++ b/include/linux/phy/phy.h
@@ -17,6 +17,7 @@
 #include <linux/regulator/consumer.h>
 
 #include <linux/phy/phy-dp.h>
+#include <linux/phy/phy-lvds.h>
 #include <linux/phy/phy-mipi-dphy.h>
 
 struct phy;
@@ -57,10 +58,13 @@ enum phy_media {
  *		the MIPI_DPHY phy mode.
  * @dp:		Configuration set applicable for phys supporting
  *		the DisplayPort protocol.
+ * @lvds:	Configuration set applicable for phys supporting
+ *		the LVDS phy mode.
  */
 union phy_configure_opts {
 	struct phy_configure_opts_mipi_dphy	mipi_dphy;
 	struct phy_configure_opts_dp		dp;
+	struct phy_configure_opts_lvds		lvds;
 };
 
 /**
-- 
2.25.1