跳到主要内容

SDK 文档

6 种语言官方 SDK,协议覆盖与字节级行为完全一致 —— 选一种开始,后期切换语言不改控制语义。

选择语言

语言适用场景
C# SDK.NET 应用 (WPF / WinForms / ASP.NET)
Python SDK数据科学 / AI / 算法验证 / 快速原型
C++ SDK高性能 / 低延迟控制 (C++17 Header-Only)
Rust SDK高性能 / 内存安全 / 服务器
Java SDKWeb 后端 / 企业系统集成
C SDK嵌入式 / 微控制器 / 资源受限设备

协议与特性

6 种 SDK 全部支持以下协议与特性,行为与时序一致:

  • 邮箱协议 — CoE (SDO/PDO/EMCY/CiA402) · EoE · FoE · SoE · AoE · VoE · FSoE
  • 核心能力 — 状态机 (Init/PreOp/SafeOp/OP) · DC 分布式时钟 · 冗余 + Hot-Connect · 邮箱网关 (ETG.8200)

跨语言一致性

同一套协议常量与判断逻辑在 6 种语言中字节级一致,迁移只换调用语法:

  • 从站状态枚举、AL Status Code、SDO Abort Code、FSoE 错误码 —— 数值与描述跨语言一致
  • 邮箱 / 帧 CRC16 算法等价,同一帧在任意 SDK 产生相同校验值
  • AL Status Code 描述支持中英双语(默认英文,UI 可取中文)

版本兼容

master.Build() 启动时自动比对 SDK 与驱动版本,不匹配在日志中给出 Warning。

升级类型重装驱动?
PATCH (2.1.0 → 2.1.5)❌ 不需要
MINOR (2.1.x → 2.2.0)✅ 必须
MAJOR (2.x → 3.0.0)✅ 必须

同一 MAJOR.MINOR 内 PATCH 互相兼容,升级 SDK 不需重装驱动;MAJOR / MINOR 变化必须重装配套的驱动安装包。