Skip to content

Commit

Permalink
Merge pull request #1353 from Willmac16/gh-pages
Browse files Browse the repository at this point in the history
  • Loading branch information
jneilliii authored Feb 28, 2025
2 parents 2dcdb63 + ece5240 commit 59cbc2d
Showing 1 changed file with 26 additions and 2 deletions.
28 changes: 26 additions & 2 deletions _plugins/gcodeleveling.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,10 +32,31 @@ compatibility:
python: '>=2.7,<4'
---

# Gcode Leveling
# OctoPrint-GcodeLeveling

This plugin creates a model of the work surface (using the least squares method on user provided points), allowing for leveling of machines through gcode that otherwise cannot be leveled (e.g. for a grbl machine). A user just needs to measure some z values at a variety of x and y values (e.g. with the paper test), then configure a couple of settings, and the plugin will handle the leveling on file upload.

This plugin really only makes sense it you have no other way of leveling out stuff (i.e. your firmware doesn't offer that feature or you are working on a warped material).

## Gcode Support

* This plugin should be fine with most gcode since it only changes movement commands; however, for movement commands and commands that change how movement commands function (e.g. changes in relative/absolute movement) support needs to be added to the plugin.

### Supported Commands
+ `G0`
+ `G1`
+ `G2`/`G3`
- See the note on `G17-19`
+ `M82`/`M83`

### Monitored Commands
+ `G90` `G91`
- the plugin will not change any values in relative positioning mode
+ `G17` `G18` `G19`
- the plugin only modifies arcs in XY workspace mode
+ `G92`
- extruder position resets will be respected, any other position resets will stop the plugin from changing any future values on a file

## Setup

Install via the bundled [Plugin Manager](https://docs.octoprint.org/en/master/bundledplugins/pluginmanager.html)
Expand All @@ -44,7 +65,10 @@ or manually using this URL:
https://github.com/willmac16/OctoPrint-GcodeLeveling/archive/master.zip

+ The plugin depends on numpy, so it will need to install this (if it is not already installed), which can take some time on a raspberry pi.
- Numpy in a python3 environment requires libatlas3-base, so some instances may need to run ```sudo apt install libatlas3-base``` to install properly.
- Numpy in a python3 environment requires libatlas3-base, so some instances may need to run the following to install properly
```bash
sudo apt install libatlas3-base libopenblas-dev
```

## Configuration

Expand Down

0 comments on commit 59cbc2d

Please sign in to comment.