이 문서는 디바이스 트리 작성법을 설명한 

http://devicetree.org/Device_Tree_Usage  웹 문서를 

유영창이 안되는 영어 실력으로 발로 번역 및 의역한 것입니다. 

경우에 따라서는 필요하다고 생각되는 내용을 임의로 추가 했습니다. 

그래서 오역 및 잘못된 내용이 있을 수 있습니다. 

7 고급 주제들 

7.1 복잡한 샘플 장치

지금까지 디바이스 트리를 이해하기 위한 기본적인 정의만 다루었습니다. 
이제 좀 더 디바이스 트리를 완벽하게 사용하기 이해서 좀 더 복잡한 하드웨어를 샘플에 추가 할 필요가 있습니다. 

이런 복잡한 하드웨어로 PCI 호스트 브릿지를 추가해 보겠습니다. 
이 샘플 용 PCI 호스트 브릿지는 
0x10180000 를 제어 레지스터 주소로 갖고 
0x80000000 주소를 BARs 영역의 시작 주소를 
갖는 것으로 가정합니다. 
지금까지 사용한 예에 
다음과 같은 PCI 호스트 브릿지 노드를 추가하는 것으로 설명을 시작하겠습니다. 

pci@10180000 {
compatible = "arm,versatile-pci-hostbridge", "pci";
reg = <0x10180000 0x1000>;
interrupts = <8 0>;
};
이 예를 보면 이 PCI 호스트 브릿지는 

제어를 위한 주소가 reg 속성으로 0x10180000 번지부터 크기는 0x1000 의 범위를 가집니다. 
이 번지영역을 이용하여 호스트 브릿지를 제어하게 될겁니다. 
이 호스트 브릿지는 시스템 인터럽트에 8 번 인터럽트를 통해서 인터럽트 처리를 하게 됩니다. 

7.2 PCI 호스트 브릿지

이 섹션은 Host/PCI 브릿지 노드에 대한 설명입니다. 

사전에 양해 드리고 싶은 것은 
이 섹션을 설명할 때 여러분은 이미 PCI 에 대한 기본 지식이 
있을 것이라는 가정을 두고 있습니다 .
이 문서는 PCI 에 대한 학습문서가 아니기 때문에 
관련된 내용의 다른 곳에서 도움을 얻기 바랍니다. 
또한 ePAPR 나 Open Firmware의 PCI Bus Binding에 대한 것을 참조 하시면 많은 도움이 되실 겁니다. 
Freescale MPC5200 에 대한 완벽한 예를 거기서 찾아 보실 수 있습니다. 

7.2.1 PCI 버스 번호 매기기

우선 PCI 버스 번호를 처리하기 위한 보완된 예제를 보겠습니다.

pci@0x10180000 {
compatible = "arm,versatile-pci-hostbridge", "pci";
reg = <0x10180000 0x1000>;
interrupts = <8 0>;
bus-ranges = <0 0>;
};
보통 각각의 PCI 버스들은 해당 버스에 유일한 번호가 매겨집니다. 
이 버스 넘버링은 
위 예에서 보듯이 두개의 셀을 포함하는 bus-ranges 속성을 사용하여 
디바이스 트리내에 PCI 노드로 표현 됩니다. 
이 bus-ranges 속성 값의 
첫번째 셀은 이 노드에 부여된 버스 번호입니다.
즉 0 번 버스라는 의미가 됩니다. 
두번째 셀은 하부의 PCI 버스들의 중 가장 큰 번호를 기술합니다. 
샘플 장치는 하나의 PCI 버스만을 가지기 때문에 이 값은 0이 됩니다. 
7.2.2 PCI 주소 변환

앞에서 다루었던 외부 버스 공간과 비슷하게, 
PCI 주소 공간도 CPU 주소 공간과 하드웨어 적으로 완벽하게 분리되어 있습니다.
그래서 PCI 주소에서 CPU 주소를 얻기 위해서 주소 변환이 필요합니다. 
이 주소 변환에 사용하는 속성은 이전에 설명했던 
ranges
#address-cells
#size-cells 
속성이 사용됩니다. 
이걸 이용해서 주소 변환을 표현하는 예를 보겠습니다.

pci@0x10180000 {
compatible = "arm,versatile-pci-hostbridge", "pci";
reg = <0x10180000 0x1000>;
interrupts = <8 0>;
bus-ranges = <0 0>;

#address-cells = <3>
#size-cells = <2>;
ranges = <0x42000000 0 0x80000000 0x80000000 0 0x20000000
 0x02000000 0 0xa0000000 0xa0000000 0 0x10000000
 0x01000000 0 0x00000000 0xb0000000 0 0x01000000>;
};

위 예를 보면, 
자식 주소( PCI 주소)는 3 개의 셀을 사용합니다. 
이것은 #address-cells 속성에 정의 되어 있습니다. 
그리고 PCI 범위는 2개의 셀로 기입됩니다. 
이것은 #size-cells 셀에 정의 되어 있습니다. 
그리고 부모 주소는 1 개의 셀을 사용하고 있습니다. 
이것은 이전에 상위 노드에서 정의 하고 있습니다. 
우선 왜  PCI 주소를 사용하기 위해서 32 비트 셀이 세개가 필요한지 궁금할 것입니다.
이 세개의 셀들은 다음과 같이 phys.hi, phys.mid 그리고 phys.low 의 순서대로 나열한 자식 주소값입니다. 
phys.hi  셀 값의 의미 : npt000ss bbbbbbbb dddddfff rrrrrrrr
phys.mid 셀 값의 의미 : hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
phys.low 셀 값의 의미 : llllllll llllllll llllllll llllllll
PCI 주소는 64 비트 주소폭을 갖습니다 그래서 phys.mid 와 phys.low. 가 ranges 속성값 중 진짜 자식주소로 사용됩니다. 
그런데, 여기서 조금 복잡하지만 관심을 가질 것은 phys.high 입니다. 
이것은 다음과 같은 비트 필드로 구성되어 있습니다. 
n : 재 배치 가능영역 표시 
p : 프리펫치 가능 영역 표시
t : 어드레스 정렬 표시 
ss : 영역 구분 코드 
00 : 환경 설정 영역
01 : I/O 영역
10 : 32 비트 메모리 영역
11 : 64 비트 메모리 영역 
bbbbbbbb : PCI 버스 번호. PCI 는 계층적으로 구성된다. 그래서 서브 버스로 정의될 수 있는
                                           PCI/PCI 브리지를 가질수도 있다. 
ddddd : 디바이스 번호, 보통 IDSEL 신호와 연결되어 있다. 
fff : 기능 번호 . PCI 디바이스가 여러 기능을 가지고 있을 경우 사용된다. 
rrrrrrrr : 레지스터 번호 : PCI 환경 설정 단계에서 사용된다. 

PCI 주소 변환의 목적상 가장 중요한 필드들은 p 와 ss 입니다. 
phys.hi 안에 있는 p 와 ss 의 값은  PCI 주소 공간이 어떤 특성이 있는지를 나타냅니다. 
이제 샘플에 기입된 ranges 속성에 값을 해석하면 
다음과 같이 세가지 영역에 대한 것을 기술하고 있습니다. 
PCI 주소 0x80000000 를 시작주소로 갖고 32 비트 프리페치 가능한 512 MByte 크기의 메모리 영역은 
                호스트 CPU의 0x80000000 에 맵핑됩니다. 
PCI 주소 0xa0000000 를 시작주소로 갖고 32 비트 프리페치가 불 가능한 256MByte 크기의 메모리 영역은 
                호스트 CPU의 0xa0000000 에 맵핑됩니다.

PCI 주소 0x00000000 를 시작주소로 갖는 16 MByte 크기의 I/O 영역 영역은 
                호스트 CPU의 0xb0000000 에 맵핑됩니다.
운영체제 입장에서 보면 phys.hi 비트 필드는 해당 노드를 PCI 브릿지의 영역으로 다룰때 
주소변환 목적에 상관없는 필드는 무시할 수 있고 이와 관련된 정보정도만 필요합니다. 
그래서 주소 변환 목적에 상관없는 필드는 무시할 수 있다. 
경우에 따라서 어떤 운영체제는 추가적인 필드의 마스크에 대한 필요할 수 있습니다 .
이때 운영체제는 해당 필드 마스크 값을 얻기 위해서 PCI 버스 노드 에서 "pci" 문자열을 이용해서 찾을 것입니다. 
이런 경우라면 필요한 phys.hi 비트값들을 기입할 필요도 있습니다. 

7.3 복잡한 인터럽트 맵핑

이제 가장 골치아픈 PCI 인터럽트 매핑을 다룰 차례입니다. 
PCI 디바이스는 #INTA, #INTB, #INTC,  #INTD. 라고 불리는 네개의 신호선을 이용하여 인터럽트를 트리거 할수 있습니다.
만약 하나의 PCI 디바이스가 여러가지 기능을 가지고 있지 않다면 인터럽트를 #INTA 만 사용할 것입니다. 
그러나, 각 PCI 슬롯 또는 디바이스 입장에서 동일한 인터럽트가 나가지만 
인터럽트 컨트롤러에는 다른 입력으로 연결되어 있습니다. 
보통 하드웨어적으로  인터럽트 네게의 라인을 한 라인씩 시프트 되는 방식으로 연결합니다. 
예를 들어 첫번째 슬롯의 #INTA 는 PCI 인터럽트 컨트롤러에 #INTA 로 연결되지만 
두번째 슬롯의 #INTA 는 PCI 인터럽트 컨트롤러에 #INTB 로 연결되고

세번째 슬롯의 #INTA 는 PCI 인터럽트 컨트롤러에 #INTC 로 연결됩니다. 
다른 인터럽트 역시 이와 같이 쉬프트 한 상태로 연결됩니다. 
이런 연결 특성을 표현하기 위해서 
디바이스 트리는 각 PCI 인터럽트 신호를 인터럽트 콘트롤러에 맵핑하는 방법이 필요합니다. 
이런 복잡한 인터럽트 매핑에 관련된 속성은 다음과 같은 것이 있습니다. 
#interrupt-cells
interrupt-map
interrupt-map-mask

이 속성들이 PCI 인터럽트 맵핑을 기술하는데 사용될 수 있습니다. 
사실, 이 속성들은 PCI 버스의 인터럽트 매핑에 한정되어 사용되는 것은 아닙니다 .
이 속성들은 복합적인 인터럽트 맵을 기술할때 필요해서 정의 된 것이지만, 
주로 PCI의 인터럽트 같이 복잡한 인터럽트 매핑을 다룰때 사용 됩니다. 
아래에 이런 복잡한 PCI 인터럽트 매핑 예를 보여 드리겠습니다. 

pci@0x10180000 {
compatible = "arm,versatile-pci-hostbridge", "pci";
reg = <0x10180000 0x1000>;
interrupts = <8 0>;
bus-ranges = <0 0>;

#address-cells = <3>
#size-cells = <2>;
ranges = <0x42000000 0 0x80000000  0x80000000  0 0x20000000
0x02000000 0 0xa0000000  0xa0000000  0 0x10000000
0x01000000 0 0x00000000  0xb0000000  0 0x01000000>;

#interrupt-cells = <1>;
interrupt-map-mask = <0xf800 0 0 7>;
interrupt-map = <0xc000 0 0 1 &intc  9 3 // 1st slot
0xc000 0 0 2 &intc 10 3
0xc000 0 0 3 &intc 11 3
0xc000 0 0 4 &intc 12 3

0xc800 0 0 1 &intc 10 3 // 2nd slot
0xc800 0 0 2 &intc 11 3
0xc800 0 0 3 &intc 12 3
0xc800 0 0 4 &intc  9 3>;
};

이 중에서 가장 먼저 interrupt-map 속성을 설명할 것입니다. 

다음 내용을 이해하기 전에 
복잡한 인터럽트 매핑에 대한 정확한 작업 표현 방법은 
        "Open Firmware Recommended Practice: Interrupt Mapping" 를 참조 하시기 바랍니다.
이 내용을 살펴보면 
interrupt-map 속성은 다음과 같은 형식을 가집니다.
interrupt-map = < 자식_인터럽트_정보1  부모_인터럽트_컨트롤러_정보1  부모_인터럽트_정보1"
                 자식_인터럽트_정보2  부모_인터럽트_컨트롤러_정보2  부모_인터럽트_정보2
                 자식_인터럽트_정보3  부모_인터럽트_컨트롤러_정보3  부모_인터럽트_정보3
  ...
>;   
 
위 예제의 한 부분인 
interrupt-map = <0xc000 0 0 1 &intc  9 3 
에서 정의 한 엔트리
0xc000 0 0 1 &intc  9 3 
를 위 정의에 대입하면 

0xc000 0 0 1 <-- 자식 인터럽트 정보1
&intc <-- 부모 인터럽트 컨트롤러 정보1
9 3 <-- 부모 인터럽트 정보 1
에 해당합니다. 
자식 인터럽트 정보1를 표현하기 위해서 사용하는 셀 수는 
#address-cells
#interrupt-cells
에 의해서 정해집니다. 위 예에서는 다음과 같이 지정되어 있는 것을 보실 수 있습니다. 
#address-cells = <3>
#interrupt-cells = <1>;
여기서 #address-cells 셀수로 표현된 주소 정보가 어떤 의미인지는 뒤에서 자세하게 설명합니다. 
#interrupt-cells 셀 수로 표현되는 것은 자식 인터럽트의 번호를 의미 합니다. 
보통 PCI 디바이스의 하드웨어의 인터럽트 번호를 의미 하는데 0으로 시작하지 않고 
        1 로 시작되는 것에 주의 하시기 바랍니다.
PCI 하드웨어 인터럽트 번호는 1 부터 시작합니다. 
이 PCI 주제 이전에 시스템 인터럽트를 설명할 때, 
시스템 인터럽트는 IRQ  번호 와 해당 인터럽트의 검출 방법에 정보가 필요하기 때문에 
인터럽트의 정보를 표현할 셀 수를 #interrupt-cells 속성을 이용하여 2 개의 셀을 지정했습니다. 
그러나 PCI 인터럽트의 검출은 항상 로우 레벨일 경우만 검출되는 것으로 규정되어 있기 때문에 
위 예에서 보듯이 PCI 인터럽트는 1 개의 셀만 지정하고 있습니다. 
이제 이 자식 디바이스 인터럽트를 받는 부모 인터럽트 컨트롤러 정보를 표현하고 있는 부분을 살펴 보겠습니다. 
예를 보듯이 
&intc
와 같이 표현하고 있습니다. 

이것은 이전 예제에 다음과 같이 표현했을때 
intc: interrupt-controller@10140000 {
compatible = "arm,pl190";
reg = <0x10140000 0x1000 >;
interrupt-controller;
#interrupt-cells = <2>;
};
사용했던 라벨 intc 를 참조 하도록 표현한 것입니다. 

이 표현에서 주의 깊게 보아야 하는 것은 
#interrupt-cells 속성입니다. 
이것은 interrupt-map 속성의 엔트리 중 
부모_인터럽트_정보1 를 지정하는 셀 수로 사용됩니다. 
#interrupt-cells = <2> 
로 지정했기 때문에 

부모_인터럽트_정보1 을 표현하기 위해서  2 개의 셀을 사용한다는 것을 알 수 있습니다.
위 예에서 보듯이 2 개의 셀을 사용해서 표현하고 있고 
9 3
이란 의미는 9 번 인터럽트 번호이며 
PCI 의 인터럽트 검출 레벨은 항상 로우 액티브 이므로
이에 대한 표현 값으로 3을 지정하고 있습니다. 
이제 #address-cells 셀수로 표현된 주소 정보가 어떤 의미인지를 설명하겠습니다. 
위 예를 보면 이 디바이스 트리가 표현하는 샘플 보드는 
interrupt-map 속성의 주석을 보시면 알수 있듯이 
4개의 인터럽트를 가지는 2개의 PCI 슬롯을 가지고 있음을 알수 있습니다. 
그래서 인터럽트 콘트롤러에 8개의 인터럽트 라인에 대한 맵으로 표현하고 있습니다. 
하나의 PCI 버스상에서 각 PCI 디바이스들은 #INTA 등 과 같은 인터럽트 라인을 4 개밖에 없습니다. 
그래서 인터럽트가 발생했을때 어떤 디바이스의 인터럽트인지 구별하는데 문제가 있습니다. 
다행스럽게도, 모든 PCI 디바이스는 사용가능한 유일한 디바이스 번호를 가지고 있습니다.
그래서 이 디바이스 번호를 추출해야 하는데 
이것은 앞에서 다룬 다음과 같은
phys.hi  셀 값의 의미 : npt000ss bbbbbbbb dddddfff rrrrrrrr
phys.mid 셀 값의 의미 : hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh
phys.low 셀 값의 의미 : llllllll llllllll llllllll llllllll

주소 정보 중에서 phys.hi 의 정보중 디바이스 번호의 비트 필드 정보가 필요합니다. 
이 부분을 앞에서 설명했던 부분을 다시 한번 나열해 보겠습니다. 
n : 재 배치 가능영역 표시 
p : 프리펫치 가능 영역 표시
t : 어드레스 정렬 표시 
ss : 영역 구분 코드 
00 : 환경 설정 영역
01 : I/O 영역
10 : 32 비트 메모리 영역
11 : 64 비트 메모리 영역 
bbbbbbbb : PCI 버스 번호. PCI 는 계층적으로 구성된다. 그래서 서브 버스로 정의될 수 있는
                                          PCI/PCI 브리지를 가질수도 있다. 
ddddd : 디바이스 번호, 보통 IDSEL 신호와 연결되어 있다. 
fff : 기능 번호 . PCI 디바이스가 여러 기능을 가지고 있을 경우 사용된다. 
rrrrrrrr : 레지스터 번호 : PCI 환경 설정 단계에서 사용된다. 

이 중에 
ddddd : 디바이스 번호, 보통 IDSEL 신호와 연결되어 있다. 
부분이 필요합니다. 

이 부분의 정보를 다루기 위해서 
#address-cells

에 지정된 셀 수의 정보를 나열한 것입니다. 
이때 디바이스 번호의 비트 필드 이외에는 필요 없는 정보이므로 
필요한 ddddd 정보 영역에 대한 것만 다음과 같이 나열한 것입니다 .
0xc000 0 0 
여기서 이 주소 정보의 셀은 
#address-cells = <3>
로 지정하고 있습니다. 

여기에 이 주소를 비트 마스크 하여 원하는 비트의 유효범위를 지정하기 위해서 

interrupt-map-mask = <0xf800 0 0 7>;
와 같이 지정하고 있는데 

0xf800 0 0
는 주소 정보를 추출하기 위한 비트 마스크 값이고 
7
은 인터럽트 번호를 추출하기 위한 비트 마스크 값이 됩니다

이제 interrupt-map 속성을 좀 더 설명해 보겠습니다. 

개별적인 PCI 디바이스의 인터럽트를 구별하기 위해서는 PCI 디바이스 번호와 PCI 인터럽트 번호로 
        구성된 묶음이 필요합니다. 
좀 더 쉽게 이야기 하면, 4개의 셀을 가지고 있는 자식 디바이스의 인터럽트 정보 값을 만들어야 합니다.
phys.hi, phys.mid, phys.low 의 각각에 해당하는 값을 기술하고 이를 위해서 
        #address-cells 속성 값은 3 으로 지정하고 있습니다. 
#INTA, #INTB, #INTC, #INTD 중 하나를 지정하기 위해서 #interrupt-cell 속성값은 1로 지정하고 있습니다. 

interrupt-map-mask 속성은 자식 디바이스 인터럽트 정보와 같이 4개의 셀로 구성됩니다. 
마스크 값의 각 비트들을 1로 사용하여 필드의 비트중 유요한 비트임을 표시합니다. 
이제 위 예제에 표현된 것을 정리 해 보겠습니다. 
이 예에서는 , PCI 슬롯 1 은 디바이스 id 24(0x18)을 부여합니다. 
그리고 PCI 슬롯 2 는 디바이스 id 25(0x19)를 부여합니다. 
이 값에 의해서 각 슬롯별 phys.hi 의 값은 결정합니다 
아래처럼 비트 필드의 ddddd 섹션 을 11 비트 만큼 쉬프트해서 디바이스 번호를 얻게 됩니다. 
그래서 
슬롯 1 에 대한 phys.hi 는 0xC000 이고 
슬롯 2 에 대한 phys.hi 는 0xC800 입니다. 
이 모든 것을 담은 interrupt-map 속성은 아래의 내용을 보여 준다. 
슬롯 1 의 #INTA 는 IRQ9  입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
슬롯 1 의 #INTB 는 IRQ10 입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
슬롯 1 의 #INTC 는 IRQ11 입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
슬롯 1 의 #INTD 는 IRQ12 입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
그리고 
슬롯 2 의 #INTA 는 IRQ10 입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
슬롯 2 의 #INTB 는 IRQ11 입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
슬롯 2 의 #INTC 는 IRQ12 입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
슬롯 2 의 #INTD 는 IRQ9  입니다. 주 인터럽트 콘트롤에서 로우 레벨일때 인식됩니다. 
interrupts = <8 0>; 라고 표현된 속성은 호스트/PCI-브릿지 컨트롤러 자신에게 트리거 될 수 있는 인터럽트들을 기술합니다.
이런 인터럽트들은 PCI 디바이스들이 트리거 할 수 있는 인터럽트들과 혼합하지 마시기 바랍니다. 
마지막으로 설명할 것은. 
interrupt-parent 속성인데 
interrupt-map 속성은 모든 자식 및 손자들 노드들에 대해서 디폴트 인터럽트 콘트롤러를 바꿀 수 있습니다. 
이 PCI 예제에서는, PCI 호스트 브릿지가 디폴트 인터럽트 컨트롤러가 된다는 것을 표현하고 있음을 앞에서 설명했습니다. 
만약에 PCI 버스를 통해 연결된 디바이스가 또 다른 인터럽트 컨트롤러에 바로 연결되어 있다면,
interrupt-parent 속성을 가지도록 기술되어야 합니다 .

아....

드디어 발로한 번역이 끝났습니다. 

새벽 1시 16분이군요...

집에 가야죠 ㅠㅠㅠ


이 게시물을...