FAQ
About 552 wordsAbout 2 min
2025-12-23
Common Questions from New Users
Newbie
My phone is bricked after flashing! I'm panicking 😱
Don't panic! This is common. Just enter Fastboot mode and flash back the original Boot image. If that doesn't work, flash the complete firmware.
Newbie
Why does my device say unsupported? 😤
Most likely your kernel doesn't support KernelPatch. Check if your kernel version is within 3.18 - 6.15+ and has CONFIG_KALLSYMS=y.
Newbie
My superuser path changed to kp, what should I do? 💀
It's caused by other ROOT solution remnants in the environment. Clean up conflicting files in /data/adb, restart, then reset the su path.
What if the phone fails to boot after flashing?
Don't panic! This is common and usually solvable:
Enter Fastboot Mode:
- After turning off, press and hold Power + Volume Down (may vary by phone)
- Or use command:
adb reboot bootloader
Flash back original Boot image:
fastboot flash boot PATH/TO/original_boot.img fastboot rebootIf it still doesn't work:
- Flash the complete official firmware package
- Seek community help, providing your phone model and error information
For detailed rescue methods, please refer to Rescue Guide.
Why is my device unsupported?
Possible reasons:
- Kernel version is not in supported range (3.18 - 6.15+)
- Architecture is not ARM64
- Kernel configuration does not meet requirements (requires
CONFIG_KALLSYMS=y) - Specially customized device system
重要
Most cases of unavailability can be attributed to your kernel not supporting KernelPatch.
KernelPatch requires CONFIG_KALLSYMS=y to work properly. You can compile the kernel yourself or find a kernel compiled by others to get support.
What if errors occur during patching?
- Confirm Boot image is intact: Re-acquire the original Boot image
- Check tool version: Use the latest version of FolkPatch Manager
- Try manual patching: Use KernelPatch tools to patch manually
- Check community resources: Search for special tutorials for your device model
KPM module causes FolkPatch to lose Root permissions after embedding
Some KPM modules may be incompatible with the current kernel or KernelPatch version after embedding, causing the Root authorization mechanism to malfunction, manifesting as FolkPatch being unable to properly grant superuser permissions.
注
For all KPM modules, it is recommended to prioritize loading to ensure it works properly, and then use embedding after confirming it is correct.
More Help
If you encounter problems not solved in the documentation, you can:
- Visit FolkPatch official GitHub page
- Search relevant forums and communities
- Join relevant QQ groups or Telegram groups for real-time help
Log Export
Export detailed application running logs for problem diagnosis and error reporting.
Function Description:
- Collect app running logs, kernel logs, system information
- Package as
.tar.gzcompressed file - Can be sent to developers via share button
Usage:
- Go to Settings → General
- Click Send Log
- Select save location (using system file picker)
- Wait for log collection and compression to complete
- Share or save log file
Log Content:
- Application log (logcat)
- FolkPatch kernel log
- System property information
- Device information
- Installed module list
- Reproduce the problem first
- Export log immediately
- Upload log file in GitHub Issue
- Describe problem reproduction steps in detail
Copyright
Copyright Ownership:FolkPatch Team
License under:Attribution 4.0 International (CC-BY-4.0)
