Product Docs

myCPU 产品文档

从这里开始体验一个已可运行的 RISC-V 模拟器原型：进入控制台，启动系统 demo， 观察机器状态，运行 AI accelerator workload，并沿 Runtime Labs 查看后续原型。

/

产品首页

了解 myCPU 能体验什么：OS bring-up、机器观察、AI accelerator 和 runtime labs。

/console

在线控制台

选择 demo，复用 Load / Run / Pause / Reset / Terminate，查看 terminal、pipeline 和 device counters。

/docs

产品文档

按体验路线阅读功能说明，再进入设计和状态证据链了解工程细节。

Overview

一个浏览器里的 RISC-V 系统工作台

myCPU 把 CPU 执行、平台设备、guest 系统启动、AI accelerator 和运行时原型放进同一个体验面。 用户不需要先读 Makefile 或内部状态文档，可以从控制台选择一条路线，运行已有 demo， 再用 terminal、pipeline timeline、寄存器、CSR、memory observation 和 profile counters 看见机器正在做什么。

当前最适合的体验顺序是：先从 OS Bring-up 看到系统能启动，再进入 Machine Inspector 理解 CPU 和平台状态，然后运行 AI Accelerator，最后到 Runtime Labs 查看 L1D / shadow cache 与 JIT / DBT opt-in 原型。

Try the Console

打开控制台后怎么体验

  1. 选择 demo。 `/console` 会先展示 demo workspace，而不是把用户直接丢进底层调试面板。
  2. 启动 session。 可运行 demo 会同步现有 workload 和 backend 下拉，然后复用 Load / Run / Pause / Reset / Terminate。
  3. 观察结果。 terminal 看 UART 输出和 marker，inspector 看 pipeline、register / CSR diff、platform I/O、 vector state、AI accelerator counters 和 memory / profile 摘要。
  4. 识别路线状态。 future-only 路线会显示 Coming soon；Linux Serial Console 在未配置 Image 时显示 Not configured / Runtime Image required，并提示 env 未设置、路径不存在、路径不是文件 或不可读等具体原因；配置后显示 Ready。

Demo Routes

四条主体验路线

OS Bring-up

启动系统，看见终端

从 interactive_os 开始验证 UART 输入输出，再查看 xv6 shell 和 Linux Serial Console 路线。Linux 入口复用 linux_proto 的 flat SBI shim、DTB 和 rootfs， 在配置 MYCPU_LINUX_PROTO_CONSOLE_IMAGE 后可以启动受控串口会话并进入 mycpu-linux# mini shell。

Machine Inspector

观察 CPU 和平台

使用 functional / pipeline backend，对照 pipeline stage、stall reason、GPR / CSR、 bus access、CLINT、PLIC、virtio-blk 和 memory observation。

AI Accelerator

运行设备级 AI workload

选择 guest_ai_accel_demo，观察 graph package、MMIO doorbell、DMA load/store、 scratchpad、completion、KMVAI marker 和 timed-simple profile counters。也可以直接 运行 Parameterized Tiny Model；浏览器只提交白名单模板允许的 batch、runtime shape 和 preset，服务器端重新生成并校验对应 graph，再返回输出、runtime shape、profile counters 和 op summary。

Runtime Labs

探索运行时原型

查看 Vector CNN、L1D / shadow cache、JIT / DBT opt-in 和 host-smoke-only runtime guardrail 的展示入口。这里说明未来方向，也标注 Coming soon 的交互范围。

Architecture

页面看到的数据来自真实模拟器链路

控制台通过本地 Node debug server 连接 `mycpu --debug-cli`。浏览器端只消费 workload manifest、 terminal session 和 debug snapshot；CPU 执行仍由 simulator backend 提供，设备状态来自 Machine、AddressSpace、Bus、RAM 和 MMIO device 的只读快照。

Browser Debug Server Debug CLI Machine CPU / Bus / Device

OS Bring-up

从 monitor 到 xv6，再到 Linux 路线

interactive_os 是最直接的交互入口：加载后可以在 terminal 里看到 monitor prompt， 输入命令并观察 UART 回显。xv6 shell 展示真实 `virtio-blk` board path 的系统 bring-up 成果。

Linux Serial Console 是更重的系统路线：启动 frontend server 前设置 MYCPU_LINUX_PROTO_CONSOLE_IMAGE=/path/to/Image，`/console` 会新增 linux_proto_console demo。未配置时，卡片会保持 Not configured，不会触发 Load session；如果路径不存在、不是普通文件或不可读，卡片会直接显示对应诊断。配置后， 卡片显示 Ready，Load 会加载 flat SBI shim、Linux Image payload、DTB 和 virtio-blk rootfs，并等待 mycpu-linux# prompt；Run / Pause / Reset / Terminate 仍复用现有 session 控制和 UART 增量投影。

AI Accelerator

看见一个独立 MMIO AI 设备如何完成推理

AI Accelerator 路线展示的是设备级体验：guest 提交 graph package，写 MMIO doorbell， 设备通过 DMA 和 scratchpad 推进 compute，完成后返回 completion 并输出 KMVAI marker。 控制台展示 aggregate counters，例如 queue depth、DMA bytes、device / compute / stall cycles 和 utilization，帮助用户理解一次 workload 的执行过程。

Parameterized Tiny Model 是 Wave 7 的受控 host profile 体验：当前提供 dynamic_tiny_model、dynamic_gemm 和 dynamic_cnn、tiny_attention_static 四条白名单模板。浏览器只能选择模板允许的 batch、runtime shape 或输入 preset；服务器端重新生成 graph package、runtime shape table、 输入和 expected output，然后调用 mycpu --ai-profile-manifest。控制台面板会按模板直接说明 预期 marker、这条 demo 证明什么，以及当前仍未开放的边界。 它不是任意模型上传、任意 graph authoring、ONNX / PyTorch runtime，也不开放 Linux-facing NPU driver。

Runtime Labs

把 cache、vector 和 JIT 原型放在可观察的入口里

Runtime Labs 收纳已经完成但仍偏实验性质的体验：Vector CNN 展示向量寄存器和小型 NN workload；L1D / shadow cache 展示 memory observation；JIT / DBT opt-in 展示 translation、 executable cache hit / miss、fallback、invalidation 和 summary stats。它们帮助用户理解 myCPU 正在从 reference-first 模拟器扩展到更丰富的运行时实验。

Verification

体验入口背后有回归门禁

Wave 7 前端改动至少守住 `cd frontend && node --test` 和 `git diff --check`。 触达 simulator、debug session、guest runtime 或 workload 时，会按对应范围补充 `cd myCPU && make test`、`make test-pipeline` 或更窄的 host / guest smoke。 AI 参数化小模型还要守住参数生成、shape fail-closed 和 make test-host-ai_accelerator_profile_smoke。 真实 Linux serial console e2e 是显式 opt-in：默认测试只记录跳过条件；设置 MYCPU_RUN_LINUX_PROTO_CONSOLE_E2E=1 和 MYCPU_LINUX_PROTO_CONSOLE_IMAGE=/path/to/Image 后，frontend e2e 会通过真实 debug server + debug CLI 加载 linux_proto_console， 输入 help，校验命令列表与新的 mycpu-linux# prompt， 然后 Terminate。

Roadmap

Wave 7 先把已有能力整理成可体验产品

当前主线是产品化展示与在线调试平台收口。Wave 7 之后，路线会重新打开两条更重的主线： 标准 Debian / Alpine / RISC-V 发行版镜像级平台，以及用户自定义 AI 任务和更接近商用 NPU 的性能模型。

Design References

继续深入的证据链

产品文档先讲体验；需要核对工程边界、当前状态和长期路线时，再进入这些设计与状态文档。