Repository navigation
ecat ecat-v0.18
Pre-releaseecat 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 putsecat.soin your tree'srtlibandecatsetupin~/.local/bin;./install --uninstalltakes it away.ecat.sois 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 untilpos-cmdcame 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
0x607Fonly where the drive has it. The file had to set0x607D:01,0x607D:02and0x607F:00formode: pp; the Rtelligent ECT60 has no0x607F, so PP could not be configured on it.0x607D:01and:02stay 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 has0x607Fand 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
.tclHALFILE turned into a.halone. - With
servo-thread-follows-ref-clock: falsethe window setsref-clock-sync-cyclesto 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.