Kernel · Zephyr 3.7.0 LTS3 · source + diagram note

Kernel Architecture

부팅 중 어떤 초기화 함수가 언제, 어느 실행 문맥에서 호출되는가. z_cstart()부터 애플리케이션 main()까지 경계를 따라간다.

기준 버전: Zephyr 3.7.0 LTS3 핵심: init level · main thread 고정 소스: 36940db938a8

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

부팅 경계 지도

Zephyr 이미지에는 빌드와 링크 때 배치된 초기화 항목이 들어 있다. 부팅 때 커널은 이 항목을 level과 priority 순서로 실행한다. 여기서 이미지 안에 항목이 있는가, 항목이 언제 호출되는가, 초기화된 장치를 지금 사용할 수 있는가는 서로 다른 질문이다.

아래 그림은 일반적인 멀티스레딩 구성의 부팅 순서를 보여준다. 처음에는 아키텍처 코드가 C 실행 조건을 마련하고 z_cstart()로 들어온다. EARLY와 두 PRE_KERNEL level을 마친 뒤 main thread 문맥으로 넘어가 POST_KERNEL, APPLICATION, 선택적인 SMP 단계를 지나 애플리케이션 main()을 부른다.

그림 1. 초기화 항목의 배치, 초기 부팅 문맥, main thread 문맥
SYS_INIT과 device 초기화 항목은 링크 때 섹션에 배치된다. 런타임에는 아키텍처 시작, z_cstart의 EARLY와 PRE_KERNEL_1·2, main thread 전환, POST_KERNEL, APPLICATION, 선택적 SMP, 애플리케이션 main 순으로 진행한다.

CONFIG_MULTITHREADING=n이면 thread 전환 경로가 달라진다. 그림의 main thread 구분은 멀티스레딩 구성에서의 실행 문맥을 설명한다. 작은 화면에서는 그림을 좌우로 스크롤해 읽을 수 있다.

init level마다 가능한 일이 다르다

SYS_INIT()는 초기화 함수를 level과 priority로 등록한다. level은 큰 부팅 경계이고, 숫자가 낮은 priority가 같은 level에서 먼저 실행된다. priority만 바꾸어 다른 level의 순서를 뒤집을 수는 없다. Zephyr 3.7.0의 시스템 초기화 API는 다음 순서를 정의한다.

단계실행 위치의미와 사용 경계확인할 질문
EARLYz_cstart() 진입 직후아키텍처 커널 초기화보다 먼저 필요한 극초기 작업이 코드는 아직 준비되지 않은 서비스에 기대지 않는가?
PRE_KERNEL_1초기화 문맥 · interrupt stack일반 커널 서비스를 아직 사용할 수 없음. 독립적인 하드웨어 토대를 올림provider가 더 이른 단계에 있는가?
PRE_KERNEL_2초기화 문맥 · interrupt stackPRE_KERNEL_1에서 준비한 장치에 의존 가능. 일반 커널 서비스는 아직 사용 전필요한 PRE_KERNEL_1 장치가 먼저 초기화되는가?
POST_KERNELkernel main thread커널 primitive 사용 가능. 커널 서비스가 필요한 장치를 초기화이 단계에서 요구하는 커널 기능이 실제 구성에 포함됐는가?
APPLICATIONkernel main threadmain() 진입 전의 마지막 일반 초기화 level. 그 뒤에도 정적 thread 준비와 선택적 SMP 처리가 있다앱 코드에 필요한 준비가 여기서 끝나는가?
SMP (선택)CONFIG_SMP 구성SMP 전용 초기화 level. 이 버전의 kernel/init.c에서는 main() 전 경로에 위치멀티코어 여부와 부팅 지연 설정이 무엇인가?

Zephyr의 장치 모델 문서는 PRE_KERNEL_1/2의 init 함수가 interrupt stack에서 실행되고, 일반 커널 서비스를 사용할 수 없다고 명시한다. POST_KERNEL은 main task 문맥이다. 조기 장치 초기화에서 sleep이나 thread 서비스를 전제한다면 priority 숫자만 조정해서 해결되지 않는다.

등록된 함수는 누가 호출하는가

SYS_INIT()는 C 코드에 호출문을 삽입하는 기능이 아니다. 함수 포인터를 가진 init entry를 지정된 섹션에 놓고, linker가 level과 priority 순서로 모은다. 고정 버전 init.h 222–242행에서 매크로가 entry를 만드는 경로를 확인할 수 있다. 런타임의 z_sys_init_run_level()은 고정 버전 kernel/init.c 348–375행처럼 해당 level의 시작과 끝 사이 entry를 순회한다. 사용자 정의 iterable section도 같은 섹션 배치 원리를 쓸 수 있지만, 그 자체가 Zephyr의 부팅 단계가 되는 것은 아니다.

고정 원문: 시스템 함수와 장치 함수의 갈림길

Zephyr v3.7.0 · kernel/init.c 369–374행
if (dev != NULL) {
    result = do_device_init(entry);
} else {
    result = entry->init_fn.sys();
}
sys_trace_sys_init_exit(entry, level, result);

발췌는 들여쓰기만 보기 좋게 정리했다. dev가 있으면 장치 초기화 함수로, 없으면 시스템 함수로 간다. 결과는 tracing에 전달되지만 이 순회 함수의 반환값으로 전파되지 않는다.

설명용 등록 예제

#include <zephyr/init.h>

static int app_setup(void)
{
    return 0;
}

SYS_INIT(app_setup, APPLICATION, 50);

이 코드는 API 형태를 보여 주는 작성 예제이며 고정 커밋 원문의 발췌가 아니다. APPLICATION은 main() 진입 전의 후기 init level이고 50은 그 level 안의 priority다. 시스템 SYS_INIT 함수의 반환값은 이 API 계약에서 무시된다. 오류를 뒤의 호출자에게 전달하는 일반 함수 호출처럼 취급하지 말고, 실패를 어떻게 보고하고 처리할지 별도로 설계해야 한다.

같은 초기화 entry 순회에는 device init도 들어갈 수 있다. 장치 init 결과는 device state에 기록되고, 소비자는 device_is_ready()로 초기화 성공 여부를 확인한다. 따라서 SYS_INIT 콜백 결과와 device readiness를 하나의 공통 상태 전이로 그리면 실제 오류 경계를 잃는다.

z_cstart() 이후에도 초기화가 계속된다

고정 버전 kernel/init.c 645–685행에서 z_cstart()는 EARLY, 아키텍처 초기화, device state 준비, PRE_KERNEL_1, PRE_KERNEL_2를 차례로 처리한다. 멀티스레딩 구성에서는 main thread를 준비해 그 문맥으로 전환한다. 시작 함수 414–461행이 POST_KERNEL과 APPLICATION을 실행하고, 정적 thread 준비와 설정된 SMP 단계를 처리한 뒤 애플리케이션 main()을 호출한다.

따라서 “z_cstart()가 끝난 뒤 main()이 시작한다”는 설명은 중간의 문맥 전환과 후기 init level을 숨긴다. 애플리케이션 진입 함수의 고정 버전 선언은 int main(void)다. 기존 글의 설명용 void main(void) 표기는 이 커널 경로와 맞지 않는다.

CONFIG_MULTITHREADING=n도 지원되는 별도 경로다. 이 경우 Zephyr는 일반적인 thread 전환 대신 구성에 맞는 직접 경로로 배경 초기화와 main()에 들어가므로, 그림의 thread 문맥 설명을 모든 빌드에 적용하지 않는다.

Linux를 읽다가 넘어왔다면: Linux v6.6도 init/main.c 1207–1234행에서 initcall level별 함수를 순회한다. 그러나 여기서 보는 EARLY·PRE_KERNEL_1/2·POST_KERNEL은 Zephyr의 level이다. Linux의 initcall 이름이나 실행 문맥을 이 표에 그대로 대입하지 말고, 각 커널의 등록 매크로와 호출 지점을 따로 따라가야 한다.

main() 진입과 장치 ready는 같은 뜻이 아니다

main()은 자동 부팅 초기화 level 이후 호출되지만, 특정 장치를 사용할 수 있다는 보증은 아니다. 장치 init이 실패했거나 zephyr,deferred-init으로 자동 초기화를 미뤘다면 해당 장치는 아직 준비되지 않았을 수 있다. 소비자는 필요한 device object에 대해 device_is_ready()를 확인해야 한다.

do_device_init()는 초기화 시도가 끝나면 initialized를 참으로 표시하고, 실패한 반환값은 init_res에 기록한다. 따라서 “초기화를 시도했다”와 “성공해서 쓸 수 있다”는 별개다. device_is_ready()로 준비 상태를 확인하는 이유가 여기에 있다.

설명용 사용 경계

#include <zephyr/device.h>

const struct device *dev = DEVICE_DT_GET(DT_ALIAS(uart0));
if (!device_is_ready(dev)) {
    /* 실패 원인 또는 deferred-init 정책을 확인한다. */
}

이 코드는 DT_ALIAS(uart0)가 정의된 보드를 가정한 설명용 조각이다. DEVICE_DT_GET()은 링크된 device object를 가리키며, 그 포인터를 얻었다는 사실만으로 init 성공을 뜻하지 않는다. 실제 앱에서는 alias의 존재와 드라이버 구성도 빌드 산출물에서 확인한다.

정적 semaphore나 message queue의 선언, device init, 애플리케이션의 개별 작업 실패도 각기 다른 수명 주기를 가진다. 이를 하나의 declared → linked → initialized → ready → failed 상태 머신으로 묶으면 부팅 순서와 런타임 오류를 혼동한다.

부팅이 멈춘 위치부터 좁힌다

초기화 실패를 조사할 때는 설정 파일만 보거나 timeout을 늘리기 전에, 마지막으로 통과한 level과 그 뒤 entry를 식별한다. Zephyr의 initlevels 빌드 타깃은 linker가 만든 init 호출 순서를 보여준다.

관찰우선 확인할 경계실제 증거
PRE_KERNEL 중 정지커널 서비스 사용 여부, provider의 level·prioritywest build -t initlevels, 마지막 init 로그, zephyr.map
main()에 도달하지 않음POST_KERNEL / APPLICATION entry와 정적 thread 준비level 경계 로그, assert·fatal 기록, initlevels 순서
main()은 실행, 장치 불가device init 실패 또는 deferred initdevice_is_ready(), init 결과·장치 로그, 병합 zephyr.dts
빌드에는 등록했지만 entry가 예상과 다름level·priority와 실제 링크 결과initlevels, zephyr.map, 최종 .config

조건부 사례: main()에는 들어왔는데 DEVICE_DT_GET(DT_ALIAS(uart0))이 가리키는 장치가 ready가 아니라면, 먼저 device_is_ready() 결과를 기록한다. 그 다음 장치 초기화 실패와 zephyr,deferred-init 지정 여부를 분리해 확인한다. 후자라면 자동 부팅 init 대상이 아니므로 사용 전에 명시적 device_init() 경로가 필요하다. 이 사례는 재현 실험 결과가 아닌 진단 예시다.

리뷰 질문: 소비자가 요구하는 장치는 어느 level과 priority에서 초기화되는가? 그 시점에 필요한 커널 서비스와 선행 장치가 실제로 준비되는가? main()에서 사용하는 장치는 ready를 확인하는가?

관찰 지점: west build -t initlevels와 zephyr.map으로 링크 순서를 확인하고, 런타임 로그에서 마지막으로 진입·복귀한 init entry를 기록한다. 후자는 로깅 구성과 보드 출력 경로가 준비되어야 관찰할 수 있다.

이 표는 실행하지 않은 실험 결과가 아니라, 소스와 공식 문서에서 도출한 확인 순서다. 재현 기록에는 Zephyr revision, 보드·앱, .config, 실제 init 순서와 첫 실패 신호를 함께 남긴다.

고정 버전 근거

이 글의 순서와 문맥 설명은 Zephyr 3.7.0 문서 및 36940db938a8f4a1e919496793ed439850a221c2 커밋을 기준으로 한다. kernel/init.c와 include/zephyr/init.h의 고정 원본은 byte 크기와 Git blob SHA 및 SHA-256으로 확인했다. “고정 원문” 상자만 짧은 upstream 발췌이며 나머지 코드 블록은 작성 예제다.

용어: init entry는 초기화 함수와 level 정보를 담아 링크되는 항목, init level은 부팅 단계의 큰 경계, priority는 같은 level 안에서의 실행 순서, device ready는 해당 장치의 초기화 성공 상태를 뜻한다.

다음 Zephyr RTOS 글