1. 为什么安路TD5.6.1的安装值得单独写一篇安路科技的TD系列FPGA开发工具在国产FPGA圈子里算是比较有存在感的一套EDA软件。TD5.6.1这个版本是很多做国产化替代项目、教学实验板、工业控制板卡的工程师会接触到的一个版本。它不像国外那几家大厂的工具有那么完善的在线安装引导TD的安装过程有几个比较讲究的地方——安装路径不能带中文、License要单独配置、下载器驱动要手动装、部分系统还需要额外处理运行库。这些点如果没人提前告诉你第一次装大概率要折腾一两个小时。这篇内容就是把我自己在几台不同配置的机器上装TD5.6.1的完整过程整理出来包括安装前的环境检查、安装包结构说明、主程序安装、License配置、下载器驱动安装、以及装完之后怎么验证工具链是通的。适合刚拿到安路开发板、准备上手TD工具的初学者也适合需要在多台机器上批量部署的工程师参考。需要先说明一点安装包本身请通过安路官方渠道或你购买开发板时配套提供的渠道获取我这里只讲安装步骤和配置方法不提供任何非官方的下载链接。这一点很重要用来源不明的安装包后面License和驱动出问题会很难排查。2. 装之前先把这几件事确认清楚2.1 系统版本与位数匹配TD5.6.1是64位工具32位系统直接不用考虑。Windows这边Win10 64位和Win11 64位是主流选择Win7 64位也能装但部分新版本的驱动在Win7上会有签名问题需要额外处理。Linux版本的话官方一般提供的是特定发行版适配的包常见的是CentOS和Ubuntu的某些版本如果你用的是其他发行版可能需要自己处理依赖库。我实测下来Win10 专业版 21H2之后的版本兼容性最好Win11也没问题。如果你是在虚拟机里装建议至少分配4核CPU、8GB内存、100GB磁盘空间TD综合大一点的工程对内存吃得不轻。2.2 安装路径的硬性要求这是最容易踩的坑安装路径绝对不能包含中文、空格和特殊字符。我见过有人装在D:\安路工具\TD下面结果综合的时候报一堆找不到文件的错误排查半天才发现是路径问题。推荐的路径写法D:\Anlogic\TD5.6.1或者C:\Anlogic\TD5.6.1路径层级也不要太深控制在三层以内比较稳妥。另外安装盘剩余空间建议留30GB以上TD本体加上器件库、示例工程占用的空间比很多人想象的大。2.3 关掉杀毒软件的实时防护这个不是危言耸听。TD安装过程中会释放一些底层驱动文件和可执行程序部分杀毒软件会误报导致文件被隔离装完之后工具打不开或者下载器识别不到。安装前把Windows Defender的实时防护临时关掉或者把安装目录加入白名单装完再开回来。第三方杀毒软件同理。2.4 确认你拿到的是完整安装包TD5.6.1的安装包通常是一个主安装程序加若干器件库文件或者是一个大的压缩包解压后得到安装目录。拿到之后先看文件结构一般会有类似这样的内容文件/目录作用TD_5.6.1_Setup.exe主安装程序devices 或 device_lib器件库文件drivers下载器驱动目录licenseLicense相关文件或说明doc安装说明和用户手册如果解压后发现文件明显不全或者压缩包有损坏提示别急着装重新获取一份完整的。装到一半报错再回头找原因成本更高。3. 主程序安装的完整操作链路3.1 启动安装程序与初始选择双击主安装程序如果系统弹UAC提示选是。安装向导起来之后第一步通常是选择安装语言选中文或英文都行不影响功能。接着是欢迎界面直接下一步。关键的一步在安装类型选择这里。TD一般提供两种模式典型安装Typical装主程序加常用器件库适合大多数人。自定义安装Custom可以勾选具体要装哪些器件系列、要不要装示例工程、要不要装文档。我的建议是第一次装选自定义把你要用的器件系列勾上用不到的可以不装能省不少空间。比如你手头是EG4系列或者ELF系列的开发板就只勾对应的器件库。但如果你不确定以后会用到什么那就典型安装省心。3.2 安装路径设置与组件勾选到了路径选择界面点浏览选你之前准备好的那个纯英文路径。这里再强调一次别偷懒用默认路径默认路径有时候会带用户名而用户名如果是中文的一样会出问题。组件勾选界面除了器件库通常还有这几项USB Cable Driver下载器驱动建议勾上后面省得单独装。Examples示例工程初学者建议勾上装完可以直接跑例程验证。Documentation用户手册和API文档看个人需要。勾完之后点安装等待进度条走完。这个过程根据机器性能大概5到15分钟不等。期间如果弹出驱动安装确认窗口一律选安装或仍然安装。3.3 安装完成后的第一件事安装程序跑完之后先别急着打开软件。第一件事是去安装目录下确认几个关键文件是否存在D:\Anlogic\TD5.6.1\bin\td.exe 主程序 D:\Anlogic\TD5.6.1\drivers\ 驱动目录 D:\Anlogic\TD5.6.1\license\ License目录如果bin目录下没有主程序或者drivers目录是空的说明安装过程有问题大概率是杀毒软件拦截了。这种情况把杀毒软件关掉重新装一遍。确认文件齐全之后再双击主程序启动。第一次启动会比较慢因为要初始化器件库和配置环境。如果启动过程中报找不到器件库或者License无效先别慌往下看License配置那部分。4. License配置TD5.6.1能不能跑起来的关键4.1 先搞清楚你需要哪种License安路TD的License分几种情况一种是随开发板附带的License文件一种是官方提供的试用License还有一种是企业采购的正式License。不同来源的License配置方式略有差异但核心逻辑是一样的——把License文件放到指定位置然后让工具能找到它。License文件通常是一个.lic后缀的文本文件或者是一个加密的二进制文件。拿到之后先用文本编辑器打开看看如果是文本格式里面一般会包含主机ID、有效期、支持的器件系列等信息。4.2 License文件该放哪里TD查找License的顺序一般是环境变量指定的路径 → 安装目录下的license文件夹 → 用户目录下的配置文件夹。最稳妥的做法是放到安装目录的license文件夹下D:\Anlogic\TD5.6.1\license\anlogic.lic放好之后还需要确认环境变量。有些版本的TD需要手动设置一个环境变量指向License文件。在系统环境变量里新建变量名ANLOGIC_LICENSE_FILE 变量值D:\Anlogic\TD5.6.1\license\anlogic.lic设置完环境变量记得重启一下命令行或者注销重登让变量生效。4.3 License不生效的几种典型表现与排查装完License之后启动TD如果出现下面这些情况说明License没配好启动时弹窗提示License file not found或Invalid license。能打开软件但新建工程时器件列表是空的。综合的时候报License does not support this device。排查顺序是这样的先确认License文件路径没有中文和空格再确认环境变量名拼写正确不同版本可能不一样以你手头版本的文档为准然后确认License文件本身没有过期用文本编辑器看有效期字段最后确认License支持的器件系列和你实际用的器件匹配。注意License文件不要随意修改内容尤其是文本格式的License改一个字符都可能导致校验失败。如果确实需要更新找提供License的渠道重新获取。4.4 关于License的常见误区很多人以为装完软件就万事大吉结果卡在License上。还有一个误区是以为License可以随便复制到多台机器用。实际上大部分License是绑定主机ID或者网卡MAC地址的换机器需要重新申请。如果你要在多台机器上部署提前确认License的授权范围别装完了才发现用不了。5. 下载器驱动安装连不上板子多半是这里的问题5.1 驱动安装的时机TD安装过程中如果勾选了USB Cable Driver驱动会自动装。但自动装有时候不靠谱尤其是Win10和Win11对驱动签名要求比较严。所以我的习惯是不管自动装没装装完主程序之后手动再装一遍驱动。驱动文件一般在安装目录的drivers文件夹下或者在你拿到的安装包里单独有一个drivers目录。里面通常会有针对不同下载器的驱动比如Anlogic USB Cable、AL-Link等。5.2 手动安装驱动的步骤把下载器插到电脑USB口上然后打开设备管理器。这时候你应该能看到一个带黄色感叹号的设备名字可能是Unknown Device或者USB Device。右键这个设备选更新驱动程序→浏览我的电脑以查找驱动程序→指向drivers目录。如果系统提示驱动未签名选择仍然安装此驱动程序软件。装完之后设备管理器里应该能看到一个正常的设备名字类似Anlogic USB Cable或者AL-Link。这时候下载器就算装好了。5.3 驱动装完还是识别不到怎么办如果驱动装了但TD里还是找不到下载器按这个顺序排查换一个USB口优先用主板后置的USB口别用前面板或者USB Hub。换一根USB线有些线只能充电不能传数据。在设备管理器里卸载设备勾选删除驱动程序软件然后重新插拔重新装驱动。确认下载器本身没坏换一台电脑试试。如果是Win11检查一下内存完整性和核心隔离设置这两个功能有时候会拦截未签名驱动。我遇到过最离谱的一次是USB线的问题换了三根线才找到一根能正常识别的。所以别小看线材。6. 装完之后怎么验证工具链是通的6.1 用示例工程跑一遍完整流程验证工具链最直接的方法就是拿一个官方示例工程从打开到综合到下载跑一遍。安装目录下的Examples文件夹里一般有现成的工程。打开TDFile → Open Project选一个示例工程。然后依次执行综合Synthesize看能不能正常跑完有没有报器件库相关的错误。布局布线Place Route这一步能过说明License和器件库都没问题。生成比特流Generate Bitstream生成.bit或.fs文件。下载Download连上开发板选对下载器把比特流下进去。如果这四步都能走通说明你的TD5.6.1安装和配置是完整的。6.2 常见验证失败的原因对照失败环节可能原因处理方向综合报错找不到器件器件库没装或许可证不支持检查器件库勾选和License范围布局布线卡住或报错工程设置或约束文件问题先用示例工程默认设置跑生成比特流失败License不支持比特流生成确认License类型下载时找不到下载器驱动问题或USB连接问题重装驱动、换线换口下载成功但板子没反应引脚约束或时钟配置问题检查约束文件和板子原理图6.3 环境变量的完整性检查除了License的环境变量TD有时候还需要PATH里包含它的bin目录这样命令行工具才能直接调用。检查一下系统PATH里有没有加上D:\Anlogic\TD5.6.1\bin如果没有手动加上。加完之后在命令行里敲td -version具体命令以你版本为准能输出版本信息就说明命令行环境也配好了。7. 多版本共存与卸载重装的注意事项7.1 同时装多个TD版本会不会冲突有些项目可能要求用特定版本的TD比如老项目用TD4.x新项目用TD5.6.1。这种情况下多版本共存是可行的但要注意几点安装路径要分开环境变量只能指向一个版本通常是你要用的那个License文件也要对应好。切换版本的时候改环境变量或者用批处理脚本切换。我的做法是给每个版本单独写一个启动脚本脚本里临时设置环境变量再启动对应的td.exe这样不用来回改系统环境变量。7.2 卸载重装的正确姿势如果装坏了要重装别直接覆盖安装。正确的顺序是先在控制面板里卸载TD然后手动删除安装目录残留的文件再清理环境变量最后重启电脑再重新安装。残留的配置文件和注册表项有时候会导致重装后出现奇怪的问题。提示卸载前把你自己的工程文件和License文件备份出来卸载程序有时候会连License一起删掉。7.3 安装包和License的归档习惯最后分享一个我自己的习惯每装好一台机器把用到的安装包、License文件、驱动、以及一份自己整理的安装步骤笔记打包归档到一个专门的目录里。过半年再装新机器的时候直接照着笔记走十分钟搞定不用重新踩一遍坑。这个习惯在需要批量部署或者帮同事装环境的时候特别省事。装TD5.6.1这件事说难不难说简单也不简单。核心就是把路径、License、驱动这三件事处理好剩下的就是等进度条。真正花时间的从来不是安装本身而是装完之后发现哪里不对再回头排查。所以宁可装之前多花五分钟确认环境也别装完了再折腾。