CycloneDDS 架构分析

最新推荐文章于 2025-12-25 10:41:03 发布

原创最新推荐文章于 2025-12-25 10:41:03 发布 · 置顶 · 526 阅读

11 ·

CC 4.0 BY-SA版权

文章标签：

#自动驾驶 #人工智能 #中间件 #DDS

AI 同时被 3 个专栏收录

22 篇文章

订阅专栏

中间件

14 篇文章

订阅专栏

DDS

3 篇文章

订阅专栏

团队博客: 汽车电子社区

1. 项目概述

1.1 基本信息

- 项目名称: CycloneDDS
- 维护组织: Eclipse Foundation
- 开源许可: EPL-2.0 OR BSD-3-Clause
- 主要语言: C (C++支持仅限于Iceoryx插件)
- 版本: 0.11.0
- 构建系统: CMake 3.16+

1.2 设计理念

CycloneDDS采用纯C语言实现，追求极致性能和最小资源占用，特别适合嵌入式和实时系统。

2. 整体架构设计

2.1 分层架构

┌─────────────────────────────────────┐
│        DDS用户应用程序层              │
├─────────────────────────────────────┤
│         DDSC C API层                 │
├─────────────────────────────────────┤
│        DDSI-RTPS协议层               │
├─────────────────────────────────────┤
│         DDSR运行时库                  │
├─────────────────────────────────────┤
│         传输层/操作系统层             │
└─────────────────────────────────────┘

2.2 目录结构分析

src/
├── core/                    # 核心实现
│   ├── cdr/                # CDR序列化支持 (258.85KB)
│   ├── ddsc/               # C API实现
│   │   └── include/dds/dds.h  # 统一API入口
│   └── ddsi/               # DDSI-RTPS协议实现
│       ├── ddsi_init.c         # 系统初始化 (2028行)
│       ├── ddsi_receive.c      # 消息接收处理 (143.96KB)
│       ├── ddsi_transmit.c     # 消息发送处理 (36.51KB)
│       ├── ddsi_security_omg.c # 安全实现 (162.52KB)
│       └── ddsi_typewrap.c     # 类型系统 (144.53KB)
├── ddsrt/                  # DDS运行时库
├── idl/                    # IDL编译器
├── security/               # 安全模块
├── tools/                  # 工具集
└── ucunit/                 # 单元测试框架

3. 核心模块详细分析

3.1 DDSC API层 (`src/core/ddsc/`)

主要接口设计

// 核心API定义 (dds/dds.h - 5191行)
typedef struct dds_entity dds_entity_t;

// 域管理
dds_entity_t dds_create_participant (uint32_t domain, const dds_qos_t *qos, const dds_listener_t *listener);

// 发布订阅管理
dds_entity_t dds_create_publisher (dds_entity_t participant, const dds_qos_t *qos, const dds_listener_t *listener);
dds_entity_t dds_create_subscriber (dds_entity_t participant, const dds_qos_t *qos, const dds_listener_t *listener);

// 主题管理
dds_entity_t dds_create_topic (dds_entity_t participant, const char *name, const dds_topic_descriptor_t *descriptor, const dds_qos_t *qos, const dds_listener_t *listener);

// 读写器管理
dds_entity_t dds_create_writer (dds_entity_t publisher, dds_entity_t topic, const dds_qos_t *qos, const dds_listener_t *listener);
dds_entity_t dds_create_reader (dds_entity_t subscriber, dds_entity_t topic, const dds_qos_t *qos, const dds_listener_t *listener);

设计特点
- 统一接口: 所有DDS实体通过dds_entity_t统一管理
- QoS支持: 完整的QoS策略支持
- 监听器机制: 事件驱动的回调处理
- 错误处理: 统一的错误码和状态管理

3.2 DDSI协议层 (`src/core/ddsi/`)

初始化模块 (ddsi_init.c - 2028行)

// 核心初始化流程
static void ddsi_init_thread (struct ddsi_domaingv *gv)
{
    // 网络配置初始化
    // 安全组件初始化
    // 线程池创建
    // 定时器系统启动
}

// 域参与者创建
dds_return_t ddsi_create_participant (struct ddsi_domaingv *gv, const struct ddsi_guid *guid)

消息接收处理 (ddsi_receive.c - 143.96KB)

// 核心接收循环
static void ddsi_recv_thread (struct ddsi_domaingv *gv)
{
    while (!gv->terminate)
    {
        // 网络消息接收
        // 消息解析和路由
        // 状态机更新
        // 应用层数据分发
    }
}

// 消息分发逻辑
static void ddsi_handle_data_msg (struct ddsi_domaingv *gv, const struct ddsi_msg_header *msg)

消息发送处理 (ddsi_transmit.c - 36.51KB)

// 高性能发送实现
dds_return_t ddsi_write_sample (struct ddsi_writer *wr, const struct ddsi_serdata *serdata)
{
    // 数据序列化
    // QoS过滤
    // 目标端点选择
    // 批量发送优化
}

3.3 序列化模块 (`src/core/cdr/`)

CDR流处理 (dds_cdrstream.c - 258.85KB)

// 高效的CDR序列化实现
size_t dds_cdr_serialize (const void *data, size_t size, dds_ostream_t *os)
{
    // 大端/小端处理
    // 对齐优化
    // 内存预分配
}

// 动态类型支持
dds_return_t dds_cdr_deserialize_type (dds_istream_t *is, void **data)

4. 调用流程分析

4.1 数据发布流程

应用程序调用
    ↓
dds_write()
    ↓
ddsc_write_sample()
    ↓
ddsi_write_sample()
    ↓
ddsi_transmit_sample()
    ↓
网络发送

4.2 数据订阅流程

网络接收
    ↓
ddsi_receive_thread()
    ↓
ddsi_handle_data_msg()
    ↓
ddsi_deliver_data()
    ↓
ddsc_deliver_sample()
    ↓
应用程序回调

4.3 发现流程

域创建
    ↓
ddsi_init_discovery()
    ↓
SPDP/GUIDPrefix发现
    ↓
SEDP端点发现
    ↓
匹配建立
    ↓
数据通信

5. 关键算法实现

5.1 发现算法

- SPDP (Simple Participant Discovery Protocol): 参与者发现
- SEDP (Simple Endpoint Discovery Protocol): 端点发现
- 实现位置: ddsi_discovery.c

5.2 可靠性算法

- 心跳机制: ddsi_heartbeat.c
- ACK/NACK处理: ddsi_acknack.c
- 重传策略: ddsi_retransmit.c

5.3 安全实现

- 认证: ddsi_security_omg.c (162.52KB)
- 加密: 集成OpenSSL
- 访问控制: 完整的权限管理

6. 性能优化特性

6.1 内存管理

- 零拷贝: 关键路径避免数据拷贝
- 内存池: 预分配内存减少malloc/free
- 对齐优化: 结构体缓存行对齐

6.2 网络优化

- 批量发送: 聚合小消息减少系统调用
- 零拷贝网络: 直接内存映射到网卡
- 异步I/O: 非阻塞网络操作

6.3 并发设计

- 无锁数据结构: 关键路径避免锁竞争
- 线程池: 专用网络处理线程
- 原子操作: 状态更新使用原子操作

7. 构建系统分析

7.1 CMake配置

# 主要选项
option(BUILD_DDSI2 "Build the ddsi2 service" ON)
option(BUILD_SECURITY "Build with security support" ON)
option(BUILD_SHARED_LIBS "Build shared libraries" ON)
option(BUILD_TESTING "Build tests" ON)