DJI `2ca3:8004` — id_table 匹配与枚举路径

环境：eCos USB Host（CSKY）· 大疆 Osmo Action 6（VID:PID = 0x2ca3:0x8004）· 对照 Linux uvcvideo / snd-usb-audio 的 id_table（非同一运行环境）
关联：USB 2.0 枚举流程 · 枚举与 Probe · UVC 驱动分析
附件：USB 描述符 dump（Linux lsusb -v，2ca3:8004）
状态：进行中（根因：UAC2 AC HEADER 按 UAC1 解析）

1. 现象与背景

在 eCos USB Host（CSKY）上接入大疆 Osmo Action 6（VID:PID = 0x2ca3:0x8004），配置为 UVC + UAC2 复合设备（DIAG_UAC2_UVC，5 个接口）。目标是主机侧正常枚举并出现 /dev/video0（UVC）；绿联 1d6b:0102 等 UVC 设备在 eCos 上已可用，可作对照。

实际：8004 模式下接口描述符可读，但 接口 1 绑定 snd-usb-audio 后报 invalid HEADER（按 UAC1 解析 UAC2 AC 头）。usb_set_configuration 按接口 0→4 顺序 device_add；接口 1 的 probe 阻塞或失败后，接口 2～4 可能无法继续，UVC（接口 3 / 4）起不来。

本文对照 Linux uvc_ids[] / usb_audio_ids[] 说明各接口能否 match，并结合 eCos 日志与调用栈区分「描述符已解析」与「驱动未 probe」。标准描述符见 dji_descriptor.txt；下文含 2ca3:0025 vendor 模式与 8004 正常模式两轮实测摘要。

2. 设备概要

项	值
VID:PID	`0x2ca3:0x8004`
产品	OsmoAction6
配置	`DIAG_UAC2_UVC`，5 个接口（接口 0～4，`bInterfaceNumber`）
整机 `bDeviceClass`	239（Misc），非 `0xFF` → 可按接口类正常 match

说明：两张表里都没有 2ca3:8004 专用条目，靠通用类匹配项。eCos 日志 adding 1-2:1.x 末位 x 即接口号（如 1-2:1.1 → 接口 1）。

3. 接口描述符：标准预期与 eCos 两轮实测

接入后 eCos 上会先枚举 2ca3:0025（vendor，wTotalLength=124），断开再以 2ca3:8004 进入 DIAG_UAC2_UVC（wTotalLength=639）。Linux 侧标准值见 dji_descriptor.txt。

轮次	VID:PID	配置	类 / 子类 / 协议（接口 0～4）
第 1 次	`2ca3:0025`	124 B，5 接口	`255/255/48`；`255/67/1`×4
第 2 次	`2ca3:8004`	639 B，5 接口	`255/255/48`；`1/1/32`；`1/2/32`；`14/1/0`；`14/2/0`

各接口 bInterfaceClass / SubClass / Protocol（ifdesc raw）：

接口	预期 (Linux)	标准含义	第 1 轮 `0025`	第 2 轮 `8004`
0	255 / 255 / 48	厂商 DIAG（bulk）	255 / 255 / 48	255 / 255 / 48
1	1 / 1 / 32	UAC2 Audio Control（`bcdADC 2.00`）	255 / 67 / 1	1 / 1 / 32
2	1 / 2 / 32	UAC2 Audio Streaming	255 / 67 / 1	1 / 2 / 32
3	14 / 1 / 0	UVC Video Control（`bcdUVC 1.50`）	255 / 67 / 1	14 / 1 / 0
4	14 / 2 / 0	UVC Video Streaming	255 / 67 / 1	14 / 2 / 0

4. 视频：uvc_ids 与 uvcvideo

4.1 表内相关通用项（表尾）

/* Generic USB Video Class */
{ USB_INTERFACE_INFO(USB_CLASS_VIDEO, 1, UVC_PC_PROTOCOL_UNDEFINED) },  /* pr=0 */
{ USB_INTERFACE_INFO(USB_CLASS_VIDEO, 1, UVC_PC_PROTOCOL_15) },         /* pr=1 */

USB_INTERFACE_INFO(USB_CLASS_VIDEO, 1, UVC_PC_PROTOCOL_UNDEFINED) 展开为：

#define USB_DEVICE_ID_MATCH_INT_INFO \
	(USB_DEVICE_ID_MATCH_INT_CLASS | USB_DEVICE_ID_MATCH_INT_SUBCLASS | \
	 USB_DEVICE_ID_MATCH_INT_PROTOCOL)   /* 0x0080 | 0x0100 | 0x0200 = 0x0300 */

{
	.match_flags        = USB_DEVICE_ID_MATCH_INT_INFO,  /* 0x0300 */
	.bInterfaceClass    = 0x0e,
	.bInterfaceSubClass = 0x01,
	.bInterfaceProtocol = 0x00,
},

等价条件：

字段	值
`bInterfaceClass`	14（`USB_CLASS_VIDEO`）
`bInterfaceSubClass`	1（Video Control）
`bInterfaceProtocol`	见下表

4.2 接口是否 match

接口	描述符	是否 match `uvc_ids`	命中表项（`usb_match_id` 从前向后）
3	14 / 1 / 0	是	`USB_INTERFACE_INFO(14, 1, 0)`（`UVC_PC_PROTOCOL_UNDEFINED`）
4	14 / 2 / 0	否	表项要求 SubClass=1；流接口为 SubClass=2
0 / 1 / 2	非 Video	否	—

5. 音频：usb_audio_ids 与 snd-usb-audio

5.1 表内唯一有效项

static struct usb_device_id usb_audio_ids[] = {
	{ .match_flags = (USB_DEVICE_ID_MATCH_INT_CLASS | USB_DEVICE_ID_MATCH_INT_SUBCLASS),
	  .bInterfaceClass = USB_CLASS_AUDIO,              /* 1 */
	  .bInterfaceSubClass = USB_SUBCLASS_AUDIO_CONTROL }, /* 1 */
	{ }  /* 结束 */
};

不检查 bInterfaceProtocol，故 Protocol=32（UAC2）不影响 match。

5.2 接口是否 match

接口	描述符	是否 match `usb_audio_ids`	说明
1	1 / 1 / 32	是	唯一会绑 `snd-usb-audio` 的接口
2	1 / 2 / 32	否	SubClass=2（Streaming），表项要求 SubClass=1
0 / 3 / 4	非 Audio Control	否	—

6. 调用栈：配置描述符解析

text

hub 端口枚举完成
  └─ usb_new_device(udev)                         [hub.c]
       ├─ usb_get_configuration(udev)              [config.c]
       │    ├─ usb_get_descriptor(USB_DT_CONFIG)  // 读 wTotalLength 整包配置描述符
       │    └─ usb_parse_configuration()           [config.c]
       │         ├─ 扫描 USB_DT_INTERFACE，统计各 interface 的 alt 数
       │         └─ while (size > 0)
       │              └─ usb_parse_interface()     [config.c]
       │                   └─ memcpy → alt->desc     // bInterfaceClass/SubClass/Protocol
       │                        （日志 ifdesc raw 在此打印）
       │                   // 结果缓存在 dev->config[cfg].intf_cache[]
       │
       └─ device_add(&udev->dev)                   [hub.c] → [core.c]
            └─ bus_attach_device()                 [bus.c]
                 └─ device_attach()                [dd.c]
                      └─ bus_for_each_drv → driver_probe_device
                           └─ usb_device_match → really_probe
                                └─ usb_probe_device()      [driver.c] 设备级
                                     └─ generic_probe()    [generic.c]
                                          ├─ choose_configuration(udev)
                                          └─ usb_set_configuration(udev, c)  [message.c]
                                               ├─ usb_control_msg(SET_CONFIGURATION)
                                               ├─ 从 actconfig->intf_cache[] 填
                                               │    intf->cur_altsetting（已解析的 ifdesc）
                                               ├─ usb_enable_interface()
                                               └─ for (i = 0; i < nintf; i++)
                                                    ├─ dev_dbg("adding %s")   // 日志如 adding 1-2:1.x，x=接口号
                                                    └─ device_add(&intf->dev) [message.c]
                                                         └─ bus_attach_device() …（见 §7）

要点：

接口的类 / 子类 / 协议（bInterfaceClass 等）在第一次 usb_get_configuration 里解析，写入 alt->desc；与后面是否 uvc_probe 无关。
adding 日志出现在 usb_set_configuration 的接口 device_add（按接口 0→4），之前还有一次整机 device_add(&udev->dev) 触发 generic_probe → set_configuration。
intf->cur_altsetting->desc 即 usb_match_id / uvc_ids / usb_audio_ids 所用字段。

7. 调用栈：接口 device_add 与驱动 probe

text

device_add(&intf->dev)                            [message.c] → [core.c]
  └─ bus_attach_device()                          [bus.c]
       └─ device_attach()                         [dd.c]
            └─ bus_for_each_drv(usb_bus_type)
                 └─ __driver_attach()
                      ├─ down(parent->sem)
                      ├─ if (!dev->driver)
                      │     └─ driver_probe_device(drv, dev)   [dd.c]
                      │          ├─ usb_device_match(dev, drv)   [driver.c]
                      │          │    └─ usb_match_id() → usb_match_one_id()
                      │          └─ really_probe()               // match 成功才进
                      │               └─ usb_probe_interface()   [driver.c]
                      │                    └─ driver->probe()    // uvc_probe / usb_audio_probe
                      └─ up(parent->sem)

8. 排查备忘

Osmo Action 6 在 eCos 上会先以 2ca3:0025（wTotalLength=124，各接口均为 vendor 类/子类/协议）枚举一轮并断开，再以 2ca3:8004（639 B，DIAG_UAC2_UVC）进入 UAC2/UVC 正常类/子类/协议；第 2 轮描述符与 §3 一致，但 接口 1 的 usb_audio_probe 报 invalid HEADER（UAC2 头按 UAC1 解析），可能阻塞接口 2～4 的 probe，导致接口 3 走不到 uvc_probe。日志里务必用 VID:PID / wTotalLength 区分两轮。沿 §6、§7 建议在下列函数加打印：

函数	文件	建议打印
`usb_new_device`	`hub.c`	`idVendor:idProduct`、`devnum`
`usb_get_descriptor`（CONFIG）	`config.c`	`wTotalLength`
`usb_parse_interface`	`config.c`	`ifnum`、`bInterfaceClass/SubClass/Protocol`（`ifdesc raw`）
`choose_configuration`	`generic.c`	选中的 `bConfigurationValue`
`usb_set_configuration`	`message.c`	`adding %s`、`ifnum`
`device_add`（接口）	`message.c`	`ifnum` 进入/返回
`usb_match_one_id`	`driver.c`	类/子类/协议、命中的 `driver->name`
`usb_probe_interface`	`driver.c`	`driver->name`、`intf`、返回值
`usb_audio_probe` / `uvc_probe`	驱动	`invalid HEADER` 前后、返回码

USB

Pinctrl / GPIO

DJI `2ca3:8004` — id_table 匹配与枚举路径

目录

1. 现象与背景

2. 设备概要

3. 接口描述符：标准预期与 eCos 两轮实测

4. 视频：uvc_ids 与 uvcvideo

4.1 表内相关通用项（表尾）

4.2 接口是否 match

5. 音频：usb_audio_ids 与 snd-usb-audio

5.1 表内唯一有效项

5.2 接口是否 match

6. 调用栈：配置描述符解析

7. 调用栈：接口 device_add 与驱动 probe

8. 排查备忘

DJI 2ca3:8004 — id_table 匹配与枚举路径 ​

目录 ​

1. 现象与背景 ​

2. 设备概要 ​

3. 接口描述符：标准预期与 eCos 两轮实测 ​

4. 视频：uvc_ids 与 uvcvideo ​

4.1 表内相关通用项（表尾） ​

4.2 接口是否 match ​

5. 音频：usb_audio_ids 与 snd-usb-audio ​

5.1 表内唯一有效项 ​

5.2 接口是否 match ​

6. 调用栈：配置描述符解析 ​

7. 调用栈：接口 device_add 与驱动 probe ​

8. 排查备忘 ​

DJI `2ca3:8004` — id_table 匹配与枚举路径

目录

1. 现象与背景

2. 设备概要

3. 接口描述符：标准预期与 eCos 两轮实测

4. 视频：uvc_ids 与 uvcvideo

4.1 表内相关通用项（表尾）

4.2 接口是否 match

5. 音频：usb_audio_ids 与 snd-usb-audio

5.1 表内唯一有效项

5.2 接口是否 match

6. 调用栈：配置描述符解析

7. 调用栈：接口 device_add 与驱动 probe

8. 排查备忘