PCI IRQ Routing

peterhu

PCI IRQ Routing

. S8 q' j; j  g+ b& u
1 @% y! M. |( J1.Why IRQ Routing

在计算机发展的历史中，很多技术的出现都是为了解决当前所面临的问题而产生和发展出来的，PCI IRQ Routing也不例外，随着计算机系统的功能需求的增加，越来越多的PCI/PCIE设备被加入到系统中来，可是PIC mode下却只有15 个IRQ可供使用（即使是APIC，目前也只是有24个INTIN），而且在早期device都是直接拉线到8259 IRQ，所以一旦确定就没法改变，没有灵活性。于是中断共享就是这种情况下解决这一问题的一个方法（当然其他的方法如使用MSI,SIRQ等也都可以实现中断的复用），可是中断共享了以后又会有新的问题出现 那就是如何分配这些中断的使用 才能够达到负载均衡（Loading Banlance），上述的这些问题就使得PCI IRQ Routing应运而生了。

2.How to Routing
/ @" y" `1 S* Q- s1 u4 G4 I  [
- Y$ I( v. I; g8 w: L1.Routing for Internal Device
9 R' f' g# n" R5 Q7 h
  ?4 n, ~6 n; U: J5 k新的chipset为了Internal Device Interrupt Routing有更大的灵活性，在chipset内部加入了以下几个新的register 为方便SBIOS去配置；这几个register分别是D**IP（Intertupt Pin Register）用于设定对应的device所使用的Interupt Pin；D**IR（Interrupt Router Register）用于设定Interrupt Pin所使用的Interrupt Router（PIRQA#-H#）；PIRQ_ROUT （Routing Control Register），用于设定PCI Device Interrupt Pin INTA#-H# 连接到具体PIC controller的IRQ*上，在8259 PIC Mode下SBIOS需要去设置PIRQ_ROUT的register 用于指定具体的IRQ；APIC Mode PIRQ_ROUT则是固定的连接到APIC INTIN pin上，PIRQA#-H#分别连接到INTIN16-INT23。比如我们想配置Device31 Function2 也就是Sata Controller 1的IRQ Routing 是使用INTA#
PIRQA# 最终接到PIC 的IRQ5,那么我们需要做的配置将会如下图所示：

" `' }3 X9 C; S

$ H, E5 E5 }* ~$ a9 z' {& y2 F2.Routing for PCIE Root Ports

" ~* ^1 J+ k6 ?7 S6 Q7 |7 XPCIE Root Ports扮演的是一个P2P bridge的角色，Root Ports自身产生的Intterupts的处理方式和Internal Devices处理方式一样；Root Ports所接入的设备所产生的Intterupts，则会有Root Ports转发给上一级的Root Complex去处理。为了Intterupt Sharing更加的均衡合理， 在转发给Root Complex之前这些来自Downstream PCIE Devices产生的Intterupt将会被chipset内部的称之为swizzling的一个机制处理过之后再丢给Root Complex，这个部分就是完全的HW机制，它的基本原理就是将来自Downstream PCIE Devices INTA#=H# 产生的中断请求 再转化一遍，比如接在Root Ports 2上的INTA#将会被转成INTB# 然后再丢给上层的Root Complex。经过Swizzling之后，INTA#-H# 会被分别连接到PIRQA#-H#.

, a# d* l7 S! R0 a& u& U3.Routing for PCI Expansion Slots
4 s( e8 v, v2 K6 d  V
/ r* Z5 }( ]5 I8 IPCI Expansion Slots通常是指通过PNP Bridge扩展出来的PCI 插槽（slots），在这些slots上可以接入PCI Device。这些PCI Expansion Slots的 IRQ Routing和PCIE Root Ports非常接近，主要的区别可能就是swizzling的部分需要HW自己去拉，实现的原理和chipset 内置的swizzling应该是类似的。最终PCI Slot上的device经过swizzling之后 ，INTA#-H#会被分别连接到PIRQA#-H#.
  h) r) H1 }" t% i0 h! h
3.Reporting IRQ Routing to OS
8 {. r+ q" m* {; r
SBIOS将PCI IRQ Routing信息配置好以后就需要将这些信息提供给OS，为OS获取系统整个IRQ的分配提供一个基本的参考依据。当然OS并不一定要严格按照SBIOS提供的信息去配置PCI Device它也会依据获取信息动态的去分配这些IRQ Routing。通常SBIOS回报给OS这些信息有两种方式，
对于Legacy OS，SBIOS会通过PCI IRQ Routing Table 的方式告知OS；对于ACPI OS SBIOS则是通过在对应的PCI Device space中提供_PRT method告知ACPI OS 系统的IRQ Routing的方式。

4 \4 v* h2 n" H  E' I- x1.PCI IRQ Routing Table (Legacy OS)
& Q2 `6 ]' H  z
Legacy OS 下Intterupt Controller 通常是工作在PIC Mode，BIOS需要按照微软规定的PCI IRQ Routing Table Specification将PCI Devices IRQ Routing信息回报给Legacy OS。这张IRQ Routing Table的格式如下所示：

8 a/ Y. Z/ x/ u' j) ]( H


SBIOS会将这张table放在F segment（F0000h-FFFFF）, 我们可以通过Search “$PIR” Signature去找到这张表格。

2.ACPI _PRT Packages (ACPI OS)

) U1 ?! |1 O- s" P; {$ p* j8 P- I) aACPI OS 需要通过_PRT Packages 将Routing的信息 Report给OS，而且根据PIC/APIC Mode的不同，_PRT回报给OS 的Packages也会有不同。
A.PIC Mode回报Routing信息的sample code如下所示：（所有code 均来自google 大神）：
$ D! n- S; O1 i8 W
OperationRegion (\_SB.PCI0.SBRG.PIX0, PCI_Config, 0x60, 0x0C)
) V- A$ L" W1 T. P* x/ D
Field (\_SB.PCI0.SBRG.PIX0, ByteAcc, NoLock, Preserve)

{

! c& @% E* X3 oPIRA,
8,
/ U$ O- d2 _& p+ D4 v4 W# o! {
PIRB,
8,
7 N* p, t1 m7 _8 c…
4 A- j% N& x. E1 c
}
0 C3 \/ d0 u# Q7 J
Device (LNKA)
. _7 ?( \! ]8 y  [
{
9 c, q3 c* X( _
$ Q8 |( S0 d/ R+ w6 o4 y# rName (_HID, EisaId ("PNP0C0F"))

: i* a8 L1 _% J2 I- f& B. T0 kName (_UID, 0x01)

8 r( j$ |2 ~( W5 W1 r1 k3 dMethod (_STA, 0, NotSerialized)
6 b0 }3 J9 M3 S9 r
{
. W- ^- G# I2 F/ x) a
And (PIRA, 0x80, Local0)
# _' h. s3 r1 a3 J  P+ o
7 A: X4 X, a" B; ~  c/ w  n
; X; B: j2 j  y0 `If (Local0)

{

Return (0x09)
( X( K! ~" x% t1 f- O1 E
8 _8 i! M8 v. Q' w% s}

2 Q0 L" I7 B2 v3 lElse
5 m* A3 G- L5 U6 F% P( A3 C; O, b+ E
* U  h) e2 a8 E1 I{

' N, e8 V4 T5 v, j. o( NReturn (0x0B)
' v' f6 U6 t5 }. h3 P6 [9 E
}

}
# |. ?) a8 y! q% l+ C3 f

* {7 h2 p& |+ H) C0 B. vMethod (_PRS, 0, NotSerialized)

- l, F: K2 f! z/ a4 I{
, x, _' E' ?2 F* Z

" ~, u3 p! n% \2 gReturn (PRSA)

$ \% s' P" r$ l6 m2 Z1 b- Y- G}
& J1 _. w; d8 h% _/ D$ A

  g+ m; m, ~+ K& UMethod (_DIS, 0, NotSerialized)
7 W! z" q$ i3 {% ?, M
{

$ n9 @! W# }0 ~1 e/ Y- B' I1 OOr (PIRA, 0x80, PIRA)
* Z! v# O3 T2 E* ~: }
}


$ j! C( v$ p" k0 K' p) AMethod (_CRS, 0, NotSerialized)

7 c1 r0 T* e+ Y7 H3 D- p{
$ f8 d+ d) _" ?% M! m" E
And (PIRA, 0x0F, Local0)
5 `; x0 g6 g0 r' ~8 w* K
ShiftLeft (0x01, Local0, IRA0)

' l# Z9 ]! `6 _( ^- @# s' K) g" cReturn (BUFA)
+ ~. L7 G. Q2 q. y# ^7 P
}

" }9 J# y$ o# B4 k3 o. D
Method (_SRS, 1, NotSerialized)
8 [  p, W& {: _' R$ u7 A7 K+ t! `& v: c
) Y3 Y; T. M1 \  [2 P{

  ^% h$ {, @. ]8 H/ sCreateWordField (Arg0, 0x01, IRA)
% u1 H: _5 `4 V& }7 V8 o! H$ I
FindSetRightBit (IRA, Local0)


Decrement (Local0)
: t5 C5 P, s- J) `0 T2 B
& ^/ V7 s5 K9 B- Z0 p* O! iStore (Local0, PIRA)
- t4 ~  F: p" P0 q* l0 |( c2 x, z- g
}

3 P4 x" h9 ~5 B* h) c}

Name (PR00, Package (0x12)

{
& m, y/ p+ Y7 R5 ?0 `+ T
Package (0x04)

{
, j8 k& v" |5 j+ q; U
0x0001FFFF,

0x00,

* L5 {) t  V6 P. @' S# a, d  y$ YLNKA,

, u* r$ d5 ?! T# @& p0 }  T0x00

6 Z  V/ G7 \; ]& L: }; R},
* s+ @4 w& ?8 d7 I
9 m( A. C" }" J7 G2 J* R! j* K( S' X
Package (0x04)

1 O" ?* l1 Q. |* v8 X{
* ^* S% O' [" p+ j# [1 l  v2 F
! V% Q' F& C+ [0x0001FFFF,
2 X7 X& Y. @, i' f1 C. b6 J" S6 s
8 m. y6 }) \; ^0x01,

LNKB,

0x00
) J% S' ~. o7 m; \/ y
},
/ v  w5 ?. S" i, a
9 d$ I. P- M: M……
) @! Y# O, t, ~/ K$ n+ g; R
4 R6 f. |; W& J; u1 E) O

$ Q8 e1 O3 m, w6 Q2 IPackage (0x04)

{

; r: h5 V5 U4 I% a$ d0x001DFFFF,
! o# v' y4 K! f3 R. i
7 M, {4 T, p3 U- c- H* j0x00,
6 |( I  L2 |0 v; W) z
: L$ f( A3 M5 rLNKH,
+ `" }$ p7 q- [2 c) Z2 M/ y
6 L5 y4 [. c" V3 N$ p. Y- F6 D5 ?0x00

7 o# Q8 p& m6 l},

8 |( V- ^$ \6 U7 r% W: h$ ^# ?8 J
: Q4 Y% a9 b( u; V, B, OPackage (0x04)

9 j* M6 _# Q$ ~/ [$ f; c{

, e2 b8 \+ B  u1 \, L0x001DFFFF,
! C. B" h( H5 m/ o+ i8 E
7 p; |% e: P  K' d0 x0x01,

LNKD,
( ^- ^$ _$ W( g$ I( K

9 G' V* P( j) x3 Z6 o' X/ f9 S/ b0x00
3 V2 i! _7 s; ]0 T& t3 }
},
# D- X5 r" g- {! y9 e% |
2 H( n) _- f% L
& z" z5 u% `9 W# f* o# ~' H7 V2 HPackage (0x04)
0 R7 U2 a( a+ S  a4 e" I0 z
9 T' a. j, u. s& |{
5 S, t: J2 a, A3 }) O: [9 Y
0x001DFFFF,

; \* l( j6 N& F' j7 x9 @0x02,

& Z7 E# e! h2 Z% {LNKC,
& P; A) O' L1 a
0x00

* z( L6 M. T. }},
5 l5 O6 @) ]( [! a& K7 C
, ?1 {) `& t5 b
3 F& }+ L! q" I: ?! B- lPackage (0x04)
5 f) @& p) p. A
, \) R3 E2 b  C9 ~% F# K! e{

# Z, ^+ Z2 P3 N3 \+ F' Y/ C4 ^- F* S0x001DFFFF,

0x03,

LNKA,

0x00
: f  B% c+ C+ i& C+ I0 R
2 E9 Q, ~  @! L},

…
3 ?$ U  ?9 ?$ g! h/ E
7 L- @( C  p+ n( {7 b  Q1 }& b- P})
3 Y, W* }& L- n$ L
Device (PCI0)

3 p' D  K& ]4 @3 R/ `' v{

* x, s- Y/ ?! ?& T0 M


Name (_HID, EisaId ("PNP0A08"))
: o: G2 P. _8 }
Name (_CID, 0x030AD041)

9 k# K% P1 b0 v- q  {! VName (_ADR, 0x00)
0 \4 G$ B& I9 I( t8 r1 S! h6 c  u3 Z
2 t( N: N  O& _1 B  e: k
% X0 L* u% V* b: K0 T
+ z. V: U* i4 rMethod (_PRT, 0, NotSerialized)
/ }; t: m# `! e9 d2 T
{
/ O+ v. A6 O4 N$ W9 n/ d9 J
If (PICM)
% L6 x% S! L% F, U% q8 k# f
8 B# _  U  G7 ]/ I0 T" Z{
3 H. n: l* d& Z7 v: h
- t+ Z6 e0 M0 K6 q( V/ cReturn (AR00)

}


Return (PR00)

}
, t( T# b  r7 t6 u7 \; @
…
}
上面是从网上搜到的一个PIC Mode Routing 信息的一部分的code，我们从底往上看，上述code表示Device (PCI0) scope下的所有device 的Routing信息PICM用于表示当前使用的是PIC 还是APIC
1 l* a" b7 c/ Q: {  JMode，当PIC Mode时就回复PR00的package，PR00表示bus 0 device 0x1f INTA#被routing到PIRQA，bus 0 device 0x1f INTB#被routing到PIRQB，后面的一个bus 0 device 0x1d也是表示相同的意义。PR00 Package中的LNKA LNKB
$ @( A- T" R6 u9 c/ Jdevice其实表示的是PIRQA PIRQB这些register以及操作这些register的function ，Device (LNKA)中的_STA表示现在使用的PIRQ* Status 如果Interrupt Routing Enable bit被disable了，将会report 0x1001表示device is disable and do not decode its resource；_PRS表示该PIRQ* 可以使用的interrupt 范围以及相关的属性（level /edge trigger
- r8 f5 O9 y. \' v; f$ @active low/high shared …）;_CRS表示当前的Interrupt 以及属性，_SRS用设定相应的interrupt及属性；所有这些操作都是对PIRQ* register进行，这些register则通过ACPI OperationRegion的方式宣告出来如下所示：

$ _# \% u- i1 K/ F4 h! Q- EOperationRegion (\_SB.PCI0.SBRG.PIX0, PCI_Config, 0x60, 0x0C)
+ s1 o, f( P! ^' q0 P; G* `
. X3 l3 q2 y  G9 M$ ?! c. HField (\_SB.PCI0.SBRG.PIX0, ByteAcc, NoLock, Preserve)

{

PIRA,
8,

PIRB,
8,
…
/ U+ F2 O. k+ r* f7 `+ Q6 P}
" O, |' ?- p. t8 ]/ PB.APIC Mode回报Routing信息的sample code如下所示：（所有code 均来自google 大神）：
7 o+ V% _/ K6 L/ t6 YName (AR00, Package (0x12)
8 H5 @% K* y; w- f1 G4 |$ ^
{
# e$ D# }& h) [' F8 c# T, K4 V$ ^1 Y
Package (0x04)

{

0x0001FFFF,
8 r0 w7 c4 H& D! H+ O  [4 d' }9 s
0x00,

2 K& w" l) j  J; A' v0x00,
) W* E( ?* u  u- E+ E. p5 M
- @1 p. r4 L4 y0x10
, r* q; _9 e0 f: P) K( H4 A
},


Package (0x04)

{
$ R) a! k9 b) S2 F
0x0001FFFF,
" F! G  R; ^$ \9 ^; @
0x01,

. U+ v! X: H" g: y8 W1 i1 d& W, \' W0x00,

) `% j: r$ O7 N" ~! `% Y# Q0x11

},


Package (0x04)
7 S4 }- c* p8 k
{

" a' A3 V* @9 Q( j/ t1 L0x0001FFFF,
5 l; Q5 t6 P* [
! R* e: W% @+ e  i- `0 `0x02,
+ }. {% S' u! w4 B2 _7 m
) L1 g& C  ]+ P9 C0x00,

; ^9 a+ L! b5 q0x12
9 s) ~, @: y: l8 s, c1 e8 v% B, b. N
* S( |0 H( A. X% a},
% x% r6 M: s& n, V
1 h" N/ ]. x( i3 W, I2 ]- V. T8 ?
Package (0x04)

$ ]  e, o: C! S. X( ^2 }6 ?- P  i% G{
$ \6 _+ O8 O0 D, q
0x0001FFFF,
5 H& `1 {6 e3 |& p  W# F
5 ]7 V  V: B! D- s) w3 D: O5 C0x03,
3 e% c  G; i! O; U5 V. `6 U( i: A
0x00,

9 U, }" e1 Q3 q0 e* N" S4 G0x13

! _4 K$ J" g# I& {$ k},


! f4 P/ G$ [; t# Z/ GPackage (0x04)

{

0x001FFFFF,
' H. K6 [0 ?8 ?4 _) b* g, d
. v+ T2 G" i+ p) m+ d" [% [$ e9 o- }5 C0x00,

0x00,

0x12
$ s: F+ `8 N' k; Y6 N7 a
},

$ m+ }9 @( x; A* D7 q' h
Package (0x04)

9 ]3 e" U2 v3 Z; c7 z& }{
2 u% V3 W2 X$ t- [
0x001FFFFF,

0x01,
/ h; h* `9 U( E8 p0 C. T
0x00,
( e! K4 E# p: D% N: g: m
$ j! @& N* ^$ x! {
+ R1 T2 ~( U5 T. Q& a0x13

},
1 p2 n. m  H, h
1 I7 h! Z. o7 D5 ]
Package (0x04)
& }# F9 r6 J0 L* d) n. ^
{

0x001DFFFF,
# S2 A3 ~6 ]+ i( s
  b1 Y" v) P" M0x00,
: u% T: w* `4 \1 m* r! d# d8 ?# M
0x00,
8 r* _7 M) m5 P9 [5 e4 i7 R  X" }. o" p
0x17

8 A7 b% W  {5 I% `5 v},
+ D  t, Z4 N% U' M( r

& l9 z' D' H# z- |+ wPackage (0x04)

8 ?* U. g5 z4 u( E! x/ r8 `{
! u4 ]( m+ n1 v* Z9 S& S
9 O" [5 C! J+ @+ i0x001DFFFF,
% n; y2 F; i, m/ Z
0x01,
( y  v/ _# x; Y  i3 q; r5 H! D4 Q
& d  q( x8 ?: w$ ]" t( W7 W4 W1 [0x00,

5 E0 V% F+ i( ^7 @1 k+ b0 M! x0x13
8 Z; C" ~2 j1 d- G# N/ ]: h, f2 b
# ^3 k" I# U& D+ J},
9 @) {  W/ s  H- u% Q# Q2 A- B

Package (0x04)
/ w! L$ H" n6 f& I. M9 R
{

0x001DFFFF,
; [! m( V! V. @* H  e
% y6 u1 f) z2 q+ {# z& g4 f0x02,
7 ~' K9 w: t, f5 O$ }
1 |" n" \4 z, x/ x2 Y$ L5 K0x00,
0 S4 H' v; ^! n. M3 m; [3 Y% |
0x12


. K2 F6 J  a  P7 z3 P7 N},
8 T! W8 Y4 o) n1 S) ?
# x4 r6 L# t9 v4 ~' Q3 u0 N
' G0 x: R5 L: {! VPackage (0x04)

{

0x001DFFFF,

4 |9 u: |/ U6 P5 M  s8 O2 L9 j- i0x03,

0x00,
: l$ C8 q* ~; h* W- j8 z
$ v2 w/ j8 ]3 c- W' F& I9 L0x10

$ ?; M- R$ \+ ^0 Z+ j$ K$ G+ x+ p},
" i' ?7 ~0 ~! i# G% C

+ l3 t; s/ n1 V…
( E2 ]$ d1 C* _1 |" w/ I+ V' q% s
! j" J1 N. R0 w+ W9 B5 l( }})
5 S7 ?9 E8 x' y. l* Q+ ]
2 G* x/ n, O: a5 D) ^1 K2 zDevice (PCI0)

* V/ x, G+ x! N3 `2 a{

2 V9 ?& Y( B' G( n5 X


9 F1 e2 h" Y+ OName (_HID, EisaId ("PNP0A08"))
) j" ?+ ~& ?+ W/ m; P8 q. [
Name (_CID, 0x030AD041)

7 b8 a3 O3 G' X+ I* l0 f' K0 JName (_ADR, 0x00)
, Q+ v/ g: l5 _; E: |" ]. i: r6 Y


Method (_PRT, 0, NotSerialized)

. d2 f0 T& Z! e% _3 C. \{

If (PICM)

{
4 V5 L8 s3 @2 ?0 A6 \* p
- ?$ \9 l; Z' T. r# RReturn (AR00)
' E7 o* I7 ^. u1 S- I
% x- Q( {, ?8 \$ q) \}

0 N, j, ]; z( s6 E; s# Y7 o
Return (PR00)
4 W5 S: j' V9 i. f
  q( a. H+ P: N, W}
6 S' c$ [, _. c/ ]& P5 k
…
}
3 r: o6 L' \/ O% {) eAPIC Mode _PRT就比较简单了，Package AR00回报bus 0 device 0x1f INTA#直接连接到APIC INTIN16 ，INTB#连接到INTIN17，INTC#连接到INTIN18, INTD#连接到INTIN19等等，在ACPI OS下会有APIC相关的driver根据这些信息设置REDIR_TBL中每个INITIN* 的属性及中断向量等信息。
$ b3 N' V$ f% o' y) MSBIOS如果需要更改Routing信息，就可以按照上面的sample code的做法去修改AR00 PR00 package中的设置。另外关于APIC（I/O APIC ,LAPIC）Base
) z! g; v, e4 uAddress GlobalIrqBase…等信息 SBIOS会通过Multiple APIC Description Table (MADT) 回报给ACPI OS，这样OS下的driver就可以直接配置和处理与APIC相关的中断的产生、处理、属性等。

! a! G5 P  Z% p( K% ]) @
5 p5 \- N- ?& V1 bRefer：
《PCI IRQ Routing Table Specification》
《PCI IRQ Routing on a Multiprocessor ACPI System》
/ e; Y( O; Y9 }1 l: u9 y0 B《ACPI Spec 3.0》

: O" n5 K, Y$ z) I  [

Peter
" S+ P+ e) }0 J0 n2010-10-29
! j5 _- p, }! ~9 O" h/ _6 F

1 p, p. b) h0 d1 q
7 f' L' z2 [; R! |8 E[ 本帖最后由 peterhu 于 2010-10-29 16:22 编辑 ]