Programming

The programming syntax is based on the axis-specific programming of independent axes [PROG].

After the axis identifier, the parameters of the oscillating motion are defined by keywords and, if applicable, an associated value:

X[<keyword> <(value1)>, [<keyword2> <(value2) >,...]

The characteristic of the oscillating motion is determined by the locations of the reversal positions and the axis feedrate. The reversal positions can be either specified directly or alternatively they are determined automatically via the zero position and the excursion.

The oscillation velocity must be specified. It can be defined by:

If it is not defined, Error ID 50593 is output.

If no restriction occurs due to the dynamic axis characteristics, the frequency and the period are maintained exactly when the linear slope is used and maintained approximately when the non-linear slope is used.

Syntax for programming an oscillation motion:

<axis:name> [ OSC ON | [OFF | OFF FEED=.. | OFF INSTANT]
                         FEED=.. | FREQ=.. | TIME=.. [1ST_POS=.. 2ND_POS=..]

                         | [ ZERO_POS=.. EXCUR=..] [1ST_DELT=.. 2ND_DELT=..] [NBR_OSC=..] { \ } ]

<axis_name>

Name of the oscillating axis

OSC

Identifier for "Oscillating” function. Must always be programmed as the first keyword.

ON

Oscillation on. The motion is stopped at block end when a path motion is active and the oscillating motion is then commanded.

OFF

Oscillation off. Current oscillation cycle is finished. The oscillating axis can then move again in the coordinated motion. If the oscillating motion is stopped implicitly if it is not previously deselected when a new axis motion is programmed.

OFF FEED=..

Fast oscillation stop. The current oscillation cycle is aborted and the axis moves at the specified feedrate to target position (2ND POS). The oscillating axis can then move again in the coordinated motion.

OFF INSTANT

Immediate oscillation stop. Axis stops immediately and can be moved again within the path compound immediately.
Available as of V3.1.3107.38

FEED=..

Feedrate of the oscillating motion in [mm/min, m/min, inch/min]

FREQ=..

Frequency of the oscillating motion in [Hz]

TIME=..

Period of the oscillating motion in [s]

1ST_POS=..

First reversal position in [mm, inch]

2ND_POS=..

Second reversal position in [mm, inch]

ZERO_POS=..

Zero point or zero crossing of the oscillating motion in [mm, inch]

EXCUR=..

Excursion in [mm, inch]

1ST_DELT=..

Wait time at first reversal position in [s]

2ND_DELT=..

Wait time at second reversal position in [s]

NBR_OSC=..

Number of oscillations

\

Separator ("backslash") for clear programming of the command over multiple lines.

Programing Example

prg_example

Programming the oscillating axis

The equals signs between the keyword and the value are optional.

Specifying the oscillating motion path via reversal positions:

N10 X[OSC ON 1ST_POS=-100 2ND_POS=100 FEED=1000]

Specifying the oscillating motion path via the zero position and the excursion:

N20 X[OSC ON ZERO_POS=0 EXCUR=100 FEED=1000]

Specifying oscillation frequency 1 Hertz, 10 oscillations:

N30 X[OSC ON ZERO_POS=0 EXCUR=100 FREQ=1 NBR_OSC=10]

Specifying a 4s oscillating period:

N40 X[OSC ON ZERO_POS=0 EXCUR=100 TIME=4]

Oscillating motion with feed motion of a path axis:

N50 X[OSC ON 1ST_POS=111 2ND_POS=222 FREQ=1]

N60 G01 G90 Y500 F200

Oscillate with wait times of 0.5 s each at reversal positions

N70 X[OSC ON 1ST_POS=-100 1ST_DELT=0.5 2ND_POS=200
      2ND_DELT=0.5 FEED=1000]

Deselecting oscillation:

Oscillation is stopped when reversal position 2 is reached:

N80 X[OSC OFF]

Fast oscillation stop:

If a feedrate is programmed with FEED in combination with OFF, the oscillating motion is stopped immediately (feedhold of oscillating axis) and the reversal position 2 is directly approached at the new feed rate.

N90 X[OSC OFF FEED=5000]

Notice

notice

Restrictions of kinematic transformations

When kinematic transformation (#TRAFO ON) is active, an oscillating motion is only permitted if the kinematics have a basic Cartesian structure and the oscillation direction vector lies in the z axis direction of the machine.

If an oscillating motion is defined by the number of oscillations, it can be aborted before the specified number of oscillations is reached by programming an oscillation stop.