iotsaas/docs/tuya/完成步骤.md
2995840376 0ce191c448 chore: 初始化 iotsaas 版本库基线
纳入范围:
- backend/  Spring Boot 多模块后端(iot-common/device/rule/data/alarm/auth)
- frontend/admin/  Vue3 + Element Plus 管理后台
- Android/   涂鸦原生 APP (com.xhai.iot)
- backend/sql/  Flyway 风格迁移脚本(V2~V21)
- docs/       对接文档与设计文档

排除范围:
- 构建产物: node_modules/ target/ build/ dist/ .gradle/
- 签名密钥: *.jks *.keystore (严禁入库)
- 本机配置: Android/local.properties
- 运行日志: logs/ *.log
- AI 协作本地数据 .codebuddy/ 与第三方 demo tuya-demo/

.gitattributes 统一以 LF 存储, Windows 批处理保留 CRLF
2026-10-27 12:00:41 +08:00

2.8 KiB
Raw Blame History

Step 1 - 登录 & 涂鸦绑定

登录 iotsaas 账号(用之前注册的账号密码) 点"我的" Tab → 涂鸦账号绑定 输入涂鸦账号 86-18933750555 + 密码 → 绑定 预期:提示"涂鸦账号绑定成功",返回后"我的"页显示"已绑定"

Step 2 - 底部 Tab 框架

确认底部有"首页"和"我的"两个 Tab 点击切换,确认页面正常切换、不闪退

Step 3 - 配网添加设备(关键,验证设备隔离问题)

首页点右上角 "+" 进入配网页 将涂鸦设备置于配网模式(快速开关机 3 次,指示灯快闪) 输入 Wi-Fi SSID/密码 → 开始配网 预期:提示"配网成功",设备进入你的 AppKey 家庭

Step 4 - 设备列表 & 控制

配网成功后回首页,刷新设备列表 预期:能看到刚才配网的设备(这验证了设备隔离问题已解决) 点击设备 → 进入控制页 → 开关/滑块控制 预期:开关生效,设备实际动作

配网流程 搜索设备(不要求 Wi-Fi) ├─ 发现 BLE_WIFI / MULT_MODE 设备(网关/双模) │ → 弹 Wi-Fi 输入对话框(SSID 已自动填当前 Wi-Fi) │ → 获取 token → 配网 └─ 发现 SINGLE_BLE 设备(蓝牙子设备,开关/传感器等) → 不弹 Wi-Fi,直接获取 token → 配网

子设备控制流 Mesh子设备(JD2BTSA) → isSigMesh=true → 检测到 ↓ ThingOSMesh.newDevice(meshId).publishCommands(nodeId, category, cmd) ↓ 301蓝牙网关本地转发 ↓ Mesh子设备执行

┌─────────────────────────────────────────────┐ │ 场景应用层(自己建) │ │ Scene 表:场景名、触发条件、动作、启用状态 │ │ 触发源:设备DP变化/定时/手动 │ └──────────────────┬──────────────────────────┘ │ 触发 ┌──────────────────▼──────────────────────────┐ │ 场景执行引擎(iot-rule 增强) │ │ 解析动作 → 分发到各平台适配器 │ └──────────────────┬──────────────────────────┘ │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ 涂鸦适配器 华为适配器 小米适配器 (TuyaAdapter) (HuaweiAdapter) (XiaomiAdapter) │ │ │ ▼ ▼ ▼ 涂鸦场景API HiLink API 米家API