基于ESP32与OpenSky API的极简飞行雷达DIY指南

1. 项目概述：用最少的零件，打造你的私人飞行雷达

如果你手头正好有一块闲置的ESP32开发板，又对头顶上飞过的航班感到好奇，那么这个项目可能就是为你准备的。我们常说的“Flight Radar”，通常指的是那些能实时显示飞机位置、高度、航向等信息的应用或网站。但你是否想过，自己动手，用一块成本不到50元的ESP32芯片，就能搭建一个属于你自己的、最简单的飞行信息显示器？这个项目不涉及复杂的射频接收或解码，而是巧妙地利用了互联网上公开的飞行数据API，让ESP32通过Wi-Fi获取数据，并在一个简单的OLED屏幕上展示出来。整个过程，你只需要ESP32、一块小屏幕和几根杜邦线，就能把天空中的钢铁巨鸟“拉”到你的桌面上。

这个项目的核心价值在于其极简主义。它避开了传统SDR（软件定义无线电）接收ADS-B信号所需的昂贵硬件和复杂的天线调校，转而拥抱了云数据。对于电子爱好者、创客，或者只是想用一个周末下午体验物联网和API调用乐趣的朋友来说，这是一个绝佳的入门实践。你将亲手实现从网络请求、JSON数据解析到图形化显示的全流程，深刻理解现代物联网设备如何与云端服务交互。接下来，我将详细拆解从硬件选型、软件配置到代码编写的每一个步骤，并分享我在调试过程中踩过的坑和总结的技巧。

2. 核心硬件选型与电路连接

2.1 硬件清单与选型理由

要实现这个最简单的飞行雷达，我们需要三样核心硬件：主控板、显示模块和电源。下面是我推荐的清单和背后的考量。

1. ESP32开发板 这是整个项目的大脑。我强烈推荐使用ESP32 DevKit V1或NodeMCU-32S这类基础款。它们价格低廉（约20-30元），内置Wi-Fi和蓝牙，性能对于本项目绰绰有余。为什么不选更便宜的ESP8266？因为后续我们解析JSON数据并驱动显示时，ESP32的双核处理器和更大的内存（通常4MB SPI Flash）会让程序运行得更流畅，避免在数据刷新时卡顿。选购时注意，要确保板载了USB转串口芯片（如CH340、CP2102），方便我们烧录程序。

2. OLED显示模块 显示部分，我推荐使用0.96英寸的I2C接口OLED屏幕（SSD1306驱动）。它的分辨率是128x64像素，足够显示几架飞机的关键信息。选择I2C接口而非SPI接口的原因很简单：接线更少（只需要4根线），编程库成熟，而且对于这种信息刷新率不高的应用，I2C的速度完全足够。这块屏幕价格在10元左右，是性价比之选。

3. 其他材料

• 杜邦线（母对母）若干，用于连接。
• Micro-USB数据线，用于供电和编程。
• 可选：一个面包板，方便接线和测试。

硬件选型的核心思路是“在满足需求的前提下，追求极简和低成本”。我们没有选择TFT彩屏，因为单色OLED在显示文字和简单图形时更清晰、更省电，且驱动简单。整个系统的硬件成本可以控制在40元以内。

2.2 电路连接详解

连接非常简单，遵循I2C的标准接法即可。请对照你的ESP32和OLED屏幕的引脚定义进行连接。

注意：有些OLED模块可能需要连接“RESET”引脚。如果你的屏幕有，可以将其连接到ESP32的某个GPIO（如GPIO 16），并在代码中初始化。但大多数I2C模块的复位是通过I2C命令完成的，不接物理引脚也可以工作，为求简化，我们可以先不接。

连接好后，硬件部分就完成了。你可以通过USB线将ESP32连接到电脑，准备开始软件环境的搭建。确保连接牢固，虚接是后续调试中最常见的问题来源之一。

3. 软件开发环境搭建与核心库配置

3.1 Arduino IDE环境配置

虽然ESP32可以用乐鑫官方的ESP-IDF开发，但对于这个项目，使用Arduino IDE是更快捷的选择，它对新手更友好，库管理也方便。

首先，你需要在电脑上安装Arduino IDE（建议版本1.8.x或更高）。安装完成后，打开IDE，进入“文件”->“首选项”。在“附加开发板管理器网址”中输入以下网址： https://espressif.github.io/arduino-esp32/package_esp32_index.json （如果已有其他网址，用逗号隔开即可）。这个网址告诉IDE去哪里寻找ESP32的支持包。

然后，打开“工具”->“开发板”->“开发板管理器”。在搜索框中输入“esp32”，你会找到由“Espressif Systems”提供的“ESP32”开发板包。点击“安装”。这个过程可能会比较慢，因为需要下载大量的工具链和文件，请保持网络通畅。

安装完成后，在“工具”->“开发板”列表中，就能选择你的ESP32型号了，例如“ESP32 Dev Module”。接下来，在“工具”菜单下，需要配置几个重要参数：

• Upload Speed: 设置为 921600。这个值越高，上传程序速度越快，但有些USB线或芯片可能不稳定，如果上传失败，可以尝试降低到 115200。
• Flash Frequency: 设置为 80MHz。
• Partition Scheme: 选择 Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS)。这为我们存储网页或配置文件留出了空间。
• **Core Debug Level: 设置为 无`，以减少编译输出信息。

环境配置好后，我们还需要安装两个关键的库。

3.2 关键库的安装与说明

通过“项目”->“加载库”->“管理库”，打开库管理器。

1. ArduinoJson库 搜索并安装“ArduinoJson”库，作者是Benoit Blanchon。这个库版本更新很快，建议安装较新的稳定版（如v6.x或v7.x）。本项目我们将使用v6版本。这个库至关重要，因为它负责解析从飞行数据API返回的JSON格式数据。JSON是现代网络API通信的通用语言，没有这个库，我们很难从复杂的文本数据中提取出需要的飞机呼号、经纬度、高度等信息。

2. Adafruit SSD1306 和 GFX 库 搜索并安装“Adafruit SSD1306”库。安装时，库管理器通常会提示你一并安装依赖的“Adafruit GFX Library”，请确认安装。这个库专门用于驱动我们使用的SSD1306 OLED屏幕。Adafruit的库质量很高，提供了丰富的绘图和文字显示