1. 认识GW1NSR-4C开发板与M3硬核GW1NSR-4C是高云半导体推出的一款FPGAMCU异构开发板内置了ARM Cortex-M3硬核处理器。这块板子最大的特点就是既有FPGA的灵活可编程性又有MCU的实时控制能力特别适合需要高速并行处理和复杂控制逻辑的场景。我第一次拿到这块板子时就被它小巧的尺寸和丰富的接口吸引了——QN48封装、27MHz晶振、8个GPIO LED、UART接口基本上把嵌入式开发常用的外设都集成了。在实际项目中我经常用它来做一些需要快速原型验证的工作比如电机控制、传感器数据采集等。相比纯FPGA方案M3硬核的存在让软件开发变得简单很多而对比传统MCUFPGA部分又能处理那些对时序要求苛刻的任务。这种组合拳用好了真的能事半功倍。2. 开发环境搭建避坑指南2.1 IDE版本选择这里有个大坑要特别注意必须使用Gowin IDE 1.9.9及以上版本。我刚开始用1.9.8版本时编译总是莫名其妙失败折腾了半天才发现是版本兼容性问题。后来查官方文档才知道1.9.8下只能用1.1.3版本的IP核而我们要用的M3硬核需要更高版本支持。安装完IDE后建议先跑个简单的LED闪烁例程测试下环境是否正常。我习惯在C:\Gowin\IDE\examples里找个最简单的工程修改下引脚约束文件确保能正常综合和下载。这一步看似简单但能排除很多基础环境问题。2.2 工程目录结构解析官方提供的开发包解压后主要关注这两个路径FPGA部分Gowin_EMPU(GW1NS-4C)_V1.2\solution\running_in_sram_from_emb_userflash\ref_design\FPGA_RefDesignMCU部分Gowin_EMPU(GW1NS-4C)_V1.2\ref_design\MCU_RefDesign\Keil_RefDesign我第一次打开工程时被这复杂的目录结构搞晕了后来发现其实只要关注几个关键文件gowin_pllvr.vPLL配置核心文件gowin_empu_template.v顶层模块文件.cst文件引脚约束文件Keil工程里的main.cMCU主程序3. PLL时钟配置实战3.1 晶振频率适配开发板上的实际晶振是27MHz但官方例程默认配置可能不匹配。我们需要修改gowin_pllvr.v文件中的PLL参数。这里有个重要原则PLL输出频率不要超过80MHz否则MCU很可能无法正常工作。经过多次测试我发现78MHz是个比较稳定的值。具体参数修改如下defparam pllvr_inst.FCLKIN 27; // 输入时钟27MHz defparam pllvr_inst.IDIV_SEL 8; // 输入分频系数 defparam pllvr_inst.FBDIV_SEL 25; // 反馈分频系数 defparam pllvr_inst.ODIV_SEL 8; // 输出分频系数这三个参数决定了最终输出频率计算公式是Fout Fin × (FBDIV_SEL1) / (IDIV_SEL1) / (ODIV_SEL1)。代入我们的参数就是27×(251)/(81)/(81) ≈ 78MHz。3.2 PLL不稳定问题排查在实际调试中我发现即使输出频率设置正确有时候MCU还是无法启动。这个问题困扰了我很久后来发现跟FCLKIN的字符串格式有关。有些情况下需要去掉引号直接写defparam pllvr_inst.FCLKIN 27;。这个坑特别隐蔽建议两种方式都试试。还有个经验不同开发板之间可能存在个体差异。我在三块不同的GW1NSR-4C开发板上测试同样的配置有的能正常工作有的就不行。如果遇到这种情况可以微调下分频系数比如把78MHz降到76MHz试试。4. FPGA顶层模块修改4.1 引脚定义调整打开gowin_empu_template.v文件我们需要根据实际硬件修改顶层模块的接口定义。原设计可能只用了部分LED或者UART引脚不同我们的开发板有8个LED所以需要这样定义module Gowin_EMPU_Template ( input sys_clk, input reset_n, output [7:0] led, // 8位LED input uart0_rxd, // 串口接收 output uart0_txd // 串口发送 );4.2 时钟域处理FPGA和MCU之间的时钟域要特别注意。M3硬核的工作时钟来自PLL输出在顶层模块中需要这样实例化wire mclk; // MCU时钟 Gowin_PLLVR u_Gowin_PLLVR( .clkout(mclk), // 输出78MHz给MCU .clkin(sys_clk) // 输入27MHz晶振 );然后在实例化M3硬核时要把这个时钟传递过去Gowin_EMPU_Top u_Gowin_EMPU_Top ( .sys_clk(mclk), // 使用PLL产生的时钟 .reset_n(reset_n), // 其他信号... );5. 引脚约束文件配置5.1 LED引脚映射开发板的LED连接在特定引脚上我们需要在.cst约束文件中明确定义。以我的板子为例IO_LOC led[7] 34; IO_PORT led[7] IO_TYPELVCMOS25; IO_LOC led[6] 35; IO_PORT led[6] IO_TYPELVCMOS25; IO_LOC led[5] 31; IO_PORT led[5] IO_TYPELVCMOS25; IO_LOC led[4] 32; IO_PORT led[4] IO_TYPELVCMOS25; IO_LOC led[3] 29; IO_PORT led[3] IO_TYPELVCMOS25; IO_LOC led[2] 30; IO_PORT led[2] IO_TYPELVCMOS25; IO_LOC led[1] 27; IO_PORT led[1] IO_TYPELVCMOS25; IO_LOC led[0] 28; IO_PORT led[0] IO_TYPELVCMOS25;注意电压标准要选对这个开发板用的是2.5V逻辑电平(LVCMOS25)。5.2 串口引脚配置串口引脚也需要根据实际硬件连接来配置IO_LOC uart0_rxd 45; IO_PORT uart0_rxd IO_TYPELVCMOS25; IO_LOC uart0_txd 43; IO_PORT uart0_txd IO_TYPELVCMOS25;有些开发板可能把串口接到了其他引脚上一定要查清楚原理图。我曾经因为引脚配错花了半天时间排查为什么串口没反应。6. MCU程序设计6.1 Keil工程设置打开官方提供的Keil工程后有几处需要检查在Options for Target - Target里确认MCU型号是GW1NS4C在Debug选项里选择正确的调试器如果有的话特别注意After Build选项里的路径要改成你自己的Keil安装路径6.2 LED控制实现在main.c中我们需要初始化GPIO并实现LED闪烁逻辑void GPIOInit(void) { GPIO_InitTypeDef GPIO_InitType; GPIO_InitType.GPIO_Pin GPIO_Pin_0|GPIO_Pin_1|GPIO_Pin_2| GPIO_Pin_3|GPIO_Pin_4|GPIO_Pin_5| GPIO_Pin_6|GPIO_Pin_7; GPIO_InitType.GPIO_Mode GPIO_Mode_OUT; GPIO_Init(GPIO0, GPIO_InitType); } while(1) { GPIO_ResetBit(GPIO0, 0xFF); // 所有LED亮 delay_ms(1000); GPIO_SetBit(GPIO0, 0xFF); // 所有LED灭 delay_ms(1000); }6.3 串口通信配置串口的波特率需要根据实际需求设置。我发现14400bps在这个系统上比较稳定void UartInit(void) { UART_InitTypeDef UART_InitStruct; UART_InitStruct.UART_BaudRate 14400; // 波特率 UART_Init(UART0, UART_InitStruct); }如果想用更常见的9600或115200波特率可能需要调整PLL配置确保MCU时钟能被波特率整除。7. 联合调试技巧7.1 下载模式选择下载时需要特别注意模式选择先确保跳线帽设置在MCU模式需要同时下载.fs(FPGA)和.bin(MCU)两个文件下载后可能需要按复位键(23引脚)才能启动7.2 常见问题排查如果LED不亮或者串口没反应可以按照以下步骤排查检查PLL输出频率是否在允许范围内确认引脚约束文件中的引脚号是否正确用示波器测量晶振是否起振检查串口线的TX/RX是否接反我遇到过最诡异的问题是下载后必须长按复位键才能工作后来发现是复位电路设计的问题在程序中加了延时解决。
高云GW1NSR-4C开发板M3硬核实战：从PLL配置到外设驱动的全流程解析
1. 认识GW1NSR-4C开发板与M3硬核GW1NSR-4C是高云半导体推出的一款FPGAMCU异构开发板内置了ARM Cortex-M3硬核处理器。这块板子最大的特点就是既有FPGA的灵活可编程性又有MCU的实时控制能力特别适合需要高速并行处理和复杂控制逻辑的场景。我第一次拿到这块板子时就被它小巧的尺寸和丰富的接口吸引了——QN48封装、27MHz晶振、8个GPIO LED、UART接口基本上把嵌入式开发常用的外设都集成了。在实际项目中我经常用它来做一些需要快速原型验证的工作比如电机控制、传感器数据采集等。相比纯FPGA方案M3硬核的存在让软件开发变得简单很多而对比传统MCUFPGA部分又能处理那些对时序要求苛刻的任务。这种组合拳用好了真的能事半功倍。2. 开发环境搭建避坑指南2.1 IDE版本选择这里有个大坑要特别注意必须使用Gowin IDE 1.9.9及以上版本。我刚开始用1.9.8版本时编译总是莫名其妙失败折腾了半天才发现是版本兼容性问题。后来查官方文档才知道1.9.8下只能用1.1.3版本的IP核而我们要用的M3硬核需要更高版本支持。安装完IDE后建议先跑个简单的LED闪烁例程测试下环境是否正常。我习惯在C:\Gowin\IDE\examples里找个最简单的工程修改下引脚约束文件确保能正常综合和下载。这一步看似简单但能排除很多基础环境问题。2.2 工程目录结构解析官方提供的开发包解压后主要关注这两个路径FPGA部分Gowin_EMPU(GW1NS-4C)_V1.2\solution\running_in_sram_from_emb_userflash\ref_design\FPGA_RefDesignMCU部分Gowin_EMPU(GW1NS-4C)_V1.2\ref_design\MCU_RefDesign\Keil_RefDesign我第一次打开工程时被这复杂的目录结构搞晕了后来发现其实只要关注几个关键文件gowin_pllvr.vPLL配置核心文件gowin_empu_template.v顶层模块文件.cst文件引脚约束文件Keil工程里的main.cMCU主程序3. PLL时钟配置实战3.1 晶振频率适配开发板上的实际晶振是27MHz但官方例程默认配置可能不匹配。我们需要修改gowin_pllvr.v文件中的PLL参数。这里有个重要原则PLL输出频率不要超过80MHz否则MCU很可能无法正常工作。经过多次测试我发现78MHz是个比较稳定的值。具体参数修改如下defparam pllvr_inst.FCLKIN 27; // 输入时钟27MHz defparam pllvr_inst.IDIV_SEL 8; // 输入分频系数 defparam pllvr_inst.FBDIV_SEL 25; // 反馈分频系数 defparam pllvr_inst.ODIV_SEL 8; // 输出分频系数这三个参数决定了最终输出频率计算公式是Fout Fin × (FBDIV_SEL1) / (IDIV_SEL1) / (ODIV_SEL1)。代入我们的参数就是27×(251)/(81)/(81) ≈ 78MHz。3.2 PLL不稳定问题排查在实际调试中我发现即使输出频率设置正确有时候MCU还是无法启动。这个问题困扰了我很久后来发现跟FCLKIN的字符串格式有关。有些情况下需要去掉引号直接写defparam pllvr_inst.FCLKIN 27;。这个坑特别隐蔽建议两种方式都试试。还有个经验不同开发板之间可能存在个体差异。我在三块不同的GW1NSR-4C开发板上测试同样的配置有的能正常工作有的就不行。如果遇到这种情况可以微调下分频系数比如把78MHz降到76MHz试试。4. FPGA顶层模块修改4.1 引脚定义调整打开gowin_empu_template.v文件我们需要根据实际硬件修改顶层模块的接口定义。原设计可能只用了部分LED或者UART引脚不同我们的开发板有8个LED所以需要这样定义module Gowin_EMPU_Template ( input sys_clk, input reset_n, output [7:0] led, // 8位LED input uart0_rxd, // 串口接收 output uart0_txd // 串口发送 );4.2 时钟域处理FPGA和MCU之间的时钟域要特别注意。M3硬核的工作时钟来自PLL输出在顶层模块中需要这样实例化wire mclk; // MCU时钟 Gowin_PLLVR u_Gowin_PLLVR( .clkout(mclk), // 输出78MHz给MCU .clkin(sys_clk) // 输入27MHz晶振 );然后在实例化M3硬核时要把这个时钟传递过去Gowin_EMPU_Top u_Gowin_EMPU_Top ( .sys_clk(mclk), // 使用PLL产生的时钟 .reset_n(reset_n), // 其他信号... );5. 引脚约束文件配置5.1 LED引脚映射开发板的LED连接在特定引脚上我们需要在.cst约束文件中明确定义。以我的板子为例IO_LOC led[7] 34; IO_PORT led[7] IO_TYPELVCMOS25; IO_LOC led[6] 35; IO_PORT led[6] IO_TYPELVCMOS25; IO_LOC led[5] 31; IO_PORT led[5] IO_TYPELVCMOS25; IO_LOC led[4] 32; IO_PORT led[4] IO_TYPELVCMOS25; IO_LOC led[3] 29; IO_PORT led[3] IO_TYPELVCMOS25; IO_LOC led[2] 30; IO_PORT led[2] IO_TYPELVCMOS25; IO_LOC led[1] 27; IO_PORT led[1] IO_TYPELVCMOS25; IO_LOC led[0] 28; IO_PORT led[0] IO_TYPELVCMOS25;注意电压标准要选对这个开发板用的是2.5V逻辑电平(LVCMOS25)。5.2 串口引脚配置串口引脚也需要根据实际硬件连接来配置IO_LOC uart0_rxd 45; IO_PORT uart0_rxd IO_TYPELVCMOS25; IO_LOC uart0_txd 43; IO_PORT uart0_txd IO_TYPELVCMOS25;有些开发板可能把串口接到了其他引脚上一定要查清楚原理图。我曾经因为引脚配错花了半天时间排查为什么串口没反应。6. MCU程序设计6.1 Keil工程设置打开官方提供的Keil工程后有几处需要检查在Options for Target - Target里确认MCU型号是GW1NS4C在Debug选项里选择正确的调试器如果有的话特别注意After Build选项里的路径要改成你自己的Keil安装路径6.2 LED控制实现在main.c中我们需要初始化GPIO并实现LED闪烁逻辑void GPIOInit(void) { GPIO_InitTypeDef GPIO_InitType; GPIO_InitType.GPIO_Pin GPIO_Pin_0|GPIO_Pin_1|GPIO_Pin_2| GPIO_Pin_3|GPIO_Pin_4|GPIO_Pin_5| GPIO_Pin_6|GPIO_Pin_7; GPIO_InitType.GPIO_Mode GPIO_Mode_OUT; GPIO_Init(GPIO0, GPIO_InitType); } while(1) { GPIO_ResetBit(GPIO0, 0xFF); // 所有LED亮 delay_ms(1000); GPIO_SetBit(GPIO0, 0xFF); // 所有LED灭 delay_ms(1000); }6.3 串口通信配置串口的波特率需要根据实际需求设置。我发现14400bps在这个系统上比较稳定void UartInit(void) { UART_InitTypeDef UART_InitStruct; UART_InitStruct.UART_BaudRate 14400; // 波特率 UART_Init(UART0, UART_InitStruct); }如果想用更常见的9600或115200波特率可能需要调整PLL配置确保MCU时钟能被波特率整除。7. 联合调试技巧7.1 下载模式选择下载时需要特别注意模式选择先确保跳线帽设置在MCU模式需要同时下载.fs(FPGA)和.bin(MCU)两个文件下载后可能需要按复位键(23引脚)才能启动7.2 常见问题排查如果LED不亮或者串口没反应可以按照以下步骤排查检查PLL输出频率是否在允许范围内确认引脚约束文件中的引脚号是否正确用示波器测量晶振是否起振检查串口线的TX/RX是否接反我遇到过最诡异的问题是下载后必须长按复位键才能工作后来发现是复位电路设计的问题在程序中加了延时解决。
