# dtu-wt32

**Repository Path**: shp-java/dtu-wt32

## Basic Information

- **Project Name**: dtu-wt32
- **Description**: DTU设备配置管理工具是一款专为工业物联网领域数据传输单元（DTU）量身打造的专业级跨平台桌面应用程序。它旨在彻底改变传统DTU设备依赖串口命令行、配置复杂、难以批量管理的现状，为工程师和运维人员提供一套直观、高效、统一的设备全生命周期管理解决方案。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


配置软件：https://gitee.com/shp-java/dtumanager

#### 1. 设备概述
本系列DTU（数据传输单元）设备，支持通过专用的跨平台**上位机配置管理工具**进行快速部署与深度管理。设备出厂时已预置与上位机通信的标准化协议栈，确保开箱即可被自动发现与识别。

#### 2. 与上位机软件的协同工作模式
设备作为**被管理节点**，与上位机软件构成主从式管理体系，实现双向交互：

| **交互方向** | **设备行为与响应** |
| :--- | :--- |
| **设备发现** | 设备上电并接入网络后，持续广播或响应上位机软件的**网络发现协议**（如UDP广播、特定协议报文），主动上报自身型号、ID、MAC地址等身份信息。 |
| **参数接收与设置** | 设备端固件**监听特定配置端口/指令**。当上位机下发配置参数（如服务器地址、通信周期、寄存器映射）时，设备需准确接收、解析并存入非易失性存储器，随后重启相应服务以生效。 |
| **状态上报** | 设备固件需按**心跳机制**或响应查询指令，主动向上位机周期性上报运行状态，包括：信号强度(RSSI)、网络类型、IP地址、运行时长、固件版本及关键业务数据。 |
| **固件升级** | 设备需实现**安全的固件升级（FOTA）协议**。当上位机发起升级任务并传输固件包时，设备负责完成校验、存储（至备用分区）与安全重启切换流程。 |
| **远程调试** | 设备需开放**安全的调试通道**（如TCP Socket或虚拟串口），以接收并执行从上位机“终端”功能发送的AT指令或自定义调试指令，并返回结果。 |

#### 3. 设备端对接技术要求
为确保与上位机软件无缝兼容，本设备在设计时已实现以下核心接口：

*   **通信接口**：至少支持 **以太网（TCP/IP）** 或 **RS-485** 其中一种作为配置通道。
*   **发现协议**：实现基于 **UDP 广播** 或 **Modbus-TCP 设备扫描** 的自动发现机制。
*   **配置协议**：采用结构化的**配置帧格式**，支持对设备所有可调参数的读写操作。
*   **数据上报协议**：定义统一的状态数据帧格式，供上位机解析并展示在设备列表中。
*   **安全设计**：固件升级过程包含**完整性校验（如CRC32或SHA-256）** 与**双备份回滚机制**，防止升级失败导致设备“变砖”。

#### 4. 典型工作流程（设备侧视角）
1.  **设备上电启动**
2.  **初始化网络与配置服务**
3.  **进入主循环，持续执行以下任务：**
    - [ ] **响应发现请求**：监听网络，响应上位机的发现请求并上报身份信息。
    - [ ] **监听配置指令**：接收、解析并保存上位机下发的配置参数。
    - [ ] **上报状态数据**：定时或触发式向上位机上报设备运行状态。
    - [ ] **处理升级指令**：若收到升级指令，则进入安全升级流程。
    - [ ] **处理调试指令**：若收到调试指令，则在调试通道执行并返回结果。

#### 5. 给设备开发者/生产人员的说明
*   **烧录要求**：出厂固件**必须预烧录**兼容的通信协议栈与设备发现服务。
*   **设备标识**：每台设备需具备**唯一的设备ID与MAC地址**，这是上位机识别与区分设备的关键。
*   **默认配置**：设备出厂时应设置默认的**配置服务使能**与**发现广播使能**，确保首次上电即可被软件发现。
*   **协议一致性**：设备固件实现的指令集与数据格式，需与上位机软件发布的《**设备通信协议文档**》（protocol.md）保持严格一致。