ethercrab-rs
Windows '\Device\NPF_{YOUR-ADAPTER-ID}'
Hello, In Windows, how can I know?
$env:RUST_LOG="debug" ; cargo run --example ek1100 --release -- '\Device\NPF_{YOUR-ADAPTER-ID}'
$env:RUST_LOG="debug" ; cargo run --example ek1100 --release -- '\Device\NPF_{FF0ACEE6-E8CD-48D5-A399-619CD2340465}'
I don't have a Windows PC to hand, but I believe it's something like
wmic nic get name, deviceid
Or
Get-NetAdapter | Select-Object Name, InterfaceDescription
Please let me know if either of these work (or which command you used) and I'll add an FAQ entry somewhere.
hello @jamwaffles,
Cargo.toml
[package]
name = "Rust-EK1100"
version = "0.1.0"
edition = "2021"
[dependencies]
ethercrab = { version = "0.2.0", features = ["std"] }
log = { version = "0.4.27", features = ["std"] }
env_logger = "0.10"
smol = "1.3"
heapless = "0.8"
pnet_datalink = "0.34.0"
main.rs
//! Discover devices connected to the network.
use env_logger::Env;
use ethercrab::{
Client,
ClientConfig,
PduStorage,
Timeouts,
};
use std::sync::Arc;
/// Maximum number of SubDevices that can be stored. This must be a power of 2 greater than 1.
const MAX_SUBDEVICES: usize = 128;
/// Maximum PDU data payload size
const MAX_PDU_DATA: usize = 1100;
/// Maximum number of EtherCAT frames that can be in flight at any one time.
const MAX_FRAMES: usize = 16;
/// Maximum total PDI length.
const PDI_LEN: usize = 64;
static PDU_STORAGE: PduStorage<MAX_FRAMES, MAX_PDU_DATA> = PduStorage::new();
fn main() {
env_logger::Builder::from_env(Env::default().default_filter_or("info")).init();
// List available network interfaces
let interfaces = pnet_datalink::interfaces();
if std::env::args().len() < 2 {
println!("Please provide a network interface name as an argument.");
println!("\nAvailable interfaces:");
for iface in interfaces {
println!("- {} ({})", iface.name, iface.description);
}
std::process::exit(1);
}
let interface = std::env::args()
.nth(1)
.expect("Provide network interface as first argument.");
// Verify interface exists
if !interfaces.iter().any(|iface| iface.name == interface) {
println!("Error: Interface '{}' not found.", interface);
println!("\nAvailable interfaces:");
for iface in interfaces {
println!("- {} ({})", iface.name, iface.description);
}
std::process::exit(1);
}
log::info!("Discovering EtherCAT devices on {}...", interface);
let (tx, rx, pdu_loop) = PDU_STORAGE.try_split().expect("can only split once");
let maindevice = Arc::new(Client::new(
pdu_loop,
Timeouts::default(),
ClientConfig {
dc_static_sync_iterations: 0,
..ClientConfig::default()
},
));
smol::block_on(async {
#[cfg(target_os = "windows")]
std::thread::spawn(move || {
ethercrab::std::tx_rx_task(
&interface,
tx,
rx,
)
.expect("TX/RX task")
});
#[cfg(not(target_os = "windows"))]
smol::spawn(ethercrab::std::tx_rx_task(&interface, tx, rx).expect("spawn TX/RX task"))
.detach();
let mut group = maindevice
.init_single_group::<MAX_SUBDEVICES, PDI_LEN>()
.await
.expect("Init");
log::info!("Discovered {} SubDevices", group.len());
for subdevice in group.iter(&maindevice) {
log::info!(
"--> SubDevice {:#06x} name {}, {}",
subdevice.configured_address(),
subdevice.name(),
subdevice.identity()
);
}
});
log::info!("Done.");
}
cargo run -- "\Device\NPF_{81772805-D898-4CDF-B345-365BD7BBC028}"
Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.09s
Running `target\debug\Rust-EK1100.exe \Device\NPF_{81772805-D898-4CDF-B345-365BD7BBC028}`
[2025-09-27T19:26:34Z INFO Rust_EK1100] Discovering EtherCAT devices on \Device\NPF_{81772805-D898-4CDF-B345-365BD7BBC028}...
thread 'main' has overflowed its stack
error: process didn't exit successfully: `target\debug\Rust-EK1100.exe \Device\NPF_{81772805-D898-4CDF-B345-365BD7BBC028}` (exit code: 0xc00000fd, STATUS_STACK_OVERFLOW)
(exit code: 0xc00000fd, STATUS_STACK_OVERFLOW)
config.toml
[target.x86_64-pc-windows-msvc]
rustflags = ["-C", "link-args=/STACK:8000000"]
Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.07s
Running `E:\_Rust-Proyectos\Rust-EtherCrab-EK1100\target\debug\Rust-EK1100.exe \Device\NPF_{81772805-D898-4CDF-B345-365BD7BBC028}`
[2025-09-27T19:35:28Z INFO Rust_EK1100] Discovering EtherCAT devices on \Device\NPF_{81772805-D898-4CDF-B345-365BD7BBC028}...
[2025-09-27T19:35:28Z ERROR ethercrab::client] Write service timeout, command Bwr { address: 0, register: 288 }, timeout 30 ms
thread 'main' panicked at src\main.rs:83:14:
Init: Timeout
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
error: process didn't exit successfully: `E:\_Rust-Proyectos\Rust-EtherCrab-EK1100\target\debug\Rust-EK1100.exe \Device\NPF_{81772805-D898-4CDF-B345-365BD7BBC028}` (exit code: 101)
get\debug\Rust-EK1100.exe \Device\NPF_{DEA6B43D-48A2-439B-BDAD-67240E099652}` (exit code: 1)
PS D:\_Rust-Proyectos\Rust-EtherCrab-EK1100> $env:RUST_LOG="debug,ethercrab=trace"; cargo run -- "`\Device\NPF_{DEA6B43D-48A2-439B-BDAD-67240E099652}"
Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.07s
Running `target\debug\Rust-EK1100.exe \Device\NPF_{DEA6B43D-48A2-439B-BDAD-67240E099652}`
[2025-09-27T21:03:18Z INFO Rust_EK1100] Discovering EtherCAT devices on \Device\NPF_{DEA6B43D-48A2-439B-BDAD-67240E099652}...
[2025-09-27T21:03:18Z DEBUG Rust_EK1100] Starting TX/RX task...
[2025-09-27T21:03:18Z DEBUG Rust_EK1100] TX/RX task started successfully
[2025-09-27T21:03:19Z DEBUG Rust_EK1100] Initializing device group...
[2025-09-27T21:03:19Z DEBUG ethercrab::client] Beginning reset
[2025-09-27T21:03:19Z TRACE ethercrab::pdu_loop::storage] Try to allocate frame #0
[2025-09-27T21:03:24Z ERROR ethercrab::client] Write service timeout, command Bwr { address: 0, register: 288 }, timeout 5000 ms
[2025-09-27T21:03:24Z ERROR Rust_EK1100] Failed to initialize device group: Timeout
error: process didn't exit successfully: `target\debug\Rust-EK1100.exe \Device\NPF_{DEA6B43D-48A2-439B-BDAD-67240E099652}` (exit code: 1)
Now I have this problem, it doesn't detect the EK1100...
- Can ethercrab run on Windows 11?
- Do I need a special Ethernet card for it to work?
- Realtek PCIe GbE Family Controller is my network is possible? I have tested it with TwinCAT 3 and the EK1100 works OK with an EL2008 digital output card...
Thanks for sharing your debugging steps.
Can ethercrab run on Windows 11?
I believe so, or it at least definitely runs on Windows 10, as I spent some time developing EtherCrab on Windows 10.
Do I need a special Ethernet card for it to work?
No, a standard NIC should be fine :). Check that TwinCAT isn't running, however - that might be messing stuff up if it's still holding some kind of reference to the NIC you're trying to use with EtherCrab.
Have you looked at examples/windows.rs? It has a few Windows-specific notes and tweaks. I'd still recommend Linux (or macOS at a push) however; Windows has pretty poor performance.