Skip to content

Latest commit

 

History

History
39 lines (29 loc) · 2.07 KB

README.md

File metadata and controls

39 lines (29 loc) · 2.07 KB
Raw

Modified USB Gadget Tool (modified version to send keystrokes)

This is a modified version of the USB Gadget Tool with an additional feature to send some keystrokes (currently opening a terminal under Windows and Ubuntu saying "Hello World.")

To use this feature your android device must have a matching kernel (most modern devices do) and activate the "mouse+keyboard.sh" gadget.

USB Gadget Tool Screenshot

Original USB Gadget Tool

Convert your Android phone to any USB device you like!
USB Gadget Tool allows you to create and activate USB device roles, like a mouse or a keyboard. Connected USB hosts (e.g. a normal computer) will then identify your Android device only under that role. It can also be used to deactivate the standard USB Gadget (including mtp, adb, etc.), e.g. for security reasons.

Following USB gadgets are integrated:

  • Keyboard & Mouse (/dev/hidg0, /dev/hidg1)
  • FIDO CTAP (/dev/hidg0; for WebAuthn)
  • CCID (/dev/ccid_ctrl, /dev/ccid_bulk)

USB Gadget Tool requires root permissions and a Kernel with ConfigFS support. Currently the app only enables the USB Gadget. For the usage of these device endpoints (e.g. /dev/hidg0) further apps are required (see Use-Cases).

Use-Cases

Roadmap

  • Mount of /config if not available
  • Alert if ConfigFS is not supported
  • Creating & enabling USB Gadgets during boot
  • Import custom USB Gadget profiles
  • Adding functions to USB Gadgets
  • Example USB Gadget usage (USB Gadget Tool currently only manages USB Gadgets, not implementations of these)
  • Optional telemetry to understand better how all the Android vendors compile their kernel (e.g. what USB Gadgets are available)
  • F-Droid & Google Play Store distribution

How does it work?

USB Gadget Tool uses ConfigFS - an userspace API inside the Linux Kernel - for creation of arbitrary USB composite devices. https://www.kernel.org/doc/Documentation/filesystems/configfs/configfs.txt