Modern Embedded Recipes · 150/152

QEMU CXL Type 3 디바이스 에뮬레이션 — 노트북에서 CXL 개발 환경 구축

2026년 6월 18일 · Hawk · 5분 읽기

recipes cxl qemu emulation virtualization type-3

#한 줄 요약

“실 CXL 카드 없이도 노트북에서 CXL 드라이버·BIOS 개발이 가능합니다.” QEMU 8.0+가 Type 3 memory expander를 stable 지원합니다.

#왜 에뮬레이션이 필요한가

Ch 149에서 CXL의 PHY·프로토콜을 봤습니다. 그런데 드라이버 prototype·kernel module 검증·BIOS CXL 코드 개발에는 실 하드웨어가 필요합니다. Astera Leo는 수십 만 원~수백 만 원. 개발자 한 명이 책상 위에서 시작하기엔 부담입니다.

QEMU가 CXL 디바이스를 에뮬레이션해서 Linux guest 안에서 마치 실 디바이스인 양 동작합니다. 성능은 못 측정하지만 드라이버 동작·sysfs 노출·CEDT 파싱은 real에 가깝게 검증 가능합니다.

#QEMU CXL 지원 현황

디바이스 유형	지원	안정도
Type 3 memory expander	8.0+	stable
Type 2 accelerator + memory	9.0+	experimental
Type 1 cache-only	—	not supported
Multi-LD pooling	8.2+	partial
CXL Switch	8.2+	basic
CXL 3.0 fabric	—	not yet

대부분 개발은 Type 3가 충분합니다. 드라이버 path가 Type별로 크게 갈리지 않습니다.

#호스트 머신 모델

QEMU에 CXL host bridge를 자동 생성하는 옵션:

1
qemu-system-x86_64 \
2
    -machine q35,cxl=on \
3
    -m 8G,slots=8,maxmem=32G \
4
    -smp 4 \
5
    -enable-kvm \
6
    ...

핵심 옵션:

옵션	의미
`cxl=on`	CXL host bridge 자동 생성
`slots=N,maxmem=M`	hot-add 가능한 메모리 슬롯
`q35`	PCIe support 머신 (i440fx 안 됨)

-machine이 켜져야 CEDT가 자동 생성되어 Linux guest가 CXL을 인식합니다.

#CXL Type 3 디바이스 추가

CXL Type 3 memory expander 한 개를 emulation:

1
qemu-system-x86_64 \
2
    -machine q35,cxl=on \
3
    -m 8G,slots=8,maxmem=32G \
4
    \
5
    -object memory-backend-file,id=cxl-mem0,share=on,mem-path=./cxl-mem-backing,size=256M \
6
    \
7
    -device pxb-cxl,bus_nr=12,bus=pcie.0,id=cxl.1 \
8
    -device cxl-rp,port=0,bus=cxl.1,id=root_port0,chassis=0,slot=0 \
9
    -device cxl-type3,bus=root_port0,memdev=cxl-mem0,id=cxl-mem0-dev \
10
    \
11
    -M cxl-fmw.0.targets.0=cxl.1,cxl-fmw.0.size=512M

각 옵션 의미:

옵션	역할
`memory-backend-file`	실 파일이 CXL device의 backing store 역할
`pxb-cxl`	CXL host bridge (PCI Expander Bus, CXL flavor)
`cxl-rp`	CXL Root Port (PCIe Root Port의 CXL 버전)
`cxl-type3`	Type 3 디바이스 자체
`cxl-fmw`	Fixed Memory Window (CFMWS 항목)

FMW size는 device 자체 메모리보다 커야 합니다 — multiple device interleave를 위한 예약 영역.

#Linux guest 측 인식

QEMU 안에서 부팅한 Linux:

1
# 커널 6.0+이어야 CXL 서브시스템 동작
2
guest$ uname -r
3
6.8.0-...
4

5
# CXL 모듈 로딩
6
guest$ modprobe cxl_acpi
7
guest$ modprobe cxl_pci
8

9
# PCIe로 보임
10
guest$ lspci -nn | grep CXL
11
0c:00.0 CXL: ... [1af4:0d93]    # virtio vendor + CXL ID
12

13
# CXL sysfs 등록 확인
14
guest$ ls /sys/bus/cxl/devices/
15
mem0/  decoder0.0/  port0/  root0/
16

17
# 토폴로지
18
guest$ cxl list -RT
19
[
20
  {
21
    "root":"root0",
22
    "decoders":[
23
      {
24
        "decoder":"decoder0.0",
25
        "size":536870912
26
      }
27
    ],
28
    "endpoints":[
29
      {
30
        "memdev":"mem0",
31
        "ram_size":268435456
32
      }
33
    ]
34
  }
35
]
36

37
# Region 생성
38
guest$ cxl create-region -d decoder0.0 -t ram -s 256M
39
{
40
  "region":"region0",
41
  "size":268435456,
42
  "decoder":"decoder0.0"
43
}
44

45
# DAX 모드 또는 system RAM 모드
46
guest$ daxctl reconfigure-device dax0.0 -m system-ram
47

48
# numactl로 CXL 노드 확인
49
guest$ numactl --hardware
50
node 0 size: 8000 MB     # 기본 RAM
51
node 1 size: 256 MB      # CXL Type 3 expander

guest 안에서 모든 명령이 실 디바이스와 동일하게 동작합니다.

#CEDT 검증

QEMU가 자동 생성한 ACPI CEDT를 확인:

1
guest$ acpidump -b
2
guest$ iasl -d cedt.dat
3

4
# cedt.dsl 파일 내용
5
[001h] Signature              "CEDT"
6
[004h] Table Length           0x0000005C
7
[008h] Revision               0x01
8
[009h] Checksum               0x...
9

10
[Subtable Type: CHBS (CXL Host Bridge Structure)]
11
[001h] Subtable Type          0x00
12
[003h] UID                    0x0000
13
[007h] CXL Version            0x0001
14
[00Bh] Base                   0x...
15
[013h] Length                 0x...
16

17
[Subtable Type: CFMWS (CXL Fixed Memory Window)]
18
[001h] Subtable Type          0x01
19
...

CEDT 내용이 실 BIOS와 동일한 형식입니다. 드라이버가 같은 path로 인식.

#드라이버 개발 워크플로

QEMU 환경에서 kernel module 개발 사이클:

1
# host에서 cross-compile
2
host$ make ARCH=x86_64 CROSS_COMPILE=x86_64-linux-gnu- M=drivers/cxl/
3

4
# 결과 .ko를 guest로 복사
5
host$ scp drivers/cxl/cxl_mock.ko guest:/tmp/
6

7
# guest에서 load·테스트
8
guest$ insmod /tmp/cxl_mock.ko
9
guest$ dmesg | tail
10
guest$ ls /sys/bus/cxl/devices/
11

12
# 수정·반복
13
host$ vim drivers/cxl/cxl_mock.c
14
host$ make ...

컴파일·load·테스트 사이클이 수십 초. 실 하드웨어에 reboot·flash하는 시간보다 훨씬 빠름.

#QEMU CXL의 한계

QEMU CXL은 정확도가 떨어지는 영역:

한계	영향
latency 시뮬레이션 미정확	성능 측정에 못 씀
실 PCIe link 없음	PHY·LTSSM 버그 못 잡음
CXL.cache 미지원 (Type 2)	accelerator coherency 검증 한계
Fabric·switch 시뮬레이션 제한	대규모 토폴로지 못 봄
RAS·MCTP·VDM 미구현	운영 시나리오 검증 한계

적합한 사용:

드라이버 prototype·디버깅
Kernel module ABI 변경 검증
BIOS·UEFI CXL 코드 개발
userland tool (cxl-cli 등) 개발
회귀 테스트

부적합:

성능 측정·튜닝
실 하드웨어 호환성 검증
PHY·signal integrity 디버깅

#대체 도구

QEMU 외 대안:

도구	정확도	속도	용도
QEMU CXL	medium	fast	드라이버·BIOS 개발
Intel CXL Modeling Project	high	slow	정밀 시뮬레이션
gem5 CXL 모델	very high	very slow	아키텍처 연구
FPGA 보드 + CXL IP	exact	hardware	양산 검증

대부분 개발자는 QEMU + FPGA 보드 조합이 비용·정확도 균형입니다.

#자주 하는 실수

⚠️ q35 머신 안 쓰고 i440fx로 시도

1
$ qemu-system-x86_64 -machine pc,cxl=on ...
2
qemu-system-x86_64: warning: cxl option requires q35 machine

CXL은 PCIe 5.0 기반. PCIe 자체가 q35 머신만 지원. 옛 머신 모델로는 CXL이 동작 안 합니다.

⚠️ Backing file 권한 잘못

1
$ qemu-system-x86_64 \
2
    -object memory-backend-file,id=mem0,mem-path=/root/cxl-mem,...
3
# guest 시작 시 segfault — 권한 거부

QEMU 프로세스가 읽기·쓰기 권한을 가져야 합니다. /tmp/ 또는 sudo 환경.

⚠️ Guest kernel 5.x 사용

1
guest$ uname -r
2
5.15.0-...
3
guest$ modprobe cxl_acpi
4
modprobe: FATAL: Module cxl_acpi not found

CXL subsystem은 6.0+ mainline. 5.15 LTS는 OEM patch 없이는 동작 안 함. Ubuntu 24.04+ 또는 Fedora 38+ 권장.

⚠️ FMW size를 device size와 같게

1
-object memory-backend-file,...,size=256M
2
-M cxl-fmw.0.size=256M   # 같으면 interleave 영역 없음

FMW는 interleave를 위한 예약 영역도 포함해야. device size의 2배 이상 권장.

⚠️ Multi-device emulation 시 chassis·slot 충돌

1
-device cxl-rp,port=0,...,chassis=0,slot=0
2
-device cxl-rp,port=1,...,chassis=0,slot=0  # 충돌!

각 root port는 *고유 (chassis, slot)*이어야. slot을 1, 2, 3… 로 증가.

#정리

QEMU 8.0+가 CXL Type 3 디바이스 에뮬레이션을 stable 지원해 드라이버·BIOS 개발을 노트북에서 가능하게 합니다.
-machine q35,cxl=on이 기본. pxb-cxl·cxl-rp·cxl-type3·memory-backend-file을 조합해 디바이스 추가.
Linux guest는 *kernel 6.0+*에서 cxl_acpi·cxl_pci·cxl_mem 자동 인식. cxl list -RT로 토폴로지 확인.
latency·신호 무결성·CXL.cache 시뮬레이션은 한계. 성능 측정·PHY 디버깅은 실 HW 필요.
컴파일·load·테스트 사이클이 수십 초로 매우 빨라 드라이버 prototype에 이상적.

다음 편은 Ch 151: Linux CXL 드라이버 분석 — drivers/cxl/ 디렉터리의 코드를 진입점부터 sysfs까지 분해합니다.

#관련 항목

Ch 149: PCIe → CXL 진화
Ch 151: Linux CXL 드라이버 분석 (다음 편)
Bootloader Internals Ch 35: EFI·UEFI에서 CXL 초기화 — CEDT 생성
Kernel Debugging Ch 8: CXL 커널 드라이버 디버깅
QEMU CXL 문서

QEMU CXL Type 3 디바이스 에뮬레이션 — 노트북에서 CXL 개발 환경 구축

#한 줄 요약

#왜 에뮬레이션이 필요한가

#QEMU CXL 지원 현황

#호스트 머신 모델

#CXL Type 3 디바이스 추가

#Linux guest 측 인식

#CEDT 검증

#드라이버 개발 워크플로

#QEMU CXL의 한계

#대체 도구

#자주 하는 실수

#정리

#관련 항목

Modern Embedded Recipes · 151 of 152

관련 글

Linux CXL 드라이버 분석 — cxl_pci·cxl_core·region·DAX

PCIe → CXL 진화 — 같은 PHY 위 cache-coherent 프로토콜 추가

NUMA Memory Topology — numactl·numa_alloc·HBM 적용

이 글을 참조하는 글 (3)