xref: /OK3568_Linux_fs/kernel/drivers/video/backlight/ili9320.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /* drivers/video/backlight/ili9320.c
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * ILI9320 LCD controller driver core.
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  * Copyright 2007 Simtec Electronics
7*4882a593Smuzhiyun  *	http://armlinux.simtec.co.uk/
8*4882a593Smuzhiyun  *	Ben Dooks <ben@simtec.co.uk>
9*4882a593Smuzhiyun */
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun #include <linux/delay.h>
12*4882a593Smuzhiyun #include <linux/err.h>
13*4882a593Smuzhiyun #include <linux/fb.h>
14*4882a593Smuzhiyun #include <linux/init.h>
15*4882a593Smuzhiyun #include <linux/lcd.h>
16*4882a593Smuzhiyun #include <linux/module.h>
17*4882a593Smuzhiyun #include <linux/slab.h>
18*4882a593Smuzhiyun 
19*4882a593Smuzhiyun #include <linux/spi/spi.h>
20*4882a593Smuzhiyun 
21*4882a593Smuzhiyun #include <video/ili9320.h>
22*4882a593Smuzhiyun 
23*4882a593Smuzhiyun #include "ili9320.h"
24*4882a593Smuzhiyun 
25*4882a593Smuzhiyun 
ili9320_write_spi(struct ili9320 * ili,unsigned int reg,unsigned int value)26*4882a593Smuzhiyun static inline int ili9320_write_spi(struct ili9320 *ili,
27*4882a593Smuzhiyun 				    unsigned int reg,
28*4882a593Smuzhiyun 				    unsigned int value)
29*4882a593Smuzhiyun {
30*4882a593Smuzhiyun 	struct ili9320_spi *spi = &ili->access.spi;
31*4882a593Smuzhiyun 	unsigned char *addr = spi->buffer_addr;
32*4882a593Smuzhiyun 	unsigned char *data = spi->buffer_data;
33*4882a593Smuzhiyun 
34*4882a593Smuzhiyun 	/* spi message consits of:
35*4882a593Smuzhiyun 	 * first byte: ID and operation
36*4882a593Smuzhiyun 	 */
37*4882a593Smuzhiyun 
38*4882a593Smuzhiyun 	addr[0] = spi->id | ILI9320_SPI_INDEX | ILI9320_SPI_WRITE;
39*4882a593Smuzhiyun 	addr[1] = reg >> 8;
40*4882a593Smuzhiyun 	addr[2] = reg;
41*4882a593Smuzhiyun 
42*4882a593Smuzhiyun 	/* second message is the data to transfer */
43*4882a593Smuzhiyun 
44*4882a593Smuzhiyun 	data[0] = spi->id | ILI9320_SPI_DATA  | ILI9320_SPI_WRITE;
45*4882a593Smuzhiyun 	data[1] = value >> 8;
46*4882a593Smuzhiyun 	data[2] = value;
47*4882a593Smuzhiyun 
48*4882a593Smuzhiyun 	return spi_sync(spi->dev, &spi->message);
49*4882a593Smuzhiyun }
50*4882a593Smuzhiyun 
ili9320_write(struct ili9320 * ili,unsigned int reg,unsigned int value)51*4882a593Smuzhiyun int ili9320_write(struct ili9320 *ili, unsigned int reg, unsigned int value)
52*4882a593Smuzhiyun {
53*4882a593Smuzhiyun 	dev_dbg(ili->dev, "write: reg=%02x, val=%04x\n", reg, value);
54*4882a593Smuzhiyun 	return ili->write(ili, reg, value);
55*4882a593Smuzhiyun }
56*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(ili9320_write);
57*4882a593Smuzhiyun 
ili9320_write_regs(struct ili9320 * ili,const struct ili9320_reg * values,int nr_values)58*4882a593Smuzhiyun int ili9320_write_regs(struct ili9320 *ili,
59*4882a593Smuzhiyun 		       const struct ili9320_reg *values,
60*4882a593Smuzhiyun 		       int nr_values)
61*4882a593Smuzhiyun {
62*4882a593Smuzhiyun 	int index;
63*4882a593Smuzhiyun 	int ret;
64*4882a593Smuzhiyun 
65*4882a593Smuzhiyun 	for (index = 0; index < nr_values; index++, values++) {
66*4882a593Smuzhiyun 		ret = ili9320_write(ili, values->address, values->value);
67*4882a593Smuzhiyun 		if (ret != 0)
68*4882a593Smuzhiyun 			return ret;
69*4882a593Smuzhiyun 	}
70*4882a593Smuzhiyun 
71*4882a593Smuzhiyun 	return 0;
72*4882a593Smuzhiyun }
73*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(ili9320_write_regs);
74*4882a593Smuzhiyun 
ili9320_reset(struct ili9320 * lcd)75*4882a593Smuzhiyun static void ili9320_reset(struct ili9320 *lcd)
76*4882a593Smuzhiyun {
77*4882a593Smuzhiyun 	struct ili9320_platdata *cfg = lcd->platdata;
78*4882a593Smuzhiyun 
79*4882a593Smuzhiyun 	cfg->reset(1);
80*4882a593Smuzhiyun 	mdelay(50);
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun 	cfg->reset(0);
83*4882a593Smuzhiyun 	mdelay(50);
84*4882a593Smuzhiyun 
85*4882a593Smuzhiyun 	cfg->reset(1);
86*4882a593Smuzhiyun 	mdelay(100);
87*4882a593Smuzhiyun }
88*4882a593Smuzhiyun 
ili9320_init_chip(struct ili9320 * lcd)89*4882a593Smuzhiyun static inline int ili9320_init_chip(struct ili9320 *lcd)
90*4882a593Smuzhiyun {
91*4882a593Smuzhiyun 	int ret;
92*4882a593Smuzhiyun 
93*4882a593Smuzhiyun 	ili9320_reset(lcd);
94*4882a593Smuzhiyun 
95*4882a593Smuzhiyun 	ret = lcd->client->init(lcd, lcd->platdata);
96*4882a593Smuzhiyun 	if (ret != 0) {
97*4882a593Smuzhiyun 		dev_err(lcd->dev, "failed to initialise display\n");
98*4882a593Smuzhiyun 		return ret;
99*4882a593Smuzhiyun 	}
100*4882a593Smuzhiyun 
101*4882a593Smuzhiyun 	lcd->initialised = 1;
102*4882a593Smuzhiyun 	return 0;
103*4882a593Smuzhiyun }
104*4882a593Smuzhiyun 
ili9320_power_on(struct ili9320 * lcd)105*4882a593Smuzhiyun static inline int ili9320_power_on(struct ili9320 *lcd)
106*4882a593Smuzhiyun {
107*4882a593Smuzhiyun 	if (!lcd->initialised)
108*4882a593Smuzhiyun 		ili9320_init_chip(lcd);
109*4882a593Smuzhiyun 
110*4882a593Smuzhiyun 	lcd->display1 |= (ILI9320_DISPLAY1_D(3) | ILI9320_DISPLAY1_BASEE);
111*4882a593Smuzhiyun 	ili9320_write(lcd, ILI9320_DISPLAY1, lcd->display1);
112*4882a593Smuzhiyun 
113*4882a593Smuzhiyun 	return 0;
114*4882a593Smuzhiyun }
115*4882a593Smuzhiyun 
ili9320_power_off(struct ili9320 * lcd)116*4882a593Smuzhiyun static inline int ili9320_power_off(struct ili9320 *lcd)
117*4882a593Smuzhiyun {
118*4882a593Smuzhiyun 	lcd->display1 &= ~(ILI9320_DISPLAY1_D(3) | ILI9320_DISPLAY1_BASEE);
119*4882a593Smuzhiyun 	ili9320_write(lcd, ILI9320_DISPLAY1, lcd->display1);
120*4882a593Smuzhiyun 
121*4882a593Smuzhiyun 	return 0;
122*4882a593Smuzhiyun }
123*4882a593Smuzhiyun 
124*4882a593Smuzhiyun #define POWER_IS_ON(pwr)	((pwr) <= FB_BLANK_NORMAL)
125*4882a593Smuzhiyun 
ili9320_power(struct ili9320 * lcd,int power)126*4882a593Smuzhiyun static int ili9320_power(struct ili9320 *lcd, int power)
127*4882a593Smuzhiyun {
128*4882a593Smuzhiyun 	int ret = 0;
129*4882a593Smuzhiyun 
130*4882a593Smuzhiyun 	dev_dbg(lcd->dev, "power %d => %d\n", lcd->power, power);
131*4882a593Smuzhiyun 
132*4882a593Smuzhiyun 	if (POWER_IS_ON(power) && !POWER_IS_ON(lcd->power))
133*4882a593Smuzhiyun 		ret = ili9320_power_on(lcd);
134*4882a593Smuzhiyun 	else if (!POWER_IS_ON(power) && POWER_IS_ON(lcd->power))
135*4882a593Smuzhiyun 		ret = ili9320_power_off(lcd);
136*4882a593Smuzhiyun 
137*4882a593Smuzhiyun 	if (ret == 0)
138*4882a593Smuzhiyun 		lcd->power = power;
139*4882a593Smuzhiyun 	else
140*4882a593Smuzhiyun 		dev_warn(lcd->dev, "failed to set power mode %d\n", power);
141*4882a593Smuzhiyun 
142*4882a593Smuzhiyun 	return ret;
143*4882a593Smuzhiyun }
144*4882a593Smuzhiyun 
to_our_lcd(struct lcd_device * lcd)145*4882a593Smuzhiyun static inline struct ili9320 *to_our_lcd(struct lcd_device *lcd)
146*4882a593Smuzhiyun {
147*4882a593Smuzhiyun 	return lcd_get_data(lcd);
148*4882a593Smuzhiyun }
149*4882a593Smuzhiyun 
ili9320_set_power(struct lcd_device * ld,int power)150*4882a593Smuzhiyun static int ili9320_set_power(struct lcd_device *ld, int power)
151*4882a593Smuzhiyun {
152*4882a593Smuzhiyun 	struct ili9320 *lcd = to_our_lcd(ld);
153*4882a593Smuzhiyun 
154*4882a593Smuzhiyun 	return ili9320_power(lcd, power);
155*4882a593Smuzhiyun }
156*4882a593Smuzhiyun 
ili9320_get_power(struct lcd_device * ld)157*4882a593Smuzhiyun static int ili9320_get_power(struct lcd_device *ld)
158*4882a593Smuzhiyun {
159*4882a593Smuzhiyun 	struct ili9320 *lcd = to_our_lcd(ld);
160*4882a593Smuzhiyun 
161*4882a593Smuzhiyun 	return lcd->power;
162*4882a593Smuzhiyun }
163*4882a593Smuzhiyun 
164*4882a593Smuzhiyun static struct lcd_ops ili9320_ops = {
165*4882a593Smuzhiyun 	.get_power	= ili9320_get_power,
166*4882a593Smuzhiyun 	.set_power	= ili9320_set_power,
167*4882a593Smuzhiyun };
168*4882a593Smuzhiyun 
ili9320_setup_spi(struct ili9320 * ili,struct spi_device * dev)169*4882a593Smuzhiyun static void ili9320_setup_spi(struct ili9320 *ili,
170*4882a593Smuzhiyun 					struct spi_device *dev)
171*4882a593Smuzhiyun {
172*4882a593Smuzhiyun 	struct ili9320_spi *spi = &ili->access.spi;
173*4882a593Smuzhiyun 
174*4882a593Smuzhiyun 	ili->write = ili9320_write_spi;
175*4882a593Smuzhiyun 	spi->dev = dev;
176*4882a593Smuzhiyun 
177*4882a593Smuzhiyun 	/* fill the two messages we are going to use to send the data
178*4882a593Smuzhiyun 	 * with, the first the address followed by the data. The datasheet
179*4882a593Smuzhiyun 	 * says they should be done as two distinct cycles of the SPI CS line.
180*4882a593Smuzhiyun 	 */
181*4882a593Smuzhiyun 
182*4882a593Smuzhiyun 	spi->xfer[0].tx_buf = spi->buffer_addr;
183*4882a593Smuzhiyun 	spi->xfer[1].tx_buf = spi->buffer_data;
184*4882a593Smuzhiyun 	spi->xfer[0].len = 3;
185*4882a593Smuzhiyun 	spi->xfer[1].len = 3;
186*4882a593Smuzhiyun 	spi->xfer[0].bits_per_word = 8;
187*4882a593Smuzhiyun 	spi->xfer[1].bits_per_word = 8;
188*4882a593Smuzhiyun 	spi->xfer[0].cs_change = 1;
189*4882a593Smuzhiyun 
190*4882a593Smuzhiyun 	spi_message_init(&spi->message);
191*4882a593Smuzhiyun 	spi_message_add_tail(&spi->xfer[0], &spi->message);
192*4882a593Smuzhiyun 	spi_message_add_tail(&spi->xfer[1], &spi->message);
193*4882a593Smuzhiyun }
194*4882a593Smuzhiyun 
ili9320_probe_spi(struct spi_device * spi,struct ili9320_client * client)195*4882a593Smuzhiyun int ili9320_probe_spi(struct spi_device *spi,
196*4882a593Smuzhiyun 				struct ili9320_client *client)
197*4882a593Smuzhiyun {
198*4882a593Smuzhiyun 	struct ili9320_platdata *cfg = dev_get_platdata(&spi->dev);
199*4882a593Smuzhiyun 	struct device *dev = &spi->dev;
200*4882a593Smuzhiyun 	struct ili9320 *ili;
201*4882a593Smuzhiyun 	struct lcd_device *lcd;
202*4882a593Smuzhiyun 	int ret = 0;
203*4882a593Smuzhiyun 
204*4882a593Smuzhiyun 	/* verify we where given some information */
205*4882a593Smuzhiyun 
206*4882a593Smuzhiyun 	if (cfg == NULL) {
207*4882a593Smuzhiyun 		dev_err(dev, "no platform data supplied\n");
208*4882a593Smuzhiyun 		return -EINVAL;
209*4882a593Smuzhiyun 	}
210*4882a593Smuzhiyun 
211*4882a593Smuzhiyun 	if (cfg->hsize <= 0 || cfg->vsize <= 0 || cfg->reset == NULL) {
212*4882a593Smuzhiyun 		dev_err(dev, "invalid platform data supplied\n");
213*4882a593Smuzhiyun 		return -EINVAL;
214*4882a593Smuzhiyun 	}
215*4882a593Smuzhiyun 
216*4882a593Smuzhiyun 	/* allocate and initialse our state */
217*4882a593Smuzhiyun 
218*4882a593Smuzhiyun 	ili = devm_kzalloc(&spi->dev, sizeof(struct ili9320), GFP_KERNEL);
219*4882a593Smuzhiyun 	if (ili == NULL)
220*4882a593Smuzhiyun 		return -ENOMEM;
221*4882a593Smuzhiyun 
222*4882a593Smuzhiyun 	ili->access.spi.id = ILI9320_SPI_IDCODE | ILI9320_SPI_ID(1);
223*4882a593Smuzhiyun 
224*4882a593Smuzhiyun 	ili->dev = dev;
225*4882a593Smuzhiyun 	ili->client = client;
226*4882a593Smuzhiyun 	ili->power = FB_BLANK_POWERDOWN;
227*4882a593Smuzhiyun 	ili->platdata = cfg;
228*4882a593Smuzhiyun 
229*4882a593Smuzhiyun 	spi_set_drvdata(spi, ili);
230*4882a593Smuzhiyun 
231*4882a593Smuzhiyun 	ili9320_setup_spi(ili, spi);
232*4882a593Smuzhiyun 
233*4882a593Smuzhiyun 	lcd = devm_lcd_device_register(&spi->dev, "ili9320", dev, ili,
234*4882a593Smuzhiyun 					&ili9320_ops);
235*4882a593Smuzhiyun 	if (IS_ERR(lcd)) {
236*4882a593Smuzhiyun 		dev_err(dev, "failed to register lcd device\n");
237*4882a593Smuzhiyun 		return PTR_ERR(lcd);
238*4882a593Smuzhiyun 	}
239*4882a593Smuzhiyun 
240*4882a593Smuzhiyun 	ili->lcd = lcd;
241*4882a593Smuzhiyun 
242*4882a593Smuzhiyun 	dev_info(dev, "initialising %s\n", client->name);
243*4882a593Smuzhiyun 
244*4882a593Smuzhiyun 	ret = ili9320_power(ili, FB_BLANK_UNBLANK);
245*4882a593Smuzhiyun 	if (ret != 0) {
246*4882a593Smuzhiyun 		dev_err(dev, "failed to set lcd power state\n");
247*4882a593Smuzhiyun 		return ret;
248*4882a593Smuzhiyun 	}
249*4882a593Smuzhiyun 
250*4882a593Smuzhiyun 	return 0;
251*4882a593Smuzhiyun }
252*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(ili9320_probe_spi);
253*4882a593Smuzhiyun 
ili9320_remove(struct ili9320 * ili)254*4882a593Smuzhiyun int ili9320_remove(struct ili9320 *ili)
255*4882a593Smuzhiyun {
256*4882a593Smuzhiyun 	ili9320_power(ili, FB_BLANK_POWERDOWN);
257*4882a593Smuzhiyun 	return 0;
258*4882a593Smuzhiyun }
259*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(ili9320_remove);
260*4882a593Smuzhiyun 
261*4882a593Smuzhiyun #ifdef CONFIG_PM_SLEEP
ili9320_suspend(struct ili9320 * lcd)262*4882a593Smuzhiyun int ili9320_suspend(struct ili9320 *lcd)
263*4882a593Smuzhiyun {
264*4882a593Smuzhiyun 	int ret;
265*4882a593Smuzhiyun 
266*4882a593Smuzhiyun 	ret = ili9320_power(lcd, FB_BLANK_POWERDOWN);
267*4882a593Smuzhiyun 
268*4882a593Smuzhiyun 	if (lcd->platdata->suspend == ILI9320_SUSPEND_DEEP) {
269*4882a593Smuzhiyun 		ili9320_write(lcd, ILI9320_POWER1, lcd->power1 |
270*4882a593Smuzhiyun 			      ILI9320_POWER1_SLP |
271*4882a593Smuzhiyun 			      ILI9320_POWER1_DSTB);
272*4882a593Smuzhiyun 		lcd->initialised = 0;
273*4882a593Smuzhiyun 	}
274*4882a593Smuzhiyun 
275*4882a593Smuzhiyun 	return ret;
276*4882a593Smuzhiyun }
277*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(ili9320_suspend);
278*4882a593Smuzhiyun 
ili9320_resume(struct ili9320 * lcd)279*4882a593Smuzhiyun int ili9320_resume(struct ili9320 *lcd)
280*4882a593Smuzhiyun {
281*4882a593Smuzhiyun 	dev_info(lcd->dev, "resuming from power state %d\n", lcd->power);
282*4882a593Smuzhiyun 
283*4882a593Smuzhiyun 	if (lcd->platdata->suspend == ILI9320_SUSPEND_DEEP)
284*4882a593Smuzhiyun 		ili9320_write(lcd, ILI9320_POWER1, 0x00);
285*4882a593Smuzhiyun 
286*4882a593Smuzhiyun 	return ili9320_power(lcd, FB_BLANK_UNBLANK);
287*4882a593Smuzhiyun }
288*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(ili9320_resume);
289*4882a593Smuzhiyun #endif
290*4882a593Smuzhiyun 
291*4882a593Smuzhiyun /* Power down all displays on reboot, poweroff or halt */
ili9320_shutdown(struct ili9320 * lcd)292*4882a593Smuzhiyun void ili9320_shutdown(struct ili9320 *lcd)
293*4882a593Smuzhiyun {
294*4882a593Smuzhiyun 	ili9320_power(lcd, FB_BLANK_POWERDOWN);
295*4882a593Smuzhiyun }
296*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(ili9320_shutdown);
297*4882a593Smuzhiyun 
298*4882a593Smuzhiyun MODULE_AUTHOR("Ben Dooks <ben-linux@fluff.org>");
299*4882a593Smuzhiyun MODULE_DESCRIPTION("ILI9320 LCD Driver");
300*4882a593Smuzhiyun MODULE_LICENSE("GPL v2");
301