跳到主要内容

从站分组

从站分组功能允许将从站分配到不同的组 (0-7)，每组可配置独立的 PDO 周期分频器，实现不同组以不同频率交换数据。

典型应用场景：

  • 伺服驱动（组0）：默认组，每周期发送，31.25us 32KHz
  • IO 模块（组1）：每4周期发送一次，125us 8000Hz
  • 传感器（组2）：每6400周期发送一次，200ms 5Hz
核心简化
  • 无需手动启用组 — 系统在进入 SafeOp 时自动启用有从站的组，禁用空组
  • 属性式分频器 — 通过 set_group_cycle_divider() 直接设置
  • 每组独立收发 — 每个组对应独立的 PDO 数据报文

快速开始​

let mut master = EtherCATMaster::from_json_file("config.json")?;

// 1. 分配从站到组（必须在 SAFE_OP 之前）
// slave 1~2 不设置，保持 group=0（默认组，每周期发送）
master.slave(3).set_group(1);  // IO 模块 -> 组1
master.slave(4).set_group(1);
master.slave(5).set_group(2);  // 传感器 -> 组2

// 2. 设置组分频器
master.set_group_cycle_divider(1, 4);   // 组1: 每4周期发送
master.set_group_cycle_divider(2, 10);  // 组2: 每10周期发送
// 组0 默认分频器=1，无需额外设置

// 3. 切换到 OP — 系统自动启用有从站的组
master.set_state(EcState::Operational)?;

// 4. 查询组信息
println!("组1: {} 个从站", master.group_slave_count(1));
println!("组2: {} 个从站", master.group_slave_count(2));

组语义​

组号含义
0默认组 — 未显式分组的从站自动归入此组
1-7显式分组 — 用户手动分配，组号无需连续
备注
  • 有效组范围为 0-7（共 8 组），每个组独立收发 PDO 数据
  • 组号可以不连续（如 1, 3, 5），系统会跳过空组
  • 进入 SafeOp 时自动启用有从站的组，禁用空组

从站组分配​

slave.group() / slave.set_group()​

pub fn group(&self) -> u8
pub fn set_group(&self, group: u8) -> Result<()>

获取或设置从站的组归属 (0-7)。必须在 SAFE_OP 之前设置。

示例:

// 分配从站到组
master.slave(1).set_group(1);  // 显式分到组1
master.slave(2).set_group(2);  // 显式分到组2
// master.slave(3) 不设置，保持 0（默认组）

// 读取从站所在组
let group = master.slave(1).group();

group_slave_count()​

pub fn group_slave_count(&self, group: u8) -> u16

获取组内从站数量。

active_group_count()​

pub fn active_group_count(&self) -> u8

获取活跃组数量（扫描从站集合计算）。

group_expected_wkc()​

pub fn group_expected_wkc(&self, group: u8) -> u16

获取组的期望 WKC。

组分频器​

set_group_cycle_divider()​

pub fn set_group_cycle_divider(&self, group: u8, divider: u8) -> bool

设置组的 PDO 周期分频器 (1-255)。

  • 1 — 每周期发送 (1000Hz，主周期 1ms 时)
  • 2 — 每2周期发送 (500Hz)
  • 4 — 每4周期发送 (250Hz)
  • 10 — 每10周期发送 (100Hz)

示例:

// 设置分频器
master.set_group_cycle_divider(1, 4);   // 组1: 每4周期
master.set_group_cycle_divider(2, 10);  // 组2: 每10周期
// 组0 默认分频器=1（每周期），无需设置

set_group_enabled()​

pub fn set_group_enabled(&self, group: u8, enabled: bool) -> bool

启用或禁用组。通常无需手动调用，系统在进入 SafeOp 时自动管理。

自动启用/禁用​

进入 SafeOp 状态时，系统自动扫描每个组 (0-7) 是否有从站：

  • 有从站的组 -> 自动启用，确保分频器至少为 1
  • 空组 -> 自动禁用，跳过 PDO 收发

无需手动调用 set_group_enabled()，组号也无需连续。

组诊断​

每组独立跟踪 PDO 丢帧统计。

按组查询丢帧​

// 查询指定组的丢帧统计
let stats = master.diagnostics_info().pdo().frame_loss_stats(1);
println!("组1: 累计丢帧={}, 连续={}", stats.total_lost, stats.consecutive_lost);

let stats2 = master.diagnostics_info().pdo().frame_loss_stats(2);
println!("组2: 累计丢帧={}", stats2.total_lost);

PDOFrameLoss 事件​

PDO 连续丢帧事件的 group 参数标识哪个组发生了丢帧：

master.events().on_pdo_frame_loss(|_, group, consecutive, total| {
    println!("组 {} 丢帧: 连续={}, 累计={}", group, consecutive, total);

    if group == 0 {
        // 伺服组丢帧，紧急处理
        println!("警告: 伺服组通信异常！");
    }
});

配置时序​

INIT -> PRE_OP -> SAFE_OP -> OP
  |        |         |
  |        |         +- 组配置已锁定，PDO 开始按组发送
  |        |
  |        +- 设置从站组归属: slave.set_group(n)
  |           设置组分频器: set_group_cycle_divider(n, divider)
  |           （进入 SafeOp 时自动启用有从站的组）
  |
  +- 初始化主站
警告
  • slave.set_group() 在进入 SAFE_OP 时生效
  • 组分频器建议在初始化之后、set_state(Operational) 之前设置
  • 进入 SAFE_OP 后组配置自动锁定

完整示例​

let mut master = EtherCATMaster::from_json_file("config.json")?;

// 1. 分配从站到组
// slave 1~3 不设置，保持 group=0（伺服驱动，默认组）
for i in 4..=5 {
    master.slave(i).set_group(1);      // 后2个从站 -> 组1（IO模块）
}
// 其余从站保持 group=0（默认组，每周期发送）

// 2. 设置组分频器
master.set_group_cycle_divider(1, 4);   // 组1: 250Hz
// 组0 默认分频器=1（1000Hz），无需设置

// 3. 周期
master.config().set_loop_cycle(1_000_000);      // 1ms

// 4. PDO 丢帧监控（每组独立）
master.events().on_pdo_frame_loss(|_, group, consecutive, _| {
    println!("组 {} 丢帧: 连续={}", group, consecutive);
});

// 5. 启动 — 自动启用有从站的组
master.set_state(EcState::Operational)?;

// 6. 查看组状态
println!("活跃组: {}", master.active_group_count());
println!("组0: {} 个从站", master.group_slave_count(0));
println!("组1: {} 个从站", master.group_slave_count(1));

// 7. 周期回调
master.events().on_pdo_cyclic_async(|_| {
    // 读写 PDO 数据
});