IRQ, zero-latency IRQ, CPU 예외는 다른 경로다
Zephyr 3.7.0의 보통 IRQ는 ISR 문맥에서 장치 사건을 짧게 처리하고, 필요하면 세마포어 또는 work item을 통해 스레드에 후속 작업을 넘긴다. 이것은 선택 가능한 오프로딩 방식이다. 모든 IRQ가 workqueue를 거치거나 스레드를 깨우는 것은 아니다. ISR 종료 후 어느 스레드가 실행되는지도 준비 상태와 우선순위에 달려 있다.
이 글은 v3.7.0 태그의 공통 API 계약과 ARM Cortex-M 원본의 해당 부분을 다룬다. 실제 벡터 진입, IRQ 우선순위, 중첩, stack 사용, direct ISR 구현은 아키텍처·보드·빌드 설정에 따라 달라진다. zero-latency IRQ 지원 범위는 v3.7.0 문서가 명시한 ARM Cortex-M으로 제한한다.
좁은 화면에서는 아래 그림을 좌우로 밀어 각 분기를 볼 수 있다.
그림의 일반 IRQ 순서는 한 CPU에서의 흐름이다. 위임 없는 ISR 반환은 위쪽 점선, 선택적 위임은 가운데 실선이다. 세마포어와 workqueue는 대안이다. zero-latency 표기는 CONFIG_ZERO_LATENCY_IRQS와 IRQ_ZERO_LATENCY를 사용한 Cortex-M 경로에 한정한다. CPU fault의 제한된 복구와 미등록 IRQ의 spurious fatal은 서로 다른 분기다. 좁은 화면에서는 그림을 좌우로 스크롤할 수 있다.
고정 원본과 공식 문서
원본 링크는 Zephyr v3.7.0이 가리키는 commit 36940db938a8f4a1e919496793ed439850a221c2에 고정했다. API의 사용 범위는 같은 버전의 Interrupts, Workqueue Threads, Semaphores, Fatal Errors를 기준으로 했다.
좁은 화면에서는 아래 출처표와 진단표를 좌우로 밀어 나머지 열을 볼 수 있다.
| 고정 원본 | 확인 범위 | 적용 범위 |
|---|---|---|
include/zephyr/irq.h | IRQ_CONNECT 인수는 빌드 시 계산 가능해야 함(30–47행); dynamic 대안(49–67행) | 공개 API 계약 |
arch/arm/core/cortex_m/irq_manage.c | zero-latency priority 경로는 문서의 아키텍처 제한과 함께 확인 | ARM Cortex-M 전용; 다른 아키텍처로 일반화하지 않음 |
arch/arm/core/cortex_m/fault.c | fault_handle() 뒤 제한된 recoverable 분기는 반환(1119–1122행), 나머지는 fatal(1157행) | ARM Cortex-M 전용 |
kernel/work.c | 이미 queued이면 재제출을 무시(335–367행); k_work_submit()은 system queue에 제출(421–430행) | 오프로딩을 선택한 경우 |
kernel/fatal.c | fatal reason 이후 정책 핸들러 구현 | 일반 ISR 완료 경로와 별도 |
이 글의 짧은 C 조각은 독립 빌드 파일이 아닌 설명용 사용 예다. IRQ_CONNECT의 번호·우선순위·ISR·인수·flags는 빌드 시 컴파일러가 계산할 수 있어야 하며, 실제 장치의 devicetree node와 초기화 순서는 제품 설정으로 확인해야 한다. 하드웨어 IRQ entry와 fatal decoding은 해당 보드의 아키텍처 소스로 이어서 검증해야 한다.
IRQ 연결과 두 가지 오프로딩 예
1. 연결과 enable은 별개
/* UART_NODE는 실제 보드의 devicetree node로 정의 */
IRQ_CONNECT(DT_IRQN(UART_NODE), DT_IRQ(UART_NODE, priority),
uart_isr, DEVICE_DT_GET(UART_NODE), 0);
irq_enable(DT_IRQN(UART_NODE));
기존 예의 핵심인 IRQ_CONNECT와 irq_enable을 유지했다. 전자는 handler 연결을, 후자는 해당 IRQ line의 enable을 다룬다. 빌드 시 상수 제약 때문에 동적으로 바꿀 경우 CONFIG_DYNAMIC_INTERRUPTS와 irq_connect_dynamic()을 별도로 검토한다. IRQ_DIRECT_CONNECT는 오버헤드를 줄이는 또 다른 형태이며 일반 ISR의 모든 편의 기능을 그대로 갖는다고 가정하지 않는다.
2. 일반 ISR에서 세마포어로 알리기
/* 설명용: rx_sem과 장치 수명은 사전에 보장 */
static void uart_isr(const void *arg)
{
read_fifo_fast(arg);
k_sem_give(&rx_sem);
}
read_fifo_fast()는 장치의 IRQ 원인을 확인·해제하고 필요한 데이터를 보관해야 할 자리를 나타낸다. 실제 Zephyr API 이름이 아니다. k_sem_give()는 대기 스레드를 ready로 만들 수 있지만, ISR 반환 직후 반드시 실행된다는 뜻은 아니다. ISR에서는 block하는 세마포어 취득이나 sleep을 하지 않는다. 이 예는 보통 ISR에 대한 것이며 zero-latency ISR로 옮기면 안 된다. semaphore 한계값이 1이라면 모든 IRQ 발생 횟수를 보존하지 않는다.
3. 일반 ISR에서 workqueue로 제출하기
static void rx_work_handler(struct k_work *work);
K_WORK_DEFINE(rx_work, rx_work_handler);
static void uart_isr(const void *arg)
{
/* 장치의 interrupt 원인 처리는 실제 드라이버에 맞춘다. */
k_work_submit(&rx_work);
}
K_WORK_DEFINE는 item을 정적으로 초기화하고, k_work_submit은 system workqueue에 제출할 뿐 handler를 그 자리에서 실행하지 않는다. handler는 나중에 queue의 스레드 문맥에서 실행된다. v3.7.0 반환값 0은 이미 queued, 1은 새로 queued, 2는 실행 중 재제출, 음수는 거절·오류를 뜻한다. 이미 queued인 같은 item을 다시 제출해도 이벤트별 실행 횟수가 누적되지 않는다. 매 사건을 보존하려면 별도 카운터나 버퍼가 필요하고, 오래 block하는 handler는 뒤의 item을 지연시킨다.
실행 문맥과 API 경계
| 경로 | 연결·진입 | 커널과의 경계 | 후속 실행 |
|---|---|---|---|
| 보통 IRQ | IRQ_CONNECT 등, ISR 문맥 | ISR에서 허용된 non-blocking API만 사용 | 세마포어·work 제출은 선택; 같은 CPU는 ISR 종료 후 스케줄, SMP의 다른 CPU 실행은 별도 |
| direct IRQ | IRQ_DIRECT_CONNECT, ISR_DIRECT_DECLARE | 일반 ISR과 인자 전달·스택·PM·스케줄 판단 계약이 다름. direct만으로 모든 커널 API가 금지되지는 않음 | direct ISR 반환값은 재스케줄 판단과 관련 |
| zero-latency IRQ | CONFIG_ZERO_LATENCY_IRQS + IRQ_ZERO_LATENCY; regular/direct 연결과 조합 가능 | 모든 커널 API 사용을 정의되지 않은 동작으로 취급; 커널이 검사하는 데이터 변경·동기 예외 유발 금지 | IRQ lock의 차단을 우회하는 v3.7.0 Cortex-M 구현 |
| workqueue handler | 일반 ISR 등에서 제출 후 queue 스레드에서 실행 | 스레드용 API 사용 가능하지만 장시간 block은 뒤 항목을 지연 | system 또는 별도 workqueue |
| CPU 예외·치명 오류 | CPU fault, spurious IRQ, assertion 등 | ISR 오프로딩 경로와 별도 | 원인·아키텍처별 분류 뒤 fatal policy 또는 제한된 복구 |
direct와 zero-latency는 동의어가 아니다. direct는 공통 IRQ 처리 일부를 건너뛰는 방식이고, zero-latency는 IRQ lock에 막히지 않는 우선순위 영역과 엄격한 커널 격리 계약이다. Zephyr 3.7.0 문서는 zero-latency ISR에서 모든 커널 API 사용을 정의되지 않은 동작으로 취급하며, 커널 API가 검사하는 데이터를 바꾸거나 동기 처리해야 할 예외를 만들지 말라고 한다. 당시 구현 범위는 ARM Cortex-M이다.
연결에서 실행까지 무엇을 확인할까
- 연결 방식:
IRQ_CONNECT, direct, dynamic 중 무엇을 선택했는지 확인한다. dynamic 연결에는CONFIG_DYNAMIC_INTERRUPTS가 필요하다. - 실제 IRQ line: 보드의 IRQ 번호와 priority, flags,
irq_enable()시점이 드라이버가 기대한 것과 맞는지 확인한다. 공유 IRQ는CONFIG_SHARED_INTERRUPTS같은 별도 설정이 필요하다. - ISR 문맥: 오래 걸리는 처리, block 가능한 호출, stack 사용량을 분리한다. offload를 썼다면 세마포어 대기 스레드 또는 workqueue의 우선순위를 확인한다.
- 완료 조건: IRQ 원인이 적절히 처리됐는지, ISR이 끝난 뒤 실제로 어떤 스레드가 실행됐는지 측정한다. wake-up은 실행 완료와 같지 않다.
원본의 분기를 보면 오해를 줄일 수 있다. kernel/work.c:366–368는 이미 queued인 항목을 그대로 두며, fault.c:1119–1122는 제한된 recoverable 분기가 반환할 수 있음을 보인다. 따라서 재제출 횟수와 처리 횟수, 모든 CPU fault와 fatal 종료를 각각 동일시하지 않는다.
CPU 예외와 치명 오류의 경계
핸들러가 없는 IRQ line에 인터럽트가 들어오면 K_ERR_SPURIOUS_IRQ fatal로 분류된다. CPU fault는 아키텍처별 처리에서 분류한다. Cortex-M의 z_arm_fault()는 특정 recoverable 판정에서만 반환하고, 나머지는 fatal 경로로 간다. 일반 CPU 예외 분류는 K_ERR_CPU_EXCEPTION이며, Cortex-M은 아키텍처별 세부 reason도 전달할 수 있다. CONFIG_SIMPLIFIED_EXCEPTION_CODES가 켜지면 아키텍처 reason을 일반 CPU 예외 코드로 단순화한다. stack overflow 검출은 보호 기능과 설정에 따라 감지 시점과 보장 수준이 다르다.
| 사건 | 분류·관찰 | 정책상 주의점 |
|---|---|---|
| 예상 밖 IRQ | K_ERR_SPURIOUS_IRQ, 설치된 handler와 line 확인 | 일반 offload 지연 문제와 먼저 구분 |
| 처리되지 않은 CPU fault | K_ERR_CPU_EXCEPTION, 아키텍처별 fault 정보 | Cortex-M fault 구현을 모든 CPU에 일반화하지 않음 |
| stack overflow 감지 | K_ERR_STACK_CHK_FAIL, 보호 기능·설정별 조건 | 감지 이전 데이터 손상을 배제할 수 없음 |
k_oops() | K_ERR_KERNEL_OOPS; 애플리케이션 논리의 복구 불가 조건을 표시 | fatal handler 정책과 faulting thread 중단 조건 확인 |
k_panic() | K_ERR_KERNEL_PANIC; kernel의 복구 불가 상태 | panic에서 사용자 fatal handler가 return하지 않아야 함 |
| fatal policy handler | k_sys_fatal_error_handler() | 기본 구현은 halt; 사용자 구현이 반환하면 faulting thread abort 가능하지만, kernel 상태가 이미 일관되지 않을 수 있음 |
이 표의 마지막 행은 “예외 후 계속 실행해도 안전하다”는 보장이 아니다. Zephyr 문서는 kernel panic이 회복 불가능하며, user mode 밖의 오류 뒤에는 kernel object API 동작도 신뢰하기 어려울 수 있다고 경고한다.
증상별 첫 진단표
| 증상 | 첫 확인 | 분리할 가설 |
|---|---|---|
| ISR이 한 번도 호출되지 않음 | line 번호, 연결 flags, irq_enable(), 장치의 IRQ mask | 연결과 enable 누락, 보드 IRQ 정보 불일치 |
| ISR은 돌지만 소비 스레드가 늦음 | ISR 종료 시점, 스레드 priority, workqueue 적체 | wake-up 누락과 스케줄 지연을 구분 |
| 같은 work를 여러 번 제출했는데 한 번 실행 | work item의 queued/running 상태 | 이미 큐에 있던 항목 재제출은 이벤트 카운트가 아님 |
| IRQ lock 중에도 특정 ISR 진입 | zero-latency 설정과 flags, 대상 아키텍처 | IRQ lock 우회가 설정된 경로인지 확인 |
| fatal log 뒤 정지 | reason code, fault PC·레지스터, fatal policy | spurious IRQ / CPU fault / oops / panic을 구분 |
UART 수신 예: 신호와 처리는 두 단계다
UART ISR이 FIFO의 수신 데이터를 읽고 k_sem_give()로 대기 스레드를 ready로 만들 수 있다. 같은 CPU의 일반 스레드는 ISR 문맥을 벗어난 뒤 실행할 수 있다. SMP에서는 깨운 스레드가 다른 CPU에서 먼저 실행될 수 있으므로 ISR 반환을 데이터 수명의 동기화 장벽으로 삼으면 안 된다. 더 오래 걸리는 parsing은 그 스레드 또는 work handler에서 수행한다. 이때 어떤 스레드가 먼저 실행되는지는 priority와 현재 스레드의 상태에 따라 달라진다.
workqueue 방식을 선택한 경우에는 k_work_submit()을 호출했다고 매 UART 이벤트가 독립 항목으로 저장되는 것이 아니다. 이미 queued인 같은 work item은 한 번만 처리될 수 있다. 손실 없이 프레임을 받아야 한다면 ISR 단계의 ring buffer와 생산/소비 카운트를 따로 설계하고, work item은 “읽을 데이터가 있다”는 신호로 취급한다.
Linux와 비교할 때
Linux의 top half/bottom half 용어를 그대로 대입하면 Zephyr의 선택지가 가려진다. 이 페이지에서는 IRQ entry, 일반 ISR, zero-latency/direct 특수 경로, 세마포어로 깨어난 스레드, workqueue handler를 각각 분리했다. 둘 다 오래 걸리는 작업을 IRQ 문맥 밖으로 옮길 수 있지만, 구체적인 등록 방식과 API 허용 범위는 Zephyr 3.7.0 문서와 해당 보드 구현에서 확인해야 한다.
재현과 관찰 지점
IRQ 번호와 설정은 소스의 예제 상수보다 실제 빌드 결과에서 확인한다. ISR 진입·종료, offload 제출, 소비 스레드 시작 시각을 각각 기록하면 “IRQ 지연”과 “스레드 실행 지연”을 구분할 수 있다. fatal이 나면 같은 로그에 reason code와 fault PC를 남기고, 기본 fatal policy와 사용자 override 여부를 확인한다.
| 경계 | 기록할 값 | 해석 |
|---|---|---|
| 하드웨어 IRQ → ISR | IRQ line, 진입 시각, 원인 register | 연결·mask·priority 문제 |
| ISR → offload | 제출 결과, semaphore count 또는 work 상태 | 신호 누락과 이미 queued 상태 구분 |
| ISR 반환 → 스레드 실행 | ISR 종료, 소비자 시작 시각, priority | 스케줄·workqueue 적체 분리 |
| 예외 → fatal policy | reason code, fault PC, 현재 thread | IRQ 경로 문제와 CPU fault 구분 |