1 简介
1.1 概述
Xillybus 是一个适用于多种应用的通用平台。因此,每位用户都可以轻松创建并下载满足特定需求的定制 IP 核(IP core):包括数据流 的数量、方向、性能指标以及资源消耗等属性。
为简化定制 IP 核的定义与创建流程,我们提供了一个在线工具:IP Core Factory (https://xillybus.com/custom-ip-factory)。
该工具由一个简单的 Web 应用程序构成,用户可通过它定义所需的设备文件及其配置。完成定义后,系统将自动生成用于 FPGA 工程的文件。定制 IP 核会在短时间内(通常只需几分钟)以 zip 文件形式可供下载。
下载的定制 IP 核功能完整,在实际应用中测试和使用该 IP 核不存在任何技术限制。
您无需阅读本指南即可使用该 Web 应用程序,但建议先运行 demo bundle 来熟悉 Xillybus。对于希望更深入理解并控制设 备文件属性的用户,本指南将提供一些背景信息。
请注意,本指南不涵盖 Xillyp2p IP 核,尽管 IP Core Factory 也可以生成它。有关 Xillyp2p 的更多信息,请参阅 https://xillybus.com/xillyp2p/。
对于尚未熟悉 demo bundle 的用户,建议先阅读以下文档:
即使已经明确需要定制 IP 核,最好还是从 demo bundle 入手。这样可以了解 IP 核如何与应用逻辑集成,以及整个工程应如 何搭建。
有关 IP 核定制配置的所有信息都存储在 FPGA 内部的 IP 核中。当驱动程序初始化时,主机端的驱动会检索这些信息。因 此,当 IP 核被替换时,无需在主机端做任何更改。
一个常见的错误是,为了节省资源而试图最小化配置的流数量。第 3 节和第 4.4 节展示了 Xillybus IP 核的扩展方式,并解释 了为何充足分配流是有意义的。
1.2 如何集成定制 IP 核
从 IP Core Factory 下载定制 IP 核后,需要对 demo bundle 进行修改以包含该 IP 核。这需要几个简单的步骤。说明写在 IP 核 zip 文件中的 README.TXT 里。为方便查看,这些说明也列举如下。
该 README 文件还包含其他有用信息:
-
Core ID(核 ID),一个五位数。该数字是 IP 核的唯一标识符。在询价时应提及 Core ID。
-
列出了 IP 核的设备文件,并显示了每个设备文件的技术细节。这是关于 IP 核真实特性的准确信息。
要将定制 IP 核集成到 demo bundle 中,请按以下步骤操作:
-
将 demo bundle 中的两个文件替换为 IP 核 zip 中的文件:xillybus.v 和 xillybus_core.v(或 xillybus_xl_core.v / xillybus_xxl_core.v)。
-
替换 IP 核本身。该文件位于 demo bundle 的子目录“core/”中。需要替换的文件类似于 xillybus_core.ngc、xillybus_core.edf、xillybus_core.qxp 或 xillybus_core.vqm。
-
编辑 xillydemo.v(或 xillydemo.vhd),以便将所需应用与此定制 IP 核集成。请参考 IP 核 zip 文件中的“instantiation templates”目录。其中名为 template.v(或 template.vhd)的文件包含应遵循的实例化模板。
