feat: support epd_waveshare

[tchmnn]

Hello there,

I tried to run mousefood on a waveshare display, since it was lacking support I tried my best to add it.
It works fine on my project using a Raspberry Pi Pico and a waveshare epd 2by9.

Kind regards

[orhun]

Heya!
Would be also nice to update the documentation about this 🧀 (e.g. feature flags, supported platforms, etc)

[tchmnn]

Heya! Would be also nice to update the documentation about this 🧀 (e.g. feature flags, supported platforms, etc)

Absolutely. I'll tackle that tonight.

On a related note I kind of want to change the implementation of From<TermColor>. To use Color::White for off and Color::Black for on. I kept my initial draft close to epd-weacts impl. But I keep switching foreground and background colors with ratatui so that the eink display is not all black with white text. What do you think?

EDIT: I also just saw that epd-waveshare implements it the other way around for From<BinaryColor> so I'll probably just re-use that impl.

[j-g00da]

Hi! I would prefer for Color::Black to always display as black and Color::White to display as white. Having to explicitly switch if one wants to display black-on-white may be unfortunate, but I think it's better this way as we are not creating weird behavior like white being displayed as black.

[tchmnn]

Hi! I would prefer for Color::Black to always display as black and Color::White to display as white. Having to explicitly switch if one wants to display black-on-white may be unfortunate, but I think it's better this way as we are not creating weird behavior like white being displayed as black.

Thanks for the feedback, I understand that. I updated the README. Let me know if I should add anything else.

[j-g00da]

Thanks! Code looks good, but I don't really have hardware to test this.

If you can, it would be nice to add a minimal example project in /examples using your hardware.

[tchmnn]

Thanks! Code looks good, but I don't really have hardware to test this.

If you can, it would be nice to add a minimal example project in /examples using your hardware.

Yeah, so that is kinda complicated, since I had to make a couple of changes across multiple crates (mousefood, ratatui, kasuari) to get all of this working on the Raspberry Pi Pico.
I guess I'll just grab an esp32 (seems to have least friction right now) and replicate the example using the waveshare display, test it again an then add the example to this PR.
This would require this PR to be open a couple more days tho, if that's not a problem.

[j-g00da]

Not a problem :)

[j-g00da]

Btw. Do you have a picture of mousefood/ratatui running on waveshare EPD?

[tchmnn]

I can take one. Should I add it to the README then?

BTW I should be able to include the example tomorrow, the esp32 I ordered should arrive then.

[j-g00da]

Sounds great! Yeah it would be nice to include it in the README.md.

I'm also giving a talk about ratatui and mousefood this friday and would happily include it in the slideshow.

[tchmnn]

I tried to quickly throw together an example using an esp32c6, but I unfortunately run into that issue here.
To get a working example I'd either get my hands on another esp board or get the changes I made to get it running on the Pi Pico upstream first in the other crates.

So sorry that I am not able to provide you with another image for your presentation tomorrow.

[tchmnn]

So I added an example using a xtensa board.

[j-g00da]

Looking good, just few minor things :)

[tchmnn]

I applied your suggested changes

[orhun]

I'm reopening this as we will be going over the open issues/PRs soon (Mousefood is now a part of @ratatui!!!)

[orhun]

Thanks for the PR!

[tchmnn]

Thanks for the PR!

Thanks for taking the time on stream to brush it up. The example was generated using esp-generate, that's why the edition was set to 2021 I think and there was the extra bin file.

[orhun]

Ah, that explains it!