下载
Darra EtherCAT Master Tools
EtherCAT 主站配置与调试上位机工具,支持在线扫描、从站配置、PDO 监控、协议调试(CoE/SoE/FoE/EoE/AoE/VoE/FSoE)、DC 诊断、实时诊断面板、一键导出多语言代码等功能。
- Windows
- Linux
| 项目 | 说明 |
|---|---|
| 完整安装包 | ⬇ Darra-EtherCAT-Setup.exe — 一个 exe 装好 实时内核驱动 + 主站上位机 GUI + 调试工具(驱动随包自动安装,无需单独下载) |
| 系统要求 | Windows 10+ / .NET Framework 4.7.2+,安装驱动需管理员权限 |
Linux 版本计划于 2026 年 6 月 发布。
工具环境
| 工具 | 说明 | 下载 |
|---|---|---|
| Visual C++ Redistributable | 程序运行所需的 C++ 运行时库,缺失时程序启动会提示安装 | Microsoft 官方下载 |
SDK & 驱动
- Windows
- Linux
驱动
实时内核驱动 DarraRT_Eth 已绑定在上方的完整安装包内,随安装包一键装好,不单独发布、不单独下载。下方 SDK 仅用于开发集成(SDK 运行也依赖此驱动,请先装完整安装包)。
| 驱动 | 类型 | 说明 |
|---|---|---|
| DarraRT_Eth | 必需(随安装包) | Windows 内核实时驱动,抖动 < 1μs,最小周期 31.5μs,含在完整安装包中,无需单独下载 |
SDK
- C# (.NET)
- C
- C++
- Python
- Java
- Rust
- NuGet 包
- 直接下载 .nupkg
Install-Package DarraEtherCAT
或使用 .NET CLI:
dotnet add package DarraEtherCAT
从 Darra 官方分发节点直接下载 .nupkg (永久 URL, 永远是最新版):
# 方式 1: dotnet CLI 离线安装
Invoke-WebRequest -Uri https://download.darra.xyz/ethercat/csharp/Darra.EtherCAT.nupkg -OutFile Darra.EtherCAT.nupkg
dotnet add package Darra.EtherCAT --source .
| 文件 | 永久 URL |
|---|---|
| Darra.EtherCAT.nupkg | https://download.darra.xyz/ethercat/csharp/Darra.EtherCAT.nupkg |
.nupkg 内置已 EV 签名的 Darra.Core.dll (放进 runtimes/win-x64/native/), NuGet 安装时会自动复制到运行目录, 无需手工放置.
| 项目 | 要求 |
|---|---|
| .NET | .NET Standard 2.0 (兼容 .NET Framework 4.6.1+ / .NET 6+) |
| 操作系统 | Windows 10+ |
C SDK 提供头文件 + 动态加载方式,直接调用 Darra.Core.dll 导出函数。
从 Darra 官方分发节点下载 (永久 URL, 永远是最新版):
Invoke-WebRequest -Uri https://download.darra.xyz/ethercat/c/darra_ethercat_c-win-x64.zip -OutFile darra_ethercat_c.zip
Expand-Archive -Path darra_ethercat_c.zip -DestinationPath darra_ethercat_c
| 内含 | 说明 |
|---|---|
| Darra.Core.dll | 核心驱动 DLL (EV 签名) |
| DarraEtherCAT.h | C 头文件 |
| DarraEtherCAT.lib | 导入库 (MSVC) |
| examples/ | 示例代码 (含 CMakeLists.txt) |
| 文件 | 永久 URL |
|---|---|
| darra_ethercat_c-win-x64.zip | https://download.darra.xyz/ethercat/c/darra_ethercat_c-win-x64.zip |
| darra_ethercat_c-win-x64.zip.sha256 | https://download.darra.xyz/ethercat/c/darra_ethercat_c-win-x64.zip.sha256 |
在项目中链接:
#include "DarraEtherCAT.h"
#pragma comment(lib, "DarraEtherCAT.lib")
| 项目 | 要求 |
|---|---|
| 编译器 | MSVC 2019+ / GCC 9+ / Clang 12+ |
| 操作系统 | Windows 10+ |
详见 C SDK 文档。
C++ SDK 是纯头文件 RAII 封装层,依赖 C SDK 头文件,提供自动资源管理、异常安全和现代 C++ 风格接口。
从 Darra 官方分发节点下载 (永久 URL):
Invoke-WebRequest -Uri https://download.darra.xyz/ethercat/cpp/darra_ethercat_cpp-win-x64.zip -OutFile darra_ethercat_cpp.zip
Expand-Archive -Path darra_ethercat_cpp.zip -DestinationPath darra_ethercat_cpp
| 内含 | 说明 |
|---|---|
| DarraEtherCAT.h | C SDK 头文件(必需依赖) |
| ethercat.hpp | C++ RAII 封装头文件(仅头文件,无需编译) |
| Darra.Core.dll | 核心驱动 DLL (EV 签名) |
| examples/ | 示例代码 (含 CMakeLists.txt) |
| 文件 | 永久 URL |
|---|---|
| darra_ethercat_cpp-win-x64.zip | https://download.darra.xyz/ethercat/cpp/darra_ethercat_cpp-win-x64.zip |
| darra_ethercat_cpp-win-x64.zip.sha256 | https://download.darra.xyz/ethercat/cpp/darra_ethercat_cpp-win-x64.zip.sha256 |
在项目中使用:
#include "ethercat.hpp"
// 需要 C 头文件 DarraEtherCAT.h 在 include 路径中
| 项目 | 要求 |
|---|---|
| 编译器 | MSVC 2019+ / GCC 9+ / Clang 12+(需支持 C++17) |
| 依赖 | C SDK 头文件(DarraEtherCAT.h) |
| 操作系统 | Windows 10+ |
详见 C++ SDK 文档。
- pip
- 直接下载 wheel
通过 pip 安装:
pip install darra-ethercat
从 Darra 官方分发节点直接安装 (永久 URL):
pip install https://download.darra.xyz/ethercat/python/darra_ethercat_master-py3-none-any.whl
| 文件 | 永久 URL |
|---|---|
| darra_ethercat_master-py3-none-any.whl | https://download.darra.xyz/ethercat/python/darra_ethercat_master-py3-none-any.whl |
| darra_ethercat_master.tar.gz (源码) | https://download.darra.xyz/ethercat/python/darra_ethercat_master.tar.gz |
| 项目 | 要求 |
|---|---|
| Python | 3.8+ |
| 操作系统 | Windows 10+ |
详见 Python SDK 文档。
- Maven
- Gradle
- 直接下载 jar
通过 Maven Central 安装:
<dependency>
<groupId>xyz.darra</groupId>
<artifactId>darra-ethercat-master</artifactId>
<version>LATEST</version>
</dependency>
implementation 'xyz.darra:darra-ethercat-master:+'
从 Darra 官方分发节点下载 (永久 URL):
| 文件 | 永久 URL |
|---|---|
| darra-ethercat-master.jar (主 jar, 含 native) | https://download.darra.xyz/ethercat/java/darra-ethercat-master.jar |
| darra-ethercat-master.pom (Maven 元数据) | https://download.darra.xyz/ethercat/java/darra-ethercat-master.pom |
| darra-ethercat-master-sources.jar | https://download.darra.xyz/ethercat/java/darra-ethercat-master-sources.jar |
| darra-ethercat-master-javadoc.jar | https://download.darra.xyz/ethercat/java/darra-ethercat-master-javadoc.jar |
主 jar 内嵌 EV 签名 Darra.Core.dll (在 META-INF/native/win-x64/), JNA 自动加载.
| 项目 | 要求 |
|---|---|
| Java | JDK 11+ |
| 依赖 | JNA 5.0+ |
| 操作系统 | Windows 10+ |
详见 Java SDK 文档。
- Cargo (crates.io)
- 直接下载 .crate
通过 Cargo 安装:
cargo add darra-ethercat-master
或在 Cargo.toml 中添加:
[dependencies]
darra-ethercat-master = "*"
从 Darra 官方分发节点下载源码 crate (永久 URL):
| 文件 | 永久 URL |
|---|---|
| darra-ethercat-master.crate | https://download.darra.xyz/ethercat/rust/darra-ethercat-master.crate |
.crate 是源码包, cargo 自动编译; native lib (Darra.Core.dll) 由 build.rs 从配套驱动包中读取.
| 项目 | 要求 |
|---|---|
| Rust | 1.70+ |
| 操作系统 | Windows 10+ |
详见 Rust SDK 文档。