CNC objects of axis-specific distance control

Available as of Build V3.1.3080.12 or V3.1.3107.44

Name

DIST_CTRL_IFC::a_max_int

Description

Maximum acceleration of the linear slope.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3000

Data type

REAL64

Length

8

Attributes

read

Unit

[0.1 µm/s²]

Remarks

 

Name

DIST_CTRL_IFC::sloped_delta_deviation

Description

The deviation to be executed in this cycle after being influenced by the slope.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3001

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

 

Name

DIST_CTRL::m_actual_offset

Description

Current offset to the interpolated command position of the drive as specified by distance control.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3100

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

 

Name

DIST_CTRL::v_max_int

Description

Maximum permissible velocity of the axis.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3102

Data type

REAL64

Length

8

Attributes

read

Unit

[0.1 µm/s]

Remarks

 

Name

DIST_CTRL::set_distance

Description

Set command distance of the tool to the surface.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3103

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

Only effective in “SET_DIST” mode

Name

DIST_CTRL::set_pos

Description

Set command value of the workpiece surface.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3104

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

Only effective in “SET_POS” mode

Name

DIST_CTRL::state

Description

Current internal state of distance control

0: IDLE

2: ACTIVE

3: FREEZE

4: OFF

5: OFF_NO_MOVE

6-12: ERROR

15:DRYRUN

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3105

Data type

UNS32

Length

4

Attributes

read

Unit

[-]

Remarks

 

Name

DIST_CTRL::kp

Description

Weighting the distance control output values. Parameterisation can be executed analogous to P-AXIS-00759. The value range is limited to 0.0 < KP <= 2.0. For KP values less than 1.0, the distance control dynamics are reduced; for KP values greater than 1.0, the dynamics are increased.

A KP factor less than 1 reduces a possible distance control oscillation and steadies control in the event of minor distance errors.
[as of V2.11.2809.06 or V3.1.3079.06]

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3106

Data type

REAL64

Length

8

Attributes

read/ write

Unit

[-]

Remarks

The new values only become effective with the following transitions for safety reasons

  1. From INACTIVE to ACTIVE state
  2. From FREEZE to ACTIVE state

Name

DIST_CTRL::i_tn

Description

Integral action time of the PID controller in [s]. The integral action time defines the time after which the P and I components of the manipulated variable are equal. Parameterisation can be executed analogous to P-AXIS-00764. The value range is limited to 0.0 <= I_TN <= 50.0. A large integral action time produces greater control stability. The shorter the integration action time, the greater the I component and the faster the control. A short integral action time excites oscillations more strongly.
[as of V2.11.2809.06 or V3.1.3079.06]

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3107

Data type

REAL64

Length

8

Attributes

read/ write

Unit

[s]

Remarks

The new values only become effective with the following transitions for safety reasons

  1. From INACTIVE to ACTIVE state
  2. From FREEZE to ACTIVE state

Name

DIST_CTRL::d_tv

Description

Derivative action time of the PID controller in [s]. The derivative action time defines the time after which the P and D components of the manipulated variable are equal. Parameterisation can be executed analogous to P-AXIS-00765. The value range is limited to 0.0 <= D_TV <= 2.0. The larger the derivative action time, the stronger the D component.
[as of V2.11.2809.06 or V3.1.3079.06]

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3108

Data type

REAL64

Length

8

Attributes

read/ write

Unit

[s]

Remarks

The new values only become effective with the following transitions for safety reasons

  1. From INACTIVE to ACTIVE state
  2. From FREEZE to ACTIVE state

Name

DIST_CTRL::smoothing_fact

Description

Currently set smoothing factor of the exponential averaging filter analogous to P-AXIS-00784. Specifies the weighting of the current measured value.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3109

Data type

REAL64

Length

8

Attributes

read

Unit

[-]

Remarks

 

Name

DIST_CTRL::kalman_sigma

Description

Currently set uncertainty of the included measured values analogous to P-AXIS-00783.
[as of V3.1.3079.23]

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>310A

Data type

REAL64

Length

8

Attributes

read

Unit

[-]

Remarks

 

Name

DIST_CTRL::n_cycles

Description

Currently set number of measured values used for filtering according to P-AXIS-00413.
[as of V3.1.3079.23]

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>310B

Data type

SGN32

Length

4

Attributes

read

Unit

[-]

Remarks

 

Name

DIST_CTRL::skip_dist_ctrl

Description

Not in use - in preparation

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>310C

Data type

BOOLEAN

Length

1

Attributes

read

Unit

[-]

Remarks

 

Name

DIST_CTRL::filter_type

Description

Active filter type to smooth sensor values.

Filter types for smoothing sensor values, see P-AXIS-00782.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>310D

Data type

STRING

Length

30

Attributes

read

Unit

[-]

Remarks

 

Name

DIST_CTRL::max_dist_change

Description

Maximum change in sensor values per cycle. Required for the “Kalman_DYN” filter.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>310E

Data type

REAL64

Length

8

Attributes

read

Unit

[0.1 µm]

Remarks

Filter not yet available.

Name

DIST_CTRL::filtered_feedback

Description

Filtered feedback value.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>310F

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

 

Name

DIST_CTRL::feedback_value

Description

Calculated distance control feedback value.

SET_DIST mode:

Measured actual distance between the interpolated command position of the drive and the surface.

SET_DIST (use_both_encoder) and SET_POS modes:

Measured position of the real surface in the selected coordinate system.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3110

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

 

Name

DIST_CTRL::target_deviation

Description

SET_DIST mode:

Current difference between the interpolated command position of the dive and the set command distance to the surface.

SET_POS mode:

Current difference between the measured real surface and the specified command surface.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3111

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm] I

Remarks

Filtered sensor values are included in this value.

Name

DIST_CTRL::delta_deviation_pre_limiter

Description

The distance to be executed in this cycle before being influenced by the limiter. Influenced by the PID controller.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3112

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

SET_DIST:
For kp=1, this is the distance to go between the actual position of the tool and the set command distance to the surface.

SET_POS:
For kp=1, this is the distance to go to be executed in order to compensate for the difference between the actual position of the tool and the real surface.

Name

DIST_CTRL::sensor_value

Description

Return value of the sensor.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3113

Data type

SGN64

Length

8

Attributes

read

Unit

[0.01 nm]

Remarks

 

Name

DIST_CTRL_PARAM[0]::v_max

Description

The maximum velocity set by P-AXIS-00415 when a position offset is executed.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3500

Data type

SGN32

Length

4

Attributes

read/ write

Unit

[µm/s]

Remarks

The new values only become effective with the following transitions for safety reasons

  1. From INACTIVE to ACTIVE state
  2. From FREEZE to ACTIVE state

Name

DIST_CTRL_PARAM[0]::a_max

Description

The maximum acceleration set by P-AXIS-00416 when a position offset is executed.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3501

Data type

SGN32

Length

4

Attributes

read/ write

Unit

[mm/s²]

Remarks

The new values only become effective with the following transitions for safety reasons

  1. From INACTIVE to ACTIVE state
  2. From FREEZE to ACTIVE state

Name

DIST_CTRL_IFC::actual_offset

Description

Offset to the interpolated command position of the drive currently output by distance control to the drive.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3900

Data type

SGN32

Length

4

Attributes

read

Unit

[Incr.]

Remarks

The drive resolution and the gear ratio are included in this value.

Name

DIST_CTRL_IFC::delta_offset

Description

Delta currently output to the drive indicating that the cycle must be executed.

Task

GEO (Port 551)

Index group

0x120300

Index offset

0x<AID>3901

Data type

SGN32

Length

4

Attributes

read

Unit

[Incr.]

Remarks

The drive resolution and the gear ratio are included in this value.