2. PCI 總線族

下面的總線都屬于 PCI 族：

• PCI：32 bit 總線，33 或 66 MHz。
• MiniPCI：插槽更小，用于筆記本電腦。
• CardBus：外部卡槽，用于筆記本電腦。
• PIX Extended(PCI-X)：比 PCI 插槽要寬，64 bit，但支持插入一個標準 PCI 卡。
• PCI Express(PCIe or PCI-E)：PCI 的當前代，用串行接口取代并行接口。
• PCI Express Mini Card：應用于較新的筆記本，取代 MiniPCI。
• Express Card：應用于較新的筆記本，取代 CardBus。

這些技術都是互相兼容的，內核驅動可以使用同一套。內核不需要感知硬件到底用的是什么插槽和總線變種。

3. PCI 設備類型

PCI 總線上的設備類型主要有：

• 網卡（有線或無線）。
• SCSI 適配器。
• 總線控制器：USB、PCMCIA、I2C、FireWire、IDE。
• 顯卡。
• 聲卡。

4. PCI 特性

主要是針對設備驅動開發者。

• boot 階段 BIOS 或 linux（如果配置了的話）會自動分配設備的資源（I/O 地址，IRQ 中斷線）。PCI/PCIe 的地址分配，參考本號《系統地址映射初始化：基于 PCI 的系統》、《系統地址映射初始化：基于 PCIe 的系統》。
• 設備驅動只需要讀取系統地址空間中的相應配置即可。
• 大小端：PCI 設備的配置信息是小端的。寫驅動的時候要注意（有些內核函數可以提供大小端轉化）。

5. 列舉 PCI 設備

1. lspci：列舉所有 PCI 設備。

2. lspci -tv：列舉 PCI 總線設備樹。

3. PCI 設備樹與 /sys 中的數據結構對應

6. PCI 設備配置

1. 每個 PCI 設備有一個 256 byte 地址空間長度的配置寄存器。
2. 可以通過 lspci -x 查看設備的配置：

3. 標準的 PCI 配置信息：

• 偏移 0：Vendor ID。
• 偏移 2：Device ID。
• 偏移 10：Class ID（網卡、顯卡、橋 ...）。
• 偏移 16 - 39：Base Address Registers（BAR）0 到 5。
• 偏移 44：SubVendor ID。
• 偏移 46：SubDevice ID。
• 偏移 64 及以上：設備制造商。

這些偏移的定義，在內核的 include/linux/pci_regs.h。

7. linux 驅動

7.1 注冊所支持的設備

drivers/net/ne2k-pci.c：

static struct pci_device_id ne2k_pci_tbl[] = {
  { 0x10ec, 0x8029, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_RealTek_RTL_8029 },
  { 0x1050, 0x0940, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_Winbond_89C940 },
  { 0x11f6, 0x1401, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_Compex_RL2000 },
  { 0x8e2e, 0x3000, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_KTI_ET32P2 },
  { 0x4a14, 0x5000, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_NetVin_NV5000SC },
  { 0x1106, 0x0926, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_Via_86C926 },
  { 0x10bd, 0x0e34, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_SureCom_NE34 },
  { 0x1050, 0x5a5a, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_Winbond_W89C940F },
  { 0x12c3, 0x0058, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_Holtek_HT80232 },
  { 0x12c3, 0x5598, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_Holtek_HT80229 },
  { 0x8c4a, 0x1980, PCI_ANY_ID, PCI_ANY_ID, 0, 0, CH_Winbond_89C940_8c4a },
  { 0, }
};
MODULE_DEVICE_TABLE(pci, ne2k_pci_tbl);

7.2 注冊驅動

注冊驅動的操作函數，以及驅動所支持的設備表：

static struct pci_driver ne2k_driver = {
  .name = DRV_NAME,
  .probe = ne2k_pci_init_one,
  .remove = __devexit_p(ne2k_pci_remove_one),
  .id_table = ne2k_pci_tbl,
#ifdef CONFIG_PM
  .suspend = ne2k_pci_suspend,
  .resume = ne2k_pci_resume,
#endif /* CONFIG_PM */
};

static int __init ne2k_pci_init(void)
{
  return pci_register_driver(&ne2k_driver);
}
static void __exit ne2k_pci_cleanup(void)
{
  pci_unregister_driver (&ne2k_driver);
}

• 驅動的操作函數以及所支持的設備，會在模塊加載時被載入。
• 如果找到一個匹配的設備，PCI 框架代碼會調用驅動的 probe() 函數。
• 非常類似 USB 設備驅動！

7.3 驅動操作函數修飾

• __init：模塊初始化函數。這些代碼會在驅動初始化完之后被丟棄。
• __exit：模塊退出函數。如果是靜態編譯（編到內核中）的驅動，會忽略之。
• __devinit：probe 函數以及所有初始化函數。如果使能了 CONFIG_HOTPLUG 內核配置，則此類函數就是個正常的函數，否則等同 __init。
• __devinitconst：用于設備 ID 表。
• __devexit：移除時會調用的函數。同 __devinit。
• 所有引用 __devinit 函數地址的地方，都應該使用 __devexit_p(fun) 進行聲明修飾。如果代碼被丟棄的話，此修飾會將函數地址替換為 NULL。

示例：

static struct pci_driver ne2k_driver = {
  .name = DRV_NAME,
  .probe = ne2k_pci_init_one,
  .remove = __devexit_p(ne2k_pci_remove_one),
  .id_table = ne2k_pci_tbl,
  ...
};

7.4 設備初始化步驟

• 使能設備。
• 請求 I/O 端口以及 I/O 內存資源。
• 設置 DMA mask size（coherent 及 streaming DMA 皆需要）。
• 分配并初始化共享控制數據（pci_allocate_coherent()）。
• 初始化設備寄存器（如果需要的話）。
• 注冊 IRQ 處理函數（request_irq()）。
• 注冊進其他子系統（網絡、顯示、存儲，等等）。
• 使能 DMA 處理引擎。

7.5 設備使能

1. 在訪問設備寄存器之前，驅動需要先執行 pci_enable_device()，這會導致：

• 如果設備在 suspend 狀態，則喚醒之。
• 分配設備的 I/O 和內存區域（如果 BIOS 沒有搞定的話）。
• 為設備分配一個 IRQ（如果 BIOS 沒有搞定的話）。

pci_enable_device() 可能會失敗，所以需要檢查其返回值！

pci_enable_device（drivers/net/ne2k-pci.c）示例：

static int __devinit ne2k_pci_init_one
(struct pci_dev *pdev, const struct pci_device_id *ent)
{
  ...
  i = pci_enable_device (pdev);
  if (i)
    return i;
  ...
}

2. 調用 pci_set_master() 使能 DMA，這會導致：

• 通過設置 PCI_COMMAND 寄存器中的 bus master bit 來使能 DMA。完成后設備便可在地址總線上扮演一個 master 的角色。
• 如果 BIOS 設置了偽造的值，則修復延遲定時器的值（Fix the latency timer value if it's set to something bogus by the BIOS. 這句話沒看明白）。

3. 如果設備可以使用 PCI Memory-Write-Invalidate transaction（寫整個 cache lines），你還可以調用 pci_set_mwi()：

• 此函數使能 Memory-Write-Invalidate 的 PCI_COMMAND bit。
• 此函數還確保對 cache line size 寄存器進行正確的設置。

7.6 訪問配置寄存器

訪問 I/O 內存和端口信息。

#include < linux/pci.h >

/* 讀接口 */
int pci_read_config_byte(struct pci_dev *dev, int where, u8 *val);
int pci_read_config_word(struct pci_dev *dev, int where, u16 *val);
int pci_read_config_dword(struct pci_dev *dev, int where, u32 *val);

/* 讀示例：drivers/net/cassini.c */
pci_read_config_word(cp- >pdev, PCI_STATUS, &cfg);

/* 寫接口 */
int pci_write_config_byte(struct pci_dev *dev, int where, u8 val);
int pci_write_config_word(struct pci_dev *dev, int where, u16 val);
int pci_write_config_dword(struct pci_dev *dev, int where, u32 val);

/* 寫示例：drivers/net/s2io.c */
/* Clear "detected parity error" bit
pci_write_config_word(sp- >pdev, PCI_STATUS, 0x8000);

• 每個 PCI 設備最多有 6 個 I/O 或內存區域，通過 BAR0 到 BAR5 來描述。
• 訪問 I/O 區域的基地址：

#include < linux/pci.h >
long iobase = pci_resource_start(pdev, bar);

• 訪問 I/O 區域的大小：

long iosize = pci_resource_len(pdev, bar);

• 預留 I/O 區域：

request_region(iobase, iosize, “my driver”);

或者簡單點：

pci_request_region(pdev, bar, “my driver”);

或者更簡單點：

pci_request_regions(pdev, “my driver”);

示例代碼（drivers/net/ne2k-pci.c）：

ioaddr = pci_resource_start (pdev, 0);
irq = pdev- >irq;

if (!ioaddr || ((pci_resource_flags (pdev, 0) & IORESOURCE_IO) == 0))
{
  dev_err(&pdev- >dev, "no I/O resource at PCI BAR #0\\n");
  return -ENODEV;
}

if (request_region (ioaddr, NE_IO_EXTENT, DRV_NAME) == NULL) {
  dev_err(&pdev- >dev, "I/O resource 0x%x @ 0x%lx busy\\n", NE_IO_EXTENT, ioaddr);
  return -EBUSY;
}

7.7 設置 DMA mask size

• 對于擁有超過（或少于）（那不就是 whatever 么？） 32 bit 總線 master capability 的設備，對此設備調用 pci_dma_set_mask() 聲明之。
• 特別是對于使用 64 bit DMA 的 PCI-X 和 PCIe 兼容設備來說，驅動必須調用此函數
• 如果設備可以直接尋址系統 RAM 中高于 4G 物理地址的“緩存一致性內存”，則通過 pci_set_consistent_dma_mask() 注冊之。

示例（drivers/net/wireless/ipw2200.c）：

err = pci_set_dma_mask(pdev, DMA_32BIT_MASK);

if (!err)
  err = pci_set_consistent_dma_mask(pdev, DMA_32BIT_MASK);
if (err) {
  printk(KERN_WARNING DRV_NAME ": No suitable DMA available.\\n");
  goto out_pci_disable_device;
}

7.8 分配緩存一致性的 DMA buffers

至此，已完成 DMA mask size 的分配。

• 如果你準備使用緩存一致性的 buffers，則分配之。
• 詳情參考內核 Documentation/DMA-API.txt。

7.9 初始化設備寄存器

如果設備需要的話：

• 設置一些 "capability" 域。
• 進行一些 vendor specific 的初始化工作或復位。

示例：清除 pending 的中斷。

7.10 注冊中斷處理函數

1. 調用 request_irq() 時需要傳入 IRQF_SHARED flag，因為 PCI 中斷線是可共享的。
2. 中斷注冊同時會使能中斷，故在中斷注冊的時間點上，需要：

• 確保設備已完成全部初始化工作并準備好處理中斷。
• 確保設備在調用 request_irq() 之前沒有 pending 的中斷。

3. 實際調用 request_irq() 的地方取決于設備類型，以及其所屬的子系統（比如網絡、顯示、存儲 ...）。
4. 驅動隨后被注冊進其所屬的子系統。

7.11 PCI 設備關停

在 remove() 函數中，你通常需要對在設備初始化（probe() 函數）中所做工作進行逆操作：

1. 禁能設備產生中斷：如果你不禁能設備中斷的話，系統可能會收到 spurious 中斷，并最終禁用掉整個中斷線。該中斷線上的其他設備就遭殃了！
2. 釋放 IRQ。
3. 停止所有 DMA 活動：需要在關閉 IRQs 之后再做（原 slides 這句話后面還有一個注：could start new DMAs，這句話沒看明白）。
4. 釋放 DMA buffers：先釋放 streaming buffers，然后再釋放 consistent buffers。
5. 從其他子系統中取消注冊。
6. 通過 io_unmap() 取消映射 I/O 內存及端口。
7. 通過 pci_disable_device() 關閉設備。
8. 取消注冊 I/O 內存和端口：如果這一步不做的話，會無法重新加載驅動。