---
name: define-interface-protocol-characteristics-2
description: 当接口使用标准化或自定义通信协议时，用于系统化定义协议的关键特征，包括标识、层级、打包机制、错误处理、同步流程和状态报告。适用于网络接口、软件组件接口及跨系统通信接口的设计阶段。
---

# 定义接口协议特征

## 何时使用
- 接口基于明确的通信协议（如 HTTP、MQTT、自定义二进制协议等）
- 存在多个实体间的交互需求，需规范数据交换行为
- 正在编写《接口设计说明》文档，需结构化描述协议行为
- 不适用于无协议栈的直接硬件连接（如 GPIO、模拟信号线）

## 执行步骤

1. **分配唯一协议标识符**：为当前协议分配项目内唯一的名称或 ID，确保可追溯性。
2. **明确协议层级**：指定协议在 OSI 或 TCP/IP 模型中的位置（如应用层、传输层），记录为变量 `protocol_level`。
3. **定义打包机制**：
   - 描述数据分段与重组规则
   - 说明路由选择逻辑
   - 规定寻址方式（如 IP 地址、设备 ID、主题名）
4. **规定错误处理机制**：
   - 指定合法性检查方法（如 CRC 校验、校验和）
   - 定义错误检测与纠正策略
   - 设定故障恢复流程，包括重传策略和超时处理，并设置 `retransmission_limit`（最大重传次数）
5. **描述同步过程**：
   - 连接建立：定义握手协议（如 SYN/ACK、CONNECT 请求）
   - 连接保持：配置心跳机制，设定 `heartbeat_interval`（心跳间隔，单位：秒）
   - 连接终止：实现优雅关闭流程（如 FIN 握手、DISCONNECT 通知）
6. **定义状态报告机制**：
   - 列出所有状态码及其含义
   - 规范实体标识格式（如 UUID、MAC 地址）
   - 描述运行时报告内容（如吞吐量、延迟、错误率等性能统计）

## 输出要求
生成结构化的协议特征描述，可直接引用至《接口设计说明》文档中，确保开发、测试与集成团队对协议行为理解一致。