Setting and Adjusting CNC System Parameters
This guide is for setup machinists and process engineers who change controller values and then have to live with the result. We cover which parameters matter, the order to change them, and how to prove the machine still holds ±0.005 mm before you release a production run.

In this article
- 1
- 2
- 3
- 4
- 5
- 6
- 7
Key takeaways
What adjusting CNC system parameters actually controls
A CNC control holds hundreds of numbered parameters, and most of them you will never touch. The ones that decide part quality fall into four groups: axis servo tuning, machine geometry and compensation, tool and work offsets, and process limits such as feed, spindle, and acceleration. Adjusting CNC system parameters in the wrong group is how a machine that cut fine on Monday starts scrapping on Tuesday.
The distinction that matters most is between parameters that describe the machine and parameters that describe the job. Backlash compensation, pitch error compensation, and servo gains describe the machine. They should change rarely, and only after a mechanical check. Tool offsets, work offsets, and feed rates describe the job. Those change with every setup, and operators adjust them daily.
When a part comes out oversized, the temptation is to open the compensation screen. That is usually the wrong move. If a 50 mm bore is 0.03 mm oversize, a tool offset change of 0.015 mm per side fixes that bore and breaks every other feature cut with the same tool. Find out whether the error is repeatable across the whole travel before you edit anything.
One more boundary. Parameters do not make a worn machine accurate. On a machine with 0.05 mm of backlash from a loose thrust bearing, adding compensation will improve the average size but the spread will stay wide. We see this often on older VMCs, and the honest fix is mechanical, not digital.
- 1Machine parametersServo gains, backlash and pitch error comp, soft limits, spindle orientation.
- 2Job parametersTool length and radius offsets, work offsets, feed and speed overrides.
- 3Protected parametersUsually locked behind a password. Log every change and who made it.
Servo gain and feedforward settings
Servo tuning decides how fast an axis responds to a command and how much it overshoots. Position loop gain is the main value. Too low, and the axis lags behind the command, which shows up as rounded corners on a contour. Too high, and the axis hums, then alarms with an overload or an excessive error warning.
Raise position gain in small increments, usually 10 to 20 percent at a time, and run the same test move after each change. A good test is a 100 mm rapid in both directions followed by a reversal, watched on the servo tuning screen. The following error should settle quickly, without oscillation. If you hear a high-pitched whine at standstill, back off.
Feedforward gain helps the axis keep up during acceleration without raising position gain into instability. On a mill cutting a 200 mm arc at 3,000 mm/min, feedforward reduces the following error at the quadrant points, which is where you see witness marks on a circular interpolated bore.
Acceleration and deceleration time constants belong in the same conversation. Shortening the accel time makes the machine feel faster and increases the shock load on the ballscrew and coupling. On a 16 simultaneous 5-axis machine, we keep accel times conservative on the rotary axes because A and C axis inertia is much higher than the linear axes.
- 1Position loop gainRaise 10–20 percent per step, then test a reversal move.
- 2Feedforward gainImproves contour accuracy without pushing the loop into oscillation.
- 3Accel time constantLonger on rotary axes. Shorter times add mechanical shock.
Backlash and pitch error compensation
Backlash compensation tells the control how much lost motion exists when an axis reverses direction. Measured with a dial indicator against a stopped axis, a typical value on a healthy ballscrew is 0.005 to 0.015 mm. On a machine that has run three shifts for years, 0.03 mm is common and 0.05 mm means it is time to look at the thrust bearings and the nut.
The correct order is measure, fix what you can, then compensate what is left. Clean and re-preload the nut if the design allows. Check the coupling for slip. Only then enter a compensation value. A compensation table that grows every quarter is a symptom, not a solution.
Pitch error compensation corrects the difference between the commanded position and the actual position along the full axis travel. This is not a single number. It is a table, measured at intervals of 20 to 50 mm with a laser interferometer or a granite and indicator setup. On a 4,000 mm travel machine, a pitch error table can recover 0.02 mm at the ends of travel that a single compensation value would miss.
Both compensations assume the machine is at thermal equilibrium. A cold machine and a machine that has run for four hours are different machines. Measure after a warm-up cycle that matches production, and if you run lights-out, measure at the temperature the machine will actually hold.
- 1Measure hotRun a warm-up cycle before reading any geometry value.
- 2Compensate in one directionBacklash values apply on reversal. Do not double them.
- 3Log the trendA rising backlash value predicts a mechanical failure.
Tool offsets, work offsets, and process limits
Tool length offsets set the Z reference for each tool. Measure them the same way every time, either on a tool presetter or with a probe on the machine. Mixing the two methods introduces a consistent error that will show up as a step between tools. Keep a written procedure and stick to it.
Tool radius or cutter compensation lets you adjust a feature size without reprogramming. When a slot comes out 0.02 mm narrow, a radius offset change of 0.01 mm per side brings it in. This works for a single feature. If several features cut with the same tool are all off in the same direction, the tool is worn or the offset is wrong, and you should re-measure the tool rather than chase the part.
Work offsets define where the part sits in the machine. On a vise setup, a probe routine is faster and more repeatable than touching off with a gauge block. The common mistake is setting the work offset from a rough face. If the stock face has 0.1 mm of variation, your Z datum moves with it.
Process limits include maximum feed, spindle speed, and torque limits. These protect the machine and the tool. Do not raise them to chase a cycle time unless you have confirmed the spindle load and the tool life at the new value. A feed limit raised by 30 percent can cut tool life in half on stainless.
- 1One method per shopPresetter or probe, but not both for the same tool.
- 2Radius comp for one featureA systematic error across features means re-measure the tool.
- 3Do not lift limits blindlyCheck spindle load and tool life before raising a feed limit.
Step by step: adjusting CNC system parameters safely
- 11. Back up the parameter fileWrite the full parameter set and the PLC ladder to a USB stick or the network. Record the machine serial number and the date in the file name. Without this, a bad edit can turn into a service call.
- 22. Define the problem with a numberMeasure the actual error. A bore 0.03 mm oversize, a step of 0.02 mm between tools, a corner radius that measures 0.15 mm instead of 0.10 mm. Write the number down before you open any screen.
- 33. Warm up and check mechanicsRun the spindle and axes for 20 to 30 minutes. Then check for backlash, loose couplings, and a dirty or worn tool. Confirm that the error is repeatable across three parts.
- 44. Change one parameter groupServo gains first if the problem is contour accuracy, geometry compensation if it is size across the travel, offsets if it is a single feature. Change one group, then stop and test.
- 55. Verify with a test cutCut a representative feature at the production feeds and speeds. Measure with a calibrated micrometer or CMM. Compare to the number from step 2, not to a feeling.
- 66. Record and releaseWrite the old value, the new value, the test result, and the operator name in the machine log. If the result is within tolerance across three consecutive parts, release the job.
Which parameter group to adjust for a given symptom
Match the symptom to the group before you edit anything.
| Symptom | Likely group | What to change | Watch out for |
|---|---|---|---|
| Rounded corners on a contour | Servo tuning | Raise position gain 10–20% | Whine or overload alarm |
| Size drifts from one end of travel to the other | Pitch error comp | Rebuild the pitch error table | Measuring a cold machine |
| Size changes when the axis reverses | Backlash comp | Enter measured lost motion | Hiding a worn ballscrew |
| One feature off, others correct | Tool radius offset | Adjust 0.01 mm per side | Chasing a worn tool |
| Step between two tools | Tool length offset | Re-measure on the presetter | Mixing probe and presetter |
| Z datum moves between parts | Work offset | Re-probe on a clean face | Setting Z on rough stock |
| Cycle time too long | Process limits | Raise feed or accel slightly | Tool life and spindle load |
When to adjust parameters and when to stop
Adjust parameters when the error is small, repeatable, and traceable to a known cause. Stop and call for a mechanical repair when backlash keeps climbing, when an axis alarms under normal load, or when the same value has to be re-entered every week. Compensation should shrink over time, not grow.
Common questions
How often should backlash compensation be checked?
Check it on a schedule that matches the machine's duty cycle. A machine running three shifts should be checked quarterly. A prototype machine running one shift can go six months.
The trend matters more than the single number. If backlash moves from 0.010 mm to 0.015 mm in a quarter, plan a mechanical inspection. If it jumps from 0.010 mm to 0.040 mm overnight, stop and find out why.
Can I copy a parameter file from an identical machine?
Only the machine-specific groups, and only if the machine serial numbers and option configurations match. Servo gains and pitch error tables are tied to individual machines and will not transfer cleanly.
Copying a full parameter set between machines is a common cause of an axis running away on the first power-up. Load the file, then re-tune the servo and re-measure the geometry.
What tolerance can parameter tuning realistically achieve?
On a well-maintained machine, tuning and compensation support a tolerance of ±0.005 mm. That is the level we hold in production, with 100 percent inspection before shipment.
If the machine mechanical condition does not support that, no parameter change will get you there. Fix the machine first, then tune.
Does raising position gain always improve accuracy?
No. It improves response up to the point where the loop becomes unstable. Past that point the axis oscillates, the surface finish gets worse, and the drive can alarm.
The practical ceiling depends on the mechanical stiffness of the axis. A machine with a worn guideway will start oscillating at a lower gain than a new one.
How do I know if an error is thermal or mechanical?
Run the same test cut on a cold machine and again after a warm-up cycle. If the size shifts with temperature, it is thermal, and the fix is a warm-up routine or thermal compensation.
If the size is stable but the spread is wide across repeated cuts, it is mechanical. Look at backlash, tool wear, and workholding.
Should operators be allowed to change parameters?
Job parameters such as tool offsets and work offsets, yes. Machine parameters such as servo gains and compensation tables should sit behind a password controlled by the maintenance or process engineering team.
Every change to a machine parameter needs a log entry with the old value, the new value, and the reason. This is what makes an audit trail possible.
Put the parameters to work on a real part
Send us your drawing and we will return a quotation and a free DFM analysis within 12 hours. Our 127 high-precision CNC machines hold ±0.005 mm with 100 percent inspection before shipment.
12-hour quote100% inspectionNo minimum order quantity