Repetier-Firmware configuration tool for version 0.91 Rev 8

Introduction

The configurator is the solution to the typical configuration hell, when it comes to creating or updating a new firmware for your 3d printer. While the wanted values are quite simple, many users get lost in the different options and when they need to be set. In this configurator we try to hide all information and settings, that are not relevant for your printer, based on previous answers. For that reason work yourself through the top menus from left to right and answer the questions from top to bottom.

This is the latest stable version. It will get no more updates or fixes since version 0.92 is in a good shape and is already usable. In fact users with Arduino due based boards should upgrade to 0.92 and enable watchdog in that version. All other users can safely continue to use this version until 0.92 is declared stable or if you like to live with the latest features and improvements you can already switch to 0.92.
Switch to 0.92

Upload old configuration

If you have already made a configuration - including older versions - you can upload the Configuration.h or config.json file to set all options to that settings. If you choose the Configuration.h, the settings are taken from the embedded json string. All changes in the normal part are lost. New parameter are highlighted like this:

I'm a new option!

Attention! Only config files generated by this configuration tool can be uploaded!

If you enable eeprom, you can change the most important parameter after installation over the host. Please be aware that the eeprom values overwrite settings in Configuration.h! To overwrite exiting settings select a different eeprom set.

If you intend to use the printer from a linux pc, select a ansi baud rate.

Dimensions

[mm]
[mm]
[mm]
[mm]
[mm]
[mm]
[mm]
[mm]

You need to enter the horizontal distance of the diagonal rod, when the carriage is at center position.
[mm]

This value limits the movement radius to prevent illegal positions.
[°]
[mm]
[mm]

Stepper

[s]
[s, 0 = disabled]
[-]
[-]
[10-xxx, higher values need more ram. If you use too much ram your firmware will crash!]
[microseconds] Needed for gantry systems and due boards.
[Hz, Atmel AVR has a limit near 12000 Hz]
[microseconds, increase when you loose steps going > double step frequency]
[processor steps] 1999 is a good value for AVR. Higher values increase load and quality.
[moves] Higher values require more ram. Cartesian printer can go up to 32 on Atmel AVR, Deltas until 16.
[entries, 0..Move Cache Size]
[processor steps]
[mm/s]
[mm/s]

X axis stepper motor

[steps per mm]
[mm/s]
[mm/s]
[mm/s2]
[mm/s2]
[mm]

Y axis stepper motor

[steps per mm]
[mm/s]
[mm/s]
[mm/s2]
[mm/s2]
[mm]

Z axis stepper motor

[steps per mm]
[mm/s]
[mm/s]
[mm/s2]
[mm/s2]
[mm/s]

Endstops


You can test the endstops with the M119 command. As long as they are not triggered, the returned message should show "L" as signal state.
[mm for X,Y and Z]
[- for X,Y and Z]
[- for X,Y and Z]
This is the distance, that the extruder will have to endstops after homing is finished. Use this if you want to prevent triggering when you are near endstops or for delta printers to go a bit lower, so you can select between extruders without hitting the endstop.
[°C, 0 = disabled]
If enabled, the temperature must be for watchperiod seconds inside a +/- corridor of the target range, before it is finished.
[°C]
Range where the selected heat manager controls output. Ouside this range extruder/bed are heated with full power.
[°C]
Calling M109 (set bed temp and wait) will finish immediately, if the bed has already a temperature that close to target temperature.
[°C]
Enables the extruder cooler if extruder temp is warmer or value is higher then this value.
[°C]
Ignores extruder moves, if extruder is cooler then this value.
[°C]
Maximum temperature you can define. Larger values get reduced to this value.
[°C]
Temperatures below this lets the firmware assume, that the thermistor is defect.
[°C]
Temperatures higher this lets the firmware assume, that the thermistor is defect.
[mm filament going in]
When you try to extruder more then this in one move, the extrusion gets ignored. Protects for wrong defined extrusion commands, e.g. if you stopped printing and did not reset extrusion position to 0.

Heated bed

[°C]
[°C]
[0-255] Determines maximum power for heater.
[milliseconds]
[0-255] Minimum power when heating.
[0-255] Maximum power during pid control. Increase when target temperature can not be reached.
Increases power proportionally to temperature difference.
Integral factor
Damping factor
[0-255] Increase when target temperature can not be reached.
[seconds] Time between heater on and temperature rise.

Extruder

Extruder {{$index}}

[mm]
[mm]
[mm/s]
[mm]
[steps per mm]
[mm/s2]
[0-255] Determines maximum power for heater.
[0-255] Minimum power when heating.
[0-255] Maximum power during pid control. Increase when target temperature can not be reached.
Increases power proportionally to temperature difference.
Integral factor
Damping factor
[0-255] Increase when target temperature can not be reached.
[seconds] Time between heater on and temperature rise.
The extruder cooler is not the fan cooling your print! It cools only the extruder for a smaller transition zone.
[0-255]
[-]
[-]
[mm] Distance to retract during heat up.
[°C] Temperature, where the retract will take place
These commands get executed, when an extruder switch is commanded. First the deselect commands from the active extruder get executed, then the new extruder is selected and the select commands get executed. Separate multiple commands by "\n".

Temperature Tables

If you have a datasheet for your thermistor, you will find the values for T0/R0 (typical 25°C and 100000 Ohm) as well as the beta there. Min and max temperature defaults should work for all thermistors. The resistors R1 and R2 depend on your printer controller board. All known boards use R1=0 and R2=4700 ohm, which is also what the precomputed tables assume. Be aware that the computation from these values is not as exact as tables derived from the datasheet resistances at various temperatures. Especially for higher temperatures the drift gets stronger. You can get more exact values in your operating range, when you have T0/R0 in that range and not at 25°C.

Generic Table 1

[°C]
[Ohm]
[Ohm]
[°C]
[°C]
[Ohm]
[Ohm]

Generic Table 2

[°C]
[Ohm]
[Ohm]
[°C]
[°C]
[Ohm]
[Ohm]

Generic Table 3

[°C]
[Ohm]
[Ohm]
[°C]
[°C]
[Ohm]
[Ohm]
If you have a datasheet for your thermistor, you can build your own thermistor table. To make it easy you can enter directly the temperatures and resistances from your datasheet. The adc values and modified temperature values are computed for you. All known boards use R1=0 and R2=4700 ohm, which is also what the precomputed tables assume. Do not use too much values. 20 degree steps for unused temperatures and 10° steps in important ranges are enough. More values only cost more computation time.

User defined Thermistor table 1

[Ohm]
[Ohm]
Temperature [°C] Resistance [Ohm] ADC
{{t.t}} {{t.r}} {{t.adc}}

User defined Thermistor table 2

[Ohm]
[Ohm]
Temperature [°C] Resistance [Ohm] ADC
{{t.t}} {{t.r}} {{t.adc}}

User defined Thermistor table 3

[Ohm]
[Ohm]
Temperature [°C] Resistance [Ohm] ADC
{{t.t}} {{t.r}} {{t.adc}}
[-]

Z-Probing

[mm] = Max. distance to go back for next test
[mm] = extruder height when probe triggers
[mm/s]
[mm/s]
[mm]
[-]
[mm]
[mm]
X/Y in [mm] from origin
X/Y in [mm] from origin
X/Y in [mm] from origin

Servo configuration

Servos can use any digital pin. PWM is not necessary! Please note that servos should have their own 5V source, not the one used to power the board. Usage:
M340 P<servoId> S<pulseInUS> : servoID = 0..3, Servos are controlled by a pulse with normally between 500 and 2500 with 1500ms in center position. 0 turns servo off.

You selected custom configuration of your user interface. This is the most flexible option and requires you to modify uiconfig.h to your needs. Please read the configuration manual and the comments in uiconfig.h on how to do the setup correctly.

[milliseconds]
[milliseconds]
[milliseconds]
[milliseconds]
[milliseconds]
[milliseconds]
[milliseconds]
[°C]
[°C]
[°C]
[°C]
[°C]
[°C]
[°C]
[°C]
[mm/s]
[mm]
Adds a menu entry in the LCD menu to toggle light on/off

Please notice the warnings below, which normally indicate a wrong or bad choice of configuration combination.

  • {{w}}

There are three options to continue your work:

  1. Download complete firmware incl. these settings
    This returns a zip file with the complete firmware including your settings in Configuration.h. You can upload the contained Configuration.h later to continue configuration or use it for future versions. The README.txt contains all instuctions needed for compilation.
  2. Download Configuration.h
    This returns only the modified Configuration.h file. Use it to update an existing firmware.
  3. Download config.json
    This file only contains your configuration settings. It is not needed for compilation and contains only the settings part of the Configuration.h. Useful for printer vendors who want to offer a pre configured and testen configuration to allow future firmware updates.