1. 项目概述当微控制器遇上云端如果你玩过Arduino或者CircuitPython肯定遇到过这样的场景想给温湿度传感器加个联网功能实时把数据传到手机上看看结果光是让ESP8266连上Wi-Fi就折腾了半天更别提还要处理SSL加密、MQTT协议这些让人头大的事情。代码越写越复杂主控芯片那点内存和算力很快就捉襟见肘了。这正是我几年前做智能花盆项目时踩过的坑。当时我用一块ATSAMD21做主控想通过ESP8266把土壤湿度数据发到云端。调试网络连接和协议解析占用了绝大部分开发时间项目本身的逻辑反而被挤到了角落。后来我发现了AirLift这个“外挂”方案搭配Adafruit IO这个对创客极其友好的云平台整个开发体验才有了质的飞跃。简单来说AirLift帮你扛下了所有联网的“脏活累活”而Adafruit IO则提供了一个即拿即用的数据后台让你能专注于项目本身的功能逻辑。这个组合的核心价值在于“解耦”和“简化”。传统的物联网开发中网络栈Wi-Fi连接、TCP/IP协议、TLS加密和应用程序逻辑读取传感器、控制执行器都挤在同一个微控制器里相互争夺资源。AirLift基于ESP32它本身就是一个功能强大的Wi-Fi蓝牙芯片在这里被用作专门的网络协处理器。你的主控芯片比如一块简单的ATmega328P只需要通过高速SPI接口向它发送简单的指令比如“连接这个Wi-Fi”、“把这段数据发到这个网址”剩下的网络握手、数据包重组、证书验证等复杂操作全部由AirLift内部的ESP32独立完成。这就像你开车时用手机导航你只需要告诉手机目的地具体的路线规划、实时路况计算都由手机处理你专心开车就行。Adafruit IO则是为这类硬件项目量身定做的云端“收件箱”和“控制面板”。你不需要自己租服务器、搭数据库、写API接口。在Adafruit IO上创建一个Feed数据流它就会自动生成一个专属的MQTT主题和HTTP API端点。你的设备只管往这个端点发送数据比如温度值Adafruit IO就会帮你存储、记录并可以实时显示在网页仪表盘上。你还可以设置触发器和动作比如“当温度超过30度时给我发一封邮件”或者“在仪表盘上显示一个开关点击后向设备发送一个‘1’”。对于原型开发和小型项目来说这极大地降低了云端开发的门槛。2. 硬件选型与架构解析2.1 AirLift的两种形态外置模块与一体板AirLift主要有两种存在形式选择哪种取决于你的项目基础和需求。第一种是外置协处理器模块比如 Adafruit AirLift – ESP32 WiFi协处理器分线板 。这是一个独立的小板子上面集成了ESP32芯片、陶瓷天线、必要的滤波电路和电平转换芯片。你通过排针将它和你现有的主控板比如Arduino Uno、Metro 328P、甚至树莓派Pico连接起来。连接通常需要4根SPI线SCK, MOSI, MISO, CS、2根控制线BUSY, RESET以及电源和地线。这种方式的灵活性最高你可以把它嫁接到几乎任何有SPI接口的微控制器项目上让老项目瞬间获得联网能力。我经常用它来给一些基于ATmega328的旧设备做智能化升级。第二种是内置AirLift的一体化开发板。Adafruit将ESP32协处理器直接做到了主控板上例如 Metro M4 Express AirLift 和 PyPortal 。以PyPortal为例它在一块板子上集成了ATSAMD51主控性能强劲、ESP32协处理器、3.5英寸触摸屏和多个传感器。这种板子开箱即用所有引脚定义和软件库都已预先配置好你完全不用操心硬件连接问题上手速度极快特别适合快速构建功能相对复杂的交互式物联网设备比如信息显示屏、智能相框。注意选择外置模块时务必确认你的主控板有足够的GPIO引脚和SPI接口。同时需要注意电平匹配AirLift模块是3.3V逻辑如果你的主控是5V如Arduino Uno需要连接逻辑电平转换器或者确保你的主控板SPI接口在3.3V下也能正常工作很多现代板子可以。2.2 为什么是ESP32做协处理器你可能会有疑问为什么选ESP32而不是其他芯片这背后有几个关键的工程考量。首先性能与功能的平衡。ESP32是一颗双核240MHz的芯片内置Wi-Fi和蓝牙其网络协议栈和处理能力远超常见的8位或32位通用微控制器。让它专职处理网络属于“专业的人做专业的事”。主控芯片可以是更便宜、功耗更低的型号专注于项目特定的I/O控制和业务逻辑。其次TLS/SSL加密的硬件卸载。现代物联网通信加密是必须的。ESP32内置了硬件加密加速器能够高效地处理HTTPSMQTT over TLS连接所需的加密解密运算。如果让一个没有硬件加密功能的普通微控制器来做软件加密会消耗大量CPU时间和内存导致程序响应变慢甚至崩溃。AirLift的固件中已经预烧录了根证书可以直接建立安全的TLS连接这对主控芯片来说是透明的你无需在主控代码中引入任何SSL库。最后成熟的软件生态。AirLift运行的固件是基于Arduino的WiFiNINA核心的变体这是一个经过广泛测试和验证的Wi-Fi驱动库。Adafruit为其编写了针对CircuitPython和Arduino的专用适配库adafruit_esp32spi封装了所有底层细节。你只需要调用类似esp.connect_AP(ssid, password)和esp.post(url, data)这样的高级函数复杂性被完全隐藏。2.3 Adafruit IO创客的云端瑞士军刀Adafruit IO不是一个通用的云服务如AWS IoT它精准定位于教育、创客和原型开发。它的设计哲学是“开箱即用”和“可视化优先”。核心概念是Feed数据流。你可以把Feed理解为一个带时间戳的数据通道。创建一个名为“living_room_temperature”的Feed它就拥有了一个唯一的密钥Key。你的设备通过HTTP或MQTT协议向这个Feed发送一个数值如25.6Adafruit IO会自动记录这个数值和接收时间。所有历史数据都可以通过图表查看你也可以设置数据保留策略。Dashboard仪表盘是它的另一大亮点。通过拖拽组件图表、开关、滑块、文本框、地图等你可以快速将多个Feed的数据可视化并组合成一个完整的控制界面。例如一个仪表盘可以同时显示温度曲线、湿度曲线并包含一个控制LED灯开关的按钮。这个仪表盘可以通过网页链接分享给任何人无需他们登录。触发器和动作Triggers Actions提供了简单的自动化能力。你可以设置规则例如“当‘door_sensor’ Feed的值变为1门打开时向‘telegram_bot’ Feed发送一条消息‘门被打开了’”。这相当于一个简易的IFTTT能实现设备与设备、设备与通知服务之间的联动。对于免费账户Adafruit IO有速率和存储限制例如每Feed每分钟最多30次数据点最多存储30天数据但对于绝大多数学习和原型项目来说已经完全足够。它的价值在于让你在5分钟内就拥有一个功能完整的物联网后端从而把全部精力聚焦在硬件和嵌入式代码本身。3. 软件环境与核心配置3.1 CircuitPython vs Arduino如何选择这是两个主要的开发环境选择哪一个主要取决于你的硬件和个人偏好。CircuitPython是Adafruit主导的基于Python的嵌入式编程语言。它的最大优势是极简的开发流程和交互式编程。你只需将开发板通过USB连接到电脑它会显示为一个名为CIRCUITPY的U盘。把你的Python代码文件code.py和库文件直接拖进去代码就会自动运行。修改代码后直接保存文件板子会自动软重启并运行新代码无需编译和上传。这对于调试和快速迭代来说体验无敌。AirLift在CircuitPython下有非常完善的库支持adafruit_esp32spi,adafruit_io代码写起来就像在电脑上用requests库访问网页一样直观。Arduino则是更传统、生态更庞大的C/C开发环境。它的性能通常更好对内存和时间的控制更精细适合对实时性要求高或资源极其紧张的项目。使用Arduino开发AirLift项目你需要安装多个库WiFiNINA, Adafruit IO Arduino, Adafruit MQTT等并通过Arduino IDE进行编译和上传。代码结构更底层一些但灵活性也更高。我的建议是如果你是物联网新手或者追求最快的开发验证速度强烈推荐从CircuitPython开始。它的学习曲线平缓错误信息更友好能让你迅速看到成果建立信心。当你需要更优的性能或更复杂的多任务处理时再考虑迁移到Arduino。3.2 密钥管理革命从secrets.py到settings.toml在物联网项目中安全地管理Wi-Fi密码和API密钥是头等大事。你肯定不想把ssid my_home_wifi和password 12345678这样的敏感信息硬编码在公开分享的代码里。CircuitPython早期使用secrets.py文件来解决这个问题。从CircuitPython 8开始官方推荐使用更强大的settings.toml文件。这是一个纯文本的配置文件采用TOML格式存储在CIRCUITPY盘的根目录。你的主程序code.py通过os.getenv()函数来读取其中的配置项。创建一个settings.toml文件内容如下CIRCUITPY_WIFI_SSID 你的Wi-Fi名称 CIRCUITPY_WIFI_PASSWORD 你的Wi-Fi密码 ADAFRUIT_AIO_USERNAME 你的Adafruit IO用户名 ADAFRUIT_AIO_KEY 你的Adafruit IO Active Key为什么用settings.toml而不用secrets.py标准化TOML是一种更通用、结构更清晰的配置文件格式很多现代工具都支持。灵活性除了网络密钥未来还可以用于配置其他板级设置。工具链支持一些高级的编辑器和工具可以更好地识别和语法高亮TOML文件。在代码中你这样读取配置完全看不到明文密码from os import getenv ssid getenv(CIRCUITPY_WIFI_SSID) password getenv(CIRCUITPY_WIFI_PASSWORD) # 如果读取失败getenv会返回None便于你做错误处理 if not ssid or not password: raise ValueError(请在settings.toml中配置Wi-Fi信息)重要实操心得settings.toml文件必须使用纯文本编辑器如VS Code, Mu, Sublime Text创建和编辑。千万不要用Windows自带的记事本因为它可能会在文件开头添加一个不可见的BOM字符导致CircuitPython无法正确解析文件。一个简单的检查方法是在CircuitPython的REPL中执行import os; print(os.listdir(/))确认能看到settings.toml文件并且文件大小正确。3.3 库文件安装避免“找不到模块”的坑无论是CircuitPython还是Arduino正确安装库文件是成功的第一步。这里以CircuitPython为例详细说明流程。首先访问 CircuitPython库合集页面 。这个页面提供了所有官方库的打包下载。关键的一步是根据你板子上运行的CircuitPython版本选择对应的库包。你可以在板子的REPL中执行import os; os.uname()来查看版本。通常选择最新稳定版的库包即可。下载的是一个.zip文件解压后你会看到一个巨大的lib文件夹。你不需要把整个lib文件夹复制过去。只需要将你的项目所需的几个库文件或文件夹复制到你的CIRCUITPY盘里的lib文件夹下即可。对于基础的AirLift Adafruit IO项目你通常需要以下库adafruit_io/(文件夹)adafruit_esp32spi/(文件夹)adafruit_bus_device/(文件夹)adafruit_requests.mpy(文件)如果你的板子有NeoPixel灯可能还需要neopixel.mpy复制时的注意事项确保CIRCUITPY盘上的lib文件夹存在如果不存在就自己创建一个。直接将adafruit_io整个文件夹拖入lib文件夹而不是只复制里面的文件。.mpy文件是预编译的MicroPython字节码文件体积更小加载更快请直接复制。复制完成后安全弹出U盘或者按一下板子的复位键让新库生效。一个常见的错误是库版本不匹配。如果你在代码中导入库时遇到ImportError或者运行时出现奇怪的AttributeError首先检查库文件是否完整复制其次考虑去库的GitHub页面下载最新版本替换。4. CircuitPython实战从连接到收发数据4.1 硬件连接与引脚定义如果你使用的是外置AirLift模块与主控板的连接是第一步。以常见的ESP32 AirLift Breakout为例连接方式如下表所示AirLift模块引脚功能说明连接至主控板示例备注VIN电源输入 (3.3V-5V)3.3V接3.3V稳压输出确保电流充足GND地线GNDSCKSPI时钟SCK(例如board.SCK)MOSISPI主出从入MOSI(例如board.MOSI)MISOSPI主入从出MISO(例如board.MISO)CS片选 (Chip Select)任意数字IO (例如board.D9)低电平有效用于选择该SPI设备BUSY忙线 (Ready/Busy)任意数字IO (例如board.D10)高电平表示ESP32忙不可发送指令RESET复位任意数字IO (例如board.D5)低电平复位ESP32注意CS、BUSY、RESET这三个引脚可以连接到主控板的任何空闲数字引脚上但必须在代码中正确声明。SCK、MOSI、MISO通常需要连接到主控板硬件SPI接口的固定引脚上。如果你使用的是AirLift一体板如PyPortal, Metro M4 AirLift那么恭喜你所有连接在板子内部已经完成引脚名称也是预定义好的。在代码中你会使用像board.ESP_CS、board.ESP_BUSY、board.ESP_RESET这样的常量无需自己定义。4.2 代码逐行解析与网络连接让我们深入分析一段完整的CircuitPython代码理解每一行在做什么。以下代码实现了连接Wi-Fi、连接Adafruit IO、创建/获取一个Feed、发送和接收数据。# SPDX-FileCopyrightText: 2021 ladyada for Adafruit Industries # SPDX-License-Identifier: MIT # 导入必要的模块 from os import getenv from random import randint import board import busio from digitalio import DigitalInOut import adafruit_connection_manager from adafruit_esp32spi import adafruit_esp32spi import adafruit_requests from adafruit_io.adafruit_io import IO_HTTP, AdafruitIO_RequestError # 1. 从settings.toml读取敏感信息 ssid getenv(CIRCUITPY_WIFI_SSID) password getenv(CIRCUITPY_WIFI_PASSWORD) aio_username getenv(ADAFRUIT_AIO_USERNAME) aio_key getenv(ADAFRUIT_AIO_KEY) # 2. 配置ESP32 SPI控制引脚以一体板为例 esp32_cs DigitalInOut(board.ESP_CS) esp32_ready DigitalInOut(board.ESP_BUSY) esp32_reset DigitalInOut(board.ESP_RESET) # 如果是外置模块需要注释掉上面三行使用下面三行并修改引脚号 # esp32_cs DigitalInOut(board.D9) # esp32_ready DigitalInOut(board.D10) # esp32_reset DigitalInOut(board.D5) # 3. 初始化SPI总线和控制对象 spi busio.SPI(board.SCK, board.MOSI, board.MISO) esp adafruit_esp32spi.ESP_SPIcontrol(spi, esp32_cs, esp32_ready, esp32_reset) # 4. 连接Wi-Fi网络 print(Connecting to AP...) while not esp.is_connected: try: esp.connect_AP(ssid, password) except RuntimeError as e: print(could not connect to AP, retrying: , e) continue print(Connected to, str(esp.ssid, utf-8), \tRSSI:, esp.rssi) # 5. 创建网络会话和SSL上下文 pool adafruit_connection_manager.get_radio_socketpool(esp) ssl_context adafruit_connection_manager.get_radio_ssl_context(esp) requests adafruit_requests.Session(pool, ssl_context) # 6. 初始化Adafruit IO HTTP API对象 io IO_HTTP(aio_username, aio_key, requests) # 7. 获取或创建Feed try: # 尝试获取名为“temperature”的Feed temperature_feed io.get_feed(temperature) except AdafruitIO_RequestError: # 如果Feed不存在首次运行则创建它 temperature_feed io.create_new_feed(temperature) # 8. 发送数据到Feed random_value randint(0, 50) print(Sending {0} to temperature feed....format(random_value)) io.send_data(temperature_feed[key], random_value) print(Data sent!) # 9. 从Feed接收最新数据 print(Retrieving data from temperature feed...) received_data io.receive_data(temperature_feed[key]) print(Data from temperature feed: , received_data[value])关键点解析第5步的adafruit_connection_manager这是一个重要的新模块CircuitPython 8它统一管理网络连接和SSL上下文替代了旧版本中直接使用adafruit_esp32spi.adafruit_esp32spi_socket的方式代码更简洁资源管理更好。第7步的异常处理io.get_feed(“feed_name”)会尝试获取一个已存在的Feed。如果这个Feed是第一次使用在Adafruit IO上不存在API会返回404错误在库中被包装为AdafruitIO_RequestError异常。我们捕获这个异常然后调用io.create_new_feed()来创建它。这是一种非常实用的“获取或创建”模式。Feed的Key创建或获取Feed后返回的feed对象是一个字典其中feed[“key”]是这个Feed在Adafruit IO系统中的唯一标识符一个长字符串在发送和接收数据时需要用到。将这段代码保存为CIRCUITPY盘上的code.py板子会自动运行。打开串口监视器如Mu编辑器你应该能看到连接Wi-Fi、发送和接收数据的全过程输出。4.3 串口输出分析与故障排查成功运行后串口输出应该类似这样Connecting to AP... Connected to MyHomeWiFi RSSI: -45 Sending 23 to temperature feed... Data sent! Retrieving data from temperature feed... Data from temperature feed: 23如果遇到问题以下是常见的错误和排查步骤AttributeErrorwhen initializing ESP_SPIcontrol:现象在初始化esp对象时程序崩溃报错AttributeError。原因代码中使用的引脚如board.ESP_CS在你的板上不存在。这常见于使用外置模块但代码仍用了一体板的引脚定义。解决切换到代码中注释掉的外置模块引脚定义部分board.D9,board.D10,board.D5并根据你的实际接线修改引脚编号。RuntimeError: Failed to connect to AP:现象一直打印重连信息无法连接Wi-Fi。排查检查settings.toml中的SSID和PASSWORD是否正确注意大小写和特殊字符。检查Wi-Fi信号强度RSSI。在连接前可以尝试添加print(“Scanning for AP…”)和for ap in esp.scan_networks(): print(“\t%s\tRSSI: %d” % (str(ap[‘ssid’], ‘utf-8’), ap[‘rssi’]))来扫描网络确认能看到你的Wi-Fi且信号良好RSSI -70。检查AirLift模块的天线是否连接好如果是外接天线。AdafruitIO_RequestError: Error with request:现象在io.get_feed或io.send_data时出错。排查首先确认Wi-Fi连接成功打印出了RSSI值。检查settings.toml中的ADAFRUIT_AIO_USERNAME和ADAFRUIT_AIO_KEY是否正确。AIO_KEY是Active Key不是密码。访问Adafruit IO网站登录后查看右上角“View AIO Key”确认用户名和密钥无误。检查网络是否能正常访问io.adafruit.com。有些公共网络可能有防火墙限制。代码运行一次后停止:现象数据发送接收一次后程序就结束了板子上的LED也不闪了。原因CircuitPython的code.py脚本默认只运行一次。执行到末尾就停止了。解决如果你想让它循环执行比如每10秒发送一次数据需要将主要逻辑放在一个while True:循环中并在末尾加上time.sleep(10)。5. Arduino环境下的配置与使用5.1 库安装的“坑”与正确姿势对于Arduino用户使用AirLift需要安装多个库且版本有要求。这一步比CircuitPython繁琐容易出错。必须安装的四个库及其版本Adafruit WiFiNINA这是AirLift固件通信的核心驱动。必须从Adafruit的GitHub仓库下载ZIP安装不能使用Arduino库管理器里的通用WiFiNINA库。因为Adafruit版本包含了针对AirLift的特定补丁和优化。下载地址 Adafruit WiFiNINA Library 。在Arduino IDE中通过项目-加载库-添加.ZIP库…来安装。ArduinoHttpClient(版本 0.4.0)用于处理HTTP请求。可以从库管理器搜索安装。Adafruit MQTT Library(版本 1.0.0)Adafruit IO的底层通信库之一。从库管理器安装。Adafruit IO Arduino(版本 3.1.0)Adafruit IO的主库。从库管理器安装。安装后的关键检查 安装完Adafruit IO Arduino库后打开文件-示例-Adafruit IO Arduino你应该能看到一系列示例草图。找到adafruitio_00_publish并打开。在这个示例的config.h选项卡中必须找到并取消注释删除行首的//这一行// uncomment the following line if you are using airlift #define USE_AIRLIFT如果找不到这行说明你的Adafruit IO Arduino库版本太旧请通过库管理器更新到最新版。这个宏定义至关重要它告诉库使用AirLift的SPI通信方式而不是默认的板载Wi-Fi如ESP8266/ESP32原生模式。5.2 配置文件的填写与引脚重定义Arduino示例使用config.h文件来集中管理配置。你需要填写以下信息/******************************* WIFI **************************************/ #define WIFI_SSID 你的Wi-Fi名称 #define WIFI_PASS 你的Wi-Fi密码 /******************************* Adafruit IO *******************************/ #define IO_USERNAME 你的Adafruit IO用户名 #define IO_KEY 你的Adafruit IO Active Key”对于外置AirLift模块你还需要在config.h中找到引脚定义部分进行修改。通常位于文件靠后的位置看起来像这样#if defined(USE_AIRLIFT) #define ESP32_CS PIN_SPI_SS // 默认可能使用SPI SS引脚 #define ESP32_READY D10 // 需要根据你的接线修改 #define ESP32_RESET D5 // 需要根据你的接线修改 #endif你需要将ESP32_READY和ESP32_RESET修改为你实际连接使用的引脚编号例如9,10等。ESP32_CS通常连接到主控板的SPI片选引脚如Arduino Uno的10脚如果使用了默认的PIN_SPI_SS通常不需要改动。对于AirLift一体板库通常已经根据板子型号做了预定义你一般不需要修改引脚配置。编译上传示例代码后打开串口监视器波特率通常为115200你应该能看到连接Wi-Fi、连接Adafruit IO并开始发送计数器的日志。5.3 Arduino示例代码运行与调试成功上传adafruitio_00_publish后串口监视器输出是主要的调试信息源。正常输出Connecting to Adafruit IO... Adafruit IO connected. Sending feed value: 1 Sending feed value: 2 Sending feed value: 3 ...常见问题排查编译错误fatal error: AdafruitIO_WiFi.h: No such file or directory:原因USE_AIRLIFT宏没有正确定义导致编译器试图包含错误的头文件。解决确认config.h中#define USE_AIRLIFT一行已取消注释且前面没有//。连接失败Failed to connect to Adafruit IO:排查检查config.h中的Wi-Fi和AIO密钥信息。检查串口输出的Wi-Fi连接状态。是否先成功连接到了Wi-Fi如果没有检查SSID/密码和信号强度。检查外置模块的硬件连接特别是CS,READY,RESET三根线是否接错或接触不良。数据发送成功但Adafruit IO上看不到:排查登录Adafruit IO进入Feeds页面查看是否多了一个名为counter或其他示例中指定的名称的Feed。进入Dashboards-Monitor页面这是实时数据流监视器。确保示例代码运行时这个页面是打开的你应该能看到数据点流入。检查Feed的名称是否匹配。示例代码发送到counterfeed请确认你在IO上查看的也是counter。6. 数据可视化与项目进阶6.1 在Adafruit IO上验证与监控数据代码运行成功只是第一步在Adafruit IO的Web界面上看到数据流动才是项目闭环的关键。登录与查看Feed登录 io.adafruit.com 点击左侧导航栏的Feeds。你应该能看到一个以你设备发送数据时命名的Feed例如temperature或counter。点击它你会进入Feed详情页这里以图表形式展示了数据的历史记录下方是数据点的列表。使用Monitor页面进行实时调试这是我最常用的调试工具。点击左侧导航栏的Dashboards然后选择Monitor。这个页面会显示一个实时滚动的日志包含所有Feed收到的数据以及任何错误信息。当你的设备发送数据时这里会立即显示出来是验证通信是否成功的最直接方式。创建可视化仪表盘DashboardFeed是数据管道Dashboard才是展示窗口。点击Dashboards-New Dashboard创建一个新仪表盘。点击蓝绿色的“”号可以添加各种组件图表Line Chart/Bar Chart将你的温度Feed拖进去就能自动生成一个实时更新的曲线图。仪表Gauge可以显示当前数值并设置颜色区间如低温蓝色、高温红色。开关Toggle可以创建一个按钮点击后向一个Feed发送1或0。你的设备可以订阅这个Feed从而接收控制指令。文本框Text显示静态说明或最新的数据值。地图Map如果你的数据包含经纬度可以显示在地图上。你可以自由拖拽排列这些组件创建一个完整的监控面板。这个面板的链接可以分享给任何人他们无需登录即可查看。6.2 从示例到实际项目连接传感器与执行器掌握了基本的数据收发后我们就可以替换掉示例中的随机数连接真实的传感器了。案例制作一个联网温湿度计硬件准备AirLift一体板如PyPortal或Metro M4 AirLift、DHT22温湿度传感器。硬件连接将DHT22的VCC接3.3VGND接GND数据线接板子的一个GPIO脚例如board.D4。安装传感器库在CircuitPython的lib文件夹中添加adafruit_dht.mpy库。修改代码在之前的code.py基础上增加传感器读取逻辑。import adafruit_dht import time ... # 初始化DHT传感器 dht_device adafruit_dht.DHT22(board.D4) ... while True: try: # 读取温湿度 temperature_c dht_device.temperature humidity dht_device.humidity if temperature_c is not None and humidity is not None: print(“Temp: {:.1f} C, Humidity: {}%”.format(temperature_c, humidity)) # 发送温度到IO io.send_data(temperature_feed[“key”], temperature_c) # 也可以创建并发送到湿度Feed # io.send_data(humidity_feed[“key”], humidity) else: print(“Failed to read from DHT sensor”) except RuntimeError as e: # DHT传感器偶尔会读取出错这是正常的 print(“DHT reading error:”, e) # 每30秒发送一次数据避免超过Adafruit IO免费账户的速率限制 time.sleep(30)进阶通过云端控制硬件我们不仅可以上传数据还可以让Adafruit IO下发指令。例如通过Dashboard上的开关控制板载LED。在Adafruit IO上创建Feed创建一个名为led_switch的Feed。修改设备端代码CircuitPython示例# 初始化LED import digitalio led digitalio.DigitalInOut(board.LED) led.direction digitalio.Direction.OUTPUT # 获取LED控制Feed try: led_feed io.get_feed(“led_switch”) except AdafruitIO_RequestError: led_feed io.create_new_feed(“led_switch”) # 在循环中接收该Feed的最新数据 while True: # ... 其他逻辑如读取传感器 ... # 检查LED开关状态 led_data io.receive_data(led_feed[“key”]) if led_data[“value”] “1”: # 假设开关发送“1”表示开 led.value True else: led.value False time.sleep(5) # 每5秒检查一次控制指令在Dashboard上添加开关在Dashboard编辑界面添加一个Toggle组件将其绑定到led_switch这个Feed。当你点击网页上的开关时设备端的LED就会随之亮灭。6.3 性能优化与注意事项在实际项目中为了稳定运行还需要注意以下几点速率限制与数据节流Adafruit IO免费账户对数据上传速率有限制。核心原则是不要频繁发送数据。对于温湿度这类变化慢的数据每30秒或每分钟发送一次足矣。可以使用time.sleep()或定时器来实现。发送前也可以判断数值变化是否超过阈值避免发送无意义的数据。错误处理与重试机制网络是不稳定的。你的代码必须有健壮的错误处理。while True: try: # 尝试发送数据 io.send_data(feed_key, value) except (RuntimeError, OSError) as e: print(“Send failed:”, e) # 等待一段时间后重试避免快速重试循环 time.sleep(10) # 甚至可以尝试重新连接Wi-Fi if not esp.is_connected: reconnect_wifi() time.sleep(interval)低功耗考虑如果是电池供电项目需要优化功耗。AirLift ESP32在连接Wi-Fi并保持活动状态时功耗在几十到一百多毫安。对于长期监测项目可以采取“采集-连接-发送-深度睡眠”的循环模式。使用主控的深度睡眠功能定时唤醒唤醒后给AirLift上电连接网络发送数据然后再次进入深度睡眠。这能极大延长电池寿命。Feed命名与管理建议使用清晰、有结构的Feed名称如office_temperature、greenhouse_soil_moisture。你可以在Adafruit IO上对Feed进行分组Groups方便管理多个设备或多个数据流。我个人在多个农场环境监测项目中使用了AirLiftAdafruit IO的组合。最大的体会是它把物联网开发中最繁琐、最不稳定的网络部分变成了一个可靠的“黑盒”。作为开发者我终于可以从网络协议的泥潭中抽身把更多时间花在传感器校准、电源管理和外壳设计这些真正创造价值的事情上。当你第一次在手机上看到自己制作的设备从千里之外传回实时数据时那种成就感是驱动你进行下一个项目的最大动力。这个技术栈对于创客、教育者和产品原型开发者来说无疑是一把打开物联网大门的金钥匙。