SDK 文档
6 种语言官方 SDK,协议覆盖与字节级行为完全一致 —— 选一种开始,后期切换语言不改控制语义。
选择语言
| 语言 | 适用场景 |
|---|---|
| C# SDK | .NET 应用 (WPF / WinForms / ASP.NET) |
| Python SDK | 数据科学 / AI / 算法验证 / 快速原型 |
| C++ SDK | 高性能 / 低延迟控制 (C++17 Header-Only) |
| Rust SDK | 高性能 / 内存安全 / 服务器 |
| Java SDK | Web 后端 / 企业系统集成 |
| 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 变化必须重装配套的驱动安装包。