Skip to content

Latest commit

 

History

History
75 lines (45 loc) · 2.55 KB

TROUBLESHOOTING.md

File metadata and controls

75 lines (45 loc) · 2.55 KB
Raw

Troubleshooting Guide

Before reporting a bug or opening an issue to ask for help, go through this guide.

Can I send any keys?

Are your cables correctly connected?

The Nethunter phone should have a regular USB cable attached. The OTG cable should be connected to the locked Android phone.

Refer to the graphic in the README on how to connect the phones.

Is your NetHunter Android phone capable of emulating a keyboard?

  • Check that the /dev/hidg0 device is present
  • Check that the /system/xbin/hid-keyboard binary is present

The diag command will check that these files are present. bash ./android-pin-bruteforce diag

If these files are present but the script doesn't work, try using another Android app to emulate a keyboard such as https://store.nethunter.com/en/packages/remote.hid.keyboard.client/

Does your OTG cable work?

Connect a keyboard or mouse to any phone using the OTG cable. Confirm that the cable works with a different phone and any device. Try using a different OTG cable. Even if it works, perhaps it does not fit well with your locked phone.

Does the script correctly send keys to a text editor in Windows/Linux/MacOS?

  • Connect your NetHunter phone to your laptop.
  • Open a text editor such as Notepad
  • Run the script
  • Confirm that keys are sent to your laptop

Can you send keys to Windows/Linux/Macos from the command line?

Try testing sending keys from the NetHunter command line.

echo "enter" | /system/xbin/hid-keyboard /dev/hidg0 keyboard echo "a b c" | /system/xbin/hid-keyboard /dev/hidg0 keyboard

Can you send keys to the locked phone from the command line?

Same as above.

Does the phone accept keyboard input when it is locked?

Connect a USB keyboard through the OTG cable to the locked phone. This technique requires emulating a keyboard, so if the phone does not accept USB keyboard input while it is locked, this attack will not work.

Note that some devices will not permit you to use a new or unknown USB device while it is locked.

Did you try a different locked phone?

Same as above but with a different locked phone.

Sending the correct keys

What keys will bring up the PIN prompt?

Using a keyboard, try keys and combinations of keys including:

  • CTRL + ESCAPE
  • ESCAPE
  • SPACE

What keys should be sent after the PIN is entered?

Usually this is enter but you might need to send other keys.

Troubleshooting

  • Reboot the phones.
  • Unplug and replug the cables.
  • Try new cables including the OTG cable
  • Paste the output of the diag command, bash ./android-pin-bruteforce diag