99 lines
3.9 KiB
Markdown
99 lines
3.9 KiB
Markdown
|
# zcache — 数据缓存与转换服务
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
zcache 是 EIS 系统中的 **实时数据缓存与转换中枢**。它从多个数据源接收原始二进制 PLC 遥测数据，按电文地址映射将原始数据解码为标准化浮点数组，存入共享内存环形缓冲区，供下游服务（eqpalg、zhd 等）直接读取。
|
|||
|
|
|
|||
|
|
## 进程架构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
rcv / zprx / zsub
|
|||
|
|
│
|
|||
|
|
│ ICE SendDataShort(eventNo, rawPLCData)
|
|||
|
|
▼
|
|||
|
|
┌──────────────────────────────────────────┐
|
|||
|
|
│ zcache │
|
|||
|
|
│ │
|
|||
|
|
│ ZcacheICEI::SendDataShort() │
|
|||
|
|
│ │ │
|
|||
|
|
│ ├→ CacheTele(eventNo, seq) │
|
|||
|
|
│ │ └─ 原始字节 → CMemFix<PLC_DATA> │
|
|||
|
|
│ │ 按事件号环形缓存(TEL_CACHE_SIZE=10) │
|
|||
|
|
│ │ │
|
|||
|
|
│ ├→ ConvertTele(eventNo, seq) │
|
|||
|
|
│ │ └─ mv_tele 地址映射 │
|
|||
|
|
│ │ ├─ NORMAL模式: 值×factor │
|
|||
|
|
│ │ └─ BINARY模式: 位提取 │
|
|||
|
|
│ │ → TELTMP 暂存缓冲区 │
|
|||
|
|
│ │ │
|
|||
|
|
│ └→ eventNo==1003: │
|
|||
|
|
│ PutTempTelInCache() │
|
|||
|
|
│ └─ TELTMP → m_mapfix 批量刷新 │
|
|||
|
|
│ │
|
|||
|
|
└──────────────┬───────────────────────────┘
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
共享内存 (GlobMem)
|
|||
|
|
│
|
|||
|
|
┌────────────┼────────────┐
|
|||
|
|
▼ ▼ ▼
|
|||
|
|
eqpalg zhd ztrk
|
|||
|
|
(实时监控) (历史存储) (物料跟踪)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 核心职责
|
|||
|
|
|
|||
|
|
### 1. 数据缓存
|
|||
|
|
|
|||
|
|
- 将到达的原始二进制遥测数据按事件号存入 `CMemFix<PLC_DATA>` 环形缓冲区
|
|||
|
|
- 每个事件号保留最近 10 条消息
|
|||
|
|
|
|||
|
|
### 2. 数据转换 (`ConvertTele`)
|
|||
|
|
|
|||
|
|
根据从 `T_LOV_FDAAITEM` 构建的地址映射表，将原始二进制数据解码：
|
|||
|
|
|
|||
|
|
| 转换模式 | 处理方式 |
|
|||
|
|
|----------|----------|
|
|||
|
|
| NORMAL（普通数值） | 读取源值 × 转换因子 → 目标缓冲区 |
|
|||
|
|
| BINARY（位提取） | 右移指定位 → 与 1 进行 AND 运算 → 布尔/整型 |
|
|||
|
|
|
|||
|
|
支持的数据类型: `float`（浮点）、`int`（整型）、`short`（短整型）、`bool`（布尔）
|
|||
|
|
|
|||
|
|
### 3. 暂存与批量刷新
|
|||
|
|
|
|||
|
|
- `eventNo==1003` 触发批量刷新：将暂存区 `TELTMP` 的全部数据写入各事件号的环形缓冲区 `m_mapfix`
|
|||
|
|
|
|||
|
|
## 数据来源
|
|||
|
|
|
|||
|
|
| 来源服务 | 调用方式 | 数据内容 |
|
|||
|
|
|----------|----------|----------|
|
|||
|
|
| **rcv** | ICE `SendDataShort(eventNo, seq)` | L1 二进制遥测电文 |
|
|||
|
|
| **zprx** | ICE `SendDataShort(eventNo, seq)` | 转发的事件 2000-2010 数据 |
|
|||
|
|
|
|||
|
|
## 数据消费
|
|||
|
|
|
|||
|
|
下游服务**不通过 ICE 调用 zcache**，而是直接读取共享内存中的 `PLC_DATA` 缓冲区：
|
|||
|
|
|
|||
|
|
| 消费者 | 读取内容 |
|
|||
|
|
|--------|----------|
|
|||
|
|
| **eqpalg** | `GlobaltemSharedMemory::cache_data()` 从 PLC_DATA 读取实时值 |
|
|||
|
|
| **zhd** | 从共享内存读取快照写入 iHyperDB |
|
|||
|
|
| **ztrk** | 读取区域跟踪数据 |
|
|||
|
|
|
|||
|
|
## ICE 接口
|
|||
|
|
|
|||
|
|
| 方法 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `SendDataShort(eventNo, seq)` | 核心入口: 缓存 + 转换 raw 数据。eventNo=1002 跳过；eventNo<2000 做转换；eventNo≥2000 仅缓存 |
|
|||
|
|
| `SendDataLong` | 未实现 |
|
|||
|
|
| `TimeNotify` | 未实现 |
|
|||
|
|
|
|||
|
|
## 源文件
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
src/zcache/
|
|||
|
|
├── zcache.cpp # PACE 组件入口
|
|||
|
|
├── ZcacheICEI.cpp # ICE servant: SendDataShort 入口
|
|||
|
|
└── CacheMag.cpp # 核心: 地址映射、数据缓存、类型转换
|
|||
|
|
```
|