Repository navigation
Solder Paste
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.
- 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.
- Load a Gerber object with the solder paste pads (the paste layer). See Importing Files.
- Open the plugin with Alt+K.
- Set the calibration in the Hardware, Quantity, Placement and Cycle tabs. Start with the values of your syringe and your machine.
- 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.
- Set Margin, Travel Z, the Dispense heights and the Feedrate values.
- Set the Tool change position (X-Y and Z).
- Check the Preprocessor in the Common Parameters frame. In the calibrated modes the Controller sets it.
- Select the Gerber object in Source Object. Click Generate Geometry.
- Select the new Geometry object in the Geometry Solder Paste list. Click Generate CNCJob.
- 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.
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.
| 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 |
| 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.
| 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 |
| 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 |
| 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. | — |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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. | — |
| 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. | — |
- 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: 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.
- 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.
- 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.
- 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.
- 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.
- Gerber Object - the source of the pads.
- Geometry Object - the Geometry made by the plugin.
- CNCJob Object - the G-code object and the save step.
- Preprocessors - the output files of the machine.
- Preferences CNCJob - the default output settings.
- Drilling and Milling - other G-code jobs.
- Keyboard Shortcuts - all shortcut keys.
FlatCAM Evo Manual · Source code · Report a problem · MIT license
Start here
- Installation
- Getting Started
- Tutorial: Single-Sided PCB
- Tutorial: Double-Sided PCB
- User Interface
- Keyboard Shortcuts
- Glossary
- FAQ and Troubleshooting
Files and projects
Objects
Editors
PCB operations
- Isolation Routing
- Non-Copper Clearing
- Paint
- Cutout
- Drilling
- Milling
- Follow
- Double-Sided
- Solder Paste
- Film
- Panelize
- Copper Thieving
- Fiducials
- Markers
- Punch Gerber
- Invert Gerber
- Etch Compensation
- Extract
- Rules Check
- QR Code
Utility plugins
- Align Objects
- Calculators
- Distance · Object Distance
- Optimal
- Move · Transform
- Subtract
- Image Import · PDF Import
- PCB Wizard
- Report
- Tcl Shell
Machine control (in development)
Advanced
- Tools Database
- Preprocessors
- Path Optimization
- Tcl Scripting
- Tcl Command Reference
- Developer Guide
- Translating
Preferences