Files

T

coco df489d5640 a

2026-07-03 16:05:30 +08:00

14 KiB

Raw Blame History

设备指令系统

**本文档引用的文件** - [GD10OperCmd.cpp](file://cpp/Tools/GD10OperCmd.cpp) - [GD10OperCmd.h](file://h/GD10OperCmd.h) - [DetcGD10Dev.cpp](file://cpp/Operator/DetcGD10Dev.cpp) - [DetcGD10Dev.h](file://h/DetcGD10Dev.h) - [DevManager.cpp](file://cpp/Managers/DevManager.cpp) - [DevManager.h](file://h/DevManager.h) - [IOManager.cpp](file://cpp/Managers/IOManager.cpp) - [IOManager.h](file://h/IOManager.h) - [FileOperTools.cpp](file://cpp/Tools/FileOperTools.cpp) - [FileOperTools.h](file://h/FileOperTools.h) - [Markup.h](file://h/Markup.h) - [Constant.h](file://h/Constant.h) - [Crc16.cpp](file://cpp/Tools/Crc16.cpp) - [Crc16.h](file://h/Crc16.h) - [Crc32.cpp](file://cpp/Tools/Crc32.cpp) - [Crc32.h](file://h/Crc32.h)

引言

本文档深入解析了GD10设备指令系统的实现，重点分析了GD10OperCmd.cpp文件中的设备指令系统。文档详细说明了GD10设备通信协议的命令格式、参数编码规则与响应解析机制，涵盖了指令分类（如设备配置、数据采集、状态查询等）、命令帧结构、校验机制（CRC16/CRC32）及超时重传策略。通过代码示例展示了典型指令的构造与解析流程，如启动测量任务、读取设备参数等。同时，文档解释了与DevManager、IOManager等模块的集成方式，以及在不同设备状态下的指令调度逻辑，并提供了常见通信异常的诊断方法和处理建议。

项目结构

GeomativeStudio项目是一个用于地质勘探设备管理的软件系统，其核心功能围绕GD10设备的通信、配置和数据管理展开。项目结构清晰地分为多个模块，每个模块负责特定的功能领域。

graph TB
subgraph "核心模块"
DevManager["设备管理器<br>(Managers/DevManager.cpp)"]
IOManager["输入输出管理器<br>(Managers/IOManager.cpp)"]
GD10OperCmd["GD10操作命令<br>(Tools/GD10OperCmd.cpp)"]
end
subgraph "工具与支持模块"
DetcGD10Dev["GD10设备检测<br>(Operator/DetcGD10Dev.cpp)"]
FileOperTools["文件操作工具<br>(Tools/FileOperTools.cpp)"]
Markup["XML解析工具<br>(Tools/Markup.cpp)"]
Crc16["CRC16校验<br>(Tools/Crc16.cpp)"]
Crc32["CRC32校验<br>(Tools/Crc32.cpp)"]
end
subgraph "常量与头文件"
Constant["常量定义<br>(h/Constant.h)"]
Headers["头文件<br>(h/*.h)"]
end
GD10OperCmd --> DevManager
GD10OperCmd --> IOManager
GD10OperCmd --> DetcGD10Dev
GD10OperCmd --> FileOperTools
GD10OperCmd --> Markup
GD10OperCmd --> Crc16
GD10OperCmd --> Crc32
DetcGD10Dev --> FileOperTools
DevManager --> Headers
IOManager --> Headers
Constant --> Headers

图源

节源

核心组件

GD10OperCmd类是实现GD10设备指令系统的核心组件，它通过模拟微机操作来管理连接到Geomative Studio的GD10设备。该类提供了对设备上文件系统的操作接口，包括工程、测区、脚本和测量任务的增删改查。所有操作都依赖于DetcGD10Dev类来检测和确认设备的连接状态，并使用Markup类来解析和修改设备上的XML配置文件。FileOperTools类则提供了底层的文件和目录操作功能，确保了操作的原子性和日志记录。

节源

架构概述

GD10设备指令系统的架构是一个典型的分层设计，从上层应用逻辑到底层硬件交互，各层职责分明。

graph TD
A[用户界面] --> B[GD10OperCmd]
B --> C[DetcGD10Dev]
B --> D[FileOperTools]
B --> E[Markup]
C --> F[USB设备]
D --> G[文件系统]
E --> H[XML文件]
B --> I[Crc16/Crc32]
subgraph "应用层"
A
B
end
subgraph "服务层"
C
D
E
I
end
subgraph "数据层"
F
G
H
end

图源

节源

详细组件分析

GD10操作命令分析

CGD10OperCmd类是整个指令系统的核心，它封装了所有与GD10设备交互的命令。

类结构与关系

classDiagram
class CGD10OperCmd {
+static CGD10OperCmd* m_pGD10Oper
+CGD10OperCmd()
+~CGD10OperCmd()
+static CGD10OperCmd* GetInstance()
+int project_add(const char *mac, const char *projectcn)
+bool project_delete(const char *mac, const char *projectcn)
+int testzone_add(const char *projectcn, const char *testzonecn, const char *type)
+int testzone_delete(const char *projectcn, const char *testzonecn)
+int script_add(const char *scriptcn, const char *scriptname, const char *mudiumid)
+bool script_delete(const char *scriptcn)
+bool meas_delete(const char *projectcn, const char *testzonecn, const char *measuringcn)
+bool set_param(const CString& strParam)
+bool unregister_user(CString strMacAddr)
+bool loadDeviceMarkDataFromGD()
+static UINT LoadDevMarkDataFormGDThread(LPVOID lParam)
}
class CDetcGD10Dev {
+static CDetcGD10Dev* m_pDetcDev
+bool m_bGD10DevIsCon
+CString m_strDevAddr
+CDetcGD10Dev()
+~CDetcGD10Dev()
+static CDetcGD10Dev* GetInstance()
+bool IsGD10DevConnect()
+CString GetGD10DevAddr()
+void DetectGD10Dev()
}
class CFileOperTools {
+static CFileOperTools* m_pFileOper
+FILE* m_pComLog
+CRITICAL_SECTION *m_pWriteLogSection
+CFileOperTools()
+~CFileOperTools()
+static CFileOperTools* GetInstance()
+bool CopyFolder(CString strSrcPath, CString strDstPath)
+bool IsFileExist(CString strFileInfo)
+bool WriteComLog(const CString& strInfo)
+bool DeleteDirectory(CString strDirPath)
+bool DeleteFileDirect(CString strFilePath)
}
class CMarkup {
+CMarkup()
+~CMarkup()
+bool Load(const char* szFileName)
+bool Save(const char* szFileName)
+bool FindChildElem(const char* szName)
+bool IntoElem()
+bool AddChildElem(const char* szName, const char* szData)
+bool RemoveChildElem()
+CString GetChildData()
+bool SetChildData(const char* szData)
+void ResetPos()
}
CGD10OperCmd --> CDetcGD10Dev : "使用"
CGD10OperCmd --> CFileOperTools : "使用"
CGD10OperCmd --> CMarkup : "使用"
CDetcGD10Dev --> CFileOperTools : "使用"

图源

节源

指令执行流程

sequenceDiagram
participant UI as "用户界面"
participant GD10Cmd as "CGD10OperCmd"
participant DetDev as "CDetcGD10Dev"
participant FileTools as "CFileOperTools"
participant Markup as "CMarkup"
UI->>GD10Cmd : project_add(mac, projectcn)
GD10Cmd->>DetDev : IsGD10DevConnect()
alt 设备未连接
GD10Cmd-->>UI : 显示错误消息
return
end
GD10Cmd->>DetDev : GetGD10DevAddr()
GD10Cmd->>FileTools : MakeSureDirectoryPathExists()
alt 创建目录失败
GD10Cmd-->>UI : 显示错误消息
return
end
GD10Cmd->>Markup : 加载 localhost.xml
GD10Cmd->>Markup : 在 path_dictionary 中添加 path 元素
GD10Cmd->>Markup : 保存 localhost.xml
GD10Cmd->>Markup : 加载 mac.xml
GD10Cmd->>Markup : 在 path_dictionary 中添加 path 元素
GD10Cmd->>Markup : 保存 mac.xml
GD10Cmd-->>UI : 返回成功 (1)

图源

节源

GD10OperCmd.cpp

设备检测与管理分析

CDetcGD10Dev类负责检测和管理GD10设备的连接状态，为上层指令系统提供设备可用性保障。

设备检测流程

flowchart TD
Start([开始检测设备]) --> GetDrives["获取所有逻辑驱动器"]
GetDrives --> CheckDrive["遍历每个驱动器"]
CheckDrive --> IsRemovable{"是否为可移动驱动器?"}
IsRemovable --> |是| GetVolName["获取卷标名称"]
IsRemovable --> |否| NextDrive["下一个驱动器"]
GetVolName --> CompareName{"卷标是否为 'GD10' 或 'GD20'?"}
CompareName --> |是| SetAddr["设置设备地址"]
CompareName --> |否| CheckDir["检查是否存在 \\SD\\equipment 目录"]
CheckDir --> |存在| SetAddr
CheckDir --> |不存在| NextDrive
SetAddr --> SetConnected["设置连接状态为 true"]
SetConnected --> End([设备检测完成])
NextDrive --> CheckDrive

图源

DetcGD10Dev.cpp

节源

DetcGD10Dev.cpp

依赖分析

GD10设备指令系统依赖于多个核心组件和工具类，这些依赖关系确保了系统的稳定性和功能完整性。

graph TD
GD10OperCmd --> DetcGD10Dev
GD10OperCmd --> FileOperTools
GD10OperCmd --> Markup
GD10OperCmd --> Crc16
GD10OperCmd --> Crc32
DetcGD10Dev --> FileOperTools
DevManager --> GD10OperCmd
IOManager --> GD10OperCmd
subgraph "GD10指令系统"
GD10OperCmd
DetcGD10Dev
end
subgraph "工具类"
FileOperTools
Markup
Crc16
Crc32
end
subgraph "其他管理器"
DevManager
IOManager
end

图源

节源

性能考虑

在设计和实现GD10设备指令系统时，性能是一个重要的考量因素。系统通过以下方式优化性能：

单例模式：CGD10OperCmd和CDetcGD10Dev类都采用了单例模式，避免了重复创建对象的开销。
线程安全：CFileOperTools类在写日志时使用了临界区（CRITICAL_SECTION）来保证线程安全，防止多线程并发写入导致的日志混乱。
异步操作：loadDeviceMarkDataFromGD方法通过创建独立线程来执行文件复制和删除操作，避免了阻塞主线程，提高了用户体验。
错误重试：在删除文件或复制文件时，系统会进行多次重试（最多3次），以应对可能的文件占用或I/O错误，提高了操作的鲁棒性。

故障排除指南

当GD10设备指令系统出现通信异常时，可以按照以下步骤进行诊断和处理：

节源

常见问题与解决方案

问题现象	可能原因	解决方案
"请确保主机设备连上Geomative Studio!"	GD10设备未正确连接或未被识别	1. 检查USB线缆连接是否牢固。 2. 确认设备卷标是否为'GD10'或'GD20'。 3. 检查`LOG\detect_gd20_log.txt`日志文件以获取详细检测信息。
"添加工程到本机失败"	`localhost.xml`文件损坏或权限不足	1. 检查`sd\users\localhost.xml`文件是否存在且可写。 2. 查看`LOG\general\`目录下的日志文件，确认具体的错误代码。
"创建工程失败"	SD卡空间不足或文件系统错误	1. 检查GD10设备的SD卡剩余空间。 2. 尝试格式化SD卡（注意备份数据）。
"删除文件失败"	文件被其他进程占用	1. 确保没有其他程序正在访问GD10设备的文件。 2. 系统会自动重试3次，若仍失败，重启软件或设备后重试。
"解析输入参数错误"	`set_param`方法的输入字符串格式不正确	1. 确认输入参数为逗号分隔的键值对，如`"key1,value1;key2,value2"`。 2. 检查键名是否存在于`equipment.xml`文件中。

结论

通过对GD10OperCmd.cpp及其相关组件的深入分析，我们全面理解了GD10设备指令系统的工作原理。该系统通过一个清晰的分层架构，将设备检测、文件操作、XML解析和指令执行等功能解耦，实现了对GD10设备的高效管理和控制。系统设计考虑了单例模式、线程安全和异步操作等性能优化策略，并通过详细的日志记录和错误处理机制保证了系统的稳定性。对于开发者而言，理解这些核心组件的交互方式和设计模式，对于维护和扩展系统功能至关重要。

14 KiB Raw Blame History Unescape Escape