Skip to content

A proxy for USB devices, libUSB and gadgetFS - you may want this:https://github.com/ktemkin/facedancer

Notifications You must be signed in to change notification settings

v-whoami-v/USBProxy

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

USBProxy

Status

This project is in the very early stages (alpha), it should be assumesd that it is currently non-functional. In fact, there are many occasions on which it doesn't even compile.

What?

A USB man in the middle device using the BeagleBone Black hardware.

Why?

Other USB sniffers exist, but I really like the BeagleBone Black as a hardware platform and I wanted to tinker with the USB device side. There was also an article on Hack a Day about sniffing USB with the BeagleBoard-xM, but on further inspection, it would only build against a relatively old kernel version.

ToDo

  • Some sort of library to make all of this easier to use
  • Support alternative chipsets - gadgetfs should take care of this
  • Clean up code - check return values, etc

License

All files should have a license displayed at the start of the file. Any code that we have written is released under the GPL v3 license.

FAQ

Q. I need support!

A. Me too buddy, me too. Let's hug it out. Your best chance of getting support is to contact me on IRC (#USBProxy on freenode.net), raise an issue on GitHub or email me directly.

Q. How is this different to using usbmon on the host?

A. It isn't. Although there are situations where you may not be able to access the code running on the host system; for example, when reverse engineering USB devices for use with closed platforms.

Q. Isn't the Beagle already a USB monitor?

A. The Total Phase Beagle USB monitors are excellent devices for sniffing and debugging USB connections, in fact, one was used by "AlexP" to reverse engineer the Microsoft Kinect. However, they are completely unrelated to the BeagleBone Black devices produced by TI, which are open source single board computer systems. The BeagleBone Black is the intended target device for this software.

About

A proxy for USB devices, libUSB and gadgetFS - you may want this:https://github.com/ktemkin/facedancer

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 49.9%
  • C 47.0%
  • Makefile 2.2%
  • Other 0.9%