技小云
59 lines
3.5 KiB
Markdown
59 lines
3.5 KiB
Markdown
---
|
||
title: 教程视频
|
||
description: 秀杰 DTU 管理平台的部署与设备实操录屏教程
|
||
outline: deep
|
||
---
|
||
|
||
# 教程视频
|
||
|
||
秀杰 DTU 分两支：把服务起起来并让设备连上，然后在平台上真的操作一遍设备。
|
||
|
||
## V4 部署教程：源码起服务到设备接入
|
||
|
||
| 项 | 内容 |
|
||
| --- | --- |
|
||
| 标题 | 秀杰 DTU 部署教程：源码起服务到设备接入 |
|
||
| 目标观众 | 做 DTU 设备接入的开发者 |
|
||
| 时长 | 12 ~ 15 分钟 |
|
||
| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
|
||
| 关联文档 | 代码仓 `docs_ui/` 文档站（快速上手、通信协议、控制台说明） |
|
||
| 关联仓库路径 | `server/`、`vue/`、`docs_ui/`、`docker/`、`deploy/` |
|
||
|
||
分镜：
|
||
|
||
1. **环境准备**（1.5 分钟）：Go 1.25+、Node.js 24+ 与 pnpm 10+、MySQL 8、Redis 7 的版本检查
|
||
2. **初始化数据库**（2 分钟）：建库 `xiujie_dtu` 并按顺序导入四个初始化 SQL（基础表、业务表、菜单、角色）
|
||
3. **配置后端**（1.5 分钟）：复制 `config_default.yaml` 为 `config.yaml`、改数据库与 Redis 连接、设置 JWT 签名密钥环境变量（长度不少于 32 位，未提供时服务拒绝签发令牌）
|
||
4. **启动后端**（2.5 分钟）：`go run main.go`，说明三个监听端口的用途：控制台 5689、设备 HTTP 5692、设备 TCP 5690
|
||
5. **启动前端与文档站**（2 分钟）：`pnpm install && pnpm dev`（前端 5688）、`npm run docs:dev`（文档站 5687）
|
||
6. **登录与改密**（1 分钟）：初始 admin 账号登录后立即改密
|
||
7. **Docker 部署路线**（2 分钟）：`docker/dtu_base` 初始化中间件 → `docker/dtu_iot` 部署业务服务、`make docker-build docker-push` 构建推送镜像
|
||
|
||
## V5 设备实操：双通道接入、指令下发与 OTA
|
||
|
||
| 项 | 内容 |
|
||
| --- | --- |
|
||
| 标题 | 秀杰 DTU 设备实操：双通道接入、指令下发与 OTA |
|
||
| 目标观众 | 设备端与平台端联调工程师 |
|
||
| 时长 | 15 ~ 18 分钟 |
|
||
| 发布位置 | 官网本页 + 源码仓 README 顶部 + B 站 |
|
||
| 关联文档 | 代码仓文档站「通信协议」章节（HTTP API、TCP 帧、指令、属性上报、配置同步、OTA、UART 隧道） |
|
||
| 关联仓库路径 | `tools/`、`server/`、`docs_ui/` |
|
||
|
||
分镜：
|
||
|
||
1. **HTTP 通道联调**（3 分钟）：用 `tools/test-device-http-v4.sh` 带 DEVICE_KEY / PRODUCT_KEY / PROJECT_KEY 打一次设备注册与上报，看平台侧设备列表出现
|
||
2. **TCP 通道联调**（3 分钟）：`tools/test-device-tcp-v4.py --heartbeat --listen-command` 建连、维持心跳、接收平台下发指令
|
||
3. **指令下发**（2.5 分钟）：从控制台对设备下指令，两端同时看帧与日志
|
||
4. **属性上报与配置同步**（2.5 分钟）：设备上报属性、平台侧改配置并下发，验证端到端一致性
|
||
5. **OTA 升级**（2.5 分钟）：研发中心建固件版本、发起 OTA 升级任务、看设备侧升级结果
|
||
6. **UART 隧道**（1.5 分钟）：透传串口数据的用法与适用场景
|
||
7. **压测**（2 分钟）：`tools/stress-2w-devices.py --count 20000` 演示 2 万设备压测怎么发起、看指标
|
||
|
||
## 录制备忘
|
||
|
||
- 录屏环境用干净 Ubuntu，MySQL / Redis 独立装，不要连生产或预演环境
|
||
- DEVICE_KEY / PRODUCT_KEY / PROJECT_KEY 等示例值用文档里的测试值，画面出现即可
|
||
- 2 万设备压测那段只演示命令与指标入口，不在录屏环境真压 2 万台
|
||
- 步骤与代码仓文档站的「快速上手」严格一致，视频里的每条命令都要能原样复制执行
|