1 /*
2 * Arm PrimeCell PL110 Color LCD Controller
3 *
4 * Copyright (c) 2005-2009 CodeSourcery.
5 * Written by Paul Brook
6 *
7 * This code is licensed under the GNU LGPL
8 */
9
10 #include "qemu/osdep.h"
11 #include "hw/irq.h"
12 #include "hw/sysbus.h"
13 #include "hw/qdev-properties.h"
14 #include "migration/vmstate.h"
15 #include "ui/console.h"
16 #include "framebuffer.h"
17 #include "ui/pixel_ops.h"
18 #include "qemu/timer.h"
19 #include "qemu/log.h"
20 #include "qemu/module.h"
21 #include "qapi/error.h"
22 #include "qom/object.h"
23
24 #define PL110_CR_EN 0x001
25 #define PL110_CR_BGR 0x100
26 #define PL110_CR_BEBO 0x200
27 #define PL110_CR_BEPO 0x400
28 #define PL110_CR_PWR 0x800
29 #define PL110_IE_NB 0x004
30 #define PL110_IE_VC 0x008
31
32 enum pl110_bppmode
33 {
34 BPP_1,
35 BPP_2,
36 BPP_4,
37 BPP_8,
38 BPP_16,
39 BPP_32,
40 BPP_16_565, /* PL111 only */
41 BPP_12 /* PL111 only */
42 };
43
44
45 /* The Versatile/PB uses a slightly modified PL110 controller. */
46 enum pl110_version
47 {
48 VERSION_PL110,
49 VERSION_PL110_VERSATILE,
50 VERSION_PL111
51 };
52
53 #define TYPE_PL110 "pl110"
54 OBJECT_DECLARE_SIMPLE_TYPE(PL110State, PL110)
55
56 struct PL110State {
57 SysBusDevice parent_obj;
58
59 MemoryRegion iomem;
60 MemoryRegionSection fbsection;
61 QemuConsole *con;
62 QEMUTimer *vblank_timer;
63
64 int version;
65 uint32_t timing[4];
66 uint32_t cr;
67 uint32_t upbase;
68 uint32_t lpbase;
69 uint32_t int_status;
70 uint32_t int_mask;
71 int cols;
72 int rows;
73 enum pl110_bppmode bpp;
74 int invalidate;
75 uint32_t mux_ctrl;
76 uint32_t palette[256];
77 uint32_t raw_palette[128];
78 qemu_irq irq;
79 MemoryRegion *fbmem;
80 };
81
82 static int vmstate_pl110_post_load(void *opaque, int version_id);
83
84 static const VMStateDescription vmstate_pl110 = {
85 .name = "pl110",
86 .version_id = 2,
87 .minimum_version_id = 1,
88 .post_load = vmstate_pl110_post_load,
89 .fields = (const VMStateField[]) {
90 VMSTATE_INT32(version, PL110State),
91 VMSTATE_UINT32_ARRAY(timing, PL110State, 4),
92 VMSTATE_UINT32(cr, PL110State),
93 VMSTATE_UINT32(upbase, PL110State),
94 VMSTATE_UINT32(lpbase, PL110State),
95 VMSTATE_UINT32(int_status, PL110State),
96 VMSTATE_UINT32(int_mask, PL110State),
97 VMSTATE_INT32(cols, PL110State),
98 VMSTATE_INT32(rows, PL110State),
99 VMSTATE_UINT32(bpp, PL110State),
100 VMSTATE_INT32(invalidate, PL110State),
101 VMSTATE_UINT32_ARRAY(palette, PL110State, 256),
102 VMSTATE_UINT32_ARRAY(raw_palette, PL110State, 128),
103 VMSTATE_UINT32_V(mux_ctrl, PL110State, 2),
104 VMSTATE_END_OF_LIST()
105 }
106 };
107
108 static const unsigned char pl110_id[] =
109 { 0x10, 0x11, 0x04, 0x00, 0x0d, 0xf0, 0x05, 0xb1 };
110
111 static const unsigned char pl111_id[] = {
112 0x11, 0x11, 0x24, 0x00, 0x0d, 0xf0, 0x05, 0xb1
113 };
114
115
116 /* Indexed by pl110_version */
117 static const unsigned char *idregs[] = {
118 pl110_id,
119 /* The ARM documentation (DDI0224C) says the CLCDC on the Versatile board
120 * has a different ID (0x93, 0x10, 0x04, 0x00, ...). However the hardware
121 * itself has the same ID values as a stock PL110, and guests (in
122 * particular Linux) rely on this. We emulate what the hardware does,
123 * rather than what the docs claim it ought to do.
124 */
125 pl110_id,
126 pl111_id
127 };
128
129 #define COPY_PIXEL(to, from) do { *(uint32_t *)to = from; to += 4; } while (0)
130
131 #undef RGB
132 #define BORDER bgr
133 #define ORDER 0
134 #include "pl110_template.h"
135 #define ORDER 1
136 #include "pl110_template.h"
137 #define ORDER 2
138 #include "pl110_template.h"
139 #undef BORDER
140 #define RGB
141 #define BORDER rgb
142 #define ORDER 0
143 #include "pl110_template.h"
144 #define ORDER 1
145 #include "pl110_template.h"
146 #define ORDER 2
147 #include "pl110_template.h"
148 #undef BORDER
149
150 #undef COPY_PIXEL
151
152 static drawfn pl110_draw_fn_32[48] = {
153 pl110_draw_line1_lblp_bgr,
154 pl110_draw_line2_lblp_bgr,
155 pl110_draw_line4_lblp_bgr,
156 pl110_draw_line8_lblp_bgr,
157 pl110_draw_line16_555_lblp_bgr,
158 pl110_draw_line32_lblp_bgr,
159 pl110_draw_line16_lblp_bgr,
160 pl110_draw_line12_lblp_bgr,
161
162 pl110_draw_line1_bbbp_bgr,
163 pl110_draw_line2_bbbp_bgr,
164 pl110_draw_line4_bbbp_bgr,
165 pl110_draw_line8_bbbp_bgr,
166 pl110_draw_line16_555_bbbp_bgr,
167 pl110_draw_line32_bbbp_bgr,
168 pl110_draw_line16_bbbp_bgr,
169 pl110_draw_line12_bbbp_bgr,
170
171 pl110_draw_line1_lbbp_bgr,
172 pl110_draw_line2_lbbp_bgr,
173 pl110_draw_line4_lbbp_bgr,
174 pl110_draw_line8_lbbp_bgr,
175 pl110_draw_line16_555_lbbp_bgr,
176 pl110_draw_line32_lbbp_bgr,
177 pl110_draw_line16_lbbp_bgr,
178 pl110_draw_line12_lbbp_bgr,
179
180 pl110_draw_line1_lblp_rgb,
181 pl110_draw_line2_lblp_rgb,
182 pl110_draw_line4_lblp_rgb,
183 pl110_draw_line8_lblp_rgb,
184 pl110_draw_line16_555_lblp_rgb,
185 pl110_draw_line32_lblp_rgb,
186 pl110_draw_line16_lblp_rgb,
187 pl110_draw_line12_lblp_rgb,
188
189 pl110_draw_line1_bbbp_rgb,
190 pl110_draw_line2_bbbp_rgb,
191 pl110_draw_line4_bbbp_rgb,
192 pl110_draw_line8_bbbp_rgb,
193 pl110_draw_line16_555_bbbp_rgb,
194 pl110_draw_line32_bbbp_rgb,
195 pl110_draw_line16_bbbp_rgb,
196 pl110_draw_line12_bbbp_rgb,
197
198 pl110_draw_line1_lbbp_rgb,
199 pl110_draw_line2_lbbp_rgb,
200 pl110_draw_line4_lbbp_rgb,
201 pl110_draw_line8_lbbp_rgb,
202 pl110_draw_line16_555_lbbp_rgb,
203 pl110_draw_line32_lbbp_rgb,
204 pl110_draw_line16_lbbp_rgb,
205 pl110_draw_line12_lbbp_rgb,
206 };
207
pl110_enabled(PL110State * s)208 static int pl110_enabled(PL110State *s)
209 {
210 return (s->cr & PL110_CR_EN) && (s->cr & PL110_CR_PWR);
211 }
212
pl110_update_display(void * opaque)213 static void pl110_update_display(void *opaque)
214 {
215 PL110State *s = (PL110State *)opaque;
216 DisplaySurface *surface = qemu_console_surface(s->con);
217 drawfn fn;
218 int src_width;
219 int bpp_offset;
220 int first;
221 int last;
222
223 if (!pl110_enabled(s)) {
224 return;
225 }
226
227 if (s->cr & PL110_CR_BGR)
228 bpp_offset = 0;
229 else
230 bpp_offset = 24;
231
232 if ((s->version != VERSION_PL111) && (s->bpp == BPP_16)) {
233 /* The PL110's native 16 bit mode is 5551; however
234 * most boards with a PL110 implement an external
235 * mux which allows bits to be reshuffled to give
236 * 565 format. The mux is typically controlled by
237 * an external system register.
238 * This is controlled by a GPIO input pin
239 * so boards can wire it up to their register.
240 *
241 * The PL111 straightforwardly implements both
242 * 5551 and 565 under control of the bpp field
243 * in the LCDControl register.
244 */
245 switch (s->mux_ctrl) {
246 case 3: /* 565 BGR */
247 bpp_offset = (BPP_16_565 - BPP_16);
248 break;
249 case 1: /* 5551 */
250 break;
251 case 0: /* 888; also if we have loaded vmstate from an old version */
252 case 2: /* 565 RGB */
253 default:
254 /* treat as 565 but honour BGR bit */
255 bpp_offset += (BPP_16_565 - BPP_16);
256 break;
257 }
258 }
259
260 if (s->cr & PL110_CR_BEBO) {
261 fn = pl110_draw_fn_32[s->bpp + 8 + bpp_offset];
262 } else if (s->cr & PL110_CR_BEPO) {
263 fn = pl110_draw_fn_32[s->bpp + 16 + bpp_offset];
264 } else {
265 fn = pl110_draw_fn_32[s->bpp + bpp_offset];
266 }
267
268 src_width = s->cols;
269 switch (s->bpp) {
270 case BPP_1:
271 src_width >>= 3;
272 break;
273 case BPP_2:
274 src_width >>= 2;
275 break;
276 case BPP_4:
277 src_width >>= 1;
278 break;
279 case BPP_8:
280 break;
281 case BPP_16:
282 case BPP_16_565:
283 case BPP_12:
284 src_width <<= 1;
285 break;
286 case BPP_32:
287 src_width <<= 2;
288 break;
289 }
290 first = 0;
291 if (s->invalidate) {
292 framebuffer_update_memory_section(&s->fbsection,
293 s->fbmem,
294 s->upbase,
295 s->rows, src_width);
296 }
297
298 framebuffer_update_display(surface, &s->fbsection,
299 s->cols, s->rows,
300 src_width, s->cols * 4, 0,
301 s->invalidate,
302 fn, s->palette,
303 &first, &last);
304
305 if (first >= 0) {
306 dpy_gfx_update(s->con, 0, first, s->cols, last - first + 1);
307 }
308 s->invalidate = 0;
309 }
310
pl110_invalidate_display(void * opaque)311 static void pl110_invalidate_display(void * opaque)
312 {
313 PL110State *s = (PL110State *)opaque;
314 s->invalidate = 1;
315 if (pl110_enabled(s)) {
316 qemu_console_resize(s->con, s->cols, s->rows);
317 }
318 }
319
pl110_update_palette(PL110State * s,int n)320 static void pl110_update_palette(PL110State *s, int n)
321 {
322 DisplaySurface *surface = qemu_console_surface(s->con);
323 int i;
324 uint32_t raw;
325 unsigned int r, g, b;
326
327 raw = s->raw_palette[n];
328 n <<= 1;
329 for (i = 0; i < 2; i++) {
330 r = (raw & 0x1f) << 3;
331 raw >>= 5;
332 g = (raw & 0x1f) << 3;
333 raw >>= 5;
334 b = (raw & 0x1f) << 3;
335 /* The I bit is ignored. */
336 raw >>= 6;
337 switch (surface_bits_per_pixel(surface)) {
338 case 8:
339 s->palette[n] = rgb_to_pixel8(r, g, b);
340 break;
341 case 15:
342 s->palette[n] = rgb_to_pixel15(r, g, b);
343 break;
344 case 16:
345 s->palette[n] = rgb_to_pixel16(r, g, b);
346 break;
347 case 24:
348 case 32:
349 s->palette[n] = rgb_to_pixel32(r, g, b);
350 break;
351 }
352 n++;
353 }
354 }
355
pl110_resize(PL110State * s,int width,int height)356 static void pl110_resize(PL110State *s, int width, int height)
357 {
358 if (width != s->cols || height != s->rows) {
359 if (pl110_enabled(s)) {
360 qemu_console_resize(s->con, width, height);
361 }
362 }
363 s->cols = width;
364 s->rows = height;
365 }
366
367 /* Update interrupts. */
pl110_update(PL110State * s)368 static void pl110_update(PL110State *s)
369 {
370 /* Raise IRQ if enabled and any status bit is 1 */
371 if (s->int_status & s->int_mask) {
372 qemu_irq_raise(s->irq);
373 } else {
374 qemu_irq_lower(s->irq);
375 }
376 }
377
pl110_vblank_interrupt(void * opaque)378 static void pl110_vblank_interrupt(void *opaque)
379 {
380 PL110State *s = opaque;
381
382 /* Fire the vertical compare and next base IRQs and re-arm */
383 s->int_status |= (PL110_IE_NB | PL110_IE_VC);
384 timer_mod(s->vblank_timer,
385 qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL) +
386 NANOSECONDS_PER_SECOND / 60);
387 pl110_update(s);
388 }
389
pl110_read(void * opaque,hwaddr offset,unsigned size)390 static uint64_t pl110_read(void *opaque, hwaddr offset,
391 unsigned size)
392 {
393 PL110State *s = (PL110State *)opaque;
394
395 if (offset >= 0xfe0 && offset < 0x1000) {
396 return idregs[s->version][(offset - 0xfe0) >> 2];
397 }
398 if (offset >= 0x200 && offset < 0x400) {
399 return s->raw_palette[(offset - 0x200) >> 2];
400 }
401 switch (offset >> 2) {
402 case 0: /* LCDTiming0 */
403 return s->timing[0];
404 case 1: /* LCDTiming1 */
405 return s->timing[1];
406 case 2: /* LCDTiming2 */
407 return s->timing[2];
408 case 3: /* LCDTiming3 */
409 return s->timing[3];
410 case 4: /* LCDUPBASE */
411 return s->upbase;
412 case 5: /* LCDLPBASE */
413 return s->lpbase;
414 case 6: /* LCDIMSC */
415 if (s->version != VERSION_PL110) {
416 return s->cr;
417 }
418 return s->int_mask;
419 case 7: /* LCDControl */
420 if (s->version != VERSION_PL110) {
421 return s->int_mask;
422 }
423 return s->cr;
424 case 8: /* LCDRIS */
425 return s->int_status;
426 case 9: /* LCDMIS */
427 return s->int_status & s->int_mask;
428 case 11: /* LCDUPCURR */
429 /* TODO: Implement vertical refresh. */
430 return s->upbase;
431 case 12: /* LCDLPCURR */
432 return s->lpbase;
433 default:
434 qemu_log_mask(LOG_GUEST_ERROR,
435 "pl110_read: Bad offset %x\n", (int)offset);
436 return 0;
437 }
438 }
439
pl110_write(void * opaque,hwaddr offset,uint64_t val,unsigned size)440 static void pl110_write(void *opaque, hwaddr offset,
441 uint64_t val, unsigned size)
442 {
443 PL110State *s = (PL110State *)opaque;
444 int n;
445
446 /* For simplicity invalidate the display whenever a control register
447 is written to. */
448 s->invalidate = 1;
449 if (offset >= 0x200 && offset < 0x400) {
450 /* Palette. */
451 n = (offset - 0x200) >> 2;
452 s->raw_palette[(offset - 0x200) >> 2] = val;
453 pl110_update_palette(s, n);
454 return;
455 }
456 switch (offset >> 2) {
457 case 0: /* LCDTiming0 */
458 s->timing[0] = val;
459 n = ((val & 0xfc) + 4) * 4;
460 pl110_resize(s, n, s->rows);
461 break;
462 case 1: /* LCDTiming1 */
463 s->timing[1] = val;
464 n = (val & 0x3ff) + 1;
465 pl110_resize(s, s->cols, n);
466 break;
467 case 2: /* LCDTiming2 */
468 s->timing[2] = val;
469 break;
470 case 3: /* LCDTiming3 */
471 s->timing[3] = val;
472 break;
473 case 4: /* LCDUPBASE */
474 s->upbase = val;
475 break;
476 case 5: /* LCDLPBASE */
477 s->lpbase = val;
478 break;
479 case 6: /* LCDIMSC */
480 if (s->version != VERSION_PL110) {
481 goto control;
482 }
483 imsc:
484 s->int_mask = val;
485 pl110_update(s);
486 break;
487 case 7: /* LCDControl */
488 if (s->version != VERSION_PL110) {
489 goto imsc;
490 }
491 control:
492 s->cr = val;
493 s->bpp = (val >> 1) & 7;
494 if (pl110_enabled(s)) {
495 qemu_console_resize(s->con, s->cols, s->rows);
496 timer_mod(s->vblank_timer,
497 qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL) +
498 NANOSECONDS_PER_SECOND / 60);
499 } else {
500 timer_del(s->vblank_timer);
501 }
502 break;
503 case 10: /* LCDICR */
504 s->int_status &= ~val;
505 pl110_update(s);
506 break;
507 default:
508 qemu_log_mask(LOG_GUEST_ERROR,
509 "pl110_write: Bad offset %x\n", (int)offset);
510 }
511 }
512
513 static const MemoryRegionOps pl110_ops = {
514 .read = pl110_read,
515 .write = pl110_write,
516 .endianness = DEVICE_NATIVE_ENDIAN,
517 };
518
pl110_mux_ctrl_set(void * opaque,int line,int level)519 static void pl110_mux_ctrl_set(void *opaque, int line, int level)
520 {
521 PL110State *s = (PL110State *)opaque;
522 s->mux_ctrl = level;
523 }
524
vmstate_pl110_post_load(void * opaque,int version_id)525 static int vmstate_pl110_post_load(void *opaque, int version_id)
526 {
527 PL110State *s = opaque;
528 /* Make sure we redraw, and at the right size */
529 pl110_invalidate_display(s);
530 return 0;
531 }
532
533 static const GraphicHwOps pl110_gfx_ops = {
534 .invalidate = pl110_invalidate_display,
535 .gfx_update = pl110_update_display,
536 };
537
538 static Property pl110_properties[] = {
539 DEFINE_PROP_LINK("framebuffer-memory", PL110State, fbmem,
540 TYPE_MEMORY_REGION, MemoryRegion *),
541 DEFINE_PROP_END_OF_LIST(),
542 };
543
pl110_realize(DeviceState * dev,Error ** errp)544 static void pl110_realize(DeviceState *dev, Error **errp)
545 {
546 PL110State *s = PL110(dev);
547 SysBusDevice *sbd = SYS_BUS_DEVICE(dev);
548
549 if (!s->fbmem) {
550 error_setg(errp, "'framebuffer-memory' property was not set");
551 return;
552 }
553
554 memory_region_init_io(&s->iomem, OBJECT(s), &pl110_ops, s, "pl110", 0x1000);
555 sysbus_init_mmio(sbd, &s->iomem);
556 sysbus_init_irq(sbd, &s->irq);
557 s->vblank_timer = timer_new_ns(QEMU_CLOCK_VIRTUAL,
558 pl110_vblank_interrupt, s);
559 qdev_init_gpio_in(dev, pl110_mux_ctrl_set, 1);
560 s->con = graphic_console_init(dev, 0, &pl110_gfx_ops, s);
561 }
562
pl110_init(Object * obj)563 static void pl110_init(Object *obj)
564 {
565 PL110State *s = PL110(obj);
566
567 s->version = VERSION_PL110;
568 }
569
pl110_versatile_init(Object * obj)570 static void pl110_versatile_init(Object *obj)
571 {
572 PL110State *s = PL110(obj);
573
574 s->version = VERSION_PL110_VERSATILE;
575 }
576
pl111_init(Object * obj)577 static void pl111_init(Object *obj)
578 {
579 PL110State *s = PL110(obj);
580
581 s->version = VERSION_PL111;
582 }
583
pl110_class_init(ObjectClass * klass,void * data)584 static void pl110_class_init(ObjectClass *klass, void *data)
585 {
586 DeviceClass *dc = DEVICE_CLASS(klass);
587
588 set_bit(DEVICE_CATEGORY_DISPLAY, dc->categories);
589 dc->vmsd = &vmstate_pl110;
590 dc->realize = pl110_realize;
591 device_class_set_props(dc, pl110_properties);
592 }
593
594 static const TypeInfo pl110_info = {
595 .name = TYPE_PL110,
596 .parent = TYPE_SYS_BUS_DEVICE,
597 .instance_size = sizeof(PL110State),
598 .instance_init = pl110_init,
599 .class_init = pl110_class_init,
600 };
601
602 static const TypeInfo pl110_versatile_info = {
603 .name = "pl110_versatile",
604 .parent = TYPE_PL110,
605 .instance_init = pl110_versatile_init,
606 };
607
608 static const TypeInfo pl111_info = {
609 .name = "pl111",
610 .parent = TYPE_PL110,
611 .instance_init = pl111_init,
612 };
613
pl110_register_types(void)614 static void pl110_register_types(void)
615 {
616 type_register_static(&pl110_info);
617 type_register_static(&pl110_versatile_info);
618 type_register_static(&pl111_info);
619 }
620
621 type_init(pl110_register_types)
622