Renesas RZN2_EtherCAT_CiA402_CR52 SSC Config

Renesas 官方 EtherCAT CiA402 示例配置 (RZN2_EtherCAT_CiA402_CR52)

来源: Renesas 官方 EtherCAT CiA402 示例工程（RZN2 评估套件）
目标平台: RZN2 (Cortex-R52)
工具: SSC Tool (Slave Stack Code Tool)
整理日期: 2026-06-13

目录

1. SlaveInformation（从站信息）
2. Generic（通用配置）
3. Hardware（硬件配置）
4. EtherCAT State Machine（状态机配置）
5. Synchronisation（同步配置）
6. Application（应用层配置）
7. ProcessData（过程数据配置）
8. Mailbox（邮箱配置）
9. 附录A：ESC 内存布局
10. 附录B：ESC_16BIT_ACCESS 与 ESC_32BIT_ACCESS 配置分析

1. SlaveInformation（从站信息）

2. Generic（通用配置）

3. Hardware（硬件配置）

注意: 该Hardware节点显示的是精简参数列表（Renesas定制版SSC Tool），与标准SSC Tool的完整参数列表不同。其中 ESC_16BIT_ACCESS 和 ESC_32BIT_ACCESS 均为 0 的原因详见 附录B。

4. EtherCAT State Machine（状态机配置）

5. Synchronisation（同步配置）

6. Application（应用层配置）

7. ProcessData（过程数据配置）

8. Mailbox（邮箱配置）

8.1 协议支持

8.2 缓冲区配置

附录A：ESC 内存布局

0x1000 ~ 0x10FF  SM0 邮箱输出 (Master→Slave)  256字节
0x1100 ~ 0x11FF  SM1 邮箱输入 (Slave→Master)  256字节
0x1200 ~ ...     SM2 过程数据输出 (PDO Output) 默认起始
0x1500 ~ ...     SM3 过程数据输入 (PDO Input)  默认起始

附录B：ESC_16BIT_ACCESS 与 ESC_32BIT_ACCESS 配置分析

B.1 问题的提出

在 3. Hardware（硬件配置） 中，ESC_16BIT_ACCESS 和 ESC_32BIT_ACCESS 都配置为 0，即禁用了 16 位和 32 位的 ESC 寄存器访问。直觉上，32 位访问应该比 8 位逐字节访问更高效，为什么 Renesas 官方示例要禁用它们？

B.2 SSC 配置参数的作用

ESC_16BIT_ACCESS 和 ESC_32BIT_ACCESS 是 Beckhoff SSC Tool 生成的配置参数，影响 SSC 核心层 如何访问 ESC DPRAM：

当两者都为 0 时，SSC 的通用读/写宏最终展开为 ESCMEMCPY，即标准 memcpy：

HW_EscRead(pData, Address, Len)  →  memcpy(pData, &pEsc[Address], Len)
HW_EscWrite(pData, Address, Len) →  memcpy(&pEsc[Address], pData, Len)

B.3 Renesas 硬件访问层的设计

关键文件：renesashw.h

Renesas 在 renesashw.h 中设计了两组互相独立的宏：

第一组：通用访问宏（供 SSC 核心层调用）

#define ESC_MEM_ADDR    UINT8    // 以字节为最小寻址单元
#define ESC_MEM_SHIFT   0        // 地址偏移 = 地址本身（无需右移）

// 读：memcpy(pData, &pEsc[Address], Len)
#define HW_EscRead(pData, Address, Len)   ESCMEMCPY(...)

// 写：memcpy(&pEsc[Address], pData, Len)  
#define HW_EscWrite(pData, Address, Len)  ESCMEMCPY(...)

当 ESC_16BIT_ACCESS = 0 且 ESC_32BIT_ACCESS = 0 时，SSC 核心层的所有数据路径都走这两个宏 → 最终是 memcpy。

第二组：专用寄存器访问宏（供特定场景直接调用）

// 16 位读：将 pEsc 强制转为 UINT16*，地址除以 2（16 位对齐）
#define HW_EscReadWord(WordValue, Address)   \
    ((WordValue) = (((UINT16 *) pEsc)[((Address) >> 1)]))

// 32 位读：将 pEsc 强制转为 UINT32*，地址除以 4（32 位对齐）
#define HW_EscReadDWord(DWordValue, Address) \
    ((DWordValue) = (UINT32) (((UINT32 *) pEsc)[(Address >> 2)]))

// 对应的 16/32 位写宏同理
#define HW_EscWriteWord(WordValue, Address)  ...
#define HW_EscWriteDWord(DWordValue, Address) ...

// 直接读取 AL Event 寄存器（16 位对齐寄存器，地址偏移已硬编码）
#define HW_GetALEventRegister()  \
    ((((UINT16 ESCMEM *) pEsc)[((ESC_AL_EVENT_OFFSET) >> 1)]))

关键结论: 这两组宏完全独立。即使 ESC_16BIT_ACCESS = 0，HW_EscReadWord() 仍然可以正常工作 —— 因为它是直接在 renesashw.h 中定义的，不归 SSC 代码生成器管。

B.4 RZ/N2 的 ESC 硬件连接方式

在 rm_ethercat_ssc_port.c:720-728 中：

UINT16 HW_Init(void)
{
    pEsc = (MEM_ADDR ESCMEM *) p_instance_ctrl->p_reg;
    //                          ^^^^^^^^^^^^^^^^^^
    // p_reg = (R_ESC_Type *) R_ESC_BASE  — ESC 硬件寄存器基地址（直接内存映射）
    return 0;
}

RZ/N2 的 ESC（EtherCAT Slave Controller）集成在芯片内部，ESC DPRAM 直接映射到 MCU 的物理地址空间。这意味着：

• pEsc 就是一个普通的 C 指针，指向 ESC DPRAM 在内存中的起始位置
• memcpy 直接走 MCU 内部总线访问 ESC DPRAM，无需任何 SPI/并行总线中转
• 与通过 SPI 连接的外部 ESC 芯片完全不同，不存在总线宽度限制

B.5 两者均配置为 0 的原因

B.6 反直觉的一点

表面上看，配置 ESC_32BIT_ACCESS = 1 似乎能提升吞吐量。但在 RZ/N2 平台上：

1. SSC 核心层不知道具体哪些 ESC 地址是对齐的，统一使用 32 位访问有风险
2. ESC_16BIT_ACCESS 和 ESC_32BIT_ACCESS 两个标志互相排斥，不能同时启用 —— 当 ESC 寄存器有 8/16/32 位混合对齐时，单一宽度无法覆盖所有场景
3. 实际性能瓶颈不在 DPRAM 的读写宽度，而在 EtherCAT 总线的帧周期（通常 500μs ~ 1ms）

Renesas 选择 「通用路径用 memcpy 保安全，热路径用专用宏提效率」 的策略，两个 SSC 标志全部置 0 是最合理的工程决策。