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:   Sandor Yu <Sandor.yu@nxp.com>
To:     andrzej.hajda@intel.com, neil.armstrong@linaro.org,
        robert.foss@linaro.org, Laurent.pinchart@ideasonboard.com,
        jonas@kwiboo.se, jernej.skrabec@gmail.com, airlied@gmail.com,
        daniel@ffwll.ch, robh+dt@kernel.org,
        krzysztof.kozlowski+dt@linaro.org, shawnguo@kernel.org,
        s.hauer@pengutronix.de, festevam@gmail.com, kishon@ti.com,
        vkoul@kernel.org, dri-devel@lists.freedesktop.org,
        devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org,
        linux-kernel@vger.kernel.org, linux-phy@lists.infradead.org,
        alexander.stein@ew.tq-group.com
Cc:     kernel@pengutronix.de, linux-imx@nxp.com, Sandor.yu@nxp.com,
        oliver.brown@nxp.com
Subject: [PATCH v4 04/10] phy: Add HDMI configuration options
Date:   Mon, 21 Nov 2022 15:23:54 +0800
Message-Id: <ccbf293c5c3b3357f16bc480956d3795b66ea1cf.1669013346.git.Sandor.yu@nxp.com>
In-Reply-To: <cover.1669013346.git.Sandor.yu@nxp.com>
References: <cover.1669013346.git.Sandor.yu@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?gWTu30yDmU0y/ITpzitw0oc07QC1M3Lg62h4Qy8t/yuj8oRGGXWbh0x1VlGR?=
 =?us-ascii?Q?fb7S29J8r29FZSyzMC1KqducqrrFEPTEwqmTUwkP1MCqojXu4jsPia3DONJH?=
 =?us-ascii?Q?2J17cddbIy2T3xQsVHZjjZnnN2gJBX5AQJZX/mWpHygBrfQuTb9xygAGBFdd?=
 =?us-ascii?Q?b79692q4EIDIVakIiAg57dpasnMc8dziuj7RW+V8hNbl+IwCwBwaFAv06mAi?=
 =?us-ascii?Q?S3zefl2UeCwZ9yYhWkx/3VanMHY7Rkr42djNTmWCZxV/LX/t5bn4CBX0REWt?=
 =?us-ascii?Q?b4UNRjctuTgeSnhsU/GkGHdhrp2TcbaEVTEOogttfY+xlofl8ccFMIGrnz8J?=
 =?us-ascii?Q?H9f3hMhvpd89p6Q+0WhFJkbbfPDM/cJCTE1BF9QcnopSHUoqU3cvQfeU57e/?=
 =?us-ascii?Q?szQ+dQjOk46BxZ1C7Xn1TXcs2jQ7ibYEEZ27GKJzWQUBHRSlc4m91gSYbZqQ?=
 =?us-ascii?Q?YsGuGYXm5/P6nai5EJRiNAEnNl3X5E+7Cj+kz9Qz5tz9E+gjlffYnetuYf6j?=
 =?us-ascii?Q?pGua5dXCLJJsgq8rbqOlEZs0UGYCJDJffUfe3sYydD5ujILCBpEU6HOwJ4H0?=
 =?us-ascii?Q?1l7zFX5mSV2WPGGGz1W5ed7t/hUQK2LbrpOFT8QIR9EAjbylwbggILBnVYpR?=
 =?us-ascii?Q?FncJmWzOnksfRP7kNekmnlGNdoS+B9kOndR3H1fFbxT8m28RsYUx/aH7aS7y?=
 =?us-ascii?Q?7nMgvEfXWPkZ3in13IW6RfU1VRBqtfT5xt0QpvWI43stzqHRYmiMCSl5q4bC?=
 =?us-ascii?Q?5FxNF6ZbpSyJKMtO4MFysrbgGnILYmkywq5nTmj8mH/Z78SqI+bwPXi1YuBz?=
 =?us-ascii?Q?wln5ip+fdpFEfSkEz91werfpvd7aoT1ni5eLZNLLR1o/jhyl37USxQY29BCl?=
 =?us-ascii?Q?iYebd8kaUcVeR5XH/gdq1x2kJxQN+qUxT1/m9L+41WXaFS0QuJ6a5beLeJAW?=
 =?us-ascii?Q?qk3bmCmraY1ozEilGRFGb1P/uiwr8fDIxzmuoFA/DyukizuUihFuzhxrt/lQ?=
 =?us-ascii?Q?nGjha5eVHOsco4UBiJu+cd1yq2U473v9rImS87wfft4Sl2/euMfMYJBtn5tx?=
 =?us-ascii?Q?B5mkZpQYZpDqOw3saJutsP8XYafWTeFXI7clqvRWsxx9gegKDhXWehYs83CL?=
 =?us-ascii?Q?r7lTYVFlWu3AxliBSQ8021iy4p+q53Tg7smNznIyZtlVRHccwySR5JlBT95x?=
 =?us-ascii?Q?QlSixOX196Osdcy7jUIGtF/qRQPvkDnzNv9H//RZVJRS802JoGLJtIz6sQVr?=
 =?us-ascii?Q?o5cQC14LEUb+Y9/hSr03ldFbVRNvbTnjRTIS3mSEzldEJm5Qo56qDlhae+Qn?=
 =?us-ascii?Q?SxIMNv4cAZnVeYYnq8fXgKYGS/PwENfQqa+BQP1Rgj5EV+Q9ekzv+OEkKHio?=
 =?us-ascii?Q?p1FLKdO4Y0Xi9NGckTYZp+wNnPTnM2/mv8M/UFF/yNEtYlQWUXqV02Jp7r9F?=
 =?us-ascii?Q?E0j545OazNmtJJ1CZpXi5/r+YKIDYwSNm/uaHrVxoL9AlSBcyBSZezQKQVTk?=
 =?us-ascii?Q?ZCH826QzITbDuk0bHHJFEpWb1010GMYcfwgVBtyvsYdZHGo0vFKzovXDQB65?=
 =?us-ascii?Q?VS90+ys9ukH67TBE9dFYKjjEBEK0ZPj8HoPfFlqd?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 3b23bc6b-b50d-4702-1e5c-08dacb91d3c1
X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9448.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Nov 2022 07:27:21.2035
 (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: G4dgcpMBxL0smdCEIOcTAQqW7exWsB6J9laKeJRMsX/5fs/U9FQ2dG9KfvKopaO4MI0/aq1jlgTt83ixoXNlRA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR04MB7638
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 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

Allow HDMI PHYs to be configured through the generic
functions through a custom structure added to the generic union.

The parameters added here are based on HDMI PHY
implementation practices.  The current set of parameters
should cover the potential users.

Signed-off-by: Sandor Yu <Sandor.yu@nxp.com>
---
 include/linux/phy/phy-hdmi.h | 38 ++++++++++++++++++++++++++++++++++++
 include/linux/phy/phy.h      |  7 ++++++-
 2 files changed, 44 insertions(+), 1 deletion(-)
 create mode 100644 include/linux/phy/phy-hdmi.h

diff --git a/include/linux/phy/phy-hdmi.h b/include/linux/phy/phy-hdmi.h
new file mode 100644
index 000000000000..5765aa5bc175
--- /dev/null
+++ b/include/linux/phy/phy-hdmi.h
@@ -0,0 +1,38 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/*
+ * Copyright 2022 NXP
+ */
+
+#ifndef __PHY_HDMI_H_
+#define __PHY_HDMI_H_
+
+/**
+ * Pixel Encoding as HDMI Specification
+ * RGB, YUV422, YUV444:HDMI Specification 1.4a Section 6.5
+ * YUV420: HDMI Specification 2.a Section 7.1
+ */
+enum hdmi_phy_colorspace {
+	HDMI_PHY_COLORSPACE_RGB,        /* RGB 4:4:4 */
+	HDMI_PHY_COLORSPACE_YUV422,     /* YCbCr 4:2:2 */
+	HDMI_PHY_COLORSPACE_YUV444,     /* YCbCr 4:4:4 */
+	HDMI_PHY_COLORSPACE_YUV420,     /* YCbCr 4:2:0 */
+	HDMI_PHY_COLORSPACE_RESERVED4,
+	HDMI_PHY_COLORSPACE_RESERVED5,
+	HDMI_PHY_COLORSPACE_RESERVED6,
+};
+
+/**
+ * struct phy_configure_opts_hdmi - HDMI configuration set
+ * @pixel_clk_rate:	Pixel clock of video modes in KHz.
+ * @bpc: Maximum bits per color channel.
+ * @color_space: Colorspace in enum hdmi_phy_colorspace.
+ *
+ * This structure is used to represent the configuration state of a HDMI phy.
+ */
+struct phy_configure_opts_hdmi {
+	unsigned int pixel_clk_rate;
+	unsigned int bpc;
+	enum hdmi_phy_colorspace color_space;
+};
+
+#endif /* __PHY_HDMI_H_ */
diff --git a/include/linux/phy/phy.h b/include/linux/phy/phy.h
index b1413757fcc3..6f6873ea7270 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-hdmi.h>
 #include <linux/phy/phy-lvds.h>
 #include <linux/phy/phy-mipi-dphy.h>
 
@@ -42,7 +43,8 @@ enum phy_mode {
 	PHY_MODE_MIPI_DPHY,
 	PHY_MODE_SATA,
 	PHY_MODE_LVDS,
-	PHY_MODE_DP
+	PHY_MODE_DP,
+	PHY_MODE_HDMI,
 };
 
 enum phy_media {
@@ -60,11 +62,14 @@ enum phy_media {
  *		the DisplayPort protocol.
  * @lvds:	Configuration set applicable for phys supporting
  *		the LVDS phy mode.
+ * @hdmi:	Configuration set applicable for phys supporting
+ *		the HDMI 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;
+	struct phy_configure_opts_hdmi		hdmi;
 };
 
 /**
-- 
2.34.1