xref: /openbmc/qemu/hw/display/pl110.c (revision dccbaf0cc0f1744ffd7562a3dc60e4fc99fd9d44)
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