IC 仿真实践 SoC V2.0 · RISC-V 进阶版 SOC2.0 资料 项目资料.md

项目资料.md

处芯积律 RISC-V SoC 进阶版（SoC V2.0）— 项目资料

文档用途：面向学员的「一页总览 + 上手路径」；与官网 IC 仿真实践 · SoC V2.0 项目页 口径一致。
工程细节：顶层模块名、Makefile 目标、默认用例名等，以服务器只读树内 read_me / Makefile 与实际目录为准；本文不替代工程内文件。
SoC 仿真详解：见 SOC验证环境详解.md。
QSPI / ISP / PINMUX 专项包：见 IP专项实践说明.md。

在线阅读

在官网打开 SoC V2.0 项目介绍页，点击 「SOC2.0 资料」，或直接访问：

https://www.yueanic.com/projects/ic-practice/simulation/project/soc-v2-0/docs

该页会列出本仓库 SOC2.0/ 目录下全部 Markdown，并转为站内 HTML。部署侧可通过环境变量 SOC_V2_0_DOCUMENTATION_ROOT 指向资料根目录。

与 V1.1 / V3.0 资料的差异（便于选型）

对比项 SoC V1.1 SoC V2.0（本项目） SoC V3.0
侧重点 入门闭环、基础互连与外设 中型 SoC + 增量 IP（QSPI/ISP/DMA/PINMUX） 大仓库专题与工程化模板
工程母本 /project/SOC_V1.1/To_Customer /project/SOC2.0/soc（IP 包在同级目录） /project/SOC3.0/soc
在线文档根 SOC_V1.1/ SOC2.0/（本目录） SOC3.0/
PDF / 视频 有 详情页「配套资料 / 串讲视频」已挂载 有

1. 项目定位

项 说明
正式名称 处芯积律 RISC-V SoC 进阶版（SoC V2.0）
难度 中等
实践形态 VNC 远程桌面；在个人可写目录的工程副本中操作
SoC 只读母本 /project/SOC2.0/soc
并列 IP 母本 /project/SOC2.0/{QSPI,ISP,PINMUX}
先决建议 建议已完成 SoC V1.1，或具备同等 SoC 仿真经验

纪律：/project/... 为只读参考源；禁止在母本目录内直接修改。应复制到个人练习目录后再编辑与仿真。

# 将 USER 换成你的 VNC 系统用户名（如 cxjl10）
cd /home/USER/cxjl_practice

# SoC 主工程（推荐先做）
cp -a /project/SOC2.0/soc ./SOC2.0_soc_my
cd ./SOC2.0_soc_my
ls -la
cat read_me

# 需要做专项时再复制对应 IP 包（示例：QSPI）
# cp -a /project/SOC2.0/QSPI ./SOC2.0_QSPI_my

2. 服务器目录结构（与母本一致）

/project/SOC2.0/
├── soc/                 # 官网「服务器推荐只读路径」所指主工程
│   ├── Makefile         # comp / run_all / run_<sw用例>
│   ├── read_me          # 编译与仿真简要说明
│   ├── filelist/        # top.f 及各子系统 filelist
│   ├── top/             # 顶层（含 soc_top 等）
│   ├── ip/              # apb_subsystem、busmatrix、dma、isp、pad …
│   ├── ibex/            # RISC-V 核（第三方树，一般勿大改）
│   ├── sw/              # C 用例：uart_test、spi_test、soc_dma_test*、isp_test …
│   ├── test/            # TB
│   ├── model/、comp/ …
│   └── …
├── QSPI/                # QSPI IP + tb + sim
├── ISP/                 # ISP rtl / tb / sim / cmodel
└── PINMUX/              # rtl + FPV（Formal）

相对 V1.1，V2.0 的典型增量包括：更完整的总线子系统、DMA、ISP、QSPI、PINMUX/Formal 等；请以顶层例化与 filelist/ 为准画「差异地图」。

3. 建议学习路径（2～3 周）

  1. 第 0 步：复制 soc 到个人目录；阅读 read_me 与 Makefile；记录工具链与默认 TEST。
  2. 基线：按 read_me / Makefile 零改动跑通至少一轮（如 make run_all TEST=spi 或工程内实际存在的软件用例目录）。保存完整 log，命名 baseline_v2_YYYYMMDD。
  3. 差异地图：对照 V1.1 笔记，梳理 ip/、sw/、filelist/ 增量点；能口述一条「CPU → 总线 → 外设/SRAM」路径。
  4. 定向深化（选一）：
  5. SoC 内 sw/soc_dma_test* / UART / SPI；或
  6. 并列包 QSPI / ISP / PINMUX（见 IP 专项文档）。
  7. 受控改动：一次只改一类（参数 / 小段 RTL / 软件用例），附最小相关回归。
  8. 复盘：现象 → 假设 → log/波形证据 → 结论 → 可复现命令。

更细的检查项见 docs/工程实践检查清单.md。

4. 官网资源对照

资源 位置
项目介绍 / 分阶段方案 /projects/ic-practice/simulation/project/soc-v2-0
本站 Markdown 资料（本页机制） /projects/ic-practice/simulation/project/soc-v2-0/docs
PDF 配套资料（协议、环境、寄存器表等） 项目详情页 「配套资料」
串讲视频 项目详情页 「项目串讲视频」
VNC 连接信息 用户中心 → 我的 VNC 连接

5. FAQ

Q：资料页空白？
A：确认部署机存在应用旁 SOC2.0/ 目录及 .md 文件；或设置 SOC_V2_0_DOCUMENTATION_ROOT 后重启 8002。

Q：仿真命令与本文不一致？
A：以副本内 read_me、Makefile 与 sw/ 下实际存在的用例目录名为准。

Q：PDF 和本页 Markdown 有何区别？
A：PDF 多为串讲配套讲义式资料；本页 Markdown 侧重上手路径与目录事实，便于网页内跳转查阅。