授权与激活
Darra EtherCAT Master 采用 激活码 + 机器绑定 的授权模式。GUI 和 SDK 提供 激活 与 查询状态 两个入口。
一、未激活 (评估版) 行为
未激活时, 软件以 评估版 模式运行:
- 单次连续运行不超过 2 小时, 到时自动停止总线通信; 重新启动程序可继续评估。
- 评估版仅供学习和功能验证, 商业用途请购买正式许可证。
- 大部分 GUI 功能 (扫描从站、浏览信息、协议测试、代码导出) 在评估期内均可正常使用, 只是受单次 2 小时时长限制。
评估版单次连续运行上限为 2 小时。需要长时间连续运行的部署请激活正式许可证。
二、激活前准备
- 程序需以 管理员权限 运行 (写入授权需要管理员权限)。
- 需要 网络连接 (用于激活)。
- 需要 激活码 (购买后获得)。
- Windows 10 / 11, x64 平台。
三、购买激活码
在 GUI 的 软件激活 对话框中点击 购买授权 按钮, 会跳转到购买页面:
https://ethercat.darra.xyz/purchase
完整许可条款见 https://ethercat.darra.xyz/license。
激活码格式
激活码为 12 位大写字母 (A–Z), 例如:
ABCDEFGHIJKL
输入时大小写不敏感, 程序会自动转为大写并清除空格 / 连字符。激活码全局唯一, 与购买时绑定的机器关联。
四、在 GUI 中激活
- 打开 软件激活 对话框。
- 在 激活码 输入框填入 12 位激活码。
- 点击 激活 按钮。
- 程序联网核销并写入证书文件, 激活成功后 激活状态 显示为绿色 已激活。
对话框还内置 运行时版本 区块, 显示当前的 SDK 版本、驱动版本 与两者的 兼容性 (匹配 = 绿色 ✓, 不匹配 = 红色 ★), 方便在激活前确认运行环境就绪。
| 激活状态显示 | 含义 |
|---|---|
| 已激活 (绿) | 校验通过, 正常运行 |
| 验证中... (橙) | 正在验证 |
| 证书无效 (红) | 校验失败, 需重新激活 |
| 未激活 (红) | 未激活, 以评估版运行 |
激活成功后授权与本机绑定, 迁移到其他机器后失效, 需在新机器上重新激活。重新激活前若本机已有授权, 程序会提示后再重新激活 (需管理员权限)。
五、SDK 激活
GUI 与 SDK 走同一个底层 Authorization 接口。在你自己的程序里也可直接调用激活接口:
C#
using DarraEtherCAT_Master;
var (success, message) = Authorization.Activate("ABCDEFGHIJKL");
if (success)
{
Console.WriteLine("激活成功");
}
else
{
Console.WriteLine($"激活失败: {message}");
}
Python
from ethercat import Authorization
success, message = Authorization.activate("ABCDEFGHIJKL")
print("激活成功" if success else f"激活失败: {message}")
Java
import com.darra.ethercat.Authorization;
ActivateResult r = Authorization.activate("ABCDEFGHIJKL");
System.out.println(r.success ? "激活成功" : "激活失败: " + r.message);
C / C++
#include "ethercat.h"
result_t r = ec_activate("ABCDEFGHIJKL");
if (r.code == OK) {
printf("激活成功\n");
} else {
printf("激活失败: %s\n", r.message);
}
- 编译 SDK 不会触发激活, 但运行程序 / 调用激活接口会触发, 请隔离开发环境与生产环境。
- 已激活的设备不会重复激活; 重新激活前需先清除本机原有授权。
六、查询激活状态
GUI 的激活状态由底层 LicenseStatus 派生。SDK 可直接查询:
var status = Authorization.LicenseStatus;
if (status == LicenseStatus.Verified)
Console.WriteLine("已激活");
else
Console.WriteLine($"未激活 (状态: {status})");
| 枚举 | 含义 | 处理 |
|---|---|---|
| Verified | 已激活, 校验通过 | 正常运行 |
| Verifying | 正在验证 | 等待验证完成 |
| NotVerified | 未激活 / 校验失败 | 调 Activate() 或检查授权 |
读不到状态时, 程序保守判定为 未激活, 按评估版处理。请确保从官方渠道获取完整安装包。
七、版本兼容
驱动与核心运行库必须配套使用:
- 主版本 / 次版本变化时 (例如 2.1.x → 2.2.0), 必须重新安装官方安装包, 否则程序启动会报兼容性错误并拒绝运行。
- PATCH 级补丁 (例如 2.1.0 → 2.1.5) 通常无需重装驱动。
- 请始终从官方渠道获取安装包与运行库; 使用非官方渠道下载或被修改过的文件可能导致软件无法正常运行。
详见 Windows 驱动文档 — 驱动 ↔ SDK 版本兼容。
八、常见错误
1. 激活码格式无效
激活码必须是 12 位大写字母。检查是否多/少了字符, 或混入了数字 / 符号。
2. 激活失败: 网络连接异常
激活需要联网核销, 请检查:
- 网络连接是否正常
- 激活码是否正确
- 激活码是否已被使用 (绑定其他机器)
3. 检测到本机已有授权
重新激活前需先清除本机原有授权。程序会弹窗询问, 确认后自动清除 (需管理员权限)。若清除失败, 请以管理员身份重新运行程序。
4. 软件运行约 2 小时后总线停止
未激活的评估版单次连续运行上限为 2 小时。重新启动程序可继续评估, 商业部署请激活正式许可证。
5. 换机 / 更换主板后无法运行
授权与本机绑定。更换主板 / CPU / 网卡或迁移到新机器后, 原授权失效, 需在新机器上重新激活 (如激活码已绑定旧机器, 请联系技术支持)。
联系支持
- 技术支持: [email protected]
- 商务咨询: [email protected]
- 购买授权: https://ethercat.darra.xyz/purchase