Skip to content

ecat ecat-v0.19

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 16 Nov 03:40
· 90 commits to main since this release

ecat for LinuxCNC 2.10. There are no 2.10 packages for Debian yet, so the main way to install is for a run-in-place LinuxCNC; there is a package too.

Install

First the userspace master, linuxcnc-ethercat-uspace 1.4 (needed for EoE and eoe: {host-ip}; ecat 0.19 also runs on 1.1 to 1.3 without them) from MetalMusings/ethercat: sudo apt install ./linuxcnc-ethercat-uspace_*_amd64.deb.

  • Run-in-place LinuxCNC: unpack ecat-rip-0.19-debian13.tar.gz (or -debian12) and run ./install. It puts ecat.so in your tree's rtlib and ecatsetup in ~/.local/bin; ./install --uninstall takes it away. ecat.so is built against one LinuxCNC, commit b0e7b191b9 (2.10.0~pre2-436): the installer compares your tree's HAL headers with that build's and refuses on any difference (a different HAL API could crash a machine), and then says how to build ecat for your LinuxCNC from source.
  • LinuxCNC 2.10 package: linuxcnc-ecat_*.deb (debian12, debian13).

LinuxCNC 2.9 users take ecat-v0.11. The window, ecatsetup --gui, needs python3-pyqt5. To try ecat without disturbing your setup: getting started. See the README.

What is new in 0.19

Serial channels (EL6001, EL6002, EL6021, EL6022). A serial terminal's channel becomes a serial port on the computer (/dev/ttyECAT4) that mb2hal and Modbus VFDs use like /dev/ttyUSB0: serial: per slave, baud, frame, send continuous, the settings changed by the program on the port while running, status pins; EtherCAT Setup proposes the channel, has a Serial ports card with mb2hal's lines, and the HAL check warns when mb2hal's parity or data bits differ from the channel's. How-to: A Modbus VFD on a serial terminal. Not tried on a real terminal (we have none): built from Beckhoff's manual and tried over a real wire, mb2hal against a Modbus slave, 2400 to 115200 baud, with a slave of our own (an EaserCAT 3000) made to behave as an EL6021, in halrun. A capture from a real terminal (ecatsetup --capture) is welcome.

Ethernet over EtherCAT (EoE). eoe: per slave gives a slave that speaks EoE an IP address, and host-ip gives the computer an address on the slave's network device eoe0s<position>, so that a device's web page opens in a browser while LinuxCNC runs. EtherCAT Setup has a Network (EoE) card that proposes a free subnet. Needs master 1.4. How-to: A device's web page over EoE. Tried on one slave of our own (an EaserCAT 3000 with a web server): in halrun, and in LinuxCNC with traffic while a plasma cutter homed and jogged (7458 of 7458 pings answered, no events, no following errors); not on a bought device, nor with two EoE slaves on one bus.

EtherCAT Setup: the window's new cards above; --capture / Save capture... also records what a serial terminal does.

Everything else in 0.18 is unchanged; the component's cia402, encoder and analog functions are as they were.