3. 开发环境搭建：安装Lattice Diamond或Radiant软件，配置License，创建第一个空白工程，熟悉IDE界面布局

好，咱们开始动手了。这一章我带你走一遍开发环境的搭建流程。说实话，很多初学者卡在这一步，不是因为技术难，而是因为软件安装和License配置确实有点绕。我当年第一次装Diamond的时候，光License就折腾了半个下午。

ECP5开发板支持两款官方IDE：Lattice Diamond（经典款）和 Lattice Radiant（新秀）。怎么选？我个人习惯是：如果你刚入门，直接用Radiant，它界面更现代，操作更直观。但如果你之后要维护老项目，Diamond还是得装。

3.1 软件下载与安装

先去Lattice官网下载安装包。注意，这两个软件都挺大的——Diamond大概2GB，Radiant稍微小一点，但也接近1.5GB。下载前确认你的网络够稳。

安装过程其实没什么特别的，一路Next就行。但有几点我要提醒你：

• 安装路径不要有中文。这是老生常谈了，但我见过太多人栽在这上面。
• 建议关闭杀毒软件。安装过程中有些动态库会被误杀，导致编译时报莫名其妙的错。
• 选择完整安装。别图省空间只装核心组件，后面你会发现缺这缺那。

3.2 License配置——最容易踩坑的地方

软件装好了，打开，弹出一个License窗口。嗯，这里就是很多人卡住的地方。

Lattice的License分两种：免费评估版和付费正式版。对于学习用途，免费版完全够用。你只需要去官网注册一个账号，申请一个免费的Node-Locked License，绑定你电脑的MAC地址就行。

具体步骤：

1. 打开Lattice官网，注册账号并登录。
2. 进入License申请页面，选择“Free Diamond/Radiant License”。
3. 输入你的电脑MAC地址（在命令行里输入 ipconfig /all 就能看到）。
4. 提交后，邮箱会收到一个 .lic 文件。
5. 把这个文件放到一个固定路径，比如 C:\Lattice\license\。
6. 设置环境变量 LM_LICENSE_FILE 指向这个文件路径。

配置完成后，重启软件。如果看到欢迎界面没有License报错，恭喜你，这一步过了。

3.3 创建第一个空白工程

好，环境搭好了，咱们来建个工程试试手。以Radiant为例（Diamond操作类似）：

1. 点击 File → New → Project。
2. 输入工程名，比如 my_first_project。注意，工程名也别用中文。
3. 选择工程路径。我建议每个工程单独一个文件夹，方便管理。
4. 选择器件型号。ECP5系列有很多型号，你得根据手头的开发板来选。比如常见的 LFE5U-25F-6BG256C。
5. 点击Finish，工程就创建好了。

你会看到一个空白的工程界面。别慌，咱们先加一个源文件：

• 右键点击 Input Files → Add → New File。
• 选择 Verilog HDL File，文件名写 top。
• 点击OK，编辑器里就会出现一个空的 .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 <= 1'b0;
        else
            led <= ~led;
    end

endmodule

这段代码就是一个简单的LED闪烁器。保存后，点击工具栏上的 Synthesize 按钮，开始综合。如果一切顺利，你会看到控制台输出一堆信息，最后显示 “Synthesis completed successfully”。

3.4 熟悉IDE界面布局

现在咱们来认认Radiant的界面。说白了，就几个核心区域：

区域	名称	作用
左侧	Project Explorer	显示工程文件结构，源文件、约束文件、IP核都在这里
中间	编辑器区域	写代码的地方，支持多标签页
下方	Console / Log	显示编译、综合、布局布线的输出信息
右侧	Tasks / Reports	一键执行综合、布局布线、生成比特流等操作

你想想看，这个布局其实和大多数IDE差不多。如果你用过Vivado或Quartus，上手会很快。如果你完全没用过，也别担心——你只需要记住三个按钮：Synthesize（综合）、Place & Route（布局布线）、Generate Bitstream（生成比特流）。这三个按钮从左到右，就是FPGA开发的完整流程。

嗯，这里要注意一点：Tasks面板里的操作顺序是固定的。你不能跳过综合直接布局布线，系统会报错。我刚开始学的时候犯过这个错，点了半天没反应，还以为软件坏了。

3.5 本章知识体系

下面这张图帮你梳理了本章的核心逻辑：

这张图把整个流程串起来了。你跟着走一遍，基本上就不会漏掉什么。

3.6 一些心里话

说实话，搭建开发环境这件事，看起来简单，但做起来确实容易让人烦躁。尤其是License配置那一步，我当年折腾了整整一个下午，最后发现是MAC地址填错了。所以如果你卡住了，别急，大概率是某个小细节没注意到。

另外，我建议你把这个空白工程保存好，以后每次新建项目都可以拿它当模板。省得每次都要重新配一遍。

好了，环境搭好了，下一章咱们就开始真正写代码了。到时候我会带你写一个完整的流水灯程序，把综合、布局布线、下载到板子上的全流程走一遍。

---