项目简介
本项目是基于ESP IDF和Vue.js构建的物联网空气质量监测与上报系统。借助ESP32设备,结合IKEA的VINDRIKTNING空气传感器,能够实时监测空气质量数据。系统通过MQTT协议将数据发送到指定服务器或客户端,同时支持REST API访问,还提供基于Vue.js的Web界面供用户查看数据。
项目的主要特性和功能
- MQTT客户端:支持通过MQTT协议将空气质量数据发送到远程服务器。
- REST API:提供REST API接口,方便用户通过HTTP请求获取空气质量数据。
- VINDRIKTNING传感器支持:与IKEA的VINDRIKTNING空气传感器无缝集成,实时读取空气质量数据。
- Web界面:提供基于Vue.js的Web界面,用户可通过浏览器查看传感器数据。
- 配置管理:支持通过Web界面配置网络参数、传感器数量和GPIO引脚。
安装使用步骤
1. 环境准备
确保已安装ESP IDF SDK,并配置好环境变量。可参考ESP IDF SDK安装指南进行安装和配置。
2. 下载项目源码
从相应渠道获取本项目的源码文件。
3. 安装前端依赖
进入前端Web应用目录并安装依赖:
bash
cd front/webapp
npm install
4. 构建前端应用
构建Vue应用,生成静态文件:
bash
npm run build
5. 配置和编译
返回项目根目录,配置ESP32应用:
bash
cd ../..
idf.py menuconfig
在配置界面中,设置传感器数量、GPIO引脚等信息。
6. 编译并烧录
编译项目并烧录到ESP32设备:
bash
idf.py build
idf.py -p <your serial device> flash
7. 监控设备
通过以下命令监控设备输出:
bash
idf.py -p <your serial device> monitor
8. 使用Web界面
通过浏览器访问ESP32的IP地址,查看传感器数据。初始访问可能需等待传感器完成首次测量。
9. 访问传感器数据
通过REST API获取传感器数据,具体API示例可在Dust Logger.postman_collection.json
文件中找到。
10. 配置MQTT推送
在MQTT配置部分输入必要信息并启用MQTT客户端,传感器数据将以JSON格式推送到MQTT服务器。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】