枚举的使用
com.darra.ethercat.data.EcState

使用EcState的程序包

程序包	说明
com.darra.ethercat.data
com.darra.ethercat.master
com.darra.ethercat.slave
com.darra.ethercat.statics
com.darra.ethercat.sugar

com.darra.ethercat.data中EcState的使用

返回EcState的com.darra.ethercat.data中的方法

修饰符和类型	方法	说明
EcState	EcState.Status.baseState()	获取基础状态 (低 4 位, 不含 Error 标志)
static EcState	EcState.fromValue(int val)	从数值转换为基础状态枚举 (**不保留 Error 位**, 仅返回低 4 位对应的基础状态).
EcState	EcatSlaveDiag.EcAlStatusMirror.getAlState()	AL State 基础枚举 (低字节低 4 位, 不含 Error 标志)
static EcState	EcState.valueOf(String name)	返回带有指定名称的该类型的枚举常量。
static EcState[]	EcState.values()	返回包含该枚举类型的常量的数组， 顺序与声明这些常量的顺序相同

com.darra.ethercat.master中EcState的使用

返回EcState的com.darra.ethercat.master中的方法

修饰符和类型	方法	说明
EcState	State.getState()	获取当前主站 EtherCAT 状态
EcState	EtherCATMaster.State()	获取主站 EtherCAT 状态 (C# State 对应)

参数类型为EcState的com.darra.ethercat.master中的方法

修饰符和类型	方法	说明
static int	State.getStateLevel(EcState state)	获取状态级别 (用于比较状态优先级)
static boolean	State.isStateCompatible(EcState current, EcState required)	判断当前状态是否满足要求
void	MasterEvents.SlaveStateChangedListener.onSlaveStateChanged(short masterIndex, short slaveIndex, EcState oldState, EcState newState)
void	MasterEvents.StateChangedListener.onStateChanged(EcState oldState, EcState newState)
boolean	EtherCATMaster.setState(EcState state)	切换 EtherCAT 主站状态.
boolean	State.setState(EcState targetState)	设置主站状态 (阻塞, 等待转换完成)
void	EtherCATMaster.SetState(EcState targetState)	设置主站状态 (C# SetState 对应)
CompletableFuture<Boolean>	EtherCATMaster.setStateAsync(EcState state)	异步版 setState, 不阻塞调用线程.
CompletableFuture<Boolean>	EtherCATMaster.setStateAsync(EcState state, Consumer<String> progress)	异步版 setState (带进度回调), 不阻塞调用线程, 经主站串行闸排队隔离。
boolean	State.setStateSequence(EcState targetState, int timeoutMs)	顺序设置主站状态 (INIT → PREOP → SAFEOP → OP)
boolean	State.waitForSlaveState(int slaveIndex, EcState target, int timeoutMs, int pollIntervalMs)	轮询等待单个从站到达指定状态 (PDO 启动后状态确认场景)
boolean	State.waitForState(EcState target)	等待主站到达指定状态 (默认 10s 超时, 50ms 轮询间隔)
boolean	State.waitForState(EcState target, int timeoutMs, int pollIntervalMs)	轮询等待主站到达指定状态 (对齐 C# WaitForState / C++ master_state::WaitForState) 不发起状态切换, 仅等待已请求的转换完成 / PDO 流稳定确认

com.darra.ethercat.slave中EcState的使用

返回EcState的com.darra.ethercat.slave中的方法

修饰符和类型	方法	说明
EcState	Slave.State()	当前 EtherCAT 状态
EcState	Slave.StateLive()	当前 EtherCAT 状态 (强制实时读, 绕过缓存).

参数类型为EcState的com.darra.ethercat.slave中的方法

修饰符和类型	方法	说明
void	SlaveEvents.StateChangedListener.onStateChanged(EcState oldState, EcState newState)
boolean	Slave.SetState(EcState targetState)	设置从站 EtherCAT 状态 (默认 3000ms 超时)
boolean	Slave.SetState(EcState targetState, int timeoutMs)	设置从站 EtherCAT 状态
void	SlaveEvents.triggerStateChanged(EcState oldState, EcState newState)	触发状态变化 (包外访问: MasterEvents 路由事件到从站)

com.darra.ethercat.statics中EcState的使用

参数类型为EcState的com.darra.ethercat.statics中的方法

修饰符和类型	方法	说明
static String	PrintHelper.getStateDescription(EcState state)	获取 EcState 的描述

com.darra.ethercat.sugar中EcState的使用

声明为EcState的com.darra.ethercat.sugar中的字段

修饰符和类型	字段	说明
final EcState	SlaveStateQueue.StateChangeEvent.newState
final EcState	SlaveStateQueue.StateChangeEvent.oldState

返回变量类型为EcState的类型的com.darra.ethercat.sugar中的方法

修饰符和类型	方法	说明
static Map<EcState,List<Slave>>	MasterStreams.slavesByState(EtherCATMaster master)	按 EcState 分组, 用于一次性诊断 "网络上有多少从站卡在哪个状态".
static Map<EcState,Long>	MasterStreams.stateCounts(EtherCATMaster master)	按 EcState 计数.

参数类型为EcState的com.darra.ethercat.sugar中的方法

修饰符和类型	方法	说明
static boolean	SlaveListExt.allInState(EtherCATMaster master, EcState state)	全网从站是否都进入了指定状态.
static boolean	SlaveListExt.anyInState(EtherCATMaster master, EcState state)	是否存在任意从站处于指定状态.
static long	SlaveListExt.countByState(EtherCATMaster master, EcState state)	处于指定状态的从站数.
static CompletableFuture<Boolean>	MasterAsync.setStateAsync(EtherCATMaster master, EcState state)	异步设置主站状态.
static CompletableFuture<Boolean>	MasterAsync.setStateAsync(EtherCATMaster master, EcState state, Duration timeout)	带超时的异步设置主站状态.
static Stream<Slave>	MasterStreams.slavesInState(EtherCATMaster master, EcState state)	过滤指定 EtherCAT 状态的从站.
static Stream<Slave>	MasterStreams.slavesNotInState(EtherCATMaster master, EcState state)	过滤**不在**指定状态的从站.
MasterBuilder	MasterBuilder.targetState(EcState state)	目标 EtherCAT 状态.

参数类型为EcState的com.darra.ethercat.sugar中的构造器

限定符	构造器	说明
	StateChangeEvent(short m, short s, EcState os, EcState ns)