chore: 清理废弃模块代码

2026-06-22 10:11:33 +08:00
parent a87bc24b01
commit 74a0193e3d
16 changed files with 566 additions and 1 deletions
@@ -0,0 +1,88 @@
+---
+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`的实现）
@@ -0,0 +1,57 @@
+---
+name: fix-yoxo1007-receive-data
+description: 修复YOXO1007以太网模块接收数据解析错误问题
+source: auto-skill
+extracted_at: '2026-06-17T04:30:00.000Z'
+---
+
+# 修复 YOXO1007 以太网模块接收数据解析错误
+
+## 问题现象
+
+服务器已收到网关注册请求并响应，但网关端无法接收/解析服务器返回的数据。
+
+## 根本原因
+
+YOXO1007 模块在**透传模式**下发送的是**原始二进制数据**，不是 ASCII 格式的 hex 字符串。
+
+原代码错误地使用了 `AsciiToHex` 函数进行格式转换：
+
+```c
+// 错误代码 - CATONE 模式使用的 ASCII 转换不适用于 ETH 透传模式
+memset(HexData, 0x00, CatOneEthRxLen / 2);
+uint8_t ret = AsciiToHex(RxBuffTemp, HexData, CatOneEthRxLen);
+if(ret > 0)
+    GateWay->SvrRevCallBack(GateWay, HexData, ret);
+```
+
+这导致服务器返回的二进制数据被错误解析，回调函数无法正确处理。
+
+## 修复方案
+
+修改 `CatOneTask.c` 中 ETH 接收线程的数据处理逻辑，直接传递原始二进制数据：
+
+```c
+// 修改后的正确代码
+CAT1_DBG_LOG("Eth Rev: len=%d\r\n", CatOneEthRxLen);
+/* YOXO1007模块在透传模式下发送原始二进制数据,直接传递 */
+if(CatOneEthRxLen > 0)
+    GateWay->SvrRevCallBack(GateWay, (uint8_t *)CatOneEthRxBuff, CatOneEthRxLen);
+```
+
+## 修改位置
+
+`Project/GateWay/source/User/Src/CatOneTask.c` 中的 `CatOneRev_Thread_Entry` 函数内的 ETH 分支。
+
+## 关键区别
+
+| 模式 | 数据格式 | 解析方式 |
+|------|----------|----------|
+| CAT1 (4G) | ASCII 字符串 (AT 命令/响应) | 需要 AsciiToHex 转换 |
+| ETH (YOXO1007) | 原始二进制 (透传模式) | 直接传递，不转换 |
+
+## 注意事项
+
+- 此修改仅影响 ETH 通信模式，CAT1 模式的 ASCII 解析逻辑保持不变
+- YOXO1007 模块配置参数使用二进制命令协议（识别流 ED F2 A3 56...），与数据透传是不同层面
+- 模块配置保存后重启会自动进入之前保存的工作模式，无需额外进入透传模式的命令
@@ -0,0 +1,79 @@
+---
+name: git-branch-cleanup
+description: 批量删除/重命名本地和远端 Git 分支，并同步远端仓库结构（含中文分支名、upstream 修复）
+source: auto-skill
+extracted_at: '2026-06-17T10:06:37.947Z'
+---
+
+# Git 分支批量清理与重命名
+
+## 适用场景
+需要删除多余的本地/远端分支、将分支重命名、并让远端结构与本地保持一致。
+
+## 操作流程
+
+### 1. 切换到安全分支
+```bash
+# 先 stash 未提交的更改
+git stash --include-untracked
+
+# 如果有 untracked 文件冲突，使用 -f 强制切换
+git checkout -f master
+```
+
+> **坑点**：中文分支名之间的文件差异可能产生大量 untracked 冲突（如 FatFS 文档等），
+> `git checkout` 会拒绝切换，需要 `-f` 强制切换，之后 `git stash pop` 恢复。
+
+### 2. 删除本地分支
+```bash
+git branch -D "LAN口通讯"
+git branch -D "新版4G模块1"
+```
+
+### 3. 重命名本地分支
+```bash
+git branch -m "旧版4G模块" develop
+```
+
+### 4. 删除远端分支（每个远端都要操作）
+```bash
+# 一次性删除多个远端分支
+git push home --delete "LAN口通讯" "新版4G模块" "旧版4G模块"
+git push origin --delete "LAN口通讯" "新版4G模块" "旧版4G模块"
+```
+
+> **注意**：远端可能认证失败（如内网地址不可达），先确认网络可达再操作。
+> 远端分支名可能与本地不完全一致（本地有 `新版4G模块1`，远端只有 `新版4G模块`）。
+
+### 5. 强制推送重命名后的分支到远端
+```bash
+git push home develop --force
+git push origin develop --force
+```
+
+### 6. 修复上游跟踪分支
+重命名后，分支仍跟踪旧的远端名（如 `origin/旧版4G模块`，已不存在）：
+```bash
+git branch --set-upstream-to=origin/develop develop
+```
+
+### 7. 恢复工作内容并切回开发分支
+```bash
+git checkout develop
+git stash pop
+```
+
+### 8. 验证最终结构
+```bash
+git fetch --all --prune
+git branch -a
+```
+
+## 常见问题
+
+| 问题 | 解决方案 |
+|------|----------|
+| checkout 报 untracked files 冲突 | `git checkout -f <branch>` |
+| 远端认证失败 | 检查网络/VPN，确认远端地址可达 |
+| 重命名后 upstream 指向已删除的远端分支 | `git branch --set-upstream-to=origin/<new-name> <branch>` |
+| 中文分支名在命令行中需加引号 | `git branch -D "旧版4G模块"` |