RTOS · Zephyr · Zephyr 3.7.0 LTS3

Zephyr RTOS 3.7.0 LTS3 내부 동작 분석

thread, scheduler, interrupt, device model, devicetree, Kconfig, west build flow를 Linux kernel 분석 방식으로 다시 정리한 시리즈입니다. 짧은 API 요약이 아니라 소스 코드 위치, 사용 패턴, 라인별 설명, 그림, 불변 조건, 디버깅 포인트를 한 글 안에 넣었습니다.

소스 분석 기준: Zephyr v3.7.0 LTS3 최신 stable과 별도 관리 원본 코드 + 그림 + 설명

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

전체 흐름

Zephyr는 작은 RTOS지만 단순한 super-loop가 아닙니다. kernel object, scheduler, interrupt, workqueue, device model, devicetree, Kconfig, west workspace가 서로 맞물려 하나의 firmware image를 만듭니다. 그래서 한 파일을 외우는 방식보다 "빌드 시점에 결정되는 것"과 "런타임에 상태가 바뀌는 것"을 나눠서 읽어야 합니다.

그림 1. Zephyr를 읽는 네 축
Kernelthread, scheduler, IRQ, timer
BuildKconfig, CMake, west, generated files
Hardwaredevicetree, board, pinctrl, driver
RuntimeIPC, workqueue, network, power
Debugmap, .config, zephyr.dts, logs

각 글은 이 네 축 중 하나만 보지 않고, 빌드 산출물이 런타임 상태로 바뀌는 지점을 코드와 그림으로 같이 표시합니다.

버전 기준

이 시리즈는 Zephyr v3.7.0 LTS3 태그의 소스를 분석합니다. 3.7 LTS 계열의 후속 유지보수 패치가 이 태그에 포함됐다는 뜻은 아닙니다. 제품 적용 전에는 공식 릴리스와 보안 수정을 별도로 확인해야 합니다. RC는 정식 릴리스와 구분합니다.

토픽 목록

Documents Zephyr 공식 문서 한국어 번역 Zephyr 3.7.0 공식 문서를 요약·해설, 접을 수 있는 영어 원문, 한국어 전문 번역의 세 부분으로 읽습니다. Kernel Kernel Architecture 부팅 직후 z_cstart(), init level, iterable section, kernel object가 초기화되는 순서를 분석한다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Kernel Thread / Scheduler k_thread, stack object, ready queue, cooperative/preemptive priority, timeout이 scheduler 결정에 들어가는 길을 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Kernel SMP: 두 CPU의 동시 실행 보조 CPU의 시작 관문, 공유 ready queue, CPU mask와 spinlock, 원격 스레드 중단의 조건을 구분한다. Kernel Interrupt / Exception IRQ_CONNECT, irq_enable, ISR context, nested interrupt, deferred work의 경계를 실제 코드 흐름으로 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Kernel Memory Management 스택, 힙, mem_slab, mem_pool의 메모리를 누가 확보하고 해제하는지 살펴본다. 메모리 도메인, MPU, 사용자 모드가 접근 권한을 어떻게 제한하는지도 구분해 확인한다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Device / Board Device Model DEVICE_DT_DEFINE 계열 macro, config/data 분리, API vtable, init level, device_is_ready의 의미를 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Device / Board Driver Model DT_INST_FOREACH_STATUS_OKAY, DEVICE_DT_INST_DEFINE, compatible binding이 driver instance를 찍어내는 과정을 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Device / Board Devicetree dts, overlay, binding yaml, generated header, ordinal, DEVICE_DT_GET이 하나의 빌드 파이프라인으로 이어지는 과정을 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Build / Config Kconfig symbol, default, select, imply, depends on, prj.conf, board defconfig가 최종 .config로 수렴하는 과정을 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Build / Config Build System / west west workspace, manifest, modules, CMake, generated files, build directory가 어떻게 Zephyr app 하나를 만드는지 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Build / Config External Modules: 외부 코드의 빌드 연결 저장소 배치, 모듈 발견, 기능 선택과 최종 링크를 나누고 module.yml과 CMake의 역할을 읽습니다. Build / Config Snippets: 설정 조각의 재사용 검색 root, fragment·overlay 추가 순서와 보드 조건을 실제 생성 설정에 연결합니다. Storage Flash와 Flash Map: 주소와 영역 장치·파티션의 좌표, 지우기·쓰기 정렬과 저장 영역의 소유권을 구분합니다. Storage File Systems: VFS와 저장 백엔드 마운트 경로, LittleFS·FatFS의 매체 연결과 자동 포맷·파일 수명을 읽습니다. Runtime Services Settings와 NVS 영속 저장 설정 키·handler와 NVS backend의 플래시 기록·복원 경계를 구분합니다. Runtime Services IPC / Synchronization semaphore, mutex, queue, msgq, event, poll이 wait queue와 timeout으로 어떻게 수렴하는지 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Runtime Services IPC Service와 이미지 간 통신 endpoint 결합 통지와 첫 송신 시점, backend 선택과 TX/RX 버퍼 수명을 나눠 읽습니다. User Mode 사용자 권한과 메모리 보호 메모리 도메인과 커널 객체 권한을 구분하고, 사용자 시스템 호출의 검증 및 오류 처리 경로를 살펴본다. Testing Twister 테스트 실행 시나리오와 플랫폼 선택부터 빌드·실행·결과 보고까지, 통과한 단계와 미검증 범위를 구분한다. Testing native_sim: 호스트에서 실행하는 Zephyr 가상 시간과 스레드 실행 모델, 호스트 주변장치와 실제 하드웨어 검증의 경계를 구분합니다. Testing Device Emulators: 장치 응답의 대역 AT24 드라이버와 가상 I2C 경로를 따라가며 오류 주입 지점과 모델의 한계를 읽습니다. Testing Ztest 스위트와 판정 케이스 선언, 픽스처 수명, 사용자 테스트와 assertion·assumption·SKIP 결과를 연결해 읽는다. Runtime Services Timer / Workqueue k_timer, timeout queue, delayed work, system workqueue가 interrupt와 thread 사이의 완충층이 되는 과정을 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Runtime Services RTIO 요청·완료 큐 SQE 제출, CQE 대기·회수, 취소와 버퍼 반환의 서로 다른 시점을 추적합니다. Connectivity CAN과 ISO-TP: 프레임과 메시지 mailbox 대기, 필터 수신과 ISO-TP 분할·흐름 제어·완료의 한계를 비교합니다. Connectivity USB Device: 두 스택과 호스트 열거 기존 USB와 새 USBD의 초기화, VBUS 조건과 endpoint 방향을 구분합니다. Runtime Services Networking net_if, net_pkt, net_buf, L2 드라이버, 소켓 API가 버퍼 소유권과 스레드 우선순위를 어떻게 함께 관리하는지 살펴본다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Runtime Services Bluetooth LE의 Host·HCI·Controller 단일칩·듀얼칩 배치와 명령·이벤트·연결 데이터의 경계를 읽습니다. Zephyr 3.7

명령은 한 트리, 접속 경로는 여러 개

Zephyr 3.7.0 Shell의 백엔드, 정적·동적 명령 등록, 가장 깊은 핸들러 선택, 출력·로그 큐와 실패 경계를 원본 도식 및 표로 설명합니다.

Zephyr 3.7

타이머가 아니라 작업의 진전을 감시한다

Zephyr 3.7.0 Task Watchdog의 채널별 feed, 가장 이른 마감의 커널 타이머, ISR 콜백과 하드웨어 watchdog fallback을 원본 도식과 비교표로 설명합니다.

Zephyr 3.7

원격 관리 요청은 세 경계를 지나 명령이 된다

Zephyr 3.7.0 MCUmgr의 SMP 요청·응답, 전송 계층과 명령 그룹 활성화 경계를 자체 도식과 표로 설명합니다.

Zephyr 3.7

인터페이스는 UP인데, 왜 아직 연결되지 않았을까?

Zephyr v3.7.0의 net_if 관리·동작 상태, net_mgmt 이벤트 콜백, Connection Manager의 IP 준비 판정과 놓친 초기 알림 처리법을 원본 도식과 표로 설명합니다.

Zephyr 3.7

pinctrl: 같은 UART0가 왜 보드마다 다른 핀으로 나가는가?

Zephyr v3.7.0 pinctrl의 default/sleep 상태, nRF52840 DK 실제 UART0 배선, PINCTRL_DT_DEFINE부터 pinctrl_apply_state까지의 경계와 실패 진단을 원본 도식·표로 설명합니다.

아키텍처 포팅: 새 CPU가 Zephyr 스레드를 실행하려면

Zephyr v3.7.0 아키텍처 포팅에서 부트 진입, ABI 문맥 전환, 예외·인터럽트, 링커·도구체인 연결을 RISC-V 실제 소스와 독창적인 도식·표로 살펴봅니다.

SoC 포팅: 보드 아래의 하드웨어 계약은 어디에 있을까?

Zephyr v3.7.0 hardware model v2에서 SoC family·series·CPU cluster, board target, DTS·Kconfig·CMake·초기화 경계를 실제 nRF5340 소스로 읽습니다.

보안 강화는 설정표에서 끝나지 않는다

Zephyr v3.7.0 보안 프로세스·Secure Coding·hardenconfig를 구별하고 위협, 설정, 실행 검증을 잇는 방법을 자체 도식과 표로 설명합니다.

보안 이미지와 비보안 앱의 계약

Zephyr v3.7.0의 TF-M 통합을 보안·비보안 이미지, 지원 보드와 빌드 산출물, PSA 서비스 호출 경계로 나눠 원본 그림과 표로 설명합니다.

LoRa 패킷 하나를 보냈다고 LoRaWAN 메시지가 되는 것은 아니다

Zephyr v3.7.0의 LoRa 직접 송수신과 LoRaWAN 가입·지역·콜백을 세 개의 원본 도식과 검증 표로 분리해 읽습니다.

Device / Board Board Porting board.yml, board DTS, defconfig, runner, pinctrl, flash/debug 설정이 하나의 board target으로 묶이는 과정을 읽는다. 소스 코드 위치와 실제 사용 패턴을 함께 정리했습니다. Runtime Services Polling / Events 준비 알림과 비트 대기를 나누고, 획득 경쟁·signal 재사용·reset 시점을 구분한다. Runtime Services zbus 채널과 구독 참조 통지와 메시지 복사, 동기 listener와 비동기 구독의 수명·오류를 구분한다. Runtime Services 데이터 전달: 포인터와 바이트 FIFO·LIFO·msgq·mailbox·pipe의 저장 방식, 버퍼 수명과 부분 완료를 비교한다. Device / Board 전력 관리: CPU·시스템·장치 idle 정책과 시스템 관리 장치, runtime 사용 횟수의 책임과 실패 경로를 구분한다. Debug Logging: 로그 한 줄의 여행 컴파일 필터부터 버퍼와 backend 출력까지, 로그가 사라지거나 늦어지는 경로를 읽는다. Build / Config Sysbuild: 여러 이미지의 빌드 상위 설정과 이미지별 설정, 구성 순서와 플래시 순서, domains.yaml의 역할을 나눈다. Debug Tracing: 시간축 읽기 커널 훅부터 CTF 파일까지, 시각 필드와 두 버퍼의 손실 경계를 확인한다.