Watchdog
The Linux-CNC firmware includes a watchdog Module by definition. This module cannot be removed.
The watchdog must be petted by LinuxCNC periodically or it will bite. When the watchdog bites, all the board’s I/O pins are pulled low and the stepgen will stop (optionally the stepgen can stop while respecting the acceleration limits, see description). Encoder instances keep counting quadrature pulses.
Resetting the watchdog resumes normal operation of the FPGA.
Configuration
The watchdog does not have any configuration.
Input pins
Name |
Type |
Description |
|---|---|---|
<board-name>.watchdog.timeout_ns |
integer |
The time out (in ns) after which the watchdog will bite. It is recommended to set the watchdog at least 1.5 times the period of the servo-thread to give some leeway. If set too tight, this will lead to a watchdog which bites as soon as there is a latency excursion. |
Output pins
Name |
Type |
Description |
|---|---|---|
<board-name>.watchdog.has_bitten |
hal_bit (i/o) |
Flag indicating that the watchdog has not been petted on time and that it has bitten. should be set to False or 0 to restart the working of the FPGA |
<board-name>.watchdog.timeout_cycles |
integer |
The number of cycles of the FPGA before the watchdog bites (DEBUG). |
Example
loadrt threads name1=servo-thread period1=10000000
loadrt litexcnc
loadrt litexcnc_eth config_file="<path-to-configuration.json>"
loadrt estop_latch
# Add the functions to the HAL
addf <board-name>.read test-thread
...
addf estop-latch.0 servo-thread
...
addf <board-name>.write test-thread
# Setup the watchdog (assuming servo-thread period of 1000000 ns (1 kHz))
setp EMCO5.watchdog.timeout_ns 1500000
# Tie the watchdog into the E-STOP chain
net estop-loopout iocontrol.0.emc-enable-in <= estop-latch.0.ok-out
net estop-loopin iocontrol.0.user-enable-out => estop-latch.0.ok-in
net estop-reset iocontrol.0.user-request-enable => estop-latch.0.reset
net remote-estop estop-latch.0.fault-in <= <board-name>.watchdog.has_bitten
# More sources for E-stop (such as a GPIO-in) can be added to this E-Stop circuit.