root/drivers/gpu/drm/panel/panel-novatek-nt35950.c
// SPDX-License-Identifier: GPL-2.0-only
/*
 * Novatek NT35950 DriverIC panels driver
 *
 * Copyright (c) 2021 AngeloGioacchino Del Regno
 *                    <angelogioacchino.delregno@somainline.org>
 */
#include <linux/delay.h>
#include <linux/gpio/consumer.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/of_graph.h>
#include <linux/regulator/consumer.h>

#include <drm/drm_connector.h>
#include <drm/drm_crtc.h>
#include <drm/drm_mipi_dsi.h>
#include <drm/drm_modes.h>
#include <drm/drm_panel.h>

#define MCS_CMD_MAUCCTR                 0xf0 /* Manufacturer command enable */
#define MCS_PARAM_SCALER_FUNCTION       0x58 /* Scale-up function */
#define MCS_PARAM_SCALEUP_MODE          0xc9
 #define MCS_SCALEUP_SIMPLE             0x0
 #define MCS_SCALEUP_BILINEAR           BIT(0)
 #define MCS_SCALEUP_DUPLICATE          (BIT(0) | BIT(4))

/* VESA Display Stream Compression param */
#define MCS_PARAM_VESA_DSC_ON           0x03

/* Data Compression mode */
#define MCS_PARAM_DATA_COMPRESSION      0x90
 #define MCS_DATA_COMPRESSION_NONE      0x00
 #define MCS_DATA_COMPRESSION_FBC       0x02
 #define MCS_DATA_COMPRESSION_DSC       0x03

/* Display Output control */
#define MCS_PARAM_DISP_OUTPUT_CTRL      0xb4
 #define MCS_DISP_OUT_SRAM_EN           BIT(0)
 #define MCS_DISP_OUT_VIDEO_MODE        BIT(4)

/* VESA Display Stream Compression setting */
#define MCS_PARAM_VESA_DSC_SETTING      0xc0

/* SubPixel Rendering (SPR) */
#define MCS_PARAM_SPR_EN                0xe3
#define MCS_PARAM_SPR_MODE              0xef
 #define MCS_SPR_MODE_YYG_RAINBOW_RGB   0x01

#define NT35950_VREG_MAX                4

struct nt35950 {
        struct drm_panel panel;
        struct drm_connector *connector;
        struct mipi_dsi_device *dsi[2];
        struct regulator_bulk_data vregs[NT35950_VREG_MAX];
        struct gpio_desc *reset_gpio;
        const struct nt35950_panel_desc *desc;

        int cur_mode;
        u8 last_page;
};

struct nt35950_panel_mode {
        const struct drm_display_mode mode;

        bool enable_sram;
        bool is_video_mode;
        u8 scaler_on;
        u8 scaler_mode;
        u8 compression;
        u8 spr_en;
        u8 spr_mode;
};

struct nt35950_panel_desc {
        const char *model_name;
        const struct mipi_dsi_device_info dsi_info;
        const struct nt35950_panel_mode *mode_data;

        bool is_dual_dsi;
        u8 num_lanes;
        u8 num_modes;
};

static inline struct nt35950 *to_nt35950(struct drm_panel *panel)
{
        return container_of(panel, struct nt35950, panel);
}

static void nt35950_reset(struct nt35950 *nt)
{
        gpiod_set_value_cansleep(nt->reset_gpio, 1);
        usleep_range(12000, 13000);
        gpiod_set_value_cansleep(nt->reset_gpio, 0);
        usleep_range(300, 400);
        gpiod_set_value_cansleep(nt->reset_gpio, 1);
        usleep_range(12000, 13000);
}

/*
 * nt35950_set_cmd2_page - Select manufacturer control (CMD2) page
 * @dsi_ctx: context for mipi_dsi functions
 * @nt:   Main driver structure
 * @page: Page number (0-7)
 */
static void nt35950_set_cmd2_page(struct mipi_dsi_multi_context *dsi_ctx,
                                  struct nt35950 *nt, u8 page)
{
        const u8 mauc_cmd2_page[] = { MCS_CMD_MAUCCTR, 0x55, 0xaa, 0x52,
                                      0x08, page };

        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, mauc_cmd2_page,
                                        ARRAY_SIZE(mauc_cmd2_page));
        if (!dsi_ctx->accum_err)
                nt->last_page = page;
}

/*
 * nt35950_set_data_compression - Set data compression mode
 * @dsi_ctx: context for mipi_dsi functions
 * @nt:        Main driver structure
 * @comp_mode: Compression mode
 */
static void nt35950_set_data_compression(struct mipi_dsi_multi_context *dsi_ctx,
                                         struct nt35950 *nt, u8 comp_mode)
{
        u8 cmd_data_compression[] = { MCS_PARAM_DATA_COMPRESSION, comp_mode };
        u8 cmd_vesa_dsc_on[] = { MCS_PARAM_VESA_DSC_ON, !!comp_mode };
        u8 cmd_vesa_dsc_setting[] = { MCS_PARAM_VESA_DSC_SETTING, 0x03 };
        u8 last_page = nt->last_page;

        /* Set CMD2 Page 0 if we're not there yet */
        if (last_page != 0)
                nt35950_set_cmd2_page(dsi_ctx, nt, 0);

        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_data_compression,
                                        ARRAY_SIZE(cmd_data_compression));
        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_vesa_dsc_on,
                                        ARRAY_SIZE(cmd_vesa_dsc_on));

        /* Set the vesa dsc setting on Page 4 */
        nt35950_set_cmd2_page(dsi_ctx, nt, 4);

        /* Display Stream Compression setting, always 0x03 */
        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_vesa_dsc_setting,
                                        ARRAY_SIZE(cmd_vesa_dsc_setting));

        /* Get back to the previously set page */
        nt35950_set_cmd2_page(dsi_ctx, nt, last_page);
}

/*
 * nt35950_set_scaler - Enable/disable resolution upscaling
 * @dsi_ctx: context for mipi_dsi functions
 * @scale_up:  Scale up function control
 */
static void nt35950_set_scaler(struct mipi_dsi_multi_context *dsi_ctx,
                               u8 scale_up)
{
        u8 cmd_scaler[] = { MCS_PARAM_SCALER_FUNCTION, scale_up };

        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_scaler,
                                        ARRAY_SIZE(cmd_scaler));
}

/*
 * nt35950_set_scale_mode - Resolution upscaling mode
 * @dsi_ctx: context for mipi_dsi functions
 * @mode: Scaler mode (MCS_DATA_COMPRESSION_*)
 */
static void nt35950_set_scale_mode(struct mipi_dsi_multi_context *dsi_ctx,
                                   u8 mode)
{
        u8 cmd_scaler[] = { MCS_PARAM_SCALEUP_MODE, mode };

        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_scaler,
                                        ARRAY_SIZE(cmd_scaler));
}

/*
 * nt35950_inject_black_image - Display a completely black image
 * @dsi_ctx: context for mipi_dsi functions
 *
 * After IC setup, the attached panel may show random data
 * due to driveric behavior changes (resolution, compression,
 * scaling, etc). This function, called after parameters setup,
 * makes the driver ic to output a completely black image to
 * the display.
 * It makes sense to push a black image before sending the sleep-out
 * and display-on commands.
 */
static void nt35950_inject_black_image(struct mipi_dsi_multi_context *dsi_ctx)
{
        const u8 cmd0_black_img[] = { 0x6f, 0x01 };
        const u8 cmd1_black_img[] = { 0xf3, 0x10 };
        u8 cmd_test[] = { 0xff, 0xaa, 0x55, 0xa5, 0x80 };

        /* Enable test command */
        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_test, ARRAY_SIZE(cmd_test));

        /* Send a black image */
        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd0_black_img,
                                        ARRAY_SIZE(cmd0_black_img));
        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd1_black_img,
                                        ARRAY_SIZE(cmd1_black_img));

        /* Disable test command */
        cmd_test[ARRAY_SIZE(cmd_test) - 1] = 0x00;
        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_test, ARRAY_SIZE(cmd_test));
}

/*
 * nt35950_set_dispout - Set Display Output register parameters
 * @nt:    Main driver structure
 * @dsi_ctx: context for mipi_dsi functions
 */
static void nt35950_set_dispout(struct mipi_dsi_multi_context *dsi_ctx,
                                struct nt35950 *nt)
{
        u8 cmd_dispout[] = { MCS_PARAM_DISP_OUTPUT_CTRL, 0x00 };
        const struct nt35950_panel_mode *mode_data = nt->desc->mode_data;

        if (mode_data[nt->cur_mode].is_video_mode)
                cmd_dispout[1] |= MCS_DISP_OUT_VIDEO_MODE;
        if (mode_data[nt->cur_mode].enable_sram)
                cmd_dispout[1] |= MCS_DISP_OUT_SRAM_EN;

        mipi_dsi_dcs_write_buffer_multi(dsi_ctx, cmd_dispout,
                                        ARRAY_SIZE(cmd_dispout));
}

static int nt35950_get_current_mode(struct nt35950 *nt)
{
        struct drm_connector *connector = nt->connector;
        struct drm_crtc_state *crtc_state;
        int i;

        /* Return the default (first) mode if no info available yet */
        if (!connector->state || !connector->state->crtc)
                return 0;

        crtc_state = connector->state->crtc->state;

        for (i = 0; i < nt->desc->num_modes; i++) {
                if (drm_mode_match(&crtc_state->mode,
                                   &nt->desc->mode_data[i].mode,
                                   DRM_MODE_MATCH_TIMINGS | DRM_MODE_MATCH_CLOCK))
                        return i;
        }

        return 0;
}

static int nt35950_on(struct nt35950 *nt)
{
        const struct nt35950_panel_mode *mode_data = nt->desc->mode_data;
        struct mipi_dsi_device *dsi = nt->dsi[0];
        struct mipi_dsi_multi_context dsi_ctx = { .dsi = dsi };

        nt->cur_mode = nt35950_get_current_mode(nt);
        nt->dsi[0]->mode_flags |= MIPI_DSI_MODE_LPM;
        nt->dsi[1]->mode_flags |= MIPI_DSI_MODE_LPM;

        nt35950_set_cmd2_page(&dsi_ctx, nt, 0);
        nt35950_set_data_compression(&dsi_ctx, nt, mode_data[nt->cur_mode].compression);
        nt35950_set_scale_mode(&dsi_ctx, mode_data[nt->cur_mode].scaler_mode);
        nt35950_set_scaler(&dsi_ctx, mode_data[nt->cur_mode].scaler_on);
        nt35950_set_dispout(&dsi_ctx, nt);

        mipi_dsi_dcs_set_tear_on_multi(&dsi_ctx, MIPI_DSI_DCS_TEAR_MODE_VBLANK);
        mipi_dsi_dcs_set_tear_scanline_multi(&dsi_ctx, 0);

        /* CMD2 Page 1 */
        nt35950_set_cmd2_page(&dsi_ctx, nt, 1);

        /* Unknown command */
        mipi_dsi_dcs_write_seq_multi(&dsi_ctx, 0xd4, 0x88, 0x88);

        /* CMD2 Page 7 */
        nt35950_set_cmd2_page(&dsi_ctx, nt, 7);

        /* Enable SubPixel Rendering */
        mipi_dsi_dcs_write_seq_multi(&dsi_ctx, MCS_PARAM_SPR_EN, 0x01);

        /* SPR Mode: YYG Rainbow-RGB */
        mipi_dsi_dcs_write_seq_multi(&dsi_ctx, MCS_PARAM_SPR_MODE,
                                     MCS_SPR_MODE_YYG_RAINBOW_RGB);

        /* CMD3 */
        nt35950_inject_black_image(&dsi_ctx);
        mipi_dsi_dcs_exit_sleep_mode_multi(&dsi_ctx);
        mipi_dsi_msleep(&dsi_ctx, 120);

        mipi_dsi_dcs_set_display_on_multi(&dsi_ctx);
        mipi_dsi_msleep(&dsi_ctx, 120);

        if (dsi_ctx.accum_err)
                return dsi_ctx.accum_err;

        nt->dsi[0]->mode_flags &= ~MIPI_DSI_MODE_LPM;
        nt->dsi[1]->mode_flags &= ~MIPI_DSI_MODE_LPM;

        return 0;
}

static void nt35950_off(struct nt35950 *nt)
{
        struct mipi_dsi_device *dsi = nt->dsi[0];
        struct mipi_dsi_multi_context dsi_ctx = { .dsi = dsi };

        mipi_dsi_dcs_set_display_off_multi(&dsi_ctx);
        mipi_dsi_usleep_range(&dsi_ctx, 10000, 11000);

        mipi_dsi_dcs_enter_sleep_mode_multi(&dsi_ctx);
        mipi_dsi_msleep(&dsi_ctx, 150);

        nt->dsi[0]->mode_flags |= MIPI_DSI_MODE_LPM;
        nt->dsi[1]->mode_flags |= MIPI_DSI_MODE_LPM;
}

static int nt35950_sharp_init_vregs(struct nt35950 *nt, struct device *dev)
{
        int ret;

        nt->vregs[0].supply = "vddio";
        nt->vregs[1].supply = "avdd";
        nt->vregs[2].supply = "avee";
        nt->vregs[3].supply = "dvdd";
        ret = devm_regulator_bulk_get(dev, ARRAY_SIZE(nt->vregs),
                                      nt->vregs);
        if (ret < 0)
                return ret;

        ret = regulator_is_supported_voltage(nt->vregs[0].consumer,
                                             1750000, 1950000);
        if (!ret)
                return -EINVAL;
        ret = regulator_is_supported_voltage(nt->vregs[1].consumer,
                                             5200000, 5900000);
        if (!ret)
                return -EINVAL;
        /* AVEE is negative: -5.90V to -5.20V */
        ret = regulator_is_supported_voltage(nt->vregs[2].consumer,
                                             5200000, 5900000);
        if (!ret)
                return -EINVAL;

        ret = regulator_is_supported_voltage(nt->vregs[3].consumer,
                                             1300000, 1400000);
        if (!ret)
                return -EINVAL;

        return 0;
}

static int nt35950_prepare(struct drm_panel *panel)
{
        struct nt35950 *nt = to_nt35950(panel);
        int ret;

        ret = regulator_enable(nt->vregs[0].consumer);
        if (ret)
                return ret;
        usleep_range(2000, 5000);

        ret = regulator_enable(nt->vregs[3].consumer);
        if (ret)
                goto end;
        usleep_range(15000, 18000);

        ret = regulator_enable(nt->vregs[1].consumer);
        if (ret)
                goto end;

        ret = regulator_enable(nt->vregs[2].consumer);
        if (ret)
                goto end;
        usleep_range(12000, 13000);

        nt35950_reset(nt);

        ret = nt35950_on(nt);

end:
        if (ret < 0) {
                regulator_bulk_disable(ARRAY_SIZE(nt->vregs), nt->vregs);
                return ret;
        }

        return 0;
}

static int nt35950_unprepare(struct drm_panel *panel)
{
        struct nt35950 *nt = to_nt35950(panel);

        nt35950_off(nt);

        gpiod_set_value_cansleep(nt->reset_gpio, 0);
        regulator_bulk_disable(ARRAY_SIZE(nt->vregs), nt->vregs);

        return 0;
}

static int nt35950_get_modes(struct drm_panel *panel,
                             struct drm_connector *connector)
{
        struct nt35950 *nt = to_nt35950(panel);
        int i;

        for (i = 0; i < nt->desc->num_modes; i++) {
                struct drm_display_mode *mode;

                mode = drm_mode_duplicate(connector->dev,
                                          &nt->desc->mode_data[i].mode);
                if (!mode)
                        return -ENOMEM;

                drm_mode_set_name(mode);

                mode->type |= DRM_MODE_TYPE_DRIVER;
                if (nt->desc->num_modes == 1)
                        mode->type |= DRM_MODE_TYPE_PREFERRED;

                drm_mode_probed_add(connector, mode);
        }

        connector->display_info.bpc = 8;
        connector->display_info.height_mm = nt->desc->mode_data[0].mode.height_mm;
        connector->display_info.width_mm = nt->desc->mode_data[0].mode.width_mm;
        nt->connector = connector;

        return nt->desc->num_modes;
}

static const struct drm_panel_funcs nt35950_panel_funcs = {
        .prepare = nt35950_prepare,
        .unprepare = nt35950_unprepare,
        .get_modes = nt35950_get_modes,
};

static int nt35950_probe(struct mipi_dsi_device *dsi)
{
        struct device *dev = &dsi->dev;
        struct device_node *dsi_r;
        struct mipi_dsi_host *dsi_r_host;
        struct nt35950 *nt;
        const struct mipi_dsi_device_info *info;
        int i, num_dsis = 1, ret;

        nt = devm_drm_panel_alloc(dev, struct nt35950, panel, &nt35950_panel_funcs,
                                  DRM_MODE_CONNECTOR_DSI);
        if (IS_ERR(nt))
                return PTR_ERR(nt);

        ret = nt35950_sharp_init_vregs(nt, dev);
        if (ret)
                return dev_err_probe(dev, ret, "Regulator init failure.\n");

        nt->desc = of_device_get_match_data(dev);
        if (!nt->desc)
                return -ENODEV;

        nt->reset_gpio = devm_gpiod_get(dev, "reset", GPIOD_ASIS);
        if (IS_ERR(nt->reset_gpio)) {
                return dev_err_probe(dev, PTR_ERR(nt->reset_gpio),
                                     "Failed to get reset gpio\n");
        }

        /* If the panel is connected on two DSIs then DSI0 left, DSI1 right */
        if (nt->desc->is_dual_dsi) {
                info = &nt->desc->dsi_info;
                dsi_r = of_graph_get_remote_node(dsi->dev.of_node, 1, -1);
                if (!dsi_r) {
                        dev_err(dev, "Cannot get secondary DSI node.\n");
                        return -ENODEV;
                }
                dsi_r_host = of_find_mipi_dsi_host_by_node(dsi_r);
                of_node_put(dsi_r);
                if (!dsi_r_host)
                        return dev_err_probe(dev, -EPROBE_DEFER, "Cannot get secondary DSI host\n");

                nt->dsi[1] = mipi_dsi_device_register_full(dsi_r_host, info);
                if (IS_ERR(nt->dsi[1])) {
                        dev_err(dev, "Cannot get secondary DSI node\n");
                        return PTR_ERR(nt->dsi[1]);
                }
                num_dsis++;
        }

        nt->dsi[0] = dsi;
        mipi_dsi_set_drvdata(dsi, nt);

        ret = drm_panel_of_backlight(&nt->panel);
        if (ret) {
                if (num_dsis == 2)
                        mipi_dsi_device_unregister(nt->dsi[1]);

                return dev_err_probe(dev, ret, "Failed to get backlight\n");
        }

        drm_panel_add(&nt->panel);

        for (i = 0; i < num_dsis; i++) {
                nt->dsi[i]->lanes = nt->desc->num_lanes;
                nt->dsi[i]->format = MIPI_DSI_FMT_RGB888;

                nt->dsi[i]->mode_flags = MIPI_DSI_CLOCK_NON_CONTINUOUS |
                                         MIPI_DSI_MODE_LPM;

                if (nt->desc->mode_data[0].is_video_mode)
                        nt->dsi[i]->mode_flags |= MIPI_DSI_MODE_VIDEO;

                ret = mipi_dsi_attach(nt->dsi[i]);
                if (ret < 0) {
                        /* If we fail to attach to either host, we're done */
                        if (num_dsis == 2)
                                mipi_dsi_device_unregister(nt->dsi[1]);

                        return dev_err_probe(dev, ret,
                                             "Cannot attach to DSI%d host.\n", i);
                }
        }

        /* Make sure to set RESX LOW before starting the power-on sequence */
        gpiod_set_value_cansleep(nt->reset_gpio, 0);
        return 0;
}

static void nt35950_remove(struct mipi_dsi_device *dsi)
{
        struct nt35950 *nt = mipi_dsi_get_drvdata(dsi);
        int ret;

        ret = mipi_dsi_detach(nt->dsi[0]);
        if (ret < 0)
                dev_err(&dsi->dev,
                        "Failed to detach from DSI0 host: %d\n", ret);

        if (nt->dsi[1]) {
                ret = mipi_dsi_detach(nt->dsi[1]);
                if (ret < 0)
                        dev_err(&dsi->dev,
                                "Failed to detach from DSI1 host: %d\n", ret);
                mipi_dsi_device_unregister(nt->dsi[1]);
        }

        drm_panel_remove(&nt->panel);
}

static const struct nt35950_panel_mode sharp_ls055d1sx04_modes[] = {
        {
                /* 1920x1080 60Hz no compression */
                .mode = {
                        .clock = 214537,
                        .hdisplay = 1080,
                        .hsync_start = 1080 + 400,
                        .hsync_end = 1080 + 400 + 40,
                        .htotal = 1080 + 400 + 40 + 300,
                        .vdisplay = 1920,
                        .vsync_start = 1920 + 12,
                        .vsync_end = 1920 + 12 + 2,
                        .vtotal = 1920 + 12 + 2 + 10,
                        .width_mm = 68,
                        .height_mm = 121,
                },
                .compression = MCS_DATA_COMPRESSION_NONE,
                .enable_sram = true,
                .is_video_mode = false,
                .scaler_on = 1,
                .scaler_mode = MCS_SCALEUP_DUPLICATE,
        },
        /* TODO: Add 2160x3840 60Hz when DSC is supported */
};

static const struct nt35950_panel_desc sharp_ls055d1sx04 = {
        .model_name = "Sharp LS055D1SX04",
        .dsi_info = {
                .type = "LS055D1SX04",
                .channel = 0,
                .node = NULL,
        },
        .mode_data = sharp_ls055d1sx04_modes,
        .num_modes = ARRAY_SIZE(sharp_ls055d1sx04_modes),
        .is_dual_dsi = true,
        .num_lanes = 4,
};

static const struct of_device_id nt35950_of_match[] = {
        { .compatible = "sharp,ls055d1sx04", .data = &sharp_ls055d1sx04 },
        {  }
};
MODULE_DEVICE_TABLE(of, nt35950_of_match);

static struct mipi_dsi_driver nt35950_driver = {
        .probe = nt35950_probe,
        .remove = nt35950_remove,
        .driver = {
                .name = "panel-novatek-nt35950",
                .of_match_table = nt35950_of_match,
        },
};
module_mipi_dsi_driver(nt35950_driver);

MODULE_AUTHOR("AngeloGioacchino Del Regno <angelogioacchino.delregno@somainline.org>");
MODULE_DESCRIPTION("Novatek NT35950 DriverIC panels driver");
MODULE_LICENSE("GPL v2");