Android: support for new e-ink devices

[pazos]

About

Support for new android based ereaders (ie: with e-ink screen) in KOReader.

Intro

Android has no APIs for e-ink screens or warmth lights. Each vendor implement its own methods.
We support some drivers and we keep a list of devices that work with each driver.

To test drivers go to "Tools" -> "More Tools" -> "Developer options" -> "Start compatibility test" in KOReader FM.

Instructions

If some driver works in your device and it isn't currently supported in KOReader

add a comment with:

1. commercial name of product
2. android version
3. driver(s) that work.

Attach the report saved on your device in /sdcard/test.log

If no driver work

Wait until somebody writes a driver for that platform.

Troubleshooting

Can't do the test because KOReader won't work at all

Use ADB to start the test: adb shell am start -n org.koreader.launcher/.TestActivity
Please include that bit of info in your comment.

My device has other different issues.

There're a few known quirks. If your device has one of these please include it in your comment.

"no lights": my device has no frontlight
"broken lifecycle": the app hangs at pause/resume
"broken hw rotation": the app hangs when rotated
"needs wakelocks": the app only work if I use a 3rd party tool to keep the device active when KO is running.

My device only works in A2 mode.

Please tell us exactly that on the report. It might work with the OldTolino driver if the "Tolino/NTX" test works fine.

Submitting a patch yourself.

Due to "life happens" reasons there is going to be a delay between the report and the patch that addresses the report. If you want to make the span shorter you can make the patch yourself and send a PR against https://github.com/koreader/android-luajit-launcher

Have a look at https://github.com/koreader/android-luajit-launcher/commits/master/app/src/main/java/org/koreader/launcher/device, in particular commits with the scheme "add $model".

Please do not comment here asking for help. It makes support harder.

[f-coco]

Device info: Manufacturer: unknown Brand: allwinner Model: mooink plus 2c Device: e70p54_android_cfa Product: e70p54_android_cfa Hardware: sun8iw15p1 Platform: virgo

Wroking EPD Driver: NGL4 mooink_plus2c.log

@hugleo
Sorry, I forgot to tell this device is a color e-ink devices. I installed the latest nightly build, the color is gone.

[raygan]

commercial name of product: Moaan InkPalm Plus
android version: 11
driver(s) that work: Rockchip 3566 eink driver works, no backlight driver works.
test.log

I'd add to this that while I haven't found any way to set backlight level or increment the backlight on this device, I have found that I can toggle it on and off with this activitiy: com.moan.toggle_backlight
For example, this works over ADB:
am broadcast -a com.moan.toggle_backlight
Perhaps this would allow you to add basic backlight control to KOReader? I can't confirm but I think this may also work for other InkPalm devices.

[hevoos]

Onyx Boox Go 10.3
Android: 12
no lights
E-INK: Onyx/Qualcomm (works, screen refreshes)

test.log