基于PyPortal与CircuitPython的物联网飓风追踪器开发实战

1. 项目概述：一个桌面级的实时风暴监视器

每年夏天，大西洋上总会酝酿着一些“不速之客”。它们从非洲西海岸生成，一路向西，有时悄无声息地消散，有时却会积蓄能量，演变成令人敬畏的飓风。对于生活在沿岸地区的人们来说，及时掌握这些风暴的动态，是防灾准备中至关重要的一环。传统的追踪方式依赖于手机App或网页，信息虽然全面，但总感觉隔了一层。有没有可能让这些数据“活”在你的桌面上，以一种更直观、更物理的方式呈现？

这正是我这次动手项目的初衷：利用一块Adafruit PyPortal开发板，打造一个能独立运行、实时显示大西洋风暴动态的桌面追踪器。它不依赖电脑或手机，通电联网后，就能自动从美国国家飓风中心（NOAA）获取最新的风暴数据，并在3.2英寸的触摸屏上，清晰地标出风暴的位置、名称和移动方向。这不仅仅是一个技术Demo，更是一个将物联网（IoT）概念落地的绝佳案例——把云端的数据流，转化为触手可及的物理信息显示。

PyPortal是一款非常有趣的开发板，它集成了ESP32 Wi-Fi模块、彩色显示屏、触摸功能，甚至还有扬声器和多个传感器，开箱即用性极高。而CircuitPython，作为MicroPython的一个分支，极大地降低了嵌入式开发的门槛。你不需要复杂的交叉编译环境，只需像操作U盘一样，把Python代码文件拖到开发板上，它就能运行。这个项目完美结合了这两者的优势：用PyPortal作为硬件载体，用CircuitPython快速实现网络通信、数据解析和图形显示的逻辑。

接下来，我将带你从零开始，完整复现这个“飓风追踪器”。我会详细拆解每一个步骤，不仅告诉你怎么做，更会解释为什么这么做，并分享我在搭建过程中踩过的坑和总结的经验。无论你是刚接触硬件编程的新手，还是想寻找一个有趣物联网项目的老手，相信都能从中获得启发。

2. 核心硬件与软件栈解析

在动手写代码之前，我们必须先理解手中的“武器”。这个项目的成功，很大程度上依赖于选对了合适的硬件和软件工具链。它们各自承担着不可替代的角色，共同构成了一个高效、易用的开发环境。

2.1 硬件核心：Adafruit PyPortal

PyPortal可以看作是一个为物联网显示应用量身定做的“瑞士军刀”。我们之所以选择它，而非自己用ESP32开发板搭配屏幕来组装，主要是出于效率和完整性的考虑。

核心组件与功能：

• ESP32 Wi-Fi协处理器：这是设备连接互联网的“网关”。它通过SPI接口与主控芯片通信，负责所有的网络连接、HTTP请求等任务，让我们的主程序可以专注于业务逻辑，而不必深陷于复杂的网络协议栈中。
• 主控芯片（通常是ATSAMD51或类似）：负责运行我们的CircuitPython程序，处理数据，驱动显示屏和外围设备。它与ESP32分工明确，一个管计算和显示，一个管联网。
• 3.2英寸IPS触摸显示屏（320x240分辨率）：显示地图和风暴信息的关键。其分辨率和色彩表现足以清晰展示细节。
• 内置传感器与外围设备：如温度传感器、光线传感器、扬声器、MicroSD卡槽等。在这个项目中，我们主要用到的是板载NeoPixel LED（用作状态指示灯）和SD卡槽（可选，用于存储更多资源）。

注意：PyPortal有多个版本（如PyPortal、PyPortal Titano、PyPortal Pynt），它们屏幕尺寸和部分外围可能略有不同。本项目的代码和资源主要针对标准版（320x240）设计。如果你使用其他版本，可能需要调整地图图片的尺寸或代码中的显示参数。

为什么是PyPortal？自己组装一个类似功能的设备并非不可能，但你需要自行解决显示屏驱动、触摸屏校准、ESP32与主控的稳定通信、电源管理等一系列问题。PyPortal将这些全部集成并优化好了，提供了统一的adafruit_pyportal库，让我们可以用几行代码就完成网络请求、图片显示和文本渲染，极大地降低了开发难度和调试时间。

2.2 软件基石：CircuitPython与关键库

CircuitPython是让这一切变得简单的魔法。它是由Adafruit主导开发的一个开源Python解释器，专为微控制器设计。

CircuitPython的核心优势：

1. 无需编译，即时迭代：开发板在电脑上会显示为一个名为CIRCUITPY的U盘。你直接用任何文本编辑器修改code.py文件并保存，板子会自动重新运行新代码。这种“编辑-保存-运行”的循环，比传统的“编译-烧录-调试”流程快得多，特别适合快速原型开发。
2. 丰富的硬件抽象库：Adafruit为几乎所有自家产品以及常见传感器、执行器编写了高质量的CircuitPython库。这些库提供了高级API，让你用board.SCL、board.NEOPIXEL这样的抽象名称来访问硬件引脚，无需关心底层寄存器操作。
3. 内置REPL（交互式解释器）：通过串口连接，你可以像在电脑上使用Python Shell一样，实时执行命令、查看变量、调试程序，这对于排查问题无比方便。

本项目依赖的关键库：根据项目资料，我们需要在PyPortal的CIRCUITPY驱动器的lib文件夹中放置以下库文件。你可以从Adafruit CircuitPython Bundle中一次性获取全部，也可以按需单独下载。

• adafruit_esp32spi：与板载ESP32 Wi-Fi模块通信的底层驱动库。
• adafruit_requests：一个类似于Python标准库requests的HTTP客户端库，用于从NOAA服务器获取JSON数据。它是本项目数据获取的桥梁。
• adafruit_connection_manager：被adafruit_requests用来管理网络连接和SSL上下文。
• adafruit_pyportal：核心库！它封装了显示、网络、触摸等复杂操作，提供了PyPortal()这样一个高级对象，让我们能用简洁的代码完成复杂任务。
• adafruit_portalbase：adafruit_pyportal库的基础库。
• adafruit_imageload：用于加载和显示图片文件（如我们的地图和风暴图标）。
• adafruit_display_text与adafruit_bitmap_font：用于在屏幕上绘制文本标签。前者处理文本对象，后者处理字体文件。
• adafruit_display_shapes：用于绘制基本的图形，如线条（我们用它来画风暴的移动方向箭头）。
• simpleio：一个包含常用简单函数的库，我们主要用到其中的map_range函数，用于将经纬度坐标映射到屏幕像素坐标。
• neopixel：用于控制板载的RGB NeoPixel状态灯。

库的安装方式：推荐初学者直接下载完整的Adafruit CircuitPython Library Bundle，解压后将其中的lib文件夹整个复制到CIRCUITPY驱动器的根目录。这样能确保所有依赖库都在。虽然这会占用一些存储空间（约几MB），但避免了因缺少某个依赖库而导致的难以排查的导入错误。对于存储空间紧张的项目，再考虑按需单独复制。

3. 环境搭建与基础配置实战

拿到PyPortal后，第一步不是急着写代码，而是为其搭建好运行环境。这个过程就像给新电脑安装操作系统和驱动，是后续所有工作的基础。

3.1 刷写CircuitPython固件

PyPortal出厂可能运行其他固件。我们需要将其刷写成CircuitPython环境。

详细步骤与原理：

1. 下载固件：访问 CircuitPython官网 ，找到对应PyPortal型号的最新.uf2固件文件并下载。.uf2是UF2格式的固件文件，这是一种由微软开发的、专为USB大容量存储设备刷机设计的文件格式，其特点是无需专用刷机工具，拖拽即可。
2. 进入引导加载模式：
   • 用一条可靠的数据线（务必确认是数据线而非仅充电线）将PyPortal连接到电脑。
   • 快速双击板子正面的Reset按钮。此时，板载的NeoPixel LED应变为绿色（如果变红，通常意味着USB连接有问题）。
   • 电脑上会出现一个名为PORTALBOOT（或类似）的U盘驱动器。这个驱动器是板子内置的引导加载程序（bootloader）暴露出来的，专门用于接收新的固件。
3. 拖拽刷机：将下载好的.uf2文件直接拖入PORTALBOOT驱动器。拖入后，PORTALBOOT驱动器会消失，稍等片刻，电脑上会出现一个新的名为CIRCUITPY的驱动器。这个过程就是引导加载程序将UF2文件写入微控制器内部Flash，然后启动CircuitPython系统。
4. 验证：打开CIRCUITPY驱动器，你应该能看到一个boot_out.txt文件。用文本编辑器打开它，里面会显示当前运行的CircuitPython版本信息。至此，固件刷写完成。

实操心得：双击Reset键的节奏需要练习一下，有时太快或太慢都无法成功。如果第一次没出现PORTALBOOT盘，多试几次。确保USB线插在电脑主板后置接口（供电更稳定），并避开USB集线器。

3.2 配置Wi-Fi连接：settings.toml文件

CircuitPython 8及以上版本推荐使用settings.toml文件来管理敏感信息，如Wi-Fi密码和API密钥。这比将密码硬编码在code.py中要安全得多，也便于分享代码。

创建settings.toml文件：

1. 在CIRCUITPY驱动器的根目录下，新建一个纯文本文件。
2. 将其命名为settings.toml（注意扩展名）。
3. 用文本编辑器（如VS Code、Notepad++，甚至系统自带的记事本）打开，输入以下内容：

# PyPortal Hurricane Tracker 配置文件 CIRCUITPY_WIFI_SSID = "你的Wi-Fi网络名称" CIRCUITPY_WIFI_PASSWORD = "你的Wi-Fi密码"

关键解析与避坑指南：

• 格式必须严格：settings.toml是TOML格式。键值对用等号连接，字符串必须用双引号括起来。等号两边可以有空格。#号用于注释。
• 变量名是固定的：CIRCUITPY_WIFI_SSID和CIRCUITPY_WIFI_PASSWORD是CircuitPython网络库识别的特定环境变量名，不能随意更改。
• 文件位置：必须放在CIRCUITPY的根目录，不能放在任何子文件夹里。
• 编码问题：如果Wi-Fi密码或SSID包含中文或特殊字符，请确保文本编辑器以UTF-8无BOM格式保存此文件。否则，CircuitPython可能无法正确读取。
• 在代码中调用：在你的code.py中，通过os.getenv()函数来获取这些值：

  import os ssid = os.getenv("CIRCUITPY_WIFI_SSID") password = os.getenv("CIRCUITPY_WIFI_PASSWORD")

  这种方式将密码与代码逻辑完全分离。

3.3 网络连接测试与WiFiManager

在编写复杂的飓风追踪逻辑前，我们必须先确保PyPortal能稳定地连接到互联网。Adafruit提供了一个基础的测试脚本，但我强烈推荐使用更健壮的WiFiManager。

基础连接测试：你可以运行资料中提供的code.py测试脚本。它会扫描网络、连接你配置的Wi-Fi，并尝试访问一个测试URL来获取文本和JSON数据。如果串口终端（可以使用Mu Editor、PuTTY或VS Code的串口监视器）能打印出网络信息和获取到的网页内容，说明网络层配置成功。

为什么推荐WiFiManager？基础的connect_AP在理想网络环境下没问题，但现实中的Wi-Fi可能不稳定。WiFiManager类（位于adafruit_esp32spi.adafruit_esp32spi_wifimanager）提供了以下增强功能：

• 自动重连：当网络断开时，它会自动尝试重新连接。
• 连接状态指示：可以绑定一个NeoPixel LED，用不同颜色（如蓝色连接中、绿色已连接、红色错误）直观显示网络状态。
• 简化的请求接口：它封装了requests对象，提供了get()、post()等方法，内部处理了连接检查和错误重试。

使用WiFiManager的代码片段示例：

import board from adafruit_esp32spi import adafruit_esp32spi from adafruit_esp32spi.adafruit_esp32spi_wifimanager import WiFiManager import neopixel from os import getenv # 获取Wi-Fi配置 ssid = getenv("CIRCUITPY_WIFI_SSID") password = getenv("CIRCUITPY_WIFI_PASSWORD") # 初始化ESP32 SPI（根据你的板子型号选择正确的引脚） esp32_cs = DigitalInOut(board.ESP_CS) esp32_ready = DigitalInOut(board.ESP_BUSY) esp32_reset = DigitalInOut(board.ESP_RESET) spi = busio.SPI(board.SCK, board.MOSI, board.MISO) esp = adafruit_esp32spi.ESP_SPIcontrol(spi, esp32_cs, esp32_ready, esp32_reset) # 使用板载NeoPixel作为状态灯 status_pixel = neopixel.NeoPixel(board.NEOPIXEL, 1, brightness=0.2) # 创建WiFiManager实例 wifi = WiFiManager(esp, ssid, password, status_pixel=status_pixel) # 现在可以使用wifi.get(url)来发起请求，它会自动管理连接 try: response = wifi.get("https://httpbin.org/get") print(response.json()) except Exception as e: print("Request failed:", e)

在飓风追踪器项目中，虽然原始代码使用了pyportal.network.fetch()（其底层可能也做了类似管理），但理解WiFiManager对于构建其他需要稳定网络连接的IoT项目非常有帮助。

4. 飓风追踪器核心代码深度剖析

环境配置妥当后，我们进入最核心的部分——解读和编写飓风追踪器的代码。这段代码巧妙地融合了网络数据获取、坐标转换、图形显示等多个模块。

4.1 数据源：NOAA的JSON接口

项目的“大脑”是数据。我们使用的是美国国家飓风中心（NOAA）提供的公开JSON数据接口：https://www.nhc.noaa.gov/CurrentStorms.json。

数据结构解析：用浏览器打开这个链接，你会看到类似下面的JSON结构（数据是动态的，以下为示例）：

{ "activeStorms": [ { "name": "HURRICANE_FIONA", "classification": "HU", "latitude": "25.1N", "longitude": "70.5W", "latitudeNumeric": 25.1, "longitudeNumeric": -70.5, "movementDir": 285, "lastUpdate": "2023-09-20T15:00:00.000Z", ... }, { "name": "TROPICAL_STORM_GASTON", "classification": "TS", ... } ] }

• activeStorms：一个数组，包含当前所有活跃风暴的信息。
• 每个风暴对象中，我们最关心的字段是：
  • name：风暴名称。
  • classification：风暴等级。"TD"（热带低压），"TS"（热带风暴），"HU"（飓风）。这决定了我们显示哪个图标。
  • latitudeNumeric/longitudeNumeric：用数字表示的经纬度（北纬和西经为负值）。这是计算屏幕坐标的直接输入。
  • movementDir：移动方向，以度为单位（0度为正北，顺时针增加）。用于绘制方向箭头。
  • lastUpdate：数据最后更新时间。

注意事项：这个接口返回的是全球数据。我们的代码通过LAT_RANGE和LON_RANGE定义了只显示大西洋特定区域（例如北纬5°到45°，西经40°到100°）的风暴。如果你想追踪其他海域的风暴，需要调整这两个参数，并更换对应的地图背景图片。

4.2 核心代码模块拆解

让我们深入到主程序code.py中，看看各个部分是如何协同工作的。

4.2.1 初始化与配置

# --| User Config |--------------------------------------------------- UPDATE_RATE = 60 # 数据更新间隔（分钟） MAX_STORMS = 3 # 最大显示风暴数 NAME_COLOR = 0xFFFFFF # 标签文字颜色（白色） NAME_BG_COLOR = 0x000000 # 标签背景颜色（黑色） ARROW_COLOR = 0x0000FF # 方向箭头颜色（蓝色） ARROW_LENGTH = 15 # 箭头长度（像素） LAT_RANGE = (45, 5) # 地图显示的纬度范围（北纬45度到5度） LON_RANGE = (-100, -40) # 地图显示的经度范围（西经100度到40度） # --------------------------------------------------------------------

这部分是用户可配置项。UPDATE_RATE控制从NOAA获取数据的频率，设为60分钟是合理的，既不会对服务器造成压力，也能及时反映风暴动向。LAT_RANGE和LON_RANGE定义了地图的经纬度边界，必须与map.bmp图片所覆盖的地理范围严格对应。

4.2.2 PyPortal对象与显示组初始化

pyportal = PyPortal( status_neopixel=board.NEOPIXEL, default_bg="/map.bmp", )

这是整个项目的“控制中心”。PyPortal类初始化时，我们指定了状态灯（NEOPIXEL）和默认背景图片（map.bmp）。它会自动帮我们完成显示初始化、网络初始化等繁琐工作。

displayio是CircuitPython的显示框架，它使用“组”（Group）的概念来管理屏幕上的元素。我们将风暴图标、标签、箭头等每个风暴的图形元素放在一个storm_gfx组里，再把所有风暴组放入一个顶层的storm_icons组，最后将这个组添加到pyportal.root_group。这种层级管理使得批量更新和清除风暴显示变得非常高效。

4.2.3 经纬度到屏幕坐标的映射：墨卡托投影

这是项目的数学核心。地球是球体，屏幕是平面，如何把弯曲的经纬线映射到平面的像素坐标？

代码中使用了一种简化版的墨卡托投影公式来处理纬度（y坐标）：

y = math.radians(lat) y = math.tan(math.pi / 4 + y / 2) y = math.log(y) y = (VIRTUAL_WIDTH * y) / (2 * math.pi) y = VIRTUAL_HEIGHT / 2 - y y = int(y - Y_OFFSET)

• math.radians(lat)：将纬度从角度转换为弧度。
• math.tan(math.pi / 4 + y / 2)和math.log(y)：这是墨卡托投影的正向变换公式，将球面坐标映射到圆柱面再展开为平面。
• VIRTUAL_WIDTH和VIRTUAL_HEIGHT：是根据地图经纬度范围和屏幕像素尺寸计算出的“虚拟”世界尺寸，用于比例缩放。
• Y_OFFSET：是一个预计算的偏移量，确保地图在屏幕上的垂直位置正确。

经度（x坐标）的处理则简单得多，因为是等距的，直接使用线性映射：

x = int(map_range(lon, LON_RANGE[0], LON_RANGE[1], 0, board.DISPLAY.width - 1))

simpleio.map_range函数将lon从[LON_RANGE[0], LON_RANGE[1]]区间，线性映射到[0, 屏幕宽度-1]的像素区间。

4.2.4 风暴图标的显示与更新逻辑

1. 清除旧图标：每次更新前，while len(storm_icons): _ = storm_icons.pop()会清空storm_icons组中的所有子组。
2. 获取并解析数据：pyportal.network.fetch(URL)获取JSON数据，pyportal.network.process_json解析出activeStorms数组。
3. 遍历风暴并绘制：
   • 坐标转换：对每个风暴，用上述公式计算屏幕坐标(x, y)。
   • 图标选择：根据classification字段（TD, TS, HU），从storm_icons.bmp雪碧图（sprite sheet）中选择对应的图标（TileGrid）。雪碧图是一张包含所有小图的大图，通过索引来选取。
   • 创建标签：使用adafruit_display_text.Label在图标旁显示风暴名称。
   • 绘制箭头：根据movementDir（角度），用adafruit_display_shapes.Line从风暴中心点画一条指定长度和方向的线段作为箭头。
   • 打包成组：将图标、标签、箭头放入一个storm_gfx组，然后将该组添加到storm_icons组中。
4. 定时更新：主循环中，通过比较time.monotonic()的差值，每隔UPDATE_RATE分钟调用一次update_display()函数。

4.3 资源文件准备

代码需要两个关键的图片资源文件：

1. map.bmp：背景地图。必须是一张与LAT_RANGE和LON_RANGE精确匹配的大西洋区域地图，保存为BMP格式，尺寸为320x240像素。你可以使用资料中提供的链接下载，也可以自己用GIS软件制作。
2. storm_icons.bmp：风暴图标雪碧图。它应该是一个包含多个16x16像素图标的横向排列图片。通常顺序是：热带低压(TD)、热带风暴(TS)、飓风(HU)。代码通过索引storm_type来选取。需要确保图标背景色（通常是黄色0xFFFF00）被设置为透明（icons_pal.make_transparent(i)），这样图标才能完美叠加在地图上。

将这两个.bmp文件直接放在CIRCUITPY驱动器的根目录。

5. 项目部署、调试与优化经验

将代码和资源文件都准备好后，就可以进行最后的部署和测试了。这个过程可能会遇到一些问题，以下是详细的部署步骤和常见问题的排查方法。

5.1 完整部署清单

在将CIRCUITPY驱动器弹出并给PyPortal独立供电前，请确保驱动器根目录下有以下文件和文件夹结构：

CIRCUITPY/ ├── code.py # 主程序文件 ├── settings.toml # Wi-Fi配置文件（务必填写正确的SSID和密码） ├── map.bmp # 背景地图文件 ├── storm_icons.bmp # 风暴图标雪碧图文件 └── lib/ # 库文件夹 ├── adafruit_esp32spi/ ├── adafruit_requests/ ├── adafruit_pyportal/ ├── adafruit_display_text/ ├── adafruit_display_shapes/ ├── adafruit_imageload/ ├── simpleio.mpy └── ... (其他依赖库)

操作顺序建议：

1. 确保PyPortal通过USB连接到电脑，并显示CIRCUITPY驱动器。
2. 将完整的lib库文件夹复制进去。
3. 将map.bmp和storm_icons.bmp复制进去。
4. 创建并编辑好settings.toml文件。
5. 最后，将编写好的code.py复制进去。CircuitPython会在文件复制完成后自动重新运行程序。

5.2 常见问题与排查技巧实录

即使按照步骤操作，也可能会遇到问题。以下是我在多次搭建和教学中遇到的典型问题及解决方法。

问题1：屏幕一片空白或卡在启动画面。

• 可能原因A：库文件缺失或版本不匹配。
  • 排查：检查串口输出（使用Mu Editor或screen/putty连接串口，波特率通常为115200）。如果看到ImportError: no module named 'adafruit_xxx'之类的错误，就是库问题。
  • 解决：从最新的Adafruit CircuitPython Bundle中重新复制完整的lib文件夹。确保库的版本与你的CircuitPython固件版本大致兼容（通常Bundle页面会注明支持的CPy版本）。
• 可能原因B：settings.toml文件配置错误或位置不对。
  • 排查：串口输出可能显示连接Wi-Fi失败或超时。
  • 解决：确认settings.toml在根目录，变量名拼写正确，SSID和密码无误，且文件以UTF-8无BOM格式保存。可以尝试在代码开头加入print(os.getenv(“CIRCUITPY_WIFI_SSID”))来验证是否成功读取。
• 可能原因C：图片文件格式或路径错误。
  • 排查：代码中加载图片的路径是“/map.bmp”，表示根目录。如果图片损坏或不是BMP格式，可能导致显示初始化失败。
  • 解决：确认图片文件是未压缩的BMP格式。可以尝试用简单的图片查看器打开，再另存为标准的BMP文件。确保文件名和代码中引用的完全一致（包括大小写）。

问题2：能连接Wi-Fi，但获取不到风暴数据。

• 可能原因A：网络请求被阻止或URL失效。
  • 排查：在update_display()函数的try块内，在fetch之前添加print(“Fetching URL:”, URL)，之后添加print(“Response status:”, resp.status_code)。通过串口观察输出。
  • 解决：如果状态码不是200，可能是NOAA服务器暂时问题，或者你的网络无法访问该域名（某些地区可能需要特殊网络设置）。可以尝试在电脑浏览器中直接打开https://www.nhc.noaa.gov/CurrentStorms.json测试连通性。
• 可能原因B：JSON数据结构变化。
  • 排查：NOAA的API可能会更新。打印出resp.json()的原始内容，检查activeStorms这个键是否还存在，以及内部字段名是否改变（如latitudeNumeric）。
  • 解决：根据新的JSON结构，调整代码中解析数据的路径（JSON_PATH变量）和字段名。

问题3：风暴图标显示位置严重偏移或根本不在屏幕上。

• 可能原因：LAT_RANGE/LON_RANGE与map.bmp不匹配。
  • 这是最常见的问题之一。地图图片所覆盖的地理范围必须与代码中定义的经纬度范围严格对应。如果地图是从其他来源获取或自己裁剪的，你需要知道它的四个角对应的经纬度。
  • 解决：假设你的地图左上角是(北纬45°, 西经100°)，右下角是(北纬5°, 西经40°)，那么LAT_RANGE = (45, 5)，LON_RANGE = (-100, -40)。注意纬度是从大到小（上北下南），经度是从小到大（左西右东，西经为负值）。你可以通过注释掉图标绘制，只打印计算出的(x, y)坐标，并与你预期的位置对比来调试。

问题4：程序运行一段时间后死机或重启。

• 可能原因A：内存泄漏。在update_display()函数中，如果旧的显示对象没有被正确释放，多次更新后会耗尽内存。
  • 排查：原始代码使用while len(storm_icons): _ = storm_icons.pop()来清空组，这通常是正确的。确保在创建新对象（如Label, Line）时，旧对象已被移除且没有在其他地方被引用。
  • 解决：CircuitPython的displayio框架要求手动管理显示对象的生命周期。确保每次更新时，旧的TileGrid、Label、Line对象都被从其父组中移除。
• 可能原因B：Wi-Fi连接不稳定导致网络请求阻塞。
  • 解决：考虑使用之前提到的WiFiManager来增强网络稳定性。或者，在pyportal.network.fetch()周围添加更完善的异常处理和超时机制。

5.3 性能优化与功能扩展思路

基础项目运行稳定后，你可以考虑以下优化和扩展：

1. 降低功耗：如果使用电池供电，可以设置更长的UPDATE_RATE（如180分钟）。在两次更新的间隔，可以考虑让ESP32进入深度睡眠，或者降低屏幕亮度（如果PyPortal型号支持背光控制）。
2. 增加交互性：利用PyPortal的触摸屏。例如，点击某个风暴图标，在屏幕一侧显示更详细的信息（如风速、气压、预测路径）。
3. 本地化与美化：
   • 更换地图：制作更高清或不同风格（如深色模式）的地图背景。
   • 自定义图标：设计更美观的风暴图标雪碧图。
   • 显示更多信息：在屏幕底部添加一个信息栏，滚动显示所有风暴的摘要，或显示最后更新时间。
4. 数据持久化与历史：如果插入了MicroSD卡，可以将每次获取的数据连同时间戳保存到文件中，用于简单回顾或分析。
5. 多区域支持：修改代码，使其能够通过配置切换显示大西洋、东太平洋等不同海域的风暴数据，并自动加载对应的地图。

这个飓风追踪器项目是一个非常好的起点，它清晰地展示了如何将一个物联网想法，从数据源、网络通信、数据处理到图形化展示完整地实现出来。当你看到第一个风暴图标出现在自己制作的地图上时，那种将虚拟数据与现实设备连接起来的成就感，正是硬件编程的魅力所在。希望这份详细的指南能帮助你顺利搭建属于自己的天气监测站。如果在实践中遇到任何新问题，不妨多看看串口输出的错误信息，那往往是解决问题的关键线索。