// SPDX-License-Identifier: GPL-2.0-only /* * Novatek NT35950 DriverIC panels driver * * Copyright (c) 2021 AngeloGioacchino Del Regno * */ #include #include #include #include #include #include #include #include #include #include #include #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_kzalloc(dev, sizeof(*nt), GFP_KERNEL); if (!nt) return -ENOMEM; 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 (!nt->dsi[1]) { dev_err(dev, "Cannot get secondary DSI node\n"); return -ENODEV; } num_dsis++; } nt->dsi[0] = dsi; mipi_dsi_set_drvdata(dsi, nt); drm_panel_init(&nt->panel, dev, &nt35950_panel_funcs, DRM_MODE_CONNECTOR_DSI); 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 "); MODULE_DESCRIPTION("Novatek NT35950 DriverIC panels driver"); MODULE_LICENSE("GPL v2");