首页 / 快速开始

🎯 快速开始

10分钟完成设备配置，开始您的AIOT之旅

📦
步骤1
准备工作
→
🔌
步骤2
设备上电
→
📝
步骤3
注册设备
→
📱
步骤4
配网连接
→
📊
步骤5
查看数据
→
🎮
步骤6
控制端口
→
✅
完成
开始使用

📦 步骤1：准备工作

硬件清单

物品 数量 说明 必需
ESP32-S3设备 1 主控设备，带LCD屏幕 ✅ 必需
USB-C数据线 1 供电及烧录 ✅ 必需
电源适配器 1 5V 1A规格 ✅ 必需
传感器/舵机等 若干 根据需求选配 ⭕ 可选

软件/网络准备

  • WiFi网络：2.4GHz频段，支持WPA2（不支持5GHz和企业网络）
  • 管理后台：记录管理后台的网址（如：https://demo.aiot.hello1023.com）
  • 浏览器：Chrome、Safari、Edge等现代浏览器
  • 手机：用于配网
💡
小提示

首次使用建议先在电脑旁边配置，方便查看LCD显示和调试。配置成功后可随意放置。

🔌 步骤2：设备开箱与上电

1
检查设备外观
  • LCD屏幕：位于设备正面，240×240像素，用于显示状态信息
  • Boot按键：通常位于设备侧面，长按进入配网模式
  • USB-C接口：用于供电和固件烧录
  • GPIO引脚：用于连接外设（传感器、舵机、LED等）
2
连接电源

使用USB-C数据线连接设备与电源适配器（或电脑USB口），设备会立即启动。

⚠️

请使用至少1A电流的电源，电流不足可能导致设备工作不稳定或LCD显示异常。

3
观察LCD显示

上电后，LCD屏幕会显示启动信息：

Product: ESP32-S3-Dev-01
MAC: **:**:**:**:**

✓ 如果看到以上信息，说明设备启动正常！如果没有注册，使用MAC地址进行注册，具体见步骤3。

📝 步骤3：在管理后台注册设备（如已注册，请跳过）

设备上电后，可以在LCD屏幕上看到MAC地址等信息。接下来需要在管理后台注册设备，才能进行远程控制和数据查看。

1
登录管理后台
  1. 打开浏览器，访问管理后台地址（如：https://demo.aiot.hello1023.com）
  2. 输入用户名和密码登录
  3. 首次使用请先注册账号
2
进入设备管理
  1. 登录后，点击左侧菜单的"设备管理"
  2. 点击右上角的"添加设备"按钮
  3. 选择"注册已有设备"
3
获取设备信息

在设备LCD屏幕上查找以下信息：

  • MAC地址：12位十六进制数（如：AA:BB:CC:DD:EE:FF）
  • UUID：设备唯一标识符（自动生成）
  • 产品代码：如ESP32-S3-Dev-01或ESP32-S3-Rain-01
💡

通常只需要输入MAC地址，其他信息会自动识别。

4
填写设备信息

在注册页面填写：

  • MAC地址：输入设备的MAC地址
  • 设备名称：给设备起个好记的名字（如：智能家居网关）
  • 设备描述：备注信息（可选）

填写完成后，点击"提交注册"按钮。

5
验证注册成功

注册成功后：

  • 页面显示"注册成功"提示
  • 设备列表中会出现新注册的设备
  • 设备状态显示为"离线"（灰色，因为还未配网）

✓ 设备注册完成！接下来进行配网连接。

⚠️
注意事项
  • 每个设备只能注册一次，重复注册会提示"设备已存在"
  • 如需重新注册，请先在设备管理中解绑设备
  • MAC地址必须准确，输入错误会导致注册失败
  • 注册后设备显示"离线"是正常的，完成配网后会变为"在线"

📱 步骤4：配网连接WiFi

设备注册完成后，需要进行配网，连接WiFi和服务器。有两种方式可以进入配网模式：

方式1
自动进入配网模式（首次启动）

如果设备是全新的或未保存WiFi信息，上电后会自动进入配网模式：

  • LCD显示"Config Mode"或"WiFi: Config..."
  • 设备会创建一个WiFi热点，名称类似：AIOT-ESP32-XXXXXX
方式2
手动进入配网模式（重新配网）

如果需要更换WiFi或重新配置：

  1. 长按设备上的Boot按键约3秒
  2. LCD显示"Entering Config Mode..."
  3. 松开按键，设备会重启并进入配网模式
3
连接配网热点
  1. 打开手机或电脑的WiFi设置
  2. 找到名为AIOT-ESP32-XXXXXX的WiFi热点
  3. 点击连接（无需密码）
  4. 连接后，系统会自动弹出配网页面
💡

如果没有自动弹出，请手动打开浏览器访问：http://192.168.4.1

4
填写配网信息

在配网页面填写以下信息：

  • WiFi SSID：您的WiFi网络名称
  • WiFi密码：WiFi密码（支持中文和特殊字符）
  • 服务器地址：管理后台地址（如：http://conf.aiot.hello1023.com:8001）

填写完成后，点击"提交"按钮。

5
等待连接成功

提交后，设备会尝试连接WiFi和服务器：

  • LCD显示"Connecting WiFi..."
  • 连接成功后显示"WiFi: Connected"
  • 接着显示"MQTT: Connected"
  • 配网热点会自动关闭
  • 您的手机/电脑会自动重连原来的WiFi

✓ 如果LCD显示"WiFi: Connected"和"MQTT: Connected"，说明配网成功！

此时回到管理后台，设备状态应该从"离线"变为"在线"（绿色）。

⚠️
常见问题
  • 如果配网失败，设备会在30秒后自动重启并重新进入配网模式
  • 请确认WiFi密码正确，特别注意大小写
  • 确保WiFi是2.4GHz频段（不支持5GHz）
  • 服务器地址要填写完整，包括http://前缀和端口号
  • 如果多次失败，可以尝试重启设备后重新配网
🎉
恭喜！配网完成

设备现在已经连接到WiFi和服务器，可以开始远程控制和数据查看了！

📊 步骤5：查看传感器数据

设备注册成功后，首先学习如何查看传感器数据，了解设备当前状态和环境信息。

1
进入设备详情
  1. 在"设备管理"页面，找到您注册的设备
  2. 点击设备名称或右侧的"查看详情"按钮
  3. 进入设备详情页面
2
查看实时传感器数据

在"传感器数据"标签页，您可以看到各种传感器的实时数据：

传感器类型 数据示例 说明
DHT11温湿度 24.5C / 50% 温度和湿度
DS18B20 25.0C 防水温度传感器
雨水传感器 Dry / Raining 是否检测到雨水
光照传感器 1200 lux 环境光照强度
💡
小提示

传感器数据每10秒自动上报一次，页面会实时更新显示。如果显示"--"或"N/A"，说明该端口未连接传感器。

3
查看历史数据
  1. 点击"历史记录"标签
  2. 选择时间范围（最近1小时、24小时、7天等）
  3. 查看数据趋势图表
  4. 可以导出数据为CSV文件
4
实际操作示例

试试这个简单测试：

  1. 找到DHT11温度传感器的数值（如果已连接）
  2. 用手轻轻捂住传感器，等待10-15秒
  3. 观察页面上的温度数值是否上升
  4. 松开手，等待温度恢复正常

✓ 如果温度有变化，说明传感器工作正常，数据传输无误！

🎉
太棒了！

您已经学会了如何查看传感器数据。接下来，让我们学习如何控制设备的各种端口。

🎮 步骤6：控制设备端口

掌握了传感器数据查看后，接下来学习如何远程控制设备。让我们通过最简单的LED测试来体验远程控制功能。

1
进入远程控制页面
  1. 在设备详情页面，点击"远程控制"标签
  2. 页面会显示该设备支持的所有控制端口
  3. 找到"LED控制"面板
2
测试LED开关

让我们控制板载的LED灯：

  1. 在LED控制面板中，选择LED1
  2. 点击"开"按钮，LED1应该会亮起 💡
  3. 点击"关"按钮，LED1应该会熄灭
  4. 可以尝试控制LED2、LED3、LED4
💡

提示：控制命令会立即发送到设备，通常1秒内生效。观察设备板上的LED是否响应。

3
验证控制成功

如果LED能够正常开关，说明远程控制功能工作正常！🎉

  • ✅ 设备能够接收并执行远程命令
  • ✅ 网络通信正常
  • ✅ 系统运行稳定

✓ 恭喜！您已经完成了基本的远程控制测试。

🎓
了解更多控制功能

除了LED，系统还支持控制舵机、继电器、PWM输出等更多端口类型。

详细使用方法请查看：管理后台使用指南