요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
USB drivers
4
===========
6
The USB boards are identified by an identification called USB ID.
8
The ``lsusb`` command allows identifying the USB IDs::
10
$ lsusb
11
...
12
Bus 001 Device 015: ID 046d:082d Logitech, Inc. HD Pro Webcam C920
13
Bus 001 Device 074: ID 2040:b131 Hauppauge
14
Bus 001 Device 075: ID 2013:024f PCTV Systems nanoStick T2 290e
15
...
17
Newer camera devices use a standard way to expose themselves as such,
18
via USB Video Class. Those cameras are automatically supported by the
19
``uvc-driver``.
21
Older cameras and TV USB devices uses USB Vendor Classes: each vendor
22
defines its own way to access the device. This section contains
23
card lists for such vendor-class devices.
25
While this is not as common as on PCI, sometimes the same USB ID is used
26
by different products. So, several media drivers allow passing a ``card=``
27
parameter, in order to setup a card number that would match the correct
28
settings for an specific product type.
30
The current supported USB cards (not including staging drivers) are
31
listed below\ [#]_.
33
.. [#]
35
some of the drivers have sub-drivers, not shown at this table.
36
In particular, gspca driver has lots of sub-drivers,
37
for cameras not supported by the USB Video Class (UVC) driver,
38
as shown at :doc:`gspca card list <gspca-cardlist>`.
40
====================== =========================================================
41
Driver Name
42
====================== =========================================================
43
airspy AirSpy
44
au0828 Auvitek AU0828
45
b2c2-flexcop-usb Technisat/B2C2 Air/Sky/Cable2PC USB
46
cx231xx Conexant cx231xx USB video capture
47
dvb-as102 Abilis AS102 DVB receiver
48
dvb-ttusb-budget Technotrend/Hauppauge Nova - USB devices
49
dvb-usb-a800 AVerMedia AverTV DVB-T USB 2.0 (A800)
50
dvb-usb-af9005 Afatech AF9005 DVB-T USB1.1
51
dvb-usb-af9015 Afatech AF9015 DVB-T USB2.0
52
dvb-usb-af9035 Afatech AF9035 DVB-T USB2.0
53
dvb-usb-anysee Anysee DVB-T/C USB2.0
54
dvb-usb-au6610 Alcor Micro AU6610 USB2.0
55
dvb-usb-az6007 AzureWave 6007 and clones DVB-T/C USB2.0
56
dvb-usb-az6027 Azurewave DVB-S/S2 USB2.0 AZ6027
57
dvb-usb-ce6230 Intel CE6230 DVB-T USB2.0
58
dvb-usb-cinergyT2 Terratec CinergyT2/qanu USB 2.0 DVB-T
59
dvb-usb-cxusb Conexant USB2.0 hybrid
60
dvb-usb-dib0700 DiBcom DiB0700
61
dvb-usb-dibusb-common DiBcom DiB3000M-B
62
dvb-usb-dibusb-mc DiBcom DiB3000M-C/P
63
dvb-usb-digitv Nebula Electronics uDigiTV DVB-T USB2.0
64
dvb-usb-dtt200u WideView WT-200U and WT-220U (pen) DVB-T
65
dvb-usb-dtv5100 AME DTV-5100 USB2.0 DVB-T
66
dvb-usb-dvbsky DVBSky USB
67
dvb-usb-dw2102 DvbWorld & TeVii DVB-S/S2 USB2.0
68
dvb-usb-ec168 E3C EC168 DVB-T USB2.0
69
dvb-usb-gl861 Genesys Logic GL861 USB2.0
70
dvb-usb-gp8psk GENPIX 8PSK->USB module
71
dvb-usb-lmedm04 LME DM04/QQBOX DVB-S USB2.0
72
dvb-usb-m920x Uli m920x DVB-T USB2.0
73
dvb-usb-nova-t-usb2 Hauppauge WinTV-NOVA-T usb2 DVB-T USB2.0
74
dvb-usb-opera Opera1 DVB-S USB2.0 receiver
75
dvb-usb-pctv452e Pinnacle PCTV HDTV Pro USB device/TT Connect S2-3600
76
dvb-usb-rtl28xxu Realtek RTL28xxU DVB USB
77
dvb-usb-technisat-usb2 Technisat DVB-S/S2 USB2.0
78
dvb-usb-ttusb2 Pinnacle 400e DVB-S USB2.0
79
dvb-usb-umt-010 HanfTek UMT-010 DVB-T USB2.0
80
dvb_usb_v2 Support for various USB DVB devices v2
81
dvb-usb-vp702x TwinhanDTV StarBox and clones DVB-S USB2.0
82
dvb-usb-vp7045 TwinhanDTV Alpha/MagicBoxII, DNTV tinyUSB2, Beetle USB2.0
83
em28xx Empia EM28xx USB devices
84
go7007 WIS GO7007 MPEG encoder
85
gspca Drivers for several USB Cameras
86
hackrf HackRF
87
hdpvr Hauppauge HD PVR
88
msi2500 Mirics MSi2500
89
mxl111sf-tuner MxL111SF DTV USB2.0
90
pvrusb2 Hauppauge WinTV-PVR USB2
91
pwc USB Philips Cameras
92
s2250 Sensoray 2250/2251
93
s2255drv USB Sensoray 2255 video capture device
94
smsusb Siano SMS1xxx based MDTV receiver
95
ttusb_dec Technotrend/Hauppauge USB DEC devices
96
usbtv USBTV007 video capture
97
uvcvideo USB Video Class (UVC)
98
zd1301 ZyDAS ZD1301
99
====================== =========================================================
101
.. toctree::
102
:maxdepth: 1
104
au0828-cardlist
105
cx231xx-cardlist
106
em28xx-cardlist
107
siano-cardlist
109
gspca-cardlist
111
dvb-usb-dib0700-cardlist
112
dvb-usb-dibusb-mb-cardlist
113
dvb-usb-dibusb-mc-cardlist
115
dvb-usb-a800-cardlist
116
dvb-usb-af9005-cardlist
117
dvb-usb-az6027-cardlist
118
dvb-usb-cinergyT2-cardlist
119
dvb-usb-cxusb-cardlist
120
dvb-usb-digitv-cardlist
121
dvb-usb-dtt200u-cardlist
122
dvb-usb-dtv5100-cardlist
123
dvb-usb-dw2102-cardlist
124
dvb-usb-gp8psk-cardlist
125
dvb-usb-m920x-cardlist
126
dvb-usb-nova-t-usb2-cardlist
127
dvb-usb-opera1-cardlist
128
dvb-usb-pctv452e-cardlist
129
dvb-usb-technisat-usb2-cardlist
130
dvb-usb-ttusb2-cardlist
131
dvb-usb-umt-010-cardlist
132
dvb-usb-vp702x-cardlist
133
dvb-usb-vp7045-cardlist
135
dvb-usb-af9015-cardlist
136
dvb-usb-af9035-cardlist
137
dvb-usb-anysee-cardlist
138
dvb-usb-au6610-cardlist
139
dvb-usb-az6007-cardlist
140
dvb-usb-ce6230-cardlist
141
dvb-usb-dvbsky-cardlist
142
dvb-usb-ec168-cardlist
143
dvb-usb-gl861-cardlist
144
dvb-usb-lmedm04-cardlist
145
dvb-usb-mxl111sf-cardlist
146
dvb-usb-rtl28xxu-cardlist
147
dvb-usb-zd1301-cardlist
149
other-usb-cardlist
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
USB 장치 식별
1-28이 문서는 GPL-2.0 라이선스를 따르는 USB media driver 목록입니다. USB board는 USB ID라는 식별자로 구분합니다.
`lsusb` 명령으로 USB ID를 확인할 수 있습니다.
$ lsusb
...
Bus 001 Device 015: ID 046d:082d Logitech, Inc. HD Pro Webcam C920
Bus 001 Device 074: ID 2040:b131 Hauppauge
Bus 001 Device 075: ID 2013:024f PCTV Systems nanoStick T2 290e
...최신 camera 장치는 USB Video Class를 통해 표준 방식으로 자신을 노출합니다. 이런 camera는 `uvc-driver`에서 자동으로 지원합니다.
오래된 camera와 TV USB 장치는 USB Vendor Classes를 사용합니다. 각 vendor가 장치 접근 방식을 자체 정의하며, 이 절은 그런 vendor-class 장치의 card list를 제공합니다.
PCI만큼 흔하지는 않지만 서로 다른 제품이 같은 USB ID를 쓰는 경우가 있습니다. 따라서 여러 media driver는 `card=` parameter를 받아 특정 제품 유형의 올바른 설정과 일치하는 card 번호를 지정할 수 있게 합니다.
지원 목록의 범위
30-38현재 지원하는 USB card는 아래와 같으며 `staging drivers`는 포함하지 않습니다.
일부 driver에는 이 표에 표시하지 않은 sub-driver가 있습니다. 특히 `gspca` driver에는 USB Video Class (UVC) driver가 지원하지 않는 camera용 sub-driver가 많으며, `gspca-cardlist` 문서에서 확인할 수 있습니다.
지원 USB driver
40-99| Driver | 이름 |
|---|---|
| airspy | AirSpy |
| au0828 | Auvitek AU0828 |
| b2c2-flexcop-usb | Technisat/B2C2 Air/Sky/Cable2PC USB |
| cx231xx | Conexant cx231xx USB video capture |
| dvb-as102 | Abilis AS102 DVB receiver |
| dvb-ttusb-budget | Technotrend/Hauppauge Nova - USB devices |
| dvb-usb-a800 | AVerMedia AverTV DVB-T USB 2.0 (A800) |
| dvb-usb-af9005 | Afatech AF9005 DVB-T USB1.1 |
| dvb-usb-af9015 | Afatech AF9015 DVB-T USB2.0 |
| dvb-usb-af9035 | Afatech AF9035 DVB-T USB2.0 |
| dvb-usb-anysee | Anysee DVB-T/C USB2.0 |
| dvb-usb-au6610 | Alcor Micro AU6610 USB2.0 |
| dvb-usb-az6007 | AzureWave 6007 and clones DVB-T/C USB2.0 |
| dvb-usb-az6027 | Azurewave DVB-S/S2 USB2.0 AZ6027 |
| dvb-usb-ce6230 | Intel CE6230 DVB-T USB2.0 |
| dvb-usb-cinergyT2 | Terratec CinergyT2/qanu USB 2.0 DVB-T |
| dvb-usb-cxusb | Conexant USB2.0 hybrid |
| dvb-usb-dib0700 | DiBcom DiB0700 |
| dvb-usb-dibusb-common | DiBcom DiB3000M-B |
| dvb-usb-dibusb-mc | DiBcom DiB3000M-C/P |
| dvb-usb-digitv | Nebula Electronics uDigiTV DVB-T USB2.0 |
| dvb-usb-dtt200u | WideView WT-200U and WT-220U (pen) DVB-T |
| dvb-usb-dtv5100 | AME DTV-5100 USB2.0 DVB-T |
| dvb-usb-dvbsky | DVBSky USB |
| dvb-usb-dw2102 | DvbWorld & TeVii DVB-S/S2 USB2.0 |
| dvb-usb-ec168 | E3C EC168 DVB-T USB2.0 |
| dvb-usb-gl861 | Genesys Logic GL861 USB2.0 |
| dvb-usb-gp8psk | GENPIX 8PSK->USB module |
| dvb-usb-lmedm04 | LME DM04/QQBOX DVB-S USB2.0 |
| dvb-usb-m920x | Uli m920x DVB-T USB2.0 |
| dvb-usb-nova-t-usb2 | Hauppauge WinTV-NOVA-T usb2 DVB-T USB2.0 |
| dvb-usb-opera | Opera1 DVB-S USB2.0 receiver |
| dvb-usb-pctv452e | Pinnacle PCTV HDTV Pro USB device/TT Connect S2-3600 |
| dvb-usb-rtl28xxu | Realtek RTL28xxU DVB USB |
| dvb-usb-technisat-usb2 | Technisat DVB-S/S2 USB2.0 |
| dvb-usb-ttusb2 | Pinnacle 400e DVB-S USB2.0 |
| dvb-usb-umt-010 | HanfTek UMT-010 DVB-T USB2.0 |
| dvb_usb_v2 | Support for various USB DVB devices v2 |
| dvb-usb-vp702x | TwinhanDTV StarBox and clones DVB-S USB2.0 |
| dvb-usb-vp7045 | TwinhanDTV Alpha/MagicBoxII, DNTV tinyUSB2, Beetle USB2.0 |
| em28xx | Empia EM28xx USB devices |
| go7007 | WIS GO7007 MPEG encoder |
| gspca | Drivers for several USB Cameras |
| hackrf | HackRF |
| hdpvr | Hauppauge HD PVR |
| msi2500 | Mirics MSi2500 |
| mxl111sf-tuner | MxL111SF DTV USB2.0 |
| pvrusb2 | Hauppauge WinTV-PVR USB2 |
| pwc | USB Philips Cameras |
| s2250 | Sensoray 2250/2251 |
| s2255drv | USB Sensoray 2255 video capture device |
| smsusb | Siano SMS1xxx based MDTV receiver |
| ttusb_dec | Technotrend/Hauppauge USB DEC devices |
| usbtv | USBTV007 video capture |
| uvcvideo | USB Video Class (UVC) |
| zd1301 | ZyDAS ZD1301 |
USB media 장치 확인 흐름
usb-cardlist.rst:1-149먼저 `lsusb`로 USB ID를 확인하고, 표준 UVC camera인지 vendor-class 장치인지 구분합니다. 동일 ID를 공유하는 제품은 driver의 `card=` parameter가 필요할 수 있습니다.