Skip to content

Solder Paste

Marius Stanciu edited this page Oct 29, 2026 · 1 revision

The Solder Paste plugin makes the G-code that dispenses solder paste on the PCB pads with a CNC machine and a syringe. It works in 3 steps. First it makes a Geometry object with the pads and the nozzle tools. Then it makes a CNCJob object from that Geometry. Last, it saves the G-code. The settings for the syringe and the machine are in the calibration tabs at the top of the panel.

Where to find it

  • Menu: Plugins > Solder Paste Dispensing.
  • Keyboard: Alt+K.
  • The panel opens in a tab next to Project and Properties. The tab shows the plugin name.

Screenshot placeholder: images/Solder-Paste-1.png - The Solder Paste panel. Show the calibration tabs (Hardware, Quantity, Placement, Cycle) at the top, the Source Object combo, the Tools Table and the Generate Geometry and Generate CNCJob buttons.

Quick start

  1. Load a Gerber object with the solder paste pads (the paste layer). See Importing Files.
  2. Open the plugin with Alt+K.
  3. Set the calibration in the Hardware, Quantity, Placement and Cycle tabs. Start with the values of your syringe and your machine.
  4. Enter a diameter in New Tool and click the add button. Add one nozzle tool for each nozzle size you use. Dispensing starts with the biggest nozzle.
  5. Set Margin, Travel Z, the Dispense heights and the Feedrate values.
  6. Set the Tool change position (X-Y and Z).
  7. Check the Preprocessor in the Common Parameters frame. In the calibrated modes the Controller sets it.
  8. Select the Gerber object in Source Object. Click Generate Geometry.
  9. Select the new Geometry object in the Geometry Solder Paste list. Click Generate CNCJob.
  10. Click the review button to check the G-code. Click Save GCode to save it. The name of the CNCJob object must end in _solderpaste before the save is allowed.

Parameters

Values are in mm (or inch in an inch project) unless the field says another unit. Units for the calibration fields are shown next to the field. A dash (—) means that the value has no stored default.

The calibration fields are on 4 tabs at the top of the panel. Some fields are disabled for some settings. A note under the tabs explains what to change.

Calibration: Hardware tab

Parameter Description Default
Controller The controller dialect of your machine. Choices: Mach3, Mach4, LinuxCNC, GRBL and Marlin. The controller also selects the preprocessor in the calibrated modes (see Preprocessor). Mach3
Syringe drive How the syringe is moved. Motor: a spindle-type motor. The speed is set in RPM and the flow is measured. Stepper: a dedicated extrusion axis moves the plunger. Motor
Extrusion axis The axis that moves the plunger. Choices: A, B, C and E. Use A, B or C for CNC controllers. Marlin needs E in linear mode. Stock GRBL has no extra axis. Disabled for the Motor drive. A
Axis units The units of the extrusion axis. Rotary: degrees of motor rotation (uses Screw pitch and Motor turns / screw turn). Linear: millimetres of plunger motion. Disabled for the Motor drive. Rotary
Mach3 dwell units The unit of the dwell time for Mach3 (G04). Seconds or Milliseconds. Enabled only for Mach3. The times in this panel are always in seconds. Seconds
GRBL mode The $32 setting of GRBL. Spindle: paste dispensing requires this mode ($32=0). Laser. Enabled only for GRBL. Spindle
Marlin cold extrusion Confirms that the firmware allows cold extrusion and that the E steps per millimetre are calibrated for the syringe. No heater is enabled by this plugin. Enabled only for Marlin, with a non-motor drive. Off

Calibration: Quantity tab

Parameter Description Default
Dose calculation How much paste each pad gets. Thickness: the paste thickness times the pad area. Fixed volume: a fixed number of microlitres per pad. Legacy: the old uncalibrated cycle. Legacy disables most calibration fields and uses the Legacy prime time and Reverse time fields in the Forward and Reverse frames. Thickness
Paste thickness The target wet paste thickness, in physical millimetres. It does not depend on the project units. Enabled for Thickness. 0.1 mm
Volume per pad The volume of paste per pad, in microlitres (uL). One microlitre equals one cubic millimetre. Raster strokes share this dose. Enabled for Fixed volume. 0.05 uL
Measured flow The measured flow of the nozzle and the paste, in uL/s. Measure the delivered volume in seconds at the Forward speed. 0 means not calibrated. Enabled for the Motor drive. 0.0 uL/s
Dose correction A multiplier for the commanded dose. Increase it if the measured delivery is below the target. 1.0 x
Syringe internal diameter The bore of the syringe, in mm. It converts volume to plunger travel. Enabled for the Stepper drive. 10.0 mm
Screw pitch The plunger movement for one screw revolution, in mm per revolution. Used for a rotary motor axis. 1.0 mm/rev
Motor turns / screw turn The gear reduction: motor revolutions for one screw revolution. 1.0 x
Maximum plunger speed The speed limit of the plunger, in mm/min, for the stepper dispensing and retraction. Enabled for the Stepper drive. 60.0 mm/min

Screenshot placeholder: images/Solder-Paste-2.png - The Quantity tab with Dose calculation set to Thickness.

Calibration: Placement tab

Parameter Description Default
Pad placement How the paste is placed on a pad. Auto: wide pads get raster strokes, and dots are used when a line does not fit. Line: one line per pad. Raster: parallel strokes over the pad. Dot: a dot on each pad. Auto
Raster overlap The overlap between adjacent strokes of the nozzle width, in percent. A higher value gives more strokes. Enabled for Auto and Raster. 30 %
Dot footprint The measured diameter of a deposited dot, in mm (or inch in an inch project). A dot must fit inside the pad. Enabled for Auto and Dot. 0.2

Calibration: Cycle tab

Parameter Description Default
Prime volume The volume delivered at the start of each line. It is taken from the dose of the line. Keep 0 unless you need it. 0.0 uL
Plunger retract The stepper anti-drip retraction, in physical plunger millimetres. The plunger takes it back at the next pad. Enabled for the Stepper drive. 0.02 mm
Slow Z approach Approaches the pad through Z Start at the Z Dispense feedrate. The motor stays off until Z Action. Off gives a faster normal cycle. Off

Tools Table

Parameter Description Default
# The nozzle tool number. Dispensing starts with the biggest nozzle. When there are no more nozzles and some pads are still not covered, a warning message box is shown. —
Diameter The nozzle diameter. It is the width of the paste dispensed. —
New Tool The diameter of a new nozzle tool. 0.3
Add (button) Adds a nozzle tool with the diameter in New Tool. —
Delete (trash button) Deletes the selected rows of the Tools Table. —

Parameters

Parameter Description Default
Margin The offset from the boundary of the pads. It is a fraction of the tool diameter, in percent. 0 %
Travel Z The height for the travel between pads, without dispensing. Use a value above zero. 2.0

Dispense

Parameter Description Default
Z Start The height when the paste dispensing starts. Enabled for Slow Z approach and for the Legacy mode. 0.05
Z Action The height when the paste is dispensed. 0.1
Z Stop The height when the paste dispensing stops. Enabled for the Legacy mode. 0.05

Tool change

Parameter Description Default
X-Y The X,Y position of the nozzle change, in the format (x, y). 0.0, 0.0
Z The height of the nozzle change. 5.0

Feedrate

Parameter Description Default
X-Y The feedrate while the machine moves on the XY plane. 150
Feedrate Rapids The feedrate for the fastest moves. 1500
Z The feedrate while the machine moves vertically. 150
Z Dispense The feedrate while the machine moves up to the dispense position. Enabled for Slow Z approach and for the Legacy mode. 1.0

Forward

Parameter Description Default
Motor forward speed The speed while the paste is pushed through the nozzle. Enabled for the Motor drive and for the Legacy mode. 300
Legacy prime time (s) The pause after the dispensing, in seconds. Enabled only for the Legacy mode. 1

Reverse

Parameter Description Default
Motor reverse speed The speed while the paste is pulled back into the syringe. Enabled for the Motor drive and for the Legacy mode. 200
Reverse time (s) The pause after the syringe is retracted, to allow the pressure to balance, in seconds. Enabled for the Motor drive and for the Legacy mode. 1

Common Parameters

Parameter Description Default
Preprocessor The preprocessor file for the paste G-code: Paste_1, Paste_GRBL or Paste_Marlin. In the calibrated modes (Thickness or Fixed volume) the plugin selects it from the Controller: GRBL uses Paste_GRBL, Marlin uses Paste_Marlin, and the other controllers use Paste_1. This field is enabled only in Legacy mode. See Preprocessors. Paste_1

Geometry

Parameter Description Default
Generate Geometry Makes a Geometry object with the pads and the nozzle paths. It uses the Gerber pads of the Source Object and the Tools Table. —
Geometry Solder Paste (list) The Geometry object that is used for the CNCJob. Selecting it restores its nozzle settings. Regenerate the Geometry after you change the quantity or the placement. —

CNCJob

Parameter Description Default
Generate CNCJob Makes the G-code for the solder paste dispensing. The controller and the calibration values are used. —
CNCJob Solder paste (list) The CNCJob object that the save and review buttons use. Its name must end in _solderpaste before you can save the G-code. —
Save GCode Saves the G-code to a file. —
Review CNC Code (button) Shows the G-code so you can check it. —
Reset Tool Sets the parameters of the plugin back to the defaults. —

Advanced

How the dose is calculated

  • Thickness: the dose is the Paste thickness multiplied by the area of the pad. The Dose correction multiplies the result.
  • Fixed volume: each pad gets the Volume per pad. The Dose correction multiplies the result.
  • Legacy: the uncalibrated cycle of the old version. The calibration fields are disabled. The Forward and Reverse fields show the legacy times.

Motor and stepper drives

  • Motor: the speed of the motor sets the flow. Measure the flow at the Forward speed and enter it in Measured flow. No flow is assumed without a measurement.
  • Stepper: the plunger moves a set distance. The Syringe internal diameter, Screw pitch, Motor turns / screw turn and Maximum plunger speed convert the volume into plunger travel.

Pad placement

  • Auto fills wide pads with raster strokes. It uses dots when a line cannot fit on the pad.
  • The Dot footprint is the measured dot size. A dot must fit inside the pad.

Geometry and CNCJob

  • Regenerate the Geometry after you change the quantity or the placement.
  • Controller and calibration changes apply to the next CNCJob. They do not change an existing CNCJob.

Controller notes

  • GRBL: stock GRBL supports the spindle motor only. Set $32=0 and select the Spindle mode. Paste dispensing needs this mode.
  • Marlin: select E with Linear units. Set the cold extrusion and the E steps per millimetre in the firmware. The plugin does not enable a heater.

Limits

  • If the Gerber object has no pads, the plugin reports Failed. and makes no Geometry object.
  • If the Tools Table is empty, the plugin reports Tools table is empty. and makes no Geometry object.

See also

Clone this wiki locally