紫光同创这几年在国产FPGA圈子里存在感越来越强不管是高校实验室、研究所还是做工业控制的方案商都能看到它的身影。我之前一直在用Xilinx和IntelAltera家的东西第一次接触紫光同创的Pango Design Suite时说实话有点不太适应。但这个工具链这两年的进步确实明显从代码编写到综合布线再到下载调试全流程已经相当完整而且对国产器件的支持力度也很大。这篇教程我会围绕Pango Design Suite 2020.3的完整安装流程来写包括环境准备、软件获取、安装步骤、License配置、工程校验以及常见问题排查。整个安装过程我实际操作过不止一遍Windows和Linux两种环境都踩过坑这里把经验都整理出来。不管你是刚开始学FPGA的新手还是从其他平台转过来的老手按这个流程走基本不会出大问题。1. 环境准备先把“地基”打好1.1 软硬件要求别让电脑成了瓶颈Pango Design Suite 2020.3本身对硬件的要求不算苛刻但FPGA开发工具的通病就是吃内存、吃硬盘。我最初用一台8GB内存的笔记本跑综合稍微大一点的工程就开始卡后来换到16GB才顺畅起来。先看一下最基本的硬件参考配置CPUx86架构即可Intel或AMD都可以主频不建议太低内存最低8GB强烈建议16GB及以上综合和布局布线阶段对内存需求很大硬盘安装包约3GB安装后完整占用接近10GB建议预留30GB以上空间操作系统Windows 7/10/1164位、LinuxUbuntu/CentOS等主流发行版分辨率建议1080P及以上工具界面信息量比较大低分辨率下操作体验很差操作系统这块要注意2020.3这个版本对Windows 11的兼容性不如Windows 10稳定如果你用的是Win11建议优先用Windows 10环境或者准备一台Windows 10的虚拟机做开发。Linux环境我也测过Ubuntu 18.04和CentOS 7都能正常跑但需要手动处理一些依赖库后面会细说。硬盘空间这块很多人会忽略Pango Design Suite安装完成之后除了安装目录本身的占用用户目录下还会生成缓存和工程配置文件项目多起来之后占用增长很快。所以安装前确保系统盘有足够余量免得安装到一半磁盘满了报错。1.2 安装包和License提前找好渠道安装包和License文件的获取是很多新手卡住的第一道坎。紫光同创的软件不像Xilinx和Intel那样完全开放下载需要走官方渠道。获取安装包的途径主要有这么几个紫光同创官网注册开发者账号在下载中心申请联系紫光同创的技术支持或代理商通过邮件获取高校用户可以通过学校的FPGA实验室或校企合作渠道统一申请我自己的经验是直接联系技术支持效率最高。官网申请有时候响应慢电话或者邮件联系技术支持说明来意和使用的芯片型号一般当天就能拿到下载链接。License文件也是同样的渠道技术支持会根据你提供的MAC地址生成对应的License。这里有个重要的细节License是绑定电脑的申请时需要提供网卡的MAC地址。不同电脑的MAC地址不同License不能混用。如果你在台式机和笔记本之间切换开发环境需要分别申请对应的License。另外紫光同创偶尔会提供试用License有效期一般是30天到90天适合前期评估和学习。但试用License功能上可能会有部分限制比如不支持某些高级IP核或加密功能正式项目还是要申请正式License。2. 安装流程详解一步步来别跳步2.1 Windows安装注意选装组件拿到安装包之后先解压到一个没有中文和空格的路径下。比如D:\PDS2020.3或者E:\Tools\PDS\2020.3解压路径有中文的话后面启动工具时可能会出莫名其妙的报错而且这种报错很难排查。解压完成后找到安装程序一般是setup.exe或install.bat右键以管理员身份运行。这一步非常关键如果不以管理员身份运行后续安装驱动和写注册表环节可能会失败。安装流程大致是进入欢迎界面点击Next阅读并接受许可协议选择安装路径这里再次强调不要有中文和空格选择安装组件一般全选即可点击Install开始安装组件选择这里多说一句如果你只是做逻辑开发不涉及仿真和调试可以只装主程序和下载器驱动。但我的建议是能装的全装上尤其是USB下载器驱动必须装不然开发板连不上电脑。Simulation组件如果你有自己的仿真工具可以不用装但装了也不碍事。整个安装过程大约需要10到20分钟取决于电脑性能。装到一半的时候会弹出一个驱动安装的窗口这个就是USB下载器的驱动点击安装即可。如果驱动安装提示失败不要慌装完主程序后可以手动去安装目录下的driver文件夹里重新安装。安装完成后桌面上会出现Pango Design Suite的快捷方式。第一次双击启动会稍微慢一点工具在初始化环境耐心等一会儿。如果启动后界面直接显示License错误先别急License配置放在下一节专门讲。2.2 Linux安装依赖库和权限问题比较多Linux环境下安装Pango Design Suite 2020.3麻烦主要集中在依赖库和系统权限上。我之前在Ubuntu 18.04上装过一次花了不少时间才跑通。安装包一般是.tar.gz压缩包先解压到一个合适的目录tar -zxvf PDS2020.3-linux-installer.tar.gz解压后进入目录里面会有安装脚本通常叫install或install.sh执行时需要root权限sudo ./install安装过程跟Windows类似会有交互式的安装向导按提示操作即可。但在正式安装之前建议先装好依赖库不然装到一半会因为缺少某些库文件而报错。Ubuntu系统建议提前安装这些依赖sudo apt-get update sudo apt-get install libncurses5 libncurses5-dev libxft2 libxrender1 libxtst6 libxi6CentOS系统则是sudo yum install ncurses-libs libXft libXrender libXtst libXi这些库主要是图形界面和文本界面依赖的缺少任何一个Pango Design Suite的主程序都可能启动不了。Linux下安装还有一个坑是USB下载器的权限问题。普通用户访问USB设备需要配置udev规则不然开发板连上之后没有权限访问。紫光同创的安装包里一般会附带99-pango.rules之类的文件把它拷贝到/etc/udev/rules.d/目录下然后重新加载udev规则sudo cp 99-pango.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules sudo service udev restart做完这一步开发板插入后普通用户才能正常识别和使用。3. License配置关键一步不容出错3.1 认识License文件先搞清楚它是干嘛的License可以理解为软件的使用授权凭证。Pango Design Suite的License文件里包含了授权使用的功能模块、授权期限、绑定的MAC地址等信息。没有License工具打开后没法进行综合和布局布线只能看看界面。License主要分两种Node-Locked License节点锁定型绑定特定电脑的MAC地址只能在一台机器上用Floating License浮动型部署在服务器上局域网内多台机器可以同时使用个人开发和高校学习基本都是Node-Locked License企业用户可能会有浮动License的需求。申请的时候要说清楚自己是什么使用场景。拿到License文件后先用记事本打开检查一下确认里面的MAC地址和你本机的MAC地址一致。如果不一致说明这个License不是给这台机器生成的需要重新申请。3.2 环境变量配置Windows和Linux各来一遍License的加载方式有两种一种是通过环境变量指定License文件的路径另一种是通过工具界面加载。环境变量是更可靠的方式工具启动时会自动读取。Windows环境下配置环境变量的步骤右键“此电脑”选择“属性”点击“高级系统设置”点击“环境变量”在“系统变量”区域点击“新建”变量名填LM_LICENSE_FILE变量值填License文件的完整路径比如D:\PDS2020.3\license.dat点击确定保存这里要注意变量名不要写错。我遇到过有人把LM_LICENSE_FILE写成了LM_LICENSE_PATH结果工具一直报找不到License。另外如果你的工具是2020.3之后的版本也可能会读PDS_LICENSE_FILE这个变量保险起见两个都配上路径填同一个License文件。Linux环境下配置环境变量修改~/.bashrc或~/.bash_profile在文件末尾追加export LM_LICENSE_FILE/opt/PDS2020.3/license.dat然后执行source ~/.bashrc让配置生效。3.3 使用License管理工具加载更直观也更保险除了环境变量Pango Design Suite还自带License管理工具。这个工具在主程序安装目录下Windows下可以在“开始”菜单找到Linux下可以在安装目录的bin文件夹下找到。用License管理工具的好处是加载成功后会在界面上显示License的详细信息包括授权功能、到期时间等一目了然。操作步骤也不复杂打开License管理工具选择“加载License”或“Load License”选项浏览选择License文件点击加载稍等片刻会显示加载结果如果加载失败工具会给出错误提示比如MAC地址不匹配、License过期、格式错误等。根据提示排查就好这种可视化方式比黑乎乎的命令行好排查得多。我个人是环境变量和License管理工具两者都配置一遍的这样最稳。因为有些版本的Pango Design Suite在启动时只读环境变量有些版本则会优先检查工具内部配置两者都配好可以避免很多莫名其妙的问题。完成License配置后重新启动Pango Design Suite正常情况下会正常进入开发界面。如果还是报License错误先别急直接跳到第5节看问题排查。4. 快速验证安装用工程说话4.1 新建第一个工程确认工具链跑通安装和License配置都搞定后最好立刻创建一个工程来验证整条工具链是否正常。这一步很花时间但非常有必要如果等到真正做项目时才发工具有问题那是件很让头疼的事。打开Pango Design Suite界面风格跟Vivado和Quartus有些类似上手难度不大。创建工程的入口一般在File菜单下的New Project或者欢迎界面的Create New Project。点击后会弹出工程创建向导。工程创建向导里的关键选项Project Name工程名称建议用英文不要有空格Project Location工程存放路径同样不要有中文和空格Device Family根据你手上的开发板芯片来选择比如Logos系列、Titan系列等Device具体的芯片型号要精确到后缀我建工程习惯用D:\FPGA_Projects作为根目录每个项目单独建文件夹工程名和文件夹名保持一致。这个习惯在工程多了之后好处很明显查找和管理都方便。创建完工程后界面会显示工程的综合状态。如果是空工程显示的就是空白的状态树。接下来添加一个简单的Verilog文件来验证编译流程。点击添加源文件选择Verilog文件类型文件名命名一个top.v然后在编辑器里写一个最简单的逻辑module top( input wire clk, input wire rst_n, output reg led ); always (posedge clk or negedge rst_n) begin if (!rst_n) led 1b0; else led ~led; end endmodule这段代码实现的是一个简单的LED翻转逻辑作为验证工具链和硬件平台的“Hello World”。写好之后保存先做语法检查然后进行综合。4.2 跑一遍完整流程综合布线一个不少综合在Pango Design Suite里叫Synthesis点击工具条上的综合按钮工具会开始分析代码并生成网表。第一次跑综合会稍微慢一些因为工具在建立缓存和编译库文件。综合完成后状态树里会多出综合结果的节点同时会生成资源占用报告。在看资源报告时留意一下LUT、FF、IO的使用数量这些数据能帮助判断设计是否符合预期。如果资源占用为0或者报错说明代码有问题或者综合没跑成功。综合通过后就进行布局布线这个阶段耗时一般比综合长。布局布线完成后工具会生成时序报告包括建立时间、保持时间的余量。对于跑时钟频率不高的简单逻辑这个阶段的时序应该很充裕。接下来是生成比特流文件Bitstream在Pango Design Suite里不同系列的芯片生成的文件格式略有差异但作用相同都是用来下载到FPGA配置芯片的固件。生成比特流是整个开发流程的最终产物生成成功意味着工具链完整跑通了编译方面没有问题。4.3 连接开发板做下载验证真实硬件才算数软件编译流程验证通过后有条件的话建议连接一块真实的开发板做下载测试这是验证安装环境最彻底的方式。用USB线将开发板连接到电脑安装好的下载器驱动应该能自动识别设备。在设备管理器里如果能看到一个额外的USB设备节点,说明驱动正常工作。如果设备节点带黄色感叹号说明驱动没装好回到安装目录重新安装驱动。连接好开发板后在Pango Design Suite里打开下载模式选择生成的比特流文件点击下载。下载成功后开发板上的LED灯应该开始按代码逻辑闪烁这就说明从软件安装到License配置再到硬件连接整个环境全部正常工作。我自己的习惯是新环境安装完成后一定会跑一遍这个流程确保环境可用才放心。不然等开发到一半才发现环境有问题排查起来很费时间。5. 关键问题与排查技巧实录5.1 启动或编译报错先从常见问题查起安装和使用过程中遇到的问题大部分都集中在几个固定的坑上。先整理一个速查表后面详细展开问题现象可能原因解决办法启动提示License错误License未加载、MAC不匹配检查环境变量、重新申请License启动闪退或卡启动界面安装路径有中文、系统兼容性问题重装到纯英文路径综合报“command not found”环境变量PATH没配置将工具bin目录加入PATH运行仿真失败仿真组件未安装重新安装时勾选仿真组件USB下载器无法识别驱动未装或权限问题重装驱动、配置udev规则License相关的错误是最常见的一类。工具启动时弹窗提示License不可用先检查环境变量是否配置正确然后检查License文件内的MAC地址是否与本机一致最后确认License是否在有效期内。这三点都确认了还报错那就是License文件本身有问题需要联系技术支持重新生成。启动闪退的问题我遇到的绝大多数是安装路径有中文导致的。Pango Design Suite对中文路径的支持不太好安装路径或工程路径中出现中文轻则警告重则直接闪退。解决方案只能是卸载重装用纯英文路径。综合报“command not found”的情况比较特殊可能是环境变量PATH中没有包含工具的bin目录。在Windows系统下需要把工具安装目录下的bin文件夹路径追加到系统的PATH环境变量中。Linux系统下安装脚本一般会自动配置但如果你换了shell或者手动改了.bashrc可能需要检查一下是否被覆盖。5.2 Linux环境特有的问题补充几个Linux下运行Pango Design Suite除了之前提到的依赖库和udev规则还有几个比较有代表性的问题。一是字符编码问题。有些Linux环境默认的locale是UTF-8但Pango Design Suite的某些组件对locale比较敏感启动时可能报locale相关的警告。可以通过设置LANGC或LANGen_US.UTF-8来规避具体用哪个取决于你的系统环境。在启动命令前加上环境变量export LC_ALLC二是OpenGL渲染问题。如果你的Linux主机显卡驱动没有装好工具启动时可能黑屏或界面显示异常。这种情况通常需要安装显卡官方驱动或者确认OpenGL库完整。如果只是偶尔出现花屏问题可以试试修改工具的界面渲染模式有些版本的Pango支持通过启动参数切换软件渲染。三是虚拟机和远程桌面环境下运行问题。如果你在虚拟机里装Pango需要注意虚拟机的3D加速和显存配置。远程桌面环境下由于图形界面的渲染方式不同偶尔会有界面刷新异常这个跟网络质量和远程桌面协议都有关系。有条件的话本地操作体验会好很多。5.3 我的避坑笔记几个值得养成的习惯安装完Pango Design Suite并跑通一个完整工程后我总结了一些日常使用中非常值得养成的习惯这些习惯帮我省去了很多麻烦。第一做好备份和版本管理。Pango Design Suite的工程文件是整个项目开发的核心建议定期备份或者使用版本控制工具进行管理。FPGA工程的源文件和约束文件都是文本文件适合版本管理养成提交记录的习惯出问题时能快速回退。我个人比较推荐把工程放到云盘或者本地NAS同步目录里这样即使电脑出问题工程文件也有保障。第二详细阅读官方文档和资源。Pango Design Suite有相当详细的官方文档包括用户手册、教程、参考设计等。遇到问题先查文档大部分问题都能找到答案比网上零散搜索有效率得多。紫光同创的开发者社区和论坛也值得常去看看有时候会遇到热心的工程师解答你的疑问。第三保持工具版本更新到最新状态。Pango的版本迭代比国外大厂快新版本往往修复了老版本的一些已知问题并增加了新的器件支持。在日常工作中关注官方的版本升级通告如果有跨版本的大更新建议在非关键时间完成升级验证。版本更新前先查看官方发布的更新说明确认新增功能和修复内容符合自己的需求。这些习惯看起来不起眼但长期坚持下来能极大提升工作效率。我在实际项目开发中深有体会。6. 通用问题与注意事项重要内容再强调6.1 从其他FPGA工具链迁移时容易忽视的几个差异如果你之前用过Xilinx的ISE/Vivado或Intel的Quartus转到Pango Design Suite时会有一定的适应成本。工具界面和操作逻辑大体相似但细节上差异不小下面几点我觉得值得关注。工程文件管理方式不同。Xilinx和Intel的工程文件都有一套自己的格式Pango也有自己的工程格式三者之间不兼容。如果你需要把现有代码从其他平台迁移过来一般需要新建Pango工程然后把源文件复制进去。约束文件的写法也需要调整不同工具之间的约束语法差异较大不能直接复制过去。IP核的使用方式差异更明显。Xilinx的IP核生成需要通过Vivado的IP CatalogIntel的通过Quartus的Platform DesignerPango也有自己的IP核管理工具。但由于IP核是各家工具链自行开发的所以IP核的接口和配置方式各不相同。换句话说你在Vivado里用得再熟的IP核到了Pango这边还是要重新学习和熟悉一次。调试工具的使用也存在差异。Xilinx的ChipScope或Vivado的ILAIntel的SignalTapPango也有对应的在线逻辑分析仪功能但操作方式和信号触发条件的设置上都有差异。如果是刚接触Pango的调试工具建议先用简单的工程把在线调试工具跑通熟悉流程后再做复杂设计。6.2 在线调试工具“相见不相识”教你一个快速上手的方法很多从别的平台转过来的朋友第一次打开Pango的在线逻辑分析仪时一头雾水。我之前也是这个状态最大的困惑就是找不到对应的功能模块在哪。我建议的快速上手路径是先找到工具菜单里的Debug或Logic Analyzer相关入口看一遍帮助文档的截图然后找一个简单的工程比如计数器或LED闪烁把需要观察的信号手动添加到调试界面里跑一遍完整的抓取流程。当你把“添加信号→设置触发条件→运行抓取→查看波形”这个闭环跑通后这套工具的基本用法也就掌握了。需要注意的是不同的芯片系列支持的调试功能有所差异高端芯片的调试能力更强低端芯片的调试资源有限。在验证调试功能前先确认一下你手上的芯片型号是否支持对应的在线逻辑分析功能免得白忙活。6.3 网上下载的代码不能直接用教你快速适配接触FPGA一定绕不过一件事就是下载别人的参考代码来学习和改造。网上关于FPGA的开源项目很多但大多是针对Xilinx或Intel平台的拿到Pango上来用不能直接编译通过。适配别人的代码时主要看三个方面第一约束文件肯定要重写。Xilinx的XDC约束和Intel的QSF约束在Pango里完全不适用。你需要根据Pango的约束语法重新定义管脚位置、电平标准、时钟约束等。这是工作量最大的一块。第二代码中如果有调用特定平台的IP核需要找到Pango对应的IP核并修改接口。比如别人的代码用了Xilinx的FIFO IP核你在Pango里就要用Pango的FIFO IP核替换端口名和参数都需要修改。这部分比较繁琐但逻辑结构是通用的改起来其实不难。第三原语Primitive的处理。在Xilinx和Intel平台下有一些专用的原语比如全局时钟缓冲BUFG、高-speed收发器等。Pango平台也有对应的原语但名称和用法不同。如果原代码使用了平台相关的原语需要查阅Pango的模板和文档替换成Pango的原语写法。我在实际改动别人代码时常用策略是建立一个适配清单逐条记录需要调整的文件和内容。先跑通综合再处理布局布线和约束,一步一步来就不会觉得无从下手。如果真的遇到某些比较繁琐的IP核替换可以考虑干脆在Pango里重新生成一个功能一样的IP核来替代效率反而更高。7. 写在最后的几条经验安装和配置Pango Design Suite 2020.3这件事说难不难说简单也会遇到各种意外情况。我从最初的磕磕绊绊到后来能顺利装好环境并跑通工程最大的感触是FPGA开发工具链的安装过程看似繁琐但每一步都有它的道理。安装路径为什么不要有中文、License为什么要绑定MAC、驱动为什么会安装失败这些问题的答案在你熟悉工具链之后会觉得理所当然但对刚接触的人来说真的会卡住很久。对于那些从Xilinx或Intel平台转过来的朋友我想说的是Pango Design Suite的使用逻辑跟市面上的主流FPGA工具是相通的只要花一点时间适应转过来的难度并没有想象中那么大。真正需要花时间研究的反而是每一次工具版本升级和芯片型号更新带来的细节变化。最后还想建议大家尤其是刚入门的朋友把“看完这篇教程自己去装一遍”作为训练目标。当你能独立完成从下载安装到工程验证的所有步骤时就会积累很多理解。如果在过程中遇到我没提到的问题欢迎记录下来多动手尝试这也是FPGA学习过程中最珍贵的一部分经验。
Pango Design Suite 2020.3安装教程：从环境准备到License配置全流程
紫光同创这几年在国产FPGA圈子里存在感越来越强不管是高校实验室、研究所还是做工业控制的方案商都能看到它的身影。我之前一直在用Xilinx和IntelAltera家的东西第一次接触紫光同创的Pango Design Suite时说实话有点不太适应。但这个工具链这两年的进步确实明显从代码编写到综合布线再到下载调试全流程已经相当完整而且对国产器件的支持力度也很大。这篇教程我会围绕Pango Design Suite 2020.3的完整安装流程来写包括环境准备、软件获取、安装步骤、License配置、工程校验以及常见问题排查。整个安装过程我实际操作过不止一遍Windows和Linux两种环境都踩过坑这里把经验都整理出来。不管你是刚开始学FPGA的新手还是从其他平台转过来的老手按这个流程走基本不会出大问题。1. 环境准备先把“地基”打好1.1 软硬件要求别让电脑成了瓶颈Pango Design Suite 2020.3本身对硬件的要求不算苛刻但FPGA开发工具的通病就是吃内存、吃硬盘。我最初用一台8GB内存的笔记本跑综合稍微大一点的工程就开始卡后来换到16GB才顺畅起来。先看一下最基本的硬件参考配置CPUx86架构即可Intel或AMD都可以主频不建议太低内存最低8GB强烈建议16GB及以上综合和布局布线阶段对内存需求很大硬盘安装包约3GB安装后完整占用接近10GB建议预留30GB以上空间操作系统Windows 7/10/1164位、LinuxUbuntu/CentOS等主流发行版分辨率建议1080P及以上工具界面信息量比较大低分辨率下操作体验很差操作系统这块要注意2020.3这个版本对Windows 11的兼容性不如Windows 10稳定如果你用的是Win11建议优先用Windows 10环境或者准备一台Windows 10的虚拟机做开发。Linux环境我也测过Ubuntu 18.04和CentOS 7都能正常跑但需要手动处理一些依赖库后面会细说。硬盘空间这块很多人会忽略Pango Design Suite安装完成之后除了安装目录本身的占用用户目录下还会生成缓存和工程配置文件项目多起来之后占用增长很快。所以安装前确保系统盘有足够余量免得安装到一半磁盘满了报错。1.2 安装包和License提前找好渠道安装包和License文件的获取是很多新手卡住的第一道坎。紫光同创的软件不像Xilinx和Intel那样完全开放下载需要走官方渠道。获取安装包的途径主要有这么几个紫光同创官网注册开发者账号在下载中心申请联系紫光同创的技术支持或代理商通过邮件获取高校用户可以通过学校的FPGA实验室或校企合作渠道统一申请我自己的经验是直接联系技术支持效率最高。官网申请有时候响应慢电话或者邮件联系技术支持说明来意和使用的芯片型号一般当天就能拿到下载链接。License文件也是同样的渠道技术支持会根据你提供的MAC地址生成对应的License。这里有个重要的细节License是绑定电脑的申请时需要提供网卡的MAC地址。不同电脑的MAC地址不同License不能混用。如果你在台式机和笔记本之间切换开发环境需要分别申请对应的License。另外紫光同创偶尔会提供试用License有效期一般是30天到90天适合前期评估和学习。但试用License功能上可能会有部分限制比如不支持某些高级IP核或加密功能正式项目还是要申请正式License。2. 安装流程详解一步步来别跳步2.1 Windows安装注意选装组件拿到安装包之后先解压到一个没有中文和空格的路径下。比如D:\PDS2020.3或者E:\Tools\PDS\2020.3解压路径有中文的话后面启动工具时可能会出莫名其妙的报错而且这种报错很难排查。解压完成后找到安装程序一般是setup.exe或install.bat右键以管理员身份运行。这一步非常关键如果不以管理员身份运行后续安装驱动和写注册表环节可能会失败。安装流程大致是进入欢迎界面点击Next阅读并接受许可协议选择安装路径这里再次强调不要有中文和空格选择安装组件一般全选即可点击Install开始安装组件选择这里多说一句如果你只是做逻辑开发不涉及仿真和调试可以只装主程序和下载器驱动。但我的建议是能装的全装上尤其是USB下载器驱动必须装不然开发板连不上电脑。Simulation组件如果你有自己的仿真工具可以不用装但装了也不碍事。整个安装过程大约需要10到20分钟取决于电脑性能。装到一半的时候会弹出一个驱动安装的窗口这个就是USB下载器的驱动点击安装即可。如果驱动安装提示失败不要慌装完主程序后可以手动去安装目录下的driver文件夹里重新安装。安装完成后桌面上会出现Pango Design Suite的快捷方式。第一次双击启动会稍微慢一点工具在初始化环境耐心等一会儿。如果启动后界面直接显示License错误先别急License配置放在下一节专门讲。2.2 Linux安装依赖库和权限问题比较多Linux环境下安装Pango Design Suite 2020.3麻烦主要集中在依赖库和系统权限上。我之前在Ubuntu 18.04上装过一次花了不少时间才跑通。安装包一般是.tar.gz压缩包先解压到一个合适的目录tar -zxvf PDS2020.3-linux-installer.tar.gz解压后进入目录里面会有安装脚本通常叫install或install.sh执行时需要root权限sudo ./install安装过程跟Windows类似会有交互式的安装向导按提示操作即可。但在正式安装之前建议先装好依赖库不然装到一半会因为缺少某些库文件而报错。Ubuntu系统建议提前安装这些依赖sudo apt-get update sudo apt-get install libncurses5 libncurses5-dev libxft2 libxrender1 libxtst6 libxi6CentOS系统则是sudo yum install ncurses-libs libXft libXrender libXtst libXi这些库主要是图形界面和文本界面依赖的缺少任何一个Pango Design Suite的主程序都可能启动不了。Linux下安装还有一个坑是USB下载器的权限问题。普通用户访问USB设备需要配置udev规则不然开发板连上之后没有权限访问。紫光同创的安装包里一般会附带99-pango.rules之类的文件把它拷贝到/etc/udev/rules.d/目录下然后重新加载udev规则sudo cp 99-pango.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules sudo service udev restart做完这一步开发板插入后普通用户才能正常识别和使用。3. License配置关键一步不容出错3.1 认识License文件先搞清楚它是干嘛的License可以理解为软件的使用授权凭证。Pango Design Suite的License文件里包含了授权使用的功能模块、授权期限、绑定的MAC地址等信息。没有License工具打开后没法进行综合和布局布线只能看看界面。License主要分两种Node-Locked License节点锁定型绑定特定电脑的MAC地址只能在一台机器上用Floating License浮动型部署在服务器上局域网内多台机器可以同时使用个人开发和高校学习基本都是Node-Locked License企业用户可能会有浮动License的需求。申请的时候要说清楚自己是什么使用场景。拿到License文件后先用记事本打开检查一下确认里面的MAC地址和你本机的MAC地址一致。如果不一致说明这个License不是给这台机器生成的需要重新申请。3.2 环境变量配置Windows和Linux各来一遍License的加载方式有两种一种是通过环境变量指定License文件的路径另一种是通过工具界面加载。环境变量是更可靠的方式工具启动时会自动读取。Windows环境下配置环境变量的步骤右键“此电脑”选择“属性”点击“高级系统设置”点击“环境变量”在“系统变量”区域点击“新建”变量名填LM_LICENSE_FILE变量值填License文件的完整路径比如D:\PDS2020.3\license.dat点击确定保存这里要注意变量名不要写错。我遇到过有人把LM_LICENSE_FILE写成了LM_LICENSE_PATH结果工具一直报找不到License。另外如果你的工具是2020.3之后的版本也可能会读PDS_LICENSE_FILE这个变量保险起见两个都配上路径填同一个License文件。Linux环境下配置环境变量修改~/.bashrc或~/.bash_profile在文件末尾追加export LM_LICENSE_FILE/opt/PDS2020.3/license.dat然后执行source ~/.bashrc让配置生效。3.3 使用License管理工具加载更直观也更保险除了环境变量Pango Design Suite还自带License管理工具。这个工具在主程序安装目录下Windows下可以在“开始”菜单找到Linux下可以在安装目录的bin文件夹下找到。用License管理工具的好处是加载成功后会在界面上显示License的详细信息包括授权功能、到期时间等一目了然。操作步骤也不复杂打开License管理工具选择“加载License”或“Load License”选项浏览选择License文件点击加载稍等片刻会显示加载结果如果加载失败工具会给出错误提示比如MAC地址不匹配、License过期、格式错误等。根据提示排查就好这种可视化方式比黑乎乎的命令行好排查得多。我个人是环境变量和License管理工具两者都配置一遍的这样最稳。因为有些版本的Pango Design Suite在启动时只读环境变量有些版本则会优先检查工具内部配置两者都配好可以避免很多莫名其妙的问题。完成License配置后重新启动Pango Design Suite正常情况下会正常进入开发界面。如果还是报License错误先别急直接跳到第5节看问题排查。4. 快速验证安装用工程说话4.1 新建第一个工程确认工具链跑通安装和License配置都搞定后最好立刻创建一个工程来验证整条工具链是否正常。这一步很花时间但非常有必要如果等到真正做项目时才发工具有问题那是件很让头疼的事。打开Pango Design Suite界面风格跟Vivado和Quartus有些类似上手难度不大。创建工程的入口一般在File菜单下的New Project或者欢迎界面的Create New Project。点击后会弹出工程创建向导。工程创建向导里的关键选项Project Name工程名称建议用英文不要有空格Project Location工程存放路径同样不要有中文和空格Device Family根据你手上的开发板芯片来选择比如Logos系列、Titan系列等Device具体的芯片型号要精确到后缀我建工程习惯用D:\FPGA_Projects作为根目录每个项目单独建文件夹工程名和文件夹名保持一致。这个习惯在工程多了之后好处很明显查找和管理都方便。创建完工程后界面会显示工程的综合状态。如果是空工程显示的就是空白的状态树。接下来添加一个简单的Verilog文件来验证编译流程。点击添加源文件选择Verilog文件类型文件名命名一个top.v然后在编辑器里写一个最简单的逻辑module top( input wire clk, input wire rst_n, output reg led ); always (posedge clk or negedge rst_n) begin if (!rst_n) led 1b0; else led ~led; end endmodule这段代码实现的是一个简单的LED翻转逻辑作为验证工具链和硬件平台的“Hello World”。写好之后保存先做语法检查然后进行综合。4.2 跑一遍完整流程综合布线一个不少综合在Pango Design Suite里叫Synthesis点击工具条上的综合按钮工具会开始分析代码并生成网表。第一次跑综合会稍微慢一些因为工具在建立缓存和编译库文件。综合完成后状态树里会多出综合结果的节点同时会生成资源占用报告。在看资源报告时留意一下LUT、FF、IO的使用数量这些数据能帮助判断设计是否符合预期。如果资源占用为0或者报错说明代码有问题或者综合没跑成功。综合通过后就进行布局布线这个阶段耗时一般比综合长。布局布线完成后工具会生成时序报告包括建立时间、保持时间的余量。对于跑时钟频率不高的简单逻辑这个阶段的时序应该很充裕。接下来是生成比特流文件Bitstream在Pango Design Suite里不同系列的芯片生成的文件格式略有差异但作用相同都是用来下载到FPGA配置芯片的固件。生成比特流是整个开发流程的最终产物生成成功意味着工具链完整跑通了编译方面没有问题。4.3 连接开发板做下载验证真实硬件才算数软件编译流程验证通过后有条件的话建议连接一块真实的开发板做下载测试这是验证安装环境最彻底的方式。用USB线将开发板连接到电脑安装好的下载器驱动应该能自动识别设备。在设备管理器里如果能看到一个额外的USB设备节点,说明驱动正常工作。如果设备节点带黄色感叹号说明驱动没装好回到安装目录重新安装驱动。连接好开发板后在Pango Design Suite里打开下载模式选择生成的比特流文件点击下载。下载成功后开发板上的LED灯应该开始按代码逻辑闪烁这就说明从软件安装到License配置再到硬件连接整个环境全部正常工作。我自己的习惯是新环境安装完成后一定会跑一遍这个流程确保环境可用才放心。不然等开发到一半才发现环境有问题排查起来很费时间。5. 关键问题与排查技巧实录5.1 启动或编译报错先从常见问题查起安装和使用过程中遇到的问题大部分都集中在几个固定的坑上。先整理一个速查表后面详细展开问题现象可能原因解决办法启动提示License错误License未加载、MAC不匹配检查环境变量、重新申请License启动闪退或卡启动界面安装路径有中文、系统兼容性问题重装到纯英文路径综合报“command not found”环境变量PATH没配置将工具bin目录加入PATH运行仿真失败仿真组件未安装重新安装时勾选仿真组件USB下载器无法识别驱动未装或权限问题重装驱动、配置udev规则License相关的错误是最常见的一类。工具启动时弹窗提示License不可用先检查环境变量是否配置正确然后检查License文件内的MAC地址是否与本机一致最后确认License是否在有效期内。这三点都确认了还报错那就是License文件本身有问题需要联系技术支持重新生成。启动闪退的问题我遇到的绝大多数是安装路径有中文导致的。Pango Design Suite对中文路径的支持不太好安装路径或工程路径中出现中文轻则警告重则直接闪退。解决方案只能是卸载重装用纯英文路径。综合报“command not found”的情况比较特殊可能是环境变量PATH中没有包含工具的bin目录。在Windows系统下需要把工具安装目录下的bin文件夹路径追加到系统的PATH环境变量中。Linux系统下安装脚本一般会自动配置但如果你换了shell或者手动改了.bashrc可能需要检查一下是否被覆盖。5.2 Linux环境特有的问题补充几个Linux下运行Pango Design Suite除了之前提到的依赖库和udev规则还有几个比较有代表性的问题。一是字符编码问题。有些Linux环境默认的locale是UTF-8但Pango Design Suite的某些组件对locale比较敏感启动时可能报locale相关的警告。可以通过设置LANGC或LANGen_US.UTF-8来规避具体用哪个取决于你的系统环境。在启动命令前加上环境变量export LC_ALLC二是OpenGL渲染问题。如果你的Linux主机显卡驱动没有装好工具启动时可能黑屏或界面显示异常。这种情况通常需要安装显卡官方驱动或者确认OpenGL库完整。如果只是偶尔出现花屏问题可以试试修改工具的界面渲染模式有些版本的Pango支持通过启动参数切换软件渲染。三是虚拟机和远程桌面环境下运行问题。如果你在虚拟机里装Pango需要注意虚拟机的3D加速和显存配置。远程桌面环境下由于图形界面的渲染方式不同偶尔会有界面刷新异常这个跟网络质量和远程桌面协议都有关系。有条件的话本地操作体验会好很多。5.3 我的避坑笔记几个值得养成的习惯安装完Pango Design Suite并跑通一个完整工程后我总结了一些日常使用中非常值得养成的习惯这些习惯帮我省去了很多麻烦。第一做好备份和版本管理。Pango Design Suite的工程文件是整个项目开发的核心建议定期备份或者使用版本控制工具进行管理。FPGA工程的源文件和约束文件都是文本文件适合版本管理养成提交记录的习惯出问题时能快速回退。我个人比较推荐把工程放到云盘或者本地NAS同步目录里这样即使电脑出问题工程文件也有保障。第二详细阅读官方文档和资源。Pango Design Suite有相当详细的官方文档包括用户手册、教程、参考设计等。遇到问题先查文档大部分问题都能找到答案比网上零散搜索有效率得多。紫光同创的开发者社区和论坛也值得常去看看有时候会遇到热心的工程师解答你的疑问。第三保持工具版本更新到最新状态。Pango的版本迭代比国外大厂快新版本往往修复了老版本的一些已知问题并增加了新的器件支持。在日常工作中关注官方的版本升级通告如果有跨版本的大更新建议在非关键时间完成升级验证。版本更新前先查看官方发布的更新说明确认新增功能和修复内容符合自己的需求。这些习惯看起来不起眼但长期坚持下来能极大提升工作效率。我在实际项目开发中深有体会。6. 通用问题与注意事项重要内容再强调6.1 从其他FPGA工具链迁移时容易忽视的几个差异如果你之前用过Xilinx的ISE/Vivado或Intel的Quartus转到Pango Design Suite时会有一定的适应成本。工具界面和操作逻辑大体相似但细节上差异不小下面几点我觉得值得关注。工程文件管理方式不同。Xilinx和Intel的工程文件都有一套自己的格式Pango也有自己的工程格式三者之间不兼容。如果你需要把现有代码从其他平台迁移过来一般需要新建Pango工程然后把源文件复制进去。约束文件的写法也需要调整不同工具之间的约束语法差异较大不能直接复制过去。IP核的使用方式差异更明显。Xilinx的IP核生成需要通过Vivado的IP CatalogIntel的通过Quartus的Platform DesignerPango也有自己的IP核管理工具。但由于IP核是各家工具链自行开发的所以IP核的接口和配置方式各不相同。换句话说你在Vivado里用得再熟的IP核到了Pango这边还是要重新学习和熟悉一次。调试工具的使用也存在差异。Xilinx的ChipScope或Vivado的ILAIntel的SignalTapPango也有对应的在线逻辑分析仪功能但操作方式和信号触发条件的设置上都有差异。如果是刚接触Pango的调试工具建议先用简单的工程把在线调试工具跑通熟悉流程后再做复杂设计。6.2 在线调试工具“相见不相识”教你一个快速上手的方法很多从别的平台转过来的朋友第一次打开Pango的在线逻辑分析仪时一头雾水。我之前也是这个状态最大的困惑就是找不到对应的功能模块在哪。我建议的快速上手路径是先找到工具菜单里的Debug或Logic Analyzer相关入口看一遍帮助文档的截图然后找一个简单的工程比如计数器或LED闪烁把需要观察的信号手动添加到调试界面里跑一遍完整的抓取流程。当你把“添加信号→设置触发条件→运行抓取→查看波形”这个闭环跑通后这套工具的基本用法也就掌握了。需要注意的是不同的芯片系列支持的调试功能有所差异高端芯片的调试能力更强低端芯片的调试资源有限。在验证调试功能前先确认一下你手上的芯片型号是否支持对应的在线逻辑分析功能免得白忙活。6.3 网上下载的代码不能直接用教你快速适配接触FPGA一定绕不过一件事就是下载别人的参考代码来学习和改造。网上关于FPGA的开源项目很多但大多是针对Xilinx或Intel平台的拿到Pango上来用不能直接编译通过。适配别人的代码时主要看三个方面第一约束文件肯定要重写。Xilinx的XDC约束和Intel的QSF约束在Pango里完全不适用。你需要根据Pango的约束语法重新定义管脚位置、电平标准、时钟约束等。这是工作量最大的一块。第二代码中如果有调用特定平台的IP核需要找到Pango对应的IP核并修改接口。比如别人的代码用了Xilinx的FIFO IP核你在Pango里就要用Pango的FIFO IP核替换端口名和参数都需要修改。这部分比较繁琐但逻辑结构是通用的改起来其实不难。第三原语Primitive的处理。在Xilinx和Intel平台下有一些专用的原语比如全局时钟缓冲BUFG、高-speed收发器等。Pango平台也有对应的原语但名称和用法不同。如果原代码使用了平台相关的原语需要查阅Pango的模板和文档替换成Pango的原语写法。我在实际改动别人代码时常用策略是建立一个适配清单逐条记录需要调整的文件和内容。先跑通综合再处理布局布线和约束,一步一步来就不会觉得无从下手。如果真的遇到某些比较繁琐的IP核替换可以考虑干脆在Pango里重新生成一个功能一样的IP核来替代效率反而更高。7. 写在最后的几条经验安装和配置Pango Design Suite 2020.3这件事说难不难说简单也会遇到各种意外情况。我从最初的磕磕绊绊到后来能顺利装好环境并跑通工程最大的感触是FPGA开发工具链的安装过程看似繁琐但每一步都有它的道理。安装路径为什么不要有中文、License为什么要绑定MAC、驱动为什么会安装失败这些问题的答案在你熟悉工具链之后会觉得理所当然但对刚接触的人来说真的会卡住很久。对于那些从Xilinx或Intel平台转过来的朋友我想说的是Pango Design Suite的使用逻辑跟市面上的主流FPGA工具是相通的只要花一点时间适应转过来的难度并没有想象中那么大。真正需要花时间研究的反而是每一次工具版本升级和芯片型号更新带来的细节变化。最后还想建议大家尤其是刚入门的朋友把“看完这篇教程自己去装一遍”作为训练目标。当你能独立完成从下载安装到工程验证的所有步骤时就会积累很多理解。如果在过程中遇到我没提到的问题欢迎记录下来多动手尝试这也是FPGA学习过程中最珍贵的一部分经验。
