Merge tag 'armsoc-soc' of git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc
[linux-2.6-microblaze.git] / Documentation / admin-guide / media / pci-cardlist.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 PCI drivers
4 ===========
5
6 The PCI boards are identified by an identification called PCI ID. The PCI ID
7 is actually composed by two parts:
8
9         - Vendor ID and device ID;
10         - Subsystem ID and Subsystem device ID;
11
12 The ``lspci -nn`` command allows identifying the vendor/device PCI IDs:
13
14 .. code-block:: none
15    :emphasize-lines: 3
16
17     $ lspci -nn
18     ...
19     00:0a.0 Multimedia controller [0480]: Philips Semiconductors SAA7131/SAA7133/SAA7135 Video Broadcast Decoder [1131:7133] (rev d1)
20     00:0b.0 Multimedia controller [0480]: Brooktree Corporation Bt878 Audio Capture [109e:0878] (rev 11)
21     01:00.0 Multimedia video controller [0400]: Conexant Systems, Inc. CX23887/8 PCIe Broadcast Audio and Video Decoder with 3D Comb [14f1:8880] (rev 0f)
22     02:01.0 Multimedia video controller [0400]: Internext Compression Inc iTVC15 (CX23415) Video Decoder [4444:0803] (rev 01)
23     02:02.0 Multimedia video controller [0400]: Conexant Systems, Inc. CX23418 Single-Chip MPEG-2 Encoder with Integrated Analog Video/Broadcast Audio Decoder [14f1:5b7a]
24     02:03.0 Multimedia video controller [0400]: Brooktree Corporation Bt878 Video Capture [109e:036e] (rev 11)
25     ...
26
27 The subsystem IDs can be obtained using ``lspci -vn``
28
29 .. code-block:: none
30    :emphasize-lines: 4
31
32     $ lspci -vn
33     ...
34         00:0a.0 0480: 1131:7133 (rev d1)
35                 Subsystem: 1461:f01d
36                 Flags: bus master, medium devsel, latency 32, IRQ 209
37                 Memory at e2002000 (32-bit, non-prefetchable) [size=2K]
38                 Capabilities: [40] Power Management version 2
39     ...
40
41 At the above example, the first card uses the ``saa7134`` driver, and
42 has a vendor/device PCI ID equal to ``1131:7133`` and a PCI subsystem
43 ID equal to ``1461:f01d`` (see :doc:`Saa7134 card list<saa7134-cardlist>`).
44
45 Unfortunately, sometimes the same PCI subsystem ID is used by different
46 products. So, several media drivers allow passing a ``card=`` parameter,
47 in order to setup a card number that would match the correct settings for
48 an specific board.
49
50 The current supported PCI/PCIe cards (not including staging drivers) are
51 listed below\ [#]_.
52
53 .. [#] some of the drivers have sub-drivers, not shown at this table
54
55 ================  ========================================================
56 Driver            Name
57 ================  ========================================================
58 altera-ci         Altera FPGA based CI module
59 b2c2-flexcop-pci  Technisat/B2C2 Air/Sky/Cable2PC PCI
60 bt878             DVB/ATSC Support for bt878 based TV cards
61 bttv              BT8x8 Video For Linux
62 cobalt            Cisco Cobalt
63 cx18              Conexant cx23418 MPEG encoder
64 cx23885           Conexant cx23885 (2388x successor)
65 cx25821           Conexant cx25821
66 cx88xx            Conexant 2388x (bt878 successor)
67 ddbridge          Digital Devices bridge
68 dm1105            SDMC DM1105 based PCI cards
69 dt3155            DT3155 frame grabber
70 dvb-ttpci         AV7110 cards
71 earth-pt1         PT1 cards
72 earth-pt3         Earthsoft PT3 cards
73 hexium_gemini     Hexium Gemini frame grabber
74 hexium_orion      Hexium HV-PCI6 and Orion frame grabber
75 hopper            HOPPER based cards
76 ipu3-cio2         Intel ipu3-cio2 driver
77 ivtv              Conexant cx23416/cx23415 MPEG encoder/decoder
78 ivtvfb            Conexant cx23415 framebuffer
79 mantis            MANTIS based cards
80 meye              Sony Vaio Picturebook Motion Eye
81 mxb               Siemens-Nixdorf 'Multimedia eXtension Board'
82 netup-unidvb      NetUP Universal DVB card
83 ngene             Micronas nGene
84 pluto2            Pluto2 cards
85 saa7134           Philips SAA7134
86 saa7164           NXP SAA7164
87 smipcie           SMI PCIe DVBSky cards
88 solo6x10          Bluecherry / Softlogic 6x10 capture cards (MPEG-4/H.264)
89 sta2x11_vip       STA2X11 VIP Video For Linux
90 tw5864            Techwell TW5864 video/audio grabber and encoder
91 tw686x            Intersil/Techwell TW686x
92 tw68              Techwell tw68x Video For Linux
93 zoran             Zoran-36057/36067 JPEG codec
94 ================  ========================================================
95
96 Some of those drivers support multiple devices, as shown at the card
97 lists below:
98
99 .. toctree::
100         :maxdepth: 1
101
102         bttv-cardlist
103         cx18-cardlist
104         cx23885-cardlist
105         cx88-cardlist
106         ivtv-cardlist
107         saa7134-cardlist
108         saa7164-cardlist
109         zoran-cardlist