← Hardware

Hardware 05 · Interrupt · Linux v6.18.37

Arm GICv3: 핀 입력에서 Linux IRQ handler까지

주변장치의 interrupt 출력이 GIC Distributor와 Redistributor를 지나 CPU의 IRQ exception이 되고, Linux irqdomain을 통해 device driver handler로 전달되는 전 과정을 추적합니다.

분석 범위
보드에서 Linux까지 8단계
그림
4 boundary diagrams
원본 코드
2 excerpts · 48 lines
기준
Linux v6.18.37

인터럽트가 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. 단계별 확인 지점
01
1. Board signal
START
02
2. GIC Distributor
CHECKPOINT
03
3. Redistributor
CHECKPOINT
04
4. CPU interface
CHECKPOINT
05
5. Acknowledge
CHECKPOINT
06
6. Firmware description
CHECKPOINT
07
7. Linux irqdomain
CHECKPOINT
08
8. Driver completion
LINUX / RESULT
01

1. Board signal

장치 interrupt 핀의 전압 도메인, pull, polarity, edge/level 특성을 회로도와 datasheet에서 확정합니다. Shared line이면 모든 장치가 deassert할 조건도 적습니다.

02

2. GIC Distributor

SPI의 group, enable, priority, trigger, target affinity를 GICD 레지스터에서 확인합니다. GICD_ISPENDR만 보고 끝내지 말고 ICFGR과 IROUTER가 실제 wiring 의도와 같은지 함께 봅니다.

03

3. Redistributor

각 PE의 GICR_WAKER.ChildrenAsleep을 기다리고 SGI/PPI enable, priority, group을 per-CPU Redistributor frame에서 설정합니다. CPU hotplug 때 이 상태는 다시 초기화됩니다.

04

4. CPU interface

ICC_SRE_EL1로 system register interface를 사용하고 ICC_PMR_EL1, ICC_BPR1_EL1, ICC_IGRPEN1_EL1이 interrupt를 허용하는지 확인합니다. PSTATE.I도 unmask되어야 합니다.

05

5. Acknowledge

IRQ exception 진입 후 ICC_IAR1_EL1을 읽으면 가장 높은 우선순위의 INTID가 active 상태가 됩니다. 1020~1023은 일반 장치 IRQ가 아니라 special/spurious ID입니다.

06

6. Firmware description

Device Tree의 interrupt-parent와 `<type number flags>`가 GIC binding에 맞아야 합니다. SPI/PPI type 숫자와 Linux hwirq 변환을 섞으면 정상 핀도 다른 INTID에 연결됩니다.

07

7. Linux irqdomain

GIC irqdomain이 fwspec을 hwirq로 번역하고 virq를 할당합니다. gic_handle_irq()는 진입 문맥에 맞는 함수를 호출합니다. 일반 IRQ 경로에서는 하위 함수가 IAR에서 INTID를 읽고 generic_handle_domain_irq()로 전달하면 IRQ core가 irq_desc와 irqaction을 찾습니다.

08

8. Driver completion

level interrupt는 handler가 장치 status를 clear한 뒤 EOI해야 합니다. 원인을 지우지 않으면 EOI 직후 다시 pending되어 interrupt storm이 생기므로 장치 register와 GIC state를 한 쌍으로 검증합니다.

인터럽트 번호와 처리 경로

그림 2. Interrupt 실행 경로왼쪽부터 신호나 데이터를 처리하는 순서를 나타냅니다. 각 단계에서 확인할 항목을 함께 표시했습니다.
01 Device status=1
02 IRQ pin assert
03 GICD pending
04 priority/route
05 ICC_IAR1_EL1
06 irqdomain
07 driver handler
08 status clear+EOI
그림 3. firmware와 Linux 번호 공간의 연결왼쪽부터 신호나 데이터를 처리하는 순서를 나타냅니다. 각 단계에서 확인할 항목을 함께 표시했습니다.
01 DT interrupt specifier
02 gic_irq_domain_translate
03 hwirq
04 virq/irq_desc
05 request_irq
06 irqaction
07 runtime dispatch
그림 4. 입력, 소유권, 완료 조건의 경계완료 조건을 충족하기 전에는 다음 계층이 해당 자원을 재사용하면 안 됩니다.
INPUT

주변장치가 만든 level 또는 edge interrupt와 올바른 SPI/PPI 번호, 전원이 켜진 GICD/GICR

OWNER

장치 status는 device driver, SPI routing과 priority는 GIC, virq와 handler 연결은 Linux irqdomain/IRQ core가 소유

OUTPUT

대상 PE가 INTID를 acknowledge하고 Linux가 등록된 irqaction handler를 실행한 뒤 interrupt가 해제됨

DONE

장치 원인이 제거되고 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 원본으로 확인할 수 있는 내용만 다뤘습니다.

읽어야 할 상태와 해석

같은 동작에 대한 활성화 상태, 처리 상태, 자원 소유권, 완료 레지스터 값을 함께 기록합니다. 읽으면 지워지는 비트나 1을 써야 지워지는 비트가 있는지는 먼저 데이터시트에서 확인합니다.

레지스터/상태소유 블록검증할 의미
GICD_CTLR / TYPERDistributorgroup enable, affinity routing, 구현된 INTID 수
GICD_IGROUPR / IGRPMODRDistributorSecure/Non-secure group 분류
GICD_ISENABLER / ISPENDRDistributorSPI enable과 pending 상태
GICD_ICFGR / IROUTERDistributoredge/level 설정과 PE affinity route
GICR_WAKER / ISENABLER0RedistributorPE sleep 상태와 SGI/PPI enable
ICC_PMR_EL1 / BPR1_EL1CPU interfacepriority mask와 preemption grouping
ICC_IAR1_EL1 / EOIR1_EL1 / DIR_EL1CPU interfaceacknowledge, priority drop, deactivate
GITS_* tablesITSMSI 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()

__gic_handle_irq()

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

Linux v6.18.37 원본 파일 열기 →

실제 장비에서 확인하는 순서

  1. Pin

    실행 오실로스코프나 logic analyzer로 장치 사건 전후 interrupt 핀을 측정합니다.

    통과 기준 예상 polarity로 assert되고 level형이면 status clear까지 유지되어야 합니다.

  2. Device status

    실행 장치의 raw/masked interrupt status와 mask register를 같은 시점에 읽습니다.

    통과 기준 raw 원인 bit와 출력 mask 조합이 실제 핀 상태를 설명해야 합니다.

  3. GIC state

    실행 해당 INTID의 enable, pending, active, ICFGR, IROUTER를 debugger 또는 안전한 monitor에서 기록합니다.

    통과 기준 핀 assert 뒤 pending이 생기고 acknowledge 뒤 active로 이동해야 합니다.

  4. CPU entry

    실행 trace_irq_handler_entry, function_graph 또는 exception entry counter를 사용합니다.

    통과 기준 CPU가 INTID를 받은 횟수와 `/proc/interrupts` 증가량이 부하 조건까지 대응해야 합니다.

  5. 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입니다. 그보다 아래의 통과 증거와 그 지점의 실패 증거를 한 묶음으로 남겨야 수정의 효과도 검증할 수 있습니다.