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, 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
Cc:     kernel@pengutronix.de, linux-imx@nxp.com, Sandor.yu@nxp.com,
        oliver.brown@nxp.com
Subject: [PATCH v6 4/8] phy: Add HDMI configuration options
Date:   Thu, 15 Jun 2023 09:38:14 +0800
Message-Id: <cec469206a166c4b070fd7d7bbf89a8df656ccc6.1686729444.git.Sandor.yu@nxp.com>
In-Reply-To: <cover.1686729444.git.Sandor.yu@nxp.com>
References: <cover.1686729444.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?iiPOAeojDtX18yxs4pqg57EiXsJn6+AcbCy/pNkl2EkJdVX0JbN1z+J+fTz7?=
 =?us-ascii?Q?T3jqCGxOoU9/j9SsucdTWkxw12DoA2i9cwFljyFELkDTJa14a6iEu1PD9y26?=
 =?us-ascii?Q?DgYspT6/toBhgNP9Lzd1mrUD1slvoypfsEgCmN9qfYJEkF1MCWBJnxM1+IJG?=
 =?us-ascii?Q?BIltaDi1WjHmRe5n8vNxOU3rxW6IF5YFuT2tBTgQ4tw0vqffxzBQact9U+Vy?=
 =?us-ascii?Q?gbkc0Y8dJoqNHGhCr1UNxC+737juuxUuphRJS8ial6a1iGbNDZ3Ws3Z5zMaa?=
 =?us-ascii?Q?mv9Vtcf0NFouNDWKBTwijwBFFw6LvAlDGgEsxizO10dsRrIH4P4TLg30IYpE?=
 =?us-ascii?Q?Ell2NY3pQaBO2+so5yIOK87+DzS7WPPE5rzGRNv+WfhkHrA11scoLpgTsAPY?=
 =?us-ascii?Q?2HBpKeDM6efjeTrAF615z/9QoUDyL0fVOYsQL2pTeTG3lIqeo6InpDNaCjIv?=
 =?us-ascii?Q?NOIvIpNKBJHJsodasnQ9iuQGgKFZ2mDSXfXApOunIUMzPEPe+7g6Zb1fqUtv?=
 =?us-ascii?Q?hNTGX0ZhERb08rrf+llZqfC4dqv+OuVhSSi0dni2lJv9FItPcw35y4RMoh1E?=
 =?us-ascii?Q?5bjt43rvSx79Nq05/6QTdU9bHI/48fL/wBmv3P/36c4E8KEQpD3F9bicVaiC?=
 =?us-ascii?Q?7KWo7AEwhA6A1wyWWQUA5SekBcwVDsS+gGpoiKJ+3j3s93b2V6kBU8hz3qmt?=
 =?us-ascii?Q?LI//GVc1m1RcoNNgxx/BWZU1csVwfaahlnzCjEUaRtuhpYYLpa7gSwduTN0m?=
 =?us-ascii?Q?FlBaCYrDxgz2nfEQdRVoJyS0Fmf51cZhlaj5cGQAQ/MNXpEKv4Ee4/vVzhay?=
 =?us-ascii?Q?bLOiGHtuBmwhGd+AQsGtRxZIsIsMqfU8mIfH2cYVo1Zc4M2GC7vDjP815Y3W?=
 =?us-ascii?Q?3KibGufstdenPMFyQEmhQ9k1KgrEg7CgJsM1O1PZukzjU2YoX++hvAJk78ln?=
 =?us-ascii?Q?2D9dexXGGD+vt0JRS4duqezrKZ1t4mj4BN+lOG+P6tjC6AAbAISELJhof3lQ?=
 =?us-ascii?Q?nCHkulUd1uaGsKBQ7gMEsEi+ZOROjbg0odUo3qw5Ch2F1IG83uCxng6O4VFn?=
 =?us-ascii?Q?xbaTl/NPJguSkE4xmj5RQdREiKasCecE4xjtlIDZJRnYX+BcsvlmFw+HkmOi?=
 =?us-ascii?Q?gBuz3O0Q6tberWAI4K7gwoj7z6yWWiqbtxFEdGHnReyoLw2o5iM0DWC8iRyW?=
 =?us-ascii?Q?wGqOl0csOGOy/tIBEm364QoYa5rCvrsVrkXsNOO91QTEFIAEtHjsX0EB2T2R?=
 =?us-ascii?Q?Pb33fgwfhwZ9YD+hZD1CnFrBOtnv6b+ChFcYOD4OFkKLMqw/15pmTTJETBYp?=
 =?us-ascii?Q?zHfCvrqTk83oyoAqrhvpnC0voPwG+KHRdil19i/ppKDdxS26psZeMgXrVCxD?=
 =?us-ascii?Q?P8+N21c21mT5Du3CBKcgqJyCWuxHXE5dtEaa6Fysgym5AGX/oAYWbbyWAA66?=
 =?us-ascii?Q?esSFeUZTU+U64fGD6h2rQjZOoVIE3UafJ4mITCPSYr7inwLNPC/vP7yN3Fw2?=
 =?us-ascii?Q?wNO50PaswJp7uC2MAGkFaOcCVUwjQOZyzyTu/i6slhB5scnXDiuUJkbHuVk3?=
 =?us-ascii?Q?B0cpWl0ffCG12Xy89I+5pAblvsAxDQzAR+sj1w8O?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: bf050f20-0c04-4b94-c47f-08db6d41a8af
X-MS-Exchange-CrossTenant-AuthSource: PAXPR04MB9448.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jun 2023 01:41:37.5272
 (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: N5HJRXUNLv+aKOR/DcCu66BzGKeAmqjX3UUctI0QXYzIg4CKa2mcxfzA7H7SUh5gwR//jmHyLGiZiWVx58eCcw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM8PR04MB8034
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

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 3a570bc59fc7..93d77d45b1d4 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