root/drivers/gpu/drm/panel/panel-samsung-db7430.c
// SPDX-License-Identifier: GPL-2.0
/*
 * Panel driver for the Samsung LMS397KF04 480x800 DPI RGB panel.
 * According to the data sheet the display controller is called DB7430.
 * Found in the Samsung Galaxy Beam GT-I8350 mobile phone.
 * Linus Walleij <linus.walleij@linaro.org>
 */
#include <drm/drm_mipi_dbi.h>
#include <drm/drm_modes.h>
#include <drm/drm_panel.h>

#include <linux/delay.h>
#include <linux/gpio/consumer.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/media-bus-format.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/regulator/consumer.h>
#include <linux/spi/spi.h>

#include <video/mipi_display.h>

#define DB7430_ACCESS_PROT_OFF          0xb0
#define DB7430_UNKNOWN_B4               0xb4
#define DB7430_USER_SELECT              0xb5
#define DB7430_UNKNOWN_B7               0xb7
#define DB7430_UNKNOWN_B8               0xb8
#define DB7430_PANEL_DRIVING            0xc0
#define DB7430_SOURCE_CONTROL           0xc1
#define DB7430_GATE_INTERFACE           0xc4
#define DB7430_DISPLAY_H_TIMING         0xc5
#define DB7430_RGB_SYNC_OPTION          0xc6
#define DB7430_GAMMA_SET_RED            0xc8
#define DB7430_GAMMA_SET_GREEN          0xc9
#define DB7430_GAMMA_SET_BLUE           0xca
#define DB7430_BIAS_CURRENT_CTRL        0xd1
#define DB7430_DDV_CTRL                 0xd2
#define DB7430_GAMMA_CTRL_REF           0xd3
#define DB7430_UNKNOWN_D4               0xd4
#define DB7430_DCDC_CTRL                0xd5
#define DB7430_VCL_CTRL                 0xd6
#define DB7430_UNKNOWN_F8               0xf8
#define DB7430_UNKNOWN_FC               0xfc

#define DATA_MASK       0x100

/**
 * struct db7430 - state container for a panel controlled by the DB7430
 * controller
 */
struct db7430 {
        /** @dev: the container device */
        struct device *dev;
        /** @dbi: the DBI bus abstraction handle */
        struct mipi_dbi dbi;
        /** @panel: the DRM panel instance for this device */
        struct drm_panel panel;
        /** @reset: reset GPIO line */
        struct gpio_desc *reset;
        /** @regulators: VCCIO and VIO supply regulators */
        struct regulator_bulk_data regulators[2];
};

static const struct drm_display_mode db7430_480_800_mode = {
        /*
         * 31 ns period min (htotal*vtotal*vrefresh)/1000
         * gives a Vrefresh of ~71 Hz.
         */
        .clock = 32258,
        .hdisplay = 480,
        .hsync_start = 480 + 10,
        .hsync_end = 480 + 10 + 4,
        .htotal = 480 + 10 + 4 + 40,
        .vdisplay = 800,
        .vsync_start = 800 + 6,
        .vsync_end = 800 + 6 + 1,
        .vtotal = 800 + 6 + 1 + 7,
        .width_mm = 53,
        .height_mm = 87,
        .flags = DRM_MODE_FLAG_NVSYNC | DRM_MODE_FLAG_NHSYNC,
};

static inline struct db7430 *to_db7430(struct drm_panel *panel)
{
        return container_of(panel, struct db7430, panel);
}

static int db7430_power_on(struct db7430 *db)
{
        struct mipi_dbi *dbi = &db->dbi;
        int ret;

        /* Power up */
        ret = regulator_bulk_enable(ARRAY_SIZE(db->regulators),
                                    db->regulators);
        if (ret) {
                dev_err(db->dev, "failed to enable regulators: %d\n", ret);
                return ret;
        }
        msleep(50);

        /* Assert reset >=1 ms */
        gpiod_set_value_cansleep(db->reset, 1);
        usleep_range(1000, 5000);
        /* De-assert reset */
        gpiod_set_value_cansleep(db->reset, 0);
        /* Wait >= 10 ms */
        msleep(10);
        dev_dbg(db->dev, "de-asserted RESET\n");

        /*
         * This is set to 0x0a (RGB/BGR order + horizontal flip) in order
         * to make the display behave normally. If this is not set the displays
         * normal output behaviour is horizontally flipped and BGR ordered. Do
         * it twice because the first message doesn't always "take".
         */
        mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, 0x0a);
        mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, 0x0a);
        mipi_dbi_command(dbi, DB7430_ACCESS_PROT_OFF, 0x00);
        mipi_dbi_command(dbi, DB7430_PANEL_DRIVING, 0x28, 0x08);
        mipi_dbi_command(dbi, DB7430_SOURCE_CONTROL,
                         0x01, 0x30, 0x15, 0x05, 0x22);
        mipi_dbi_command(dbi, DB7430_GATE_INTERFACE,
                         0x10, 0x01, 0x00);
        mipi_dbi_command(dbi, DB7430_DISPLAY_H_TIMING,
                         0x06, 0x55, 0x03, 0x07, 0x0b,
                         0x33, 0x00, 0x01, 0x03);
        /*
         * 0x00 in datasheet 0x01 in vendor code 0x00, it seems 0x01 means
         * DE active high and 0x00 means DE active low.
         */
        mipi_dbi_command(dbi, DB7430_RGB_SYNC_OPTION, 0x01);
        mipi_dbi_command(dbi, DB7430_GAMMA_SET_RED,
                /* R positive gamma */ 0x00,
                0x0A, 0x31, 0x3B, 0x4E, 0x58, 0x59, 0x5B, 0x58, 0x5E, 0x62,
                0x60, 0x61, 0x5E, 0x62, 0x55, 0x55, 0x7F, 0x08,
                /* R negative gamma */ 0x00,
                0x0A, 0x31, 0x3B, 0x4E, 0x58, 0x59, 0x5B, 0x58, 0x5E, 0x62,
                0x60, 0x61, 0x5E, 0x62, 0x55, 0x55, 0x7F, 0x08);
        mipi_dbi_command(dbi, DB7430_GAMMA_SET_GREEN,
                /* G positive gamma */ 0x00,
                0x25, 0x15, 0x28, 0x3D, 0x4A, 0x48, 0x4C, 0x4A, 0x52, 0x59,
                0x59, 0x5B, 0x56, 0x60, 0x5D, 0x55, 0x7F, 0x0A,
                /* G negative gamma */ 0x00,
                0x25, 0x15, 0x28, 0x3D, 0x4A, 0x48, 0x4C, 0x4A, 0x52, 0x59,
                0x59, 0x5B, 0x56, 0x60, 0x5D, 0x55, 0x7F, 0x0A);
        mipi_dbi_command(dbi, DB7430_GAMMA_SET_BLUE,
                /* B positive gamma */ 0x00,
                0x48, 0x10, 0x1F, 0x2F, 0x35, 0x38, 0x3D, 0x3C, 0x45, 0x4D,
                0x4E, 0x52, 0x51, 0x60, 0x7F, 0x7E, 0x7F, 0x0C,
                /* B negative gamma */ 0x00,
                0x48, 0x10, 0x1F, 0x2F, 0x35, 0x38, 0x3D, 0x3C, 0x45, 0x4D,
                0x4E, 0x52, 0x51, 0x60, 0x7F, 0x7E, 0x7F, 0x0C);
        mipi_dbi_command(dbi, DB7430_BIAS_CURRENT_CTRL, 0x33, 0x13);
        mipi_dbi_command(dbi, DB7430_DDV_CTRL, 0x11, 0x00, 0x00);
        mipi_dbi_command(dbi, DB7430_GAMMA_CTRL_REF, 0x50, 0x50);
        mipi_dbi_command(dbi, DB7430_DCDC_CTRL, 0x2f, 0x11, 0x1e, 0x46);
        mipi_dbi_command(dbi, DB7430_VCL_CTRL, 0x11, 0x0a);

        return 0;
}

static int db7430_power_off(struct db7430 *db)
{
        /* Go into RESET and disable regulators */
        gpiod_set_value_cansleep(db->reset, 1);
        return regulator_bulk_disable(ARRAY_SIZE(db->regulators),
                                      db->regulators);
}

static int db7430_unprepare(struct drm_panel *panel)
{
        return db7430_power_off(to_db7430(panel));
}

static int db7430_disable(struct drm_panel *panel)
{
        struct db7430 *db = to_db7430(panel);
        struct mipi_dbi *dbi = &db->dbi;

        mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF);
        msleep(25);
        mipi_dbi_command(dbi, MIPI_DCS_ENTER_SLEEP_MODE);
        msleep(120);

        return 0;
}

static int db7430_prepare(struct drm_panel *panel)
{
        return db7430_power_on(to_db7430(panel));
}

static int db7430_enable(struct drm_panel *panel)
{
        struct db7430 *db = to_db7430(panel);
        struct mipi_dbi *dbi = &db->dbi;

        /* Exit sleep mode */
        mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
        msleep(20);

        /* NVM (non-volatile memory) load sequence */
        mipi_dbi_command(dbi, DB7430_UNKNOWN_D4, 0x52, 0x5e);
        mipi_dbi_command(dbi, DB7430_UNKNOWN_F8, 0x01, 0xf5, 0xf2, 0x71, 0x44);
        mipi_dbi_command(dbi, DB7430_UNKNOWN_FC, 0x00, 0x08);
        msleep(150);

        /* CABC turn on sequence (BC = backlight control) */
        mipi_dbi_command(dbi, DB7430_UNKNOWN_B4, 0x0f, 0x00, 0x50);
        mipi_dbi_command(dbi, DB7430_USER_SELECT, 0x80);
        mipi_dbi_command(dbi, DB7430_UNKNOWN_B7, 0x24);
        mipi_dbi_command(dbi, DB7430_UNKNOWN_B8, 0x01);

        /* Turn on display */
        mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);

        return 0;
}

/**
 * db7430_get_modes() - return the mode
 * @panel: the panel to get the mode for
 * @connector: reference to the central DRM connector control structure
 */
static int db7430_get_modes(struct drm_panel *panel,
                            struct drm_connector *connector)
{
        struct db7430 *db = to_db7430(panel);
        struct drm_display_mode *mode;
        static const u32 bus_format = MEDIA_BUS_FMT_RGB888_1X24;

        mode = drm_mode_duplicate(connector->dev, &db7430_480_800_mode);
        if (!mode) {
                dev_err(db->dev, "failed to add mode\n");
                return -ENOMEM;
        }

        connector->display_info.bpc = 8;
        connector->display_info.width_mm = mode->width_mm;
        connector->display_info.height_mm = mode->height_mm;
        connector->display_info.bus_flags =
                DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE;
        drm_display_info_set_bus_formats(&connector->display_info,
                                         &bus_format, 1);

        drm_mode_set_name(mode);
        mode->type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED;

        drm_mode_probed_add(connector, mode);

        return 1;
}

static const struct drm_panel_funcs db7430_drm_funcs = {
        .disable = db7430_disable,
        .unprepare = db7430_unprepare,
        .prepare = db7430_prepare,
        .enable = db7430_enable,
        .get_modes = db7430_get_modes,
};

static int db7430_probe(struct spi_device *spi)
{
        struct device *dev = &spi->dev;
        struct db7430 *db;
        int ret;

        db = devm_drm_panel_alloc(dev, struct db7430, panel, &db7430_drm_funcs,
                                  DRM_MODE_CONNECTOR_DPI);
        if (IS_ERR(db))
                return PTR_ERR(db);

        db->dev = dev;

        /*
         * VCI   is the analog voltage supply
         * VCCIO is the digital I/O voltage supply
         */
        db->regulators[0].supply = "vci";
        db->regulators[1].supply = "vccio";
        ret = devm_regulator_bulk_get(dev,
                                      ARRAY_SIZE(db->regulators),
                                      db->regulators);
        if (ret)
                return dev_err_probe(dev, ret, "failed to get regulators\n");

        db->reset = devm_gpiod_get(dev, "reset", GPIOD_OUT_HIGH);
        if (IS_ERR(db->reset)) {
                ret = PTR_ERR(db->reset);
                return dev_err_probe(dev, ret, "no RESET GPIO\n");
        }

        ret = mipi_dbi_spi_init(spi, &db->dbi, NULL);
        if (ret)
                return dev_err_probe(dev, ret, "MIPI DBI init failed\n");

        /* FIXME: if no external backlight, use internal backlight */
        ret = drm_panel_of_backlight(&db->panel);
        if (ret)
                return dev_err_probe(dev, ret, "failed to add backlight\n");

        spi_set_drvdata(spi, db);

        drm_panel_add(&db->panel);
        dev_dbg(dev, "added panel\n");

        return 0;
}

static void db7430_remove(struct spi_device *spi)
{
        struct db7430 *db = spi_get_drvdata(spi);

        drm_panel_remove(&db->panel);
}

/*
 * The DB7430 display controller may be used in several display products,
 * so list the different variants here and add per-variant data if needed.
 */
static const struct of_device_id db7430_match[] = {
        { .compatible = "samsung,lms397kf04", },
        {},
};
MODULE_DEVICE_TABLE(of, db7430_match);

static const struct spi_device_id db7430_ids[] = {
        { "lms397kf04" },
        { },
};
MODULE_DEVICE_TABLE(spi, db7430_ids);

static struct spi_driver db7430_driver = {
        .probe          = db7430_probe,
        .remove         = db7430_remove,
        .id_table       = db7430_ids,
        .driver         = {
                .name   = "db7430-panel",
                .of_match_table = db7430_match,
        },
};
module_spi_driver(db7430_driver);

MODULE_AUTHOR("Linus Walleij <linus.walleij@linaro.org>");
MODULE_DESCRIPTION("Samsung DB7430 panel driver");
MODULE_LICENSE("GPL v2");