인터럽트가 handler에 도달하지 않는 이유
`/proc/interrupts`가 증가하지 않을 때 driver handler부터 의심하지 않고, 신호선·trigger type·GIC pending·CPU interface·irqdomain 중 처음 끊긴 경계를 어떻게 찾을 것인가?
GIC 상태와 처리 완료 조건
| 구분 | 확인할 내용 |
|---|---|
| 입력 | 주변장치가 만든 level 또는 edge interrupt와 올바른 SPI/PPI 번호, 전원이 켜진 GICD/GICR |
| 출력 | 대상 PE가 INTID를 acknowledge하고 Linux가 등록된 irqaction handler를 실행한 뒤 interrupt가 해제됨 |
| 소유권 | 장치 status는 device driver, SPI routing과 priority는 GIC, virq와 handler 연결은 Linux irqdomain/IRQ core가 소유 |
| 완료 조건 | 장치 원인이 제거되고 EOIR/DIR 처리가 끝나 동일 원인으로 pending이 즉시 재발하지 않음 |
핀 입력에서 Linux IRQ까지
1. Board signal
장치 interrupt 핀의 전압 도메인, pull, polarity, edge/level 특성을 회로도와 datasheet에서 확정합니다. Shared line이면 모든 장치가 deassert할 조건도 적습니다.
2. GIC Distributor
SPI의 group, enable, priority, trigger, target affinity를 GICD 레지스터에서 확인합니다. GICD_ISPENDR만 보고 끝내지 말고 ICFGR과 IROUTER가 실제 wiring 의도와 같은지 함께 봅니다.
3. Redistributor
각 PE의 GICR_WAKER.ChildrenAsleep을 기다리고 SGI/PPI enable, priority, group을 per-CPU Redistributor frame에서 설정합니다. CPU hotplug 때 이 상태는 다시 초기화됩니다.
4. CPU interface
ICC_SRE_EL1로 system register interface를 사용하고 ICC_PMR_EL1, ICC_BPR1_EL1, ICC_IGRPEN1_EL1이 interrupt를 허용하는지 확인합니다. PSTATE.I도 unmask되어야 합니다.
5. Acknowledge
IRQ exception 진입 후 ICC_IAR1_EL1을 읽으면 가장 높은 우선순위의 INTID가 active 상태가 됩니다. 1020~1023은 일반 장치 IRQ가 아니라 special/spurious ID입니다.
6. Firmware description
Device Tree의 interrupt-parent와 `<type number flags>`가 GIC binding에 맞아야 합니다. SPI/PPI type 숫자와 Linux hwirq 변환을 섞으면 정상 핀도 다른 INTID에 연결됩니다.
7. Linux irqdomain
GIC irqdomain이 fwspec을 hwirq로 번역하고 virq를 할당합니다. gic_handle_irq()는 진입 문맥에 맞는 함수를 호출합니다. 일반 IRQ 경로에서는 하위 함수가 IAR에서 INTID를 읽고 generic_handle_domain_irq()로 전달하면 IRQ core가 irq_desc와 irqaction을 찾습니다.
8. Driver completion
level interrupt는 handler가 장치 status를 clear한 뒤 EOI해야 합니다. 원인을 지우지 않으면 EOI 직후 다시 pending되어 interrupt storm이 생기므로 장치 register와 GIC state를 한 쌍으로 검증합니다.
인터럽트 번호와 처리 경로
주변장치가 만든 level 또는 edge interrupt와 올바른 SPI/PPI 번호, 전원이 켜진 GICD/GICR
장치 status는 device driver, SPI routing과 priority는 GIC, virq와 handler 연결은 Linux irqdomain/IRQ core가 소유
대상 PE가 INTID를 acknowledge하고 Linux가 등록된 irqaction handler를 실행한 뒤 interrupt가 해제됨
장치 원인이 제거되고 EOIR/DIR 처리가 끝나 동일 원인으로 pending이 즉시 재발하지 않음
GICv3의 pin에서 irq_desc까지 이어 읽는 상세 매뉴얼
SPI/PPI/SGI/LPI 번호 공간, Distributor, Redistributor, ICC_* system register CPU interface와 ITS를 분리합니다. 장치 status에서 시작해 GIC pending/active, INTID acknowledge, irqdomain mapping, Linux handler와 EOI까지 같은 interrupt 사건을 추적합니다.
공개적으로 다시 확인할 수 있는 자료
공개되지 않은 제조사 레지스터나 제품별 오프셋은 추측하지 않았습니다. 아래의 제조사 자료, 아키텍처 문서, Linux v6.18.37 원본으로 확인할 수 있는 내용만 다뤘습니다.
Arm GICv3/v4 overview
GICD, GICR, CPU interface, interrupt state와 routing
Linux GICv3 driver
GIC 초기화, irqdomain, handle_irq와 affinity
Linux GICv3 ITS driver
LPI와 MSI DeviceID/EventID translation
Linux IRQ domain
firmware hwirq와 Linux virq mapping
읽어야 할 상태와 해석
같은 동작에 대한 활성화 상태, 처리 상태, 자원 소유권, 완료 레지스터 값을 함께 기록합니다. 읽으면 지워지는 비트나 1을 써야 지워지는 비트가 있는지는 먼저 데이터시트에서 확인합니다.
| 레지스터/상태 | 소유 블록 | 검증할 의미 |
|---|---|---|
| GICD_CTLR / TYPER | Distributor | group enable, affinity routing, 구현된 INTID 수 |
| GICD_IGROUPR / IGRPMODR | Distributor | Secure/Non-secure group 분류 |
| GICD_ISENABLER / ISPENDR | Distributor | SPI enable과 pending 상태 |
| GICD_ICFGR / IROUTER | Distributor | edge/level 설정과 PE affinity route |
| GICR_WAKER / ISENABLER0 | Redistributor | PE sleep 상태와 SGI/PPI enable |
| ICC_PMR_EL1 / BPR1_EL1 | CPU interface | priority mask와 preemption grouping |
| ICC_IAR1_EL1 / EOIR1_EL1 / DIR_EL1 | CPU interface | acknowledge, priority drop, deactivate |
| GITS_* tables | ITS | MSI DeviceID/EventID를 LPI와 collection으로 변환 |
Linux v6.18.37 원본 코드와 줄별 해설
라인 번호를 고정해 외우는 대신 함수 선언을 기준으로 Linux v6.18.37 tree에서 다시 찾았습니다. 로컬 tree에 있는 파일은 실제 코드를 직접 싣고, 나머지는 원본 파일과 읽을 함수 좌표를 연결했습니다.
Linux v6.18.37 · 실제 원본 코드
IRQ 진입 문맥에 따라 하위 처리 함수를 선택하는 GICv3 최상위 핸들러
drivers/irqchip/irq-gic-v3.c:964-970
__gic_handle_irq_from_irqson()
__gic_handle_irq_from_irqsoff()
964static void __exception_irq_entry gic_handle_irq(struct pt_regs *regs)
965{
966 if (unlikely(gic_supports_nmi() && !interrupts_enabled(regs)))
967 __gic_handle_irq_from_irqsoff(regs);
968 else
969 __gic_handle_irq_from_irqson(regs);
970}Linux v6.18.37 · 실제 원본 코드
GIC hwirq를 Linux virq chip/handler와 연결하는 irqdomain map
drivers/irqchip/irq-gic-v3.c:1596-1636
1596static int gic_irq_domain_map(struct irq_domain *d, unsigned int irq,
1597 irq_hw_number_t hw)
1598{
1599 struct irq_chip *chip = &gic_chip;
1600 struct irq_data *irqd = irq_desc_get_irq_data(irq_to_desc(irq));
1601
1602 if (static_branch_likely(&supports_deactivate_key))
1603 chip = &gic_eoimode1_chip;
1604
1605 switch (__get_intid_range(hw)) {
1606 case SGI_RANGE:
1607 case PPI_RANGE:
1608 case EPPI_RANGE:
1609 irq_set_percpu_devid(irq);
1610 irq_domain_set_info(d, irq, hw, chip, d->host_data,
1611 handle_percpu_devid_irq, NULL, NULL);
1612 break;
1613
1614 case SPI_RANGE:
1615 case ESPI_RANGE:
1616 irq_domain_set_info(d, irq, hw, chip, d->host_data,
1617 handle_fasteoi_irq, NULL, NULL);
1618 irq_set_probe(irq);
1619 irqd_set_single_target(irqd);
1620 break;
1621
1622 case LPI_RANGE:
1623 if (!gic_dist_supports_lpis())
1624 return -EPERM;
1625 irq_domain_set_info(d, irq, hw, chip, d->host_data,
1626 handle_fasteoi_irq, NULL, NULL);
1627 break;
1628
1629 default:
1630 return -EPERM;
1631 }
1632
1633 /* Prevents SW retriggers which mess up the ACK/EOI ordering */
1634 irqd_set_handle_enforce_irqctx(irqd);
1635 return 0;
1636}Linux v6.18.37 · 원본 좌표
Documentation/devicetree/bindings/interrupt-controller/arm,gic-v3.yaml
firmware가 GIC topology와 interrupt specifier를 기술하는 binding
- 읽을 함수
interrupt-cells- 읽을 함수
redistributor-regions- 읽을 함수
msi-controller
실제 장비에서 확인하는 순서
- Pin
실행 오실로스코프나 logic analyzer로 장치 사건 전후 interrupt 핀을 측정합니다.
통과 기준 예상 polarity로 assert되고 level형이면 status clear까지 유지되어야 합니다.
- Device status
실행 장치의 raw/masked interrupt status와 mask register를 같은 시점에 읽습니다.
통과 기준 raw 원인 bit와 출력 mask 조합이 실제 핀 상태를 설명해야 합니다.
- GIC state
실행 해당 INTID의 enable, pending, active, ICFGR, IROUTER를 debugger 또는 안전한 monitor에서 기록합니다.
통과 기준 핀 assert 뒤 pending이 생기고 acknowledge 뒤 active로 이동해야 합니다.
- CPU entry
실행 trace_irq_handler_entry, function_graph 또는 exception entry counter를 사용합니다.
통과 기준 CPU가 INTID를 받은 횟수와 `/proc/interrupts` 증가량이 부하 조건까지 대응해야 합니다.
- Completion
실행 장치 clear 전후와 EOIR 전후를 구분해 재발 시간을 측정합니다.
통과 기준 level 원인이 먼저 제거되고 EOI 뒤 pending이 남지 않아야 합니다.
처음 끊긴 경계로 원인을 좁히기
| 관측 결과 | 우선 의심할 경계 | 다음 증거 |
|---|---|---|
| 핀 변화 없음 | 장치 기능, power/reset, pad mux, mask 문제 | 장치 raw status와 실제 핀 |
| 핀 assert, GIC pending 없음 | SPI 번호, 전압/배선, polarity/trigger 불일치 | 회로도와 GICD_ISPENDR/ICFGR |
| GIC pending, CPU entry 없음 | IROUTER affinity, PMR, group enable, PSTATE.I 문제 | GICD_IROUTER와 ICC_* |
| CPU entry, handler 없음 | DT specifier 또는 irqdomain mapping 오류 | hwirq/virq와 irq_desc |
| handler 반복 폭주 | level 원인 미해제, 잘못된 EOI 순서, shared IRQ 오판 | 장치 status와 GIC active/pending |
핵심은 마지막 오류 메시지가 아니라 처음 기대값과 달라진 checkpoint입니다. 그보다 아래의 통과 증거와 그 지점의 실패 증거를 한 묶음으로 남겨야 수정의 효과도 검증할 수 있습니다.