black/white e-Paper/e-Ink display driver

[silkeh]

Contribution description

This PR adds a driver for black/white e-paper/e-ink SPI display drivers/controllers, including:

• Default parameters for the IL3829 (tested)
• Default parameters for the SSD1673 (see boards: add support for Phytec 'reel board' #11096, untested)
• Header files containing RIOT logos. These were generated using png2c.
  Some questions:
  • Should I move these to a generally available directory?
  • What should the copyright notice be?
• Tests for the display driver. A video with the full test can be found here.

With the right parameters, this driver should work with most black and white e-paper display drivers. This has only been tested with the IL3829, which is commonly used in 1.54 inch black and white e-Paper displays like this one.

This PR is based on #11078 with some major rework to get it all in a more generic package.

Testing procedure

A test program is included (tests/driver_il3829).
Modify the makefile for a microcontroller/display combination you have and go for it.

Issues/PRs references

This is a complete rework based on the feedback from #11078.

[silkeh]

@bergzand ping!

[bergzand]

@aabadie You have a proposal on a unified display driver API right? Would it be possible for you to give this driver a review at some point?

[Citrullin]

@bergzand Where is the proposal for the driver? I would like to know, if this also fits into my needs :)

[bergzand]

@Citrullin There is a start of it in #13124 but I don't think there is a dedicated PR or issue yet

[aabadie]

Where is the proposal for the driver?

It's in e3fb86e and e7cbd70 from #13124 but it's still very minimal (only one map function exposed by the generic API). I'm planning to add getter/setter functions to be able to control/access internal states/parameters of the display drivers from higher level functions (like lvgl for example).
If you think the API is useful, I can split it out from #13124 and open a dedicated PR.

[silkeh]

I have updated the PR with an implementation of disp_dev, some minor fixes and a rebase on master.

[Citrullin]

@silkeh I started working on it as well. I need to split up your code in order to make it work with the IL0373. For example the variable values in epd_bw_spi_internal.h are different for the IL0373. There are some fixed values, which needs to get variables.

Where is the proposal for the driver?

It's in e3fb86e and e7cbd70 from #13124 but it's still very minimal (only one map function exposed by the generic API). I'm planning to add getter/setter functions to be able to control/access internal states/parameters of the display drivers from higher level functions (like lvgl for example).
If you think the API is useful, I can split it out from #13124 and open a dedicated PR.

Looks similar to SAUL. I think that is something we can work on.

[silkeh]

@aabadie, @bergzand: ping! 🎂

outdated

[bergzand]

Ack, thank you for the contribution and your patience with this PR!

bors merge

[bors]

Build failed:

• Murdock

[bergzand]

Both test applications need a file called Makefile.ci with the following content:

BOARD_INSUFFICIENT_MEMORY := \
    arduino-duemilanove \
    arduino-nano \
    arduino-uno \
    atmega328p-xplained-mini \
    atmega328 \
    #

Feel free to force push these changes

[bergzand]

Lets try this again

bors merge

[bors]

Build failed:

• Murdock

[benpicco]

You can generate this with

make create-Makefile.ci

[bergzand]

Thanks,

Bors merge

[bors]

🕐 Waiting for PR status (GitHub check) to be set, probably by CI. Bors will automatically try to run when all required PR statuses are set.

[bergzand]

Bors merge

[bors]

Build succeeded:

• Murdock
• static-tests
• tools-build-success

[bergzand]

Thanks for the effort you put into this @silkeh