Skip to content

Commit ec06ee5

Browse files
committed
better readme
1 parent a150a0c commit ec06ee5

1 file changed

Lines changed: 23 additions & 45 deletions

File tree

README.md

Lines changed: 23 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -4,81 +4,62 @@
44

55
Read NFC tags while screen is off.
66

7-
# Help
7+
_Useful integrations_
8+
[NFC Card Emulator Pro](https://play.google.com/store/apps/details?id=com.yuanwofei.cardemulator.pro)
9+
[Tasker](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm)
810

9-
_GOOGLE PAY DOES NOT WORK WHILE SCREEN IS OFF_
11+
# Help section
1012

11-
This is normal, you need to wake up the device to pay in stores.
12-
13-
_I HAVE AN ISSUE_
13+
**GOOGLE PAY DOES NOT WORK WHILE SCREEN IS OFF**
1414

15-
Create an issue with this format:
16-
1. Your Android Version
17-
1. The name of your ROM
18-
1. The name of your device
19-
1. Logs of Magisk at installation
15+
This is normal, you need to wake up the device to pay in stores.
2016

21-
_MY NFC IS NOT DETECTED ANYMORE_
17+
**MY NFC IS NOT DETECTED ANYMORE**
2218

2319
If you did not unlock your device since last boot, unlock it and wait 30 seconds for the module to be loaded.
2420

2521
After that time, if NFC does not start automatically or manually, it means that the patch does not work. You can uninstall the module and create an issue.
2622

27-
_I AM STUCK IN A BOOTLOOP_
23+
**I AM STUCK IN A BOOTLOOP**
24+
25+
Remove the module manually.
2826

2927
1. Boot into TWRP
3028
1. Advanced -> File Manager
3129
1. Delete /adb/modules/NFCScreenOff
3230
1. Reboot
3331

32+
**THE MODULE IS NOT WORKING SINCE LAST UPDATE**
3433

35-
For now, it only works for reading NFC tags. To pay in stores, you still need to wake up the device.
34+
Perform a clean reinstallation.
3635

37-
I succeeded to make it work only if the `modded` APK is injected while the phone is booted with the `original` APK. That is why I inject the `modded` APK in [service.sh](service.sh).
36+
1. Uninstall the module
37+
1. Reboot
38+
1. Install the module
39+
1. Restart your device
40+
41+
If it does not solve your problem, you can create an issue.
3842

3943
# How does it work?
4044

41-
Every
45+
I succeeded to make it work only if the `modded` APK is injected while the phone is booted with the `original` APK. That is why I inject the `modded` APK in [service.sh](service.sh).
4246

43-
# How to test?
47+
I have patched the original `NfcNci.apk` (com/android/nfc/NfcService.smali) so that the phone thinks the screen is always on and unlocked. This patch only applies to NFC Service so it does not impact any other functionality of the phone.
4448

45-
1. Download a card emulator like [this app](https://play.google.com/store/apps/details?id=com.yuanwofei.cardemulator.pro).
46-
1. Put a NFC tag on the back of your phone while it is locked and the screen turned off.
47-
1. Your phone should give you a feedback that it has successfully read the tag (sound, vibration).
49+
The modded APK was generated using the method described [here](https://github.com/lapwat/NfcScreenOffPie).
4850

49-
If it did not work, uninstall this module and you will be back and running. Please also leave a comment on this [XDA Thread](https://forum.xda-developers.com/apps/magisk/module-nfcscreenoff8-t4034903) with:
50-
1. Your Android Version
51-
1. The name of your ROM
52-
1. The name of your device
53-
1. Logs of Magisk (if the installation failed)
5451

5552
I will do my best to make it compatible.
5653

57-
# Updates failure
58-
59-
If the module fails to update, do the following:
60-
61-
1. Uninstall the module
62-
1. Restart your device
63-
1. Reinstall the module
64-
1. Restart your device
65-
66-
# Tested devices
54+
# Working devices
6755

6856
| Android Version | ROM | Device |
6957
|-----------------|-------------|----------------------|
7058
| 10 | crDroid 6.2 | Xiaomi Redmi K20 Pro |
7159
| 10 | Lineage 16 | Moto G5S Plus |
7260
| 9 | Havoc 2.8 | Xiaomi Redmi K20 Pro |
7361

74-
# Under the hood
75-
76-
I have patched the original `NfcNci.apk` (com/android/nfc/NfcService.smali) so that the phone thinks the screen is always on and unlocked. This patch only applies to NFC Service so it does not impact any other functionality of the phone.
77-
78-
The modded APK was generated using the method described [here](https://github.com/lapwat/NfcScreenOffPie).
79-
80-
# Todo
81-
62+
Leave a comment with your working device on the [XDA Thread](https://forum.xda-developers.com/apps/magisk/module-nfcscreenoff8-t4034903).
8263

8364
# Useful
8465

@@ -101,6 +82,3 @@ java -jar smali-2.4.0.jar a -o classes.dex NfcNci/
10182
cp NfcNci.apk NfcNci_mod.apk
10283
zip -rv NfcNci_mod.apk classes.dex
10384
```
104-
105-
106-

0 commit comments

Comments
 (0)