Linux Audio

Check our new training course

Linux kernel drivers training

May 6-19, 2025
Register
Loading...
v6.13.7
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * DRM driver for Solomon SSD13xx OLED displays
   4 *
   5 * Copyright 2022 Red Hat Inc.
   6 * Author: Javier Martinez Canillas <javierm@redhat.com>
   7 *
   8 * Based on drivers/video/fbdev/ssd1307fb.c
   9 * Copyright 2012 Free Electrons
  10 */
  11
  12#include <linux/backlight.h>
  13#include <linux/bitfield.h>
  14#include <linux/bits.h>
  15#include <linux/delay.h>
  16#include <linux/gpio/consumer.h>
  17#include <linux/property.h>
  18#include <linux/pwm.h>
  19#include <linux/regulator/consumer.h>
  20
  21#include <drm/drm_atomic.h>
  22#include <drm/drm_atomic_helper.h>
  23#include <drm/drm_client_setup.h>
  24#include <drm/drm_crtc_helper.h>
  25#include <drm/drm_damage_helper.h>
  26#include <drm/drm_edid.h>
  27#include <drm/drm_fbdev_shmem.h>
  28#include <drm/drm_format_helper.h>
  29#include <drm/drm_framebuffer.h>
  30#include <drm/drm_gem_atomic_helper.h>
  31#include <drm/drm_gem_framebuffer_helper.h>
  32#include <drm/drm_gem_shmem_helper.h>
  33#include <drm/drm_managed.h>
  34#include <drm/drm_modes.h>
  35#include <drm/drm_rect.h>
  36#include <drm/drm_probe_helper.h>
  37
  38#include "ssd130x.h"
  39
  40#define DRIVER_NAME	"ssd130x"
  41#define DRIVER_DESC	"DRM driver for Solomon SSD13xx OLED displays"
  42#define DRIVER_DATE	"20220131"
  43#define DRIVER_MAJOR	1
  44#define DRIVER_MINOR	0
  45
  46#define SSD130X_PAGE_HEIGHT 8
  47
  48#define SSD132X_SEGMENT_WIDTH 2
  49
  50/* ssd13xx commands */
  51#define SSD13XX_CONTRAST			0x81
  52#define SSD13XX_SET_SEG_REMAP			0xa0
  53#define SSD13XX_SET_MULTIPLEX_RATIO		0xa8
  54#define SSD13XX_DISPLAY_OFF			0xae
  55#define SSD13XX_DISPLAY_ON			0xaf
  56
  57#define SSD13XX_SET_SEG_REMAP_MASK		GENMASK(0, 0)
  58#define SSD13XX_SET_SEG_REMAP_SET(val)		FIELD_PREP(SSD13XX_SET_SEG_REMAP_MASK, (val))
  59
  60/* ssd130x commands */
  61#define SSD130X_PAGE_COL_START_LOW		0x00
  62#define SSD130X_PAGE_COL_START_HIGH		0x10
  63#define SSD130X_SET_ADDRESS_MODE		0x20
  64#define SSD130X_SET_COL_RANGE			0x21
  65#define SSD130X_SET_PAGE_RANGE			0x22
  66#define SSD130X_SET_LOOKUP_TABLE		0x91
  67#define SSD130X_CHARGE_PUMP			0x8d
  68#define SSD130X_START_PAGE_ADDRESS		0xb0
  69#define SSD130X_SET_COM_SCAN_DIR		0xc0
  70#define SSD130X_SET_DISPLAY_OFFSET		0xd3
  71#define SSD130X_SET_CLOCK_FREQ			0xd5
  72#define SSD130X_SET_AREA_COLOR_MODE		0xd8
  73#define SSD130X_SET_PRECHARGE_PERIOD		0xd9
  74#define SSD130X_SET_COM_PINS_CONFIG		0xda
  75#define SSD130X_SET_VCOMH			0xdb
  76
  77/* ssd130x commands accessors */
  78#define SSD130X_PAGE_COL_START_MASK		GENMASK(3, 0)
  79#define SSD130X_PAGE_COL_START_HIGH_SET(val)	FIELD_PREP(SSD130X_PAGE_COL_START_MASK, (val) >> 4)
  80#define SSD130X_PAGE_COL_START_LOW_SET(val)	FIELD_PREP(SSD130X_PAGE_COL_START_MASK, (val))
  81#define SSD130X_START_PAGE_ADDRESS_MASK		GENMASK(2, 0)
  82#define SSD130X_START_PAGE_ADDRESS_SET(val)	FIELD_PREP(SSD130X_START_PAGE_ADDRESS_MASK, (val))
  83#define SSD130X_SET_COM_SCAN_DIR_MASK		GENMASK(3, 3)
  84#define SSD130X_SET_COM_SCAN_DIR_SET(val)	FIELD_PREP(SSD130X_SET_COM_SCAN_DIR_MASK, (val))
  85#define SSD130X_SET_CLOCK_DIV_MASK		GENMASK(3, 0)
  86#define SSD130X_SET_CLOCK_DIV_SET(val)		FIELD_PREP(SSD130X_SET_CLOCK_DIV_MASK, (val))
  87#define SSD130X_SET_CLOCK_FREQ_MASK		GENMASK(7, 4)
  88#define SSD130X_SET_CLOCK_FREQ_SET(val)		FIELD_PREP(SSD130X_SET_CLOCK_FREQ_MASK, (val))
  89#define SSD130X_SET_PRECHARGE_PERIOD1_MASK	GENMASK(3, 0)
  90#define SSD130X_SET_PRECHARGE_PERIOD1_SET(val)	FIELD_PREP(SSD130X_SET_PRECHARGE_PERIOD1_MASK, (val))
  91#define SSD130X_SET_PRECHARGE_PERIOD2_MASK	GENMASK(7, 4)
  92#define SSD130X_SET_PRECHARGE_PERIOD2_SET(val)	FIELD_PREP(SSD130X_SET_PRECHARGE_PERIOD2_MASK, (val))
  93#define SSD130X_SET_COM_PINS_CONFIG1_MASK	GENMASK(4, 4)
  94#define SSD130X_SET_COM_PINS_CONFIG1_SET(val)	FIELD_PREP(SSD130X_SET_COM_PINS_CONFIG1_MASK, (val))
  95#define SSD130X_SET_COM_PINS_CONFIG2_MASK	GENMASK(5, 5)
  96#define SSD130X_SET_COM_PINS_CONFIG2_SET(val)	FIELD_PREP(SSD130X_SET_COM_PINS_CONFIG2_MASK, (val))
  97
  98#define SSD130X_SET_ADDRESS_MODE_HORIZONTAL	0x00
  99#define SSD130X_SET_ADDRESS_MODE_VERTICAL	0x01
 100#define SSD130X_SET_ADDRESS_MODE_PAGE		0x02
 101
 102#define SSD130X_SET_AREA_COLOR_MODE_ENABLE	0x1e
 103#define SSD130X_SET_AREA_COLOR_MODE_LOW_POWER	0x05
 104
 105/* ssd132x commands */
 106#define SSD132X_SET_COL_RANGE			0x15
 107#define SSD132X_SET_DEACTIVATE_SCROLL		0x2e
 108#define SSD132X_SET_ROW_RANGE			0x75
 109#define SSD132X_SET_DISPLAY_START		0xa1
 110#define SSD132X_SET_DISPLAY_OFFSET		0xa2
 111#define SSD132X_SET_DISPLAY_NORMAL		0xa4
 112#define SSD132X_SET_FUNCTION_SELECT_A		0xab
 113#define SSD132X_SET_PHASE_LENGTH		0xb1
 114#define SSD132X_SET_CLOCK_FREQ			0xb3
 115#define SSD132X_SET_GPIO			0xb5
 116#define SSD132X_SET_PRECHARGE_PERIOD		0xb6
 117#define SSD132X_SET_GRAY_SCALE_TABLE		0xb8
 118#define SSD132X_SELECT_DEFAULT_TABLE		0xb9
 119#define SSD132X_SET_PRECHARGE_VOLTAGE		0xbc
 120#define SSD130X_SET_VCOMH_VOLTAGE		0xbe
 121#define SSD132X_SET_FUNCTION_SELECT_B		0xd5
 122
 123/* ssd133x commands */
 124#define SSD133X_SET_COL_RANGE			0x15
 125#define SSD133X_SET_ROW_RANGE			0x75
 126#define SSD133X_CONTRAST_A			0x81
 127#define SSD133X_CONTRAST_B			0x82
 128#define SSD133X_CONTRAST_C			0x83
 129#define SSD133X_SET_MASTER_CURRENT		0x87
 130#define SSD132X_SET_PRECHARGE_A			0x8a
 131#define SSD132X_SET_PRECHARGE_B			0x8b
 132#define SSD132X_SET_PRECHARGE_C			0x8c
 133#define SSD133X_SET_DISPLAY_START		0xa1
 134#define SSD133X_SET_DISPLAY_OFFSET		0xa2
 135#define SSD133X_SET_DISPLAY_NORMAL		0xa4
 136#define SSD133X_SET_MASTER_CONFIG		0xad
 137#define SSD133X_POWER_SAVE_MODE			0xb0
 138#define SSD133X_PHASES_PERIOD			0xb1
 139#define SSD133X_SET_CLOCK_FREQ			0xb3
 140#define SSD133X_SET_PRECHARGE_VOLTAGE		0xbb
 141#define SSD133X_SET_VCOMH_VOLTAGE		0xbe
 142
 143#define MAX_CONTRAST 255
 144
 145const struct ssd130x_deviceinfo ssd130x_variants[] = {
 146	[SH1106_ID] = {
 147		.default_vcomh = 0x40,
 148		.default_dclk_div = 1,
 149		.default_dclk_frq = 5,
 150		.default_width = 132,
 151		.default_height = 64,
 152		.page_mode_only = 1,
 153		.family_id = SSD130X_FAMILY,
 154	},
 155	[SSD1305_ID] = {
 156		.default_vcomh = 0x34,
 157		.default_dclk_div = 1,
 158		.default_dclk_frq = 7,
 159		.default_width = 132,
 160		.default_height = 64,
 161		.family_id = SSD130X_FAMILY,
 162	},
 163	[SSD1306_ID] = {
 164		.default_vcomh = 0x20,
 165		.default_dclk_div = 1,
 166		.default_dclk_frq = 8,
 167		.need_chargepump = 1,
 168		.default_width = 128,
 169		.default_height = 64,
 170		.family_id = SSD130X_FAMILY,
 171	},
 172	[SSD1307_ID] = {
 173		.default_vcomh = 0x20,
 174		.default_dclk_div = 2,
 175		.default_dclk_frq = 12,
 176		.need_pwm = 1,
 177		.default_width = 128,
 178		.default_height = 39,
 179		.family_id = SSD130X_FAMILY,
 180	},
 181	[SSD1309_ID] = {
 182		.default_vcomh = 0x34,
 183		.default_dclk_div = 1,
 184		.default_dclk_frq = 10,
 185		.default_width = 128,
 186		.default_height = 64,
 187		.family_id = SSD130X_FAMILY,
 188	},
 189	/* ssd132x family */
 190	[SSD1322_ID] = {
 191		.default_width = 480,
 192		.default_height = 128,
 193		.family_id = SSD132X_FAMILY,
 194	},
 195	[SSD1325_ID] = {
 196		.default_width = 128,
 197		.default_height = 80,
 198		.family_id = SSD132X_FAMILY,
 199	},
 200	[SSD1327_ID] = {
 201		.default_width = 128,
 202		.default_height = 128,
 203		.family_id = SSD132X_FAMILY,
 204	},
 205	/* ssd133x family */
 206	[SSD1331_ID] = {
 207		.default_width = 96,
 208		.default_height = 64,
 209		.family_id = SSD133X_FAMILY,
 210	}
 211};
 212EXPORT_SYMBOL_NS_GPL(ssd130x_variants, "DRM_SSD130X");
 213
 214struct ssd130x_crtc_state {
 215	struct drm_crtc_state base;
 216	/* Buffer to store pixels in HW format and written to the panel */
 217	u8 *data_array;
 218};
 219
 220struct ssd130x_plane_state {
 221	struct drm_shadow_plane_state base;
 222	/* Intermediate buffer to convert pixels from XRGB8888 to HW format */
 223	u8 *buffer;
 224};
 225
 226static inline struct ssd130x_crtc_state *to_ssd130x_crtc_state(struct drm_crtc_state *state)
 227{
 228	return container_of(state, struct ssd130x_crtc_state, base);
 229}
 230
 231static inline struct ssd130x_plane_state *to_ssd130x_plane_state(struct drm_plane_state *state)
 232{
 233	return container_of(state, struct ssd130x_plane_state, base.base);
 234}
 235
 236static inline struct ssd130x_device *drm_to_ssd130x(struct drm_device *drm)
 237{
 238	return container_of(drm, struct ssd130x_device, drm);
 239}
 240
 241/*
 242 * Helper to write data (SSD13XX_DATA) to the device.
 243 */
 244static int ssd130x_write_data(struct ssd130x_device *ssd130x, u8 *values, int count)
 245{
 246	return regmap_bulk_write(ssd130x->regmap, SSD13XX_DATA, values, count);
 247}
 248
 249/*
 250 * Helper to write command (SSD13XX_COMMAND). The fist variadic argument
 251 * is the command to write and the following are the command options.
 252 *
 253 * Note that the ssd13xx protocol requires each command and option to be
 254 * written as a SSD13XX_COMMAND device register value. That is why a call
 255 * to regmap_write(..., SSD13XX_COMMAND, ...) is done for each argument.
 256 */
 257static int ssd130x_write_cmd(struct ssd130x_device *ssd130x, int count,
 258			     /* u8 cmd, u8 option, ... */...)
 259{
 260	va_list ap;
 261	u8 value;
 262	int ret;
 263
 264	va_start(ap, count);
 265
 266	do {
 267		value = va_arg(ap, int);
 268		ret = regmap_write(ssd130x->regmap, SSD13XX_COMMAND, value);
 269		if (ret)
 270			goto out_end;
 271	} while (--count);
 272
 273out_end:
 274	va_end(ap);
 275
 276	return ret;
 277}
 278
 279/* Set address range for horizontal/vertical addressing modes */
 280static int ssd130x_set_col_range(struct ssd130x_device *ssd130x,
 281				 u8 col_start, u8 cols)
 282{
 283	u8 col_end = col_start + cols - 1;
 284	int ret;
 285
 286	if (col_start == ssd130x->col_start && col_end == ssd130x->col_end)
 287		return 0;
 288
 289	ret = ssd130x_write_cmd(ssd130x, 3, SSD130X_SET_COL_RANGE, col_start, col_end);
 290	if (ret < 0)
 291		return ret;
 292
 293	ssd130x->col_start = col_start;
 294	ssd130x->col_end = col_end;
 295	return 0;
 296}
 297
 298static int ssd130x_set_page_range(struct ssd130x_device *ssd130x,
 299				  u8 page_start, u8 pages)
 300{
 301	u8 page_end = page_start + pages - 1;
 302	int ret;
 303
 304	if (page_start == ssd130x->page_start && page_end == ssd130x->page_end)
 305		return 0;
 306
 307	ret = ssd130x_write_cmd(ssd130x, 3, SSD130X_SET_PAGE_RANGE, page_start, page_end);
 308	if (ret < 0)
 309		return ret;
 310
 311	ssd130x->page_start = page_start;
 312	ssd130x->page_end = page_end;
 313	return 0;
 314}
 315
 316/* Set page and column start address for page addressing mode */
 317static int ssd130x_set_page_pos(struct ssd130x_device *ssd130x,
 318				u8 page_start, u8 col_start)
 319{
 320	int ret;
 321	u32 page, col_low, col_high;
 322
 323	page = SSD130X_START_PAGE_ADDRESS |
 324	       SSD130X_START_PAGE_ADDRESS_SET(page_start);
 325	col_low = SSD130X_PAGE_COL_START_LOW |
 326		  SSD130X_PAGE_COL_START_LOW_SET(col_start);
 327	col_high = SSD130X_PAGE_COL_START_HIGH |
 328		   SSD130X_PAGE_COL_START_HIGH_SET(col_start);
 329	ret = ssd130x_write_cmd(ssd130x, 3, page, col_low, col_high);
 330	if (ret < 0)
 331		return ret;
 332
 333	return 0;
 334}
 335
 336static int ssd130x_pwm_enable(struct ssd130x_device *ssd130x)
 337{
 338	struct device *dev = ssd130x->dev;
 339	struct pwm_state pwmstate;
 340
 341	ssd130x->pwm = pwm_get(dev, NULL);
 342	if (IS_ERR(ssd130x->pwm)) {
 343		dev_err(dev, "Could not get PWM from firmware description!\n");
 344		return PTR_ERR(ssd130x->pwm);
 345	}
 346
 347	pwm_init_state(ssd130x->pwm, &pwmstate);
 348	pwm_set_relative_duty_cycle(&pwmstate, 50, 100);
 349	pwm_apply_might_sleep(ssd130x->pwm, &pwmstate);
 350
 351	/* Enable the PWM */
 352	pwm_enable(ssd130x->pwm);
 353
 354	dev_dbg(dev, "Using PWM %s with a %lluns period.\n",
 355		ssd130x->pwm->label, pwm_get_period(ssd130x->pwm));
 356
 357	return 0;
 358}
 359
 360static void ssd130x_reset(struct ssd130x_device *ssd130x)
 361{
 362	if (!ssd130x->reset)
 363		return;
 364
 365	/* Reset the screen */
 366	gpiod_set_value_cansleep(ssd130x->reset, 1);
 367	udelay(4);
 368	gpiod_set_value_cansleep(ssd130x->reset, 0);
 369	udelay(4);
 370}
 371
 372static int ssd130x_power_on(struct ssd130x_device *ssd130x)
 373{
 374	struct device *dev = ssd130x->dev;
 375	int ret;
 376
 377	ssd130x_reset(ssd130x);
 378
 379	ret = regulator_enable(ssd130x->vcc_reg);
 380	if (ret) {
 381		dev_err(dev, "Failed to enable VCC: %d\n", ret);
 382		return ret;
 383	}
 384
 385	if (ssd130x->device_info->need_pwm) {
 386		ret = ssd130x_pwm_enable(ssd130x);
 387		if (ret) {
 388			dev_err(dev, "Failed to enable PWM: %d\n", ret);
 389			regulator_disable(ssd130x->vcc_reg);
 390			return ret;
 391		}
 392	}
 393
 394	return 0;
 395}
 396
 397static void ssd130x_power_off(struct ssd130x_device *ssd130x)
 398{
 399	pwm_disable(ssd130x->pwm);
 400	pwm_put(ssd130x->pwm);
 401
 402	regulator_disable(ssd130x->vcc_reg);
 403}
 404
 405static int ssd130x_init(struct ssd130x_device *ssd130x)
 406{
 407	u32 precharge, dclk, com_invdir, compins, chargepump, seg_remap;
 408	bool scan_mode;
 409	int ret;
 410
 411	/* Set initial contrast */
 412	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_CONTRAST, ssd130x->contrast);
 413	if (ret < 0)
 414		return ret;
 415
 416	/* Set segment re-map */
 417	seg_remap = (SSD13XX_SET_SEG_REMAP |
 418		     SSD13XX_SET_SEG_REMAP_SET(ssd130x->seg_remap));
 419	ret = ssd130x_write_cmd(ssd130x, 1, seg_remap);
 420	if (ret < 0)
 421		return ret;
 422
 423	/* Set COM direction */
 424	com_invdir = (SSD130X_SET_COM_SCAN_DIR |
 425		      SSD130X_SET_COM_SCAN_DIR_SET(ssd130x->com_invdir));
 426	ret = ssd130x_write_cmd(ssd130x,  1, com_invdir);
 427	if (ret < 0)
 428		return ret;
 429
 430	/* Set multiplex ratio value */
 431	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_MULTIPLEX_RATIO, ssd130x->height - 1);
 432	if (ret < 0)
 433		return ret;
 434
 435	/* set display offset value */
 436	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_DISPLAY_OFFSET, ssd130x->com_offset);
 437	if (ret < 0)
 438		return ret;
 439
 440	/* Set clock frequency */
 441	dclk = (SSD130X_SET_CLOCK_DIV_SET(ssd130x->dclk_div - 1) |
 442		SSD130X_SET_CLOCK_FREQ_SET(ssd130x->dclk_frq));
 443	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_CLOCK_FREQ, dclk);
 444	if (ret < 0)
 445		return ret;
 446
 447	/* Set Area Color Mode ON/OFF & Low Power Display Mode */
 448	if (ssd130x->area_color_enable || ssd130x->low_power) {
 449		u32 mode = 0;
 450
 451		if (ssd130x->area_color_enable)
 452			mode |= SSD130X_SET_AREA_COLOR_MODE_ENABLE;
 453
 454		if (ssd130x->low_power)
 455			mode |= SSD130X_SET_AREA_COLOR_MODE_LOW_POWER;
 456
 457		ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_AREA_COLOR_MODE, mode);
 458		if (ret < 0)
 459			return ret;
 460	}
 461
 462	/* Set precharge period in number of ticks from the internal clock */
 463	precharge = (SSD130X_SET_PRECHARGE_PERIOD1_SET(ssd130x->prechargep1) |
 464		     SSD130X_SET_PRECHARGE_PERIOD2_SET(ssd130x->prechargep2));
 465	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_PRECHARGE_PERIOD, precharge);
 466	if (ret < 0)
 467		return ret;
 468
 469	/* Set COM pins configuration */
 470	compins = BIT(1);
 471	/*
 472	 * The COM scan mode field values are the inverse of the boolean DT
 473	 * property "solomon,com-seq". The value 0b means scan from COM0 to
 474	 * COM[N - 1] while 1b means scan from COM[N - 1] to COM0.
 475	 */
 476	scan_mode = !ssd130x->com_seq;
 477	compins |= (SSD130X_SET_COM_PINS_CONFIG1_SET(scan_mode) |
 478		    SSD130X_SET_COM_PINS_CONFIG2_SET(ssd130x->com_lrremap));
 479	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_COM_PINS_CONFIG, compins);
 480	if (ret < 0)
 481		return ret;
 482
 483	/* Set VCOMH */
 484	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_VCOMH, ssd130x->vcomh);
 485	if (ret < 0)
 486		return ret;
 487
 488	/* Turn on the DC-DC Charge Pump */
 489	chargepump = BIT(4);
 490
 491	if (ssd130x->device_info->need_chargepump)
 492		chargepump |= BIT(2);
 493
 494	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_CHARGE_PUMP, chargepump);
 495	if (ret < 0)
 496		return ret;
 497
 498	/* Set lookup table */
 499	if (ssd130x->lookup_table_set) {
 500		int i;
 501
 502		ret = ssd130x_write_cmd(ssd130x, 1, SSD130X_SET_LOOKUP_TABLE);
 503		if (ret < 0)
 504			return ret;
 505
 506		for (i = 0; i < ARRAY_SIZE(ssd130x->lookup_table); i++) {
 507			u8 val = ssd130x->lookup_table[i];
 508
 509			if (val < 31 || val > 63)
 510				dev_warn(ssd130x->dev,
 511					 "lookup table index %d value out of range 31 <= %d <= 63\n",
 512					 i, val);
 513			ret = ssd130x_write_cmd(ssd130x, 1, val);
 514			if (ret < 0)
 515				return ret;
 516		}
 517	}
 518
 519	/* Switch to page addressing mode */
 520	if (ssd130x->page_address_mode)
 521		return ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_ADDRESS_MODE,
 522					 SSD130X_SET_ADDRESS_MODE_PAGE);
 523
 524	/* Switch to horizontal addressing mode */
 525	return ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_ADDRESS_MODE,
 526				 SSD130X_SET_ADDRESS_MODE_HORIZONTAL);
 527}
 528
 529static int ssd132x_init(struct ssd130x_device *ssd130x)
 530{
 531	int ret;
 532
 533	/* Set initial contrast */
 534	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_CONTRAST, 0x80);
 535	if (ret < 0)
 536		return ret;
 537
 538	/* Set column start and end */
 539	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_COL_RANGE, 0x00,
 540				ssd130x->width / SSD132X_SEGMENT_WIDTH - 1);
 541	if (ret < 0)
 542		return ret;
 543
 544	/* Set row start and end */
 545	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_ROW_RANGE, 0x00, ssd130x->height - 1);
 546	if (ret < 0)
 547		return ret;
 548	/*
 549	 * Horizontal Address Increment
 550	 * Re-map for Column Address, Nibble and COM
 551	 * COM Split Odd Even
 552	 */
 553	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_SEG_REMAP, 0x53);
 554	if (ret < 0)
 555		return ret;
 556
 557	/* Set display start and offset */
 558	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_DISPLAY_START, 0x00);
 559	if (ret < 0)
 560		return ret;
 561
 562	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_DISPLAY_OFFSET, 0x00);
 563	if (ret < 0)
 564		return ret;
 565
 566	/* Set display mode normal */
 567	ret = ssd130x_write_cmd(ssd130x, 1, SSD132X_SET_DISPLAY_NORMAL);
 568	if (ret < 0)
 569		return ret;
 570
 571	/* Set multiplex ratio value */
 572	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_MULTIPLEX_RATIO, ssd130x->height - 1);
 573	if (ret < 0)
 574		return ret;
 575
 576	/* Set phase length */
 577	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PHASE_LENGTH, 0x55);
 578	if (ret < 0)
 579		return ret;
 580
 581	/* Select default linear gray scale table */
 582	ret = ssd130x_write_cmd(ssd130x, 1, SSD132X_SELECT_DEFAULT_TABLE);
 583	if (ret < 0)
 584		return ret;
 585
 586	/* Set clock frequency */
 587	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_CLOCK_FREQ, 0x01);
 588	if (ret < 0)
 589		return ret;
 590
 591	/* Enable internal VDD regulator */
 592	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_FUNCTION_SELECT_A, 0x1);
 593	if (ret < 0)
 594		return ret;
 595
 596	/* Set pre-charge period */
 597	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_PERIOD, 0x01);
 598	if (ret < 0)
 599		return ret;
 600
 601	/* Set pre-charge voltage */
 602	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_VOLTAGE, 0x08);
 603	if (ret < 0)
 604		return ret;
 605
 606	/* Set VCOMH voltage */
 607	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_VCOMH_VOLTAGE, 0x07);
 608	if (ret < 0)
 609		return ret;
 610
 611	/* Enable second pre-charge and internal VSL */
 612	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_FUNCTION_SELECT_B, 0x62);
 613	if (ret < 0)
 614		return ret;
 615
 616	return 0;
 617}
 618
 619static int ssd133x_init(struct ssd130x_device *ssd130x)
 620{
 621	int ret;
 622
 623	/* Set color A contrast */
 624	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_CONTRAST_A, 0x91);
 625	if (ret < 0)
 626		return ret;
 627
 628	/* Set color B contrast */
 629	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_CONTRAST_B, 0x50);
 630	if (ret < 0)
 631		return ret;
 632
 633	/* Set color C contrast */
 634	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_CONTRAST_C, 0x7d);
 635	if (ret < 0)
 636		return ret;
 637
 638	/* Set master current */
 639	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_MASTER_CURRENT, 0x06);
 640	if (ret < 0)
 641		return ret;
 642
 643	/* Set column start and end */
 644	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_COL_RANGE, 0x00, ssd130x->width - 1);
 645	if (ret < 0)
 646		return ret;
 647
 648	/* Set row start and end */
 649	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_ROW_RANGE, 0x00, ssd130x->height - 1);
 650	if (ret < 0)
 651		return ret;
 652
 653	/*
 654	 * Horizontal Address Increment
 655	 * Normal order SA,SB,SC (e.g. RGB)
 656	 * COM Split Odd Even
 657	 * 256 color format
 658	 */
 659	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_SEG_REMAP, 0x20);
 660	if (ret < 0)
 661		return ret;
 662
 663	/* Set display start and offset */
 664	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_DISPLAY_START, 0x00);
 665	if (ret < 0)
 666		return ret;
 667
 668	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_DISPLAY_OFFSET, 0x00);
 669	if (ret < 0)
 670		return ret;
 671
 672	/* Set display mode normal */
 673	ret = ssd130x_write_cmd(ssd130x, 1, SSD133X_SET_DISPLAY_NORMAL);
 674	if (ret < 0)
 675		return ret;
 676
 677	/* Set multiplex ratio value */
 678	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_MULTIPLEX_RATIO, ssd130x->height - 1);
 679	if (ret < 0)
 680		return ret;
 681
 682	/* Set master configuration */
 683	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_MASTER_CONFIG, 0x8e);
 684	if (ret < 0)
 685		return ret;
 686
 687	/* Set power mode */
 688	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_POWER_SAVE_MODE, 0x0b);
 689	if (ret < 0)
 690		return ret;
 691
 692	/* Set Phase 1 and 2 period */
 693	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_PHASES_PERIOD, 0x31);
 694	if (ret < 0)
 695		return ret;
 696
 697	/* Set clock divider */
 698	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_CLOCK_FREQ, 0xf0);
 699	if (ret < 0)
 700		return ret;
 701
 702	/* Set pre-charge A */
 703	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_A, 0x64);
 704	if (ret < 0)
 705		return ret;
 706
 707	/* Set pre-charge B */
 708	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_B, 0x78);
 709	if (ret < 0)
 710		return ret;
 711
 712	/* Set pre-charge C */
 713	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_C, 0x64);
 714	if (ret < 0)
 715		return ret;
 716
 717	/* Set pre-charge level */
 718	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_PRECHARGE_VOLTAGE, 0x3a);
 719	if (ret < 0)
 720		return ret;
 721
 722	/* Set VCOMH voltage */
 723	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_VCOMH_VOLTAGE, 0x3e);
 724	if (ret < 0)
 725		return ret;
 726
 727	return 0;
 728}
 729
 730static int ssd130x_update_rect(struct ssd130x_device *ssd130x,
 731			       struct drm_rect *rect, u8 *buf,
 732			       u8 *data_array)
 733{
 734	unsigned int x = rect->x1;
 735	unsigned int y = rect->y1;
 736	unsigned int width = drm_rect_width(rect);
 737	unsigned int height = drm_rect_height(rect);
 738	unsigned int line_length = DIV_ROUND_UP(width, 8);
 739	unsigned int page_height = SSD130X_PAGE_HEIGHT;
 740	unsigned int pages = DIV_ROUND_UP(height, page_height);
 741	struct drm_device *drm = &ssd130x->drm;
 742	u32 array_idx = 0;
 743	int ret, i, j, k;
 744
 745	drm_WARN_ONCE(drm, y % page_height != 0, "y must be aligned to screen page\n");
 746
 747	/*
 748	 * The screen is divided in pages, each having a height of 8
 749	 * pixels, and the width of the screen. When sending a byte of
 750	 * data to the controller, it gives the 8 bits for the current
 751	 * column. I.e, the first byte are the 8 bits of the first
 752	 * column, then the 8 bits for the second column, etc.
 753	 *
 754	 *
 755	 * Representation of the screen, assuming it is 5 bits
 756	 * wide. Each letter-number combination is a bit that controls
 757	 * one pixel.
 758	 *
 759	 * A0 A1 A2 A3 A4
 760	 * B0 B1 B2 B3 B4
 761	 * C0 C1 C2 C3 C4
 762	 * D0 D1 D2 D3 D4
 763	 * E0 E1 E2 E3 E4
 764	 * F0 F1 F2 F3 F4
 765	 * G0 G1 G2 G3 G4
 766	 * H0 H1 H2 H3 H4
 767	 *
 768	 * If you want to update this screen, you need to send 5 bytes:
 769	 *  (1) A0 B0 C0 D0 E0 F0 G0 H0
 770	 *  (2) A1 B1 C1 D1 E1 F1 G1 H1
 771	 *  (3) A2 B2 C2 D2 E2 F2 G2 H2
 772	 *  (4) A3 B3 C3 D3 E3 F3 G3 H3
 773	 *  (5) A4 B4 C4 D4 E4 F4 G4 H4
 774	 */
 775
 776	if (!ssd130x->page_address_mode) {
 777		u8 page_start;
 778
 779		/* Set address range for horizontal addressing mode */
 780		ret = ssd130x_set_col_range(ssd130x, ssd130x->col_offset + x, width);
 781		if (ret < 0)
 782			return ret;
 783
 784		page_start = ssd130x->page_offset + y / page_height;
 785		ret = ssd130x_set_page_range(ssd130x, page_start, pages);
 786		if (ret < 0)
 787			return ret;
 788	}
 789
 790	for (i = 0; i < pages; i++) {
 791		int m = page_height;
 792
 793		/* Last page may be partial */
 794		if (page_height * (y / page_height + i + 1) > ssd130x->height)
 795			m = ssd130x->height % page_height;
 796
 797		for (j = 0; j < width; j++) {
 798			u8 data = 0;
 799
 800			for (k = 0; k < m; k++) {
 801				u32 idx = (page_height * i + k) * line_length + j / 8;
 802				u8 byte = buf[idx];
 803				u8 bit = (byte >> (j % 8)) & 1;
 804
 805				data |= bit << k;
 806			}
 807			data_array[array_idx++] = data;
 808		}
 809
 810		/*
 811		 * In page addressing mode, the start address needs to be reset,
 812		 * and each page then needs to be written out separately.
 813		 */
 814		if (ssd130x->page_address_mode) {
 815			ret = ssd130x_set_page_pos(ssd130x,
 816						   ssd130x->page_offset + i,
 817						   ssd130x->col_offset + x);
 818			if (ret < 0)
 819				return ret;
 820
 821			ret = ssd130x_write_data(ssd130x, data_array, width);
 822			if (ret < 0)
 823				return ret;
 824
 825			array_idx = 0;
 826		}
 827	}
 828
 829	/* Write out update in one go if we aren't using page addressing mode */
 830	if (!ssd130x->page_address_mode)
 831		ret = ssd130x_write_data(ssd130x, data_array, width * pages);
 832
 833	return ret;
 834}
 835
 836static int ssd132x_update_rect(struct ssd130x_device *ssd130x,
 837			       struct drm_rect *rect, u8 *buf,
 838			       u8 *data_array)
 839{
 840	unsigned int x = rect->x1;
 841	unsigned int y = rect->y1;
 842	unsigned int segment_width = SSD132X_SEGMENT_WIDTH;
 843	unsigned int width = drm_rect_width(rect);
 844	unsigned int height = drm_rect_height(rect);
 845	unsigned int columns = DIV_ROUND_UP(width, segment_width);
 846	unsigned int rows = height;
 847	struct drm_device *drm = &ssd130x->drm;
 848	u32 array_idx = 0;
 849	unsigned int i, j;
 850	int ret;
 851
 852	drm_WARN_ONCE(drm, x % segment_width != 0, "x must be aligned to screen segment\n");
 853
 854	/*
 855	 * The screen is divided in Segment and Common outputs, where
 856	 * COM0 to COM[N - 1] are the rows and SEG0 to SEG[M - 1] are
 857	 * the columns.
 858	 *
 859	 * Each Segment has a 4-bit pixel and each Common output has a
 860	 * row of pixels. When using the (default) horizontal address
 861	 * increment mode, each byte of data sent to the controller has
 862	 * two Segments (e.g: SEG0 and SEG1) that are stored in the lower
 863	 * and higher nibbles of a single byte representing one column.
 864	 * That is, the first byte are SEG0 (D0[3:0]) and SEG1 (D0[7:4]),
 865	 * the second byte are SEG2 (D1[3:0]) and SEG3 (D1[7:4]) and so on.
 866	 */
 867
 868	/* Set column start and end */
 869	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_COL_RANGE, x / segment_width, columns - 1);
 870	if (ret < 0)
 871		return ret;
 872
 873	/* Set row start and end */
 874	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_ROW_RANGE, y, rows - 1);
 875	if (ret < 0)
 876		return ret;
 877
 878	for (i = 0; i < height; i++) {
 879		/* Process pair of pixels and combine them into a single byte */
 880		for (j = 0; j < width; j += segment_width) {
 881			u8 n1 = buf[i * width + j];
 882			u8 n2 = buf[i * width + j + 1];
 883
 884			data_array[array_idx++] = (n2 << 4) | n1;
 885		}
 886	}
 887
 888	/* Write out update in one go since horizontal addressing mode is used */
 889	ret = ssd130x_write_data(ssd130x, data_array, columns * rows);
 890
 891	return ret;
 892}
 893
 894static int ssd133x_update_rect(struct ssd130x_device *ssd130x,
 895			       struct drm_rect *rect, u8 *data_array,
 896			       unsigned int pitch)
 897{
 898	unsigned int x = rect->x1;
 899	unsigned int y = rect->y1;
 900	unsigned int columns = drm_rect_width(rect);
 901	unsigned int rows = drm_rect_height(rect);
 902	int ret;
 903
 904	/*
 905	 * The screen is divided in Segment and Common outputs, where
 906	 * COM0 to COM[N - 1] are the rows and SEG0 to SEG[M - 1] are
 907	 * the columns.
 908	 *
 909	 * Each Segment has a 8-bit pixel and each Common output has a
 910	 * row of pixels. When using the (default) horizontal address
 911	 * increment mode, each byte of data sent to the controller has
 912	 * a Segment (e.g: SEG0).
 913	 *
 914	 * When using the 256 color depth format, each pixel contains 3
 915	 * sub-pixels for color A, B and C. These have 3 bit, 3 bit and
 916	 * 2 bits respectively.
 917	 */
 918
 919	/* Set column start and end */
 920	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_COL_RANGE, x, columns - 1);
 921	if (ret < 0)
 922		return ret;
 923
 924	/* Set row start and end */
 925	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_ROW_RANGE, y, rows - 1);
 926	if (ret < 0)
 927		return ret;
 928
 929	/* Write out update in one go since horizontal addressing mode is used */
 930	ret = ssd130x_write_data(ssd130x, data_array, pitch * rows);
 931
 932	return ret;
 933}
 934
 935static void ssd130x_clear_screen(struct ssd130x_device *ssd130x, u8 *data_array)
 936{
 937	unsigned int pages = DIV_ROUND_UP(ssd130x->height, SSD130X_PAGE_HEIGHT);
 938	unsigned int width = ssd130x->width;
 939	int ret, i;
 940
 941	if (!ssd130x->page_address_mode) {
 942		memset(data_array, 0, width * pages);
 943
 944		/* Set address range for horizontal addressing mode */
 945		ret = ssd130x_set_col_range(ssd130x, ssd130x->col_offset, width);
 946		if (ret < 0)
 947			return;
 948
 949		ret = ssd130x_set_page_range(ssd130x, ssd130x->page_offset, pages);
 950		if (ret < 0)
 951			return;
 952
 953		/* Write out update in one go if we aren't using page addressing mode */
 954		ssd130x_write_data(ssd130x, data_array, width * pages);
 955	} else {
 956		/*
 957		 * In page addressing mode, the start address needs to be reset,
 958		 * and each page then needs to be written out separately.
 959		 */
 960		memset(data_array, 0, width);
 961
 962		for (i = 0; i < pages; i++) {
 963			ret = ssd130x_set_page_pos(ssd130x,
 964						   ssd130x->page_offset + i,
 965						   ssd130x->col_offset);
 966			if (ret < 0)
 967				return;
 968
 969			ret = ssd130x_write_data(ssd130x, data_array, width);
 970			if (ret < 0)
 971				return;
 972		}
 973	}
 974}
 975
 976static void ssd132x_clear_screen(struct ssd130x_device *ssd130x, u8 *data_array)
 977{
 978	unsigned int columns = DIV_ROUND_UP(ssd130x->height, SSD132X_SEGMENT_WIDTH);
 979	unsigned int height = ssd130x->height;
 980
 981	memset(data_array, 0, columns * height);
 982
 983	/* Write out update in one go since horizontal addressing mode is used */
 984	ssd130x_write_data(ssd130x, data_array, columns * height);
 985}
 986
 987static void ssd133x_clear_screen(struct ssd130x_device *ssd130x, u8 *data_array)
 988{
 989	const struct drm_format_info *fi = drm_format_info(DRM_FORMAT_RGB332);
 990	unsigned int pitch;
 991
 992	if (!fi)
 993		return;
 994
 995	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
 996
 997	memset(data_array, 0, pitch * ssd130x->height);
 998
 999	/* Write out update in one go since horizontal addressing mode is used */
1000	ssd130x_write_data(ssd130x, data_array, pitch * ssd130x->height);
1001}
1002
1003static int ssd130x_fb_blit_rect(struct drm_framebuffer *fb,
1004				const struct iosys_map *vmap,
1005				struct drm_rect *rect,
1006				u8 *buf, u8 *data_array,
1007				struct drm_format_conv_state *fmtcnv_state)
1008{
1009	struct ssd130x_device *ssd130x = drm_to_ssd130x(fb->dev);
1010	struct iosys_map dst;
1011	unsigned int dst_pitch;
1012	int ret = 0;
1013
1014	/* Align y to display page boundaries */
1015	rect->y1 = round_down(rect->y1, SSD130X_PAGE_HEIGHT);
1016	rect->y2 = min_t(unsigned int, round_up(rect->y2, SSD130X_PAGE_HEIGHT), ssd130x->height);
1017
1018	dst_pitch = DIV_ROUND_UP(drm_rect_width(rect), 8);
1019
1020	ret = drm_gem_fb_begin_cpu_access(fb, DMA_FROM_DEVICE);
1021	if (ret)
1022		return ret;
1023
1024	iosys_map_set_vaddr(&dst, buf);
1025	drm_fb_xrgb8888_to_mono(&dst, &dst_pitch, vmap, fb, rect, fmtcnv_state);
1026
1027	drm_gem_fb_end_cpu_access(fb, DMA_FROM_DEVICE);
1028
1029	ssd130x_update_rect(ssd130x, rect, buf, data_array);
1030
1031	return ret;
1032}
1033
1034static int ssd132x_fb_blit_rect(struct drm_framebuffer *fb,
1035				const struct iosys_map *vmap,
1036				struct drm_rect *rect, u8 *buf,
1037				u8 *data_array,
1038				struct drm_format_conv_state *fmtcnv_state)
1039{
1040	struct ssd130x_device *ssd130x = drm_to_ssd130x(fb->dev);
1041	unsigned int dst_pitch = drm_rect_width(rect);
1042	struct iosys_map dst;
1043	int ret = 0;
1044
1045	/* Align x to display segment boundaries */
1046	rect->x1 = round_down(rect->x1, SSD132X_SEGMENT_WIDTH);
1047	rect->x2 = min_t(unsigned int, round_up(rect->x2, SSD132X_SEGMENT_WIDTH),
1048			 ssd130x->width);
1049
1050	ret = drm_gem_fb_begin_cpu_access(fb, DMA_FROM_DEVICE);
1051	if (ret)
1052		return ret;
1053
1054	iosys_map_set_vaddr(&dst, buf);
1055	drm_fb_xrgb8888_to_gray8(&dst, &dst_pitch, vmap, fb, rect, fmtcnv_state);
1056
1057	drm_gem_fb_end_cpu_access(fb, DMA_FROM_DEVICE);
1058
1059	ssd132x_update_rect(ssd130x, rect, buf, data_array);
1060
1061	return ret;
1062}
1063
1064static int ssd133x_fb_blit_rect(struct drm_framebuffer *fb,
1065				const struct iosys_map *vmap,
1066				struct drm_rect *rect, u8 *data_array,
1067				struct drm_format_conv_state *fmtcnv_state)
1068{
1069	struct ssd130x_device *ssd130x = drm_to_ssd130x(fb->dev);
1070	const struct drm_format_info *fi = drm_format_info(DRM_FORMAT_RGB332);
1071	unsigned int dst_pitch;
1072	struct iosys_map dst;
1073	int ret = 0;
1074
1075	if (!fi)
1076		return -EINVAL;
1077
1078	dst_pitch = drm_format_info_min_pitch(fi, 0, drm_rect_width(rect));
1079
1080	ret = drm_gem_fb_begin_cpu_access(fb, DMA_FROM_DEVICE);
1081	if (ret)
1082		return ret;
1083
1084	iosys_map_set_vaddr(&dst, data_array);
1085	drm_fb_xrgb8888_to_rgb332(&dst, &dst_pitch, vmap, fb, rect, fmtcnv_state);
1086
1087	drm_gem_fb_end_cpu_access(fb, DMA_FROM_DEVICE);
1088
1089	ssd133x_update_rect(ssd130x, rect, data_array, dst_pitch);
1090
1091	return ret;
1092}
1093
1094static int ssd130x_primary_plane_atomic_check(struct drm_plane *plane,
1095					      struct drm_atomic_state *state)
1096{
1097	struct drm_device *drm = plane->dev;
1098	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1099	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1100	struct ssd130x_plane_state *ssd130x_state = to_ssd130x_plane_state(plane_state);
1101	struct drm_shadow_plane_state *shadow_plane_state = &ssd130x_state->base;
1102	struct drm_crtc *crtc = plane_state->crtc;
1103	struct drm_crtc_state *crtc_state = NULL;
1104	const struct drm_format_info *fi;
1105	unsigned int pitch;
1106	int ret;
1107
1108	if (crtc)
1109		crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1110
1111	ret = drm_atomic_helper_check_plane_state(plane_state, crtc_state,
1112						  DRM_PLANE_NO_SCALING,
1113						  DRM_PLANE_NO_SCALING,
1114						  false, false);
1115	if (ret)
1116		return ret;
1117	else if (!plane_state->visible)
1118		return 0;
1119
1120	fi = drm_format_info(DRM_FORMAT_R1);
1121	if (!fi)
1122		return -EINVAL;
1123
1124	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
1125
1126	if (plane_state->fb->format != fi) {
1127		void *buf;
1128
1129		/* format conversion necessary; reserve buffer */
1130		buf = drm_format_conv_state_reserve(&shadow_plane_state->fmtcnv_state,
1131						    pitch, GFP_KERNEL);
1132		if (!buf)
1133			return -ENOMEM;
1134	}
1135
1136	ssd130x_state->buffer = kcalloc(pitch, ssd130x->height, GFP_KERNEL);
1137	if (!ssd130x_state->buffer)
1138		return -ENOMEM;
1139
1140	return 0;
1141}
1142
1143static int ssd132x_primary_plane_atomic_check(struct drm_plane *plane,
1144					      struct drm_atomic_state *state)
1145{
1146	struct drm_device *drm = plane->dev;
1147	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1148	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1149	struct ssd130x_plane_state *ssd130x_state = to_ssd130x_plane_state(plane_state);
1150	struct drm_shadow_plane_state *shadow_plane_state = &ssd130x_state->base;
1151	struct drm_crtc *crtc = plane_state->crtc;
1152	struct drm_crtc_state *crtc_state = NULL;
1153	const struct drm_format_info *fi;
1154	unsigned int pitch;
1155	int ret;
1156
1157	if (crtc)
1158		crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1159
1160	ret = drm_atomic_helper_check_plane_state(plane_state, crtc_state,
1161						  DRM_PLANE_NO_SCALING,
1162						  DRM_PLANE_NO_SCALING,
1163						  false, false);
1164	if (ret)
1165		return ret;
1166	else if (!plane_state->visible)
1167		return 0;
1168
1169	fi = drm_format_info(DRM_FORMAT_R8);
1170	if (!fi)
1171		return -EINVAL;
1172
1173	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
1174
1175	if (plane_state->fb->format != fi) {
1176		void *buf;
1177
1178		/* format conversion necessary; reserve buffer */
1179		buf = drm_format_conv_state_reserve(&shadow_plane_state->fmtcnv_state,
1180						    pitch, GFP_KERNEL);
1181		if (!buf)
1182			return -ENOMEM;
1183	}
1184
1185	ssd130x_state->buffer = kcalloc(pitch, ssd130x->height, GFP_KERNEL);
1186	if (!ssd130x_state->buffer)
1187		return -ENOMEM;
1188
1189	return 0;
1190}
1191
1192static int ssd133x_primary_plane_atomic_check(struct drm_plane *plane,
1193					      struct drm_atomic_state *state)
1194{
1195	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1196	struct drm_crtc *crtc = plane_state->crtc;
1197	struct drm_crtc_state *crtc_state = NULL;
1198	int ret;
1199
1200	if (crtc)
1201		crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1202
1203	ret = drm_atomic_helper_check_plane_state(plane_state, crtc_state,
1204						  DRM_PLANE_NO_SCALING,
1205						  DRM_PLANE_NO_SCALING,
1206						  false, false);
1207	if (ret)
1208		return ret;
1209	else if (!plane_state->visible)
1210		return 0;
1211
1212	return 0;
1213}
1214
1215static void ssd130x_primary_plane_atomic_update(struct drm_plane *plane,
1216						struct drm_atomic_state *state)
1217{
1218	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1219	struct drm_plane_state *old_plane_state = drm_atomic_get_old_plane_state(state, plane);
1220	struct drm_shadow_plane_state *shadow_plane_state = to_drm_shadow_plane_state(plane_state);
1221	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1222	struct ssd130x_crtc_state *ssd130x_crtc_state =  to_ssd130x_crtc_state(crtc_state);
1223	struct ssd130x_plane_state *ssd130x_plane_state = to_ssd130x_plane_state(plane_state);
1224	struct drm_framebuffer *fb = plane_state->fb;
1225	struct drm_atomic_helper_damage_iter iter;
1226	struct drm_device *drm = plane->dev;
1227	struct drm_rect dst_clip;
1228	struct drm_rect damage;
1229	int idx;
1230
1231	if (!drm_dev_enter(drm, &idx))
1232		return;
1233
1234	drm_atomic_helper_damage_iter_init(&iter, old_plane_state, plane_state);
1235	drm_atomic_for_each_plane_damage(&iter, &damage) {
1236		dst_clip = plane_state->dst;
1237
1238		if (!drm_rect_intersect(&dst_clip, &damage))
1239			continue;
1240
1241		ssd130x_fb_blit_rect(fb, &shadow_plane_state->data[0], &dst_clip,
1242				     ssd130x_plane_state->buffer,
1243				     ssd130x_crtc_state->data_array,
1244				     &shadow_plane_state->fmtcnv_state);
1245	}
1246
1247	drm_dev_exit(idx);
1248}
1249
1250static void ssd132x_primary_plane_atomic_update(struct drm_plane *plane,
1251						struct drm_atomic_state *state)
1252{
1253	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1254	struct drm_plane_state *old_plane_state = drm_atomic_get_old_plane_state(state, plane);
1255	struct drm_shadow_plane_state *shadow_plane_state = to_drm_shadow_plane_state(plane_state);
1256	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1257	struct ssd130x_crtc_state *ssd130x_crtc_state =  to_ssd130x_crtc_state(crtc_state);
1258	struct ssd130x_plane_state *ssd130x_plane_state = to_ssd130x_plane_state(plane_state);
1259	struct drm_framebuffer *fb = plane_state->fb;
1260	struct drm_atomic_helper_damage_iter iter;
1261	struct drm_device *drm = plane->dev;
1262	struct drm_rect dst_clip;
1263	struct drm_rect damage;
1264	int idx;
1265
1266	if (!drm_dev_enter(drm, &idx))
1267		return;
1268
1269	drm_atomic_helper_damage_iter_init(&iter, old_plane_state, plane_state);
1270	drm_atomic_for_each_plane_damage(&iter, &damage) {
1271		dst_clip = plane_state->dst;
1272
1273		if (!drm_rect_intersect(&dst_clip, &damage))
1274			continue;
1275
1276		ssd132x_fb_blit_rect(fb, &shadow_plane_state->data[0], &dst_clip,
1277				     ssd130x_plane_state->buffer,
1278				     ssd130x_crtc_state->data_array,
1279				     &shadow_plane_state->fmtcnv_state);
1280	}
1281
1282	drm_dev_exit(idx);
1283}
1284
1285static void ssd133x_primary_plane_atomic_update(struct drm_plane *plane,
1286						struct drm_atomic_state *state)
1287{
1288	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1289	struct drm_plane_state *old_plane_state = drm_atomic_get_old_plane_state(state, plane);
1290	struct drm_shadow_plane_state *shadow_plane_state = to_drm_shadow_plane_state(plane_state);
1291	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1292	struct ssd130x_crtc_state *ssd130x_crtc_state =  to_ssd130x_crtc_state(crtc_state);
1293	struct drm_framebuffer *fb = plane_state->fb;
1294	struct drm_atomic_helper_damage_iter iter;
1295	struct drm_device *drm = plane->dev;
1296	struct drm_rect dst_clip;
1297	struct drm_rect damage;
1298	int idx;
1299
1300	if (!drm_dev_enter(drm, &idx))
1301		return;
1302
1303	drm_atomic_helper_damage_iter_init(&iter, old_plane_state, plane_state);
1304	drm_atomic_for_each_plane_damage(&iter, &damage) {
1305		dst_clip = plane_state->dst;
1306
1307		if (!drm_rect_intersect(&dst_clip, &damage))
1308			continue;
1309
1310		ssd133x_fb_blit_rect(fb, &shadow_plane_state->data[0], &dst_clip,
1311				     ssd130x_crtc_state->data_array,
1312				     &shadow_plane_state->fmtcnv_state);
1313	}
1314
1315	drm_dev_exit(idx);
1316}
1317
1318static void ssd130x_primary_plane_atomic_disable(struct drm_plane *plane,
1319						 struct drm_atomic_state *state)
1320{
1321	struct drm_device *drm = plane->dev;
1322	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1323	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1324	struct drm_crtc_state *crtc_state;
1325	struct ssd130x_crtc_state *ssd130x_crtc_state;
1326	int idx;
1327
1328	if (!plane_state->crtc)
1329		return;
1330
1331	crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1332	ssd130x_crtc_state = to_ssd130x_crtc_state(crtc_state);
1333
1334	if (!drm_dev_enter(drm, &idx))
1335		return;
1336
1337	ssd130x_clear_screen(ssd130x, ssd130x_crtc_state->data_array);
1338
1339	drm_dev_exit(idx);
1340}
1341
1342static void ssd132x_primary_plane_atomic_disable(struct drm_plane *plane,
1343						 struct drm_atomic_state *state)
1344{
1345	struct drm_device *drm = plane->dev;
1346	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1347	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1348	struct drm_crtc_state *crtc_state;
1349	struct ssd130x_crtc_state *ssd130x_crtc_state;
1350	int idx;
1351
1352	if (!plane_state->crtc)
1353		return;
1354
1355	crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1356	ssd130x_crtc_state = to_ssd130x_crtc_state(crtc_state);
1357
1358	if (!drm_dev_enter(drm, &idx))
1359		return;
1360
1361	ssd132x_clear_screen(ssd130x, ssd130x_crtc_state->data_array);
1362
1363	drm_dev_exit(idx);
1364}
1365
1366static void ssd133x_primary_plane_atomic_disable(struct drm_plane *plane,
1367						 struct drm_atomic_state *state)
1368{
1369	struct drm_device *drm = plane->dev;
1370	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1371	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1372	struct drm_crtc_state *crtc_state;
1373	struct ssd130x_crtc_state *ssd130x_crtc_state;
1374	int idx;
1375
1376	if (!plane_state->crtc)
1377		return;
1378
1379	crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1380	ssd130x_crtc_state = to_ssd130x_crtc_state(crtc_state);
1381
1382	if (!drm_dev_enter(drm, &idx))
1383		return;
1384
1385	ssd133x_clear_screen(ssd130x, ssd130x_crtc_state->data_array);
1386
1387	drm_dev_exit(idx);
1388}
1389
1390/* Called during init to allocate the plane's atomic state. */
1391static void ssd130x_primary_plane_reset(struct drm_plane *plane)
1392{
1393	struct ssd130x_plane_state *ssd130x_state;
1394
1395	WARN_ON(plane->state);
1396
1397	ssd130x_state = kzalloc(sizeof(*ssd130x_state), GFP_KERNEL);
1398	if (!ssd130x_state)
1399		return;
1400
1401	__drm_gem_reset_shadow_plane(plane, &ssd130x_state->base);
1402}
1403
1404static struct drm_plane_state *ssd130x_primary_plane_duplicate_state(struct drm_plane *plane)
1405{
1406	struct drm_shadow_plane_state *new_shadow_plane_state;
1407	struct ssd130x_plane_state *old_ssd130x_state;
1408	struct ssd130x_plane_state *ssd130x_state;
1409
1410	if (WARN_ON(!plane->state))
1411		return NULL;
1412
1413	old_ssd130x_state = to_ssd130x_plane_state(plane->state);
1414	ssd130x_state = kmemdup(old_ssd130x_state, sizeof(*ssd130x_state), GFP_KERNEL);
1415	if (!ssd130x_state)
1416		return NULL;
1417
1418	/* The buffer is not duplicated and is allocated in .atomic_check */
1419	ssd130x_state->buffer = NULL;
1420
1421	new_shadow_plane_state = &ssd130x_state->base;
1422
1423	__drm_gem_duplicate_shadow_plane_state(plane, new_shadow_plane_state);
1424
1425	return &new_shadow_plane_state->base;
1426}
1427
1428static void ssd130x_primary_plane_destroy_state(struct drm_plane *plane,
1429						struct drm_plane_state *state)
1430{
1431	struct ssd130x_plane_state *ssd130x_state = to_ssd130x_plane_state(state);
1432
1433	kfree(ssd130x_state->buffer);
1434
1435	__drm_gem_destroy_shadow_plane_state(&ssd130x_state->base);
1436
1437	kfree(ssd130x_state);
1438}
1439
1440static const struct drm_plane_helper_funcs ssd130x_primary_plane_helper_funcs[] = {
1441	[SSD130X_FAMILY] = {
1442		DRM_GEM_SHADOW_PLANE_HELPER_FUNCS,
1443		.atomic_check = ssd130x_primary_plane_atomic_check,
1444		.atomic_update = ssd130x_primary_plane_atomic_update,
1445		.atomic_disable = ssd130x_primary_plane_atomic_disable,
1446	},
1447	[SSD132X_FAMILY] = {
1448		DRM_GEM_SHADOW_PLANE_HELPER_FUNCS,
1449		.atomic_check = ssd132x_primary_plane_atomic_check,
1450		.atomic_update = ssd132x_primary_plane_atomic_update,
1451		.atomic_disable = ssd132x_primary_plane_atomic_disable,
1452	},
1453	[SSD133X_FAMILY] = {
1454		DRM_GEM_SHADOW_PLANE_HELPER_FUNCS,
1455		.atomic_check = ssd133x_primary_plane_atomic_check,
1456		.atomic_update = ssd133x_primary_plane_atomic_update,
1457		.atomic_disable = ssd133x_primary_plane_atomic_disable,
1458	}
1459};
1460
1461static const struct drm_plane_funcs ssd130x_primary_plane_funcs = {
1462	.update_plane = drm_atomic_helper_update_plane,
1463	.disable_plane = drm_atomic_helper_disable_plane,
1464	.reset = ssd130x_primary_plane_reset,
1465	.atomic_duplicate_state = ssd130x_primary_plane_duplicate_state,
1466	.atomic_destroy_state = ssd130x_primary_plane_destroy_state,
1467	.destroy = drm_plane_cleanup,
1468};
1469
1470static enum drm_mode_status ssd130x_crtc_mode_valid(struct drm_crtc *crtc,
1471						    const struct drm_display_mode *mode)
1472{
1473	struct ssd130x_device *ssd130x = drm_to_ssd130x(crtc->dev);
1474
1475	if (mode->hdisplay != ssd130x->mode.hdisplay &&
1476	    mode->vdisplay != ssd130x->mode.vdisplay)
1477		return MODE_ONE_SIZE;
1478	else if (mode->hdisplay != ssd130x->mode.hdisplay)
1479		return MODE_ONE_WIDTH;
1480	else if (mode->vdisplay != ssd130x->mode.vdisplay)
1481		return MODE_ONE_HEIGHT;
1482
1483	return MODE_OK;
1484}
1485
1486static int ssd130x_crtc_atomic_check(struct drm_crtc *crtc,
1487				     struct drm_atomic_state *state)
1488{
1489	struct drm_device *drm = crtc->dev;
1490	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1491	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1492	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(crtc_state);
1493	unsigned int pages = DIV_ROUND_UP(ssd130x->height, SSD130X_PAGE_HEIGHT);
1494	int ret;
1495
1496	ret = drm_crtc_helper_atomic_check(crtc, state);
1497	if (ret)
1498		return ret;
1499
1500	ssd130x_state->data_array = kmalloc(ssd130x->width * pages, GFP_KERNEL);
1501	if (!ssd130x_state->data_array)
1502		return -ENOMEM;
1503
1504	return 0;
1505}
1506
1507static int ssd132x_crtc_atomic_check(struct drm_crtc *crtc,
1508				     struct drm_atomic_state *state)
1509{
1510	struct drm_device *drm = crtc->dev;
1511	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1512	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1513	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(crtc_state);
1514	unsigned int columns = DIV_ROUND_UP(ssd130x->width, SSD132X_SEGMENT_WIDTH);
1515	int ret;
1516
1517	ret = drm_crtc_helper_atomic_check(crtc, state);
1518	if (ret)
1519		return ret;
1520
1521	ssd130x_state->data_array = kmalloc(columns * ssd130x->height, GFP_KERNEL);
1522	if (!ssd130x_state->data_array)
1523		return -ENOMEM;
1524
1525	return 0;
1526}
1527
1528static int ssd133x_crtc_atomic_check(struct drm_crtc *crtc,
1529				     struct drm_atomic_state *state)
1530{
1531	struct drm_device *drm = crtc->dev;
1532	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1533	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1534	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(crtc_state);
1535	const struct drm_format_info *fi = drm_format_info(DRM_FORMAT_RGB332);
1536	unsigned int pitch;
1537	int ret;
1538
1539	if (!fi)
1540		return -EINVAL;
1541
1542	ret = drm_crtc_helper_atomic_check(crtc, state);
1543	if (ret)
1544		return ret;
1545
1546	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
1547
1548	ssd130x_state->data_array = kmalloc(pitch * ssd130x->height, GFP_KERNEL);
1549	if (!ssd130x_state->data_array)
1550		return -ENOMEM;
1551
1552	return 0;
1553}
1554
1555/* Called during init to allocate the CRTC's atomic state. */
1556static void ssd130x_crtc_reset(struct drm_crtc *crtc)
1557{
1558	struct ssd130x_crtc_state *ssd130x_state;
1559
1560	WARN_ON(crtc->state);
1561
1562	ssd130x_state = kzalloc(sizeof(*ssd130x_state), GFP_KERNEL);
1563	if (!ssd130x_state)
1564		return;
1565
1566	__drm_atomic_helper_crtc_reset(crtc, &ssd130x_state->base);
1567}
1568
1569static struct drm_crtc_state *ssd130x_crtc_duplicate_state(struct drm_crtc *crtc)
1570{
1571	struct ssd130x_crtc_state *old_ssd130x_state;
1572	struct ssd130x_crtc_state *ssd130x_state;
1573
1574	if (WARN_ON(!crtc->state))
1575		return NULL;
1576
1577	old_ssd130x_state = to_ssd130x_crtc_state(crtc->state);
1578	ssd130x_state = kmemdup(old_ssd130x_state, sizeof(*ssd130x_state), GFP_KERNEL);
1579	if (!ssd130x_state)
1580		return NULL;
1581
1582	/* The buffer is not duplicated and is allocated in .atomic_check */
1583	ssd130x_state->data_array = NULL;
1584
1585	__drm_atomic_helper_crtc_duplicate_state(crtc, &ssd130x_state->base);
1586
1587	return &ssd130x_state->base;
1588}
1589
1590static void ssd130x_crtc_destroy_state(struct drm_crtc *crtc,
1591				       struct drm_crtc_state *state)
1592{
1593	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(state);
1594
1595	kfree(ssd130x_state->data_array);
1596
1597	__drm_atomic_helper_crtc_destroy_state(state);
1598
1599	kfree(ssd130x_state);
1600}
1601
1602/*
1603 * The CRTC is always enabled. Screen updates are performed by
1604 * the primary plane's atomic_update function. Disabling clears
1605 * the screen in the primary plane's atomic_disable function.
1606 */
1607static const struct drm_crtc_helper_funcs ssd130x_crtc_helper_funcs[] = {
1608	[SSD130X_FAMILY] = {
1609		.mode_valid = ssd130x_crtc_mode_valid,
1610		.atomic_check = ssd130x_crtc_atomic_check,
1611	},
1612	[SSD132X_FAMILY] = {
1613		.mode_valid = ssd130x_crtc_mode_valid,
1614		.atomic_check = ssd132x_crtc_atomic_check,
1615	},
1616	[SSD133X_FAMILY] = {
1617		.mode_valid = ssd130x_crtc_mode_valid,
1618		.atomic_check = ssd133x_crtc_atomic_check,
1619	},
1620};
1621
1622static const struct drm_crtc_funcs ssd130x_crtc_funcs = {
1623	.reset = ssd130x_crtc_reset,
1624	.destroy = drm_crtc_cleanup,
1625	.set_config = drm_atomic_helper_set_config,
1626	.page_flip = drm_atomic_helper_page_flip,
1627	.atomic_duplicate_state = ssd130x_crtc_duplicate_state,
1628	.atomic_destroy_state = ssd130x_crtc_destroy_state,
1629};
1630
1631static void ssd130x_encoder_atomic_enable(struct drm_encoder *encoder,
1632					  struct drm_atomic_state *state)
1633{
1634	struct drm_device *drm = encoder->dev;
1635	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1636	int ret;
1637
1638	ret = ssd130x_power_on(ssd130x);
1639	if (ret)
1640		return;
1641
1642	ret = ssd130x_init(ssd130x);
1643	if (ret)
1644		goto power_off;
1645
1646	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_ON);
1647
1648	backlight_enable(ssd130x->bl_dev);
1649
1650	return;
1651
1652power_off:
1653	ssd130x_power_off(ssd130x);
1654	return;
1655}
1656
1657static void ssd132x_encoder_atomic_enable(struct drm_encoder *encoder,
1658					  struct drm_atomic_state *state)
1659{
1660	struct drm_device *drm = encoder->dev;
1661	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1662	int ret;
1663
1664	ret = ssd130x_power_on(ssd130x);
1665	if (ret)
1666		return;
1667
1668	ret = ssd132x_init(ssd130x);
1669	if (ret)
1670		goto power_off;
1671
1672	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_ON);
1673
1674	backlight_enable(ssd130x->bl_dev);
1675
1676	return;
1677
1678power_off:
1679	ssd130x_power_off(ssd130x);
1680}
1681
1682static void ssd133x_encoder_atomic_enable(struct drm_encoder *encoder,
1683					  struct drm_atomic_state *state)
1684{
1685	struct drm_device *drm = encoder->dev;
1686	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1687	int ret;
1688
1689	ret = ssd130x_power_on(ssd130x);
1690	if (ret)
1691		return;
1692
1693	ret = ssd133x_init(ssd130x);
1694	if (ret)
1695		goto power_off;
1696
1697	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_ON);
1698
1699	backlight_enable(ssd130x->bl_dev);
1700
1701	return;
1702
1703power_off:
1704	ssd130x_power_off(ssd130x);
1705}
1706
1707static void ssd130x_encoder_atomic_disable(struct drm_encoder *encoder,
1708					   struct drm_atomic_state *state)
1709{
1710	struct drm_device *drm = encoder->dev;
1711	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1712
1713	backlight_disable(ssd130x->bl_dev);
1714
1715	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_OFF);
1716
1717	ssd130x_power_off(ssd130x);
1718}
1719
1720static const struct drm_encoder_helper_funcs ssd130x_encoder_helper_funcs[] = {
1721	[SSD130X_FAMILY] = {
1722		.atomic_enable = ssd130x_encoder_atomic_enable,
1723		.atomic_disable = ssd130x_encoder_atomic_disable,
1724	},
1725	[SSD132X_FAMILY] = {
1726		.atomic_enable = ssd132x_encoder_atomic_enable,
1727		.atomic_disable = ssd130x_encoder_atomic_disable,
1728	},
1729	[SSD133X_FAMILY] = {
1730		.atomic_enable = ssd133x_encoder_atomic_enable,
1731		.atomic_disable = ssd130x_encoder_atomic_disable,
1732	}
1733};
1734
1735static const struct drm_encoder_funcs ssd130x_encoder_funcs = {
1736	.destroy = drm_encoder_cleanup,
1737};
1738
1739static int ssd130x_connector_get_modes(struct drm_connector *connector)
1740{
1741	struct ssd130x_device *ssd130x = drm_to_ssd130x(connector->dev);
1742	struct drm_display_mode *mode;
1743	struct device *dev = ssd130x->dev;
1744
1745	mode = drm_mode_duplicate(connector->dev, &ssd130x->mode);
1746	if (!mode) {
1747		dev_err(dev, "Failed to duplicated mode\n");
1748		return 0;
1749	}
1750
1751	drm_mode_probed_add(connector, mode);
1752	drm_set_preferred_mode(connector, mode->hdisplay, mode->vdisplay);
1753
1754	/* There is only a single mode */
1755	return 1;
1756}
1757
1758static const struct drm_connector_helper_funcs ssd130x_connector_helper_funcs = {
1759	.get_modes = ssd130x_connector_get_modes,
1760};
1761
1762static const struct drm_connector_funcs ssd130x_connector_funcs = {
1763	.reset = drm_atomic_helper_connector_reset,
1764	.fill_modes = drm_helper_probe_single_connector_modes,
1765	.destroy = drm_connector_cleanup,
1766	.atomic_duplicate_state = drm_atomic_helper_connector_duplicate_state,
1767	.atomic_destroy_state = drm_atomic_helper_connector_destroy_state,
1768};
1769
1770static const struct drm_mode_config_funcs ssd130x_mode_config_funcs = {
1771	.fb_create = drm_gem_fb_create_with_dirty,
1772	.atomic_check = drm_atomic_helper_check,
1773	.atomic_commit = drm_atomic_helper_commit,
1774};
1775
1776static const uint32_t ssd130x_formats[] = {
1777	DRM_FORMAT_XRGB8888,
1778};
1779
1780DEFINE_DRM_GEM_FOPS(ssd130x_fops);
1781
1782static const struct drm_driver ssd130x_drm_driver = {
1783	DRM_GEM_SHMEM_DRIVER_OPS,
1784	DRM_FBDEV_SHMEM_DRIVER_OPS,
1785	.name			= DRIVER_NAME,
1786	.desc			= DRIVER_DESC,
1787	.date			= DRIVER_DATE,
1788	.major			= DRIVER_MAJOR,
1789	.minor			= DRIVER_MINOR,
1790	.driver_features	= DRIVER_ATOMIC | DRIVER_GEM | DRIVER_MODESET,
1791	.fops			= &ssd130x_fops,
1792};
1793
1794static int ssd130x_update_bl(struct backlight_device *bdev)
1795{
1796	struct ssd130x_device *ssd130x = bl_get_data(bdev);
1797	int brightness = backlight_get_brightness(bdev);
1798	int ret;
1799
1800	ssd130x->contrast = brightness;
1801
1802	ret = ssd130x_write_cmd(ssd130x, 1, SSD13XX_CONTRAST);
1803	if (ret < 0)
1804		return ret;
1805
1806	ret = ssd130x_write_cmd(ssd130x, 1, ssd130x->contrast);
1807	if (ret < 0)
1808		return ret;
1809
1810	return 0;
1811}
1812
1813static const struct backlight_ops ssd130xfb_bl_ops = {
1814	.update_status	= ssd130x_update_bl,
1815};
1816
1817static void ssd130x_parse_properties(struct ssd130x_device *ssd130x)
1818{
1819	struct device *dev = ssd130x->dev;
1820
1821	if (device_property_read_u32(dev, "solomon,width", &ssd130x->width))
1822		ssd130x->width = ssd130x->device_info->default_width;
1823
1824	if (device_property_read_u32(dev, "solomon,height", &ssd130x->height))
1825		ssd130x->height = ssd130x->device_info->default_height;
1826
1827	if (device_property_read_u32(dev, "solomon,page-offset", &ssd130x->page_offset))
1828		ssd130x->page_offset = 1;
1829
1830	if (device_property_read_u32(dev, "solomon,col-offset", &ssd130x->col_offset))
1831		ssd130x->col_offset = 0;
1832
1833	if (device_property_read_u32(dev, "solomon,com-offset", &ssd130x->com_offset))
1834		ssd130x->com_offset = 0;
1835
1836	if (device_property_read_u32(dev, "solomon,prechargep1", &ssd130x->prechargep1))
1837		ssd130x->prechargep1 = 2;
1838
1839	if (device_property_read_u32(dev, "solomon,prechargep2", &ssd130x->prechargep2))
1840		ssd130x->prechargep2 = 2;
1841
1842	if (!device_property_read_u8_array(dev, "solomon,lookup-table",
1843					   ssd130x->lookup_table,
1844					   ARRAY_SIZE(ssd130x->lookup_table)))
1845		ssd130x->lookup_table_set = 1;
1846
1847	ssd130x->seg_remap = !device_property_read_bool(dev, "solomon,segment-no-remap");
1848	ssd130x->com_seq = device_property_read_bool(dev, "solomon,com-seq");
1849	ssd130x->com_lrremap = device_property_read_bool(dev, "solomon,com-lrremap");
1850	ssd130x->com_invdir = device_property_read_bool(dev, "solomon,com-invdir");
1851	ssd130x->area_color_enable =
1852		device_property_read_bool(dev, "solomon,area-color-enable");
1853	ssd130x->low_power = device_property_read_bool(dev, "solomon,low-power");
1854
1855	ssd130x->contrast = 127;
1856	ssd130x->vcomh = ssd130x->device_info->default_vcomh;
1857
1858	/* Setup display timing */
1859	if (device_property_read_u32(dev, "solomon,dclk-div", &ssd130x->dclk_div))
1860		ssd130x->dclk_div = ssd130x->device_info->default_dclk_div;
1861	if (device_property_read_u32(dev, "solomon,dclk-frq", &ssd130x->dclk_frq))
1862		ssd130x->dclk_frq = ssd130x->device_info->default_dclk_frq;
1863}
1864
1865static int ssd130x_init_modeset(struct ssd130x_device *ssd130x)
1866{
1867	enum ssd130x_family_ids family_id = ssd130x->device_info->family_id;
1868	struct drm_display_mode *mode = &ssd130x->mode;
1869	struct device *dev = ssd130x->dev;
1870	struct drm_device *drm = &ssd130x->drm;
1871	unsigned long max_width, max_height;
1872	struct drm_plane *primary_plane;
1873	struct drm_crtc *crtc;
1874	struct drm_encoder *encoder;
1875	struct drm_connector *connector;
1876	int ret;
1877
1878	/*
1879	 * Modesetting
1880	 */
1881
1882	ret = drmm_mode_config_init(drm);
1883	if (ret) {
1884		dev_err(dev, "DRM mode config init failed: %d\n", ret);
1885		return ret;
1886	}
1887
1888	mode->type = DRM_MODE_TYPE_DRIVER;
1889	mode->clock = 1;
1890	mode->hdisplay = mode->htotal = ssd130x->width;
1891	mode->hsync_start = mode->hsync_end = ssd130x->width;
1892	mode->vdisplay = mode->vtotal = ssd130x->height;
1893	mode->vsync_start = mode->vsync_end = ssd130x->height;
1894	mode->width_mm = 27;
1895	mode->height_mm = 27;
1896
1897	max_width = max_t(unsigned long, mode->hdisplay, DRM_SHADOW_PLANE_MAX_WIDTH);
1898	max_height = max_t(unsigned long, mode->vdisplay, DRM_SHADOW_PLANE_MAX_HEIGHT);
1899
1900	drm->mode_config.min_width = mode->hdisplay;
1901	drm->mode_config.max_width = max_width;
1902	drm->mode_config.min_height = mode->vdisplay;
1903	drm->mode_config.max_height = max_height;
1904	drm->mode_config.preferred_depth = 24;
1905	drm->mode_config.funcs = &ssd130x_mode_config_funcs;
1906
1907	/* Primary plane */
1908
1909	primary_plane = &ssd130x->primary_plane;
1910	ret = drm_universal_plane_init(drm, primary_plane, 0, &ssd130x_primary_plane_funcs,
1911				       ssd130x_formats, ARRAY_SIZE(ssd130x_formats),
1912				       NULL, DRM_PLANE_TYPE_PRIMARY, NULL);
1913	if (ret) {
1914		dev_err(dev, "DRM primary plane init failed: %d\n", ret);
1915		return ret;
1916	}
1917
1918	drm_plane_helper_add(primary_plane, &ssd130x_primary_plane_helper_funcs[family_id]);
1919
1920	drm_plane_enable_fb_damage_clips(primary_plane);
1921
1922	/* CRTC */
1923
1924	crtc = &ssd130x->crtc;
1925	ret = drm_crtc_init_with_planes(drm, crtc, primary_plane, NULL,
1926					&ssd130x_crtc_funcs, NULL);
1927	if (ret) {
1928		dev_err(dev, "DRM crtc init failed: %d\n", ret);
1929		return ret;
1930	}
1931
1932	drm_crtc_helper_add(crtc, &ssd130x_crtc_helper_funcs[family_id]);
1933
1934	/* Encoder */
1935
1936	encoder = &ssd130x->encoder;
1937	ret = drm_encoder_init(drm, encoder, &ssd130x_encoder_funcs,
1938			       DRM_MODE_ENCODER_NONE, NULL);
1939	if (ret) {
1940		dev_err(dev, "DRM encoder init failed: %d\n", ret);
1941		return ret;
1942	}
1943
1944	drm_encoder_helper_add(encoder, &ssd130x_encoder_helper_funcs[family_id]);
1945
1946	encoder->possible_crtcs = drm_crtc_mask(crtc);
1947
1948	/* Connector */
1949
1950	connector = &ssd130x->connector;
1951	ret = drm_connector_init(drm, connector, &ssd130x_connector_funcs,
1952				 DRM_MODE_CONNECTOR_Unknown);
1953	if (ret) {
1954		dev_err(dev, "DRM connector init failed: %d\n", ret);
1955		return ret;
1956	}
1957
1958	drm_connector_helper_add(connector, &ssd130x_connector_helper_funcs);
1959
1960	ret = drm_connector_attach_encoder(connector, encoder);
1961	if (ret) {
1962		dev_err(dev, "DRM attach connector to encoder failed: %d\n", ret);
1963		return ret;
1964	}
1965
1966	drm_mode_config_reset(drm);
1967
1968	return 0;
1969}
1970
1971static int ssd130x_get_resources(struct ssd130x_device *ssd130x)
1972{
1973	struct device *dev = ssd130x->dev;
1974
1975	ssd130x->reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_LOW);
1976	if (IS_ERR(ssd130x->reset))
1977		return dev_err_probe(dev, PTR_ERR(ssd130x->reset),
1978				     "Failed to get reset gpio\n");
1979
1980	ssd130x->vcc_reg = devm_regulator_get(dev, "vcc");
1981	if (IS_ERR(ssd130x->vcc_reg))
1982		return dev_err_probe(dev, PTR_ERR(ssd130x->vcc_reg),
1983				     "Failed to get VCC regulator\n");
1984
1985	return 0;
1986}
1987
1988struct ssd130x_device *ssd130x_probe(struct device *dev, struct regmap *regmap)
1989{
1990	struct ssd130x_device *ssd130x;
1991	struct backlight_device *bl;
1992	struct drm_device *drm;
1993	int ret;
1994
1995	ssd130x = devm_drm_dev_alloc(dev, &ssd130x_drm_driver,
1996				     struct ssd130x_device, drm);
1997	if (IS_ERR(ssd130x))
1998		return ERR_PTR(dev_err_probe(dev, PTR_ERR(ssd130x),
1999					     "Failed to allocate DRM device\n"));
2000
2001	drm = &ssd130x->drm;
2002
2003	ssd130x->dev = dev;
2004	ssd130x->regmap = regmap;
2005	ssd130x->device_info = device_get_match_data(dev);
2006
2007	if (ssd130x->device_info->page_mode_only)
2008		ssd130x->page_address_mode = 1;
2009
2010	ssd130x_parse_properties(ssd130x);
2011
2012	ret = ssd130x_get_resources(ssd130x);
2013	if (ret)
2014		return ERR_PTR(ret);
2015
2016	bl = devm_backlight_device_register(dev, dev_name(dev), dev, ssd130x,
2017					    &ssd130xfb_bl_ops, NULL);
2018	if (IS_ERR(bl))
2019		return ERR_PTR(dev_err_probe(dev, PTR_ERR(bl),
2020					     "Unable to register backlight device\n"));
2021
2022	bl->props.brightness = ssd130x->contrast;
2023	bl->props.max_brightness = MAX_CONTRAST;
2024	ssd130x->bl_dev = bl;
2025
2026	ret = ssd130x_init_modeset(ssd130x);
2027	if (ret)
2028		return ERR_PTR(ret);
2029
2030	ret = drm_dev_register(drm, 0);
2031	if (ret)
2032		return ERR_PTR(dev_err_probe(dev, ret, "DRM device register failed\n"));
2033
2034	drm_client_setup(drm, NULL);
2035
2036	return ssd130x;
2037}
2038EXPORT_SYMBOL_GPL(ssd130x_probe);
2039
2040void ssd130x_remove(struct ssd130x_device *ssd130x)
2041{
2042	drm_dev_unplug(&ssd130x->drm);
2043	drm_atomic_helper_shutdown(&ssd130x->drm);
2044}
2045EXPORT_SYMBOL_GPL(ssd130x_remove);
2046
2047void ssd130x_shutdown(struct ssd130x_device *ssd130x)
2048{
2049	drm_atomic_helper_shutdown(&ssd130x->drm);
2050}
2051EXPORT_SYMBOL_GPL(ssd130x_shutdown);
2052
2053MODULE_DESCRIPTION(DRIVER_DESC);
2054MODULE_AUTHOR("Javier Martinez Canillas <javierm@redhat.com>");
2055MODULE_LICENSE("GPL v2");
v6.9.4
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * DRM driver for Solomon SSD13xx OLED displays
   4 *
   5 * Copyright 2022 Red Hat Inc.
   6 * Author: Javier Martinez Canillas <javierm@redhat.com>
   7 *
   8 * Based on drivers/video/fbdev/ssd1307fb.c
   9 * Copyright 2012 Free Electrons
  10 */
  11
  12#include <linux/backlight.h>
  13#include <linux/bitfield.h>
  14#include <linux/bits.h>
  15#include <linux/delay.h>
  16#include <linux/gpio/consumer.h>
  17#include <linux/property.h>
  18#include <linux/pwm.h>
  19#include <linux/regulator/consumer.h>
  20
  21#include <drm/drm_atomic.h>
  22#include <drm/drm_atomic_helper.h>
 
  23#include <drm/drm_crtc_helper.h>
  24#include <drm/drm_damage_helper.h>
  25#include <drm/drm_edid.h>
  26#include <drm/drm_fbdev_generic.h>
  27#include <drm/drm_format_helper.h>
  28#include <drm/drm_framebuffer.h>
  29#include <drm/drm_gem_atomic_helper.h>
  30#include <drm/drm_gem_framebuffer_helper.h>
  31#include <drm/drm_gem_shmem_helper.h>
  32#include <drm/drm_managed.h>
  33#include <drm/drm_modes.h>
  34#include <drm/drm_rect.h>
  35#include <drm/drm_probe_helper.h>
  36
  37#include "ssd130x.h"
  38
  39#define DRIVER_NAME	"ssd130x"
  40#define DRIVER_DESC	"DRM driver for Solomon SSD13xx OLED displays"
  41#define DRIVER_DATE	"20220131"
  42#define DRIVER_MAJOR	1
  43#define DRIVER_MINOR	0
  44
  45#define SSD130X_PAGE_HEIGHT 8
  46
  47#define SSD132X_SEGMENT_WIDTH 2
  48
  49/* ssd13xx commands */
  50#define SSD13XX_CONTRAST			0x81
  51#define SSD13XX_SET_SEG_REMAP			0xa0
  52#define SSD13XX_SET_MULTIPLEX_RATIO		0xa8
  53#define SSD13XX_DISPLAY_OFF			0xae
  54#define SSD13XX_DISPLAY_ON			0xaf
  55
  56#define SSD13XX_SET_SEG_REMAP_MASK		GENMASK(0, 0)
  57#define SSD13XX_SET_SEG_REMAP_SET(val)		FIELD_PREP(SSD13XX_SET_SEG_REMAP_MASK, (val))
  58
  59/* ssd130x commands */
  60#define SSD130X_PAGE_COL_START_LOW		0x00
  61#define SSD130X_PAGE_COL_START_HIGH		0x10
  62#define SSD130X_SET_ADDRESS_MODE		0x20
  63#define SSD130X_SET_COL_RANGE			0x21
  64#define SSD130X_SET_PAGE_RANGE			0x22
  65#define SSD130X_SET_LOOKUP_TABLE		0x91
  66#define SSD130X_CHARGE_PUMP			0x8d
  67#define SSD130X_START_PAGE_ADDRESS		0xb0
  68#define SSD130X_SET_COM_SCAN_DIR		0xc0
  69#define SSD130X_SET_DISPLAY_OFFSET		0xd3
  70#define SSD130X_SET_CLOCK_FREQ			0xd5
  71#define SSD130X_SET_AREA_COLOR_MODE		0xd8
  72#define SSD130X_SET_PRECHARGE_PERIOD		0xd9
  73#define SSD130X_SET_COM_PINS_CONFIG		0xda
  74#define SSD130X_SET_VCOMH			0xdb
  75
  76/* ssd130x commands accessors */
  77#define SSD130X_PAGE_COL_START_MASK		GENMASK(3, 0)
  78#define SSD130X_PAGE_COL_START_HIGH_SET(val)	FIELD_PREP(SSD130X_PAGE_COL_START_MASK, (val) >> 4)
  79#define SSD130X_PAGE_COL_START_LOW_SET(val)	FIELD_PREP(SSD130X_PAGE_COL_START_MASK, (val))
  80#define SSD130X_START_PAGE_ADDRESS_MASK		GENMASK(2, 0)
  81#define SSD130X_START_PAGE_ADDRESS_SET(val)	FIELD_PREP(SSD130X_START_PAGE_ADDRESS_MASK, (val))
  82#define SSD130X_SET_COM_SCAN_DIR_MASK		GENMASK(3, 3)
  83#define SSD130X_SET_COM_SCAN_DIR_SET(val)	FIELD_PREP(SSD130X_SET_COM_SCAN_DIR_MASK, (val))
  84#define SSD130X_SET_CLOCK_DIV_MASK		GENMASK(3, 0)
  85#define SSD130X_SET_CLOCK_DIV_SET(val)		FIELD_PREP(SSD130X_SET_CLOCK_DIV_MASK, (val))
  86#define SSD130X_SET_CLOCK_FREQ_MASK		GENMASK(7, 4)
  87#define SSD130X_SET_CLOCK_FREQ_SET(val)		FIELD_PREP(SSD130X_SET_CLOCK_FREQ_MASK, (val))
  88#define SSD130X_SET_PRECHARGE_PERIOD1_MASK	GENMASK(3, 0)
  89#define SSD130X_SET_PRECHARGE_PERIOD1_SET(val)	FIELD_PREP(SSD130X_SET_PRECHARGE_PERIOD1_MASK, (val))
  90#define SSD130X_SET_PRECHARGE_PERIOD2_MASK	GENMASK(7, 4)
  91#define SSD130X_SET_PRECHARGE_PERIOD2_SET(val)	FIELD_PREP(SSD130X_SET_PRECHARGE_PERIOD2_MASK, (val))
  92#define SSD130X_SET_COM_PINS_CONFIG1_MASK	GENMASK(4, 4)
  93#define SSD130X_SET_COM_PINS_CONFIG1_SET(val)	FIELD_PREP(SSD130X_SET_COM_PINS_CONFIG1_MASK, (val))
  94#define SSD130X_SET_COM_PINS_CONFIG2_MASK	GENMASK(5, 5)
  95#define SSD130X_SET_COM_PINS_CONFIG2_SET(val)	FIELD_PREP(SSD130X_SET_COM_PINS_CONFIG2_MASK, (val))
  96
  97#define SSD130X_SET_ADDRESS_MODE_HORIZONTAL	0x00
  98#define SSD130X_SET_ADDRESS_MODE_VERTICAL	0x01
  99#define SSD130X_SET_ADDRESS_MODE_PAGE		0x02
 100
 101#define SSD130X_SET_AREA_COLOR_MODE_ENABLE	0x1e
 102#define SSD130X_SET_AREA_COLOR_MODE_LOW_POWER	0x05
 103
 104/* ssd132x commands */
 105#define SSD132X_SET_COL_RANGE			0x15
 106#define SSD132X_SET_DEACTIVATE_SCROLL		0x2e
 107#define SSD132X_SET_ROW_RANGE			0x75
 108#define SSD132X_SET_DISPLAY_START		0xa1
 109#define SSD132X_SET_DISPLAY_OFFSET		0xa2
 110#define SSD132X_SET_DISPLAY_NORMAL		0xa4
 111#define SSD132X_SET_FUNCTION_SELECT_A		0xab
 112#define SSD132X_SET_PHASE_LENGTH		0xb1
 113#define SSD132X_SET_CLOCK_FREQ			0xb3
 114#define SSD132X_SET_GPIO			0xb5
 115#define SSD132X_SET_PRECHARGE_PERIOD		0xb6
 116#define SSD132X_SET_GRAY_SCALE_TABLE		0xb8
 117#define SSD132X_SELECT_DEFAULT_TABLE		0xb9
 118#define SSD132X_SET_PRECHARGE_VOLTAGE		0xbc
 119#define SSD130X_SET_VCOMH_VOLTAGE		0xbe
 120#define SSD132X_SET_FUNCTION_SELECT_B		0xd5
 121
 122/* ssd133x commands */
 123#define SSD133X_SET_COL_RANGE			0x15
 124#define SSD133X_SET_ROW_RANGE			0x75
 125#define SSD133X_CONTRAST_A			0x81
 126#define SSD133X_CONTRAST_B			0x82
 127#define SSD133X_CONTRAST_C			0x83
 128#define SSD133X_SET_MASTER_CURRENT		0x87
 129#define SSD132X_SET_PRECHARGE_A			0x8a
 130#define SSD132X_SET_PRECHARGE_B			0x8b
 131#define SSD132X_SET_PRECHARGE_C			0x8c
 132#define SSD133X_SET_DISPLAY_START		0xa1
 133#define SSD133X_SET_DISPLAY_OFFSET		0xa2
 134#define SSD133X_SET_DISPLAY_NORMAL		0xa4
 135#define SSD133X_SET_MASTER_CONFIG		0xad
 136#define SSD133X_POWER_SAVE_MODE			0xb0
 137#define SSD133X_PHASES_PERIOD			0xb1
 138#define SSD133X_SET_CLOCK_FREQ			0xb3
 139#define SSD133X_SET_PRECHARGE_VOLTAGE		0xbb
 140#define SSD133X_SET_VCOMH_VOLTAGE		0xbe
 141
 142#define MAX_CONTRAST 255
 143
 144const struct ssd130x_deviceinfo ssd130x_variants[] = {
 145	[SH1106_ID] = {
 146		.default_vcomh = 0x40,
 147		.default_dclk_div = 1,
 148		.default_dclk_frq = 5,
 149		.default_width = 132,
 150		.default_height = 64,
 151		.page_mode_only = 1,
 152		.family_id = SSD130X_FAMILY,
 153	},
 154	[SSD1305_ID] = {
 155		.default_vcomh = 0x34,
 156		.default_dclk_div = 1,
 157		.default_dclk_frq = 7,
 158		.default_width = 132,
 159		.default_height = 64,
 160		.family_id = SSD130X_FAMILY,
 161	},
 162	[SSD1306_ID] = {
 163		.default_vcomh = 0x20,
 164		.default_dclk_div = 1,
 165		.default_dclk_frq = 8,
 166		.need_chargepump = 1,
 167		.default_width = 128,
 168		.default_height = 64,
 169		.family_id = SSD130X_FAMILY,
 170	},
 171	[SSD1307_ID] = {
 172		.default_vcomh = 0x20,
 173		.default_dclk_div = 2,
 174		.default_dclk_frq = 12,
 175		.need_pwm = 1,
 176		.default_width = 128,
 177		.default_height = 39,
 178		.family_id = SSD130X_FAMILY,
 179	},
 180	[SSD1309_ID] = {
 181		.default_vcomh = 0x34,
 182		.default_dclk_div = 1,
 183		.default_dclk_frq = 10,
 184		.default_width = 128,
 185		.default_height = 64,
 186		.family_id = SSD130X_FAMILY,
 187	},
 188	/* ssd132x family */
 189	[SSD1322_ID] = {
 190		.default_width = 480,
 191		.default_height = 128,
 192		.family_id = SSD132X_FAMILY,
 193	},
 194	[SSD1325_ID] = {
 195		.default_width = 128,
 196		.default_height = 80,
 197		.family_id = SSD132X_FAMILY,
 198	},
 199	[SSD1327_ID] = {
 200		.default_width = 128,
 201		.default_height = 128,
 202		.family_id = SSD132X_FAMILY,
 203	},
 204	/* ssd133x family */
 205	[SSD1331_ID] = {
 206		.default_width = 96,
 207		.default_height = 64,
 208		.family_id = SSD133X_FAMILY,
 209	}
 210};
 211EXPORT_SYMBOL_NS_GPL(ssd130x_variants, DRM_SSD130X);
 212
 213struct ssd130x_crtc_state {
 214	struct drm_crtc_state base;
 215	/* Buffer to store pixels in HW format and written to the panel */
 216	u8 *data_array;
 217};
 218
 219struct ssd130x_plane_state {
 220	struct drm_shadow_plane_state base;
 221	/* Intermediate buffer to convert pixels from XRGB8888 to HW format */
 222	u8 *buffer;
 223};
 224
 225static inline struct ssd130x_crtc_state *to_ssd130x_crtc_state(struct drm_crtc_state *state)
 226{
 227	return container_of(state, struct ssd130x_crtc_state, base);
 228}
 229
 230static inline struct ssd130x_plane_state *to_ssd130x_plane_state(struct drm_plane_state *state)
 231{
 232	return container_of(state, struct ssd130x_plane_state, base.base);
 233}
 234
 235static inline struct ssd130x_device *drm_to_ssd130x(struct drm_device *drm)
 236{
 237	return container_of(drm, struct ssd130x_device, drm);
 238}
 239
 240/*
 241 * Helper to write data (SSD13XX_DATA) to the device.
 242 */
 243static int ssd130x_write_data(struct ssd130x_device *ssd130x, u8 *values, int count)
 244{
 245	return regmap_bulk_write(ssd130x->regmap, SSD13XX_DATA, values, count);
 246}
 247
 248/*
 249 * Helper to write command (SSD13XX_COMMAND). The fist variadic argument
 250 * is the command to write and the following are the command options.
 251 *
 252 * Note that the ssd13xx protocol requires each command and option to be
 253 * written as a SSD13XX_COMMAND device register value. That is why a call
 254 * to regmap_write(..., SSD13XX_COMMAND, ...) is done for each argument.
 255 */
 256static int ssd130x_write_cmd(struct ssd130x_device *ssd130x, int count,
 257			     /* u8 cmd, u8 option, ... */...)
 258{
 259	va_list ap;
 260	u8 value;
 261	int ret;
 262
 263	va_start(ap, count);
 264
 265	do {
 266		value = va_arg(ap, int);
 267		ret = regmap_write(ssd130x->regmap, SSD13XX_COMMAND, value);
 268		if (ret)
 269			goto out_end;
 270	} while (--count);
 271
 272out_end:
 273	va_end(ap);
 274
 275	return ret;
 276}
 277
 278/* Set address range for horizontal/vertical addressing modes */
 279static int ssd130x_set_col_range(struct ssd130x_device *ssd130x,
 280				 u8 col_start, u8 cols)
 281{
 282	u8 col_end = col_start + cols - 1;
 283	int ret;
 284
 285	if (col_start == ssd130x->col_start && col_end == ssd130x->col_end)
 286		return 0;
 287
 288	ret = ssd130x_write_cmd(ssd130x, 3, SSD130X_SET_COL_RANGE, col_start, col_end);
 289	if (ret < 0)
 290		return ret;
 291
 292	ssd130x->col_start = col_start;
 293	ssd130x->col_end = col_end;
 294	return 0;
 295}
 296
 297static int ssd130x_set_page_range(struct ssd130x_device *ssd130x,
 298				  u8 page_start, u8 pages)
 299{
 300	u8 page_end = page_start + pages - 1;
 301	int ret;
 302
 303	if (page_start == ssd130x->page_start && page_end == ssd130x->page_end)
 304		return 0;
 305
 306	ret = ssd130x_write_cmd(ssd130x, 3, SSD130X_SET_PAGE_RANGE, page_start, page_end);
 307	if (ret < 0)
 308		return ret;
 309
 310	ssd130x->page_start = page_start;
 311	ssd130x->page_end = page_end;
 312	return 0;
 313}
 314
 315/* Set page and column start address for page addressing mode */
 316static int ssd130x_set_page_pos(struct ssd130x_device *ssd130x,
 317				u8 page_start, u8 col_start)
 318{
 319	int ret;
 320	u32 page, col_low, col_high;
 321
 322	page = SSD130X_START_PAGE_ADDRESS |
 323	       SSD130X_START_PAGE_ADDRESS_SET(page_start);
 324	col_low = SSD130X_PAGE_COL_START_LOW |
 325		  SSD130X_PAGE_COL_START_LOW_SET(col_start);
 326	col_high = SSD130X_PAGE_COL_START_HIGH |
 327		   SSD130X_PAGE_COL_START_HIGH_SET(col_start);
 328	ret = ssd130x_write_cmd(ssd130x, 3, page, col_low, col_high);
 329	if (ret < 0)
 330		return ret;
 331
 332	return 0;
 333}
 334
 335static int ssd130x_pwm_enable(struct ssd130x_device *ssd130x)
 336{
 337	struct device *dev = ssd130x->dev;
 338	struct pwm_state pwmstate;
 339
 340	ssd130x->pwm = pwm_get(dev, NULL);
 341	if (IS_ERR(ssd130x->pwm)) {
 342		dev_err(dev, "Could not get PWM from firmware description!\n");
 343		return PTR_ERR(ssd130x->pwm);
 344	}
 345
 346	pwm_init_state(ssd130x->pwm, &pwmstate);
 347	pwm_set_relative_duty_cycle(&pwmstate, 50, 100);
 348	pwm_apply_might_sleep(ssd130x->pwm, &pwmstate);
 349
 350	/* Enable the PWM */
 351	pwm_enable(ssd130x->pwm);
 352
 353	dev_dbg(dev, "Using PWM %s with a %lluns period.\n",
 354		ssd130x->pwm->label, pwm_get_period(ssd130x->pwm));
 355
 356	return 0;
 357}
 358
 359static void ssd130x_reset(struct ssd130x_device *ssd130x)
 360{
 361	if (!ssd130x->reset)
 362		return;
 363
 364	/* Reset the screen */
 365	gpiod_set_value_cansleep(ssd130x->reset, 1);
 366	udelay(4);
 367	gpiod_set_value_cansleep(ssd130x->reset, 0);
 368	udelay(4);
 369}
 370
 371static int ssd130x_power_on(struct ssd130x_device *ssd130x)
 372{
 373	struct device *dev = ssd130x->dev;
 374	int ret;
 375
 376	ssd130x_reset(ssd130x);
 377
 378	ret = regulator_enable(ssd130x->vcc_reg);
 379	if (ret) {
 380		dev_err(dev, "Failed to enable VCC: %d\n", ret);
 381		return ret;
 382	}
 383
 384	if (ssd130x->device_info->need_pwm) {
 385		ret = ssd130x_pwm_enable(ssd130x);
 386		if (ret) {
 387			dev_err(dev, "Failed to enable PWM: %d\n", ret);
 388			regulator_disable(ssd130x->vcc_reg);
 389			return ret;
 390		}
 391	}
 392
 393	return 0;
 394}
 395
 396static void ssd130x_power_off(struct ssd130x_device *ssd130x)
 397{
 398	pwm_disable(ssd130x->pwm);
 399	pwm_put(ssd130x->pwm);
 400
 401	regulator_disable(ssd130x->vcc_reg);
 402}
 403
 404static int ssd130x_init(struct ssd130x_device *ssd130x)
 405{
 406	u32 precharge, dclk, com_invdir, compins, chargepump, seg_remap;
 407	bool scan_mode;
 408	int ret;
 409
 410	/* Set initial contrast */
 411	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_CONTRAST, ssd130x->contrast);
 412	if (ret < 0)
 413		return ret;
 414
 415	/* Set segment re-map */
 416	seg_remap = (SSD13XX_SET_SEG_REMAP |
 417		     SSD13XX_SET_SEG_REMAP_SET(ssd130x->seg_remap));
 418	ret = ssd130x_write_cmd(ssd130x, 1, seg_remap);
 419	if (ret < 0)
 420		return ret;
 421
 422	/* Set COM direction */
 423	com_invdir = (SSD130X_SET_COM_SCAN_DIR |
 424		      SSD130X_SET_COM_SCAN_DIR_SET(ssd130x->com_invdir));
 425	ret = ssd130x_write_cmd(ssd130x,  1, com_invdir);
 426	if (ret < 0)
 427		return ret;
 428
 429	/* Set multiplex ratio value */
 430	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_MULTIPLEX_RATIO, ssd130x->height - 1);
 431	if (ret < 0)
 432		return ret;
 433
 434	/* set display offset value */
 435	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_DISPLAY_OFFSET, ssd130x->com_offset);
 436	if (ret < 0)
 437		return ret;
 438
 439	/* Set clock frequency */
 440	dclk = (SSD130X_SET_CLOCK_DIV_SET(ssd130x->dclk_div - 1) |
 441		SSD130X_SET_CLOCK_FREQ_SET(ssd130x->dclk_frq));
 442	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_CLOCK_FREQ, dclk);
 443	if (ret < 0)
 444		return ret;
 445
 446	/* Set Area Color Mode ON/OFF & Low Power Display Mode */
 447	if (ssd130x->area_color_enable || ssd130x->low_power) {
 448		u32 mode = 0;
 449
 450		if (ssd130x->area_color_enable)
 451			mode |= SSD130X_SET_AREA_COLOR_MODE_ENABLE;
 452
 453		if (ssd130x->low_power)
 454			mode |= SSD130X_SET_AREA_COLOR_MODE_LOW_POWER;
 455
 456		ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_AREA_COLOR_MODE, mode);
 457		if (ret < 0)
 458			return ret;
 459	}
 460
 461	/* Set precharge period in number of ticks from the internal clock */
 462	precharge = (SSD130X_SET_PRECHARGE_PERIOD1_SET(ssd130x->prechargep1) |
 463		     SSD130X_SET_PRECHARGE_PERIOD2_SET(ssd130x->prechargep2));
 464	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_PRECHARGE_PERIOD, precharge);
 465	if (ret < 0)
 466		return ret;
 467
 468	/* Set COM pins configuration */
 469	compins = BIT(1);
 470	/*
 471	 * The COM scan mode field values are the inverse of the boolean DT
 472	 * property "solomon,com-seq". The value 0b means scan from COM0 to
 473	 * COM[N - 1] while 1b means scan from COM[N - 1] to COM0.
 474	 */
 475	scan_mode = !ssd130x->com_seq;
 476	compins |= (SSD130X_SET_COM_PINS_CONFIG1_SET(scan_mode) |
 477		    SSD130X_SET_COM_PINS_CONFIG2_SET(ssd130x->com_lrremap));
 478	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_COM_PINS_CONFIG, compins);
 479	if (ret < 0)
 480		return ret;
 481
 482	/* Set VCOMH */
 483	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_VCOMH, ssd130x->vcomh);
 484	if (ret < 0)
 485		return ret;
 486
 487	/* Turn on the DC-DC Charge Pump */
 488	chargepump = BIT(4);
 489
 490	if (ssd130x->device_info->need_chargepump)
 491		chargepump |= BIT(2);
 492
 493	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_CHARGE_PUMP, chargepump);
 494	if (ret < 0)
 495		return ret;
 496
 497	/* Set lookup table */
 498	if (ssd130x->lookup_table_set) {
 499		int i;
 500
 501		ret = ssd130x_write_cmd(ssd130x, 1, SSD130X_SET_LOOKUP_TABLE);
 502		if (ret < 0)
 503			return ret;
 504
 505		for (i = 0; i < ARRAY_SIZE(ssd130x->lookup_table); i++) {
 506			u8 val = ssd130x->lookup_table[i];
 507
 508			if (val < 31 || val > 63)
 509				dev_warn(ssd130x->dev,
 510					 "lookup table index %d value out of range 31 <= %d <= 63\n",
 511					 i, val);
 512			ret = ssd130x_write_cmd(ssd130x, 1, val);
 513			if (ret < 0)
 514				return ret;
 515		}
 516	}
 517
 518	/* Switch to page addressing mode */
 519	if (ssd130x->page_address_mode)
 520		return ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_ADDRESS_MODE,
 521					 SSD130X_SET_ADDRESS_MODE_PAGE);
 522
 523	/* Switch to horizontal addressing mode */
 524	return ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_ADDRESS_MODE,
 525				 SSD130X_SET_ADDRESS_MODE_HORIZONTAL);
 526}
 527
 528static int ssd132x_init(struct ssd130x_device *ssd130x)
 529{
 530	int ret;
 531
 532	/* Set initial contrast */
 533	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_CONTRAST, 0x80);
 534	if (ret < 0)
 535		return ret;
 536
 537	/* Set column start and end */
 538	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_COL_RANGE, 0x00,
 539				ssd130x->width / SSD132X_SEGMENT_WIDTH - 1);
 540	if (ret < 0)
 541		return ret;
 542
 543	/* Set row start and end */
 544	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_ROW_RANGE, 0x00, ssd130x->height - 1);
 545	if (ret < 0)
 546		return ret;
 547	/*
 548	 * Horizontal Address Increment
 549	 * Re-map for Column Address, Nibble and COM
 550	 * COM Split Odd Even
 551	 */
 552	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_SEG_REMAP, 0x53);
 553	if (ret < 0)
 554		return ret;
 555
 556	/* Set display start and offset */
 557	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_DISPLAY_START, 0x00);
 558	if (ret < 0)
 559		return ret;
 560
 561	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_DISPLAY_OFFSET, 0x00);
 562	if (ret < 0)
 563		return ret;
 564
 565	/* Set display mode normal */
 566	ret = ssd130x_write_cmd(ssd130x, 1, SSD132X_SET_DISPLAY_NORMAL);
 567	if (ret < 0)
 568		return ret;
 569
 570	/* Set multiplex ratio value */
 571	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_MULTIPLEX_RATIO, ssd130x->height - 1);
 572	if (ret < 0)
 573		return ret;
 574
 575	/* Set phase length */
 576	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PHASE_LENGTH, 0x55);
 577	if (ret < 0)
 578		return ret;
 579
 580	/* Select default linear gray scale table */
 581	ret = ssd130x_write_cmd(ssd130x, 1, SSD132X_SELECT_DEFAULT_TABLE);
 582	if (ret < 0)
 583		return ret;
 584
 585	/* Set clock frequency */
 586	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_CLOCK_FREQ, 0x01);
 587	if (ret < 0)
 588		return ret;
 589
 590	/* Enable internal VDD regulator */
 591	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_FUNCTION_SELECT_A, 0x1);
 592	if (ret < 0)
 593		return ret;
 594
 595	/* Set pre-charge period */
 596	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_PERIOD, 0x01);
 597	if (ret < 0)
 598		return ret;
 599
 600	/* Set pre-charge voltage */
 601	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_VOLTAGE, 0x08);
 602	if (ret < 0)
 603		return ret;
 604
 605	/* Set VCOMH voltage */
 606	ret = ssd130x_write_cmd(ssd130x, 2, SSD130X_SET_VCOMH_VOLTAGE, 0x07);
 607	if (ret < 0)
 608		return ret;
 609
 610	/* Enable second pre-charge and internal VSL */
 611	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_FUNCTION_SELECT_B, 0x62);
 612	if (ret < 0)
 613		return ret;
 614
 615	return 0;
 616}
 617
 618static int ssd133x_init(struct ssd130x_device *ssd130x)
 619{
 620	int ret;
 621
 622	/* Set color A contrast */
 623	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_CONTRAST_A, 0x91);
 624	if (ret < 0)
 625		return ret;
 626
 627	/* Set color B contrast */
 628	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_CONTRAST_B, 0x50);
 629	if (ret < 0)
 630		return ret;
 631
 632	/* Set color C contrast */
 633	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_CONTRAST_C, 0x7d);
 634	if (ret < 0)
 635		return ret;
 636
 637	/* Set master current */
 638	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_MASTER_CURRENT, 0x06);
 639	if (ret < 0)
 640		return ret;
 641
 642	/* Set column start and end */
 643	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_COL_RANGE, 0x00, ssd130x->width - 1);
 644	if (ret < 0)
 645		return ret;
 646
 647	/* Set row start and end */
 648	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_ROW_RANGE, 0x00, ssd130x->height - 1);
 649	if (ret < 0)
 650		return ret;
 651
 652	/*
 653	 * Horizontal Address Increment
 654	 * Normal order SA,SB,SC (e.g. RGB)
 655	 * COM Split Odd Even
 656	 * 256 color format
 657	 */
 658	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_SEG_REMAP, 0x20);
 659	if (ret < 0)
 660		return ret;
 661
 662	/* Set display start and offset */
 663	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_DISPLAY_START, 0x00);
 664	if (ret < 0)
 665		return ret;
 666
 667	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_DISPLAY_OFFSET, 0x00);
 668	if (ret < 0)
 669		return ret;
 670
 671	/* Set display mode normal */
 672	ret = ssd130x_write_cmd(ssd130x, 1, SSD133X_SET_DISPLAY_NORMAL);
 673	if (ret < 0)
 674		return ret;
 675
 676	/* Set multiplex ratio value */
 677	ret = ssd130x_write_cmd(ssd130x, 2, SSD13XX_SET_MULTIPLEX_RATIO, ssd130x->height - 1);
 678	if (ret < 0)
 679		return ret;
 680
 681	/* Set master configuration */
 682	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_MASTER_CONFIG, 0x8e);
 683	if (ret < 0)
 684		return ret;
 685
 686	/* Set power mode */
 687	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_POWER_SAVE_MODE, 0x0b);
 688	if (ret < 0)
 689		return ret;
 690
 691	/* Set Phase 1 and 2 period */
 692	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_PHASES_PERIOD, 0x31);
 693	if (ret < 0)
 694		return ret;
 695
 696	/* Set clock divider */
 697	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_CLOCK_FREQ, 0xf0);
 698	if (ret < 0)
 699		return ret;
 700
 701	/* Set pre-charge A */
 702	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_A, 0x64);
 703	if (ret < 0)
 704		return ret;
 705
 706	/* Set pre-charge B */
 707	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_B, 0x78);
 708	if (ret < 0)
 709		return ret;
 710
 711	/* Set pre-charge C */
 712	ret = ssd130x_write_cmd(ssd130x, 2, SSD132X_SET_PRECHARGE_C, 0x64);
 713	if (ret < 0)
 714		return ret;
 715
 716	/* Set pre-charge level */
 717	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_PRECHARGE_VOLTAGE, 0x3a);
 718	if (ret < 0)
 719		return ret;
 720
 721	/* Set VCOMH voltage */
 722	ret = ssd130x_write_cmd(ssd130x, 2, SSD133X_SET_VCOMH_VOLTAGE, 0x3e);
 723	if (ret < 0)
 724		return ret;
 725
 726	return 0;
 727}
 728
 729static int ssd130x_update_rect(struct ssd130x_device *ssd130x,
 730			       struct drm_rect *rect, u8 *buf,
 731			       u8 *data_array)
 732{
 733	unsigned int x = rect->x1;
 734	unsigned int y = rect->y1;
 735	unsigned int width = drm_rect_width(rect);
 736	unsigned int height = drm_rect_height(rect);
 737	unsigned int line_length = DIV_ROUND_UP(width, 8);
 738	unsigned int page_height = SSD130X_PAGE_HEIGHT;
 739	unsigned int pages = DIV_ROUND_UP(height, page_height);
 740	struct drm_device *drm = &ssd130x->drm;
 741	u32 array_idx = 0;
 742	int ret, i, j, k;
 743
 744	drm_WARN_ONCE(drm, y % page_height != 0, "y must be aligned to screen page\n");
 745
 746	/*
 747	 * The screen is divided in pages, each having a height of 8
 748	 * pixels, and the width of the screen. When sending a byte of
 749	 * data to the controller, it gives the 8 bits for the current
 750	 * column. I.e, the first byte are the 8 bits of the first
 751	 * column, then the 8 bits for the second column, etc.
 752	 *
 753	 *
 754	 * Representation of the screen, assuming it is 5 bits
 755	 * wide. Each letter-number combination is a bit that controls
 756	 * one pixel.
 757	 *
 758	 * A0 A1 A2 A3 A4
 759	 * B0 B1 B2 B3 B4
 760	 * C0 C1 C2 C3 C4
 761	 * D0 D1 D2 D3 D4
 762	 * E0 E1 E2 E3 E4
 763	 * F0 F1 F2 F3 F4
 764	 * G0 G1 G2 G3 G4
 765	 * H0 H1 H2 H3 H4
 766	 *
 767	 * If you want to update this screen, you need to send 5 bytes:
 768	 *  (1) A0 B0 C0 D0 E0 F0 G0 H0
 769	 *  (2) A1 B1 C1 D1 E1 F1 G1 H1
 770	 *  (3) A2 B2 C2 D2 E2 F2 G2 H2
 771	 *  (4) A3 B3 C3 D3 E3 F3 G3 H3
 772	 *  (5) A4 B4 C4 D4 E4 F4 G4 H4
 773	 */
 774
 775	if (!ssd130x->page_address_mode) {
 776		u8 page_start;
 777
 778		/* Set address range for horizontal addressing mode */
 779		ret = ssd130x_set_col_range(ssd130x, ssd130x->col_offset + x, width);
 780		if (ret < 0)
 781			return ret;
 782
 783		page_start = ssd130x->page_offset + y / page_height;
 784		ret = ssd130x_set_page_range(ssd130x, page_start, pages);
 785		if (ret < 0)
 786			return ret;
 787	}
 788
 789	for (i = 0; i < pages; i++) {
 790		int m = page_height;
 791
 792		/* Last page may be partial */
 793		if (page_height * (y / page_height + i + 1) > ssd130x->height)
 794			m = ssd130x->height % page_height;
 795
 796		for (j = 0; j < width; j++) {
 797			u8 data = 0;
 798
 799			for (k = 0; k < m; k++) {
 800				u32 idx = (page_height * i + k) * line_length + j / 8;
 801				u8 byte = buf[idx];
 802				u8 bit = (byte >> (j % 8)) & 1;
 803
 804				data |= bit << k;
 805			}
 806			data_array[array_idx++] = data;
 807		}
 808
 809		/*
 810		 * In page addressing mode, the start address needs to be reset,
 811		 * and each page then needs to be written out separately.
 812		 */
 813		if (ssd130x->page_address_mode) {
 814			ret = ssd130x_set_page_pos(ssd130x,
 815						   ssd130x->page_offset + i,
 816						   ssd130x->col_offset + x);
 817			if (ret < 0)
 818				return ret;
 819
 820			ret = ssd130x_write_data(ssd130x, data_array, width);
 821			if (ret < 0)
 822				return ret;
 823
 824			array_idx = 0;
 825		}
 826	}
 827
 828	/* Write out update in one go if we aren't using page addressing mode */
 829	if (!ssd130x->page_address_mode)
 830		ret = ssd130x_write_data(ssd130x, data_array, width * pages);
 831
 832	return ret;
 833}
 834
 835static int ssd132x_update_rect(struct ssd130x_device *ssd130x,
 836			       struct drm_rect *rect, u8 *buf,
 837			       u8 *data_array)
 838{
 839	unsigned int x = rect->x1;
 840	unsigned int y = rect->y1;
 841	unsigned int segment_width = SSD132X_SEGMENT_WIDTH;
 842	unsigned int width = drm_rect_width(rect);
 843	unsigned int height = drm_rect_height(rect);
 844	unsigned int columns = DIV_ROUND_UP(width, segment_width);
 845	unsigned int rows = height;
 846	struct drm_device *drm = &ssd130x->drm;
 847	u32 array_idx = 0;
 848	unsigned int i, j;
 849	int ret;
 850
 851	drm_WARN_ONCE(drm, x % segment_width != 0, "x must be aligned to screen segment\n");
 852
 853	/*
 854	 * The screen is divided in Segment and Common outputs, where
 855	 * COM0 to COM[N - 1] are the rows and SEG0 to SEG[M - 1] are
 856	 * the columns.
 857	 *
 858	 * Each Segment has a 4-bit pixel and each Common output has a
 859	 * row of pixels. When using the (default) horizontal address
 860	 * increment mode, each byte of data sent to the controller has
 861	 * two Segments (e.g: SEG0 and SEG1) that are stored in the lower
 862	 * and higher nibbles of a single byte representing one column.
 863	 * That is, the first byte are SEG0 (D0[3:0]) and SEG1 (D0[7:4]),
 864	 * the second byte are SEG2 (D1[3:0]) and SEG3 (D1[7:4]) and so on.
 865	 */
 866
 867	/* Set column start and end */
 868	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_COL_RANGE, x / segment_width, columns - 1);
 869	if (ret < 0)
 870		return ret;
 871
 872	/* Set row start and end */
 873	ret = ssd130x_write_cmd(ssd130x, 3, SSD132X_SET_ROW_RANGE, y, rows - 1);
 874	if (ret < 0)
 875		return ret;
 876
 877	for (i = 0; i < height; i++) {
 878		/* Process pair of pixels and combine them into a single byte */
 879		for (j = 0; j < width; j += segment_width) {
 880			u8 n1 = buf[i * width + j];
 881			u8 n2 = buf[i * width + j + 1];
 882
 883			data_array[array_idx++] = (n2 << 4) | n1;
 884		}
 885	}
 886
 887	/* Write out update in one go since horizontal addressing mode is used */
 888	ret = ssd130x_write_data(ssd130x, data_array, columns * rows);
 889
 890	return ret;
 891}
 892
 893static int ssd133x_update_rect(struct ssd130x_device *ssd130x,
 894			       struct drm_rect *rect, u8 *data_array,
 895			       unsigned int pitch)
 896{
 897	unsigned int x = rect->x1;
 898	unsigned int y = rect->y1;
 899	unsigned int columns = drm_rect_width(rect);
 900	unsigned int rows = drm_rect_height(rect);
 901	int ret;
 902
 903	/*
 904	 * The screen is divided in Segment and Common outputs, where
 905	 * COM0 to COM[N - 1] are the rows and SEG0 to SEG[M - 1] are
 906	 * the columns.
 907	 *
 908	 * Each Segment has a 8-bit pixel and each Common output has a
 909	 * row of pixels. When using the (default) horizontal address
 910	 * increment mode, each byte of data sent to the controller has
 911	 * a Segment (e.g: SEG0).
 912	 *
 913	 * When using the 256 color depth format, each pixel contains 3
 914	 * sub-pixels for color A, B and C. These have 3 bit, 3 bit and
 915	 * 2 bits respectively.
 916	 */
 917
 918	/* Set column start and end */
 919	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_COL_RANGE, x, columns - 1);
 920	if (ret < 0)
 921		return ret;
 922
 923	/* Set row start and end */
 924	ret = ssd130x_write_cmd(ssd130x, 3, SSD133X_SET_ROW_RANGE, y, rows - 1);
 925	if (ret < 0)
 926		return ret;
 927
 928	/* Write out update in one go since horizontal addressing mode is used */
 929	ret = ssd130x_write_data(ssd130x, data_array, pitch * rows);
 930
 931	return ret;
 932}
 933
 934static void ssd130x_clear_screen(struct ssd130x_device *ssd130x, u8 *data_array)
 935{
 936	unsigned int pages = DIV_ROUND_UP(ssd130x->height, SSD130X_PAGE_HEIGHT);
 937	unsigned int width = ssd130x->width;
 938	int ret, i;
 939
 940	if (!ssd130x->page_address_mode) {
 941		memset(data_array, 0, width * pages);
 942
 943		/* Set address range for horizontal addressing mode */
 944		ret = ssd130x_set_col_range(ssd130x, ssd130x->col_offset, width);
 945		if (ret < 0)
 946			return;
 947
 948		ret = ssd130x_set_page_range(ssd130x, ssd130x->page_offset, pages);
 949		if (ret < 0)
 950			return;
 951
 952		/* Write out update in one go if we aren't using page addressing mode */
 953		ssd130x_write_data(ssd130x, data_array, width * pages);
 954	} else {
 955		/*
 956		 * In page addressing mode, the start address needs to be reset,
 957		 * and each page then needs to be written out separately.
 958		 */
 959		memset(data_array, 0, width);
 960
 961		for (i = 0; i < pages; i++) {
 962			ret = ssd130x_set_page_pos(ssd130x,
 963						   ssd130x->page_offset + i,
 964						   ssd130x->col_offset);
 965			if (ret < 0)
 966				return;
 967
 968			ret = ssd130x_write_data(ssd130x, data_array, width);
 969			if (ret < 0)
 970				return;
 971		}
 972	}
 973}
 974
 975static void ssd132x_clear_screen(struct ssd130x_device *ssd130x, u8 *data_array)
 976{
 977	unsigned int columns = DIV_ROUND_UP(ssd130x->height, SSD132X_SEGMENT_WIDTH);
 978	unsigned int height = ssd130x->height;
 979
 980	memset(data_array, 0, columns * height);
 981
 982	/* Write out update in one go since horizontal addressing mode is used */
 983	ssd130x_write_data(ssd130x, data_array, columns * height);
 984}
 985
 986static void ssd133x_clear_screen(struct ssd130x_device *ssd130x, u8 *data_array)
 987{
 988	const struct drm_format_info *fi = drm_format_info(DRM_FORMAT_RGB332);
 989	unsigned int pitch;
 990
 991	if (!fi)
 992		return;
 993
 994	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
 995
 996	memset(data_array, 0, pitch * ssd130x->height);
 997
 998	/* Write out update in one go since horizontal addressing mode is used */
 999	ssd130x_write_data(ssd130x, data_array, pitch * ssd130x->height);
1000}
1001
1002static int ssd130x_fb_blit_rect(struct drm_framebuffer *fb,
1003				const struct iosys_map *vmap,
1004				struct drm_rect *rect,
1005				u8 *buf, u8 *data_array,
1006				struct drm_format_conv_state *fmtcnv_state)
1007{
1008	struct ssd130x_device *ssd130x = drm_to_ssd130x(fb->dev);
1009	struct iosys_map dst;
1010	unsigned int dst_pitch;
1011	int ret = 0;
1012
1013	/* Align y to display page boundaries */
1014	rect->y1 = round_down(rect->y1, SSD130X_PAGE_HEIGHT);
1015	rect->y2 = min_t(unsigned int, round_up(rect->y2, SSD130X_PAGE_HEIGHT), ssd130x->height);
1016
1017	dst_pitch = DIV_ROUND_UP(drm_rect_width(rect), 8);
1018
1019	ret = drm_gem_fb_begin_cpu_access(fb, DMA_FROM_DEVICE);
1020	if (ret)
1021		return ret;
1022
1023	iosys_map_set_vaddr(&dst, buf);
1024	drm_fb_xrgb8888_to_mono(&dst, &dst_pitch, vmap, fb, rect, fmtcnv_state);
1025
1026	drm_gem_fb_end_cpu_access(fb, DMA_FROM_DEVICE);
1027
1028	ssd130x_update_rect(ssd130x, rect, buf, data_array);
1029
1030	return ret;
1031}
1032
1033static int ssd132x_fb_blit_rect(struct drm_framebuffer *fb,
1034				const struct iosys_map *vmap,
1035				struct drm_rect *rect, u8 *buf,
1036				u8 *data_array,
1037				struct drm_format_conv_state *fmtcnv_state)
1038{
1039	struct ssd130x_device *ssd130x = drm_to_ssd130x(fb->dev);
1040	unsigned int dst_pitch = drm_rect_width(rect);
1041	struct iosys_map dst;
1042	int ret = 0;
1043
1044	/* Align x to display segment boundaries */
1045	rect->x1 = round_down(rect->x1, SSD132X_SEGMENT_WIDTH);
1046	rect->x2 = min_t(unsigned int, round_up(rect->x2, SSD132X_SEGMENT_WIDTH),
1047			 ssd130x->width);
1048
1049	ret = drm_gem_fb_begin_cpu_access(fb, DMA_FROM_DEVICE);
1050	if (ret)
1051		return ret;
1052
1053	iosys_map_set_vaddr(&dst, buf);
1054	drm_fb_xrgb8888_to_gray8(&dst, &dst_pitch, vmap, fb, rect, fmtcnv_state);
1055
1056	drm_gem_fb_end_cpu_access(fb, DMA_FROM_DEVICE);
1057
1058	ssd132x_update_rect(ssd130x, rect, buf, data_array);
1059
1060	return ret;
1061}
1062
1063static int ssd133x_fb_blit_rect(struct drm_framebuffer *fb,
1064				const struct iosys_map *vmap,
1065				struct drm_rect *rect, u8 *data_array,
1066				struct drm_format_conv_state *fmtcnv_state)
1067{
1068	struct ssd130x_device *ssd130x = drm_to_ssd130x(fb->dev);
1069	const struct drm_format_info *fi = drm_format_info(DRM_FORMAT_RGB332);
1070	unsigned int dst_pitch;
1071	struct iosys_map dst;
1072	int ret = 0;
1073
1074	if (!fi)
1075		return -EINVAL;
1076
1077	dst_pitch = drm_format_info_min_pitch(fi, 0, drm_rect_width(rect));
1078
1079	ret = drm_gem_fb_begin_cpu_access(fb, DMA_FROM_DEVICE);
1080	if (ret)
1081		return ret;
1082
1083	iosys_map_set_vaddr(&dst, data_array);
1084	drm_fb_xrgb8888_to_rgb332(&dst, &dst_pitch, vmap, fb, rect, fmtcnv_state);
1085
1086	drm_gem_fb_end_cpu_access(fb, DMA_FROM_DEVICE);
1087
1088	ssd133x_update_rect(ssd130x, rect, data_array, dst_pitch);
1089
1090	return ret;
1091}
1092
1093static int ssd130x_primary_plane_atomic_check(struct drm_plane *plane,
1094					      struct drm_atomic_state *state)
1095{
1096	struct drm_device *drm = plane->dev;
1097	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1098	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1099	struct ssd130x_plane_state *ssd130x_state = to_ssd130x_plane_state(plane_state);
1100	struct drm_shadow_plane_state *shadow_plane_state = &ssd130x_state->base;
1101	struct drm_crtc *crtc = plane_state->crtc;
1102	struct drm_crtc_state *crtc_state = NULL;
1103	const struct drm_format_info *fi;
1104	unsigned int pitch;
1105	int ret;
1106
1107	if (crtc)
1108		crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1109
1110	ret = drm_atomic_helper_check_plane_state(plane_state, crtc_state,
1111						  DRM_PLANE_NO_SCALING,
1112						  DRM_PLANE_NO_SCALING,
1113						  false, false);
1114	if (ret)
1115		return ret;
1116	else if (!plane_state->visible)
1117		return 0;
1118
1119	fi = drm_format_info(DRM_FORMAT_R1);
1120	if (!fi)
1121		return -EINVAL;
1122
1123	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
1124
1125	if (plane_state->fb->format != fi) {
1126		void *buf;
1127
1128		/* format conversion necessary; reserve buffer */
1129		buf = drm_format_conv_state_reserve(&shadow_plane_state->fmtcnv_state,
1130						    pitch, GFP_KERNEL);
1131		if (!buf)
1132			return -ENOMEM;
1133	}
1134
1135	ssd130x_state->buffer = kcalloc(pitch, ssd130x->height, GFP_KERNEL);
1136	if (!ssd130x_state->buffer)
1137		return -ENOMEM;
1138
1139	return 0;
1140}
1141
1142static int ssd132x_primary_plane_atomic_check(struct drm_plane *plane,
1143					      struct drm_atomic_state *state)
1144{
1145	struct drm_device *drm = plane->dev;
1146	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1147	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1148	struct ssd130x_plane_state *ssd130x_state = to_ssd130x_plane_state(plane_state);
1149	struct drm_shadow_plane_state *shadow_plane_state = &ssd130x_state->base;
1150	struct drm_crtc *crtc = plane_state->crtc;
1151	struct drm_crtc_state *crtc_state = NULL;
1152	const struct drm_format_info *fi;
1153	unsigned int pitch;
1154	int ret;
1155
1156	if (crtc)
1157		crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1158
1159	ret = drm_atomic_helper_check_plane_state(plane_state, crtc_state,
1160						  DRM_PLANE_NO_SCALING,
1161						  DRM_PLANE_NO_SCALING,
1162						  false, false);
1163	if (ret)
1164		return ret;
1165	else if (!plane_state->visible)
1166		return 0;
1167
1168	fi = drm_format_info(DRM_FORMAT_R8);
1169	if (!fi)
1170		return -EINVAL;
1171
1172	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
1173
1174	if (plane_state->fb->format != fi) {
1175		void *buf;
1176
1177		/* format conversion necessary; reserve buffer */
1178		buf = drm_format_conv_state_reserve(&shadow_plane_state->fmtcnv_state,
1179						    pitch, GFP_KERNEL);
1180		if (!buf)
1181			return -ENOMEM;
1182	}
1183
1184	ssd130x_state->buffer = kcalloc(pitch, ssd130x->height, GFP_KERNEL);
1185	if (!ssd130x_state->buffer)
1186		return -ENOMEM;
1187
1188	return 0;
1189}
1190
1191static int ssd133x_primary_plane_atomic_check(struct drm_plane *plane,
1192					      struct drm_atomic_state *state)
1193{
1194	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1195	struct drm_crtc *crtc = plane_state->crtc;
1196	struct drm_crtc_state *crtc_state = NULL;
1197	int ret;
1198
1199	if (crtc)
1200		crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1201
1202	ret = drm_atomic_helper_check_plane_state(plane_state, crtc_state,
1203						  DRM_PLANE_NO_SCALING,
1204						  DRM_PLANE_NO_SCALING,
1205						  false, false);
1206	if (ret)
1207		return ret;
1208	else if (!plane_state->visible)
1209		return 0;
1210
1211	return 0;
1212}
1213
1214static void ssd130x_primary_plane_atomic_update(struct drm_plane *plane,
1215						struct drm_atomic_state *state)
1216{
1217	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1218	struct drm_plane_state *old_plane_state = drm_atomic_get_old_plane_state(state, plane);
1219	struct drm_shadow_plane_state *shadow_plane_state = to_drm_shadow_plane_state(plane_state);
1220	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1221	struct ssd130x_crtc_state *ssd130x_crtc_state =  to_ssd130x_crtc_state(crtc_state);
1222	struct ssd130x_plane_state *ssd130x_plane_state = to_ssd130x_plane_state(plane_state);
1223	struct drm_framebuffer *fb = plane_state->fb;
1224	struct drm_atomic_helper_damage_iter iter;
1225	struct drm_device *drm = plane->dev;
1226	struct drm_rect dst_clip;
1227	struct drm_rect damage;
1228	int idx;
1229
1230	if (!drm_dev_enter(drm, &idx))
1231		return;
1232
1233	drm_atomic_helper_damage_iter_init(&iter, old_plane_state, plane_state);
1234	drm_atomic_for_each_plane_damage(&iter, &damage) {
1235		dst_clip = plane_state->dst;
1236
1237		if (!drm_rect_intersect(&dst_clip, &damage))
1238			continue;
1239
1240		ssd130x_fb_blit_rect(fb, &shadow_plane_state->data[0], &dst_clip,
1241				     ssd130x_plane_state->buffer,
1242				     ssd130x_crtc_state->data_array,
1243				     &shadow_plane_state->fmtcnv_state);
1244	}
1245
1246	drm_dev_exit(idx);
1247}
1248
1249static void ssd132x_primary_plane_atomic_update(struct drm_plane *plane,
1250						struct drm_atomic_state *state)
1251{
1252	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1253	struct drm_plane_state *old_plane_state = drm_atomic_get_old_plane_state(state, plane);
1254	struct drm_shadow_plane_state *shadow_plane_state = to_drm_shadow_plane_state(plane_state);
1255	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1256	struct ssd130x_crtc_state *ssd130x_crtc_state =  to_ssd130x_crtc_state(crtc_state);
1257	struct ssd130x_plane_state *ssd130x_plane_state = to_ssd130x_plane_state(plane_state);
1258	struct drm_framebuffer *fb = plane_state->fb;
1259	struct drm_atomic_helper_damage_iter iter;
1260	struct drm_device *drm = plane->dev;
1261	struct drm_rect dst_clip;
1262	struct drm_rect damage;
1263	int idx;
1264
1265	if (!drm_dev_enter(drm, &idx))
1266		return;
1267
1268	drm_atomic_helper_damage_iter_init(&iter, old_plane_state, plane_state);
1269	drm_atomic_for_each_plane_damage(&iter, &damage) {
1270		dst_clip = plane_state->dst;
1271
1272		if (!drm_rect_intersect(&dst_clip, &damage))
1273			continue;
1274
1275		ssd132x_fb_blit_rect(fb, &shadow_plane_state->data[0], &dst_clip,
1276				     ssd130x_plane_state->buffer,
1277				     ssd130x_crtc_state->data_array,
1278				     &shadow_plane_state->fmtcnv_state);
1279	}
1280
1281	drm_dev_exit(idx);
1282}
1283
1284static void ssd133x_primary_plane_atomic_update(struct drm_plane *plane,
1285						struct drm_atomic_state *state)
1286{
1287	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1288	struct drm_plane_state *old_plane_state = drm_atomic_get_old_plane_state(state, plane);
1289	struct drm_shadow_plane_state *shadow_plane_state = to_drm_shadow_plane_state(plane_state);
1290	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1291	struct ssd130x_crtc_state *ssd130x_crtc_state =  to_ssd130x_crtc_state(crtc_state);
1292	struct drm_framebuffer *fb = plane_state->fb;
1293	struct drm_atomic_helper_damage_iter iter;
1294	struct drm_device *drm = plane->dev;
1295	struct drm_rect dst_clip;
1296	struct drm_rect damage;
1297	int idx;
1298
1299	if (!drm_dev_enter(drm, &idx))
1300		return;
1301
1302	drm_atomic_helper_damage_iter_init(&iter, old_plane_state, plane_state);
1303	drm_atomic_for_each_plane_damage(&iter, &damage) {
1304		dst_clip = plane_state->dst;
1305
1306		if (!drm_rect_intersect(&dst_clip, &damage))
1307			continue;
1308
1309		ssd133x_fb_blit_rect(fb, &shadow_plane_state->data[0], &dst_clip,
1310				     ssd130x_crtc_state->data_array,
1311				     &shadow_plane_state->fmtcnv_state);
1312	}
1313
1314	drm_dev_exit(idx);
1315}
1316
1317static void ssd130x_primary_plane_atomic_disable(struct drm_plane *plane,
1318						 struct drm_atomic_state *state)
1319{
1320	struct drm_device *drm = plane->dev;
1321	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1322	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1323	struct drm_crtc_state *crtc_state;
1324	struct ssd130x_crtc_state *ssd130x_crtc_state;
1325	int idx;
1326
1327	if (!plane_state->crtc)
1328		return;
1329
1330	crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1331	ssd130x_crtc_state = to_ssd130x_crtc_state(crtc_state);
1332
1333	if (!drm_dev_enter(drm, &idx))
1334		return;
1335
1336	ssd130x_clear_screen(ssd130x, ssd130x_crtc_state->data_array);
1337
1338	drm_dev_exit(idx);
1339}
1340
1341static void ssd132x_primary_plane_atomic_disable(struct drm_plane *plane,
1342						 struct drm_atomic_state *state)
1343{
1344	struct drm_device *drm = plane->dev;
1345	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1346	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1347	struct drm_crtc_state *crtc_state;
1348	struct ssd130x_crtc_state *ssd130x_crtc_state;
1349	int idx;
1350
1351	if (!plane_state->crtc)
1352		return;
1353
1354	crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1355	ssd130x_crtc_state = to_ssd130x_crtc_state(crtc_state);
1356
1357	if (!drm_dev_enter(drm, &idx))
1358		return;
1359
1360	ssd132x_clear_screen(ssd130x, ssd130x_crtc_state->data_array);
1361
1362	drm_dev_exit(idx);
1363}
1364
1365static void ssd133x_primary_plane_atomic_disable(struct drm_plane *plane,
1366						 struct drm_atomic_state *state)
1367{
1368	struct drm_device *drm = plane->dev;
1369	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1370	struct drm_plane_state *plane_state = drm_atomic_get_new_plane_state(state, plane);
1371	struct drm_crtc_state *crtc_state;
1372	struct ssd130x_crtc_state *ssd130x_crtc_state;
1373	int idx;
1374
1375	if (!plane_state->crtc)
1376		return;
1377
1378	crtc_state = drm_atomic_get_new_crtc_state(state, plane_state->crtc);
1379	ssd130x_crtc_state = to_ssd130x_crtc_state(crtc_state);
1380
1381	if (!drm_dev_enter(drm, &idx))
1382		return;
1383
1384	ssd133x_clear_screen(ssd130x, ssd130x_crtc_state->data_array);
1385
1386	drm_dev_exit(idx);
1387}
1388
1389/* Called during init to allocate the plane's atomic state. */
1390static void ssd130x_primary_plane_reset(struct drm_plane *plane)
1391{
1392	struct ssd130x_plane_state *ssd130x_state;
1393
1394	WARN_ON(plane->state);
1395
1396	ssd130x_state = kzalloc(sizeof(*ssd130x_state), GFP_KERNEL);
1397	if (!ssd130x_state)
1398		return;
1399
1400	__drm_gem_reset_shadow_plane(plane, &ssd130x_state->base);
1401}
1402
1403static struct drm_plane_state *ssd130x_primary_plane_duplicate_state(struct drm_plane *plane)
1404{
1405	struct drm_shadow_plane_state *new_shadow_plane_state;
1406	struct ssd130x_plane_state *old_ssd130x_state;
1407	struct ssd130x_plane_state *ssd130x_state;
1408
1409	if (WARN_ON(!plane->state))
1410		return NULL;
1411
1412	old_ssd130x_state = to_ssd130x_plane_state(plane->state);
1413	ssd130x_state = kmemdup(old_ssd130x_state, sizeof(*ssd130x_state), GFP_KERNEL);
1414	if (!ssd130x_state)
1415		return NULL;
1416
1417	/* The buffer is not duplicated and is allocated in .atomic_check */
1418	ssd130x_state->buffer = NULL;
1419
1420	new_shadow_plane_state = &ssd130x_state->base;
1421
1422	__drm_gem_duplicate_shadow_plane_state(plane, new_shadow_plane_state);
1423
1424	return &new_shadow_plane_state->base;
1425}
1426
1427static void ssd130x_primary_plane_destroy_state(struct drm_plane *plane,
1428						struct drm_plane_state *state)
1429{
1430	struct ssd130x_plane_state *ssd130x_state = to_ssd130x_plane_state(state);
1431
1432	kfree(ssd130x_state->buffer);
1433
1434	__drm_gem_destroy_shadow_plane_state(&ssd130x_state->base);
1435
1436	kfree(ssd130x_state);
1437}
1438
1439static const struct drm_plane_helper_funcs ssd130x_primary_plane_helper_funcs[] = {
1440	[SSD130X_FAMILY] = {
1441		DRM_GEM_SHADOW_PLANE_HELPER_FUNCS,
1442		.atomic_check = ssd130x_primary_plane_atomic_check,
1443		.atomic_update = ssd130x_primary_plane_atomic_update,
1444		.atomic_disable = ssd130x_primary_plane_atomic_disable,
1445	},
1446	[SSD132X_FAMILY] = {
1447		DRM_GEM_SHADOW_PLANE_HELPER_FUNCS,
1448		.atomic_check = ssd132x_primary_plane_atomic_check,
1449		.atomic_update = ssd132x_primary_plane_atomic_update,
1450		.atomic_disable = ssd132x_primary_plane_atomic_disable,
1451	},
1452	[SSD133X_FAMILY] = {
1453		DRM_GEM_SHADOW_PLANE_HELPER_FUNCS,
1454		.atomic_check = ssd133x_primary_plane_atomic_check,
1455		.atomic_update = ssd133x_primary_plane_atomic_update,
1456		.atomic_disable = ssd133x_primary_plane_atomic_disable,
1457	}
1458};
1459
1460static const struct drm_plane_funcs ssd130x_primary_plane_funcs = {
1461	.update_plane = drm_atomic_helper_update_plane,
1462	.disable_plane = drm_atomic_helper_disable_plane,
1463	.reset = ssd130x_primary_plane_reset,
1464	.atomic_duplicate_state = ssd130x_primary_plane_duplicate_state,
1465	.atomic_destroy_state = ssd130x_primary_plane_destroy_state,
1466	.destroy = drm_plane_cleanup,
1467};
1468
1469static enum drm_mode_status ssd130x_crtc_mode_valid(struct drm_crtc *crtc,
1470						    const struct drm_display_mode *mode)
1471{
1472	struct ssd130x_device *ssd130x = drm_to_ssd130x(crtc->dev);
1473
1474	if (mode->hdisplay != ssd130x->mode.hdisplay &&
1475	    mode->vdisplay != ssd130x->mode.vdisplay)
1476		return MODE_ONE_SIZE;
1477	else if (mode->hdisplay != ssd130x->mode.hdisplay)
1478		return MODE_ONE_WIDTH;
1479	else if (mode->vdisplay != ssd130x->mode.vdisplay)
1480		return MODE_ONE_HEIGHT;
1481
1482	return MODE_OK;
1483}
1484
1485static int ssd130x_crtc_atomic_check(struct drm_crtc *crtc,
1486				     struct drm_atomic_state *state)
1487{
1488	struct drm_device *drm = crtc->dev;
1489	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1490	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1491	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(crtc_state);
1492	unsigned int pages = DIV_ROUND_UP(ssd130x->height, SSD130X_PAGE_HEIGHT);
1493	int ret;
1494
1495	ret = drm_crtc_helper_atomic_check(crtc, state);
1496	if (ret)
1497		return ret;
1498
1499	ssd130x_state->data_array = kmalloc(ssd130x->width * pages, GFP_KERNEL);
1500	if (!ssd130x_state->data_array)
1501		return -ENOMEM;
1502
1503	return 0;
1504}
1505
1506static int ssd132x_crtc_atomic_check(struct drm_crtc *crtc,
1507				     struct drm_atomic_state *state)
1508{
1509	struct drm_device *drm = crtc->dev;
1510	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1511	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1512	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(crtc_state);
1513	unsigned int columns = DIV_ROUND_UP(ssd130x->width, SSD132X_SEGMENT_WIDTH);
1514	int ret;
1515
1516	ret = drm_crtc_helper_atomic_check(crtc, state);
1517	if (ret)
1518		return ret;
1519
1520	ssd130x_state->data_array = kmalloc(columns * ssd130x->height, GFP_KERNEL);
1521	if (!ssd130x_state->data_array)
1522		return -ENOMEM;
1523
1524	return 0;
1525}
1526
1527static int ssd133x_crtc_atomic_check(struct drm_crtc *crtc,
1528				     struct drm_atomic_state *state)
1529{
1530	struct drm_device *drm = crtc->dev;
1531	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1532	struct drm_crtc_state *crtc_state = drm_atomic_get_new_crtc_state(state, crtc);
1533	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(crtc_state);
1534	const struct drm_format_info *fi = drm_format_info(DRM_FORMAT_RGB332);
1535	unsigned int pitch;
1536	int ret;
1537
1538	if (!fi)
1539		return -EINVAL;
1540
1541	ret = drm_crtc_helper_atomic_check(crtc, state);
1542	if (ret)
1543		return ret;
1544
1545	pitch = drm_format_info_min_pitch(fi, 0, ssd130x->width);
1546
1547	ssd130x_state->data_array = kmalloc(pitch * ssd130x->height, GFP_KERNEL);
1548	if (!ssd130x_state->data_array)
1549		return -ENOMEM;
1550
1551	return 0;
1552}
1553
1554/* Called during init to allocate the CRTC's atomic state. */
1555static void ssd130x_crtc_reset(struct drm_crtc *crtc)
1556{
1557	struct ssd130x_crtc_state *ssd130x_state;
1558
1559	WARN_ON(crtc->state);
1560
1561	ssd130x_state = kzalloc(sizeof(*ssd130x_state), GFP_KERNEL);
1562	if (!ssd130x_state)
1563		return;
1564
1565	__drm_atomic_helper_crtc_reset(crtc, &ssd130x_state->base);
1566}
1567
1568static struct drm_crtc_state *ssd130x_crtc_duplicate_state(struct drm_crtc *crtc)
1569{
1570	struct ssd130x_crtc_state *old_ssd130x_state;
1571	struct ssd130x_crtc_state *ssd130x_state;
1572
1573	if (WARN_ON(!crtc->state))
1574		return NULL;
1575
1576	old_ssd130x_state = to_ssd130x_crtc_state(crtc->state);
1577	ssd130x_state = kmemdup(old_ssd130x_state, sizeof(*ssd130x_state), GFP_KERNEL);
1578	if (!ssd130x_state)
1579		return NULL;
1580
1581	/* The buffer is not duplicated and is allocated in .atomic_check */
1582	ssd130x_state->data_array = NULL;
1583
1584	__drm_atomic_helper_crtc_duplicate_state(crtc, &ssd130x_state->base);
1585
1586	return &ssd130x_state->base;
1587}
1588
1589static void ssd130x_crtc_destroy_state(struct drm_crtc *crtc,
1590				       struct drm_crtc_state *state)
1591{
1592	struct ssd130x_crtc_state *ssd130x_state = to_ssd130x_crtc_state(state);
1593
1594	kfree(ssd130x_state->data_array);
1595
1596	__drm_atomic_helper_crtc_destroy_state(state);
1597
1598	kfree(ssd130x_state);
1599}
1600
1601/*
1602 * The CRTC is always enabled. Screen updates are performed by
1603 * the primary plane's atomic_update function. Disabling clears
1604 * the screen in the primary plane's atomic_disable function.
1605 */
1606static const struct drm_crtc_helper_funcs ssd130x_crtc_helper_funcs[] = {
1607	[SSD130X_FAMILY] = {
1608		.mode_valid = ssd130x_crtc_mode_valid,
1609		.atomic_check = ssd130x_crtc_atomic_check,
1610	},
1611	[SSD132X_FAMILY] = {
1612		.mode_valid = ssd130x_crtc_mode_valid,
1613		.atomic_check = ssd132x_crtc_atomic_check,
1614	},
1615	[SSD133X_FAMILY] = {
1616		.mode_valid = ssd130x_crtc_mode_valid,
1617		.atomic_check = ssd133x_crtc_atomic_check,
1618	},
1619};
1620
1621static const struct drm_crtc_funcs ssd130x_crtc_funcs = {
1622	.reset = ssd130x_crtc_reset,
1623	.destroy = drm_crtc_cleanup,
1624	.set_config = drm_atomic_helper_set_config,
1625	.page_flip = drm_atomic_helper_page_flip,
1626	.atomic_duplicate_state = ssd130x_crtc_duplicate_state,
1627	.atomic_destroy_state = ssd130x_crtc_destroy_state,
1628};
1629
1630static void ssd130x_encoder_atomic_enable(struct drm_encoder *encoder,
1631					  struct drm_atomic_state *state)
1632{
1633	struct drm_device *drm = encoder->dev;
1634	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1635	int ret;
1636
1637	ret = ssd130x_power_on(ssd130x);
1638	if (ret)
1639		return;
1640
1641	ret = ssd130x_init(ssd130x);
1642	if (ret)
1643		goto power_off;
1644
1645	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_ON);
1646
1647	backlight_enable(ssd130x->bl_dev);
1648
1649	return;
1650
1651power_off:
1652	ssd130x_power_off(ssd130x);
1653	return;
1654}
1655
1656static void ssd132x_encoder_atomic_enable(struct drm_encoder *encoder,
1657					  struct drm_atomic_state *state)
1658{
1659	struct drm_device *drm = encoder->dev;
1660	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1661	int ret;
1662
1663	ret = ssd130x_power_on(ssd130x);
1664	if (ret)
1665		return;
1666
1667	ret = ssd132x_init(ssd130x);
1668	if (ret)
1669		goto power_off;
1670
1671	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_ON);
1672
1673	backlight_enable(ssd130x->bl_dev);
1674
1675	return;
1676
1677power_off:
1678	ssd130x_power_off(ssd130x);
1679}
1680
1681static void ssd133x_encoder_atomic_enable(struct drm_encoder *encoder,
1682					  struct drm_atomic_state *state)
1683{
1684	struct drm_device *drm = encoder->dev;
1685	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1686	int ret;
1687
1688	ret = ssd130x_power_on(ssd130x);
1689	if (ret)
1690		return;
1691
1692	ret = ssd133x_init(ssd130x);
1693	if (ret)
1694		goto power_off;
1695
1696	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_ON);
1697
1698	backlight_enable(ssd130x->bl_dev);
1699
1700	return;
1701
1702power_off:
1703	ssd130x_power_off(ssd130x);
1704}
1705
1706static void ssd130x_encoder_atomic_disable(struct drm_encoder *encoder,
1707					   struct drm_atomic_state *state)
1708{
1709	struct drm_device *drm = encoder->dev;
1710	struct ssd130x_device *ssd130x = drm_to_ssd130x(drm);
1711
1712	backlight_disable(ssd130x->bl_dev);
1713
1714	ssd130x_write_cmd(ssd130x, 1, SSD13XX_DISPLAY_OFF);
1715
1716	ssd130x_power_off(ssd130x);
1717}
1718
1719static const struct drm_encoder_helper_funcs ssd130x_encoder_helper_funcs[] = {
1720	[SSD130X_FAMILY] = {
1721		.atomic_enable = ssd130x_encoder_atomic_enable,
1722		.atomic_disable = ssd130x_encoder_atomic_disable,
1723	},
1724	[SSD132X_FAMILY] = {
1725		.atomic_enable = ssd132x_encoder_atomic_enable,
1726		.atomic_disable = ssd130x_encoder_atomic_disable,
1727	},
1728	[SSD133X_FAMILY] = {
1729		.atomic_enable = ssd133x_encoder_atomic_enable,
1730		.atomic_disable = ssd130x_encoder_atomic_disable,
1731	}
1732};
1733
1734static const struct drm_encoder_funcs ssd130x_encoder_funcs = {
1735	.destroy = drm_encoder_cleanup,
1736};
1737
1738static int ssd130x_connector_get_modes(struct drm_connector *connector)
1739{
1740	struct ssd130x_device *ssd130x = drm_to_ssd130x(connector->dev);
1741	struct drm_display_mode *mode;
1742	struct device *dev = ssd130x->dev;
1743
1744	mode = drm_mode_duplicate(connector->dev, &ssd130x->mode);
1745	if (!mode) {
1746		dev_err(dev, "Failed to duplicated mode\n");
1747		return 0;
1748	}
1749
1750	drm_mode_probed_add(connector, mode);
1751	drm_set_preferred_mode(connector, mode->hdisplay, mode->vdisplay);
1752
1753	/* There is only a single mode */
1754	return 1;
1755}
1756
1757static const struct drm_connector_helper_funcs ssd130x_connector_helper_funcs = {
1758	.get_modes = ssd130x_connector_get_modes,
1759};
1760
1761static const struct drm_connector_funcs ssd130x_connector_funcs = {
1762	.reset = drm_atomic_helper_connector_reset,
1763	.fill_modes = drm_helper_probe_single_connector_modes,
1764	.destroy = drm_connector_cleanup,
1765	.atomic_duplicate_state = drm_atomic_helper_connector_duplicate_state,
1766	.atomic_destroy_state = drm_atomic_helper_connector_destroy_state,
1767};
1768
1769static const struct drm_mode_config_funcs ssd130x_mode_config_funcs = {
1770	.fb_create = drm_gem_fb_create_with_dirty,
1771	.atomic_check = drm_atomic_helper_check,
1772	.atomic_commit = drm_atomic_helper_commit,
1773};
1774
1775static const uint32_t ssd130x_formats[] = {
1776	DRM_FORMAT_XRGB8888,
1777};
1778
1779DEFINE_DRM_GEM_FOPS(ssd130x_fops);
1780
1781static const struct drm_driver ssd130x_drm_driver = {
1782	DRM_GEM_SHMEM_DRIVER_OPS,
 
1783	.name			= DRIVER_NAME,
1784	.desc			= DRIVER_DESC,
1785	.date			= DRIVER_DATE,
1786	.major			= DRIVER_MAJOR,
1787	.minor			= DRIVER_MINOR,
1788	.driver_features	= DRIVER_ATOMIC | DRIVER_GEM | DRIVER_MODESET,
1789	.fops			= &ssd130x_fops,
1790};
1791
1792static int ssd130x_update_bl(struct backlight_device *bdev)
1793{
1794	struct ssd130x_device *ssd130x = bl_get_data(bdev);
1795	int brightness = backlight_get_brightness(bdev);
1796	int ret;
1797
1798	ssd130x->contrast = brightness;
1799
1800	ret = ssd130x_write_cmd(ssd130x, 1, SSD13XX_CONTRAST);
1801	if (ret < 0)
1802		return ret;
1803
1804	ret = ssd130x_write_cmd(ssd130x, 1, ssd130x->contrast);
1805	if (ret < 0)
1806		return ret;
1807
1808	return 0;
1809}
1810
1811static const struct backlight_ops ssd130xfb_bl_ops = {
1812	.update_status	= ssd130x_update_bl,
1813};
1814
1815static void ssd130x_parse_properties(struct ssd130x_device *ssd130x)
1816{
1817	struct device *dev = ssd130x->dev;
1818
1819	if (device_property_read_u32(dev, "solomon,width", &ssd130x->width))
1820		ssd130x->width = ssd130x->device_info->default_width;
1821
1822	if (device_property_read_u32(dev, "solomon,height", &ssd130x->height))
1823		ssd130x->height = ssd130x->device_info->default_height;
1824
1825	if (device_property_read_u32(dev, "solomon,page-offset", &ssd130x->page_offset))
1826		ssd130x->page_offset = 1;
1827
1828	if (device_property_read_u32(dev, "solomon,col-offset", &ssd130x->col_offset))
1829		ssd130x->col_offset = 0;
1830
1831	if (device_property_read_u32(dev, "solomon,com-offset", &ssd130x->com_offset))
1832		ssd130x->com_offset = 0;
1833
1834	if (device_property_read_u32(dev, "solomon,prechargep1", &ssd130x->prechargep1))
1835		ssd130x->prechargep1 = 2;
1836
1837	if (device_property_read_u32(dev, "solomon,prechargep2", &ssd130x->prechargep2))
1838		ssd130x->prechargep2 = 2;
1839
1840	if (!device_property_read_u8_array(dev, "solomon,lookup-table",
1841					   ssd130x->lookup_table,
1842					   ARRAY_SIZE(ssd130x->lookup_table)))
1843		ssd130x->lookup_table_set = 1;
1844
1845	ssd130x->seg_remap = !device_property_read_bool(dev, "solomon,segment-no-remap");
1846	ssd130x->com_seq = device_property_read_bool(dev, "solomon,com-seq");
1847	ssd130x->com_lrremap = device_property_read_bool(dev, "solomon,com-lrremap");
1848	ssd130x->com_invdir = device_property_read_bool(dev, "solomon,com-invdir");
1849	ssd130x->area_color_enable =
1850		device_property_read_bool(dev, "solomon,area-color-enable");
1851	ssd130x->low_power = device_property_read_bool(dev, "solomon,low-power");
1852
1853	ssd130x->contrast = 127;
1854	ssd130x->vcomh = ssd130x->device_info->default_vcomh;
1855
1856	/* Setup display timing */
1857	if (device_property_read_u32(dev, "solomon,dclk-div", &ssd130x->dclk_div))
1858		ssd130x->dclk_div = ssd130x->device_info->default_dclk_div;
1859	if (device_property_read_u32(dev, "solomon,dclk-frq", &ssd130x->dclk_frq))
1860		ssd130x->dclk_frq = ssd130x->device_info->default_dclk_frq;
1861}
1862
1863static int ssd130x_init_modeset(struct ssd130x_device *ssd130x)
1864{
1865	enum ssd130x_family_ids family_id = ssd130x->device_info->family_id;
1866	struct drm_display_mode *mode = &ssd130x->mode;
1867	struct device *dev = ssd130x->dev;
1868	struct drm_device *drm = &ssd130x->drm;
1869	unsigned long max_width, max_height;
1870	struct drm_plane *primary_plane;
1871	struct drm_crtc *crtc;
1872	struct drm_encoder *encoder;
1873	struct drm_connector *connector;
1874	int ret;
1875
1876	/*
1877	 * Modesetting
1878	 */
1879
1880	ret = drmm_mode_config_init(drm);
1881	if (ret) {
1882		dev_err(dev, "DRM mode config init failed: %d\n", ret);
1883		return ret;
1884	}
1885
1886	mode->type = DRM_MODE_TYPE_DRIVER;
1887	mode->clock = 1;
1888	mode->hdisplay = mode->htotal = ssd130x->width;
1889	mode->hsync_start = mode->hsync_end = ssd130x->width;
1890	mode->vdisplay = mode->vtotal = ssd130x->height;
1891	mode->vsync_start = mode->vsync_end = ssd130x->height;
1892	mode->width_mm = 27;
1893	mode->height_mm = 27;
1894
1895	max_width = max_t(unsigned long, mode->hdisplay, DRM_SHADOW_PLANE_MAX_WIDTH);
1896	max_height = max_t(unsigned long, mode->vdisplay, DRM_SHADOW_PLANE_MAX_HEIGHT);
1897
1898	drm->mode_config.min_width = mode->hdisplay;
1899	drm->mode_config.max_width = max_width;
1900	drm->mode_config.min_height = mode->vdisplay;
1901	drm->mode_config.max_height = max_height;
1902	drm->mode_config.preferred_depth = 24;
1903	drm->mode_config.funcs = &ssd130x_mode_config_funcs;
1904
1905	/* Primary plane */
1906
1907	primary_plane = &ssd130x->primary_plane;
1908	ret = drm_universal_plane_init(drm, primary_plane, 0, &ssd130x_primary_plane_funcs,
1909				       ssd130x_formats, ARRAY_SIZE(ssd130x_formats),
1910				       NULL, DRM_PLANE_TYPE_PRIMARY, NULL);
1911	if (ret) {
1912		dev_err(dev, "DRM primary plane init failed: %d\n", ret);
1913		return ret;
1914	}
1915
1916	drm_plane_helper_add(primary_plane, &ssd130x_primary_plane_helper_funcs[family_id]);
1917
1918	drm_plane_enable_fb_damage_clips(primary_plane);
1919
1920	/* CRTC */
1921
1922	crtc = &ssd130x->crtc;
1923	ret = drm_crtc_init_with_planes(drm, crtc, primary_plane, NULL,
1924					&ssd130x_crtc_funcs, NULL);
1925	if (ret) {
1926		dev_err(dev, "DRM crtc init failed: %d\n", ret);
1927		return ret;
1928	}
1929
1930	drm_crtc_helper_add(crtc, &ssd130x_crtc_helper_funcs[family_id]);
1931
1932	/* Encoder */
1933
1934	encoder = &ssd130x->encoder;
1935	ret = drm_encoder_init(drm, encoder, &ssd130x_encoder_funcs,
1936			       DRM_MODE_ENCODER_NONE, NULL);
1937	if (ret) {
1938		dev_err(dev, "DRM encoder init failed: %d\n", ret);
1939		return ret;
1940	}
1941
1942	drm_encoder_helper_add(encoder, &ssd130x_encoder_helper_funcs[family_id]);
1943
1944	encoder->possible_crtcs = drm_crtc_mask(crtc);
1945
1946	/* Connector */
1947
1948	connector = &ssd130x->connector;
1949	ret = drm_connector_init(drm, connector, &ssd130x_connector_funcs,
1950				 DRM_MODE_CONNECTOR_Unknown);
1951	if (ret) {
1952		dev_err(dev, "DRM connector init failed: %d\n", ret);
1953		return ret;
1954	}
1955
1956	drm_connector_helper_add(connector, &ssd130x_connector_helper_funcs);
1957
1958	ret = drm_connector_attach_encoder(connector, encoder);
1959	if (ret) {
1960		dev_err(dev, "DRM attach connector to encoder failed: %d\n", ret);
1961		return ret;
1962	}
1963
1964	drm_mode_config_reset(drm);
1965
1966	return 0;
1967}
1968
1969static int ssd130x_get_resources(struct ssd130x_device *ssd130x)
1970{
1971	struct device *dev = ssd130x->dev;
1972
1973	ssd130x->reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_LOW);
1974	if (IS_ERR(ssd130x->reset))
1975		return dev_err_probe(dev, PTR_ERR(ssd130x->reset),
1976				     "Failed to get reset gpio\n");
1977
1978	ssd130x->vcc_reg = devm_regulator_get(dev, "vcc");
1979	if (IS_ERR(ssd130x->vcc_reg))
1980		return dev_err_probe(dev, PTR_ERR(ssd130x->vcc_reg),
1981				     "Failed to get VCC regulator\n");
1982
1983	return 0;
1984}
1985
1986struct ssd130x_device *ssd130x_probe(struct device *dev, struct regmap *regmap)
1987{
1988	struct ssd130x_device *ssd130x;
1989	struct backlight_device *bl;
1990	struct drm_device *drm;
1991	int ret;
1992
1993	ssd130x = devm_drm_dev_alloc(dev, &ssd130x_drm_driver,
1994				     struct ssd130x_device, drm);
1995	if (IS_ERR(ssd130x))
1996		return ERR_PTR(dev_err_probe(dev, PTR_ERR(ssd130x),
1997					     "Failed to allocate DRM device\n"));
1998
1999	drm = &ssd130x->drm;
2000
2001	ssd130x->dev = dev;
2002	ssd130x->regmap = regmap;
2003	ssd130x->device_info = device_get_match_data(dev);
2004
2005	if (ssd130x->device_info->page_mode_only)
2006		ssd130x->page_address_mode = 1;
2007
2008	ssd130x_parse_properties(ssd130x);
2009
2010	ret = ssd130x_get_resources(ssd130x);
2011	if (ret)
2012		return ERR_PTR(ret);
2013
2014	bl = devm_backlight_device_register(dev, dev_name(dev), dev, ssd130x,
2015					    &ssd130xfb_bl_ops, NULL);
2016	if (IS_ERR(bl))
2017		return ERR_PTR(dev_err_probe(dev, PTR_ERR(bl),
2018					     "Unable to register backlight device\n"));
2019
2020	bl->props.brightness = ssd130x->contrast;
2021	bl->props.max_brightness = MAX_CONTRAST;
2022	ssd130x->bl_dev = bl;
2023
2024	ret = ssd130x_init_modeset(ssd130x);
2025	if (ret)
2026		return ERR_PTR(ret);
2027
2028	ret = drm_dev_register(drm, 0);
2029	if (ret)
2030		return ERR_PTR(dev_err_probe(dev, ret, "DRM device register failed\n"));
2031
2032	drm_fbdev_generic_setup(drm, 32);
2033
2034	return ssd130x;
2035}
2036EXPORT_SYMBOL_GPL(ssd130x_probe);
2037
2038void ssd130x_remove(struct ssd130x_device *ssd130x)
2039{
2040	drm_dev_unplug(&ssd130x->drm);
2041	drm_atomic_helper_shutdown(&ssd130x->drm);
2042}
2043EXPORT_SYMBOL_GPL(ssd130x_remove);
2044
2045void ssd130x_shutdown(struct ssd130x_device *ssd130x)
2046{
2047	drm_atomic_helper_shutdown(&ssd130x->drm);
2048}
2049EXPORT_SYMBOL_GPL(ssd130x_shutdown);
2050
2051MODULE_DESCRIPTION(DRIVER_DESC);
2052MODULE_AUTHOR("Javier Martinez Canillas <javierm@redhat.com>");
2053MODULE_LICENSE("GPL v2");