NPLab

User Tools

Site Tools

Trace:
pci_configuration_space

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
pci_configuration_space [2026/02/28 15:22] – msvoelkerpci_configuration_space [2026/02/28 16:47] (current) – [VirtIO: DeviceCfg] msvoelker
Line 29: Line 29:
 </code> </code>
  
-Mit dem Parameter r kann pciconf den PCI Configuration Space direkt ausgeben. Der Parameter b gibt an, dass der Configuration Space Byteweise ausgelesen werden soll und 0x0:0x3f gibt den Bereich an, der ausgelesen werden soll.+===== Standardisierter Bereich =====
  
-<code> +In der einfachen Variante zeigt pciconf nur einen kleinen Teil der Informationen an, die im Configuration Space stehen. Pro PCI-Gerät ist der Configuration Space 256 Byte groß. Die ersten 64 Byte sind standardisiert über das folgende Format.
-% sudo pciconf -rb virtio_pci0@pci0:0:10:0 0x0:0x3f +
-f4 1a 00 10 17 00 10 00  00 00 00 02 00 00 00 00  +
-01 00 00 00 00 00 00 00  00 60 85 e1 00 00 00 00  +
-00 00 00 00 00 00 00 00  00 00 00 00 f4 1a 01 00  +
-00 00 00 00 40 00 00 00  00 00 00 00 0c 01 00 00  +
-</code> +
- +
-Der PCI Configuration Space enthält mehr, als pciconf bisher ausgegeben hat. Es nutzt das folgende Format.+
  
 <code> <code>
Line 77: Line 69:
    60 |Interrupt Line | Interrupt Pin |    Min Gnt.   |    Max Lat.   |    60 |Interrupt Line | Interrupt Pin |    Min Gnt.   |    Max Lat.   |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 +</code>
 +
 +Mit dem Parameter r kann pciconf den PCI Configuration Space direkt ausgeben. Der Parameter b dahinter gibt an, dass der Configuration Space Byteweise ausgelesen werden soll und 0x0:0x3f gibt den Bereich an, der ausgelesen werden soll (also die kompletten ersten 64 Byte).
 +
 +<code>
 +% sudo pciconf -rb virtio_pci0@pci0:0:10:0 0x0:0x3f
 +f4 1a 00 10 17 00 10 00  00 00 00 02 00 00 00 00 
 +01 00 00 00 00 00 00 00  00 60 85 e1 00 00 00 00 
 +00 00 00 00 00 00 00 00  00 00 00 00 f4 1a 01 00 
 +00 00 00 00 40 00 00 00  00 00 00 00 0c 01 00 00 
 </code> </code>
  
 Die Bytes sind in Little Endian. Die ersten zwei Bytes sind also 0x1af4, die die Vendor ID angeben. Die Bytes sind in Little Endian. Die ersten zwei Bytes sind also 0x1af4, die die Vendor ID angeben.
  
-Interessant sind die Base Address Registers (BARs), über die weitere Informationen zum PCI-Gerät angegeben werden können. Das BAR selbst ist hauptsächlich die Base Adress, das ist die Adresse unter der sich die BAR Region im Speicher befindet. Darin kodiert ist z. B. der Typ des BAR. Es gibt Memory (0) und I/O (1). 
  
-Bei dem PCI-Gerät gibt es zwei BARs. Hier Configuration Space von eben der Teil zu den BARs.+===== Base Address Register (BAR) ===== 
 + 
 +In einer Base Address Register (BAR) Region, kann das PCI-Gerät weitere Informationen schreiben und auch der Treiber kann darin schreiben, um z. B. Informationen zurück zu geben. Das BAR in dem standardisierten Bereich ist hauptsächlich die Base Address, das ist die Adresse unter der sich die BAR Region im Speicher befindet. Darin kodiert ist z. B. der Typ des BAR. Es gibt Memory (0) und I/O (1). 
 + 
 +Bei dem PCI-Gerät gibt es zwei BARs. Hier der Abschnitt vom Configuration Space zu den BARs.
  
 <code> <code>
-   | BAR 1     |            | BAR 2     | +| BAR 1     |            | BAR 2     | 
-    01 00 00 00 00 00 00 00  00 60 85 e1 00 00 00 00  + 01 00 00 00 00 00 00 00  00 60 85 e1 00 00 00 00  
-    00 00 00 00 00 00 00 00+ 00 00 00 00 00 00 00 00
 </code> </code>
  
-BAR 1 hat Typ 1 (I/O) und Base Address 0. BAR 2 hat Typ 0 (Memory) und Base Address 0xe1856000. Die BARs lassen sich mit pciconf mit dem Parameter b ausgeben.+BAR 1 hat Typ 1 (I/O) und Base Address 0. BAR 2 hat Typ 0 (Memory) und Base Address 0xe1856000. Die BARs lassen sich mit pciconf über den Parameter b ausgeben.
  
 <code> <code>
Line 100: Line 105:
 </code> </code>
  
-Die Zahl in eckigen Klammern gibt über ein Byte-Offset hexadezimal an wo im Configuration Space der BAR angegeben ist.+Die Zahl in eckigen Klammern gibt über ein Byte-Offset hexadezimal an, wo im Configuration Space der BAR angegeben ist. 
 + 
 +VirtIO nutzt im Legacy Modus den BAR vom Typ I/O und im Modern Modus den BAR vom Typ Memory. Das PCI-Gerät, was VirtualBox bereistellt ist ein Transitional Device. Das heißt, es unterstützt beide Modi. FreeBSD hat einen Treiber pro Modus (src/sys/dev/virtio/pci/virtio_pci_[legacy|modern].c). Es ruft jeweils die entsprechende device_probe Methode auf und trifft die Entscheidung anhand des Rückgabewertes. Hier betrachte ich den Modern Modus. 
 + 
 +Mit pciconf kann über den Parameter D eine BAR Region ausgelesen werden. 
 + 
 +<code> 
 +% sudo pciconf -D pci0:0:10:0 0x18 | hexdump -C 
 +00000000  01 00 00 00 01 00 00 00  01 00 00 00 01 00 00 00  |................| 
 +00000010  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................| 
 +00000020  00 90 fa 03 01 00 00 00  00 d0 fa 03 01 00 00 00  |................| 
 +00000030  00 e0 fa 03 01 00 00 00  ff ff ff ff ff ff ff ff  |................| 
 +00000040  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  |................| 
 +* 
 +00000060  ff ff ff ff ff ff ff ff  ff ff ff ff 00 00 00 00  |................| 
 +00000070  08 00 27 54 00 00 00 00  01 00 00 00 ff ff ff ff  |..'T............| 
 +00000080  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  |................| 
 +* 
 +00002000 
 +</code> 
 + 
 +Im Modern Mode zeigen die PCI Capabilities auf, wo sich in der BAR Region welche Informationen finden. 
  
-VirtIO nutzt im legacy mode den BAR vom Typ I/O und im modern mode den BAR vom Typ Memory. Das PCI-Gerät, was VirtualBox bereistellt ist ein Transitional Device. Das heißt, der unterstützt beide Modi. FreeBSD hat einen Treiber pro Modus (src/sys/dev/virtio/pci/virtio_pci_[legacy|modern].c). Es ruft jeweils die entsprechende device_probe Methode auf und trifft die Entscheidung anhand des Rückgabewertes.+===== Capabilities =====
  
-Im Modern Mode zeigen die PCI Capabilities auf, wo sich im der BAR Region welche Informationen finden. Der Capabilites Pointer ist in dem PCI Configuration Space von oben auf 0x40 gesetzt. Das ist ein Pointer auf des erste Element in einer linked list von Capabilites. Die Capabtilites lassen sich mit pciconf über den Parameter c ausgeben.+Zu einem PCI-Gerät können eine Reihe von Capabilities angegeben werden, die z. B. angeben können, in welchen BAR Regionen und wo darin weitere Informationen zu finden sind. Der Capabilities Pointer ist in dem PCI Configuration Space von oben auf 0x40 gesetzt. Das ist ein Pointer auf des erste Element in einer linked list von Capabilities. Die Capabilities lassen sich mit pciconf über den Parameter c ausgeben.
  
 <code> <code>
Line 116: Line 143:
 </code> </code>
  
-Der erste Wert nach cap gibt die Capability ID an. Der Wert in eckigen Klammern gibt über ein Byte-Offset hexadezimal an wo im Configuration Space die Capability beschrieben steht. Die erste Capability ist also 0x40 = 64 Byte hinter dem Start des Configuration Space zu finden, also direkt hinter dem eben angegebenen Format. Die Bytes lassen sich ebenfalls mit pciconf -rb auslesen.+Der erste Wert nach cap gibt die Capability ID an. Der Wert in eckigen Klammern gibt über ein Byte-Offset hexadezimal an, wo im Configuration Space die Capability beschrieben steht. Die erste Capability ist also 0x40 = 64 Byte hinter dem Start des Configuration Space zu finden, also direkt hinter dem standardisierten Bereich. Die Bytes lassen sich ebenfalls mit pciconf -rb auslesen.
  
 <code> <code>
Line 161: Line 188:
 </code> </code>
  
-Alle Capabilites sind also VirtIO spezifische Capabilites und die Informationen befinden sich im BAR 2, also in dem vom Typ Memory. Das Offset gibt an ab welcher Byte Position die Informationen im BAR sind und size wie viele Bytes die Informationen umfassen.+Alle Capabilities sind also VirtIO spezifische Capabilities und die Informationen befinden sich in der Region vom BAR 2, also in der vom Typ memory (die im VirtIO Modern Modus benutzt wird). Das Offset gibt an ab welcher Byte Position die Informationen in der BAR Region sind und size wie viele Bytes die Informationen umfassen.
  
-Mit pciconf kann über den Parameter D eine BAR Region ausgelesen werden.+==== VirtIO: CommonCfg ====
  
-<code> +Die erste Capability vom Typ VirtIO: CommonCfg enthält VirtIO-Gerätunabhängige Einstellungen. Sie startet in der BAR Region bei Byte 0 und ist 0x38 Byte groß. Es handelt sich um den Bereich vor den ganzen 0xffff, also
-% sudo pciconf -D pci0:0:10:0 0x18 | hexdump +
-0000000 0000 0000 dda3 002f 0000 0000 9823 000f +
-0000010 0000 0000 0000 0000 0000 0000 0000 0000 +
-0000020 9000 03fa 0001 0000 d000 03fa 0001 0000 +
-0000030 e000 03fa 0001 0000 ffff ffff ffff ffff +
-0000040 ffff ffff ffff ffff ffff ffff ffff ffff +
-* +
-0000060 ffff ffff ffff ffff ffff ffff 0000 0000 +
-0000070 0008 5427 0000 0000 0001 0000 ffff ffff +
-0000080 ffff ffff ffff ffff ffff ffff ffff ffff +
-* +
-0002000+
  
-% sudo pciconf -D pci0:0:10:0 0x18 | hexdump -C +<code> 
-00000000  01 00 00 00 01 00 00 00  01 00 00 00 01 00 00 00  |................| +00000000  01 00 00 00 01 00 00 00  01 00 00 00 01 00 00 00 
-00000010  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................| +00000010  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00 
-00000020  00 90 fa 03 01 00 00 00  00 d0 fa 03 01 00 00 00  |................| +00000020  00 90 fa 03 01 00 00 00  00 d0 fa 03 01 00 00 00 
-00000030  00 e0 fa 03 01 00 00 00  ff ff ff ff ff ff ff ff  |................| +00000030  00 e0 fa 03 01 00 00 00
-00000040  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  |................| +
-* +
-00000060  ff ff ff ff ff ff ff ff  ff ff ff ff 00 00 00 00  |................| +
-00000070  08 00 27 54 00 00 00 00  01 00 00 00 ff ff ff ff  |..'T............| +
-00000080  ff ff ff ff ff ff ff ff  ff ff ff ff ff ff ff ff  |................| +
-* +
-00002000+
 </code> </code>
  
-Die erste Capability vom Typ VirtIO: CommonCfg startet bei Byte 0 und ist 0x38 Byte groß, ist also der Bereich vor den ganzen 0xffff. Beschrieben ist das Format in der VirtIO Spezifikation mit+Beschrieben ist das Format in der VirtIO Spezifikation im Abschnitt [[https://docs.oasis-open.org/virtio/virtio/v1.4/virtio-v1.4.html#x1-1750004|4.1.4.3 Common configuration structure layout]] mit
  
 <code> <code>
Line 225: Line 233:
 </code> </code>
  
-Das VirtualBox PCI-Gerät gibt darüber also z. B. an, welche Features es unterstützt. Für die Features gibt es insgesamt 64 Bit. In device_feature_select wird geschrieben, ob device_feature die unteren 32 Bit (0) oder die oberen 32 Bit (1) anzeigt. In der Ausgabe oben ist in Little Endian gelesen device_feature_select=1, somit gibt das device_feature mit 1 die oberen oberen 32 Bit an. Auf die gleiche Weise schreibt der FreeBSD Treiber die Features, die es davon unterstützt und genutzt werden sollen in driver_feature_select und driver_feature. Auch hier ist in der Ausgabe oben in Little Endian gelesen driver_feature_select=1, somit gibt das driver_feature mit 1 die oberen oberen 32 Bit an.+Das VirtualBox PCI-Gerät gibt darüber also z. B. an, welche Features es unterstützt. Für die Features gibt es insgesamt 64 Bit. In device_feature_select wird geschrieben, ob device_feature die unteren 32 Bit (0) oder die oberen 32 Bit (1) anzeigt. In der Ausgabe oben ist in Little Endian gelesen device_feature_select=1, somit gibt das device_feature mit 1 die oberen oberen 32 Bit an. Auf die gleiche Weise schreibt der FreeBSD Treiber die Features, die es davon unterstützt und nutzen möchte in driver_feature_select und driver_feature. Auch hier ist in der Ausgabe oben in Little Endian gelesen driver_feature_select=1, somit gibt das driver_feature mit 1 die oberen oberen 32 Bit an.
  
-Mit device_feature_select=0 und driver_feature_select=0 sieht die erste Zeile der Ausgabe in so aus.+Mit device_feature_select=0 und driver_feature_select=0 sieht die erste Zeile der Ausgabe so aus.
  
 <code> <code>
Line 233: Line 241:
 </code> </code>
  
-In Little Endian gelesen sind die Features vom Device also:+In Little Endian gelesen sind device_feature=0x1002fdda3, d. h. das PCI-Gerät unterstützt die folgenden Features
  
-0x1002fdda3 <Version1,GuestAnnounce,CtrlVLANFilter,CtrlRxMode,CtrlVq,Status,MrgRxBuf,TxUFO,TxTSOv6,TxTSOv4,RxUFO,RxLROv6,RxLROv4,MAC,RxChecksum,TxChecksum>.+Version1,GuestAnnounce,CtrlVLANFilter,CtrlRxMode,CtrlVq,Status,MrgRxBuf,TxUFO,TxTSOv6,TxTSOv4,RxUFO,RxLROv6,RxLROv4,MAC,RxChecksum,TxChecksum
  
-und die ausgehandelten Features:+und driver_feature=0x1000f9823, d. h. ausgehandelt wurden die folgenden Features
  
-0x1000f9823 <Version1,CtrlVLANFilter,CtrlRxMode,CtrlVq,Status,MrgRxBuf,TxTSOv6,TxTSOv4,MAC,RxChecksum,TxChecksum>+Version1,CtrlVLANFilter,CtrlRxMode,CtrlVq,Status,MrgRxBuf,TxTSOv6,TxTSOv4,MAC,RxChecksum,TxChecksum
  
 +==== VirtIO: DeviceCfg ====
  
 +Die Capability VirtIO: DeviceCfg gibt VirtIO-Gerätspezifische Einstellungen an. In der BAR Region startet sie bei Byte-Offset 0x70 und ist 0xa = 10 Byte lang, was diesem Abschnitt entspricht:
  
 +<code>
 +00000070  08 00 27 54 00 00 00 00  01 00
 +</code>
 +
 +Beschrieben ist das Format in der VirtIO Spezifikation im Abschnitt [[https://docs.oasis-open.org/virtio/virtio/v1.4/virtio-v1.4.html#x1-2760004|5.1.4 Device configuration layout]] mit:
 +
 +<code>
 +struct virtio_net_config { 
 +        u8 mac[6]; 
 +        le16 status; 
 +        le16 max_virtqueue_pairs; 
 +        le16 mtu; 
 +        le32 speed; 
 +        u8 duplex; 
 +        u8 rss_max_key_size; 
 +        le16 rss_max_indirection_table_length; 
 +        le32 supported_hash_types; 
 +        le32 supported_tunnel_types; 
 +};
 +</code>
  
 +Es sind jedoch nicht immer alle Werte angegeben. Welche Werte angegeben sind, hängt von den ausgehandelten Features ab. Hier sind lediglich die MAC-Adresse=08:00:27:54:00:00, der Status=0 und max_virtqueue_pairs=1 angegeben. Die MTU fehlt z. B., weil das Feature VIRTIO_NET_F_MTU nicht ausgehandelt wurde.
pci_configuration_space.1772292124.txt.gz · Last modified: by msvoelker