README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈
YoWASP nextpnr 软件包
YoWASP nextpnr 软件包套件为 WebAssembly 提供了 nextpnr 及相关工具,适用于多个 FPGA 系列。有关详细信息,请参阅 YoWASP 项目概览。
支持的 FPGA 系列包括:
- Lattice iCE40(通过 Project IceStorm);
- Lattice ECP5(通过 Project Trellis);
- Lattice MachXO2(通过 Project Trellis;实验性);
- Lattice Nexus(通过 Project Oxide;实验性);
- Gowin(通过 Project Apicula;实验性)。
Notes
由于技术原因,随 yowasp-nextpnr-machxo2 PyPI 包分发的 MachXO2 工具链中的 ecppack、ecpunpack、ecpbram、ecppll 和 ecpmulti 工具分别以 yowasp-xo2pack、yowasp-xo2unpack、yowasp-xo2bram、yowasp-xo2pll 和 yowasp-xo2multi 的名称安装。这些命令与同一版本的 yowasp-nextpnr-ecp5 PyPI 包中带有 yowasp-ecp* 前缀的对应命令运行完全相同的代码。
Versioning
此包的版本源自上游 nextpnr 包的版本,格式为 X.Y[.Z] format, and is comprised of five or six parts in a X.Y.Z.N.postM[.dev]:
X:nextpnr 主版本号Y:nextpnr 次版本号Z:nextpnr 修订版本号;由于 nextpnr 目前不进行修订版本发布,此字段保留N: zero for packages built from nextpnr releases,Nfor packages built from unreleased nextpnr snapshots;N是自最近一次发布以来的提交数量postM:包构建版本号;用于区分由同一 nextpnr 源代码树生成的不同构建dev:仅存在于从未发布的 nextpnr 快照构建的包中;将这些包标记为预发布版本
采用此方案后,上游版本与 PEP 440 Python 包版本之间存在直接对应关系。从未发布快照构建的包默认会被 pip 忽略,但仍可显式安装。(这些包每天上传到 TestPyPI,但仅偶尔上传到 PyPI。)
早期使用过另一种版本方案,其中包构建版本号由 .devM 后缀表示。该方案与 PEP 440 版本说明符 兼容性不佳,已被弃用。
配置
请参阅 yowasp-runtime 的文档。
许可证
本包受 ISC 许可证 约束,与 nextpnr 许可证 相同。