From 2181410904ddac38ec6955090dc70ca583ae4d62 Mon Sep 17 00:00:00 2001 From: Nicolas Mailloux Date: Thu, 22 Jun 2023 12:47:54 -0400 Subject: [PATCH] LEGAL.md: Add eInk waveforms warning --- LEGAL.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/LEGAL.md b/LEGAL.md index 3865dfe..f468f8c 100644 --- a/LEGAL.md +++ b/LEGAL.md @@ -7,4 +7,8 @@ This is the official document concerning legal information about InkBox OS. It h - 'The Software' represents both of the things above. ## Statement -The Software is provided to you WITHOUT ANY WARRANTY, and no one but you is responsible if you ever brick your device for any reason whatsoever. +The Software is provided to you WITHOUT ANY WARRANTY, and no one but you is responsible if you ever brick your device by installing it. + +## Warnings +### Waveform +eInk devices need special data to drive their screen properly. This data is often referenced to as "waveforms", and is usually specific to each device. When distributing images, we cannot guarantee you that the wveform used for our testing device, even if said device *is* of the same model as the one you downloaded it for, will work for yours.
Since every eInk display is unique in its conception, every waveform is different, even for the same display model. If inappropriate data is fed to the eInk display's controller, such as wrong voltages for changing the state of a pixel, it can cause permanent damage to the screen. This has been seen happening on Kindle devices with their native firmware, but has yet to be demonstrated on Kobo devices.
In summary, you shouldn't be worried of flashing a release image of InkBox OS to your device, since the eInk controller should be tolerant enough to work fine with the input data it receives. If you are using a Kindle Touch, we use an in-kernel "default" waveform provided by Amazon until you provide your own.
But exceptions *do* happen, and for them we can't be held responsible for damaging your device.