{"id":22624367,"url":"https://github.com/leso-kn/epaper-central","last_synced_at":"2025-06-18T05:35:52.771Z","repository":{"id":202675864,"uuid":"707900716","full_name":"leso-kn/epaper-central","owner":"leso-kn","description":"A lightweight image sender library for ZigBee USB sticks running the cc2531-OEPL OpenEPaperLink station firmware.","archived":false,"fork":false,"pushed_at":"2023-11-05T17:07:26.000Z","size":90,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-09T00:14:40.295Z","etag":null,"topics":["cc2531","epaper","openepaperlink","zigbee"],"latest_commit_sha":null,"homepage":"https://epaper-central.readthedocs.io","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leso-kn.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-10-20T23:43:59.000Z","updated_at":"2024-07-19T00:05:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"1e738b7f-12ab-41f8-9067-eff271fa0dca","html_url":"https://github.com/leso-kn/epaper-central","commit_stats":null,"previous_names":["leso-kn/epaper-central"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leso-kn%2Fepaper-central","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leso-kn%2Fepaper-central/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leso-kn%2Fepaper-central/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leso-kn%2Fepaper-central/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leso-kn","download_url":"https://codeload.github.com/leso-kn/epaper-central/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236948086,"owners_count":19230393,"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":["cc2531","epaper","openepaperlink","zigbee"],"created_at":"2024-12-09T00:13:50.775Z","updated_at":"2025-02-03T13:12:51.873Z","avatar_url":"https://github.com/leso-kn.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"![epaper-central banner](docs/banner.png)\n\n# `libepaper-central`\n\n_A lightweight image sender library for ZigBee USB sticks running the cc2531-OEPL OpenEPaperLink station firmware._\n\n## About\n\nThis C library acts as a serial-driver for CC2531-based ZigBee USB sticks. It can be used to transmit bi-color images to hacked supermarket price-tags via the [OpenEPaperLink](https://openepaperlink.de/) protocol (tested with OpenEPaperLink v1.9.0).\n\nThe data-source are generic rgb pixel-arrays, which could be fully generated in memory with no need for intermediate files.\n\n## API\n\nTo integrate libepaper-central in your project, head over to the [docs](https://epaper-central.readthedocs.io/).\n\n## Usage (command-line)\n\nThe library comes with a standalone reference-program \"epaperd\" which picks up [PPM images (P6)](https://en.wikipedia.org/wiki/Netpbm#Description) from a folder and sends them to nearby OpenEPaperLink displays.\n\nThe program will check for files named after tag mac addresses (e.g. 00112233aabbccdd.ppm for a tag with mac address `00:11:22:33:aa:bb:cc:dd`) and falls back to `default.ppm` if no specific image exists for a tag – in this case the mac address will be visible on the display in addition until an applicable .ppm-file becomes available in the cache folder.\n\n```bash\n\u003e epaperd [/cache/directory]\n```\n\n## Compatible Hardware\n\nThe library is compatible with CC2531-based ZigBee USB sticks running the cc2531-OEPL station firmware.\n\nThe firmware can be obtained from [Jonas Niesners OpenEPaperLink repository](https://github.com/jonasniesner/OpenEPaperLink/blob/4aaffbacd4ebee760c0c4088e069e5ba60e4a219/ARM_Tag_FW/cc2531_OEPL/cc2531_OEPL_beta.hex) – for flashing there's several options available:\n\n1. Using a proprietary [CC Debugger](https://www.ti.com/tool/CC-DEBUGGER) adapter\n2. Using a Raspberry Pi (or other single-board computer) via [cc2531-flasher-pi](https://github.com/leso-kn/cc2531-flasher-pi)\n3. Using an esp32 (see [https://youtu.be/98fOzZs__fc](https://youtu.be/98fOzZs__fc?t=170))\n\n## License\n\nlibepaper-central is licensed under the MIT License.\n\n## Changelog\n\n### v0.2.0\n\n* Pixmap format optimizations (Improved refresh speed)\n* epaperd: Added command line option \"`-D`\" to specify ZigBee radio device\n* epaperd: Display error message if serial device cannot be opened\n* Fix: Fixed minor offset between black and red pixels\n\n### v0.1.1\n\n* Fix: Added fallback install dirs in CMake configuration ([#1](https://github.com/leso-kn/epaper-central/issues/1))\n* Docs: Added build instructions page\n\n### v0.1.0\n\n* Initial version of the library\n  * Transmit images from generic rgb pixel-arrays\n  * Simple \"epaperd\" reference-program to load .ppm-images from a folder and transmit them to price-tags\n\n---\n\nCreated by [Lesosoftware](https://github.com/leso-kn) in 2023\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleso-kn%2Fepaper-central","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleso-kn%2Fepaper-central","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleso-kn%2Fepaper-central/lists"}