常见问题

  • Tang
更新历史
日期 版本 作者 更新内容
2022-10-19 v0.3 wonder
  • 增加设置顶层相关说明
2022-09-23 v0.2 wonder
  • 更新部分过期内容
2022-06-29 v0.1 wonder
  • 初次编写

这里汇总一些常见问题。

Programmer 相关

首先确定设备管理器里面有两个 converter,在进行下面的操作

converter

与上图中一样的话说明电脑与板子连接没问题;不存在的话请稍微等待数秒,可能电脑正在加载驱动;数秒后仍未显示出来 converter 请更换电脑别的 USB 接口或者重新安装驱动点我跳转到驱动下载页面

下载频率

要注意下载频率应该为 2.5M 或者更低的数值。不然很可能导致下载极其缓慢或者下载失败等问题。

点开查看操作步骤图片

点击下图中的 Frequency,设置频率小于或者等于 2.5MHz

接着再点击 Save 即可

Error found

没有扫描到下载器或者驱动错误,要求使用 这里 的压缩包文件。
下载后解压替换掉 Gowin IDE 对应安装目录的 Programmer 文件夹即可。
不会替换的话可以在下载解压后的 Programmer 程序中手动添加对应下载文件来进行烧录。

替换下载器软件后出现这个问题的话,可以先重启一下 programmer 软件;

Cabel open failed

cable_open_failed

在板卡通电的时候需要 2~3s 时间来加载驱动,加载成功后电脑设备管理器中会显示出两个 converter 设备,这个时候就可以正常烧录了。

converter

这里的意思是没有找到下载器,可以尝试使用高云半导体所提供的最新的教育版的编程器 点我跳转 来尝试解决老版本 Programmer 软件的 bug。

使用新版本下载器后出现这个问题的话,可以先重启一下 programmer 软件;依旧没找到的话可以看看本篇开头的 converter 相关的内容。

educational_edition_programmer

No Gowin devices found

no_gowin_device_found

这里指的是没有扫描到高云设备,可以尝试使用高云半导体所提供的最新的教育版的编程器 点我跳转 来尝试解决老版本 Programmer 软件的 bug。

educational_edition_programmer

Nano 9K

Nano 9K 在设计的时候将 JTAG_SEL 引脚连接到了 S2 按键上,根据高云手册可以知道 JTAGSEL_N=0 的时候,芯片的 Jtag 引脚可以正常使用。

jtag_sel_function

在使用 Programmer 对 Nano 9K FPGA 板卡进行操作的时候按住 S2 按键就可以了。

Primer 20K

20K Dock 套件要注意拨动拨码开关使能核心板后,下载软件才可以通过底板识别到底板所插入的核心板。

使能核心板 未使能状态 补充说明
switch_1_on reset_led_on 未使能核心板的话板子上的 0、1 号 LED 会一直亮着,且核心板不会正常启动。

单独使用 20K 核心板和 RV Debugger Plus 下载器来下载固件出现这个错误时,可能是接线错了,自己根据下面的表格检查一下线序,或者检查一下核心板的 8pin 接口有没有被怼歪(有一次连接失败,发现是引脚歪了然后连接不上下载器了;不要大力出奇迹)。

20K 核心板 JTAG 引脚定义可以在背部看到。

核心板 5V0 TMS TDO TCK TDI RX TX GND
调试器 5V0 TMS TDO TCK TDI TX RX GND

cable_connect

对于 20K 板卡来说可能是因为 JTAG 复用而导致主控芯片的 JTAG 引脚不再能被调试,点我来查看相应解决办法

ID code mismatch

id_code_mismatch

这种情况是工程文件设置的芯片与实际下载芯片型号不一致而造成的。

重新设置工程中的芯片型号(比如工程设置、引脚约束、各个IP中的型号)。

板卡型号 芯片系列 芯片设备 封装 速度等级
Tang Nano GW1N GW1N-1 QFN48 C6/I5
Tang Nano 1K GW1NZ GW1NZ-1 QFN48 C6/I5
Tang Nano 4K GW1NSR GW1NSR-4C QFN48P C6/I5 或者 C7/I6
Tang Nano 9K GW1NR GW1NR-9C QFN88P C6/I5
Tang Primer 20K GW2A GW2A-18C PBGA256 C8/I7

spi flash selected mismatch

以高云半导体小蜜蜂(芯片名称以 GW1N 开头的系列)家族芯片为主控的板卡芯片内部含有 FLASH,因此下载的时候将生成的固件烧录到芯片内部即可,将板载的 FLASH 芯片当作外设使用。

以高云半导体晨熙(芯片名称以 GW2A 开头的系列)家族芯片为主控的板卡芯片内部无有 FLASH,因此下载的时候将生成的固件烧录到外部 FLASH,对此在 Programmer 界面所进行的下载模式与 FLASH 选择如下:

flash_mode 操作(Operation)为
exFlash Erase,Program thru GAO-Bridge
Flash 型号选择为 Generic Flash

下载卡住、下载非常慢

不要选中带有 Verify 选项的。

never_choose_verify

另外自己注意设置一下下载频率,一般设置为 2.5MHZ 不会有异常

点开查看操作步骤图片

点击下图中的 Frequency

接着再点击 Save 即可

找不到下载文件

一般来说生成的下载文件(拓展后缀为.fs)在工程目录下的 impl/pnr 文件夹里面。

点开查看相关图文说明

在上图中可以看到这个下载文件的路径为 /fpga_project1/impl/pnr/fpga_project1.fs

其中 fpga_project1 为工程目录,impl 为 IDE 生成的目录,然后所需要的文件位于 pnr 文件夹内

然后那个拓展名为 .fs 的文件就是下载到 fpga 的固件

烧录结束后没反应

一般这种情况是没有选择正确的烧录文件。可以自己先对应着各个板子点灯文档里所选择的芯片型号来检查一下自己的工程,然后看看自己的代码是否有问题。对于 20K 板卡来说可能是因为 JTAG 复用而导致主控芯片的 JTAG 引脚不再能被调试,点我来查看相应解决办法

IDE 使用相关

查看IP文档

在 IDE 里面的 IP 界面点击想要查看的 IP 文档后点击对应的语言即可跳转到对应的说明

点开查看相关说明

修改设置过的 IP

在 IDE 里面的 IP 界面点击上方器件选型旁边的文件夹后打开已生成 IP 编辑界面

点开查看相关说明

设置 TOP 层

对于含有多个模块的工程,成功例化后,在 IDE -> Hierarchy 页面右键想要设置为顶层的模块,然后选择 Set As Top Module 将它设置为顶层模块了。

set_top_module

如果在 Hierarchy 页面出现下下表左图现象,这表明代码里有逻辑错误,比如 语法错误、例化错误 等等,点击右上角的 RTL Anakysis Error ,就可以在弹出的对话框里看到错误的类型代码以及错误的位置,如下表右图所示。

RTL Analysis Error 错误类型以及详情
top_module_error error_detail

使用 GAO

GAO 是高云半导体在线逻辑分析仪(Gowin Analyzer Oscilloscope)。安装高云 IDE 之后就能在对应的安装相对路径下看到相关文档了

gao

使用高云半导体所提供的最新的教育版的编程器 点我跳转 能够正常使用 GAO(因为 GAO 必须在 IDE 内才能打开,所以你需要自己替换掉安装时候的 Programmer 文件夹,并且确定替换后的路径与之前的相同)。

educational_edition_programmer