RISC-MV(Minimal Virtualization)는 이 프로젝트의 독자 ISA 계열이다. 현재
구현하는 64비트 아키텍처는 RArchM64이며 64비트 정수, SIMD와 부동소수점,
MMU·예외·멀티코어, 동적 VIO 장치와 GPT/FAT32 부팅 및 RMFS system
파일시스템을 지원한다.
정식 실행파일 포맷은 .exf(RISC-MV Executable File v1)다. 기존 .cvm
실행파일은 지원하지 않는다. Cvm*, CVM_*, cvmclang 같은 이름은 기존
소스와 도구의 레거시 명칭으로 유지되지만 새 실행파일은 RMVEXF01 magic과
RArchM64를 식별하는 RA64 ISA ID만 사용한다.
자체 C 컴파일러 cvmcc는 지원과 유지보수가 종료됐으며 기본 빌드에서
생성하지 않는다. 소스와 기존 테스트만 현재 상태로 보존한다. 지원되는 C
경로는 Clang 22와 cvmclang.ps1/cvmir bridge다.
computer/
├─ src/ VM 본체
├─ include/ 공용 ABI와 프로토콜 헤더
├─ kernel/ reference kernel
├─ examples/
│ ├─ boot/ ROM·loader·disk 부팅 예제
│ ├─ benchmarks/ ALU·branch·memory·MMU 벤치마크
│ ├─ block/ block device 예제
│ ├─ calculation/ raw 계산 바이너리 예제
│ ├─ compiler/ 폐기된 자체 컴파일러 회귀 자료
│ ├─ counter/ 반복문 예제
│ ├─ display/ framebuffer 예제
│ ├─ hello/ UART 출력 예제
│ ├─ keyboard/ keyboard 예제
│ ├─ linker/ 다중 오브젝트 링크 예제
│ ├─ llvm_ir/ LLVM IR→RISC-MV 변환 예제
│ └─ syscall/ system call 예제
├─ devices/
│ ├─ block/
│ ├─ display/
│ ├─ keyboard/
│ └─ sample_counter/
├─ tools/
│ ├─ assembler/
│ ├─ archive/
│ ├─ linker/
│ ├─ compiler/ 폐기된 자체 컴파일러 회귀 자료
│ ├─ ir_translator/
│ ├─ kernel_image/
│ ├─ disk_image/
│ └─ object/
├─ tests/
├─ docs/
│ ├─ boot/
│ ├─ devices/
│ ├─ examples/
│ ├─ kernel/
│ ├─ system/
│ ├─ tests/
│ └─ tools/
└─ build.ps1 유일한 빌드 진입점
예제와 장치는 프로젝트 이름별 하위 폴더가 하나의 독립 빌드 단위다. 하위 폴더에는 별도 빌드 스크립트를 두지 않는다.
옵션 없이 실행하면 기존 build 폴더를 완전히 초기화하고 VM, 모든 도구,
커널, 장치, 예제와 테스트 러너를 빌드한다.
.\build.ps1개별 프로젝트는 폴더 이름으로 선택한다. 선택 빌드도 기본적으로 build를
먼저 초기화한다.
# counter 예제와 실행에 필요한 VM·도구
.\build.ps1 -e counter
# block 장치 하나
.\build.ps1 -d block
# boot 예제와 block 장치를 함께 빌드
.\build.ps1 -e boot -d block
# 기존 산출물을 유지하면서 선택 대상을 갱신
.\build.ps1 -e keyboard -d keyboard -nc사용 가능한 예제 이름은 benchmarks, block, boot, calculation,
counter, display, hello, keyboard, linker, llvm_ir,
syscall이다. 장치
이름은 block, display, keyboard, sample_counter다. -e all과
-d all도 지원한다.
build 루트에는 main.exe와 유형별 폴더만 생성된다.
build/
├─ main.exe
├─ tools/
│ ├─ vmasm.exe
│ ├─ cvmlink.exe
│ ├─ cvmar.exe
│ ├─ cvmir.exe
│ ├─ cvmclang.ps1
│ ├─ vmkimg.exe
│ ├─ vmkdisk.exe
│ ├─ test_runner.exe
│ ├─ lst/
│ └─ sym/
├─ kernel/
├─ devices/ 모든 장치 DLL을 직접 배치
│ ├─ lst/
│ └─ sym/
├─ examples/ 모든 예제 결과를 직접 배치
│ ├─ lst/ assembler listing
│ └─ sym/ symbol/map 파일
├─ modules/ 장치 DLL과 설정 자동 복사 위치
└─ sysroot/ legacy CVM-named headers, crt0.o, libcvm.a
.\build\main.exe -r 4k `
-l .\build\examples\counter.bin
.\build\tools\test_runner.exe
.\examples\boot\run_boot_demo.ps1-r/--ram은 양의 정수 뒤에 b, k, m, g 단위를 붙일 수 있다.
단위는 대소문자를 구분하지 않으며, 생략하거나 b를 쓰면 byte이고
k, m, g는 각각 KiB, MiB, GiB다. 예를 들어 -r 1m은
1,048,576 byte를 할당한다.
부팅 예제는 ROM에서 시작해 VIO block device의 GPT/FAT32 boot partition에서
BOOT.EXF와 KERNEL.EXF를 읽는다. reference kernel은 별도 RMFS system
partition을 /로 마운트해 /BIN/INIT.EXF를 실행하며 BootInfo, PMM,
MMU, VBR, W^X와 page-fault 복구를 검사하고 성공하면 UART에
KERNEL: READY를 출력한다.
장치를 빌드하면 DLL이 build/devices와 build/modules에 동시에
생성된다. 설정이 필수인 block 장치는 .conf도 자동 생성되며, boot 예제를
함께 빌드하면 생성된 system.img를 쓰기 가능으로 연결하도록 갱신된다.
reference kernel의 RMFS 자체 검사는 /KTEST.TXT를 생성·교체한다.
파일 내용은 고정된 읽기/쓰기 회귀 표식이며 부팅이 끝나도 자동 삭제하지
않는다.
세부 규격은 docs/system, docs/boot, docs/devices, docs/tools,
docs/examples, docs/kernel, docs/tests 아래에서 분류별로 확인할 수 있다.
아키텍처 명칭과 레거시 호환 정책은
RISC_MV.md에 정리되어 있다.