Files
website/pages/projects/xiu-dtu/guide/tutorial.md
T
2026-11-05 11:54:21 +08:00

3.5 KiB
Raw Blame History

title, description, outline
title description outline
教程视频 秀杰 DTU 管理平台的部署与设备实操录屏教程 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 万台
  • 步骤与代码仓文档站的「快速上手」严格一致,视频里的每条命令都要能原样复制执行