If your spindle runs from the VFD keypad but will not start from your CNC controller, that is actually a useful diagnostic clue.
Manual operation confirms that the spindle motor, spindle cable, VFD power section, and incoming power are at least capable of running. The problem is usually somewhere in the separate automatic-control path:
CNC software → CNC controller → control cable → VFD control input → spindle
That path may use PWM, 0–10V analog control, Modbus/RS-485, relays, or a combination of signals. If any part of that chain is missing or incorrectly configured, the spindle can work perfectly in manual mode while ignoring automatic commands.
Here is how to troubleshoot the problem logically without changing random VFD parameters or replacing parts unnecessarily.
What Manual Mode Proves—and What It Does Not
When the spindle runs correctly from the VFD keypad or manual controls, you have confirmed several important things:
- The VFD has incoming power.
- The VFD can create output for the spindle motor.
- The spindle cable is capable of carrying that output.
- The spindle motor can rotate.
- A water-cooled spindle’s cooling system should be operating normally during the test.
Manual operation does not prove that:
- The CNC controller is sending a spindle command.
- The correct control cable is installed.
- The signal reaches the VFD.
- The VFD is listening to the correct external input.
- The controller’s RPM range matches the VFD.
- The start/forward command is configured.
- Modbus communication is established.
This distinction prevents a common troubleshooting mistake: assuming the VFD must be defective simply because automatic mode does not work.
Understand the Two Commands the VFD May Need
Automatic spindle control frequently involves two separate instructions:
- Run or forward: Tells the VFD to start the spindle.
- Speed: Tells the VFD what frequency or RPM to use.
These commands may arrive through the same digital connection, as they often do with Modbus, or through separate outputs. A PWM or analog installation might use a changing speed signal plus a relay or digital output for run/forward.
This creates several possible symptoms:
| What happens | What it usually indicates |
|---|---|
| The VFD display does not react at all | No control signal, wrong port, wrong cable, or incorrect communication setup |
| A relay clicks, but the VFD does not react | A run output may be activating, but the speed signal or VFD input may still be missing |
| The VFD shows a requested frequency, but the spindle does not start | Speed control is reaching the VFD, but the run/forward command may be missing |
| The spindle starts but runs at the wrong RPM | Controller range, PWM scaling, frequency limits, or display scaling may be incorrect |
| The controller reports a timeout | Modbus communication, wiring polarity, controller settings, or VFD communication parameters may be incorrect |
A click, illuminated software button, or “OK” message only proves that the controller accepted part of the command. It does not prove that the complete command reached the VFD.
1. Identify the Automatic-Control Method
Before touching any wiring or parameters, determine how the controller is supposed to communicate with the VFD.
Common methods include:
- PWM
- 0–5V or 0–10V analog voltage
- Modbus over RS-485
- A relay or digital output for run/forward
- A controller-specific interface combining more than one signal
Do not identify the cable solely by its connector shape or wire colors. A cable for MASSO may not be wired like one for Buildbotics, Shapeoko, OpenBuilds, or a Sienci controller.
If you are uncertain which method your machine uses, start with our guide to connecting a CNC spindle to Buildbotics, LinuxCNC, Mach4, or Sienci controllers.
2. Issue a Known Spindle Command
Test automatic operation with a deliberate command rather than launching a complete toolpath.
Many controllers support an MDI command similar to:
M3 S12000
This requests clockwise spindle operation at 12,000 RPM. The exact syntax and testing procedure vary by controller, so use the controller manufacturer’s documentation when necessary.
Before testing:
- Remove the cutting tool.
- Make sure the spindle is securely mounted.
- Keep hands clear of the collet.
- Confirm coolant flow for a water-cooled spindle.
- Be prepared to stop the system immediately.
Observe three things when the command is issued:
- Does the controller accept the command?
- Does the VFD display change?
- Does the spindle begin turning?
Those three answers help locate where the command chain stops.
3. Watch the VFD, Not Just the Controller Screen
The VFD display is one of the best diagnostic tools available.
If the controller reports that it accepted the command but the VFD display does not change, the VFD may not be receiving the signal at all. The likely causes move upstream toward the control cable, controller output, selected port, or communication configuration.
If the VFD display changes to an appropriate frequency but the spindle remains stopped, the speed command may be arriving without a valid run/forward command.
For a typical 24,000 RPM, 400 Hz spindle:
- 12,000 RPM is approximately 200 Hz.
- 24,000 RPM is approximately 400 Hz.
These values are examples, not universal settings. Always verify the rated frequency and maximum speed of your specific spindle.
4. Verify the VFD’s Automatic Sources
A VFD can be configured to receive its run and speed instructions from several places:
- The keypad
- External terminals
- An analog input
- PWM-related circuitry
- Modbus/RS-485
- Another communication interface
The VFD must be programmed to listen to the inputs actually being used.
Because run and speed may have separate source parameters, it is possible for one to be correct while the other is not. The VFD might receive the requested speed but never receive permission to run—or it may receive a start command while still expecting speed from the keypad.
Compare the complete configuration against the documentation for your exact VFD, spindle, and controller. PwnCNC spindle-system owners can begin with the VFD default-programming reference.
Do not copy parameter numbers from a different VFD model, controller, or YouTube installation simply because the symptoms appear similar.
Avoid an unnecessary factory reset
A factory reset can erase motor ratings, control-source selections, frequency limits, display settings, and other configuration required for your spindle.
Before resetting anything:
- Photograph or record the current values.
- Confirm that you have the correct programming sheet.
- Verify that the instructions match your VFD and spindle.
- Use a reset only when the configuration cannot be restored safely another way.
Random parameter changes often turn one identifiable problem into several overlapping problems.
5. Inspect the Control Cable and Connections
The control cable is different from the spindle power cable. It carries low-voltage commands between the CNC controller and VFD.
Inspect it with the power disconnected:
- Confirm that both connectors are fully seated.
- Look for bent, recessed, or damaged pins.
- Check detachable terminal blocks for loose wires.
- Confirm that the cable is connected to the intended controller port.
- Verify polarity on RS-485 connections.
- Check for strain or damage if the machine was moved.
- Confirm that the cable matches the controller and VFD combination.
One supplied support case was resolved by correcting two communication wires. Other cases involved a control cable, controller output, or VFD hardware that required isolation through testing.
Never switch wires as an experiment unless the applicable wiring diagram specifically calls for it. A connector that fits can still have the wrong pinout.
6. Determine Whether a Signal Reaches the VFD
For an analog-voltage installation—or a PWM system converted into a DC control voltage—a multimeter can help determine whether the controller is producing a speed command.
For example, on a properly scaled 0–10V system:
- 12,000 RPM may produce approximately 5V.
- 24,000 RPM may produce approximately 10V.
On a 0–5V system:
- 12,000 RPM may produce approximately 2.5V.
- 24,000 RPM may produce approximately 5V.
Measure first at the controller or controller-side connection, then at the VFD end of the control cable.
The results can isolate the fault:
- Correct voltage at the controller but not at the VFD end suggests a cable or connector problem.
- No voltage at the controller suggests controller configuration, output selection, pin assignment, or controller hardware.
- Correct voltage at the VFD suggests checking the VFD input terminal and automatic-source programming.
A standard multimeter cannot meaningfully decode Modbus data. For RS-485 systems, use communication indicators, controller diagnostics, verified A/B wiring, matching communication settings, or substitution testing.
Only perform electrical measurements if you understand the test points and can do so safely. VFD enclosures contain hazardous voltage even though the control signal itself is low voltage.
7. Check the Controller’s Spindle Configuration
If the physical signal path appears correct, review the controller configuration.
Depending on the controller, check:
- Spindle control enabled
- Correct output or communication port selected
- Maximum spindle speed
- PWM range or analog-output scaling
- Modbus enabled
- Device address
- Baud rate, parity, and stop bits
- Run/forward output assignment
- Tool or spindle type
- Firmware settings related to automatic spindle control
A controller can accept M3 S12000 and display “OK” while producing no usable signal at its output. The command parser and physical output are separate stages.
If the controller provides no voltage, communication activity, or output change when a valid command is issued, further VFD programming will not solve the problem.
8. If It Starts but Runs at the Wrong Speed
Once the spindle starts automatically, you may discover a second problem: commanded and actual RPM do not match.
For example, a 24,000 RPM command might produce only 8,000 RPM. That usually points to scaling rather than a defective spindle.
Check:
- Controller maximum spindle-speed setting
- GRBL maximum RPM value
- PWM maximum output
- 0–5V versus 0–10V expectations
- VFD upper and maximum frequency
- Spindle rated frequency
- VFD display coefficient
- CAM or sender spindle-speed settings
Our guide to CNC spindles running at the wrong RPM covers this symptom in greater detail.
When Should You Suspect the VFD?
A hardware problem becomes more likely after you confirm that:
- The controller produces the expected command.
- The command reaches the VFD end of the cable.
- The VFD is configured for that input.
- The run/forward signal is present.
- The spindle still does not respond correctly.
- The VFD exhibits other unusual behavior in manual mode.
In one of the supplied cases, the controller produced approximately 5V at half speed and 10V at full speed, confirming that the command path reached the VFD. Replacing the VFD became the logical next step.
In another case, replacing abnormal VFD hardware restored automatic operation, after which a separate controller-scaling issue could be addressed.
The goal is not to assume that VFDs never fail. It is to prove that the command reaches the VFD before replacing the most expensive components.
Common Mistakes to Avoid
- Changing several parameters at once
- Factory-resetting a pre-programmed VFD without recording its settings
- Assuming a relay click proves speed control is working
- Assuming “command accepted” means the controller produced an output
- Using voltage measurements to diagnose Modbus data
- Ordering a cable based only on the CNC machine name
- Confusing the control cable with the spindle power cable
- Testing with a cutting tool installed
- Assuming manual operation proves automatic communication
- Continuing to troubleshoot the VFD after confirming that the controller produces no output
Information to Collect Before Requesting Support
If the problem remains, provide:
- CNC machine brand and model
- Controller brand, model, and revision
- VFD model and input voltage
- Spindle power, voltage, maximum RPM, and rated frequency
- Control method: PWM, analog, Modbus, or unknown
- Control-cable type
- Current VFD automatic-source settings
- Controller spindle settings
- Results of a known MDI command
- What the VFD display does during that command
- Any voltage measurements appropriate for the control method
- Clear photos of both ends of the control connection
A short video showing the controller command, VFD display, and spindle response can also be useful.
For advanced MASSO configuration questions outside a PwnCNC product issue, contact MASSO directly at support@masso.com.au.
Final Takeaway
When a CNC spindle works manually but not automatically, begin with what the symptom has already proven: the spindle and VFD power section can run.
Then trace the automatic command one stage at a time:
Command → controller output → control cable → VFD input → run and speed response
Do not skip directly to replacing the VFD, resetting every parameter, or rewiring connectors. Observe the VFD, verify the selected control method, confirm that a command leaves the controller, and determine whether it reaches the VFD.
If you need a controller-specific replacement, review PwnCNC’s PWM and Modbus control cables. If you are planning a complete upgrade, the PwnCNC Spindle System is configured around the selected spindle and CNC controller to reduce wiring and setup complexity.








