Interface-Specific Options

• AAxisMax = 181.0 – Indicates the A axis maximum end-of-stroke value that can be commanded of a wrist device.

• AAxisMin = -181.0 – Indicates the A axis minimum end-of-stroke value that can be commanded of a wrist device.

• AllowForcedHits – Is only applicable if you are using a fixed probe.

• True – You can type Ctrl + H to take a hit. If this feature is enabled, you can press Ctrl + H to cause PC-DMIS to read and interpret a hit at that position. If you are not using a fixed probe, Ctrl + H has no effect, regardless of the value of this entry.

• False – This feature is disabled.

• AlwaysSendEnableObserverOnScan = True – Enables the controller's Observer functionality if you perform analog scans when the value is True.

• AlwaysSendWAngles = False – Sends W angles with all XYZ moves if the value is True. The value should only be True for some Leitz machines.

• ARM2CompMode = False – Is part of the generic VolComp support for interfaces. If you are using external VolComp, you should set the value to True for any horizontal arm that has a negative stroke as it extends (the common example is when the arm extends in the –Y direction). This is usually the case for Arm 2 on a dual-arm system.

This entry is not normally used with this interface as the VolComp is almost always done inside the controller.

• AutoTriggerEnabled = False – To allow the response to a position request to be treated as a manual hit when a manual hit has been requested but you are using a fixed probe (which can’t actually trigger), set the value to True.

AxisX = 0

AxisY = 2

AxisZ = 4

These values are used when re-assigning axes so that the axes used in PC-DMIS are different from what is used natively on the controller. Usually, you use the Axis tab in the Machine Options dialog box to set them. The variable name represents the PC-DMIS axis.

The value indicates the native machine axis according to this key:

0 = X+

1 = X-

2 = Y+

3 = Y-

4 = Z+

5 = Z-

When making axis re-assignments, the resulting coordinate system should be right-handed.

• BAxisMax = 181.0 – Indicates the B axis maximum end-of-stroke value that can be commanded of a wrist device.

• BAxisMin = -181.0 – Indicates the B axis minimum end-of-stroke value that can be commanded of a wrist device.

• CaxisMax = 181.0 – Indicates the C axis maximum end-of-stroke value that can be commanded of a wrist device.

• CAxisMin = -181.0 – Indicates the C axis minimum end-of-stroke value that can be commanded of a wrist device.

• COMPENS_FILE_NAME = compens.dat – Is part of the generic VolComp support for interfaces. This is the name of the compensation map data file that is used if UseVolcomp is set to either 1 or 2. This specification may include a path.

This entry is not normally used with this interface as the VolComp is almost always done inside the controller.

• ConstantSpatialDensity

• True – The density of the measured points is kept constant during the scan path.

• False – The speed modulates the scan density. This means that it is equal to the specified value at the nominal scanning speed. If the speed is reduced because of the surface curvature, the distance between measured points decreases proportionally to the speed.

• ContinuousTempSensor = True

• True – The machine has a temperature sensor that remains in continuous contact with the part being measured.

• False – The machine has a temperature sensor that must be manually held in contact with the part being measured. It must be held long enough to obtain a valid part-temperature reading. This setting only applies if temperature compensation is enabled and is set to have the controller perform the thermal compensation for the part.

• ConvertToDEABridgeAxisConvention

• False – You are using a horizontal machine.

• True – The value only needs to be True if a bridge machine has been compensated with a DEA map that is on the computer.

• CW43LAirTestDelayTC = 0 – Is an integer delay time in milliseconds. If the value is greater than 0, PC-DMIS waits for this length of time. It then sends a command to change the air state (on or off) before it starts checking the status to verify that it has completed.

• CW43LThirdAxisTCLeftToRightLift = True

• CW43LThirdAxisTCSlot = -1 – Indicates the number of the CW43L probe changer slot in which the third axis C Joint is located. When the continuous C Joint port is not present in the probe changer, the value should be -1.

• CW43LThirdAxisTCVerticalSlot = -1

• CW43LTRecoverEmeTC = False – Applies only when the third axis wrist is present. If the value is True, the third axis is homed (if needed) if an emergency occurs during a probe change operation.

• CW43LTRestoreWristAfterTC – Determines whether PC-DMIS performs an angle rotation to restore previous the AB angle after a probe change (probe change) operation using a CW43L probe changer.

• 1 – The probe changer restores the wrist to the AB angle it used before the change.

• 0 – The probe changer does not perform the final angle rotation that restores the prior wrist values.

Available from Leitz interface version 3.41.

• CW43LTTCAntiCrashMode = False – To enable a special mode for CW43L probe changes that’s designed to be more careful about preventing possible crashes, set the value to True. It performs extra testing of the air status at various stages before it continues with following operations. It also uses the setting for the CW43LTTCAntiCrashSpeed entry to override regular speeds from the measurement routine, and so on.

• CW43LTTCAntiCrashSpeed = 0.0 – Is used if the CW43LTTCAntiCrashMode entry is set to True. It specifies a speed to be used during the anti-crash mode changes.

• If you are using absolute speeds, the value should be in mm/sec.

• If you are using relative speeds, the value should be a percentage of the maximum move speed.

• CW43LTTest3AxisSlotTC = True – Applies if the third axis wrist and the CW43L probe changer are present. If the value is True, it checks for the presence of the third axis on the probe changer. It does this before any drop-off or pick-up operation of the third axis wrist.

• CW43LTThirdAxisSlotAngle = -1

• CWSPresent – Passes the CWS commands to the FDC.

• True – The FDC handles the CWS.

• False – No CWS command passes to the FDC.

• DebugCMM – Is part of generic debug support shared between interfaces. It is not used for this interface.

• DebugCPU – Is part of generic debug support shared between interfaces. It is not used for this interface.

• DebugFile = debug.txt – Specifies the name of the file that contains debug output if it is enabled. When debug output is enabled, this file is re-initialized each time PC-DMIS starts.

The debug.txt file can become quite large if PC-DMIS is left in an "idle" state for long periods of time with debugging enabled. This is because even when idle, PC-DMIS continuously does position updates. That activity is included in the debug file. This value is typically specified on the Debug tab in the Machine Options dialog box.

• DebugLog = False – To enable debug output, set the value to True. This value is typically specified on the Debug tab in the Machine Options dialog box.

• DebugPosReport – Is part of generic debug support shared between interfaces. It is not used for this interface.

• DebugTitle – Is the title of the Debug window, if used.

• DebugWindow = False – To create a window that contains debug output, set the value to True. It is part of the generic debug support shared between interfaces. This is not normally useful for this interface, because of the typically large volume of debug output when debug is enabled.

• DelayBetweenCntlCAndCntlBInMilliseconds = 500 – Delays sending a Ctrl + B command to the controller after it sends a Ctrl + C (Break) command.

• DisableCircularMoves = False – If the value is True, the circular moves (MOVCTR + MOVCIR) are disabled, and the behavior is the same as for a controller that doesn’t have true circular moves. This behavior refers only to the true circular movement capability in the controller firmware. It is not the same as enabling or disabling circular movement or motion within a PC-DMIS measurement routine. Circular motion can still be requested in a measurement routine if you are using a controller that does not have true circular moves. In that case, the circular path is approximated with a series of line segments.

• DisableFastProbe = False – Some controllers support FastProbe capability. This is an alternate means of probing when taking discrete hits using an analog scanning probe.

A value of True disables any attempt to use the Fast Probe mode. PC-DMIS treats the machine the same as if it did not have the Fast Probe capability. In a few cases, this may even prevent errors during calibration. On machines that support Fast Probe, when calibrating the probe, PC-DMIS normally calculates calibration coefficients for both normal probing and fast probing. With some combinations of machine type, probe type, and stylus configuration, it may not always be possible to successfully calculate coefficients for Fast Probe and may result in an error. A value of True should prevent that error.

• DisableSP6LowMatrixUpdate = False – If the value is True, it disables the availability and use of the Lower Matrix calibration procedure.

• DisableTraxCal = False – Disables the TRAX method of probe calibration.

• DisableWRISTCSY = False – To prevent the interface from sending any WRISTCSY commands, set the value to True. In some very specific hardware configurations (such as a continuous wrist with a horizontal arm with an SP600 probe on some particular machines), sending the WRISTCSY command may cause problems. Normally, the value should be False.

• DisengageDrives = False – If you want to use this type of machine in manual mode or for scribing, set the value to True. This entry does not function on all machines that use this interface.

• EnablePrintButtonToForceHit = False – Applies only if you are using a fixed probe. If the value is True, you can press the Print button on the jog box to take a hit.

• EnableRotaryAbsolutePosition = False – This setting returns the value of GETPOS. A value of True returns the rotary absolute position. EnableRotaryClockMode = True and EnableRotaryAbsolutePosition = True are recommended.

• EnableRotaryClockMode = True – To enable attempted support for user-selectable direction of table rotation (clockwise, counterclockwise, or shortest), set the value to True. Some controllers and/or firmware versions only support the shortest direction move, and the commands needed to support directional control may cause an error. In that case, set the value to False to prevent the error.

• ExpectedMissSpeedUpFactor = 2.0 – In some measurement situations where it is expected that it will probably miss the part, a hit may be requested. In those cases, the hit request to the interface is flagged to expect a miss. This entry value is a multiplier that is applied to the normally requested touch speed. It is applied when issuing a measurement request where it’s actually expected to miss the part. The hit request is commanded at a touch speed that is the regular touch speed multiplied by this factor.

• FlipAAxis = False

• FlipBAxis = False – These flags reverse the direction of rotation of the A or B joint of continuous motion wrists, such as the CW43, CW43Lite, and IW42C. Reversing the B axis, in particular, was typically needed when used with common firmware versions prior to the year 2001. Since 2001, this setting is machine-specific when you are using these wrist devices. If you are using a Renishaw PHS, the value should be False.

• FLSPresent = Passes the FLS commands to the FDC.

• True – The FDC handles the FLS.

• False – No FLS command passes to the FDC.

• ForceDVMOUT = True – Forces probe deflection output (DVM) to be included with the data produced by analog scans.

• ForceRetractMove – Some controllers automatically retract after a DCC measurement; others do not.

• False – PC-DMIS assumes that the controller does automatically retract.

• True – PC-DMIS assumes that the controller does not automatically retract and explicitly sends a move command to move to the retract point.

• HasContinuousCJoint = -1 – Indicates the presence of a third wrist axis that is infinitely indexable. For information about using this with a probe changer, see "Note on CW43L 3rd Axis Continuous C Joint".

• InPositionToolChangerDelay = 2.0 – Amount of time in seconds that the machine waits in the slot at the changing point for air pressure to accumulate or dissipate. It does this prior to moving out of the slot during a CW43L probe changer changing cycle.

• IppHssDat = 1

• Jog_PartAlign_InCurrentAxisMode – Affects the jog box axis directions when jogging.

• True – Rotates the jog box axes to be consistent with the user-defined axis directions.

• False – The native axis directions are used.

• LowerMatrix_LSPX1C

• LowerMatrix_LSPX1H

• LowerMatrix_LSPX1M

• LowerMatrix_LSPX1S

• LowerMatrix_LSPX3

• LowerMatrix_LSPX5

• LowerMatrix_SP25

• LowerMatrix_SP600

• LowerMatrix_SP80

The value for one of these entries is a string of nine values (separated by commas) that make up the lower-level probe deflection matrix.

Normally, a lower matrix value is created and saved by running the lower-level matrix calibration procedure rather than by manual input in these entries.

• LowerMatrixSeed_LSPX1C

• LowerMatrixSeed_LSPX1H

• LowerMatrixSeed_LSPX1M

• LowerMatrixSeed_LSPX1S

• LowerMatrixSeed_LSPX3

• LowerMatrixSeed_LSPX5

• LowerMatrixSeed_SP25

• LowerMatrixSeed_SP600

• LowerMatrixSeed_SP80

The value for one of these entries is a string of three values (separated by commas). These values are used along with the lower matrix when computing probe stiffness for adaptive scanning.

• LSRPARAMMaxDistance = 15.0 – Is not currently used.

• LSRPARAMPointTarget = 0.01 – Is not currently used.

• LSRPARAMStandoff = -20.0 – Is not currently used.

• MAGACSYClearance = 0.0 – Is a comma-separated list of values in millimeters (one for each probe changer port). It specifies the clearance distance in front of the probe changer to use when you change tools in that probe changer. The value applies to all ports in the probe changer. The value is only used if it is greater than a minimum acceptable value (currently 75 mm).

• MaxAccelX = 0.0, MaxAccelY = 0.0, MaxAccelZ = 0.0 - These control the maximum acceleration (mm/sec/sec) for the X, Y, and Z axes. The values are normally read from the controller during the first startup of PC-DMIS when it is installed, or any time it is started after the ReadCmmDefaults entry is set to True.

• MaxBufferedMoves = 7 – Is the maximum number of queued moves that are allowed in the controller's buffer at one time. You can use this option to not overrun the controller buffer.

• MaxJogAutoRetractDistance = 5.0 – Specifies the maximum value that will be accepted for JOGAUTORETRACT (the manual hit retract distance). The value is in MM. If the firmware version is new enough to support getting the value from the controller, this value be set automatically when retrieving from the controller. This can happen the first time the interface is started after installation, or any time the interface is started with the ReadCmmDefaults entry set to True.

• MaxSpeedX = 50.0, MaxSpeedY = 50.0, MaxSpeedZ = 50.0 - These are the maximum speeds for the X, Y, and Z axes. Normally, these values are read from the controller configuration automatically. This can happen the first time the interface is started after installation, or any time the interface is started with the ReadCmmDefaults entry set to True.

• MaxTableAccel = 0.0 – This is the maximum acceleration for the rotary table (if present). Normally, this value is read from the controller configuration automatically. This can happen the first time the interface is started after installation, or any time the interface is started with the ReadCmmDefaults entry set to True.

• MaxTableSpeed = 20.0 – This entry specifies the rotary table's maximum speed in degrees per second (deg/sec). Normally, this value is read from the controller configuration automatically. This can happen the first time the interface is started after installation, or any time the interface is started with the ReadCmmDefaults entry set to True.

• MaxWristSpeed_A = 50.0

• MaxWristSpeed_B = 50.0

These are the maximum speeds for the A and B axes if a continuous motion wrist is being used. This has no effect for indexing wrists such as a PH10 or Tesastar-M.

• MechanicalOffsetsInRawMachineCoordinatesV35 = False – Is part of the general VolComp setup that multiple interfaces share. It is not really used with this interface because VolComp is done inside the controller by the firmware.

• MechOffsetX = 0.0

• MechOffsetY = 0.0

• MechOffsetZ = 0.0

VolComp is normally performed in the controller itself with this interface. If it was configured to require a probe reference point other than 0,0,0, the values can be input in these offsets.

• NewtonToMMConversion = 1.2 – Specifies the spring rate of the probes' internal axes. This constant converts between a deflection force in Newtons and the corresponding deflection distance in millimeters. This value depends on the type of the scanning probe you are using. For machines that support PRBTYP, the stiffness conversion value is normally obtained from one of the following probe type-specific entries when that type probe is in use. However, this entry provides a default value to be used if some type of analog probe is in use that is not recognized as one of the following specific entries. For any machine that has only one analog probe, even if the machine is capable of supporting multiple types, it is recommended to set this parameter to the correct value.

• NewtonToMMConversion_LSPX1C = 1.2

• NewtonToMMConversion_LSPX1H = 1.2

• NewtonToMMConversion_LSPX1M = 0.6

• NewtonToMMConversion_LSPX1S = 1.2

• NewtonToMMConversion_LSPX3 = 5.0

• NewtonToMMConversion_LSPX5 = 5.0

• NewtonToMMConversion_SM25 = 1.0

• NewtonToMMConversion_SP25 = 0.5

• NewtonToMMConversion_SP600 = 1.2

• NewtonToMMConversion_SP80 = 2.0

These are the probe type-specific stiffness values used on machines that support multiple probe types via the PRBTYP command. The end of the name identifies the type of probe it applies to.

• ProbeSpeed = 0.0 – Is normally not used. You can use this entry to force a particular probe speed. It is an absolute speed in mm/sec. If it is set to a non-zero value, all probing is done using this speed. This ignores any touch speed commands in the measurement routine.

• ReadCmmDefaults = True – When this parameter set to True, and the interface starts, it sends commands to read the machine parameters from the controller for MaxSpeed, MaxAccel, and so on.

• RestoreWristAfterEmergency = False – If the value is True, when beginning or resuming execution after an emergency error while using a continuous motion wrist, the last commanded AB angles are restored before proceeding. Some continuous motion wrists do not maintain the current AB angle when an emergency type error disengages the drives. You can use this option to make sure the angles are automatically re-established before proceeding with the execution.

• RotaryConvergence = 0.0 – Defines a threshold in degrees for the rotary table position after a rotation. PC-DMIS does not consider a table rotation as finished until the table position is different from the commanded position by the amount established by the defined threshold.

• RotaryDelayAfterMove = 0.0 – Specifies a delay (in ms) that is applied after each table rotation.

• RotaryMinDelta = 0.5 – Is the minimum angular deviation required to be commanded before the rotary table moves.

• RotaryOffset = 0.0 – Is the angular offset (in degrees) from the zero position of the rotary table if it is desired to have a zero reference other than the home position.

• RotaryOffsetSpeed = 50.0 – Sets the speed of table rotation after homing to the reference position.

• RotaryTablePresent = False – Indicates if a rotary table is present.

• RotateWristFromController

• True – You are using a continuous-motion wrist, such as a CW43 or PHS.

• False – You are using an indexing wrist, such as a PH10 or Tesastar-M.

• ScanSpeed = 50.0 – Is used only for analog scans. It sets the maximum allowed scan speed.

• SendHSSFullData – Specifies the data path points that are sent to the controller during HSS and VHSS scans. It is applied only when the SendHSSVectors entry is set to True.

• 0 = X,Y,Z,I,J,K

• 1 = X,Y,Z,I,J,K,W,A,B

• 2 = X,Y,Z,I,J,K,W

• SendOptionProbeOnManualHit

• True – Analog probing parameters from any OptionProbe command that might be present are updated when a manual hit is requested.

• False – Analog probing parameters are updated only for DCC operations.

• SP25_Uncalibrated_SM1_NLPPAR01

• SP25_Uncalibrated_SM1_NLPPAR04

• SP25_Uncalibrated_SM1_NLPPAR10

• SP25_Uncalibrated_SM2_NLPPAR01

• SP25_Uncalibrated_SM2_NLPPAR04

• SP25_Uncalibrated_SM2_NLPPAR10

• SP25_Uncalibrated_SM3_NLPPAR01

• SP25_Uncalibrated_SM3_NLPPAR04

• SP25_Uncalibrated_SM3_NLPPAR10

• SP25_Uncalibrated_SM4_NLPPAR01

• SP25_Uncalibrated_SM4_NLPPAR04

• SP25_Uncalibrated_SM4_NLPPAR10

• SP25_Uncalibrated_SM5_NLPPAR01

• SP25_Uncalibrated_SM5_NLPPAR04

• SP25_Uncalibrated_SM5_NLPPAR10

These are the linear deflection coefficients to be used for the first-time calibration of an SP25 scanning module. Each type of module (SM25-1, SM25-2 through SM25-5) can have its own set of coefficients. There are three entries (NLPPAR01, NLPPAR04, and NLPPAR10) for each module type. Each entry consists of three values separated by commas. The three entries with three values each collectively provide a 3X3 deflection matrix for the given module type.

You should not normally attempt to modify these values unless specifically directed by Hexagon Technical Support.

• SupportsFastProbe = False – If the controller supports the Fastprobe mode of probing with an analog scanning probe, set the value to True. This value may be set automatically on some controller types based on information that the controller returns during startup.

• SupportsLSRPARAM = False – Is not currently used.

• TC3AxisSlotChannel = 7 – Is used with the CW43L probe changer with the third axis C Joint.

• TCAirInputChannel = 8 – Is used with the CW43L probe changer to read the status of the air solenoid.

• TCAirOutputChannel = 8 – Is used with the CW43L probe changer to activate the air solenoid.

• TCLiftDistance = 115.0 – Is the vertical distance in millimeters that the machine moves when lifting the CW43L probe changer slot covers.

• TcpipConnectionTimeoutSeconds = 5.0 – When communicating through TCP/IP, the initial connection attempt with the controller waits this duration in seconds before considering it a failure to connect.

• TcpipIPAddress = 100.0.0.1 – Is used only when communicating to the controller via a TCP/IP connection. The value must be set to the IP address that the controller uses.

• TcpipPort = 1234 – Is used only when communicating to the controller via a TCP/IP connection. The value must be set to the port number that the controller is configured to listen to. Typically, this is port 2001.

• TCPort3AxisClearance = 55.0 – Is the horizontal distance (in millimeters) used to move a probe attachment free of the CW43L probe changer mounting pins for the port containing the third axis C Joint.

• TCPortClearance = 35.0 – Is the horizontal distance (in millimeters) used to move a probe attachment free of the CW43L probe changer mounting pins.

• TCRack3AxisClearance = 230 – Is the default horizontal clearance distance (in millimeters) for the CW43L probe changer for the port containing the third axis C Joint for free movement between ports and the mount point.

• TCRackClearance = 150 – Is the default horizontal clearance distance(in millimeters) for the CW43L probe changer for free movement between the ports and the mount point.

• TestAirOn = True – Checks to see if sufficient air pressure is available for a probe change on the CW43L probe changer after sending the command to open the air solenoid.

• TestVolcomp = 0 – Is for internal use only by Hexagon Technical Support. This option should be set to 0 for customers.

• UseDebugManager

• True – The interface uses the debug manager if it has been enabled.

• False – The interface does not use the debug manager, even if the debug manager has been enabled.

• UseMoveAll – Some controllers support moving all six possible axes (X, Y, Z, A, B, and either W or C) in a single command.

• True – A MoveAll request attempts to use this on controllers where support for this is supported.

• False – A MoveAll request is handled using separate move requests for the machine axes and wrist axes, regardless of whether the controller supports a single move all command.

• UseScanSpeedAsBasis – Controls the value that is associated with the 100% value when converting percentage speeds to absolute speeds.

• True – The value for the ScanSpeed entry is used.

• False – The machine max move speed is used.

• UseToolChangerMountPoint = True – For Leitz probe changers, False ignores the common probe mount point and moves directly to the port change point.

• UsingOldWcompens32 = False – Is part of the generic VolComp support for interfaces. Set the value to True if you are using external VolComp and you are trying to use the older version of the wcompens32 DLL.

This entry is not normally used with this interface as the VolComp is almost always done inside the controller.

• Version = 0.0 – Indicates the version of the software interface. You should not manually change the value.

• VolCompMethod = 1 – Is part of the generic VolComp support for interfaces.

This entry is not normally used with this interface as the VolComp is almost always done inside the controller.

• WarmupStationPowerState – If you are using a Warmup Station for laser probes, this entry specifies the power state to be set when PC-DMIS first starts.

• 0 – Off

• 1 – On

• WCompensMode = 1 – Is part of the generic VolComp support for interfaces. If you are using VolComp outside the controller, for horizontal arm machines, set the value to 0. For a regular vertical arm machine, set it to 1. For a horizontal arm, also make sure that the ARM2CompMode entry is set correctly if running on a dual-arm machine.

This entry is not normally used with this interface as the VolComp is almost always done inside the controller.

• WristAOffset = 0.0

• WristBOffset = 0.0

• WristCOffset = 0.0

These wrist offsets "square up" the A, B, and C position of the head so that it is aligned with the machine axes.

The A and B offsets are used with IW42C, a CW43, a CW43Lite, or a Renishaw PHS wrists and the offsets are not stored on the controller.

The C offset is only used if a third axis/joint (C joint) is present.