前言工业自动化与智能制造快速发展高精度、高响应的运动控制系统已成为设备核心。然而传统运动控制开发往往面临接口复杂、文档缺失、调试困难等挑战严重制约了研发效率与系统稳定性。本文推荐一款专为正运动 ZMotion 系列运动控制器设计的 高性能、现代化 C# 软件开发包基于 .NET 8.0开发 深度融合工业场景需求。不管是开发 CNC 设备、机器人、激光加工系统还是自动化检测平台ZMotionSDK 都能为大家提供一套简洁、高效、可靠的运动控制解决方案。项目介绍ZMotionSDK 是一个专业的 C# 运动控制器软件开发包为正运动 ZMotion 系列运动控制器提供完整的编程接口。该 SDK 基于 .NET 8.0 开发提供高性能、易用的工业级运动控制解决方案。核心特性多样化连接方式以太网通信支持 TCP/IP 网络连接快速稳定串口通信兼容传统串口通信方式超时控制可配置连接超时时间确保连接可靠性高性能运动控制插补功能支持直线、圆弧插补运动缓存运动运动指令缓存机制实现平滑连续运动实时监控位置、速度、状态的实时反馈完整 IO 控制系统数字输入输出高速 DI/DO 读写操作批量操作支持多点 IO 的批量读写提高效率信号反转智能信号反转配置适应不同硬件接线Modbus 支持原生支持 Modbus 协议的 IO 操作智能回零系统多种回零模式支持 8 种标准回零模式参数可配置回零速度、偏移量、等待时间等全可配置总线回零支持 EtherCAT 等总线驱动器的回零功能状态监控实时回零状态监控和异常处理IOSugar协议糖化框架类型安全映射通过[Address]等特性将硬件地址映射到结构体/类字段支持基本类型、枚举、嵌套结构和按位域BitField映射异步读写提供Read*Async/Write*Async系列方法支持批量读写、超时与取消令牌适合 UI 与高并发场景自定义转换器字段级支持Converter特性用于值缩放、单位转换或自定义序列化/反序列化逻辑校验与默认值支持在字段上声明默认值与校验属性例如范围验证读取时会自动应用并在写入前进行校验高性能内部使用反射缓存 表达式树动态编译读写性能接近手写访问并支持批量打包以减少通信开销线程安全与并发内部使用并发字典和分段锁策略支持多线程并发读写和共享构建器实例虚拟地址与别名支持将逻辑字段映射到虚拟地址或别名便于在不同硬件版本间复用协议定义安全与异常处理完善的异常体系专门的ZMotionException异常处理错误码解析详细的错误码说明和处理建议轴状态监控全面的轴运行状态、限位、告警监控安全机制软硬限位保护急停减速度配置快速开始安装通过 NuGet 包管理器安装Install-Package ZMotionSDK或通过 .NET CLIdotnet add package ZMotionSDK基础使用示例using ZMotionSDK; using ZMotionSDK.Models; classProgram { static async Task Main() { var zmotion new ZMotion(); try { // 连接控制器 zmotion.Open(192.168.1.100, 3000); Console.WriteLine(控制器连接成功); // 配置轴参数 var axisParam new AxisParam { Speed 100.0f, Acceleration 1000.0f, Deceleration 1000.0f, SmoothingFactor 0.1f, Units 1000.0f, PositiveLimit 10000.0f, NegativeLimit -10000.0f, EmergencyDeceleration 5000.0f }; // 应用轴参数 zmotion.SetAxisParam(0, axisParam); // 执行绝对位置移动 zmotion.Move_Absolute(0, 5000.0f); Console.WriteLine(开始移动到位置5000); // 异步等待运动完成 var result await zmotion.WaitMoveCompleteAsync(0, 10000); if (result.IsSuccess) { Console.WriteLine($运动完成耗时: {result.ElapsedTime:F2}ms); } else { Console.WriteLine(运动超时); } // 读取当前状态 var motionState zmotion.GetAxisMotionState(1)[0]; Console.WriteLine($当前位置: {motionState.CurrentPosition}); Console.WriteLine($当前速度: {motionState.CurrentSpeed}); Console.WriteLine($运行状态: {motionState.IsRunning}); } catch (ZMotionException ex) { Console.WriteLine($控制器错误: {ex.Message}); } finally { zmotion.Close(); Console.WriteLine(连接已关闭); } } }详细功能说明1、连接管理// 方式1带超时的快速连接 zmotion.Open(192.168.1.100, 3000); // 方式2标准以太网连接 zmotion.Open_Eth(192.168.1.100); // 关闭连接 zmotion.Close();2、数字 IO 控制基础 IO 操作// 读取单个数字输入 bool diValue zmotion.GetDI(0); // 批量读取数字输入 bool[] diArray zmotion.GetDI_Multi(0, 15); // 设置单个数字输出 zmotion.SetDO(0, true); // 批量设置数字输出 bool[] doValues { true, false, true, false }; zmotion.SetDO_Multi(0, doValues);协议糖化 IO 操作// 定义输入协议结构 publicstruct DIProtocol { [Address(0)] publicbool StartButton; [Address(1)] publicbool StopButton; [Address(2)] publicbool EmergencyStop; [Address(3)] publicbool SafetyDoor; } // 定义输出协议结构 publicstruct DOProtocol { [Address(0)] publicbool MotorEnable; [Address(1)] publicbool AlarmLight; [Address(2)] publicbool RunningLight; [Address(3)] publicbool CompletedLight; } // 创建 IOSugar 构建器示例使用异步 API var builder new ZMotionIOClientDIProtocol, DOProtocol(); builder.ZMotion zmotion; // 异步读取结构化的输入数据 var inputs await builder.ReadDIAsync(); if (inputs.StartButton !inputs.EmergencyStop) { var outputs new DOProtocol { MotorEnable true, RunningLight true, AlarmLight false, CompletedLight false }; await builder.WriteAsync(outputs); }3、运动控制基本运动控制// 单轴绝对移动 zmotion.Move_Absolute(0, 1000.0f); // 单轴相对移动 zmotion.Move_Relative(0, 500.0f); // 连续运动点动 zmotion.Jog(0, true); // 正向点动 zmotion.Jog(0, false); // 反向点动 // 停止运动 zmotion.Stop(0, CancelMode.取消当前运动和缓冲运动);回零操作// 配置回零参数 zmotion.SetGoHomeCreepSpeed(0, 10.0f); zmotion.SetGoHomeWaitTime(0, 100); zmotion.SetGoHomeOffpos(0, 50.0f); // 执行回零 zmotion.GoHome(0, 1); // 检查回零状态 bool homeStatus zmotion.GetHomeStatus(0);缓存运动模式// 构建连续运动序列 zmotion.Move_Absolute(0, 1000.0f); zmotion.MoveDelay(0, 500); zmotion.Move_Relative(0, 500.0f); zmotion.MoveOp(0, 1, 1); zmotion.Move_Absolute(0, 0.0f); // 查询缓存状态 int bufferedMoves zmotion.GetMovesBuffered(0); int remainBuffer zmotion.GetRemainBuffer(0);4、参数配置与监控轴参数配置// 基本运动参数 zmotion.SetSpeed(0, 100.0f); zmotion.SetAccel(0, 1000.0f); zmotion.SetDecel(0, 1000.0f); zmotion.SetSpeed_L(0, 10.0f); zmotion.SetSramp(0, 0.1f); // 脉冲参数 zmotion.SetUnits(0, 1000.0f); zmotion.SetAxisType(0, AxisType.Pulse); // 安全参数 zmotion.SetLimit(0, 10000.0f, true); zmotion.SetLimit(0, -10000.0f, false); zmotion.SetDecel_Fast(0, 5000.0f);状态监控// 获取详细的轴运动状态 var motionStates zmotion.GetAxisMotionState(4); foreach (var state in motionStates) { Console.WriteLine($轴 {Array.IndexOf(motionStates, state)}:); Console.WriteLine($ 当前位置: {state.CurrentPosition}); Console.WriteLine($ 规划位置: {state.PlanPosition}); Console.WriteLine($ 当前速度: {state.CurrentSpeed}); Console.WriteLine($ 运行状态: {state.IsRunning}); Console.WriteLine($ 缓存数量: {state.MovesBuffered}); Console.WriteLine($ 轴状态: {state.Status}); } // 获取轴信号状态 var signal zmotion.GetAxisSignal(0); Console.WriteLine($原点信号: {signal.HomeSignal}); Console.WriteLine($正限位: {signal.PositiveLimitSignal}); Console.WriteLine($负限位: {signal.NegativeLimitSignal}); Console.WriteLine($报警信号: {signal.AlarmSignal});5、总线功能// 总线初始化 zmotion.Init_Bus(); // 检查初始化状态 bool initStatus zmotion.GetBusInitStatus(); // 获取总线节点数量 int nodeCount zmotion.GetBusNodeNum(0); // 总线轴使能控制 zmotion.AxisEnable_Bus(0, true); zmotion.AxisEnable_Bus(0, false); // 清除总线驱动器报警 zmotion.ClearAlarm_Bus(0, 0);6、高级功能电子齿轮// 设置电子齿轮比例 zmotion.Connect(0, 1, 2.0f); // 设置连接速率 zmotion.SetClutchRate(1, 1000000.0f); // 设置编码器比例 zmotion.SetEncoderRatio(0, 1000, 1000);在线命令执行// 执行缓存命令 string result1 zmotion.Execute_Buffer(DPOS(0)); // 执行直接命令 string result2 zmotion.Execute_Direct(?DPOS(0)); // 程序下载 zmotion.BasDown(C:\Program\test.bas, BasDownMode.ROM);设计模式分部类设计ZMotion类采用分部类设计将不同功能模块分离策略模式不同的运动模式和控制策略建造者模式MessageBuilder用于构建复杂的 IO 操作工厂模式协议配置和数据映射的创建测试与示例项目包含完整的测试应用程序位于Test/ZMotionTest目录连接管理TCP/IP 连接配置和状态监控轴控制界面完整的单轴和多轴控制界面IO 控制面板数字输入输出的实时控制和监控参数测试轴参数的配置和实时测试缓存运动缓存运动指令的管理和执行协议测试ProtocolSugar 功能的完整测试性能优化反射缓存使用ConcurrentDictionary缓存反射操作避免重复反射批量操作支持多轴、多 IO 的批量读写减少通信开销异步支持关键 API 提供异步版本避免 UI 线程阻塞内存优化优化 P/Invoke 调用减少内存分配和 GC 压力注意本 SDK 专为正运动 ZMotion 系列控制器设计使用前请确认硬件兼容性。总结项目不仅是一个运动控制接口封装更是一套面向现代工业软件开发的完整工具链。通过 .NET 8.0 的高性能运行时、类型安全的协议映射、异步非阻塞架构以及丰富的工业功能集它显著提升了运动控制应用的开发效率、系统稳定性和可维护性。关键词C#运动控制、.NET 8.0、#正运动控制器、#IOSugar、#协议糖化、#EtherCAT、#数字IO、#缓存运动、#插补运动、#回零控制、#轴参数配置、#异步IO、P/Invoke、#工业自动化、#运动控制器SDK、#ZMotion、#Modbus、#电子齿轮、#总线控制