Skip to content

Configuration Details

Jyers edited this page Aug 12, 2021 · 7 revisions

About the Different Configurations

Default

This configuration if for stock, or almost stock setups. With no bed probe or form of leveling whatsoever, this is the config if you want the closest experience to the stock firmware, with the least additional features.

BL-Touch

The BL Touch config files are intend to be used with an ANTCLABS BL Touch or similar BL Touch clone bed probes. It is labeled with a grid size (3x3 or 5x5) which indicates the amount of points on the bed that will be probed, and a High Speed probing identifier (HS) which signifies whether or not the probe will be stowed between probing moves. High Speed is safe in most cases, but will cause the probe to crash if your bed is very significantly slanted. This config provides a one step leveling option on the home menu which will create a mesh of your bed. This mesh is stored in eeprom and will need to be remade after re-flashing your firmware. M420 S1 is required in your start Gcode to enable the mesh.

Note: BL-Touch configs require the probe to be connected to the dedicated port, not the Z endstop.

Manual Mesh

These configurations are intended to be used if you do not have a bed probe, but would like to create a bed mesh to improve print quality. It is labeled with a grid size (3x3 or 5x5) which indicates the amount of points on the bed that will be probed. This config adds a leveling option to the main menu, which begins a manual leveling operation. During this operation the printer will move to a series of points, you will need to adjust the z position from menu using a piece of paper or a feeler gauge to find the correct height. Once adjusted you select "Next Point" and continue until you have probed the entire bed. Once complete your mesh will be saved to eeprom. This means the mesh will need to be remade after re-flashing your firmware. M420 S1 is required in your start Gcode to enable the mesh.

UBL

UBL stands for Unified Bed Leveling and is the most advanced of marlin's mesh bed leveling systems. This config options is labeled with BLTouch or NoProbe as it can be used with or without a bed probe. As you might imagine, using a bed probe automates much of the process while without a probe all of the leveling is done manually using the nozzle and a piece of paper or a feeler gauge. It is also labeled with a grid size (3x3, 5x5, 10x10, or 15x15) which indicates the amount of points on the bed that will be probed, and a High Speed probing identifier (HS) which signifies whether or not the probe will be stowed between probing moves. The advantage of UBL over other mesh bed leveling systems is through the abundant features it provides. Even when using a bed probe, you can use the manual menu to adjust current points, or even set points your probe can not reach. However the main attraction of UBL when used with a probe is the mesh tilting feature. The main idea of tilting is to make one very detailed mesh and then rather than remaking it next time, simply tilt it to match the bed. This works on the basis that the overall shape of your bed should not change, it is the tilt of the bed that is so easily affected. This means that by making one mesh for the shape of your bed and simply tilting it using a 2x2 probing grid, you can drastically decrease the time your printer has to spend leveling. The UBL mesh is saved to eeprom. However this does not mean mesh will need to be remade after re-flashing your firmware. UBL saves the mesh data to a different segment of eeprom that will not be effected by flashing or even by resetting eeprom from the menu. To restore a mesh after a flash or reset, simply select "Load Mesh" from the leveling menu and your previous mesh will be restored. To enable UBL you can use M420 S1 or G29 A. You also may want to tilt your mesh before every print for which you can use G29 J. UBL also allows for saving multiple meshes to eeprom, the firmware uses slot 0, so to load the mesh you created and saved in the menu you use G29 L0. An example of a startup script that will enable UBL and tilt the mesh would be: G29 A G29 J

Note: BL-Touch configs require the probe to be connected to the dedicated port, not the Z endstop.