86 lines
2.6 KiB
Markdown
86 lines
2.6 KiB
Markdown
|
# 任务003：TCP通讯服务
|
|||
|
|
|
|||
|
|
## 目标
|
|||
|
|
|
|||
|
|
实现TCP长连接服务，处理设备登录、签名验证、数据上报、指令下发。
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
- Rust + Tokio
|
|||
|
|
- TCP长连接
|
|||
|
|
|
|||
|
|
## 协议规范
|
|||
|
|
|
|||
|
|
### 通信规则
|
|||
|
|
- 长连接，无需PING包
|
|||
|
|
- 空闲1分钟上报，充电15秒上报
|
|||
|
|
- 超时5000ms
|
|||
|
|
- JSON去空格回车省流量，LF处理粘包
|
|||
|
|
- `dev_id`：IMEI（10进制）
|
|||
|
|
- `sub_device_id`：485 ID
|
|||
|
|
- `msg_id`：自增会话ID
|
|||
|
|
|
|||
|
|
### 签名机制
|
|||
|
|
- 设备首次连接调 `auth_str` 接口获取8位安全码（仅一次）
|
|||
|
|
- `sign = SHA256(dev_id + auth_str + timestamp).substring(56, 63)`
|
|||
|
|
- 时间戳秒级，平台校验±60秒
|
|||
|
|
|
|||
|
|
### 接口清单
|
|||
|
|
|
|||
|
|
| 动作 | 方向 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `login` | 设备→平台 | 登录（需sign签名+timestamp） |
|
|||
|
|
| `auth_str` | 设备→平台 | 获取安全码（仅首次） |
|
|||
|
|
| `off` | 双向 | 停止供电 |
|
|||
|
|
| `status_post` | 设备→平台 | 定时状态上报（rssi/status） |
|
|||
|
|
| `on` | 平台→设备 | 开始供电 |
|
|||
|
|
| `open` | 平台→设备 | 开门（错误码63=门锁故障） |
|
|||
|
|
| `status_get` | 平台→设备 | 读取仓板状态 |
|
|||
|
|
| `reset` | 平台→设备 | 设备重启 |
|
|||
|
|
| `pow_fail` | 设备→平台 | 停电上报 |
|
|||
|
|
|
|||
|
|
## 实现要求
|
|||
|
|
|
|||
|
|
### TCP Server
|
|||
|
|
- 监听端口：3002（可配置）
|
|||
|
|
- 连接管理：维护设备连接池
|
|||
|
|
- 心跳检测：5000ms超时断开
|
|||
|
|
- 粘包处理：LF分隔
|
|||
|
|
|
|||
|
|
### 登录流程
|
|||
|
|
1. 设备发送 `{"act":"login","dev_id":"IMEI","msg_id":1,"timestamp":xxx,"sign":"xxx"}`
|
|||
|
|
2. 平台验证签名
|
|||
|
|
3. 验证通过 → 返回 `{"suc":1,"msg_id":1}`
|
|||
|
|
4. 验证失败 → 返回 `{"suc":0,"err":"签名错误"}`
|
|||
|
|
|
|||
|
|
### 数据上报处理
|
|||
|
|
- `status_post`：解析status HEX数据，存入Redis（实时）+ MySQL（持久化）
|
|||
|
|
- `pow_fail`：记录停电日志
|
|||
|
|
|
|||
|
|
### 指令下发
|
|||
|
|
- 提供API接口供HTTP服务调用
|
|||
|
|
- 通过设备连接池下发指令
|
|||
|
|
- 设备不在线时返回错误
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
software/server/src/
|
|||
|
|
├── tcp/
|
|||
|
|
│ ├── mod.rs # TCP服务入口
|
|||
|
|
│ ├── server.rs # TCP Server实现
|
|||
|
|
│ ├── connection.rs # 连接管理
|
|||
|
|
│ ├── protocol.rs # 协议解析
|
|||
|
|
│ ├── handler.rs # 消息处理
|
|||
|
|
│ └── commands.rs # 指令下发
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 质量约束
|
|||
|
|
|
|||
|
|
1. 完成代码后执行 `cargo check`，必须零报错、零警告
|
|||
|
|
2. 分层拆分，单函数≤80行，命名语义化，完整注释
|
|||
|
|
3. 所有外部IO/网络请求异常捕获，禁止裸panic
|
|||
|
|
4. 分支逻辑全覆盖，不遗漏兜底分支
|
|||
|
|
5. 常量抽离，不使用废弃API
|
|||
|
|
6. Rust内存安全，合理管理所有权，禁用unsafe无合理理由
|