
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本项目是不来梅大学计算机体系结构研究组原RISC-V虚拟原型的扩展。关于开放指令集架构RISC-V及虚拟原型本身的更多信息,可参考此处,相关成果已发表于论文。
本Docker容器是针对ESP32-C3微控制器的特定实现,可执行使用ESP-IDF专用工具链和驱动编译的程序。
该虚拟原型需要ESP-IDF的特定版本。请按照相关说明安装工具链并使用驱动。
您需要安装https://www.docker.com/products/docker-desktop/%E4%BB%A5%E8%BF%90%E8%A1%8C%E5%AE%B9%E5%99%A8%E3%80%82
$ docker pull docker.xuanyuan.run/agbstestcloud/riscv-vp:latest
进入ESP-IDF项目目录,执行构建命令:
$ idf.py build
构建完成后,项目目录结构包含build文件夹及目标.elf文件(如hello-world-bm.elf)。
将当前项目目录映射到容器的/data路径,并指定.elf文件路径:
示例(当前目录为/home/<user>/esp-idf/examples/hello-world-bm):
$ docker run -it --volume $PWD:/data agbstestcloud/riscv-vp:latest build/hello-world-bm.elf
执行以下命令获取所有程序参数:
$ docker run -it --volume $PWD:/data agbstestcloud/riscv-vp:latest --help
输出帮助菜单:
SystemC 2.3.3-Accellera --- Aug 16 2022 11:10:33 Copyright (c) 1996-2018 by all Contributors, ALL RIGHTS RESERVED ESP32-C3 Extension of the Virtual Prototype: --rom-file: Specify the ROM-File for the ESP32-C3. Default: /usr/local/bin/esp32c3_rev3_rom.elf --verbose-mode: Print verbose output of all TLM Modules. Default: disabled --quiet-mode: Print only the UART Messages to standard-out. Default: disabled Usage of the Virtual Prototype: --intercept-syscalls: Directly intercept and handle syscalls in the ISS. Default: disabled --debug-mode: Start a GDB session. Default: disabled --debug-port: Select port number to connect with GDB. Default: 5005 --trace-mode: Enable instruction tracing. Default: disabled --tlm-global-quantum: Set global tlm quantum (in NS). Default: 10 --use-instr-dmi: Use dmi to fetch instructions. Default: disabled --use-data-dmi: Use dmi to execute load/store operations. Default: disabled --input-file: Input file to use for execution. Default: First program argument
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务