Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Android: support for new e-ink devices #8482

Open
pazos opened this issue Nov 25, 2021 · 213 comments · Fixed by koreader/android-luajit-launcher#492 · May be fixed by koreader/android-luajit-launcher#531
Open

Android: support for new e-ink devices #8482

pazos opened this issue Nov 25, 2021 · 213 comments · Fixed by koreader/android-luajit-launcher#492 · May be fixed by koreader/android-luajit-launcher#531
Labels

Comments

@pazos
Copy link
Member

pazos commented Nov 25, 2021

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

On top of the screen you'll notice either unsupported or a description of the current support.

It is important for us to know if you're requesting support for a new, unsupported, device or an update on a supported one.

If it is an update please also tell us the improvements you noticed with the change.

add a comment with:

  1. Reason: update or new
  2. commercial name of product
  3. android version
  4. 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

My device used to work but not anymore after a firmware update.

Try the test again and report if it's ok with any new driver!

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.

@DominikSchmidbauer

This comment has been minimized.

@NiLuJe

This comment has been minimized.

@pazos

This comment has been minimized.

@arooni

This comment has been minimized.

@DominikSchmidbauer

This comment has been minimized.

@pazos pazos added the help-wanted We'd like help with this issue label Dec 6, 2021
@deep-dark-blue

This comment has been minimized.

@arooni

This comment has been minimized.

@jonch919

This comment has been minimized.

@metivett

This comment has been minimized.

@pbethke

This comment has been minimized.

@Ducha90

This comment has been minimized.

@Frenzie

This comment has been minimized.

@Ducha90

This comment has been minimized.

@Moonbase59

This comment was marked as resolved.

@Frenzie

This comment was marked as resolved.

@raygan

This comment was marked as resolved.

@hevoos

This comment was marked as resolved.

@plateaukao
Copy link

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.

Hi, @f-coco
As far as I know, this device (mooink plus 2c) does not allow installing apks by default, and I can't find any information how to do so. Do you know where I can find related information to install koreader on it? So that I can also verify the changes @hugleo did at (koreader/android-luajit-launcher#500) ? Thanks!

@b1tfan

This comment was marked as outdated.

@b1tfan
Copy link

b1tfan commented Sep 27, 2024

  1. Manufacturer: rakuten kobo inc
    Brand: rakutenkobo
    Model: tolino
    Device: ntx_6sl
    Product: ntx_6sl
    Hardware: e70q20
    Platform: imx6
    Friendly name:
    test.log
    Tolino Epos 1
  2. Android 4.4
  3. Tolino Ntx, Freescale/NTX

why was this marked as outdated? The warmth control is not working at all.

@pazos
Copy link
Member Author

pazos commented Sep 27, 2024

why was this marked as outdated? The warmth control is not working at all.

Quick (wrong*) filter. I'm going to update OP to improve these things in the future ;)

@b1tfan
Copy link

b1tfan commented Sep 28, 2024

  1. Device info:
    Manufacturer: rakuten kobo inc.
    Brand: rakutenkobo
    Model: tolino vision 6
    Device: tolino
    Product: tolino
    Hardware: sun8iw15p1
    Platform: virgo
  2. Android 8
  3. nothing works, in koreader brightness is ok, warmth does not work
    test[2].log

@hugleo
Copy link
Contributor

hugleo commented Sep 28, 2024

3. Tolino Ntx, Freescale/NTX

@b1tfan Do both the Tolino Ntx and Freescale/NTX work for EPD refresh, or do only the lights work?

@wagersmg
Copy link

wagersmg commented Oct 4, 2024

Nook GlowLight 4e
Android 8.1.4
Eink driver: freescale
Light driver: generic

Device info:
Manufacturer: barnesandnoble
Brand: nook
Model: bnrv1000
Device: e60p54_android_lowres
Product: e60p54_android_lowres
Hardware: sun8iw15p1
Platform: virgo
Working EPD Driver: Freescale/NTX
Working Frontlight Driver: Tolino Ntx (no warmth)

I can’t turn the frontlight on/off through KOReader (using gestures or the dialog menu), but once I turn the frontlight on through the Nook software (or by long pressing the N button), I am able to control the light level using the KOReader frontlight dialog. Very similar results when using the compatibility test. Starting with the frontlight off, none of the drivers seem to do anything. After long pressing the N button though, I had much better luck with a few of the drivers. Tolino Ntx (no warmth) seems like the best option to me. I gave KOReader superuser status in Magisk, but I’m still not able to turn the frontlight on/off using my toggle frontlight gesture.

test.log

@BurkSchu
Copy link

BurkSchu commented Oct 5, 2024

Tolino Epos 2

Device info:
Manufacturer: rakuten kobo inc.
Brand: rakutenkobo
Model: tolino
Device: ntx_6sl
Product: ntx_6sl
Hardware: e80k00
Platform: imx6

test.log

Lights: tolino/ntx

@b1tfan
Copy link

b1tfan commented Oct 6, 2024

  1. Tolino Ntx, Freescale/NTX

@b1tfan Do both the Tolino Ntx and Freescale/NTX work for EPD refresh, or do only the lights work?

for Test E-Ink I selected "Freescale/NTX" for Test Lights i selected "Tolino Ntx", both work for EPD refresh and lights respectively.

@hugleo
Copy link
Contributor

hugleo commented Oct 6, 2024

Nook GlowLight 4e Android 8.1.4 Eink driver: freescale Light driver: generic

Device info: Manufacturer: barnesandnoble Brand: nook Model: bnrv1000 Device: e60p54_android_lowres Product: e60p54_android_lowres Hardware: sun8iw15p1 Platform: virgo Working EPD Driver: Freescale/NTX Working Frontlight Driver: Tolino Ntx (no warmth)

I can’t turn the frontlight on/off through KOReader (using gestures or the dialog menu), but once I turn the frontlight on through the Nook software (or by long pressing the N button), I am able to control the light level using the KOReader frontlight dialog. Very similar results when using the compatibility test. Starting with the frontlight off, none of the drivers seem to do anything. After long pressing the N button though, I had much better luck with a few of the drivers. Tolino Ntx (no warmth) seems like the best option to me. I gave KOReader superuser status in Magisk, but I’m still not able to turn the frontlight on/off using my toggle frontlight gesture.

test.log

Looks like the same device that @Codereamp #11110 and already supported. Maybe different firmware versions, or hardware variation.

@MrJepperd
Copy link

Full refresh gesture not working. The eink menu to select full refresh on every page turn (or even other frequencies) not present in eink settings.

Reason:  new
Note Air 3c
Android 12 / S / API 32
Screen seems to refresh with every driver when I click the button. The onyx / qualcomm seems to do it twice or maybe more robustly? 

Device info:
Manufacturer: qualcomm
Brand: onyx
Model: noteair3c
Device: noteair3c
Product: noteair3c
Hardware: qcom
Platform: bengal

test.log

@Frenzie
Copy link
Member

Frenzie commented Nov 5, 2024

That sounds like it's coming straight from some kind of global device settings.

@MrJepperd
Copy link

That sounds like it's coming straight from some kind of global device settings.

I possibly should have also mentioned that the device indicates unsupported.

@hugleo
Copy link
Contributor

hugleo commented Nov 5, 2024

That sounds like it's coming straight from some kind of global device settings.

I possibly should have also mentioned that the device indicates unsupported.

Disable onyx optimization in app settings or change the screen other than REGAL. Then you can do eink test again to show which driver will work. With proper adb settings following the instructions even lights can work.

@MrJepperd
Copy link

That sounds like it's coming straight from some kind of global device settings.

I possibly should have also mentioned that the device indicates unsupported.

Disable onyx optimization in app settings or change the screen other than REGAL. Then you can do eink test again to show which driver will work. With proper adb settings following the instructions even lights can work.

Thanks. With optimization off and Balanced mode instead of regal only the onyx/qualcomm refresh works. The issue first indicated is still present.

Also, for the lights is it just running the test using ADB as indicated on top of this page, or are there other ADB instructions you're referring to?

@hugleo
Copy link
Contributor

hugleo commented Nov 5, 2024

That sounds like it's coming straight from some kind of global device settings.

I possibly should have also mentioned that the device indicates unsupported.

Disable onyx optimization in app settings or change the screen other than REGAL. Then you can do eink test again to show which driver will work. With proper adb settings following the instructions even lights can work.

Thanks. With optimization off and Balanced mode instead of regal only the onyx/qualcomm refresh works. The issue first indicated is still present.

Yes, we need to add support now

Also, for the lights is it just running the test using ADB as indicated on top of this page, or are there other ADB instructions you're referring to?

https://github.com/koreader/koreader/wiki/Android-tips-and-tricks#onyx-devices

@MrJepperd
Copy link

That sounds like it's coming straight from some kind of global device settings.

I possibly should have also mentioned that the device indicates unsupported.

Disable onyx optimization in app settings or change the screen other than REGAL. Then you can do eink test again to show which driver will work. With proper adb settings following the instructions even lights can work.

Thanks. With optimization off and Balanced mode instead of regal only the onyx/qualcomm refresh works. The issue first indicated is still present.

Yes, we need to add support now

Also, for the lights is it just running the test using ADB as indicated on top of this page, or are there other ADB instructions you're referring to?

https://github.com/koreader/koreader/wiki/Android-tips-and-tricks#onyx-devices

Thanks!

@CottonEvoker
Copy link

Reason: New
Commercial name of product: Bigme B751
Android version: 11

I'd like to see this working on my B751. Tried all drivers on 'Start compatability test' page but none work.

I note the instruction at the top of the post that if no driver works, I should wait until somebody writes a driver for that platform, so perhaps I shouldn't even be posting here.

But since I don't have the technical know-how to write a driver, I wanted to just make known I'd really like to see this working on my Bigme.

My device is the black & white B751 as opposed to the B751C colour device, but I think the architechture is almost identical. (In some settings on my device, it's actually described as "B751C", despite being the BW version).

KOReader a dream to use on the B751.

Again sorry if this post doesn't belong here.

@rola25
Copy link

rola25 commented Nov 25, 2024

Tolino Epos 2

Device info:
Manufacturer: rakuten kobo inc.
Brand: rakutenkobo
Model: tolino
Device: ntx_6sl
Product: ntx_6sl
Hardware: e80k00
Platform: imx6

Warmth Light still do not work with newest Version v2024.11-27-g921dde0b3_2024-11-24.
test.log

@hugleo
Copy link
Contributor

hugleo commented Nov 25, 2024

Tolino Epos 2

Device info: Manufacturer: rakuten kobo inc. Brand: rakutenkobo Model: tolino Device: ntx_6sl Product: ntx_6sl Hardware: e80k00 Platform: imx6

Warmth Light still do not work with newest Version v2024.11-27-g921dde0b3_2024-11-24. test.log

If I recall correctly, you said that one of the stable versions works.
I suggest you send the eink test log for the last stable version that worked.
We will probably need more detailed adb logs from both versions to compare.

@rola25
Copy link

rola25 commented Nov 26, 2024

Tolino Epos 2
Device info: Manufacturer: rakuten kobo inc. Brand: rakutenkobo Model: tolino Device: ntx_6sl Product: ntx_6sl Hardware: e80k00 Platform: imx6
Warmth Light still do not work with newest Version v2024.11-27-g921dde0b3_2024-11-24. test.log

If I recall correctly, you said that one of the stable versions works. I suggest you send the eink test log for the last stable version that worked. We will probably need more detailed adb logs from both versions to compare.

OK, I think I'm a step further: Warmth does work in the compatibility test, when I choose "Tolino Root" instead of "Tolino Ntx". So the question is: how can I configure koreader, so that I uses "Tolino Root" in-app?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet