pmartin / pocketbook-demo

A few demos of C/C++ applications for Pocketbook Touch Lux ereaders
MIT License
65 stars 9 forks source link

A few demos and documents and tools that could help you write a native C/C++ application for your Pocketbook Touch Lux ereader.

Demos

In each demo directory, you will find a small application highlighting or presenting one specific point.

You should take a look at the first three demos in the following order:

Once you have completed these first steps, the order of the next demos is far less important, as they each focus on a specific point and should be relatively independent from each other.

Documents

A README.md file exists in each demo directory, presenting the goals of the demo and sometimes giving some additionnal information.

For example, see demo02-gdb/README.md to learn how to remote-debug an application, or demo03-makefile-eclipse/README.md to see how to configure Eclipse for both development and remote-debugging.

Tools

To make the development process a bit easier (there is no shell on the device -- and even if we can install one, the virtual keyboard makes it rather hard to use), a few tools are provided in this repo.

App Sender / Receiver

A small shell-script that listens on the ereader side while the computer sends an application over wifi.

⇒ No need to plug the device with an USB cable each time you need to test a new buid!

Dev Utils

A collection of commands you can run from a shell-script. They expose features that are normally only accessible from native-apps.

This is used by several other scripts in this repository.

Disclaimer

#include <std/disclaimer.h>

Like they say:

The content in these demos can be deadly to your ereader device!
In short, "If it breaks, you get to keep both pieces."

These demos and documents were written by people just like you: not-quite-perfect. Which means there might be mistakes, errors, things we did not quite understand…
Our hope is they can help some other developers (maybe you?) write applications for their Pocketbook e-reader devices. In any case, especially if you want to fix something: PRs are welcome!

Also please note that, even if some commiters on this project work at TEA, The Ebook Alternative, which sells Pocketbook ereader devices, the demos and docs in this repository have been written using a public SDK (exploring it, doing a lot of trial-and-error), with absolutely no insider-knowledge at all.