EtherCAT-Master auf MikroTik hEX S (2025) mit Tether und Containern

End-to-End-Rezept: Einen echten EtherCAT-Master in einem Container auf einem MikroTik hEX S 2025 (E60iUGS) betreiben, mit Tethers list_slaves-Beispiel — verifiziert durch die Entdeckung von 2 SOMANET-Circulo-CiA402-Achsen über einen dedizierten Ethernet-Port.

Die Bausteine

BedingungLösung
EN7562CT-CPU führt nur arm32v5-Binaries ausstatisches musl-Binary cross-kompilieren (armv5l-linux-musleabi, GCC 11)
EtherCAT braucht rohen L2-Zugriff auf eine NICether4 dem Container über eine Zwei-Port-Bridge widmen
AF_PACKET-Raw-Socketsprivileged=yes am Container
NAND ist 128 MiBContainer-Rootfs + Layer auf USB (/usb1, ext4)
Binary muss in den Container/container/mounts-Bind-Mount eines Host-Verzeichnisses

1. Router-Seite: dedizierter EtherCAT-Port

ether4 verlässt die LAN-Bridge und tritt einer Bridge bei, die nur zwischen dem Port und dem veth des Containers existiert — eine reine L2-Röhre:

ecat-bridge.rsc
/interface/bridge/port/remove [find interface=ether4]
/interface/bridge/add name=ecat
/interface/bridge/port/add bridge=ecat interface=ether4
/interface/veth/add name=veth-ecat        # no address: pure L2
/interface/bridge/port/add bridge=ecat interface=veth-ecat

2. Container-Einrichtung

Der Container (hier arm32v5/debian:bookworm-slim — denk dran, nur armv5 auf dieser CPU) bekommt zwei Interfaces: veth1 behält NAT-IP-Konnektivität, veth-ecat ist die EtherCAT-Leitung:

container.rsc
/container/set debian:bookworm-slim interface=veth1,veth-ecat \
    privileged=yes cmd="sleep 100000"
/file/add type=directory name=usb1/hostshare
/container/mounts/add list=bins src=/usb1/hostshare dst=/mnt
/container/set debian:bookworm-slim mountlists=bins     # stop container first
/container/start debian:bookworm-slim

3. list_slaves für armv5 bauen

Tether (~/dev/Tether) ist ein C++23-EtherCAT-Master-Framework. Mit der musl.cc-Cross-Toolchain und einem CMake-Preset arm32v5 (Toolchain-Datei cmake/toolchain-armv5l-musl.cmake: -march=armv5te -mfloat-abi=soft -static, plus -latomic für die fehlenden 8-Byte-Atomics):

build.sh
cmake --preset arm32v5
cmake --build --preset arm32v5 --target list_slaves -j8
file build-arm32v5/bin/list_slaves
# ELF 32-bit LSB pie executable, ARM, EABI5, static-pie linked
scp -O build-arm32v5/bin/list_slaves admin@10.9.99.115:usb1/hostshare/list_slaves

GCC 11 fehlen <format>/<print>/<expected> — Tethers Build aktiviert automatisch {fmt}/tl::expected-Shim-Header, sodass C++23-Code unverändert kompiliert.

4. Ausführen

run.sh
ssh -t admin@10.9.99.115        # /container/shell needs a TTY
shell.rsc
/container/shell debian:bookworm-slim
output.txt
# /mnt/list_slaves -i veth-ecat -v
list_slaves (host)  —  interface: veth-ecat
wire probe: reply in 1051 us (tag delivery = untagged)
Kernel cBPF filter attached (13 insns)
ethercat: Master started
=== Discovered 2 slave(s) ===
Slave 0: SOMANET Circulo CiA402 Drive safe motion
  Vendor=0x000022D2 Product=0x00000302 Rev=0x11000003
  Mailbox protocols: CoE FoE
  Mailbox: std RX@0x1000 (1024B), TX@0x1400 (1024B)
  SM3: Process Output (RxPDO) start=0x1800 len=46
  SM4: Process Input  (TxPDO) start=0x1C00 len=78
  FMMUs: 4   Physical ports: 0x0011
Slave 1: SOMANET Circulo CiA402 Drive safe motion   (identical)
ethercat: Master stopped cleanly

Der Wire-Probe mit ~1 ms Antwort bestätigt echtes L2-Passthrough: EtherCAT-Frames gehen Container → veth-ecat → ecat-Bridge → ether4 → Achsen und zurück.

Einschränkungen

  • Nur arm32v5 — alles andere SIGILLt sofort; dieses Gerät kann keine Stock-armv7/aarch64-Images ausführen.
  • ether4 ist dediziert — nicht mehr Teil des LAN; das Segment ist nur über den Container erreichbar.
  • Kein Hardware-Timestamping über den veth-Pfad — ok für Discovery/CoE-Arbeit, aber bewerte die DC-Sync-Qualität entsprechend.
  • list_slaves ist ein Scan-Werkzeug; zyklischer PDO-Austausch in einem Container auf einem 2-Kern-ARMv5 funktioniert, aber erwarte keine harte Echtzeit — für Regelschleifen überlege, ob dies der richtige Host ist.

Ähnliche Beiträge nach Kategorie: EtherCAT MikroTik Embedded Netzwerke