UT实战第二期：第三代香山(昆明湖）架构IFU模块UT验证实战(进行中)

在验证中学习香山IFU的微架构设计

Created Dec 11, 2024 - Last updated: Dec 11, 2024

在本期验证任务中，各位朋友将走近香山昆明湖架构的IFU模块，在验证实战中体会香山取指模块的设计思路，加深对RISCV指令集架构的理解。欢迎各位报名参加（报名填写这里，qq群：600480230。）！

IFU（Instuction Fetch Unit）即取指单元，负责接收FTQ的请求并从ICache或Instr Uncache获取指令缓存行作为输入，以完成取指、预译码、RVC指令扩展为RVI指令、BPU预测错误预检等多项功能，最终向IBuffer输出初步译码信息和指令码，向FTQ写回检查结果。

本期任务中，合计发布4个子任务，涵盖IFU的5个子模块（PreDecode、F3Predecoder、RVCExpander、PredChecker和FrontendTrigger），所有的任务都将通过万众一芯之香山处理器的issue分配。

参与验证

本次验证任务请基于UnityChipForXiangShan提供的验证框架完成验证工作并向该仓库提交PR。

成果提交

请fork上述UnityChipForXiangShan仓库之后完成验证代码和文档的编写，成果齐备后，请发起PR以提交。

bug报告

请直接在UnityChipForXiangShan的仓库下使用bug report模板提issue，或者快捷点击这里。

提交bug时，请先在label中选择bug need to confirm标签。然后从label提供的四种bug分级（minor、normal、serious、critical）中选择您认为最符合的一种标签。最后，请选择您发现bug的模块，本次验证的是前端的ifu模块，可以统一打上ut_frontend.ifu标签。

成果需求

每个子任务需要提交以下成果：

验证环境+API：验证环境和API是代码成果，是针对待验证对象（DUT）的数据职责（引脚）和行为职责（逻辑）的封装，需要提供特定的可复用的接口、测试套件、测试覆盖率等的定义。其中，搭建验证环境可以参考验证环境搭建教程，测试覆盖率相关的文档可以参考这两篇：行覆盖率、功能覆盖率。
测试用例：测试用例是代码成果，定义了用于测试的输入组合，以及预期的输出组合。构建测试用例可以参考测试用例添加教程
验证报告：验证报告是文字成果，包括对环境、测试点和测试用例的介绍，复现代码所需的环境和指令，以及对测试覆盖率等衡量指标的报告。验证报告的书写可以参考这篇教程：验证报告教程

本期任务在UnityChipForXiangShan验证框架中已经提供了初步的环境，各位也可以自行搭建验证环境和提炼API。