第4章开发环境搭建

第4章：开发环境搭建——Keil/Arduino IDE安装、LoRa库导入、串口调试工具配置、逻辑分析仪使用

说实话，做嵌入式开发这么多年，我见过太多人卡在环境搭建这一步。明明代码逻辑没问题，结果编译报错、驱动装不上、串口打不开……折腾半天心态就崩了。这一章，我带你把这些基础工具一次性搞定。

4.1 开发工具选型：Keil还是Arduino IDE？

先说说我的个人习惯。做LoRa智慧路灯项目，我一般会准备两套环境：

Arduino IDE：快速验证原型、调通通信协议。上手快，库多，适合前期开发。
Keil MDK：做正式产品、优化功耗、调试底层驱动。性能好，调试功能强。

你可能会问：「到底用哪个？」我的建议是——两个都装。前期用Arduino IDE快速跑通LoRa收发，后期用Keil做精细化调优。我在项目中遇到过，有些学生只用Arduino，结果产品化时发现内存管理一塌糊涂……嗯，提前准备总没错。

4.2 Keil MDK安装与配置

Keil的安装其实不复杂，但有几个坑要注意。

4.2.1 下载与安装

去ARM官网下载MDK-Arm最新版（目前是5.38或更高）。
双击安装，一路Next。注意安装路径不要有中文。
安装完成后，打开Keil，点击 Pack Installer 安装你用的芯片包。比如STM32L0系列，搜索「STM32L0xx_DFP」并安装。

⚠️ 注意： 我曾经遇到过，Pack版本不匹配导致编译报错。建议安装与芯片型号严格对应的DFP包，不要贪新。

4.2.2 创建第一个LoRa工程

以STM32L071为例，我习惯这样建工程：

1. Project → New uVision Project
2. 选择芯片：STM32L071CBTx
3. 在Manage Run-Time Environment中勾选：
   - CMSIS → CORE
   - Device → Startup
   - Device → HAL Drivers（按需勾选）
4. 添加你的main.c和LoRa驱动文件

说白了，Keil的工程管理就是「芯片包+用户代码」的组合。我第一次用的时候也懵，后来发现只要把启动文件和HAL库加好，剩下的就是写代码了。

4.3 Arduino IDE安装与LoRa库导入

Arduino IDE就友好多了。我经常用它做快速原型验证。

4.3.1 安装Arduino IDE

官网下载Arduino IDE（推荐1.8.x版本，稳定）。
安装后，打开 文件 → 首选项，在「附加开发板管理器网址」中添加：
https://github.com/stm32duino/BoardManagerFiles/raw/main/package_stmicroelectronics_index.json
工具 → 开发板 → 开发板管理器，搜索「STM32」并安装。

4.3.2 导入LoRa库

这里有个小技巧。我推荐用 Sandee 或 RadioHead 库，两者都支持SX1278。

// 方法一：库管理器安装
工具 → 管理库 → 搜索 "LoRa by Sandee" → 安装

// 方法二：手动导入ZIP
项目 → 加载库 → 添加.ZIP库 → 选择你下载的LoRa库压缩包

💡 我的经验： 如果你用的是国产SX1278模块，建议用RadioHead库。它兼容性更好，我在项目中遇到过Sandee库在某些模块上初始化失败的情况。

4.4 串口调试工具配置

串口调试是嵌入式开发的「眼睛」。没有它，你根本不知道LoRa模块在干什么。

4.4.1 推荐工具

工具名称	适用场景	我的评价
SSCOM	基础调试	轻量、稳定，我用了十年
Putty	SSH/串口通用	功能全，但配置稍复杂
Arduino串口监视器	快速验证	集成在IDE里，方便

4.4.2 配置要点

波特率：LoRa模块常用9600或115200。我习惯用115200，速度快，调试信息不卡顿。
数据位：8位，无校验，1位停止位（8N1）。这是最通用的配置。
流控：关闭。LoRa模块一般不需要硬件流控。

  🔧 避坑指南： 我曾经因为USB转串口线质量差，导致数据丢包。后来换了FT232芯片的线，问题解决。别小看这根线，它可能让你排查一整天。

4.5 逻辑分析仪使用

逻辑分析仪是我调试LoRa通信的「杀手锏」。当串口输出乱码、通信不稳定时，用它抓一下波形，问题一目了然。

4.5.1 硬件准备

推荐 Saleae Logic 8 或国产兼容版（24MHz采样率足够）。价格不贵，几十块钱就能买到。

4.5.2 抓取LoRa SPI通信

将逻辑分析仪的通道夹子接到LoRa模块的SPI引脚：SCK、MISO、MOSI、NSS。
打开Saleae软件，设置采样率为16MHz（够用）。
点击「开始采集」，然后让LoRa模块发送一帧数据。
在软件中解析SPI协议，查看寄存器读写是否正确。

// 典型SPI抓取结果分析
// 正常情况：NSS拉低 → SCK产生8个时钟 → MISO/MOSI交换数据 → NSS拉高
// 异常情况：NSS毛刺、SCK频率不对、MISO无响应

💡 小技巧： 我习惯在LoRa初始化代码中加一个GPIO翻转，用来标记关键操作。比如发送前拉高一个引脚，发送后拉低。这样在逻辑分析仪上能清晰看到时序关系。

4.6 环境验证：跑一个LoRa收发Demo

工具都装好了，我们来验证一下。写一个最简单的LoRa发送程序：

#include <SPI.h>
#include <LoRa.h>

void setup() {
  Serial.begin(115200);
  while (!Serial);
  
  if (!LoRa.begin(433E6)) {  // 433MHz频段
    Serial.println("LoRa初始化失败！");
    while (1);
  }
  Serial.println("LoRa初始化成功！");
}

void loop() {
  LoRa.beginPacket();
  LoRa.print("Hello LoRa!");
  LoRa.endPacket();
  Serial.println("发送完成");
  delay(1000);
}

把代码烧录到开发板，打开串口监视器。如果看到「LoRa初始化成功」和「发送完成」，恭喜你，环境搭建成功了！

⚠️ 常见问题：

初始化失败：检查SPI接线，NSS引脚是否与代码一致。
串口乱码：检查波特率是否匹配，或者USB转串口驱动没装好。
逻辑分析仪无波形：检查接地线是否连接，通道是否选对。

好了，环境搭建就到这里。下一章我们开始写LoRa的驱动代码，真正让路灯「说话」。记住，工具只是手段，理解原理才是关键。有问题随时翻回这一章，我踩过的坑，你就不用再踩了。

📚 课程目录