2 * am200epd.c -- Platform device for AM200 EPD kit
4 * Copyright (C) 2008, Jaya Kumar
6 * This file is subject to the terms and conditions of the GNU General Public
7 * License. See the file COPYING in the main directory of this archive for
10 * Layout is based on skeletonfb.c by James Simmons and Geert Uytterhoeven.
12 * This work was made possible by help and equipment support from E-Ink
13 * Corporation. http://support.eink.com/community
15 * This driver is written to be used with the Metronome display controller.
16 * on the AM200 EPD prototype kit/development kit with an E-Ink 800x600
17 * Vizplex EPD on a Gumstix board using the Lyre interface board.
21 #include <linux/module.h>
22 #include <linux/kernel.h>
23 #include <linux/errno.h>
24 #include <linux/string.h>
25 #include <linux/delay.h>
26 #include <linux/interrupt.h>
28 #include <linux/init.h>
29 #include <linux/platform_device.h>
30 #include <linux/irq.h>
31 #include <linux/gpio.h>
33 #include <mach/pxa25x.h>
34 #include <mach/gumstix.h>
35 #include <mach/pxafb.h>
39 #include <video/metronomefb.h>
41 static unsigned int panel_type
= 6;
42 static struct platform_device
*am200_device
;
43 static struct metronome_board am200_board
;
45 static struct pxafb_mode_info am200_fb_mode_9inch7
= {
56 .sync
= FB_SYNC_HOR_HIGH_ACT
| FB_SYNC_VERT_HIGH_ACT
,
59 static struct pxafb_mode_info am200_fb_mode_8inch
= {
70 .sync
= FB_SYNC_HOR_HIGH_ACT
| FB_SYNC_VERT_HIGH_ACT
,
73 static struct pxafb_mode_info am200_fb_mode_6inch
= {
84 .sync
= FB_SYNC_HOR_HIGH_ACT
| FB_SYNC_VERT_HIGH_ACT
,
87 static struct pxafb_mach_info am200_fb_info
= {
88 .modes
= &am200_fb_mode_6inch
,
90 .lcd_conn
= LCD_TYPE_COLOR_TFT
| LCD_PCLK_EDGE_FALL
|
94 /* register offsets for gpio control */
95 #define LED_GPIO_PIN 51
96 #define STDBY_GPIO_PIN 48
97 #define RST_GPIO_PIN 49
98 #define RDY_GPIO_PIN 32
99 #define ERR_GPIO_PIN 17
100 #define PCBPWR_GPIO_PIN 16
101 static int gpios
[] = { LED_GPIO_PIN
, STDBY_GPIO_PIN
, RST_GPIO_PIN
,
102 RDY_GPIO_PIN
, ERR_GPIO_PIN
, PCBPWR_GPIO_PIN
};
103 static char *gpio_names
[] = { "LED" , "STDBY" , "RST", "RDY", "ERR", "PCBPWR" };
105 static int am200_init_gpio_regs(struct metronomefb_par
*par
)
110 for (i
= 0; i
< ARRAY_SIZE(gpios
); i
++) {
111 err
= gpio_request(gpios
[i
], gpio_names
[i
]);
113 dev_err(&am200_device
->dev
, "failed requesting "
114 "gpio %s, err=%d\n", gpio_names
[i
], err
);
119 gpio_direction_output(LED_GPIO_PIN
, 0);
120 gpio_direction_output(STDBY_GPIO_PIN
, 0);
121 gpio_direction_output(RST_GPIO_PIN
, 0);
123 gpio_direction_input(RDY_GPIO_PIN
);
124 gpio_direction_input(ERR_GPIO_PIN
);
126 gpio_direction_output(PCBPWR_GPIO_PIN
, 0);
137 static void am200_cleanup(struct metronomefb_par
*par
)
141 free_irq(PXA_GPIO_TO_IRQ(RDY_GPIO_PIN
), par
);
143 for (i
= 0; i
< ARRAY_SIZE(gpios
); i
++)
147 static int am200_share_video_mem(struct fb_info
*info
)
149 /* rough check if this is our desired fb and not something else */
150 if ((info
->var
.xres
!= am200_fb_info
.modes
->xres
)
151 || (info
->var
.yres
!= am200_fb_info
.modes
->yres
))
154 /* we've now been notified that we have our new fb */
155 am200_board
.metromem
= info
->screen_base
;
156 am200_board
.host_fbinfo
= info
;
158 /* try to refcount host drv since we are the consumer after this */
159 if (!try_module_get(info
->fbops
->owner
))
165 static int am200_unshare_video_mem(struct fb_info
*info
)
167 dev_dbg(&am200_device
->dev
, "ENTER %s\n", __func__
);
169 if (info
!= am200_board
.host_fbinfo
)
172 module_put(am200_board
.host_fbinfo
->fbops
->owner
);
176 static int am200_fb_notifier_callback(struct notifier_block
*self
,
177 unsigned long event
, void *data
)
179 struct fb_event
*evdata
= data
;
180 struct fb_info
*info
= evdata
->info
;
182 dev_dbg(&am200_device
->dev
, "ENTER %s\n", __func__
);
184 if (event
== FB_EVENT_FB_REGISTERED
)
185 return am200_share_video_mem(info
);
186 else if (event
== FB_EVENT_FB_UNREGISTERED
)
187 return am200_unshare_video_mem(info
);
192 static struct notifier_block am200_fb_notif
= {
193 .notifier_call
= am200_fb_notifier_callback
,
196 /* this gets called as part of our init. these steps must be done now so
197 * that we can use pxa_set_fb_info */
198 static void __init
am200_presetup_fb(void)
205 switch (panel_type
) {
207 am200_fb_info
.modes
= &am200_fb_mode_6inch
;
210 am200_fb_info
.modes
= &am200_fb_mode_8inch
;
213 am200_fb_info
.modes
= &am200_fb_mode_9inch7
;
216 dev_err(&am200_device
->dev
, "invalid panel_type selection,"
218 am200_fb_info
.modes
= &am200_fb_mode_6inch
;
222 /* the frame buffer is divided as follows:
223 command | CRC | padding
224 16kb waveform data | CRC | padding
228 fw
= am200_fb_info
.modes
->xres
;
229 fh
= am200_fb_info
.modes
->yres
;
231 /* waveform must be 16k + 2 for checksum */
232 am200_board
.wfm_size
= roundup(16*1024 + 2, fw
);
234 padding_size
= PAGE_SIZE
+ (4 * fw
);
236 /* total is 1 cmd , 1 wfm, padding and image */
237 totalsize
= fw
+ am200_board
.wfm_size
+ padding_size
+ (fw
*fh
);
239 /* save this off because we're manipulating fw after this and
240 * we'll need it when we're ready to setup the framebuffer */
244 /* the reason we do this adjustment is because we want to acquire
245 * more framebuffer memory without imposing custom awareness on the
246 * underlying pxafb driver */
247 am200_fb_info
.modes
->yres
= DIV_ROUND_UP(totalsize
, fw
);
249 /* we divide since we told the LCD controller we're 16bpp */
250 am200_fb_info
.modes
->xres
/= 2;
252 pxa_set_fb_info(NULL
, &am200_fb_info
);
256 /* this gets called by metronomefb as part of its init, in our case, we
257 * have already completed initial framebuffer init in presetup_fb so we
258 * can just setup the fb access pointers */
259 static int am200_setup_fb(struct metronomefb_par
*par
)
267 /* metromem was set up by the notifier in share_video_mem so now
268 * we can use its value to calculate the other entries */
269 par
->metromem_cmd
= (struct metromem_cmd
*) am200_board
.metromem
;
270 par
->metromem_wfm
= am200_board
.metromem
+ fw
;
271 par
->metromem_img
= par
->metromem_wfm
+ am200_board
.wfm_size
;
272 par
->metromem_img_csum
= (u16
*) (par
->metromem_img
+ (fw
* fh
));
273 par
->metromem_dma
= am200_board
.host_fbinfo
->fix
.smem_start
;
278 static int am200_get_panel_type(void)
283 static irqreturn_t
am200_handle_irq(int irq
, void *dev_id
)
285 struct metronomefb_par
*par
= dev_id
;
287 wake_up_interruptible(&par
->waitq
);
291 static int am200_setup_irq(struct fb_info
*info
)
295 ret
= request_irq(PXA_GPIO_TO_IRQ(RDY_GPIO_PIN
), am200_handle_irq
,
296 IRQF_DISABLED
|IRQF_TRIGGER_FALLING
,
299 dev_err(&am200_device
->dev
, "request_irq failed: %d\n", ret
);
304 static void am200_set_rst(struct metronomefb_par
*par
, int state
)
306 gpio_set_value(RST_GPIO_PIN
, state
);
309 static void am200_set_stdby(struct metronomefb_par
*par
, int state
)
311 gpio_set_value(STDBY_GPIO_PIN
, state
);
314 static int am200_wait_event(struct metronomefb_par
*par
)
316 return wait_event_timeout(par
->waitq
, gpio_get_value(RDY_GPIO_PIN
), HZ
);
319 static int am200_wait_event_intr(struct metronomefb_par
*par
)
321 return wait_event_interruptible_timeout(par
->waitq
,
322 gpio_get_value(RDY_GPIO_PIN
), HZ
);
325 static struct metronome_board am200_board
= {
326 .owner
= THIS_MODULE
,
327 .setup_irq
= am200_setup_irq
,
328 .setup_io
= am200_init_gpio_regs
,
329 .setup_fb
= am200_setup_fb
,
330 .set_rst
= am200_set_rst
,
331 .set_stdby
= am200_set_stdby
,
332 .met_wait_event
= am200_wait_event
,
333 .met_wait_event_intr
= am200_wait_event_intr
,
334 .get_panel_type
= am200_get_panel_type
,
335 .cleanup
= am200_cleanup
,
338 static unsigned long am200_pin_config
[] __initdata
= {
347 int __init
am200_init(void)
351 /* before anything else, we request notification for any fb
353 fb_register_client(&am200_fb_notif
);
355 pxa2xx_mfp_config(ARRAY_AND_SIZE(am200_pin_config
));
357 /* request our platform independent driver */
358 request_module("metronomefb");
360 am200_device
= platform_device_alloc("metronomefb", -1);
364 /* the am200_board that will be seen by metronomefb is a copy */
365 platform_device_add_data(am200_device
, &am200_board
,
366 sizeof(am200_board
));
368 /* this _add binds metronomefb to am200. metronomefb refcounts am200 */
369 ret
= platform_device_add(am200_device
);
372 platform_device_put(am200_device
);
373 fb_unregister_client(&am200_fb_notif
);
382 module_param(panel_type
, uint
, 0);
383 MODULE_PARM_DESC(panel_type
, "Select the panel type: 6, 8, 97");
385 MODULE_DESCRIPTION("board driver for am200 metronome epd kit");
386 MODULE_AUTHOR("Jaya Kumar");
387 MODULE_LICENSE("GPL");