# aero-hardware

**Repository Path**: qtghkat/aero-hardware

## Basic Information

- **Project Name**: aero-hardware
- **Description**: 安维轻量化智慧物联设备管理系统(AeroLink Iot) 传感器项目源码
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-08
- **Last Updated**: 2026-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AeroLink IoT 硬件仓库

安维轻量化智慧物联设备管理系统（**AeroLink IoT**）的硬件端。

基于 **DeepSeek Harness** 开发：用一句话描述需求，AI 即可生成完整的 ESP-IDF 传感器工程
（传感器驱动 + WiFi/MQTT + 串口配网 + 断线重连），通过 MQTT 接入 AeroLink IoT 平台。

## 环境要求

| 项 | 值 |
|----|----|
| 开发框架 | ESP-IDF 5.5.3 |
| 开发板 | ESP32-C3（4MB flash） |
| 语言 | C |
| 通信 | WiFi（MQTT） |

## 项目列表

| 目录 | 说明 | 适用场景 | 状态 |
|------|------|----------|------|
| `AeroLinkProvisioning/` | 本地串口配网工具（PC 上位机，Python/PySide6） | 设备部署时下发 WiFi + MQTT 配置 | ✅ 已实现 |
| `01_dht22/` | DHT22 温湿度传感器节点（GPIO3 数据 / GPIO8 RGB） | 室内温湿度监测 | ✅ 已实现 |
| `02_ds18b20/` | DS18B20 单总线温度传感器节点（GPIO3 数据 / GPIO8 RGB，5s 上报） | 液体/土壤/环境测温 | ✅ 已实现 |
| `common/` | 共享工具类 + 分区表 + 协议文档 | 所有节点项目复用 | ✅ 已实现 |
| `NN_xxx/` | （待定） | （待定） | 🚧 规划中 |

> 新增传感器项目：复制 `01_dht22` 改名，按 [`PROJECT_DESIGN_TEMPLATE.md`](PROJECT_DESIGN_TEMPLATE.md)
> 规划、按 [`dev.md`](dev.md) 第六节生成工程。

## 快速开始

```bash
cd 01_dht22
idf.py set-target esp32c3
idf.py build
idf.py -p PORT flash monitor
```

烧录后上电进入配网态，用 `AeroLinkProvisioning/` 上位机下发配置，设备自动重启上线。

## 文档导航

| 文档 | 说明 |
|------|------|
| [`dev.md`](dev.md) | 项目总览 + 开发规范（唯一权威入口，先读它） |
| [`PROJECT_DESIGN_TEMPLATE.md`](PROJECT_DESIGN_TEMPLATE.md) | 新项目规划模板 |
| [`common/MQTT接入说明.md`](common/MQTT接入说明.md) | MQTT 接入协议规范 |
| [`common/配网协议说明.md`](common/配网协议说明.md) | 串口配网协议规范 |

## 开源协议

本项目采用 [MIT License](LICENSE)。