Linux USB mtp
USB mtp 介绍
https://en.wikipedia.org/wiki/Media_Transfer_Protocol
from wiki:
MTP是一种高水平的文件传输协议，与通用串行总线大容量存储等通用存储协议相反。这意味着MTP客户端（计算机）看不到构成文件系统的数据结构的字节块数组，而是用文件和文件夹来表示MTP设备。这使得MTP设备可以参与高水平的操作（如更新其元信息索引），同时将文件系统的完整性掌握在自己手中。特别是，掉线传输（例如过早拔掉USB电缆）不会损坏设备文件系统。[6]MTP的非通用性会影响计算机操作系统如何向其他程序和用户呈现MTP设备。
根据其规范，MTP的
- 主要目的是促进具有瞬态连接的媒体设备之间的通信。[5]
- 第二个目的是启用对连接设备的命令和控制。[5]电池供电的移动设备可以通过MTP报告其电池电量水平。[6]
该协议最初是为跨USB使用而实现的，但扩展为跨TCP/IP和蓝牙使用。Windows Vista支持TCP/IP上的MTP。带有Windows Vista平台更新的Windows 7和Windows Vista也支持蓝牙上的MTP。[7]连接到MTP设备的主机称为MTP启动器，而设备本身是MTP响应器。[8]
还是 wiki 介绍得更好，其他的随便看看
https://www.cnblogs.com/skywang12345/p/3474206.html
https://wowothink.com/ffcaead/
1、UMS：USB mass storage，USB大容量存储，也被称为UMS，USB MSC。在旧版Android手机上会将其暴露给计算机，有如下几种缺点：
- USB mass storage是flash driver，外部hd，SD卡和其他USB存储设备使用的标准协议。驱动器使其自身完全对计算机可见，就像它是内部驱动器一样；
- 这种方式存在问题。无论什么设备访问存储，都需要对其进行独占访问。将存储连接到计算机时，它与设备上运行的Android操作系统断开连接。存储在SD卡或USB存储器上的任何文件或应用程序在连接到计算机时都将不可用，此时是计算机独占；
- 由于必须可以从Windows设备访问文件系统，因此必须使用FAT文件系统对其进行格式化。 微软不仅拥有对FAT施加的专利，而且FAT也是一个较旧的，较慢的文件系统，没有现代许可系统。
2、MTP：Media Transfer Protocol，媒体传输协议，主要用于传输媒体文件，当Android使用该协议，将其连接到电脑上，会显示一个媒体设备。该协议与USB mass storage的工作方式非常不同。
- MTP不会将Android设备的原始文件系统暴露给Windows，而是在文件级别运行；
- Android设备不会将其整个存储设备暴露给Windows。 相反，当将设备连接到计算机时，计算机将查询设备，并且设备会响应其提供的文件和目录列表。
- Android可以选择它呈现出来的文件，并隐藏系统文件，以便其他人无法查看或修改它们。 如果尝试删除或编辑无法修改的文件，设备将拒绝该请求，将会看到错误消息。
- 计算机不需要对存储设备进行独占访问，因此无需连接存储，断开连接或为不同类型的数据分别设置分区。Android也可以使用它想要的ext4或任何其他文件系统，但Windows不必了解该文件系统。
- 在实践中，MTP的功能很像USB mass storage。 例如，MTP设备显示在Windows资源管理器中，因此您可以浏览和传输文件。
libmtp 库
https://github.com/libmtp/libmtp
Initiator and Responder
libmtp implements an MTP initiator, which means it initiate
MTP sessions with devices. The devices responding are known
as MTP responders. libmtp runs on something with a USB host
controller interface, using libusb to access the host
controller.
If you’re more interested in the MTP responders, gadgets like
MP3 players, mobile phones etc, look into:
- MeeGo:s Buteo Sync:
https://github.com/nemomobile/buteo-mtp
https://wiki.merproject.org/wiki/Buteo/MTP - Android has an MTP responder implementation:
https://android.googlesource.com/platform/frameworks/base/+/master/media/jni/ - Ubuntu/Ricardo Salveti has mtp-server and libmtp-server going:
https://code.launchpad.net/~phablet-team/mtp/trunk
https://bazaar.launchpad.net/~phablet-team/mtp/trunk/files
明显，libmtp 是主机端用的库，
umtprd
buildroot 编译 umtprd 工具，类似于 adbd 的作用。
1 | # mtp tools |
configfs 配置 mtp 流程
0. 切换为 device 模式
1 | echo device >/proc/cviusb/otg_role |
1. 挂载 configfs
注册了一个名为usb_gadget的configfs子系统。
1 | mkdir -p /tmp/usb |
2
3
4
5
>/tmp/usb/
>└── usb_gadget
>1 directory, 0 files
2. 创建复合设备
mkdir usb_gadget/cvitek 创建名为 cvitek 的usb复合设备。
1 | mkdir -p /tmp/usb/usb_gadget/cvitek |
在 cvitek 目录下会创建很多属性，
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
.
└── cvitek
├── UDC
├── bDeviceClass
├── bDeviceProtocol
├── bDeviceSubClass
├── bMaxPacketSize0
├── bcdDevice
├── bcdUSB
├── configs
├── functions
├── idProduct
├── idVendor
├── max_speed
├── os_desc
│ ├── b_vendor_code
│ ├── qw_sign
│ └── use
└── strings
5 directories, 13 files
2.1 配置PID和VID
1 | echo 0x3346 >/tmp/usb/usb_gadget/cvitek/idVendor |
2.2 创建并配置 strings 子目录
配置 strings 首先必须设置language，这里设置为0x0409表示使用的是en-us语言。
1 | # Set the product information string |
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
>.
>└── cvitek
├── UDC
├── bDeviceClass
├── bDeviceProtocol
├── bDeviceSubClass
├── bMaxPacketSize0
├── bcdDevice
├── bcdUSB
├── configs
├── functions
├── idProduct
├── idVendor
├── max_speed
├── os_desc
│ ├── b_vendor_code
│ ├── qw_sign
│ └── use
└── strings
└── 0x409
├── manufacturer
├── product
└── serialnumber
>6 directories, 16 files
2.3 创建configuration和字符串
创建配置 c.1
1 | mkdir /tmp/usb/usb_gadget/cvitek/configs/c.1 |
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
.
└── cvitek
├── UDC
├── bDeviceClass
├── bDeviceProtocol
├── bDeviceSubClass
├── bMaxPacketSize0
├── bcdDevice
├── bcdUSB
├── configs
│ └── c.1
│ ├── MaxPower
│ ├── bmAttributes
│ └── strings
├── functions
├── idProduct
├── idVendor
├── max_speed
├── os_desc
│ ├── b_vendor_code
│ ├── qw_sign
│ └── use
└── strings
└── 0x409
├── manufacturer
├── product
└── serialnumber
8 directories, 18 files
设置配置名。
1 | mkdir /tmp/usb/usb_gadget/cvitek/configs/c.1/strings/0x409 |
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
.
└── cvitek
├── UDC
├── bDeviceClass
├── bDeviceProtocol
├── bDeviceSubClass
├── bMaxPacketSize0
├── bcdDevice
├── bcdUSB
├── configs
│ └── c.1
│ ├── MaxPower
│ ├── bmAttributes
│ └── strings
│ └── 0x409
│ └── configuration
├── functions
├── idProduct
├── idVendor
├── max_speed
├── os_desc
│ ├── b_vendor_code
│ ├── qw_sign
│ └── use
└── strings
└── 0x409
├── manufacturer
├── product
└── serialnumber
9 directories, 19 files
Set the MaxPower of USB descriptor
1 | echo 120 >/tmp/usb/usb_gadget/cvitek/configs/c.1/MaxPower |
3. 创建functions
一个USB复合设备会有多个功能，每个功能由function来表示，所谓的function就是USB设备支持的功能。当执行mkdir functions/mass_storage.0的时候，会调用function_make()函数，调用usb_get_function_instance()函数传入mass_storage字段，将会从现有的function list中找到与之匹配的function。现有的function list是由drivers/usb/gadget/function/f_xxx.c中进行添加的，这就将f_xxx.c联系起来了。
3.1 创建 mtp functions
1 | mkdir /tmp/usb/usb_gadget/cvitek/functions/mtp.usb0 |
内核还没开启相应配置的，就会报错。USB_CONFIGFS_F_MTP=y
1 | [root@sg200x]/tmp/usb/usb_gadget# mkdir /tmp/usb/usb_gadget/cvitek/functions/mtp |
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
.
└── cvitek
├── UDC
├── bDeviceClass
├── bDeviceProtocol
├── bDeviceSubClass
├── bMaxPacketSize0
├── bcdDevice
├── bcdUSB
├── configs
│ └── c.1
│ ├── MaxPower
│ ├── bmAttributes
│ └── strings
│ └── 0x409
│ └── configuration
├── functions
│ └── mtp.usb0
├── idProduct
├── idVendor
├── max_speed
├── os_desc
│ ├── b_vendor_code
│ ├── qw_sign
│ └── use
└── strings
└── 0x409
├── manufacturer
├── product
└── serialnumber
10 directories, 19 files
4. 将func和config关联起来
执行ln -s usb_gadget/cvitek/functions/mtp.usb0 usb_gadget/cvitek/configs/c.1命令将新添加的mtp的functions添加到configuration对应的function list中，表示当前usb复合设备中新增了一个function。这时候调用的是config_usb_cfg_link()函数。至此，functions和configuration关联起来了。接下来要将configuration与特定的UDC设备连接起来。
1 | ln -s /tmp/usb/usb_gadget/cvitek/functions/mtp.usb0 /tmp/usb/usb_gadget/cvitek/configs/c.1 |
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
.
└── cvitek
├── UDC
├── bDeviceClass
├── bDeviceProtocol
├── bDeviceSubClass
├── bMaxPacketSize0
├── bcdDevice
├── bcdUSB
├── configs
│ └── c.1
│ ├── MaxPower
│ ├── bmAttributes
│ ├── mtp.usb0 -> ../../../../usb_gadget/cvitek/functions/mtp.usb0
│ └── strings
│ └── 0x409
│ └── configuration
├── functions
│ └── mtp.usb0
├── idProduct
├── idVendor
├── max_speed
├── os_desc
│ ├── b_vendor_code
│ ├── qw_sign
│ └── use
└── strings
└── 0x409
├── manufacturer
├── product
└── serialnumber
11 directories, 19 files
5. 绑定到UDC，使能gadget
执行echo xxx > usb_gadget/g1/UDC命令，就会调用gadget_dev_desc_UDC_store()函数，这里面调用usb composite framework中的usb_gadget_probe_driver()函数将gadget driver与USB Controller Driver绑定，这里的Gadget Driver就是与我们创建的usb复合设备对应的驱动，接下来就会走一系列的bind流程。
1 | # Start the gadget driver |
汇总
1 | # 0. 切换为 device 模式 |
umptrd 源码
https://github.com/viveris/uMTP-Responder/tree/master/conf
官方提供了一个配置脚本。
1 |
|
1 | mount -t functionfs mtp /dev/ffs-umtp |
CONFIG_USB_FUNCTIONFS=y 可解决上面的问题。
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 (╯°□°）╯︵ ┻━┻ ！
相关推荐
2024-09-22
Linux USB gadget_configfs
Linux USB gadget 通过 configfs 配置 先阅读 Linux configfs，再看此内容 usb 只有在作为从设备时，才会用到 configfs 去配置功能。 更新日期：2013年4月25日 概述USB Linux Gadget 是一种设备，它具有一个 UDC（USB 设备控制器），并且可以连接到 USB 主机，通过添加功能扩展主机，如串行端口或大容量存储功能。 123A USB Linux Gadget is a device which has a UDC (USB Device Controller)and can be connected to a USB Host to extend it with additional functionslike a serial port or a mass storage capability. 从主机的角度来看，一个 Gadget 是一组配置的集合，每个配置包含若干接口，而从 Gadget 的角度看，这些接口被称为功能（function），每个功能代表一个如串行连接或 SCSI...
2024-09-22
Linux USB functionfs
translate from https://www.kernel.org/doc/html/v6.1/usb/functionfs.html FunctionFS 如何工作从内核的角度来看，它只是一个具有一些独特行为的复合功能。只有在用户空间驱动程序通过写入描述符和字符串注册后，它才能被添加到 USB 配置中（用户空间程序必须提供与内核级复合功能在添加到配置中时提供的相同信息）。 123456From kernel point of view it is just a composite function with someunique behaviour. It may be added to an USB configuration only afterthe user space driver has registered by writing descriptors andstrings (the user space program has to provide the same informationthat kernel level composite...
2024-09-01
Linux USB 驱动框架
depends on: bus 通用知识 uevent 机制 字符设备 USB 驱动框架很典型的Linux 驱动框架，分 核心层：完成通用功能。 设备驱动层 PDD（实现特定功能，比如 UVC， UAC， HID 这些类型的设备驱动） 控制器驱动 HCD（配置寄存器去操作硬件USB IP，完成数据收发）类似与网络中的数据链路层，只负责数据收发。 image from paper 这段 USB Driver Architecture 讲得很好。 USB (Universal Serial Bus) 17) is one of the sophisticated peripheral interfaces based on the recent hardware progress. In the USB 2.0 specification announced in April 2000, a host computer controls various USB devices with 3 transfer speeds (1.5 Mbps, 12.0 Mbps,...
2022-09-19
C++三方库
fmt格式化字符串，好像已经纳入C++20标准库，使用很方便！而且说是比printf还快~ 12345678910git clone --depth=1 https://github.com/fmtlib/fmt.gitcd fmt/mkdir buildcd buildcmake ..make -jsudo make install# g++ test.cpp -o debug -lfmt github 仓库，README中文档也较详细、使用简单 官方文档、有代码示例 fmtlog基于fmt的日志库，可以很方便的以fmt的方式格式化日志输出。 12345678git clone https://github.com/MengRao/fmtlog.gitcd fmtloggit submodule initgit submodule update./build.sh# g++ test.cpp -o debug -lfmt -lfmtlog-static #...
2024-10-06
Cvitek SDK 编译环境
SDK 下载利用 sophpi 中的脚本下载 SDK 到当前目录。 1git clone -b sg200x-evb git@github.com:sophgo/sophpi.git sophpi 中的脚本是将需要的仓库拉取到当前目录，为了区分，专门新建 v4.1.x 目录： 123mkdir v4.1.x && cd v4.1.x../sophpi/scripts/repo_clone.sh --gitclone ../sophpi/scripts/subtree.xml 如需使用双系统快启分支，则： 123mkdir v4.2.x && cd v4.2.x../sophpi/scripts/repo_clone.sh --gitclone ../sophpi/scripts/subtree_cv18xx-v4.2.x.xml 🙃可能遇到的问题： 没有权限拉取仓库。sophpi 的脚本中是用的 git clone ssh@xxx 走的 ssh，需要配置好 ssh key，否则会报错。可以替换 xml 中的...
2023-11-16
buildroot 打包 rootfs
Cvitek buildroot 打包 rootfs 流程介绍 基于 https://github.com/sophgo/cvi_mmf_sdk/tree/v4.1.0 的实现。 概述在 cvi_mmf_sdk 中，支持两种生成 rootfs 的方式： 基于 ramdisk 目录下的文件系统。 基于 buildroot 打包生成文件系统。 前者仅保留了常用的一些工具，因此生成的文件系统较小，不过新增工具比较麻烦。后者方便用户自己控制需要打包哪些工具。 默认使用第一种方式来生成文件系统，可通过在板子的配置文件中加上 CONFIG_BUILDROOT_FS=y （如 cv1812cp_sophpi_duo_sd_defconfig#L30 中的例子），以启用 buildroot 来生成文件系统。 rootfs 打包流程说明在 source cvisetup.sh 之后，就可以使用 pack_rootfs 命令来打包文件系统了。它本质上是定义在 common_functions.sh 中的一个 shell 函数，在设置必要的环境变量后，通过 make...
评论
