---
tags: 
title: 项目交接文档：软件定义雷达前端模拟器 (SDR-FES)
date created: 星期六, 十一月 29日 2025, 10:14:41 晚上
date modified: 星期四, 十二月 4日 2025, 8:30:07 晚上
---

这份文档经过了严格修订，完全聚焦于 **" 雷达前端模拟器 (MockDACS)"** 这一工具本身的构建与演进。它强调了工具的**通用性、可移植性**以及**现代软件工程标准**。

请保存此文档，在新对话开始时直接发送。

---

# 项目交接文档：软件定义雷达前端模拟器 (SDR-FES)

**Project Handover: Software-Defined Radar Front-End Simulator (MockDACS)**

## 1. 项目目标 (Project Goal)

构建一个**高可移植、高性能、容器化**的雷达前端模拟工具。

该工具不依赖特定的硬件架构（如飞腾/天数），旨在通过 Docker 容器在任何支持 Linux 的环境（x86/ARM）中运行。它作为标准的**测试信号发生器**，用于向后端信号处理系统提供符合 **FES-SPS v2.1 协议** 的 10Gbps 线速数据流，验证后端系统的协议栈鲁棒性与吞吐能力。

## 2. 当前进度状态 (Current Status)

- **工程阶段**：
    - **Phase 1-3 (完成)**：已实现基础 UDP 收发、多线程并发、CPU 亲和性绑定、自旋锁高精度控速。
    - **Phase 4 (进行中)**：已集成故障注入引擎 (`ChaosEngine`)，正在验证 Docker 环境下的故障注入（丢包/误码/乱序）效果。
- **部署状态**：已完成 Docker 化封装。验证了在容器内通过 `cpus: 2.0` 限制下，依然能跑满 2000Hz PRF，且多站多线程逻辑正常。

## 3. 技术基线与需求快照 (Technical Baseline & Requirements)

### A. 运行环境 (Environment - Portable)

- **核心理念**：**Docker First**。无论是开发本机的 WSL/Mac，还是部署端的服务器，均通过容器抹平差异。
- **架构支持**：`linux/amd64` (x86_64) & `linux/arm64` (aarch64)。
- **网络依赖**：支持 Host 模式或 Bridge 模式下的 UDP 通信，依赖 **Jumbo Frame (MTU 9000)** 以实现最高性能。

### B. 通信协议 (v2.1 Implementation)

- **帧结构**：`Magic="RADR"` + Big-Endian Header + Little-Endian Payload + **CRC32c 校验**。
- **时序**：**TAI 时间戳** + 16-bit 对齐载荷。
- **策略**：数据流 Fire-and-Forget，控制流 K-Redundancy。

### C. 模拟器架构 (Architecture)

- **核心机制**：多线程 (Multi-thread) + 忙等待 (Busy Wait) + 零拷贝 (Zero-Copy)。
- **设计原则 (新增)**：
    - **现代化**：强制使用 **C++17/20** 标准。
    - **模块化**：发送逻辑、协议封装、物理仿真、配置管理必须解耦。
    - **配置驱动**：一切可变参数（IP/端口/速率/故障率）严禁硬编码。

## 4. 新对话启动所需资料 (Materials Required)

为了确保新会话能无缝接手代码开发，请提供以下**文件内容**或**目录结构**：

1. **工程配置文件**:
    - `CMakeLists.txt` (Root)
    - `common/CMakeLists.txt`
    - `simulator/CMakeLists.txt`
    - `tools/CMakeLists.txt`
    - `Dockerfile` & `docker-compose.yml`
2. **核心源码**:
    - `common/include/protocol.h` (v2.1 协议定义)
    - `common/include/chaos.h` (故障注入引擎)
    - `common/include/utils.h` (计时与绑核工具)
    - `simulator/sender.cpp` (当前的发送端实现)
    - `tools/receiver.cpp` (当前的接收验证端实现)
3. **参考文档 (可选)**:
    - `[非密]前端感知软件数据表V0.1.docx` (原始协议参考)
    - `软件数据表评估报告生成.pdf` (协议升级依据)

## 5. 下一步工作计划 (Next Steps - Simulator Focus)

在接下来的对话中，我们将**仅聚焦于模拟器本身的完善与增强**：

1. **Phase 4 收尾**：
    - 检查 Docker 下 `receiver` 的日志，确认故障注入（DACS-2/3）的效果是否符合预期，完成鲁棒性验证闭环。
2. **Phase 5：配置系统重构 (Configuration System)**：
    - 引入 `yaml-cpp`。
    - 实现**全动态配置**：通过 YAML 文件动态调节 PRF（速率）、目标 IP、波位参数、故障概率，无需重新编译。
3. **Phase 6：数据回放功能 (Data Replay - 后期)**：
    - 开发**数据库适配层**。
    - 实现从实际雷达录制的数据库文件（如 HDF5/PCAP/Bin）中读取数据，并严格按照指定的时间戳间隔（Rate Control）发送，用于算法的高级回放测试。
4. **架构重构 (Modernization)**：
    - 应用**设计模式**（如策略模式 Strategy Pattern 用于切换数据源：`SyntheticSource` vs `ReplaySource`）。
    - 确保代码具备极高的可读性与可扩展性。

---

**提示词 (Prompt) 建议：**

> " 我是之前的用户。我们正在开发一个高可移植的 Docker 化雷达前端模拟器 (MockDACS)。目前已完成 v2.1 协议的基础实现和故障注入功能。请阅读我上传的 ' 交接文档 ' 和源码。接下来的任务是验证故障注入效果，并引入 YAML 配置系统来实现参数的动态调节。"