metronomefb.txt 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. Metronomefb
  2. -----------
  3. Maintained by Jaya Kumar <jayakumar.lkml.gmail.com>
  4. Last revised: Nov 20, 2007
  5. Metronomefb is a driver for the Metronome display controller. The controller
  6. is from E-Ink Corporation. It is intended to be used to drive the E-Ink
  7. Vizplex display media. E-Ink hosts some details of this controller and the
  8. display media here http://www.e-ink.com/products/matrix/metronome.html .
  9. Metronome is interfaced to the host CPU through the AMLCD interface. The
  10. host CPU generates the control information and the image in a framebuffer
  11. which is then delivered to the AMLCD interface by a host specific method.
  12. Currently, that's implemented for the PXA's LCDC controller. The display and
  13. error status are each pulled through individual GPIOs.
  14. Metronomefb was written for the PXA255/gumstix/lyre combination and
  15. therefore currently has board set specific code in it. If other boards based on
  16. other architectures are available, then the host specific code can be separated
  17. and abstracted out.
  18. Metronomefb requires waveform information which is delivered via the AMLCD
  19. interface to the metronome controller. The waveform information is expected to
  20. be delivered from userspace via the firmware class interface. The waveform file
  21. can be compressed as long as your udev or hotplug script is aware of the need
  22. to uncompress it before delivering it. metronomefb will ask for waveform.wbf
  23. which would typically go into /lib/firmware/waveform.wbf depending on your
  24. udev/hotplug setup. I have only tested with a single waveform file which was
  25. originally labeled 23P01201_60_WT0107_MTC. I do not know what it stands for.
  26. Caution should be exercised when manipulating the waveform as there may be
  27. a possibility that it could have some permanent effects on the display media.
  28. I neither have access to nor know exactly what the waveform does in terms of
  29. the physical media.
  30. Metronomefb uses the deferred IO interface so that it can provide a memory
  31. mappable frame buffer. It has been tested with tinyx (Xfbdev). It is known
  32. to work at this time with xeyes, xclock, xloadimage, xpdf.