{"id":13850296,"url":"https://github.com/RobPo/Paperino","last_synced_at":"2025-07-12T21:33:38.986Z","repository":{"id":51373410,"uuid":"79778736","full_name":"RobPo/Paperino","owner":"RobPo","description":"E-Paper display library for the Particle \u0026 Arduino family.","archived":false,"fork":false,"pushed_at":"2021-05-13T00:22:50.000Z","size":120433,"stargazers_count":36,"open_issues_count":5,"forks_count":6,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-08-05T20:32:03.616Z","etag":null,"topics":["arduino","breakout-board","display","driver","e-paper","epd","hackaday","hardware","library","paperino-epaper-shield","particle","shield"],"latest_commit_sha":null,"homepage":"https://robpo.github.io/Paperino/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RobPo.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-23T06:58:13.000Z","updated_at":"2024-03-16T17:21:18.000Z","dependencies_parsed_at":"2022-08-27T05:11:45.193Z","dependency_job_id":null,"html_url":"https://github.com/RobPo/Paperino","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobPo%2FPaperino","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobPo%2FPaperino/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobPo%2FPaperino/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobPo%2FPaperino/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RobPo","download_url":"https://codeload.github.com/RobPo/Paperino/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225839485,"owners_count":17532305,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","breakout-board","display","driver","e-paper","epd","hackaday","hardware","library","paperino-epaper-shield","particle","shield"],"created_at":"2024-08-04T20:01:05.658Z","updated_at":"2024-11-22T03:31:01.184Z","avatar_url":"https://github.com/RobPo.png","language":"C++","funding_links":[],"categories":["Community Libraries"],"sub_categories":[],"readme":"Paperino PL_microEPD Arduino Library\n===============================================================\n\nWelcome to the Paperino docs! This is a Hardware Library for the 1.1” E-Paper display (EPD) from Plastic Logic for Adafruits GFX library. \n\n\n![Paperino E-Paper Shield for Particle, Breakout Board and Driver Module](https://user-images.githubusercontent.com/21104467/29744828-50b878b2-8aad-11e7-8448-8b2f45289c4c.png)  \n[*Paperino E-Paper Shield for Particle, Breakout Board and Driver Module*](https://www.crowdsupply.com/robert-poser/paperino)\n\n### So, what is Paperino?\n\nPaperino is an easy to use micro EPD breakout-board for the Photon or other Arduino-compatible microcontrollers. The eInk-based ePaper display mimics the appearance of natural paper and is capable of holding text and images indefinitely, even without electricity. This makes Paperino perfect for your next battery-driven, connected project where the display content changes rarely.\n\nPaperino also integrates an easy to use accelerometer. It extends the EPD by tap-sensing functions and offers portrait/landscape detection. Furthermore you can wake-up your MCU after movement-based events from deep-sleeping, saving battery live during waiting phases.\n\n\nFeatured In\n-------------------\n![As Featured In](https://user-images.githubusercontent.com/21104467/29744858-a7aaefba-8aad-11e7-8f06-d41a8eaac7fb.png)\n\nDocumentation\n--------------\nThis is the place to get started with your new hardware! We have divided the documentation into the following sections:\n\n\n* **[Hookup Guide](https://robpo.github.io/Paperino/)** - Step-by-step instructions to get your Paperino setup and run within minutes.\n* **[Examples](https://robpo.github.io/Paperino/exampleHelloWorld/)** - Ready to use examples for your own inspiration.\n* **[Reference](https://github.com/RobPo/Paperino/tree/gh-pages/datasheets)** - Datasheets \u0026 Application Notes.\n* **[Hardware](https://github.com/RobPo/Paperino/tree/gh-pages/hardware)** - Schematics \u0026 PCB layouts.\n\n\nHow To Use\n-------------------\n\n### Installation\n\nThis library is part of the Particle and Arduino **Library Manager**. Please search for `PL_microEPD` within the Manager and download the library, that’s it! Included are six example sketches, they are useful to learn the basics about this ePaper screen.\n\n### Hardware hookup\n\nTo start communicating with the ePaper driver IC, you’ll need to supply 3.3V and four more wires for SPI communication (@3.3V voltage level). Please have a look at the [hook-up guide](https://robpo.github.io/Paperino/) for more detailed information. \n\n### Example: Hello World!\n\nThis is the [first](https://robpo.github.io/Paperino/exampleHelloWorld/), and shortest possible demo and shows how to address the ePaper (don’t forget to update the GPIO name if needed in line 3):\n\n\n```cpp\n#include \"Adafruit_GFX.h\"\n#include \"PL_microEPD.h\"\n\n#define EPD_CS      A2\nPL_microEPD display(EPD_CS);  \n\nvoid setup() {  \n    SPI.begin();                    \n    SPI.beginTransaction(SPISettings(4000000, MSBFIRST, SPI_MODE0));\n  \n    display.begin();                \n    display.print(\"Hello World!\");\n    display.update();               \n}\n\nvoid loop() {              \n}\n```\n\nYou should now be able to see the ePaper screen updating. Congratulation! If you feel more like a pro’ this is now the time to [add the wiring](https://robpo.github.io/Paperino/) of two more GPIO lines (called ‘busy’ \u0026 ‘reset’). They are needed to run the image updates a bit faster and/or to reset the IC after having it set to deep sleep.\n\n\n### More…\n\nOnce this example is successfully running, please have a look at the following sketches: [GFX demo](https://robpo.github.io/Paperino/exampleGFXdemo/) shows how to draw all the letters, rectangles and dots. The [Graylevel](https://robpo.github.io/Paperino/example4GLs/) sketch explains how to use the four different graylevels in your next project. [Update modes](https://robpo.github.io/Paperino/exampleUpdateMode/) describes three different ways of updating an ePaper screen.\n\nDistributors\n-------------------\nPaperino ePaper displays are available at [Crowd Supply](https://www.crowdsupply.com/robert-poser/paperino), [Watterott electronic](http://www.watterott.com/de/Paperino-A-micro-ePaper-with-accelerometer), [Mouser](https://www2.mouser.com/Search/Refine.aspx?Keyword=paperino) and [DigiKey](https://www.digikey.com/products/en?keywords=paperino).\n\nProjects\n-------------------\nThese demo projects are for your inspiration! What will you implement with Paperino? Tell us, we’ll love to add your project here!\n\n\n[![Project TrafficIndicator at Hackaday.io](https://user-images.githubusercontent.com/21104467/29744843-761172a8-8aad-11e7-8e60-a01fffbf1ea6.png)](https://hackaday.io/project/22002-trafficindicator-between-workhome-or-vice-versa) \n[![Project IoT Connected Desk Frame at Hackaday.io](https://user-images.githubusercontent.com/21104467/29744849-891f23a4-8aad-11e7-8b91-d1db8494546d.png)](https://hackaday.io/project/21638-iot-connected-picturedesk-frame) \n[![Project local rain forecast for fair weather cyclists at Hackster.io](https://user-images.githubusercontent.com/21104467/29744854-98f1e4b0-8aad-11e7-8356-7e5f55b207e4.png)](https://www.hackster.io/robert-poser/epaper-based-local-rain-forecast-for-fair-weather-cyclists-cb168c)  \n[![Project Industrial Tap Tap Machine at Hackster.io](https://user-images.githubusercontent.com/21104467/32456267-4848ab9c-c325-11e7-8ec6-64f17dcb3cfc.png)](https://www.hackster.io/robert-poser/tap-tap-automat-958d9c)\n\nChangelog\n-------------------\n- [v1.1.01 (03/2018)](https://github.com/RobPo/Paperino/archive/v1.1.01.zip) - Add support for more EPDs: 1.4\", 2.1\" \u0026 3.1\" (auto-detection) and for deepSleep() of driver IC\n- [v1.0.20 (10/2017)](https://github.com/RobPo/Paperino/archive/v1.0.20.zip) - Add support for (optional) simplified wiring for MCUs with limited GPIOs\n- [v1.0.10 (08/2017)](https://github.com/RobPo/Paperino/archive/v1.0.10.zip) -  Particle \u0026 Arduino Library Manager supported; tap sensitivity increased; ‘verified’ by Particle\n- [v1.0.00 (07/2017)](https://github.com/RobPo/Paperino/archive/v1.0.06.zip) - Initial release\n\n\nLicense Information\n-------------------\n\nThis library is _**open source**_!\n\nCreated by Robert Poser, Mar 4th 2018, Dresden/Germany. Released under BSD license (3-clause BSD license), check license.md for more information.\n\nWe invested time and resources providing this open source code, please support Paperino and \nopen source hardware @Adafruit and by purchasing this product @Crowdsupply @Watterott @Plasticlogic.\n\nIf you like this project please [follow us on Twitter](https://twitter.com/paperino_io).\nHaving problems or have awesome suggestions? Contact us: paperino.display@gmail.com.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRobPo%2FPaperino","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRobPo%2FPaperino","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRobPo%2FPaperino/lists"}