On Tue, Feb 2, 2010 at 6:09 AM, Andrew Morton [off-list ref] wrote:

On Mon,  1 Feb 2010 18:35:08 +0800
Jaya Kumar [off-list ref] wrote:

quoted

This patch adds the ability to store waveforms to broadsheetfb. It uses the
firmware class to retrieve the waveform. The request to store the waveform
is triggered from a driver sysfs entry called loadstore_waveform. I
considered adding this to Documentation/ABI/testing/ but then decided against
it. It is not something I would expect a user to ever interact with. It
would be only useful for people doing platform bringup and other such dirty
activities. Also, I noticed it is not (yet?) common practice to document
sysfs entries for fbdev drivers in there. Please let me know your feedback.

Thanks,
jaya

This patch adds waveform storing capability to broadsheetfb. It uses the
firmware class to retrieve the waveform, and the request to initiate the
waveform storing is done via a driver sysfs entry, loadstore_waveform.

Please educate me: broadsheet is a framebuffer device, is it not?  What
does it mean to record a waveform into a framebuffer device?  In what
way will a user observe the waveform?  Is it audio?  From the patch it
appears that this mysterious device has flash memory too?

Mystified!

Hi Andrew,

You are right, broadsheet is a framebuffer device. It is slightly
different than a typical framebuffer controller that drives a normal
TFT-LCD display. Most E-Ink display panels require a waveform in order
to function. That is, in order to drive the state of a pixel to black,
gray, or white, a specific waveform is utilized. Basically, that
waveform represents the specific E-field wiggling needed to get the
pixel to its optimal state given current temperature, and its previous
state. TN/IPS-LCDs use a similar concept but the driving waveform is
sufficiently simple that it is internalized in the TFT source/gate
driver.

These E-Ink waveforms are specific to a production batch. That is, a
batch of display films are produced, then they get characterized and a
waveform is generated for that batch. Broadsheet, typically, is
attached to its private SPI flash which is then flashed with this
waveform.

Users won't be able to see the waveform and typically won't ever need
to know about it. If however, the display panel attached to broadsheet
is changed out, then they will need to update their waveform. That
would typically be done at a factory or repair facility rather than by
a user.

Thanks,
jaya