下载
一句话答案(在哪下载 / 怎么安装):官方安装包一个 exe 装好实时内核驱动 + GUI 工具,直接下载 Darra-EtherCAT-Setup.exe,以管理员身份运行即可;无 MSI、无单独驱动包。装完不自动重启,需要重启时自己重启。
下载总览
| 名称 | 版本 | 系统 | 直链 |
|---|---|---|---|
| 完整安装包 Darra-EtherCAT-Setup.exe | 2.11.0 | Windows x64 | ⬇ 下载 |
| C SDK darra_ethercat_c-win-x64.zip | 2.11.0 | Windows x64 | ⬇ 下载 |
| C++ SDK darra_ethercat_cpp-win-x64.zip | 2.11.0 | Windows x64 | ⬇ 下载 |
| C# SDK Darra.EtherCAT.Master.nupkg | 2.11.0 | Windows x64 | ⬇ 下载 |
| Python SDK darra_ethercat_master-cp312-cp312-win_amd64.whl | 2.11.0 | Windows x64 | ⬇ 下载 |
| Java SDK darra-ethercat-master.jar | 2.11.0 | Windows x64 | ⬇ 下载 |
| Rust SDK darra-ethercat-master.crate | 2.11.0 | Windows x64 | ⬇ 下载 |
| Rust SDK 完整包 darra_ethercat_rust.zip(含 Darra.Core.dll) | 2.11.0 | Windows x64 | ⬇ 下载 |
直链地址固定,始终指向最新版;各语言也可按包管理器安装,见下文 SDK 一节。
Darra EtherCAT Master Tools
EtherCAT 主站配置与调试上位机工具,支持在线扫描、从站配置、PDO 监控、协议调试(CoE/SoE/FoE/EoE/AoE/VoE/FSoE)、DC 诊断、实时诊断面板、导出多语言代码等功能。
- Windows
- Linux
| 项目 | 说明 |
|---|---|
| 完整安装包 | ⬇ Darra-EtherCAT-Setup.exe — 一个 exe 装好 实时内核驱动 + 主站上位机 GUI + 调试工具(驱动随包自动安装,无需单独下载) |
| 校验和 | SHA-256 校验文件 Darra-EtherCAT-Setup.exe.sha256 |
| 系统要求 | Windows 10+ / .NET Framework 4.7.2+,安装驱动需管理员权限 |
可直接下载上方完整安装包,进行 2 小时测试评估。评估期为单次连续运行 2 小时:从进程启动起算,关闭或重启后重新计时,不写入注册表。评估时请提供使用测试工具导出的 .deni 文件。
我们会免费提供可运行的案例工程,用于验证并满足您的功能需求。
先卸载旧版 → 重启电脑 → 再安装新版。操作前请先保存好工程和配置文件。详见使用前的准备。
Linux 版尚未公开发布,说明见 Linux 版(未公开发布)。
Linux 版(未公开发布)
受限于 Linux 内核安全与预编译无法通用问题,Linux SDK 与驱动尚未公开发布,无公开评估版本;授权价格同 Windows,请先用 Windows 版完成评估后联系 sales@darra.xyz 购买。
协议层与 Windows 版完全相同,性能数字见 Linux 驱动层。
工具环境
| 工具 | 说明 | 下载 |
|---|---|---|
| Visual C++ Redistributable | 程序运行所需的 C++ 运行时库,缺失时程序启动会提示安装 | Microsoft 官方下载 |
SDK & 驱动
- Windows
- Linux
驱动
实时内核驱动 DarraRT_Eth 已绑定在上方的完整安装包内,随安装包一并装好,不单独发布、不单独下载。下方 SDK 仅用于开发集成(SDK 运行也依赖此驱动,请先装完整安装包)。
| 驱动 | 类型 | 说明 |
|---|---|---|
| DarraRT_Eth | 必需(随安装包) | Windows 内核实时驱动,抖动平均 1.2µs / 最大 4.5µs,最小周期 31.25µs,含在完整安装包中,无需单独下载 |
SDK
安装包内已附全套 6 个语言 SDK(头文件 / 示例 / 源码包),也可按下方各语言单独下载。
Maven Central / NuGet / PyPI / crates.io 的版本上架可能略晚于官网下载包;需要精确版本时用下方"直接下载"或按各语言 SDK 文档本地安装。
- C# (.NET)
- C
- C++
- Python
- Java
- Rust
- NuGet 包
- 直接下载 .nupkg
Install-Package Darra.EtherCAT.Master
或使用 .NET CLI:
dotnet add package Darra.EtherCAT.Master
从官方下载地址直接下载 .nupkg(地址固定,始终指向最新版):
# 方式 1: dotnet CLI 离线安装
Invoke-WebRequest -Uri https://download.darra.xyz/ethercat/csharp/Darra.EtherCAT.Master.nupkg -OutFile Darra.EtherCAT.Master.nupkg
dotnet add package Darra.EtherCAT.Master --source .
| 文件 | 下载地址 |
|---|---|
| Darra.EtherCAT.Master.nupkg | https://download.darra.xyz/ethercat/csharp/Darra.EtherCAT.Master.nupkg |
| Darra.EtherCAT.Master.nupkg.sha256 | https://download.darra.xyz/ethercat/csharp/Darra.EtherCAT.Master.nupkg.sha256 |
.nupkg 内置已签名的 Darra.Core.dll(EV 代码签名证书,位于 runtimes/win-x64/native/),NuGet 安装时会自动复制到运行目录,无需手工放置。
| 项目 | 要求 |
|---|---|
| .NET | .NET Standard 2.0(.NET Framework 4.6.1+ 与 .NET 6–8 已验证;net9/net10 仅支持 UseAppHost=false + dotnet app.dll 运行方式,详见 C# SDK 文档) |
| 操作系统 | Windows 10+(仅 x64) |
C SDK 提供完整 C 头文件 + 导入库,链接 darra_ethercat.lib 调用 DarraEtherCAT.dll 导出函数(DarraEtherCAT.dll 运行时自行加载 Darra.Core.dll)。
从官方下载地址下载(地址固定,始终指向最新版):
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
| 内含 | 说明 |
|---|---|
| bin/ | Darra.Core.dll + DarraEtherCAT.dll(EV 代码签名) |
| include/ | ethercat.h 等完整 C 头文件 |
| lib/ | darra_ethercat.lib + darra-ethercat-advanced.lib + mxml4.lib(MSVC 链接库) |
| examples/ | 示例代码 basic.c / highlevel.c / cia402.c / test_gateway_port.c |
| 包根 | CMakeLists.txt / build.bat / build.sh(另有 conanfile.py / vcpkg/) |
| 文件 | 下载地址 |
|---|---|
| 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 "ethercat.h"
/* MSVC: ethercat.h 自带 #pragma comment(lib, "darra_ethercat.lib");
用到 advanced 层时另链 darra-ethercat-advanced.lib + mxml4.lib */
| 项目 | 要求 |
|---|---|
| 编译器 | MSVC 2019+ / GCC 7+ / Clang 10+(C11 或更高) |
| 操作系统 | Windows 10+ |
详见 C SDK 文档。
C++ SDK 是纯头文件 RAII 封装层(.hpp),包内自带 C 层头文件,提供自动资源管理、异常安全和现代 C++ 风格接口。
从官方下载地址下载:
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
| 内含 | 说明 |
|---|---|
| include/ | ethercat.h(C 层)+ ethercat.hpp 等 C++ RAII 封装头文件(含 master/ slave/ 子目录,仅头文件,无需编译) |
| bin/ | Darra.Core.dll + DarraEtherCAT.dll(EV 代码签名) |
| lib/ | darra_ethercat.lib + darra-ethercat-advanced.lib + mxml4.lib(MSVC 链接库) |
| examples/ | 示例代码 basic.cpp |
| third_party/ | pugixml(ESI/XML 解析依赖,随包源码) |
| 文件 | 下载地址 |
|---|---|
| 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"
// ethercat.hpp 会包含 ethercat.h,两者都在包内 include/ 中
| 项目 | 要求 |
|---|---|
| 编译器 | MSVC 2019+ / GCC 7+ / Clang 10+(需支持 C++17) |
| 依赖 | 包内自带 C 层头文件 |
| 操作系统 | Windows 10+ |
详见 C++ SDK 文档。
- pip
- 直接下载 wheel
通过 pip 安装:
pip install darra-ethercat-master
通过官方下载地址直接安装:
pip install https://download.darra.xyz/ethercat/python/darra_ethercat_master-cp312-cp312-win_amd64.whl
| 文件 | 下载地址 |
|---|---|
| darra_ethercat_master-cp312-cp312-win_amd64.whl | https://download.darra.xyz/ethercat/python/darra_ethercat_master-cp312-cp312-win_amd64.whl |
| darra_ethercat_master-cp312-cp312-win_amd64.whl.sha256 | https://download.darra.xyz/ethercat/python/darra_ethercat_master-cp312-cp312-win_amd64.whl.sha256 |
| 项目 | 要求 |
|---|---|
| Python | 3.12(64 位 Windows;wheel 含 cp312 原生扩展,其他版本 pip 会提示没有匹配的 wheel) |
| 操作系统 | Windows 10+ |
详见 Python SDK 文档。
- Maven
- Gradle
- 直接下载 jar
通过 Maven Central 安装:
<dependency>
<groupId>xyz.darra</groupId>
<artifactId>darra-ethercat-master</artifactId>
<version>2.11.0</version>
</dependency>
implementation 'xyz.darra:darra-ethercat-master:2.11.0'
从官方下载地址下载:
| 文件 | 下载地址 |
|---|---|
| darra-ethercat-master.jar (主 jar, 含 native) | https://download.darra.xyz/ethercat/java/darra-ethercat-master.jar |
| darra-ethercat-master.jar.sha256 | https://download.darra.xyz/ethercat/java/darra-ethercat-master.jar.sha256 |
| darra-ethercat-master.pom (Maven 元数据) | https://download.darra.xyz/ethercat/java/darra-ethercat-master.pom |
| darra-ethercat-master.pom.sha256 | https://download.darra.xyz/ethercat/java/darra-ethercat-master.pom.sha256 |
| darra-ethercat-master-javadoc.jar | https://download.darra.xyz/ethercat/java/darra-ethercat-master-javadoc.jar |
| darra-ethercat-master-javadoc.jar.sha256 | https://download.darra.xyz/ethercat/java/darra-ethercat-master-javadoc.jar.sha256 |
主 jar 内嵌已签名的 Darra.Core.dll(EV 代码签名证书,位于 jar 内 win32-x86-64/),JNA 自动加载。
| 项目 | 要求 |
|---|---|
| Java | JDK 11+ |
| 依赖 | JNA 5.0+ |
| 操作系统 | Windows 10+ |
详见 Java SDK 文档。
- Cargo (crates.io / 本地 path)
- 直接下载
crates.io 已上架 darra-ethercat-master,上架版本可能滞后于官网下载包:
cargo add darra-ethercat-master
需要最新版时,下载 .crate 解压后用路径依赖引入:
tar -xzf darra-ethercat-master.crate # 解出 darra-ethercat-master-2.11.0/
[dependencies]
darra-ethercat-master = { path = "../darra-ethercat-master-2.11.0" }
从官方下载地址下载(地址固定,始终指向最新版):
| 文件 | 说明 | 下载地址 |
|---|---|---|
| darra-ethercat-master.crate | 源码 crate | https://download.darra.xyz/ethercat/rust/darra-ethercat-master.crate |
| darra-ethercat-master.crate.sha256 | SHA-256 校验和 | https://download.darra.xyz/ethercat/rust/darra-ethercat-master.crate.sha256 |
| darra_ethercat_rust.zip | crate + bin/Darra.Core.dll | https://download.darra.xyz/ethercat/rust/darra_ethercat_rust.zip |
| darra_ethercat_rust.zip.sha256 | SHA-256 校验和 | https://download.darra.xyz/ethercat/rust/darra_ethercat_rust.zip.sha256 |
.crate 是源码包, cargo 自动编译;Windows 链接不需要导入库。.crate 不含 Darra.Core.dll,运行期需要它:取 darra_ethercat_rust.zip 的 bin/ 或安装包 SDK 目录里的 Darra.Core.dll,复制到 exe 同目录或放进 PATH。
| 项目 | 要求 |
|---|---|
| Rust | 1.70+ |
| 操作系统 | Windows 10+ |
详见 Rust SDK 文档。
Linux 平台支持尚未公开发布,发布时间未定;协议层与 Windows 版一致,发布后此页提供下载。
驱动
| 驱动 | 类型 | 说明 | 安装方式 |
|---|---|---|---|
| DarraRT (LKM) | 必需 | 内核实时驱动,抖动平均 0.8µs / 最大 3.5µs,最小周期 31.25µs | 待发布 |
详见 Linux 驱动层。
SDK
- C
- C++
- Python
- Java
- Rust
| 项目 | 要求 |
|---|---|
| 编译器 | GCC 9+ |
| 构建工具 | CMake |
| 项目 | 要求 |
|---|---|
| 编译器 | GCC 9+(需支持 C++17) |
| 依赖 | C SDK 头文件 |
| 构建工具 | CMake |
| 项目 | 要求 |
|---|---|
| Python | 3.8+ |
| 安装方式 | pip |
| 项目 | 要求 |
|---|---|
| Java | JDK 11+ |
| 依赖 | JNA 5.0+ |
| 项目 | 要求 |
|---|---|
| Rust | 1.70+ |
| 安装方式 | cargo |