On Mon, Feb 17, 2025 at 04:09:10PM +0200, Svyatoslav Ryhel wrote:
> SSD2825 is a cost-effective MIPI Bridge Chip solution targeting mainly
> smartphones. It can convert 24bit RGB interface into 4-lane MIPI-DSI
> interface to drive display modules of up to 800 x 1366, while supporting
> AMOLED, a-si LCD or LTPS panel technologies for smartphone applications.
>
> Signed-off-by: Svyatoslav Ryhel <clamor95@xxxxxxxxx>
> ---
> drivers/gpu/drm/bridge/Kconfig | 14 +
> drivers/gpu/drm/bridge/Makefile | 1 +
> drivers/gpu/drm/bridge/ssd2825.c | 824 +++++++++++++++++++++++++++++++
> 3 files changed, 839 insertions(+)
> create mode 100644 drivers/gpu/drm/bridge/ssd2825.c
>
> diff --git a/drivers/gpu/drm/bridge/Kconfig b/drivers/gpu/drm/bridge/Kconfig
> index 6b4664d91faa..a6eca3aef258 100644
> --- a/drivers/gpu/drm/bridge/Kconfig
> +++ b/drivers/gpu/drm/bridge/Kconfig
> @@ -306,6 +306,20 @@ config DRM_SIMPLE_BRIDGE
> Support for non-programmable DRM bridges, such as ADI ADV7123, TI
> THS8134 and THS8135 or passive resistor ladder DACs.
>
> +config DRM_SOLOMON_SSD2825
> + tristate "SSD2825 RGB/DSI bridge"
> + depends on SPI_MASTER && OF
> + select DRM_MIPI_DSI
> + select DRM_KMS_HELPER
> + select DRM_PANEL
> + select VIDEOMODE_HELPERS
> + help
> + Say Y here if you want support for the Solomon SSD2825 RGB/DSI
> + SPI bridge driver.
> +
> + Say M here if you want to support this hardware as a module.
> + The module will be named "solomon-ssd2825".
> +
> config DRM_THINE_THC63LVD1024
> tristate "Thine THC63LVD1024 LVDS decoder bridge"
> depends on OF
> diff --git a/drivers/gpu/drm/bridge/Makefile b/drivers/gpu/drm/bridge/Makefile
> index 97304b429a53..c621ab3fa3a9 100644
> --- a/drivers/gpu/drm/bridge/Makefile
> +++ b/drivers/gpu/drm/bridge/Makefile
> @@ -23,6 +23,7 @@ obj-$(CONFIG_DRM_SIL_SII8620) += sil-sii8620.o
> obj-$(CONFIG_DRM_SII902X) += sii902x.o
> obj-$(CONFIG_DRM_SII9234) += sii9234.o
> obj-$(CONFIG_DRM_SIMPLE_BRIDGE) += simple-bridge.o
> +obj-$(CONFIG_DRM_SOLOMON_SSD2825) += ssd2825.o
> obj-$(CONFIG_DRM_THINE_THC63LVD1024) += thc63lvd1024.o
> obj-$(CONFIG_DRM_TOSHIBA_TC358762) += tc358762.o
> obj-$(CONFIG_DRM_TOSHIBA_TC358764) += tc358764.o
> diff --git a/drivers/gpu/drm/bridge/ssd2825.c b/drivers/gpu/drm/bridge/ssd2825.c
> new file mode 100644
> index 000000000000..cc6f5d480812
> --- /dev/null
> +++ b/drivers/gpu/drm/bridge/ssd2825.c
> @@ -0,0 +1,824 @@
> +// SPDX-License-Identifier: GPL-2.0
> +#include <linux/clk.h>
> +#include <linux/delay.h>
> +#include <linux/device.h>
> +#include <linux/err.h>
> +#include <linux/kernel.h>
> +#include <linux/module.h>
> +#include <linux/mod_devicetable.h>
> +#include <linux/mutex.h>
> +#include <linux/of.h>
> +#include <linux/regulator/consumer.h>
> +#include <linux/spi/spi.h>
> +
> +#include <drm/drm_atomic_helper.h>
> +#include <drm/drm_bridge.h>
> +#include <drm/drm_drv.h>
> +#include <drm/drm_mipi_dsi.h>
> +#include <drm/drm_of.h>
> +#include <drm/drm_panel.h>
> +#include <video/mipi_display.h>
> +#include <video/videomode.h>
> +
> +#define SSD2825_DEVICE_ID_REG 0xb0
> +#define SSD2825_RGB_INTERFACE_CTRL_REG_1 0xb1
> +#define SSD2825_RGB_INTERFACE_CTRL_REG_2 0xb2
> +#define SSD2825_RGB_INTERFACE_CTRL_REG_3 0xb3
> +#define SSD2825_RGB_INTERFACE_CTRL_REG_4 0xb4
> +#define SSD2825_RGB_INTERFACE_CTRL_REG_5 0xb5
> +#define SSD2825_RGB_INTERFACE_CTRL_REG_6 0xb6
> +#define SSD2825_NON_BURST_EV BIT(2)
> +#define SSD2825_BURST BIT(3)
> +#define SSD2825_PCKL_HIGH BIT(13)
> +#define SSD2825_HSYNC_HIGH BIT(14)
> +#define SSD2825_VSYNC_HIGH BIT(15)
> +#define SSD2825_CONFIGURATION_REG 0xb7
> +#define SSD2825_CONF_REG_HS BIT(0)
> +#define SSD2825_CONF_REG_CKE BIT(1)
> +#define SSD2825_CONF_REG_SLP BIT(2)
> +#define SSD2825_CONF_REG_VEN BIT(3)
> +#define SSD2825_CONF_REG_HCLK BIT(4)
> +#define SSD2825_CONF_REG_CSS BIT(5)
> +#define SSD2825_CONF_REG_DCS BIT(6)
> +#define SSD2825_CONF_REG_REN BIT(7)
> +#define SSD2825_CONF_REG_ECD BIT(8)
> +#define SSD2825_CONF_REG_EOT BIT(9)
> +#define SSD2825_CONF_REG_LPE BIT(10)
> +#define SSD2825_VC_CTRL_REG 0xb8
> +#define SSD2825_PLL_CTRL_REG 0xb9
> +#define SSD2825_PLL_CONFIGURATION_REG 0xba
> +#define SSD2825_CLOCK_CTRL_REG 0xbb
> +#define SSD2825_PACKET_SIZE_CTRL_REG_1 0xbc
> +#define SSD2825_PACKET_SIZE_CTRL_REG_2 0xbd
> +#define SSD2825_PACKET_SIZE_CTRL_REG_3 0xbe
> +#define SSD2825_PACKET_DROP_REG 0xbf
> +#define SSD2825_OPERATION_CTRL_REG 0xc0
> +#define SSD2825_MAX_RETURN_SIZE_REG 0xc1
> +#define SSD2825_RETURN_DATA_COUNT_REG 0xc2
> +#define SSD2825_ACK_RESPONSE_REG 0xc3
> +#define SSD2825_LINE_CTRL_REG 0xc4
> +#define SSD2825_INTERRUPT_CTRL_REG 0xc5
> +#define SSD2825_INTERRUPT_STATUS_REG 0xc6
> +#define SSD2825_ERROR_STATUS_REG 0xc7
> +#define SSD2825_DATA_FORMAT_REG 0xc8
> +#define SSD2825_DELAY_ADJ_REG_1 0xc9
> +#define SSD2825_DELAY_ADJ_REG_2 0xca
> +#define SSD2825_DELAY_ADJ_REG_3 0xcb
> +#define SSD2825_DELAY_ADJ_REG_4 0xcc
> +#define SSD2825_DELAY_ADJ_REG_5 0xcd
> +#define SSD2825_DELAY_ADJ_REG_6 0xce
> +#define SSD2825_HS_TX_TIMER_REG_1 0xcf
> +#define SSD2825_HS_TX_TIMER_REG_2 0xd0
> +#define SSD2825_LP_RX_TIMER_REG_1 0xd1
> +#define SSD2825_LP_RX_TIMER_REG_2 0xd2
> +#define SSD2825_TE_STATUS_REG 0xd3
> +#define SSD2825_SPI_READ_REG 0xd4
> +#define SSD2825_SPI_READ_REG_RESET 0xfa
> +#define SSD2825_PLL_LOCK_REG 0xd5
> +#define SSD2825_TEST_REG 0xd6
> +#define SSD2825_TE_COUNT_REG 0xd7
> +#define SSD2825_ANALOG_CTRL_REG_1 0xd8
> +#define SSD2825_ANALOG_CTRL_REG_2 0xd9
> +#define SSD2825_ANALOG_CTRL_REG_3 0xda
> +#define SSD2825_ANALOG_CTRL_REG_4 0xdb
> +#define SSD2825_INTERRUPT_OUT_CTRL_REG 0xdc
> +#define SSD2825_RGB_INTERFACE_CTRL_REG_7 0xdd
> +#define SSD2825_LANE_CONFIGURATION_REG 0xde
> +#define SSD2825_DELAY_ADJ_REG_7 0xdf
> +#define SSD2825_INPUT_PIN_CTRL_REG_1 0xe0
> +#define SSD2825_INPUT_PIN_CTRL_REG_2 0xe1
> +#define SSD2825_BIDIR_PIN_CTRL_REG_1 0xe2
> +#define SSD2825_BIDIR_PIN_CTRL_REG_2 0xe3
> +#define SSD2825_BIDIR_PIN_CTRL_REG_3 0xe4
> +#define SSD2825_BIDIR_PIN_CTRL_REG_4 0xe5
> +#define SSD2825_BIDIR_PIN_CTRL_REG_5 0xe6
> +#define SSD2825_BIDIR_PIN_CTRL_REG_6 0xe7
> +#define SSD2825_BIDIR_PIN_CTRL_REG_7 0xe8
> +#define SSD2825_CABC_BRIGHTNESS_CTRL_REG_1 0xe9
> +#define SSD2825_CABC_BRIGHTNESS_CTRL_REG_2 0xea
> +#define SSD2825_CABC_BRIGHTNESS_STATUS_REG 0xeb
> +#define SSD2825_READ_REG 0xff
> +
> +#define SSD2825_COM_BYTE 0x00
> +#define SSD2825_DAT_BYTE 0x01
> +
> +#define SSD2828_LP_CLOCK_DIVIDER(n) (((n) - 1) & 0x3f)
> +#define SSD2825_LP_MIN_CLK 5000 /* KHz */
> +#define SSD2825_REF_MIN_CLK 2000 /* KHz */
> +
> +static const struct regulator_bulk_data ssd2825_supplies[] = {
> + { .supply = "dvdd" },
> + { .supply = "avdd" },
> + { .supply = "vddio" },
> +};
> +
> +struct ssd2825_dsi_output {
> + struct mipi_dsi_device *dev;
> + struct drm_panel *panel;
> + struct drm_bridge *bridge;
> +};
> +
> +struct ssd2825_priv {
> + struct spi_device *spi;
> + struct device *dev;
> +
> + struct gpio_desc *reset_gpio;
> + struct regulator_bulk_data *supplies;
> +
> + struct clk *tx_clk;
> +
> + int enabled;
> +
> + struct mipi_dsi_host dsi_host;
> + struct drm_bridge bridge;
> + struct ssd2825_dsi_output output;
> +
> + struct mutex mlock; /* for host transfer operations */
> +
> + u32 pd_lines; /* number of Parallel Port Input Data Lines */
> + u32 dsi_lanes; /* number of DSI Lanes */
> +
> + /* Parameters for PLL programming */
> + u32 pll_freq_kbps; /* PLL in kbps */
> + u32 nibble_freq_khz; /* PLL div by 4 */
> +
> + u32 hzd; /* HS Zero Delay in ns*/
> + u32 hpd; /* HS Prepare Delay is ns */
> +};
> +
> +static inline struct ssd2825_priv *dsi_host_to_ssd2825(struct mipi_dsi_host
> + *host)
> +{
> + return container_of(host, struct ssd2825_priv, dsi_host);
> +}
> +
> +static inline struct ssd2825_priv *bridge_to_ssd2825(struct drm_bridge
> + *bridge)
> +{
> + return container_of(bridge, struct ssd2825_priv, bridge);
> +}
> +
> +static int ssd2825_write_raw(struct ssd2825_priv *priv, u8 high_byte, u8 low_byte)
> +{
> + struct spi_device *spi = priv->spi;
> + u8 tx_buf[2];
> +
> + /*
> + * Low byte is the value, high byte defines type of
> + * write cycle, 0 for command and 1 for data.
> + */
> + tx_buf[0] = low_byte;
> + tx_buf[1] = high_byte;
> +
> + return spi_write(spi, tx_buf, 2);
> +}
> +
> +static int ssd2825_write_reg(struct ssd2825_priv *priv, u8 reg, u16 command)
> +{
> + u8 datal = (command & 0x00FF);
> + u8 datah = (command & 0xFF00) >> 8;
> + int ret;
> +
> + /* Command write cycle */
> + ret = ssd2825_write_raw(priv, SSD2825_COM_BYTE, reg);
> + if (ret)
> + return ret;
> +
> + /* Data write cycle bits 7-0 */
> + ret = ssd2825_write_raw(priv, SSD2825_DAT_BYTE, datal);
> + if (ret)
> + return ret;
> +
> + /* Data write cycle bits 15-8 */
> + ret = ssd2825_write_raw(priv, SSD2825_DAT_BYTE, datah);
> + if (ret)
> + return ret;
> +
> + return 0;
> +}
> +
> +static int ssd2825_write_dsi(struct ssd2825_priv *priv, const u8 *command, int len)
> +{
> + int ret, i;
> +
> + ret = ssd2825_write_reg(priv, SSD2825_PACKET_SIZE_CTRL_REG_1, len);
> + if (ret)
> + return ret;
> +
> + ret = ssd2825_write_raw(priv, SSD2825_COM_BYTE, SSD2825_PACKET_DROP_REG);
> + if (ret)
> + return ret;
> +
> + for (i = 0; i < len; i++) {
> + ret = ssd2825_write_raw(priv, SSD2825_DAT_BYTE, command[i]);
> + if (ret)
> + return ret;
> + }
> +
> + return 0;
> +}
> +
> +static int ssd2825_read_raw(struct ssd2825_priv *priv, u8 cmd, u16 *data)
> +{
> + struct spi_device *spi = priv->spi;
> + struct spi_message msg;
> + struct spi_transfer xfer[2];
> + u8 tx_buf[2];
> + u8 rx_buf[2];
> + int ret;
> +
> + memset(&xfer, 0, sizeof(xfer));
> +
> + tx_buf[1] = (cmd & 0xFF00) >> 8;
> + tx_buf[0] = (cmd & 0x00FF);
> +
> + xfer[0].tx_buf = tx_buf;
> + xfer[0].bits_per_word = 9;
> + xfer[0].len = 2;
> +
> + xfer[1].rx_buf = rx_buf;
> + xfer[1].bits_per_word = 16;
> + xfer[1].len = 2;
> +
> + spi_message_init(&msg);
> + spi_message_add_tail(&xfer[0], &msg);
> + spi_message_add_tail(&xfer[1], &msg);
> +
> + ret = spi_sync(spi, &msg);
> + if (ret)
> + dev_err(&spi->dev, "spi_sync_read failed %d\n", ret);
> +
> + *data = rx_buf[1] | (rx_buf[0] << 8);
> +
> + return 0;
> +}
> +
> +static int ssd2825_read_reg(struct ssd2825_priv *priv, u8 reg, u16 *data)
> +{
> + int ret;
> +
> + /* Reset the read register */
> + ret = ssd2825_write_reg(priv, SSD2825_SPI_READ_REG, SSD2825_SPI_READ_REG_RESET);
> + if (ret)
> + return ret;
> +
> + /* Push the address to read */
> + ret = ssd2825_write_raw(priv, SSD2825_COM_BYTE, reg);
> + if (ret)
> + return ret;
> +
> + /* Perform a reading cycle */
> + ret = ssd2825_read_raw(priv, SSD2825_SPI_READ_REG_RESET, data);
> + if (ret)
> + return ret;
> +
> + return 0;
> +}
> +
> +static int ssd2825_dsi_host_attach(struct mipi_dsi_host *host,
> + struct mipi_dsi_device *dev)
> +{
> + struct ssd2825_priv *priv = dsi_host_to_ssd2825(host);
> + struct drm_bridge *bridge;
> + struct drm_panel *panel;
> + struct device_node *ep;
> + int ret;
> +
> + if (dev->lanes > 4) {
> + dev_err(priv->dev, "unsupported number of data lanes(%u)\n",
> + dev->lanes);
> + return -EINVAL;
> + }
> +
> + /*
> + * ssd2825 supports both Video and Pulse mode, but the driver only
> + * implements Video (event) mode currently
> + */
> + if (!(dev->mode_flags & MIPI_DSI_MODE_VIDEO)) {
> + dev_err(priv->dev, "Only MIPI_DSI_MODE_VIDEO is supported\n");
> + return -EOPNOTSUPP;
> + }
> +
> + ret = drm_of_find_panel_or_bridge(host->dev->of_node, 1, 0, &panel,
> + &bridge);
> + if (ret)
> + return ret;
> +
> + if (panel) {
> + bridge = drm_panel_bridge_add_typed(panel,
> + DRM_MODE_CONNECTOR_DSI);
> + if (IS_ERR(bridge))
> + return PTR_ERR(bridge);
> + }
> +
> + priv->output.dev = dev;
> + priv->output.bridge = bridge;
> + priv->output.panel = panel;
> +
> + priv->dsi_lanes = dev->lanes;
> +
> + /* get input ep (port0/endpoint0) */
> + ret = -EINVAL;
> + ep = of_graph_get_endpoint_by_regs(host->dev->of_node, 0, 0);
> + if (ep) {
> + ret = of_property_read_u32(ep, "bus-width", &priv->pd_lines);
> +
> + of_node_put(ep);
> + }
> +
> + if (ret)
> + priv->pd_lines = mipi_dsi_pixel_format_to_bpp(dev->format);
> +
> + drm_bridge_add(&priv->bridge);
> +
> + return 0;
> +}
> +
> +static int ssd2825_dsi_host_detach(struct mipi_dsi_host *host,
> + struct mipi_dsi_device *dev)
> +{
> + struct ssd2825_priv *priv = dsi_host_to_ssd2825(host);
> +
> + drm_bridge_remove(&priv->bridge);
> + if (priv->output.panel)
> + drm_panel_bridge_remove(priv->output.bridge);
> +
> + return 0;
> +}
> +
> +static ssize_t ssd2825_dsi_host_transfer(struct mipi_dsi_host *host,
> + const struct mipi_dsi_msg *msg)
> +{
> + struct ssd2825_priv *priv = dsi_host_to_ssd2825(host);
> + u8 buf = *(u8 *)msg->tx_buf;
> + u16 config;
> + int ret;
> +
> + if (!priv->enabled) {
> + dev_err(priv->dev, "Bridge is not enabled\n");
> + return -ENODEV;
> + }
Same comment as v1:
No. See include/drm/drm_mipi_dsi.h:
* Also note that those callbacks can be called no matter the state the
* host is in. Drivers that need the underlying device to be powered to
* perform these operations will first need to make sure it's been
* properly enabled.
> +
> + if (msg->rx_len) {
> + dev_warn(priv->dev, "MIPI rx is not supported\n");
> + return -EOPNOTSUPP;
> + }
> +
> + mutex_lock(&priv->mlock);
guard(mutex)(&priv->mlock); would simplify the code here.
> +
> + ret = ssd2825_read_reg(priv, SSD2825_CONFIGURATION_REG, &config);
> + if (ret)
> + goto out_unlock;
> +
> + switch (msg->type) {
> + case MIPI_DSI_DCS_SHORT_WRITE:
> + case MIPI_DSI_DCS_SHORT_WRITE_PARAM:
> + case MIPI_DSI_DCS_LONG_WRITE:
> + config |= SSD2825_CONF_REG_DCS;
> + break;
> + case MIPI_DSI_GENERIC_SHORT_WRITE_0_PARAM:
> + case MIPI_DSI_GENERIC_SHORT_WRITE_1_PARAM:
> + case MIPI_DSI_GENERIC_SHORT_WRITE_2_PARAM:
> + case MIPI_DSI_GENERIC_LONG_WRITE:
> + config &= ~SSD2825_CONF_REG_DCS;
> + break;
> + case MIPI_DSI_DCS_READ:
> + case MIPI_DSI_GENERIC_READ_REQUEST_0_PARAM:
> + case MIPI_DSI_GENERIC_READ_REQUEST_1_PARAM:
> + case MIPI_DSI_GENERIC_READ_REQUEST_2_PARAM:
> + default:
> + goto out_unlock;
> + }
> +
> + ret = ssd2825_write_reg(priv, SSD2825_CONFIGURATION_REG, config);
> + if (ret)
> + goto out_unlock;
> +
> + ret = ssd2825_write_reg(priv, SSD2825_VC_CTRL_REG, 0x0000);
> + if (ret)
> + goto out_unlock;
> +
> + ret = ssd2825_write_dsi(priv, msg->tx_buf, msg->tx_len);
> + if (ret)
> + goto out_unlock;
> +
> + if (buf == MIPI_DCS_SET_DISPLAY_ON) {
> + ssd2825_write_reg(priv, SSD2825_CONFIGURATION_REG,
> + SSD2825_CONF_REG_HS | SSD2825_CONF_REG_VEN |
> + SSD2825_CONF_REG_DCS | SSD2825_CONF_REG_ECD |
> + SSD2825_CONF_REG_EOT);
