cjackyang / umtp-responder

Ligthweight Media Transfer Protocol (MTP) responder daemon for GNU/Linux

uMTP-Responder

Ligthweight Media Transfer Protocol (MTP) responder daemon for GNU/Linux

The uMTP-Responder allows files to be transferred to and from devices through the devices USB port.

Main characteristics and features

• Implemented in C.

• Lightweight implementation.

• User space implementation.

• As few dependencies as possible.

• Hook to the FunctionFS/libcomposite or the Gadget FS Linux layer.

• Dynamic handles allocation (No file-system pre-scan).

• (Optional) Syslog support.

Current status

What is working

• Folder listing.

• Folder creation.

• Files & Folders upload.

• Files & Folders download.

• Files & Folders deletion.

• Up to 16 storage instances supported.

• GadgetFS and FunctionFS/libcomposite modes supported.

Which platforms are supported ?

Any board with a USB device port should be compatible. The only requirement is to have the USB FunctionFS or GadgetFS support enabled in your Linux kernel.

Boards successfully tested

• Atmel Sama5D2 Xplained.

• Raspberry PI Zero (W).

• BeagleBone Black.

• Allwinner SoC based board.

• Freescale i.MX6 SabreSD. (Kernel v4.14)

• Samsung Artik710. (FunctionFS mode)

Client operating systems successfully tested

• Windows 7, Windows 10, Linux.

How to build it ?

A simple "make" should be enough. If you are using a cross-compile environment, set the "CC" variable to your GCC cross compiler.

How to set it up ?

A config file should copied into the folder /etc/umtprd/umtprd.conf This file defines the storage entries (host path and name), the MTP device name, the USB vendor & product IDs and the USB device configuration. Check the file umtprd.conf file for details on available options.

How to launch it ?

Once you have configured the correct settings in umtprd.conf, you can use umtprd_ffs.sh or umtprd_gfs.sh to launch it in FunctionFS/GadgetFS mode or use udev to launch the deamon when the usb device port is connected.

License

This project is licensed under the GNU General Public License version 3 - see the LICENSE file for details