Mach4 SimpleMotion drive plugin

Mach4 is a CNC motion control software developed by Newfangled Solutions. The Mach4 SimpleMotion drive plugin is needed to run SimpleMotion motor drivers with Mach4.

Requirements

The following things are needed for building a CNC machine using Mach4 and motor drivers connected with SimpleMotion bus:

• Atomi, IONI or Argon-based motion system, e.g. CNC mill, connected with SimpleMotion bus
• Windows PC
• Mach4 software + license
• SimpleMotion adapter depending on selected motor drivers

Mach4 installation

• Download and install Mach4
• Download the plugin files to the Mach4 plugin folder
• Read the Mach4 installation, configuration and operation manuals before use

Configuration

Motor driver configuration with Granity Software

This section shows the basic configuration for motor drivers with Granity software. More support for using this software can be found from the Granity user guide. The following subsection titles are links to corresponding guide pages. Download the Granity software from its wiki page, launch it and follow these steps:

Connect to the motor driver

Connect to a motor from the "Connect" tab by selecting the interface device, and clicking "Connect to drive"

From the opening list, select a motor driver and click "Open"

Goals

The goals settings page contains the driver function, input signal, motion dynamics, homing and soft limit settings.The following table shows the most important settings in the goals tab. All settings are explained in Granity software.

Setting	Value
Control modeCM	Position control in motion drivers, position or velocity control in spindle driver
Require software enableCEN	Enable this if you don't want the motor driver to be enabled automatically during the startup
Electrical interfaceCEI	Standard
Setpoint inputCRI	Serial only
Homing enabledHME	Select "Homing on external command" if you want to home the axis from Mach4 GUI

If homing is enabled, the position soft limits can also be used to limit axis motion. The soft limit can be set by following:

1. Home the axis by pressing button "Start homing now". After homing, the axis stops and it's setpoint is zero
2. Set the position low limit to zero
3. Go to Testing tab and find a good high limit position by incrementing the setpoint
4. Read the current setpoint, go to the Goals tab and set it tothe position high limit

Machine

The machine tab lets you to choose the axis type and scale, the motor type and properties and the feedback device type and properties. The values can be anything depending on the system, so any good values can't be shown here.

Tuning

In the tuning tab you can set the torque, velocity and position controller settings.

Fault limits

In this tab, you can set the fault triggering levels and tolerances

Testing

This tab lets you to test your motor by changing its setpoint. It also shows the device state.

Mach4 configuration

Open the Mach4 Configuration dialog

Enable the SimpleMotion drive plugin from the plugins tab.

The program should ask to restart Mach4 after enabling the plugin. Restart Mach4 before continuing.

Select the SimpleMotion drive plugin to be used as a motion device

Configure the motors

Open the Mach configuration again, and select the motors tab.

Select each used motor and configure them as following:

• The motor indexes are always one smaller than the SimpleMotion axis numbers. For example, Motor0 means drive 1 in the SimpleMotion bus.
• How many steps the motors should move for each unit of measure
• The maximum velocity of each motor
• The maximum acceleration of each motor
• Motors can also be reversed here

Axis mapping

Enable the axes used in your machine. The following picture shows 3-axis machine where the spindle motor is also controlled by Mach4. The axes X-C (0-5) are for motion, and the OB axes (6-11) can be used for controlling a spindle motor.

• Enable used axes
• The motor indexes are always one smaller than the SimpleMotion drive numbers. For example, Motor0 means drive 1 in the SimpleMotion bus
• Select a motor for each axis. Slave motors can also be set for an axis if they use more than one motor
• Do not enable axes without motors
• The spindle control type (velocity or position-controlled) will be set later

Homing / Soft limits

• Set the homing order. If some axes have the same number, they will be homed at the same time
• Enable soft limits for motion axes
• Set the soft limits to prevent axes from hitting their physical limits. If you don't know what to put here, you can also configure them later
• The homing direction, offset and speed are selected in Granity software when using this plugin

Spindle configuration

• Set min. and max. rpm for the spindle motor if it is controlled by Mach4.
• The max. rpm set here doesn't have effect to the real speed of velocity-controlled spindle. Running a velocity-controlled spindle by here configured max. speed runs the spindle motor by the maximum speed configured in the motor driver.
• If the spindle is position-controlled, the spindle motor should be selected in the "Step/Dir Spindle Axis"-dropdown. The axis must be enabled and mapped before this.

SimpleMotion drive plugin configuration

Close the Mach configuration and open the SimpleMotion drive plugin configuration

Set the following settings. The default values work in most cases.

• SimpleMotion V2 adapter FTDI port number
• SimpleMotion V2 buffer max. fill percentage
• In the case of using a velocity-controlled spindle, its axis should be selected here. The list shows only mapped and enabled axes that are not selected as position-controlled spindle

Save the SimpleMotion drive plugin configuration by pressing "OK", and start using the software!

Other

Versions

Version	Comments	Download
0.1	The first beta release	File:M4SM.zip

Known issues

• A possible small bump after disabling or stopping motion due to aborted buffered motion

TODO

In no event the Product Information or parts hereof shall be regarded as guarantee of conditions or characteristics. The Product Information or any part thereof may also not be regarded as a warranty of any kind. No liability of any kind shall be assumed by Author with respect to Product Information or any use made by you thereof, nor shall Author indemnify you against or be liable for any third party claims with respect to such information or any use thereof.

As content of this Wiki may be edited by user community, Granite Devices Oy or it's affiliates do not take any responsibility of the contents of this Wiki. Use information at your own risk. However, Granite Devices staff attempts to review all changes made to this Wiki and keep information trustworthy.

Without written consent, Granite Devices' Products or Intellectual Property shall not be used in situations or installations where living beings, material property, or immaterial property could be harmed by the operation, features or failures of Product. Products may only be used in a way where hazards like moving parts, electric shock, laser radiation, or fire can't be realized even if the content of this Wiki would suggest otherwise.