修改文件换行符，修正轮班图元长度计算问题
This commit is contained in:
@@ -1,189 +1,189 @@
|
||||
# RFIDManager 实现方案
|
||||
|
||||
## 概述
|
||||
|
||||
当前项目中的RFID功能通过`__RFID_CARD`宏控制，该宏通过条件编译启用或禁用RFID相关代码。这种方法在可维护性、测试和运行时灵活性方面存在局限。为了解决这些问题，我们建议引入`RFIDManager`类，该类封装所有RFID操作，提供更清洁、更模块化的设计。
|
||||
|
||||
`RFIDManager`将处理RFID初始化、数据读取和验证，仅通过QT信号通知外部卡片检测事件，让外部组件（如InkJetPrinter）负责具体的处理逻辑，替换代码库中分散的`#ifdef __RFID_CARD`块。
|
||||
|
||||
## 目标
|
||||
|
||||
- **封装**：将RFID逻辑集中到一个类中。
|
||||
- **运行时控制**：允许在运行时而不是编译时启用/禁用RFID功能。
|
||||
- **可维护性**：通过移除预处理器指令简化代码。
|
||||
- **可扩展性**：更容易添加新RFID功能或修改现有功能。
|
||||
- **测试**：无需重新编译即可对RFID组件进行单元测试。
|
||||
|
||||
## 类设计
|
||||
|
||||
### RFIDManager 类
|
||||
|
||||
```cpp
|
||||
class RFIDManager : public QObject {
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
RFIDManager(QObject* parent = nullptr);
|
||||
~RFIDManager();
|
||||
|
||||
// 初始化
|
||||
bool initialize();
|
||||
|
||||
// 主处理循环（定期调用，例如每300ms）
|
||||
void processRFID();
|
||||
|
||||
// 启用/禁用RFID功能
|
||||
void setEnabled(bool enabled);
|
||||
bool isEnabled() const;
|
||||
|
||||
// 配置
|
||||
void setValidationDelay(int seconds); // 例如，5秒用于卡片稳定性
|
||||
void setSerialPort(const QString& port); // 例如，"/dev/ttyAS1"
|
||||
void setBaudRate(int baudRate); // 例如，9600
|
||||
|
||||
// 数据访问
|
||||
QString getLastCardData() const;
|
||||
bool isCardPresent() const;
|
||||
|
||||
signals:
|
||||
// 通知外部卡片检测到
|
||||
void cardDetected(QString cardType); // cardType: 'A', 'B', 'C' 等
|
||||
|
||||
private:
|
||||
// 私有方法
|
||||
void readRFIDData();
|
||||
void validateCardPresence();
|
||||
|
||||
// 成员变量
|
||||
bool m_enabled;
|
||||
int m_validationDelay; // 以秒为单位
|
||||
QString m_serialPort;
|
||||
int m_baudRate;
|
||||
QString m_lastCardData;
|
||||
bool m_cardPresent;
|
||||
int m_stableCount; // 验证延迟计数器
|
||||
QString m_previousCardData; // 检测卡片变化
|
||||
|
||||
// 依赖项（内部注入或创建）
|
||||
DevOp* m_devOp; // 用于串口通信
|
||||
};
|
||||
```
|
||||
|
||||
### 关键方法
|
||||
|
||||
- **`initialize()`**：设置串口通信并初始化参数。固定串口名为"/dev/ttyAS1"，比特率9600等
|
||||
- **`processRFID()`**：主方法，在定时器循环中调用。读取数据、验证卡片存在，如果验证通过则发射`cardDetected`信号。
|
||||
- **`setEnabled(bool)`**：RFID功能的运行时切换。
|
||||
- **`setValidationDelay(int)`**：配置卡片验证延迟（例如，5秒）。
|
||||
- **`readRFIDData()`**：与`DevOp`接口读取串口数据。
|
||||
- **`validateCardPresence()`**：通过计数连续稳定读取实现延迟逻辑，如果延迟满足则发射信号。
|
||||
|
||||
## 集成计划
|
||||
|
||||
### 步骤1：创建RFIDManager类
|
||||
|
||||
- 在项目源目录中创建`RFIDManager.h`和`RFIDManager.cpp`。
|
||||
- 按照上述大纲实现类。
|
||||
|
||||
### 步骤2：在InkJetPrinter.cpp中替换宏使用
|
||||
|
||||
- 在`InkJetPrinter.cpp`中移除`#ifdef __RFID_CARD`块。
|
||||
- 将`RFIDManager`实例添加为成员变量。
|
||||
- 在构造函数中初始化`RFIDManager`，并连接信号到槽函数。
|
||||
- 在`timerHandler()`中，将RFID逻辑替换为调用`rfidManager.processRFID()`。
|
||||
- 添加槽函数（如`onCardDetected(QString cardType)`）来处理卡片检测逻辑，包括显示对话框和更新参数。
|
||||
|
||||
在`InkJetPrinter.cpp`中的示例更改：
|
||||
|
||||
```cpp
|
||||
// 在构造函数中
|
||||
rfidManager = new RFIDManager(this);
|
||||
connect(rfidManager, &RFIDManager::cardDetected, this, &InkJetPrinter::onCardDetected);
|
||||
|
||||
// 在timerHandler中
|
||||
if (rfidManager->isEnabled()) {
|
||||
rfidManager->processRFID();
|
||||
}
|
||||
|
||||
// 新增槽函数
|
||||
void InkJetPrinter::onCardDetected(QString cardType) {
|
||||
// 处理卡片逻辑：显示对话框、更新SysPara等
|
||||
if (cardType == "A") {
|
||||
// 处理墨卡
|
||||
} else if (cardType == "B") {
|
||||
// 处理维护卡
|
||||
} else if (cardType == "C") {
|
||||
// 处理其他卡
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 步骤3：更新DevOp.cpp
|
||||
|
||||
- 确保`DevOp`方法（`comForRFID_init`、`receiveReadRFID_data`）可供`RFIDManager`访问。
|
||||
- 可能使`DevOp`成为单例，或通过依赖注入将其传递给`RFIDManager`。
|
||||
|
||||
### 步骤4：更新SysPara.h
|
||||
|
||||
- 确保`RFIDPara_t`可供`RFIDManager`访问以进行参数更新。
|
||||
|
||||
### 步骤5：配置
|
||||
|
||||
- 将RFID设置添加到配置文件或UI中，允许运行时更改启用/禁用和设置延迟。
|
||||
|
||||
### 步骤6：移除宏
|
||||
|
||||
- 完全集成后，从`myinclude.h`中移除`__RFID_CARD`宏并清理任何剩余的条件代码。
|
||||
|
||||
## 验证延迟实现
|
||||
|
||||
为了防止误操作，实现5秒延迟：
|
||||
|
||||
- 跟踪具有相同卡片数据的连续读取。
|
||||
- 仅在~17次稳定读取后发射`cardDetected`信号（300ms * 17 ≈ 5.1秒）。
|
||||
- 如果卡片数据变化或消失，则重置计数器。
|
||||
|
||||
```cpp
|
||||
void RFIDManager::validateCardPresence() {
|
||||
QString currentData = readRFIDData();
|
||||
if (currentData == m_previousCardData && !currentData.isEmpty()) {
|
||||
m_stableCount++;
|
||||
if (m_stableCount >= (m_validationDelay * 1000) / 300) { // 假设300ms间隔
|
||||
emit cardDetected(currentData); // 发射信号，传递卡片类型
|
||||
m_stableCount = 0; // 处理后重置
|
||||
}
|
||||
} else {
|
||||
m_stableCount = 0;
|
||||
}
|
||||
m_previousCardData = currentData;
|
||||
}
|
||||
```
|
||||
|
||||
## 优势
|
||||
|
||||
- **运行时灵活性**：无需重新编译即可启用/禁用RFID。
|
||||
- **更清洁的代码**：逻辑中无预处理器指令混乱。
|
||||
- **更好的测试**：为单元测试模拟`RFIDManager`。
|
||||
- **模块化**：更容易扩展或修改RFID功能。
|
||||
- **错误处理**：RFID操作的集中错误处理。
|
||||
|
||||
## 潜在挑战
|
||||
|
||||
- **依赖注入**：确保`DevOp`和`SysPara`正确注入或可访问。
|
||||
- **线程安全**：如果从定时器调用`processRFID()`，确保线程安全。
|
||||
- **向后兼容性**：彻底测试以确保功能无回归。
|
||||
|
||||
## 测试计划
|
||||
|
||||
- `RFIDManager`方法的单元测试。
|
||||
- 与`InkJetPrinter`的集成测试。
|
||||
- 使用实际RFID硬件的手动测试，以验证延迟和检测。
|
||||
|
||||
## 时间表
|
||||
|
||||
1. **第1周**：设计并实现`RFIDManager`类。
|
||||
2. **第2周**：集成到`InkJetPrinter.cpp`并测试。
|
||||
3. **第3周**：更新配置并移除宏。
|
||||
4. **第4周**：全面测试和文档。
|
||||
|
||||
# RFIDManager 实现方案
|
||||
|
||||
## 概述
|
||||
|
||||
当前项目中的RFID功能通过`__RFID_CARD`宏控制，该宏通过条件编译启用或禁用RFID相关代码。这种方法在可维护性、测试和运行时灵活性方面存在局限。为了解决这些问题，我们建议引入`RFIDManager`类，该类封装所有RFID操作，提供更清洁、更模块化的设计。
|
||||
|
||||
`RFIDManager`将处理RFID初始化、数据读取和验证，仅通过QT信号通知外部卡片检测事件，让外部组件（如InkJetPrinter）负责具体的处理逻辑，替换代码库中分散的`#ifdef __RFID_CARD`块。
|
||||
|
||||
## 目标
|
||||
|
||||
- **封装**：将RFID逻辑集中到一个类中。
|
||||
- **运行时控制**：允许在运行时而不是编译时启用/禁用RFID功能。
|
||||
- **可维护性**：通过移除预处理器指令简化代码。
|
||||
- **可扩展性**：更容易添加新RFID功能或修改现有功能。
|
||||
- **测试**：无需重新编译即可对RFID组件进行单元测试。
|
||||
|
||||
## 类设计
|
||||
|
||||
### RFIDManager 类
|
||||
|
||||
```cpp
|
||||
class RFIDManager : public QObject {
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
RFIDManager(QObject* parent = nullptr);
|
||||
~RFIDManager();
|
||||
|
||||
// 初始化
|
||||
bool initialize();
|
||||
|
||||
// 主处理循环（定期调用，例如每300ms）
|
||||
void processRFID();
|
||||
|
||||
// 启用/禁用RFID功能
|
||||
void setEnabled(bool enabled);
|
||||
bool isEnabled() const;
|
||||
|
||||
// 配置
|
||||
void setValidationDelay(int seconds); // 例如，5秒用于卡片稳定性
|
||||
void setSerialPort(const QString& port); // 例如，"/dev/ttyAS1"
|
||||
void setBaudRate(int baudRate); // 例如，9600
|
||||
|
||||
// 数据访问
|
||||
QString getLastCardData() const;
|
||||
bool isCardPresent() const;
|
||||
|
||||
signals:
|
||||
// 通知外部卡片检测到
|
||||
void cardDetected(QString cardType); // cardType: 'A', 'B', 'C' 等
|
||||
|
||||
private:
|
||||
// 私有方法
|
||||
void readRFIDData();
|
||||
void validateCardPresence();
|
||||
|
||||
// 成员变量
|
||||
bool m_enabled;
|
||||
int m_validationDelay; // 以秒为单位
|
||||
QString m_serialPort;
|
||||
int m_baudRate;
|
||||
QString m_lastCardData;
|
||||
bool m_cardPresent;
|
||||
int m_stableCount; // 验证延迟计数器
|
||||
QString m_previousCardData; // 检测卡片变化
|
||||
|
||||
// 依赖项（内部注入或创建）
|
||||
DevOp* m_devOp; // 用于串口通信
|
||||
};
|
||||
```
|
||||
|
||||
### 关键方法
|
||||
|
||||
- **`initialize()`**：设置串口通信并初始化参数。固定串口名为"/dev/ttyAS1"，比特率9600等
|
||||
- **`processRFID()`**：主方法，在定时器循环中调用。读取数据、验证卡片存在，如果验证通过则发射`cardDetected`信号。
|
||||
- **`setEnabled(bool)`**：RFID功能的运行时切换。
|
||||
- **`setValidationDelay(int)`**：配置卡片验证延迟（例如，5秒）。
|
||||
- **`readRFIDData()`**：与`DevOp`接口读取串口数据。
|
||||
- **`validateCardPresence()`**：通过计数连续稳定读取实现延迟逻辑，如果延迟满足则发射信号。
|
||||
|
||||
## 集成计划
|
||||
|
||||
### 步骤1：创建RFIDManager类
|
||||
|
||||
- 在项目源目录中创建`RFIDManager.h`和`RFIDManager.cpp`。
|
||||
- 按照上述大纲实现类。
|
||||
|
||||
### 步骤2：在InkJetPrinter.cpp中替换宏使用
|
||||
|
||||
- 在`InkJetPrinter.cpp`中移除`#ifdef __RFID_CARD`块。
|
||||
- 将`RFIDManager`实例添加为成员变量。
|
||||
- 在构造函数中初始化`RFIDManager`，并连接信号到槽函数。
|
||||
- 在`timerHandler()`中，将RFID逻辑替换为调用`rfidManager.processRFID()`。
|
||||
- 添加槽函数（如`onCardDetected(QString cardType)`）来处理卡片检测逻辑，包括显示对话框和更新参数。
|
||||
|
||||
在`InkJetPrinter.cpp`中的示例更改：
|
||||
|
||||
```cpp
|
||||
// 在构造函数中
|
||||
rfidManager = new RFIDManager(this);
|
||||
connect(rfidManager, &RFIDManager::cardDetected, this, &InkJetPrinter::onCardDetected);
|
||||
|
||||
// 在timerHandler中
|
||||
if (rfidManager->isEnabled()) {
|
||||
rfidManager->processRFID();
|
||||
}
|
||||
|
||||
// 新增槽函数
|
||||
void InkJetPrinter::onCardDetected(QString cardType) {
|
||||
// 处理卡片逻辑：显示对话框、更新SysPara等
|
||||
if (cardType == "A") {
|
||||
// 处理墨卡
|
||||
} else if (cardType == "B") {
|
||||
// 处理维护卡
|
||||
} else if (cardType == "C") {
|
||||
// 处理其他卡
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 步骤3：更新DevOp.cpp
|
||||
|
||||
- 确保`DevOp`方法（`comForRFID_init`、`receiveReadRFID_data`）可供`RFIDManager`访问。
|
||||
- 可能使`DevOp`成为单例，或通过依赖注入将其传递给`RFIDManager`。
|
||||
|
||||
### 步骤4：更新SysPara.h
|
||||
|
||||
- 确保`RFIDPara_t`可供`RFIDManager`访问以进行参数更新。
|
||||
|
||||
### 步骤5：配置
|
||||
|
||||
- 将RFID设置添加到配置文件或UI中，允许运行时更改启用/禁用和设置延迟。
|
||||
|
||||
### 步骤6：移除宏
|
||||
|
||||
- 完全集成后，从`myinclude.h`中移除`__RFID_CARD`宏并清理任何剩余的条件代码。
|
||||
|
||||
## 验证延迟实现
|
||||
|
||||
为了防止误操作，实现5秒延迟：
|
||||
|
||||
- 跟踪具有相同卡片数据的连续读取。
|
||||
- 仅在~17次稳定读取后发射`cardDetected`信号（300ms * 17 ≈ 5.1秒）。
|
||||
- 如果卡片数据变化或消失，则重置计数器。
|
||||
|
||||
```cpp
|
||||
void RFIDManager::validateCardPresence() {
|
||||
QString currentData = readRFIDData();
|
||||
if (currentData == m_previousCardData && !currentData.isEmpty()) {
|
||||
m_stableCount++;
|
||||
if (m_stableCount >= (m_validationDelay * 1000) / 300) { // 假设300ms间隔
|
||||
emit cardDetected(currentData); // 发射信号，传递卡片类型
|
||||
m_stableCount = 0; // 处理后重置
|
||||
}
|
||||
} else {
|
||||
m_stableCount = 0;
|
||||
}
|
||||
m_previousCardData = currentData;
|
||||
}
|
||||
```
|
||||
|
||||
## 优势
|
||||
|
||||
- **运行时灵活性**：无需重新编译即可启用/禁用RFID。
|
||||
- **更清洁的代码**：逻辑中无预处理器指令混乱。
|
||||
- **更好的测试**：为单元测试模拟`RFIDManager`。
|
||||
- **模块化**：更容易扩展或修改RFID功能。
|
||||
- **错误处理**：RFID操作的集中错误处理。
|
||||
|
||||
## 潜在挑战
|
||||
|
||||
- **依赖注入**：确保`DevOp`和`SysPara`正确注入或可访问。
|
||||
- **线程安全**：如果从定时器调用`processRFID()`，确保线程安全。
|
||||
- **向后兼容性**：彻底测试以确保功能无回归。
|
||||
|
||||
## 测试计划
|
||||
|
||||
- `RFIDManager`方法的单元测试。
|
||||
- 与`InkJetPrinter`的集成测试。
|
||||
- 使用实际RFID硬件的手动测试，以验证延迟和检测。
|
||||
|
||||
## 时间表
|
||||
|
||||
1. **第1周**：设计并实现`RFIDManager`类。
|
||||
2. **第2周**：集成到`InkJetPrinter.cpp`并测试。
|
||||
3. **第3周**：更新配置并移除宏。
|
||||
4. **第4周**：全面测试和文档。
|
||||
|
||||
此方案为将RFID功能重构为更可维护和灵活的系统提供了坚实基础。
|
||||
Reference in New Issue
Block a user