89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
|
---
|
|||
|
|
name: add-debug-command
|
|||
|
|
description: 在 GateWay_Debug 模块中添加新的 Debug 调试命令（函数指针表 + 字符串匹配模式）
|
|||
|
|
source: auto-skill
|
|||
|
|
extracted_at: '2026-06-15T08:10:31.194Z'
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 添加 Debug 调试命令
|
|||
|
|
|
|||
|
|
本项目的 Debug 命令系统位于 `Project/GateWay/source/Module/GateWay_Debug/DebugCmd.c`，采用**函数指针表 + 字符串匹配**模式。
|
|||
|
|
|
|||
|
|
## 修改步骤
|
|||
|
|
|
|||
|
|
### 1. 编写 handler 函数
|
|||
|
|
|
|||
|
|
在 `DebugCmd.c` 中添加函数，签名固定为 `void FuncName(int argc, char *argv[])`：
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
static void DebugCmdXxx(int argc, char *argv[])
|
|||
|
|
{
|
|||
|
|
DBG_LOG("\r\n");
|
|||
|
|
if(strcmp(argv[1], "?") == 0) {
|
|||
|
|
DBG_LOG("Debug Cmd: xxx\r\n");
|
|||
|
|
DBG_LOG(" brief --> 功能描述.\r\n\r\n");
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
// 实际逻辑...
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**必须遵循的模式：**
|
|||
|
|
- 函数体第一行：`DBG_LOG("\r\n");`
|
|||
|
|
- `"?"` 帮助分支：打印命令名和 brief 说明
|
|||
|
|
- 若修改了 `ConfigPara`，调用 `WritePara()` 保存
|
|||
|
|
- 需要被外部引用时声明为 `void`，仅内部使用时声明为 `static void`
|
|||
|
|
|
|||
|
|
### 2. 注册到命令表
|
|||
|
|
|
|||
|
|
在文件末尾的 `DebugFun[]` 常量数组中添加一行：
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
const DBGFunType DebugFun[DEBUG_CMD_CNT] = {
|
|||
|
|
// ... 已有命令 ...
|
|||
|
|
"xxx", DebugCmdXxx,
|
|||
|
|
};
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**容量限制：** `DEBUG_CMD_CNT = 30`，添加前检查剩余空位（当前使用 28/30）。若超出需增大该宏。
|
|||
|
|
|
|||
|
|
### 3. 添加到 help 输出
|
|||
|
|
|
|||
|
|
在 `DebugCmdHelp` 函数末尾添加：
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
len = strlen("xxx ?\r\n");
|
|||
|
|
memcpy(Data, "xxx ?\r\n", len);
|
|||
|
|
DebugAnalyze(GateWay, Data, len);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 可用的关键 API
|
|||
|
|
|
|||
|
|
| 函数 | 头文件 | 用途 |
|
|||
|
|
|---|---|---|
|
|||
|
|
| `CatOneEthSendQueue(data, len)` | CatOneTask.h | 将载荷放入网络发送队列（需 `SvrRegFlag == true`） |
|
|||
|
|
| `CommUintOrgData(GateWay, CUPara, CUData, buf)` | Public.h | 组装通讯单元传感器数据包 |
|
|||
|
|
| `GateWayRegister(TxBuff)` | CatOneTask.h | 组装网关注册包，返回长度 |
|
|||
|
|
| `NetCommOrgData(GateWay, payload, outBuf)` | Public.h | 为载荷添加网络帧头(0x7A)+MAC+CRC |
|
|||
|
|
| `WritePara(data, len)` | (bsp) | 保存配置参数到 Flash |
|
|||
|
|
| `CatOneTriggerRegister()` | CatOneTask.h | 将 Cat1 状态机立即切换到注册状态 |
|
|||
|
|
| `ETHTriggerRegister()` | CatOneTask.h | 将以太网状态机立即切换到注册状态 |
|
|||
|
|
|
|||
|
|
## 可用的全局/extern 变量
|
|||
|
|
|
|||
|
|
| 变量 | 类型 | 来源 |
|
|||
|
|
|---|---|---|
|
|||
|
|
| `GateWay` | `static GateWayPara` | DebugCmd.c 内静态指针，指向网关参数 |
|
|||
|
|
| `SComm1Para` / `SComm2Para` | `SensorCommPara_t` | RS485Task.c 中定义，DebugCmd.c 已 extern |
|
|||
|
|
| `GateWay->SvrRegFlag` | `bool` | 服务器注册状态 |
|
|||
|
|
| `GateWay->ConfigPara` | `GWConfigPara_t` | 网关配置参数 |
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- `CatOne_t CatOne` 和 `CatOneEthTxBuff[]` 均为 CatOneTask.c 中的 **static** 变量，不能直接在 DebugCmd.c 中访问；应使用封装好的接口函数（如 `CatOneTriggerRegister()`、`ETHTriggerRegister()`）来操作状态机
|
|||
|
|
- 重新注册应：清 `GateWay->SvrRegFlag = false`，然后根据通信模式调用 `CatOneTriggerRegister()` 或 `ETHTriggerRegister()` 立即切换状态机到注册状态，而不是仅清标志位等待状态机自动检测
|
|||
|
|
- `CatOneEthSendQueue` 内部检查 `SvrRegFlag`，未注册时返回 `false`
|
|||
|
|
- 命令解析函数 `DebugAnalyze` 按 `" "` 分割参数，去除 `\r`，最多 10 个参数
|
|||
|
|
- `DEBUG_CMD_CNT = 30` 为命令容量上限，添加新命令前需检查当前使用量，若超出需将此宏增大（如改为31）
|
|||
|
|
- 若模块需要保存独立的配置参数（如YOXO1007网络参数），可在DebugCmd.c中定义static变量，并通过Flash读写函数持久化（参考`EthNetPara_t`和`WriteEthNetPara`的实现）
|