1. 项目概述与环境搭建
大家好,今天我想分享一个完整的AIoT智能环境监测系统实战项目。这个项目基于ESP32-S3开发板和OneNet云平台,能够实时监测环境温湿度数据,并通过手机APP进行远程监控和控制。我自己在实际搭建过程中踩过不少坑,也积累了一些经验,希望通过这篇文章帮助大家快速上手。
ESP32-S3是乐鑫科技推出的一款专为AIoT应用设计的芯片,相比前代产品,它在计算能力、安全性和外设接口方面都有显著提升。我选择的是ESP32-S3-DevKitC-1开发板,这款板子自带Wi-Fi和蓝牙功能,有丰富的GPIO接口,非常适合物联网项目。
开发环境搭建其实很简单。首先需要安装Arduino IDE,然后添加ESP32支持包。具体操作是:打开Arduino IDE,进入"首选项",在"附加开发板管理器网址"中添加https://dl.espressif.com/dl/package_esp32_index.json。然后在"工具"->"开发板"->"开发板管理器"中搜索ESP32并安装。安装完成后,选择"ESP32S3 Dev Module"作为开发板。
对于手机APP开发,我使用HBuilderX进行uni-app开发,这样可以同时生成Android和iOS应用。HBuilderX的安装很简单,从官网下载后直接解压就能使用。需要注意的是,开发过程中可能需要安装一些插件,比如uni-app编译器和调试器,这些在第一次运行时都会有提示,按照指引安装即可。
OneNet云平台的注册和配置也不复杂。首先注册一个账号,然后创建产品。在创建产品时,需要注意选择"物联网"类别和适合的协议类型。这里我们使用MQTT协议进行通信。创建完成后,需要定义物模型,也就是设备的数据模板。比如温度、湿度等数据点,以及控制开关等命令。物模型的标识符要尽量简洁,建议使用英文缩写,比如用"temp"表示温度,"humi"表示湿度。
2. 硬件连接与传感器配置
接下来我们看看硬件连接部分。我使用的是DHT11温湿度传感器,这是一种数字式传感器,精度足够一般环境监测使用。DHT11有三个引脚:VCC、DATA和GND。连接方式很简单:VCC接ESP32-S3的3.3V引脚,GND接GND引脚,DATA接GPIO4引脚。如果你使用的是其他型号的传感器,连接方式也类似,主要是要确认供电电压和信号引脚。
ESP32-S3-DevKitC-1开发板上有多个GPIO引脚,我选择GPIO4是因为这个引脚支持ADC功能,而且位置比较方便布线。在实际连接时,建议使用杜邦线进行连接,最好使用不同颜色的线区分电源、地和信号线,这样在调试时更容易识别。
除了DHT11,我还连接了一个LED灯作为状态指示器。LED的正极通过一个220欧姆的限流电阻接到GPIO38引脚,负极接GND。这个LED可以用来显示设备状态,比如联网成功时闪烁,数据上传时快速闪烁等。
在代码中,我们需要先初始化DHT11传感器。这需要包含DHT库,并在setup函数中进行初始化:
#include <DHT.h>
#define DHTPIN 4
#define DHTTYPE DHT11
DHT dht(DHTPIN, DHTTYPE);
void setup() {
dht.begin();
// 其他初始化代码
}
读取温湿度数据的代码也很简单:
float humidity = dht.readHumidity();
float temperature = dht.readTemperature();
if (isnan(humidity) || isnan(temperature)) {
Serial.println("读取DHT11失败");
return;
}
在实际测试中,我发现DHT11的读取间隔不能太短,至少需要2秒的间隔,否则读取可能会失败。这是因为传感器需要时间进行温湿度转换。
为了确保系统的稳定性,我还添加了看门狗定时器和异常处理机制。看门狗可以在程序卡死时自动重启设备,这对于长时间运行的物联网设备很重要。在Arduino中,可以使用ESP.wdtFeed()来喂狗,或者使用Ticker库定时喂狗。
3. 网络连接与MQTT通信
网络连接是整个系统的核心部分。ESP32-S3支持Wi-Fi连接,我们需要先配置Wi-Fi连接信息:
const char* ssid = "你的Wi-Fi名称";
const char* password = "你的Wi-Fi密码";
void connectWiFi() {
WiFi.begin(ssid, password);
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}
Serial.println("WiFi连接成功");
}
在实际项目中,我建议添加Wi-Fi重连机制。因为网络环境可能会变化,设备需要能够自动重新连接。可以添加一个计数器,在连接失败多次后重启设备。
MQTT通信部分使用PubSubClient库。首先需要配置MQTT服务器地址和端口,OneNet的MQTT服务器地址是"mqtts.heclouds.com",端口是1883。需要注意的是,OneNet使用设备鉴权信息进行连接,而不是简单的用户名密码。
设备鉴权信息的生成稍微复杂一些。需要产品ID、设备名称、设备密钥和时间戳等信息。我通常使用在线的Token生成工具来生成鉴权信息,这样可以避免手动计算的错误。
#include <PubSubClient.h>
WiFiClient espClient;
PubSubClient client(espClient);
void reconnectMQTT() {
while (!client.connected()) {
if (client.connect("设备名称", "产品ID", "鉴权信息")) {
Serial.println("MQTT连接成功");
client.subscribe("控制主题");
} else {
delay(5000);
}
}
}
数据上传使用JSON格式,这样结构清晰且易于解析。我使用ArduinoJson库来构建JSON数据:
#include <ArduinoJson.h>
void publishData(float temp, float humi) {
DynamicJsonDocument doc(1024);
doc["id"] = "123";
doc["version"] = "1.0";
JsonObject params = doc.createNestedObject("params");
params["temp"] = temp;
params["humi"] = humi;
String output;
serializeJson(doc, output);
client.publish("上传主题", output.c_str());
}
在实际使用中,我发现OneNet对数据格式有严格的要求,必须按照平台规定的格式上传,否则数据无法正确解析。所以建议先在平台上创建好物模型,然后按照物模型的格式上传数据。
4. 云平台配置与数据管理
OneNet云平台的配置是整个项目的关键环节。首先需要在平台上创建产品,我建议产品名称和分类选择与实际应用场景相符的选项,这样后期管理会更方便。
物模型的定义需要特别注意。每个数据点都需要定义正确的数据类型和单位。比如温度数据应该选择"float"类型,单位是"摄氏度";湿度数据也是"float"类型,单位是"百分比"。对于控制命令,比如LED开关,应该选择"bool"类型。
在物模型设置中,标识符的命名很重要。我建议使用简洁的英文单词,比如"temp"、"humi"、"led"等。标识符越短,数据传输时占用的字节越少,这在有限的网络带宽下很重要。
设备创建完成后,需要记录设备ID和设备密钥,这些信息在代码中会用到。我建议将这些敏感信息保存在单独的配置文件中,不要硬编码在代码里,特别是如果代码需要公开时。
数据流的管理也很重要。在OneNet平台上,可以查看每个数据点的历史数据,设置数据告警规则等。我设置了一个温度告警,当温度超过30度时发送邮件通知。告警规则可以基于单个数据点,也可以基于多个数据点的组合条件。
API接口的使用可能会遇到一些问题。OneNet提供了丰富的API接口来获取设备数据、发送控制命令等。在使用API时,需要注意认证方式,通常需要在请求头中添加API密钥。我建议先用Postman等工具测试API接口,确认无误后再集成到代码中。
数据存储和查询也是需要考虑的。OneNet平台默认保存一段时间的历史数据,如果需要长期保存,可以考虑使用平台的数据导出功能,或者将数据转发到自己的服务器上。对于简单的项目,平台提供的存储空间通常足够使用。
5. 移动端APP开发与数据可视化
移动端APP使用uni-app框架开发,这样可以一套代码同时生成Android和iOS应用。开发环境使用HBuilderX,这是一个专门为uni-app优化的IDE。
APP的界面设计我采用卡片式布局,每个传感器数据用一个卡片展示。卡片上显示当前数值、单位、安全状态等信息。对于异常数据,我会用红色背景提示,正常数据用绿色背景。
<view class="data-card">
<view class="card-header">
<image src="../../static/temperature.png"></image>
<text>温度</text>
</view>
<view class="card-body">
<text class="value">{{temperature}} ℃</text>
<view class="status" :class="getTempStatus(temperature)">
{{getTempStatusText(temperature)}}
</view>
</view>
</view>
数据获取通过调用OneNet的API实现。需要先在OneNet平台上创建API密钥,然后在APP中调用设备数据查询接口:
uni.request({
url: 'https://api.heclouds.com/devices/设备ID/datapoints',
method: 'GET',
header: {
'api-key': '你的API密钥'
},
success: (res) => {
this.temperature = res.data.data[0].value;
this.humidity = res.data.data[1].value;
}
})
在实际开发中,我发现直接调用API可能会遇到跨域问题。解决方案是在uni-app的manifest.json中配置网络白名单,或者使用云函数代理请求。
控制功能的实现需要发送POST请求到OneNet的控制接口:
uni.request({
url: 'https://api.heclouds.com/devices/设备ID/datapoints',
method: 'POST',
header: {
'api-key': '你的API密钥'
},
data: {
'led': true
},
success: (res) => {
console.log('控制命令发送成功');
}
})
为了提升用户体验,我添加了实时数据刷新功能,每5秒自动更新一次数据。同时添加了手动刷新按钮,方便用户随时更新数据。
历史数据查询功能通过折线图展示。我使用ucharts组件来绘制折线图,可以直观地显示数据变化趋势。点击数据卡片可以跳转到详细的历史数据页面。
goToHistoryPage() {
uni.navigateTo({
url: '/pages/history/temperature'
});
}
APP的打包发布也很简单。在HBuilderX中选择"发行"->"原生App-云打包",选择需要的平台和证书配置即可。如果需要上架应用市场,需要注意准备相应的应用描述和截图。
6. 系统优化与故障排除
在实际部署中,我发现了一些需要优化的地方。首先是功耗优化,ESP32-S3有多种低功耗模式,可以根据实际需求选择合适的模式。如果设备是电池供电,可以使用深度睡眠模式,在数据采集间隔期间进入睡眠状态。
// 深度睡眠示例
esp_sleep_enable_timer_wakeup(300 * 1000000); // 睡眠300秒
esp_deep_sleep_start();
网络稳定性也是一个需要关注的问题。我添加了网络质量检测机制,当网络信号较弱时,降低数据上传频率,避免因网络问题导致的数据丢失。
数据缓存机制也很重要。当网络中断时,设备可以将数据暂时保存在Flash中,待网络恢复后再上传。我使用Preferences库来实现简单的数据存储:
#include <Preferences.h>
Preferences preferences;
void saveData(float temp, float humi) {
preferences.putFloat("temp", temp);
preferences.putFloat("humi", humi);
}
在故障排除方面,我建议添加详细的日志记录功能。可以将系统运行状态、网络连接状态、数据上传状态等信息输出到串口,方便调试。对于量产设备,可以考虑将日志信息上传到服务器进行分析。
OTA升级功能对于远程设备很重要。ESP32-S3支持OTA升级,可以通过网络更新固件,无需物理接触设备。我建议在项目中早期就集成OTA功能,这样后期维护会方便很多。
安全性方面,我使用TLS加密MQTT连接,防止数据被窃听。同时添加了设备身份验证机制,确保只有授权的设备可以连接平台。对于敏感操作,比如设备控制,添加了二次确认机制。
性能监控也是系统优化的重要部分。我定期检查设备的内存使用情况、网络连接质量、数据上传成功率等指标。发现异常时及时进行调整,确保系统稳定运行。
最后是用户体验的优化。我添加了设备状态指示功能,通过LED灯的不同闪烁模式表示不同的设备状态。同时优化了APP的交互流程,使操作更加直观简单。
8095



被折叠的 条评论
为什么被折叠?



