【93】PCI Expansion ROM

1、Expansion ROM

PCIe、PCI设备可以提供Expansion ROM，Expansion ROM中存在设备初始化或者system boot的code。SystemBIOS在POST（Power-on Self Test）阶段，会枚举PCI设备，并判断有设备是否支持Expansion ROM，如果支持Expansion ROM，这把Expansion ROM code拷贝到RAM中并执行。

2、配置空间中Expansion ROM BAR位置

Type 0的0x30位置是存放设备的Expansion ROM BAR的位置，Expansion ROM BAR的枚举和其他BAR没有太大区别，都是写全1然后回读获取BAR大小，唯一的区别就是systemBIOS要去对应的地址拷贝Expansion ROM code，并校验、执行。

3、PCI Expansion ROM内容

PCIe Expansion ROM可能有很多份code image，每一份image都是512 byte boundary对齐的，并且每一份image都必须包含PCI Expansion ROM header。每次一份image的起始地址都依赖上一份image的大小（Image_N_header_offset=Image_N-1_header_offset+ Image_N-1_length*512）。最后一份image在last image indicator（0x15）字段标记出来。

3.1、PCI Expansion ROM Header格式

PCI Expansion ROM Header格式如上图，其中0x18~0x19指向PCI Data Structure。

3.2、PCI Data structure格式

其中vendor identification（0x4）/device identification（0x6）和class code（0xd）三者表示了本image code支持的设备ID（match和PCI 子系统查找probe函数的match函数类似）。

PCI data structure length（0xA）代表本image中的PCI data structure的length，单位是byte。

Image length（0x10）代表本image的大小，但是是512byte。

Code type（0x14）代表本image执行的CPU架构。

Last image indicator（0x15），bit7代表本image是否是ROM中的last image。bit7为1代表是last image，为0代表不是last image。

4、Linux kernel中PCI Expansion ROM相关实现

在sys文件系统中有对应PCIe设备的expansion ROM的binary。

在drivers/pci/pci-sysfs.c中有pci_read_rom和pci_write_rom的实现。

在drivers/pci/pci-sysfs.c中有访问Expansion ROM BAR的实现。

可以看到pci_write_rom相对来说简单一些，只是根据输入参数设置了一下pci_dev->rom_atter_enable。

在使用需要先echo 1 > rom，否则read是会返回Invalid argument。

4.1 pci_read_rom实现

pci_read_rom-->pci_map_rom------->pci_enable_rom----->io_remap----->pci_get_rom_size-->memcpy_fromio-->pci_unmap_rom-----> io_unmap----->pci_disable_rom

5、实际例子

我们拿82599网卡的Expansion ROM举个例子。82599网卡的Expansion ROM BAR size为64K，起始地址为0xa6c10000。我们使能command reg的memory access enable和expansion ROM enable后就可以访问expansion ROM BAR了。