drivers/video/backlight/otm3225a.c - third_party/linux - Git at Google


            
            // SPDX-License-Identifier: GPL-2.0

            
            /* Driver for ORISE Technology OTM3225A SOC for TFT LCD

            
             * Copyright (C) 2017, EETS GmbH, Felix Brack <fb@ltec.ch>

            
             *

            
             * This driver implements a lcd device for the ORISE OTM3225A display

            
             * controller. The control interface to the display is SPI and the display's

            
             * memory is updated over the 16-bit RGB interface.

            
             * The main source of information for writing this driver was provided by the

            
             * OTM3225A datasheet from ORISE Technology. Some information arise from the

            
             * ILI9328 datasheet from ILITEK as well as from the datasheets and sample code

            
             * provided by Crystalfontz America Inc. who sells the CFAF240320A-032T, a 3.2"

            
             * TFT LC display using the OTM3225A controller.

            
             */


            #include <linux/delay.h>

            
            #include <linux/device.h>

            
            #include <linux/kernel.h>

            
            #include <linux/lcd.h>

            
            #include <linux/module.h>

            
            #include <linux/spi/spi.h>


            #define OTM3225A_INDEX_REG	0x70

            
            #define OTM3225A_DATA_REG	0x72


            /* instruction register list */

            
            #define DRIVER_OUTPUT_CTRL_1	0x01

            
            #define DRIVER_WAVEFORM_CTRL	0x02

            
            #define ENTRY_MODE		0x03

            
            #define SCALING_CTRL		0x04

            
            #define DISPLAY_CTRL_1		0x07

            
            #define DISPLAY_CTRL_2		0x08

            
            #define DISPLAY_CTRL_3		0x09

            
            #define FRAME_CYCLE_CTRL	0x0A

            
            #define EXT_DISP_IFACE_CTRL_1	0x0C

            
            #define FRAME_MAKER_POS		0x0D

            
            #define EXT_DISP_IFACE_CTRL_2	0x0F

            
            #define POWER_CTRL_1		0x10

            
            #define POWER_CTRL_2		0x11

            
            #define POWER_CTRL_3		0x12

            
            #define POWER_CTRL_4		0x13

            
            #define GRAM_ADDR_HORIZ_SET	0x20

            
            #define GRAM_ADDR_VERT_SET	0x21

            
            #define GRAM_READ_WRITE		0x22

            
            #define POWER_CTRL_7		0x29

            
            #define FRAME_RATE_CTRL		0x2B

            
            #define GAMMA_CTRL_1		0x30

            
            #define GAMMA_CTRL_2		0x31

            
            #define GAMMA_CTRL_3		0x32

            
            #define GAMMA_CTRL_4		0x35

            
            #define GAMMA_CTRL_5		0x36

            
            #define GAMMA_CTRL_6		0x37

            
            #define GAMMA_CTRL_7		0x38

            
            #define GAMMA_CTRL_8		0x39

            
            #define GAMMA_CTRL_9		0x3C

            
            #define GAMMA_CTRL_10		0x3D

            
            #define WINDOW_HORIZ_RAM_START	0x50

            
            #define WINDOW_HORIZ_RAM_END	0x51

            
            #define WINDOW_VERT_RAM_START	0x52

            
            #define WINDOW_VERT_RAM_END	0x53

            
            #define DRIVER_OUTPUT_CTRL_2	0x60

            
            #define BASE_IMG_DISPLAY_CTRL	0x61

            
            #define VERT_SCROLL_CTRL	0x6A

            
            #define PD1_DISPLAY_POS		0x80

            
            #define PD1_RAM_START		0x81

            
            #define PD1_RAM_END		0x82

            
            #define PD2_DISPLAY_POS		0x83

            
            #define PD2_RAM_START		0x84

            
            #define PD2_RAM_END		0x85

            
            #define PANEL_IFACE_CTRL_1	0x90

            
            #define PANEL_IFACE_CTRL_2	0x92

            
            #define PANEL_IFACE_CTRL_4	0x95

            
            #define PANEL_IFACE_CTRL_5	0x97


            struct otm3225a_data {

            
            	struct spi_device *spi;

            
            	struct lcd_device *ld;

            
            	int power;

            
            };


            struct otm3225a_spi_instruction {

            
            	unsigned char reg;	/* register to write */

            
            	unsigned short value;	/* data to write to 'reg' */

            
            	unsigned short delay;	/* delay in ms after write */

            
            };


            static struct otm3225a_spi_instruction display_init[] = {

            
            	{ DRIVER_OUTPUT_CTRL_1,		0x0000, 0 },

            
            	{ DRIVER_WAVEFORM_CTRL,		0x0700, 0 },

            
            	{ ENTRY_MODE,			0x50A0, 0 },

            
            	{ SCALING_CTRL,			0x0000, 0 },

            
            	{ DISPLAY_CTRL_2,		0x0606, 0 },

            
            	{ DISPLAY_CTRL_3,		0x0000, 0 },

            
            	{ FRAME_CYCLE_CTRL,		0x0000, 0 },

            
            	{ EXT_DISP_IFACE_CTRL_1,	0x0000, 0 },

            
            	{ FRAME_MAKER_POS,		0x0000, 0 },

            
            	{ EXT_DISP_IFACE_CTRL_2,	0x0002, 0 },

            
            	{ POWER_CTRL_2,			0x0007, 0 },

            
            	{ POWER_CTRL_3,			0x0000, 0 },

            
            	{ POWER_CTRL_4,			0x0000, 200 },

            
            	{ DISPLAY_CTRL_1,		0x0101, 0 },

            
            	{ POWER_CTRL_1,			0x12B0, 0 },

            
            	{ POWER_CTRL_2,			0x0007, 0 },

            
            	{ POWER_CTRL_3,			0x01BB, 50 },

            
            	{ POWER_CTRL_4,			0x0013, 0 },

            
            	{ POWER_CTRL_7,			0x0010, 50 },

            
            	{ GAMMA_CTRL_1,			0x000A, 0 },

            
            	{ GAMMA_CTRL_2,			0x1326, 0 },

            
            	{ GAMMA_CTRL_3,			0x0A29, 0 },

            
            	{ GAMMA_CTRL_4,			0x0A0A, 0 },

            
            	{ GAMMA_CTRL_5,			0x1E03, 0 },

            
            	{ GAMMA_CTRL_6,			0x031E, 0 },

            
            	{ GAMMA_CTRL_7,			0x0706, 0 },

            
            	{ GAMMA_CTRL_8,			0x0303, 0 },

            
            	{ GAMMA_CTRL_9,			0x010E, 0 },

            
            	{ GAMMA_CTRL_10,		0x040E, 0 },

            
            	{ WINDOW_HORIZ_RAM_START,	0x0000, 0 },

            
            	{ WINDOW_HORIZ_RAM_END,		0x00EF, 0 },

            
            	{ WINDOW_VERT_RAM_START,	0x0000, 0 },

            
            	{ WINDOW_VERT_RAM_END,		0x013F, 0 },

            
            	{ DRIVER_OUTPUT_CTRL_2,		0x2700, 0 },

            
            	{ BASE_IMG_DISPLAY_CTRL,	0x0001, 0 },

            
            	{ VERT_SCROLL_CTRL,		0x0000, 0 },

            
            	{ PD1_DISPLAY_POS,		0x0000, 0 },

            
            	{ PD1_RAM_START,		0x0000, 0 },

            
            	{ PD1_RAM_END,			0x0000, 0 },

            
            	{ PD2_DISPLAY_POS,		0x0000, 0 },

            
            	{ PD2_RAM_START,		0x0000, 0 },

            
            	{ PD2_RAM_END,			0x0000, 0 },

            
            	{ PANEL_IFACE_CTRL_1,		0x0010, 0 },

            
            	{ PANEL_IFACE_CTRL_2,		0x0000, 0 },

            
            	{ PANEL_IFACE_CTRL_4,		0x0210, 0 },

            
            	{ PANEL_IFACE_CTRL_5,		0x0000, 0 },

            
            	{ DISPLAY_CTRL_1,		0x0133, 0 },

            
            };


            static struct otm3225a_spi_instruction display_enable_rgb_interface[] = {

            
            	{ ENTRY_MODE,			0x1080, 0 },

            
            	{ GRAM_ADDR_HORIZ_SET,		0x0000, 0 },

            
            	{ GRAM_ADDR_VERT_SET,		0x0000, 0 },

            
            	{ EXT_DISP_IFACE_CTRL_1,	0x0111, 500 },

            
            };


            static struct otm3225a_spi_instruction display_off[] = {

            
            	{ DISPLAY_CTRL_1,	0x0131, 100 },

            
            	{ DISPLAY_CTRL_1,	0x0130, 100 },

            
            	{ DISPLAY_CTRL_1,	0x0100, 0 },

            
            	{ POWER_CTRL_1,		0x0280, 0 },

            
            	{ POWER_CTRL_3,		0x018B, 0 },

            
            };


            static struct otm3225a_spi_instruction display_on[] = {

            
            	{ POWER_CTRL_1,		0x1280, 0 },

            
            	{ DISPLAY_CTRL_1,	0x0101, 100 },

            
            	{ DISPLAY_CTRL_1,	0x0121, 0 },

            
            	{ DISPLAY_CTRL_1,	0x0123, 100 },

            
            	{ DISPLAY_CTRL_1,	0x0133, 10 },

            
            };


            static void otm3225a_write(struct spi_device *spi,

            
            			   struct otm3225a_spi_instruction *instruction,

            
            			   unsigned int count)

            
            {

            
            	unsigned char buf[3];


            	while (count--) {

            
            		/* address register using index register */

            
            		buf[0] = OTM3225A_INDEX_REG;

            
            		buf[1] = 0x00;

            
            		buf[2] = instruction->reg;

            
            		spi_write(spi, buf, 3);


            		/* write data to addressed register */

            
            		buf[0] = OTM3225A_DATA_REG;

            
            		buf[1] = (instruction->value >> 8) & 0xff;

            
            		buf[2] = instruction->value & 0xff;

            
            		spi_write(spi, buf, 3);


            		/* execute delay if any */

            
            		if (instruction->delay)

            
            			msleep(instruction->delay);

            
            		instruction++;

            
            	}

            
            }


            static int otm3225a_set_power(struct lcd_device *ld, int power)

            
            {

            
            	struct otm3225a_data *dd = lcd_get_data(ld);


            	if (power == dd->power)

            
            		return 0;


            	if (power > LCD_POWER_ON)

            
            		otm3225a_write(dd->spi, display_off, ARRAY_SIZE(display_off));

            
            	else

            
            		otm3225a_write(dd->spi, display_on, ARRAY_SIZE(display_on));

            
            	dd->power = power;


            	return 0;

            
            }


            static int otm3225a_get_power(struct lcd_device *ld)

            
            {

            
            	struct otm3225a_data *dd = lcd_get_data(ld);


            	return dd->power;

            
            }


            static const struct lcd_ops otm3225a_ops = {

            
            	.set_power = otm3225a_set_power,

            
            	.get_power = otm3225a_get_power,

            
            };


            static int otm3225a_probe(struct spi_device *spi)

            
            {

            
            	struct otm3225a_data *dd;

            
            	struct lcd_device *ld;

            
            	struct device *dev = &spi->dev;


            	dd = devm_kzalloc(dev, sizeof(struct otm3225a_data), GFP_KERNEL);

            
            	if (dd == NULL)

            
            		return -ENOMEM;


            	ld = devm_lcd_device_register(dev, dev_name(dev), dev, dd,

            
            				      &otm3225a_ops);

            
            	if (IS_ERR(ld))

            
            		return PTR_ERR(ld);


            	dd->spi = spi;

            
            	dd->ld = ld;

            
            	dev_set_drvdata(dev, dd);


            	dev_info(dev, "Initializing and switching to RGB interface");

            
            	otm3225a_write(spi, display_init, ARRAY_SIZE(display_init));

            
            	otm3225a_write(spi, display_enable_rgb_interface,

            
            		       ARRAY_SIZE(display_enable_rgb_interface));

            
            	return 0;

            
            }


            static struct spi_driver otm3225a_driver = {

            
            	.driver = {

            
            		.name = "otm3225a",

            
            	},

            
            	.probe = otm3225a_probe,

            
            };


            module_spi_driver(otm3225a_driver);


            MODULE_AUTHOR("Felix Brack <fb@ltec.ch>");

            
            MODULE_DESCRIPTION("OTM3225A TFT LCD driver");

            
            MODULE_VERSION("1.0.0");

            
            MODULE_LICENSE("GPL v2");
	// SPDX-License-Identifier: GPL-2.0
	/* Driver for ORISE Technology OTM3225A SOC for TFT LCD
	* Copyright (C) 2017, EETS GmbH, Felix Brack <fb@ltec.ch>
	*
	* This driver implements a lcd device for the ORISE OTM3225A display
	* controller. The control interface to the display is SPI and the display's
	* memory is updated over the 16-bit RGB interface.
	* The main source of information for writing this driver was provided by the
	* OTM3225A datasheet from ORISE Technology. Some information arise from the
	* ILI9328 datasheet from ILITEK as well as from the datasheets and sample code
	* provided by Crystalfontz America Inc. who sells the CFAF240320A-032T, a 3.2"
	* TFT LC display using the OTM3225A controller.
	*/

	#include <linux/delay.h>
	#include <linux/device.h>
	#include <linux/kernel.h>
	#include <linux/lcd.h>
	#include <linux/module.h>
	#include <linux/spi/spi.h>

	#define OTM3225A_INDEX_REG 0x70
	#define OTM3225A_DATA_REG 0x72

	/* instruction register list */
	#define DRIVER_OUTPUT_CTRL_1 0x01
	#define DRIVER_WAVEFORM_CTRL 0x02
	#define ENTRY_MODE 0x03
	#define SCALING_CTRL 0x04
	#define DISPLAY_CTRL_1 0x07
	#define DISPLAY_CTRL_2 0x08
	#define DISPLAY_CTRL_3 0x09
	#define FRAME_CYCLE_CTRL 0x0A
	#define EXT_DISP_IFACE_CTRL_1 0x0C
	#define FRAME_MAKER_POS 0x0D
	#define EXT_DISP_IFACE_CTRL_2 0x0F
	#define POWER_CTRL_1 0x10
	#define POWER_CTRL_2 0x11
	#define POWER_CTRL_3 0x12
	#define POWER_CTRL_4 0x13
	#define GRAM_ADDR_HORIZ_SET 0x20
	#define GRAM_ADDR_VERT_SET 0x21
	#define GRAM_READ_WRITE 0x22
	#define POWER_CTRL_7 0x29
	#define FRAME_RATE_CTRL 0x2B
	#define GAMMA_CTRL_1 0x30
	#define GAMMA_CTRL_2 0x31
	#define GAMMA_CTRL_3 0x32
	#define GAMMA_CTRL_4 0x35
	#define GAMMA_CTRL_5 0x36
	#define GAMMA_CTRL_6 0x37
	#define GAMMA_CTRL_7 0x38
	#define GAMMA_CTRL_8 0x39
	#define GAMMA_CTRL_9 0x3C
	#define GAMMA_CTRL_10 0x3D
	#define WINDOW_HORIZ_RAM_START 0x50
	#define WINDOW_HORIZ_RAM_END 0x51
	#define WINDOW_VERT_RAM_START 0x52
	#define WINDOW_VERT_RAM_END 0x53
	#define DRIVER_OUTPUT_CTRL_2 0x60
	#define BASE_IMG_DISPLAY_CTRL 0x61
	#define VERT_SCROLL_CTRL 0x6A
	#define PD1_DISPLAY_POS 0x80
	#define PD1_RAM_START 0x81
	#define PD1_RAM_END 0x82
	#define PD2_DISPLAY_POS 0x83
	#define PD2_RAM_START 0x84
	#define PD2_RAM_END 0x85
	#define PANEL_IFACE_CTRL_1 0x90
	#define PANEL_IFACE_CTRL_2 0x92
	#define PANEL_IFACE_CTRL_4 0x95
	#define PANEL_IFACE_CTRL_5 0x97

	struct otm3225a_data {
	struct spi_device *spi;
	struct lcd_device *ld;
	int power;
	};

	struct otm3225a_spi_instruction {
	unsigned char reg; /* register to write */
	unsigned short value; /* data to write to 'reg' */
	unsigned short delay; /* delay in ms after write */
	};

	static struct otm3225a_spi_instruction display_init[] = {
	{ DRIVER_OUTPUT_CTRL_1, 0x0000, 0 },
	{ DRIVER_WAVEFORM_CTRL, 0x0700, 0 },
	{ ENTRY_MODE, 0x50A0, 0 },
	{ SCALING_CTRL, 0x0000, 0 },
	{ DISPLAY_CTRL_2, 0x0606, 0 },
	{ DISPLAY_CTRL_3, 0x0000, 0 },
	{ FRAME_CYCLE_CTRL, 0x0000, 0 },
	{ EXT_DISP_IFACE_CTRL_1, 0x0000, 0 },
	{ FRAME_MAKER_POS, 0x0000, 0 },
	{ EXT_DISP_IFACE_CTRL_2, 0x0002, 0 },
	{ POWER_CTRL_2, 0x0007, 0 },
	{ POWER_CTRL_3, 0x0000, 0 },
	{ POWER_CTRL_4, 0x0000, 200 },
	{ DISPLAY_CTRL_1, 0x0101, 0 },
	{ POWER_CTRL_1, 0x12B0, 0 },
	{ POWER_CTRL_2, 0x0007, 0 },
	{ POWER_CTRL_3, 0x01BB, 50 },
	{ POWER_CTRL_4, 0x0013, 0 },
	{ POWER_CTRL_7, 0x0010, 50 },
	{ GAMMA_CTRL_1, 0x000A, 0 },
	{ GAMMA_CTRL_2, 0x1326, 0 },
	{ GAMMA_CTRL_3, 0x0A29, 0 },
	{ GAMMA_CTRL_4, 0x0A0A, 0 },
	{ GAMMA_CTRL_5, 0x1E03, 0 },
	{ GAMMA_CTRL_6, 0x031E, 0 },
	{ GAMMA_CTRL_7, 0x0706, 0 },
	{ GAMMA_CTRL_8, 0x0303, 0 },
	{ GAMMA_CTRL_9, 0x010E, 0 },
	{ GAMMA_CTRL_10, 0x040E, 0 },
	{ WINDOW_HORIZ_RAM_START, 0x0000, 0 },
	{ WINDOW_HORIZ_RAM_END, 0x00EF, 0 },
	{ WINDOW_VERT_RAM_START, 0x0000, 0 },
	{ WINDOW_VERT_RAM_END, 0x013F, 0 },
	{ DRIVER_OUTPUT_CTRL_2, 0x2700, 0 },
	{ BASE_IMG_DISPLAY_CTRL, 0x0001, 0 },
	{ VERT_SCROLL_CTRL, 0x0000, 0 },
	{ PD1_DISPLAY_POS, 0x0000, 0 },
	{ PD1_RAM_START, 0x0000, 0 },
	{ PD1_RAM_END, 0x0000, 0 },
	{ PD2_DISPLAY_POS, 0x0000, 0 },
	{ PD2_RAM_START, 0x0000, 0 },
	{ PD2_RAM_END, 0x0000, 0 },
	{ PANEL_IFACE_CTRL_1, 0x0010, 0 },
	{ PANEL_IFACE_CTRL_2, 0x0000, 0 },
	{ PANEL_IFACE_CTRL_4, 0x0210, 0 },
	{ PANEL_IFACE_CTRL_5, 0x0000, 0 },
	{ DISPLAY_CTRL_1, 0x0133, 0 },
	};

	static struct otm3225a_spi_instruction display_enable_rgb_interface[] = {
	{ ENTRY_MODE, 0x1080, 0 },
	{ GRAM_ADDR_HORIZ_SET, 0x0000, 0 },
	{ GRAM_ADDR_VERT_SET, 0x0000, 0 },
	{ EXT_DISP_IFACE_CTRL_1, 0x0111, 500 },
	};

	static struct otm3225a_spi_instruction display_off[] = {
	{ DISPLAY_CTRL_1, 0x0131, 100 },
	{ DISPLAY_CTRL_1, 0x0130, 100 },
	{ DISPLAY_CTRL_1, 0x0100, 0 },
	{ POWER_CTRL_1, 0x0280, 0 },
	{ POWER_CTRL_3, 0x018B, 0 },
	};

	static struct otm3225a_spi_instruction display_on[] = {
	{ POWER_CTRL_1, 0x1280, 0 },
	{ DISPLAY_CTRL_1, 0x0101, 100 },
	{ DISPLAY_CTRL_1, 0x0121, 0 },
	{ DISPLAY_CTRL_1, 0x0123, 100 },
	{ DISPLAY_CTRL_1, 0x0133, 10 },
	};

	static void otm3225a_write(struct spi_device *spi,
	struct otm3225a_spi_instruction *instruction,
	unsigned int count)
	{
	unsigned char buf[3];

	while (count--) {
	/* address register using index register */
	buf[0] = OTM3225A_INDEX_REG;
	buf[1] = 0x00;
	buf[2] = instruction->reg;
	spi_write(spi, buf, 3);

	/* write data to addressed register */
	buf[0] = OTM3225A_DATA_REG;
	buf[1] = (instruction->value >> 8) & 0xff;
	buf[2] = instruction->value & 0xff;
	spi_write(spi, buf, 3);

	/* execute delay if any */
	if (instruction->delay)
	msleep(instruction->delay);
	instruction++;
	}
	}

	static int otm3225a_set_power(struct lcd_device *ld, int power)
	{
	struct otm3225a_data *dd = lcd_get_data(ld);

	if (power == dd->power)
	return 0;

	if (power > LCD_POWER_ON)
	otm3225a_write(dd->spi, display_off, ARRAY_SIZE(display_off));
	else
	otm3225a_write(dd->spi, display_on, ARRAY_SIZE(display_on));
	dd->power = power;

	return 0;
	}

	static int otm3225a_get_power(struct lcd_device *ld)
	{
	struct otm3225a_data *dd = lcd_get_data(ld);

	return dd->power;
	}

	static const struct lcd_ops otm3225a_ops = {
	.set_power = otm3225a_set_power,
	.get_power = otm3225a_get_power,
	};

	static int otm3225a_probe(struct spi_device *spi)
	{
	struct otm3225a_data *dd;
	struct lcd_device *ld;
	struct device *dev = &spi->dev;

	dd = devm_kzalloc(dev, sizeof(struct otm3225a_data), GFP_KERNEL);
	if (dd == NULL)
	return -ENOMEM;

	ld = devm_lcd_device_register(dev, dev_name(dev), dev, dd,
	&otm3225a_ops);
	if (IS_ERR(ld))
	return PTR_ERR(ld);

	dd->spi = spi;
	dd->ld = ld;
	dev_set_drvdata(dev, dd);

	dev_info(dev, "Initializing and switching to RGB interface");
	otm3225a_write(spi, display_init, ARRAY_SIZE(display_init));
	otm3225a_write(spi, display_enable_rgb_interface,
	ARRAY_SIZE(display_enable_rgb_interface));
	return 0;
	}

	static struct spi_driver otm3225a_driver = {
	.driver = {
	.name = "otm3225a",
	},
	.probe = otm3225a_probe,
	};

	module_spi_driver(otm3225a_driver);

	MODULE_AUTHOR("Felix Brack <fb@ltec.ch>");
	MODULE_DESCRIPTION("OTM3225A TFT LCD driver");
	MODULE_VERSION("1.0.0");
	MODULE_LICENSE("GPL v2");