1. ADB 框架

ADB 全稱為"Android Debug Bridge"，Android 調試橋。在純 Linux 系統中也可以使用。它是 client-server 架構，由三部分組成：

• adbclient：我們運行的 adb 命令就屬于 adbclient，比如我們運行以下命令adb push d:1.txt /root時，它就是一個 adbclient，它通過 adbserver 把windows 下的文件 "d:1.txt" 推送到開發板的 /root 目錄
• adbserver：作為一個后臺程序運行運行于 PC，它負責管理 PC 和開發板之間的通信，完成 adbclient 的請求
• adbd：運行于開發板的守護進程，它通過底下的 Gadget 跟 adbserver 通信

實際上，adbclient 和 adbserver 都是同一個應用程序：比如 Windows 下的 adb.exe，使用不同的參數來啟動時就可以作為 adbclient 或者 adbserver。我們第 1 次執行 adb 命令時，它會幫我們啟動一個 adb 程序作為 adbserver。

2. 體驗ADB

2.1 在 Windows 安裝軟件

解壓 GIT 倉庫如下文件：

確認里面的 adb.exe 所在目錄，把這個目錄添加進 Windows 的 Path 環境變量里。

2.2 在 STM32MP157 上實驗

STM32MP157 的出廠系統已經安裝好了 adbd，可以直接連接 USB 線進行測試。

比如在 Windows 上執行命令：

adb  devices  # 列出adb設備
adb  push  d:1.txt  /root  # 上傳文件到開發板/root目錄
adb  shell   # 啟動adb命令行

IMX6ULL 的出廠系統還沒安裝 adbd，等移植 ADB 時再進行實驗。

3. functionfs

我們關注的是 Gadget 部分：

使用 legacy 的方法時，我們需要在驅動程序里指定設備信息（比如設備描述符、配置描述符等等），還需要在驅動程序里實現數據的傳輸功能，這都在驅動程序里限定死了。

使用 configfs 時，我們可以靈活地指定設備信息、靈活地選擇各種 function。但是，還不夠靈活：你必須選擇某個 function，這個 function 里已經實現實現了數據的傳輸功能，你無法更改。

我們能否把 Gadget 設備的端點暴露給用戶程序？讓用戶程序自己操作端點來傳輸數據？可以！這就是 functionfs。

functionfs 是一種文件系統，它的使用分為兩步：

• 內核態：注冊 functionfs
• 用戶態：掛載 functionfs

抓住這兩點來分析代碼。

3.1 注冊 functionfs

以 legacy 的方式來分析，只要安裝 g_ffs.ko 驅動程序：

insmod g_ffs.ko

就會觸發以下調用過程：

# driversusbgadgetlegacyg_ffs.c
gfs_init
 usb_get_function_instance("ffs");
  try_get_usb_function_instance
   fi = fd- >alloc_inst();
    # driversusbgadgetfunctionf_fs.c
    ffs_alloc_inst
     dev = _ffs_alloc_dev();
      ret = functionfs_init();
       ret = register_filesystem(&ffs_fs_type);

使用 configfs 方式的話，需要執行以下命令：

modprobe libcomposite
mount -t configfs none /sys/kernel/config

mkdir -p /sys/kernel/config/usb_gadget/g1
mkdir  -p /sys/kernel/config/usb_gadget/g1/functions/ffs.adb

可以看到提示信息：

執行命令cat /proc/filesystems可以看到 functionfs。

3.2 掛載 functionfs

這時就可以掛載 functionfs 了，執行如下命令：

# mkdir -p /dev/usb-ffs/adb
# mount -t functionfs adb /dev/usb-ffs/adb  # 上面創建了 functions/ffs.adb, 掛載時 dev 就要指定為 adb
# ls /dev/usb-ffs/adb/
ep0

有了 ep0 端點后，用戶態程序就可以通過它跟主機通信了。

3.3 ep0 的驅動程序

ep0 對應的驅動程序，分析如下：

• 掛載 functionfs 時，會導致一個函數被調用：

• ffs_sb_fill 中，會在 functionfs 的根目錄下創建名為 ep0 的文件，并給它提供file_operations 結構體：