LinuxCNC Documentation

SYNOPSIS

loadrt plasmac

DESCRIPTION

A plasma cutting table control component for use with the LinuxCNC 2.10.

VERSION

016

SUMMARY

Usage of this component is demonstrated in the QtPlasmaC example configurations included with LinuxCNC.

DISCLAIMER

THE AUTHOR OF THIS SOFTWARE ACCEPTS ABSOLUTELY NO LIABILITY FOR ANY HARM OR LOSS RESULTING FROM ITS USE.

IT IS EXTREMELY UNWISE TO RELY ON SOFTWARE ALONE FOR SAFETY.

Any machinery capable of harming persons must have provisions for completely stopping all motors and moving parts etc. before persons enter any danger area.

All machinery must be designed to comply with local and national safety codes, and the author of this software can not, and does not, take any responsibility for such compliance.

FUNCTIONS

plasmac.-

PINS

plasmac.arc-fail-delay real in

arc start failure timeout (seconds)

plasmac.arc-lost-delay real in

arc lost delay during a cut (seconds)

plasmac.arc-ok-high real in

maximum voltage level for Arc OK signal [mode 0] (volts)

plasmac.arc-ok-in bool in

external arc ok input signal [mode 1 & mode 2]

plasmac.arc-ok-low real in

minimum voltage level for Arc OK signal [mode 0] (volts)

plasmac.arc-max-starts si32 in

maximum attempts at starting the arc

plasmac.arc-voltage-in real in

arc voltage input [mode 0 & mode 1] see Notes above

plasmac.arc-voltage-offset real in

offset to set arc voltage to 0 at 0 volts

plasmac.arc-voltage-scale real in

scale to convert arc_voltage input to actual volts

plasmac.axis-x-max-limit real in

axis x maximum limit, connect to ini.x.max-limit

plasmac.axis-x-min-limit real in

axis x minimum limit, connect to ini.x.min-limit

plasmac.axis-x-position real in

current x axis position, connect to axis.x.pos-cmd

plasmac.axis-y-max-limit real in

axis y maximum limit, connect to ini.y.max-limit

plasmac.axis-y-min-limit real in

axis y minimum limit, connect to ini.y.min-limit

plasmac.axis-y-position real in

current y axis position, connect to axis.y.pos-cmd

plasmac.axis-z-max-limit real in

axis z maximum limit, connect to ini.z.max-limit

plasmac.axis-z-min-limit real in

axis z minimum limit, connect to ini.z.min-limit

plasmac.axis-z-position real in

current z axis position, connect to joint.N.pos-fb

plasmac.breakaway bool in

torch breakaway switch (optional, see float_switch)

plasmac.consumable-change bool in

change consumables in torch

plasmac.cornerlock-enable bool in

enable corner lock

plasmac.cornerlock-threshold real in

corner lock threshold (% of requested feed rate), speeds below this disable THC

plasmac.current-velocity real in

current machine velocity, connect to motion.current-vel

plasmac.cut-feed-rate real in

cut feed rate from current material (machine units per minute)

plasmac.cut-height real in

cut height (machine units)

plasmac.cut-recovery bool in

recover from cut error

plasmac.cut-volts real in

cut voltage (volts)

plasmac.cutting-start bool in

start a new cut, connect to spindle.0.on

plasmac.debug-print bool in

if true will print state changes as a debug aid

plasmac.dry-run bool in

perform a dry run without probing

plasmac.external-estop bool in

external E-stop input

plasmac.feed-override real in

feed override value from GUI (connect to halui.feed-override.value)

plasmac.feed-reduction real in

reduce adaptive feed to this percentage (connect to motion.analog-out-03)

plasmac.feed-upm real in

requested feed_rate, connect to motion.feed-upm to use as the default (G-code units per minute)

plasmac.float-switch bool in

float switch input (can also act as breakaway if it actuates when torch breaks away)

plasmac.float-switch-travel real in

float switch travel (machine units)

plasmac.gcode-scale real in (default: 1)

current G-code scale

plasmac.height-override real in

height override adjustment (volts)

plasmac.height-per-volt real in

torch height change per volt (machine units)

plasmac.homed bool in

machine is homed

plasmac.ignore-arc-ok-0 bool in

Do not require arc ok for start or cutting.

plasmac.ignore-arc-ok-1 bool in

Do not require arc ok for start or cutting.

plasmac.kerf-width real in

placeholder for better G-code portability between GUIs

plasmac.laser-mode bool in

laser mode for fiber lasers

plasmac.laser-recovery-start si32 in

start laser offset for cut recovery

plasmac.laser-x-offset si32 in

alignment laser x axis offset (scaled units)

plasmac.laser-y-offset si32 in

alignment laser y axis offset (scaled units)

plasmac.lowpass-frequency real in

lowpass cutoff frequency for arc voltage output

plasmac.machine-is-on bool in

machine is on signal, connect to halui.machine.is-on

plasmac.material-thickness real in

material thickness (machine units)

plasmac.max-offset si32 in (default: 5)

maximum height offset (mm)

plasmac.mesh-arc-ok bool in (default: FALSE)

Do not require arc ok for mesh mode.

plasmac.mesh-enable bool in

enable mesh cutting mode

plasmac.mode si32 in

operating mode

plasmac.motion-type si32 in

motion type, connect to motion.motion-type

plasmac.move-down bool in

external thc down switch [mode 2]

plasmac.move-up bool in

external thc up switch [mode 2]

plasmac.multi-tool bool in (default: 1)

allows the use of multiple tools

plasmac.offset-feed-rate real in

probe offset velocity (machine units per minute)

plasmac.offset-probe-delay real in

wait for probe to deploy (seconds)

plasmac.offset-probe-x real in

X axis offset for offset probe (machine units)

plasmac.offset-probe-y real in

Y axis offset for offset probe (machine units)

plasmac.offset-set-probe bool in

deploy probe for setting offsets

plasmac.offset-set-scribe bool in

deploy scribe for setting offsets

plasmac.offsets-active bool in

offsets are active, connect to motion.eoffset-active

plasmac.offsets-limited bool in

offsets are limited, connect to motion.eoffset-limited

plasmac.ohmic-max-attempts si32 in

maximum ohmic probe attempts before fallback to float switch

plasmac.ohmic-probe bool in

ohmic probe input, from ohmic-sense-out or external component/pin

plasmac.ohmic-probe-enable bool in

enable ohmic probe

plasmac.ohmic-probe-offset real in

Z axis offset for ohmic probe (machine units)

plasmac.ohmic-sense-on-delay si32 in (default: 3)

debounce cycles for ohmic sense on

plasmac.ohmic-sense-off-delay si32 in (default: 3)

debounce cycles for ohmic sense off

plasmac.ohmic-sense-in bool in

ohmic sense relay input

plasmac.ohmic-test bool in

test for shorted torch

plasmac.ok-sample-counts si32 in (default: 10)

arc_ok number of valid samples required [mode 0]

plasmac.ok-sample-threshold real in (default: 10)

arc_ok maximum arc voltage deviation allowed [mode 0]

plasmac.override-jog bool in

override jog inhibit

plasmac.pause-at-end real in

time to pause at end of cut

plasmac.paused-motion-speed real in

multiplier for speed of motion when paused, from -1 to 1

plasmac.pid-d-gain real in

derivative gain input [mode 0 & mode 1]

plasmac.pid-i-gain real in

integral gain input [mode 0 & mode 1]

plasmac.pid-p-gain real in

proportional gain input [mode 0 & mode 1]

plasmac.pierce-delay real in

time required to pierce stock (seconds)

plasmac.pierce-height real in

pierce height (machine units)

plasmac.probe-feed-rate real in

probe down velocity (machine units per minute)

plasmac.probe-final-speed si32 in (default: 1)

final probe speed (steps per servo period)

plasmac.probe-start-height real in

probe starting height

plasmac.probe-test bool in

probe test only

plasmac.program-is-idle bool in

program is idle, connect to halui.program.is-idle

plasmac.program-is-paused bool in

program is paused, connect to halui.program.is-paused

plasmac.program-is-running bool in

program is running, connect to halui.program.is-running

plasmac.puddle-jump-delay real in

Delay move from pierce height to cut height (seconds), leave disconnected if not required.

plasmac.puddle-jump-height real in

Puddle jump height (percentage of pierce height), leave disconnected if not required.

plasmac.requested-velocity real in

deprecated

plasmac.resolution si32 in (default: 100)

multiplier for resolution of the offset counts

plasmac.restart-delay real in

time from arc failure till next restart attempt

plasmac.safe-height real in

requested safe traverse height (machine units)

plasmac.scribe-arm-delay real in

delay from scribe arm to scribe on

plasmac.scribe-on-delay real in

delay from scribe on to motion beginning

plasmac.scribe-start bool in

start a new scribe, connect to spindle.1.on

plasmac.setup-feed-rate real in

feed rate for moves to pierce and cut heights (machine units per minute)

plasmac.skip-ihs-distance real in

skip IHS if less than this distance from last cut

plasmac.slat-height real in

slat height (machine units)

plasmac.spotting-start bool in

start a new spot, connect to spindle.2.on

plasmac.spotting-threshold real in

threshold voltage to start spotting delay

plasmac.spotting-time real in

torch off delay after spotting threshold reached

plasmac.thc-auto bool in

enable automatic thc activation

plasmac.thc-delay real in

delay from cut feed rate reached to THC activate (seconds) [non auto THC]

plasmac.thc-disable bool in

thc disable

plasmac.thc-enable bool in

enable/disable thc and set the IHS skip type

plasmac.thc-feed-rate real in

maximum feed rate for thc (machine units per minute)

plasmac.thc-sample-counts si32 in (default: 50)

thc number of valid samples required [auto THC]

plasmac.thc-sample-threshold real in (default: 1)

thc maximum arc voltage deviation allowed [auto THC]

plasmac.thc-threshold real in

thc threshold (volts), changes below this have no effect

plasmac.torch-enable bool in

enable torch

plasmac.torch-off bool in

turn torch off

plasmac.torch-pulse-abort bool in

torch pulse abort

plasmac.torch-pulse-hold bool in

torch pulse hold

plasmac.torch-pulse-start bool in

torch pulse start

plasmac.torch-pulse-time real in

torch pulse time (seconds)

plasmac.tube-cut bool in

set the current job as tube cutting

plasmac.units-per-mm real in

for scale calcs, connect to halui.machine.units-per-mm

plasmac.use-auto-volts bool in

use calculated voltage for thc baseline

plasmac.voidlock-enable bool in

enable voidlock [mode 0 & mode 1]

plasmac.voidlock-off-cycles si32 in (default: 10)

number of sampling cycles to deactivate voidlock

plasmac.voidlock-on-cycles si32 in (default: 2)

number of sampling cycles to activate voidlock

plasmac.voidlock-slope si32 in (default: 500)

voidlock slope in volts per second

plasmac.x-offset si32 in

offset to apply to axis x for consumable change and cut recovery (scaled units)

plasmac.x-offset-current real in

current x axis offset, connect to axis.x.eoffset

plasmac.xy-feed-rate real in

feed-rate for consumable change

plasmac.y-offset si32 in

offset to apply to axis y for consumable change and cut recovery (scaled units)

plasmac.y-offset-current real in

current y axis offset, connect to axis.y.eoffset

plasmac.z-offset-current real in

current z axis offset, connect to axis.z.eoffset

plasmac.zero-window real in (default: 0.1)

sets window that voltage fluctuations show as zero (-0.1 to 0.1 at default value)

plasmac.pierce-type si32 in (default: 0)

allows motion to progress during pierce. 0=No movement, 1=Wiggle, 2=Ramp

plasmac.pierce-motion-delay real in (default: 0)

delay starting motion during pierce delay period. This is a % of Pierce Delay. Only used when pierce-with-motion is True.

plasmac.cut-height-delay real in (default: 0)

at the end of transition to end-pierce-height how long to pause before transition to cut height.

plasmac.pierce-end-height real in (default: 0)

height at end of piercing (in machine units). Can be different to Cut Height. Default 0 means not used. i.e. no change in height.

plasmac.gouge-speed real in (default: 0)

ramp starting speed for gouge. In machine units/min.

plasmac.gouge-speed-distance real in (default: 0)

distance gouge will run in machine units. Gouge plus creep distance should not be longer than any lead in.

plasmac.creep-speed real in (default: 0)

ramp creep or intermediate speed. Comes after gouge and is before cut speed. In machine units/min.

plasmac.creep-speed-distance real in (default: 0)

distance creep will run in machine units. Gouge plus creep distance should not be longer than any lead in.

plasmac.adaptive-feed real out

for reverse-run, connect to motion.adaptive-feed

plasmac.arc-ok-out bool out

arc ok output

plasmac.arc-voltage-out real out

arc voltage output [mode 0 & mode 1]

plasmac.consumable-changing bool out

consumables are being changed

plasmac.cornerlock-is-locked bool out

corner locked indicator

plasmac.current-feed-rate real out

current feed rate per minute (for auto-thc)

plasmac.cut-length real out

length of current cut job

plasmac.cut-recovering bool out

recovering from cut error

plasmac.cut-time real out

cut time of current job

plasmac.cutting-stop bool out

stop manual cut, connect to halui.spindle.0.stop

plasmac.feed-hold bool out

feed hold, connect to motion.feed-hold

plasmac.jog-inhibit bool out

jog inhibit, connect to motion.jog-inhibit

plasmac.laser-recovery-state si32 out

laser recovery status

plasmac.led-down bool out

thc move down indicator

plasmac.led-up bool out

thc move up indicator

plasmac.offset-scale real out

offset scale, connect to axis.<x y z>.eoffset-scale

plasmac.ohmic-enable bool out

on only while probing

plasmac.ohmic-sense-out bool out

ohmic sense output state

plasmac.paused-motion bool out

paused motion flag, true when paused motion is active

plasmac.paused-time real out

paused time during current job

plasmac.pierce-count si32 out

number of pierce attempts (torch starts)

plasmac.probe-out bool out

probe for tube cutting, connect to motion.probe-input

plasmac.probe-test-error bool out

minimum limit reached while probe testing

plasmac.probe-time real out

probe time of current job

plasmac.program-pause bool out

pause the current program, connect to halui.program.pause

plasmac.program-resume bool out

resume the currently paused program, connect to halui.program.resume

plasmac.program-run bool out

run the currently loaded program, connect to halui.program.run

plasmac.program-stop bool out

stop current program, connect to halui.program.stop

plasmac.rapid-time real out

rapid motion time of current job

plasmac.requested-feed-rate real out

requested feed rate (for auto-thc)

plasmac.run-time real out

run time of current job

plasmac.safe-height-is-limited bool out

safe height is limited indicator

plasmac.sensor-active bool out

one of float, ohmic, or breakaway is detected

plasmac.scribe-arm bool out

arm the scribe

plasmac.scribe-on bool out

turn scribe on

plasmac.state-out si32 out

current state

plasmac.stop-type-out si32 out

current stop type

plasmac.thc-active bool out

thc status output

plasmac.thc-enabled bool out

thc is enabled

plasmac.torch-on bool out

turn torch on, connect to your torch on input

plasmac.torch-time real out

torch on time of current job

plasmac.voidlock-is-locked bool out

voidlock is locked indicator [mode 0 & mode 1]

plasmac.x-offset-counts si32 out

x offset for consumable change, connect to axis.x.eoffset-counts

plasmac.xy-offset-enable bool out

enable x and y offsets, connect to axis.<x & y>.eoffset-enable

plasmac.y-offset-counts si32 out

y offset for consumable change, connect to axis.y.eoffset-counts

plasmac.z-height real out

current z axis height relative to the probed zero height

plasmac.z-offset-counts si32 out

z offset for height control, connect to axis.z.eoffset-counts

plasmac.z-offset-enable bool out

enable z offsets, connect to axis.z.eoffset-enable

plasmac.z-relative real out

distance of Z from last probed height

plasmac.low-cut-volts si32 in

low cut voltage threshold while thc active

plasmac.target-samples si32 in (default: 6)

number of samples for setting target_volts

plasmac.target-volts real out

target voltage for thc, set by arc voltage at cut height

AUTHOR

Phillip A Carter & Gregory D Carl

LICENSE

GPLv2 or greater