Tips & Tricks
=============


Temperature Dependence
----------------------

The display refresh speed depends on the environmental temperature.
Thus, if your room temperature is significantly different from ~22°C, grayscale
accuracy might be affected when using the builtin waveform.
This can be mitigated by using a different timing curve, but this would require calibrating the display timings at that temperature.
If you did this for some temperature other than room temperature, please submit a pull request!

Deep Sleep Current
------------------

Board Revision V5 is optimized for running from a battery thanks to its low deep sleep current consumption. 
In order to achieve the lowest possible deep sleep current, call
::

    epd_deinit()

before going to deep sleep. This will de-initialize the I2S peripheral used to drive the diplay and bring the pins used by epdiy to a low-power state.
You should be able to achieve a deep-sleep current of less than 13µA.
If your deep-sleep current is much higher, please check your attached peripherals.
With some modules, you have to isolate GPIO 12 before going to deep sleep:
::

    rtc_gpio_isolate(GPIO_NUM_12)

Adding a New Display
--------------------

This section is work-in-progress.

- Add Menuconfig options
- Include waveform in :code:`bulitin_waveforms.c`
- Add external waveform declaration and display resolution in `epd_internal.h`
- Calibrate timing curve in :code:`scripts/generate_epdiy_waveforms.py`.
- Add to the list of displays to build waveforms for in :code:`Makefile`
- Document