Skip to content

ecat ecat-v0.18

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 14 Nov 20:05
· 116 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.

Update from 0.17 or earlier if you use opmode-cmd, homing by the drive, or PP: see the first two points under The component.

Install

First the userspace master, linuxcnc-ethercat-uspace 1.1 or newer (1.3 recommended) from MetalMusings/ethercat: sudo apt install ./linuxcnc-ethercat-uspace_*_amd64.deb.

  • Run-in-place LinuxCNC: unpack ecat-rip-0.18-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.18

The component

  • CSP holds a fixed position while it waits for pos-cmd. After a change into CSP (opmode-cmd, or homing by the drive), the cia402 profile wrote the drive's actual position as the target every cycle until pos-cmd came within 10 counts. A drive that still moved a little, or feeds the target's velocity forward, then ran on at that speed: an ECT60 crept on at 1.5 to 3 mm/s after a change from PV to CSP, without a fault. The position is now taken once and held.
  • PP needs 0x607F only where the drive has it. The file had to set 0x607D:01, 0x607D:02 and 0x607F:00 for mode: pp; the Rtelligent ECT60 has no 0x607F, so PP could not be configured on it. 0x607D:01 and :02 stay required, and the error now says what to add (type DINT, the lowest and highest position in counts). EtherCAT Setup warns, with the bus, when the drive has 0x607F and the file does not set it.

EtherCAT Setup

  • HAL & LinuxCNC: the Joints card always shows the INI file in use, with a button to choose another one or read the same one again (also File > Machine INI file...). Before, it could only be changed on the Master page.
  • Without an INI file, or one without SERVO_PERIOD, the servo period is typed on the Master page, for trying slaves with the I/O test without a machine configuration.
  • The question before Write lists each file with what is done to it, and the plan's notes, such as a .tcl HALFILE turned into a .hal one.
  • With servo-thread-follows-ref-clock: false the window sets ref-clock-sync-cycles to 100 and warns above 100 (also --check): at 1000 the slaves' clock wandered against the servo thread (measured, see below).
  • The window is quicker while editing: the HAL & LinuxCNC page is built only while it is shown.

Tried at a machine (a plasma cutter with three ECT60 drives, LinuxCNC 2.10 run-in-place, QtPlasmaC; details in docs/development.md): cutting with the arc; sync0-shift-ns: auto while moving, also with a CPU load (1 ms); zero-at-start with homing by switches; halcmd stop and start with DC slaves; opmode-cmd between PV and CSP; PP from the window; PV as spindle.0 (M3, M4, S changes, a program, E-stop); DC clock variants (500 us, another reference slave, false with 1, 100 and 1000 sync cycles); the master's messages in the window; and the window's newer cards on a real screen. Not tried yet: the spindle encoder with a spindle running, modular devices, analog terminals, the EL7041, drives with several axes, sync0-shift-ns: auto at 500 us while moving.

Found on the way: the ECT60's velocity actual value (0x606C) is noise; for a PV spindle on it, derive spindle.N.speed-in from pos-fb.