Marlin/de

From RepRap
Revision as of 11:18, 27 April 2018 by Gatherer (talk | contribs) (PID Monitoring?)
Jump to: navigation, search
Crystal Clear action run.png
Sprinter

Release status: working

Marlin Logo.png
Description
a firmware for Arduino compatible setups
License
GNU GPL v3
Author
Contributors
Based-on
Categories
CAD Models
External Link


Marlin ist Firmware für RepRap Single-Prozessor-Elektronik und unterstützt RAMPS, RAMBo, Ultimaker, BQ, und mehrere andere Arduino-basierte 3D-Drucker. Es unterstützt das Drucken über USB oder von SD-Karten mit Ordnern und verwendet eine vorausschauende Trajektorienplanung. Marlin ist unter der GNU GPL v3 oder höher lizensiert. Es basiert auf Sprinter-Firmware, lizenziert unter GPL v2 oder höher. Die aktivsten Entwickler von Marlin sind derzeit (Januar 2016) thinkyhead, AnHardt, ErikZalm, daid, boelle, Wackerbarth, bkubicek und Wurstnase, viele andere haben Patches beigesteuert.

Das Marlin Projekt wird auf GitHub gehostet.

Aktuelle Version : Marlin 1.1.8:

Funktioniert mit RAMPS 1.4, Rumba, Ultimaker, Sanguinololu, Generation_6_Electronics, und vielen andern auf AVR 8-bit basierenden Microcontrollern. Siehe Datei "boards.h" im Ursprungscode für eine komplette Liste.

Kurzinformation

Diese RepRap Firmware ist ein Mischung zwischen Sprinter und Grbl mit vielen Originalbestandteilen. Abgeleitet von Sprinter und Grbl von Erik van der Zalm. Sprinters Hauptentwickler sind Kliment und Caru. Grbls Hauptentwickler ist Simen Svale Skogsrud. Sonney Jeon (Chamnit) verbesserte einige Teile von Grbl. Eine Abspaltung von Bkubicek für den Ultimaker wurde zusammengelegt, und die weitere Entwicklung wurde von ihm unterstützt. Einige Funktionen wurden hinzugefügt von: Lampmaker, Bradley Feldman und anderen ...

Funktionen:

  • Unterbrechungs basierte Bewegung mit echter linearer Beschleunigung.
  • hohe Schrittfrequenz
  • Vorausschauende hohe Schrittfrequenz (haltet die Geschwindigkeit wenn möglich hoch. Hohe Kurvengeschwindigkeit).
  • Unterbrechungsbasierter Temperaturschutz.
  • Vorläufige Unterstützung für den Fortschrittsalgorithmus von Matthew Roberts.
  • Volle Endstop-Unterstützung.
  • SD-Karten-Unterstützung, einschließlich Ordner und lange Dateinamen.
  • LCD-Unterstützung, sowohl zeichenbasiert als auch grafisch (idealerweise 20x4 oder 128x64).
  • LCD-Menüsystem für den Standalone-SD-Karten-Druck, gesteuert von einem Klick-Encoder.
  • EEPROM Speicherung von mehreren Einstellungen.
  • viele kleine, aber handliche Dinge, die aus der Abspaltung von Bkubicek stammen.
  • Bogenunterstützung.
  • Temperaturüberschreitungsschutz
  • Dynamische Temperatur Sollwertvorgabe aka "AutoTemp."
  • Endstop-Trigger meldet die Host-Software.
  • Heizleistungs Rückmeldung. Nützlich für die PID-Überwachung.
  • CoreXY und CoreXZ Kinematik.
  • Delta Kinematik.
  • SCARA Kinematik.
  • Automatische Druckbettnivellierung und Kompensation.
  • Firmware-Binärgröße zwischen ca. 50 kB und 100 kB, abhängig von den gewählten Optionen.
  • Filament Breite Sensor Unterstützung
  • Filament Runout Sensor-Unterstützung
  • Mehrere Extruder (bis zu 4) werden unterstützt

Die Standard-Baudrate beträgt 250.000. Da diese Baudrate direkt vom üblichen 16-MHz-Takt des Arduino-Mikrocontrollers abgeleitet wird, weist sie weniger Jitter und somit weniger Fehler auf als die üblichen 115.200 Baud, aber 250.000 Baud werden von Treibern und Host-Umgebungen nicht so gut unterstützt.

Unterschiede zu der ohnehin guten Sprinter Firmware und Zusatzfunktionen

Vorausschau (Look-ahead)

Marlin hat eine ruckartige Vorausschau. Ohne sie würde sie an jeder Ecke bremsen und wieder beschleunigen. Lookahead verzögert und beschleunigt nur auf eine Geschwindigkeit ungleich Null, so dass die Änderung der Vektorgeschwindigkeit kleiner ist als der max_xy_jerk </ code>. Dies ist nur möglich, wenn einige zukünftige Züge bereits bearbeitet wurden, daher der Name Look-Ahead. Es führt zu weniger Überlagerung von Material an Ecken, insbesondere in flachen Winkeln.

Bogenunterstützung (Arc support)

Slic3r kann Kurven erkennen, obwohl diese in Segmente unterteilt sind, und eigentlich einen Bogen beschreiben sollten. Marlin kann diese Bögen drucken. Der Vorteil ist, dass die Firmware die Auflösung wählen kann und den Kreisbogen mit nahezu konstanter Geschwindigkeit ausführen kann, was zu einem schönen Ergebnis führt. Außerdem wird weniger serielle Kommunikation benötigt.

Temperature Oversampling

To reduce noise and make the PID-differential term more useful, 16 ADC conversion results are averaged.

AutoTemp

If your G-code contains a wide spread of extruder velocities, or you realtime change the building speed, the temperature should be changed accordingly. Usually, higher speed requires higher temperature. This can now be performed by the AutoTemp function. Enable AutoTemp mode with <code>M109 Sxxx Bxxx Fxxx, where S is the minimum desired temperature ("tempmin"), B is the maximum ("tempmax"), and F is the temperature factor ("factor"). You can disable it with M109 (without any F value).

When active, the maximum extruder stepper rate of all buffered moves is calculated and named "se" [steps/sec]. The desired temperature is then set to tempmin+factor*se, constrained between tempmin and tempmax. If the target temperature is set manually or by G-code to a value less then tempmin, it will be kept without change.

Example usage: M109 S215 B260 F1, which would set the minimum temperature to 215, the maximum to 260, and a factor of 1 (according to the firmware source code, this may be a good starting point for some Ultimaker printers)

Ideally, your G-Code can be completely free of temperature controls, apart from a M109 Sxxx Bxxx Fxxx in the start.gcode, and a M109 S0 in the end.gcode.

EEPROM

If you have established known working PID constants, acceleration, and max-velocity settings for your own machine, you can set them, then store them in the EEPROM. On each boot-up, Marlin will automatically load these values from EEPROM, independent of what your compiled Configuration.h says.

LCD Menu

If your hardware supports it, you can build a LCD-CardReader+Click+encoder combination. This will allow you to adjust temperatures, accelerations, velocities, and flow rates in realtime (while printing). It also provides the ability to select and print files directly from the SD card, preheat the extruder, disable the stepper motors, and do other interesting things. One working hardware configuration is documented at http://www.thingiverse.com/thing:12663. If you have at least a 20x4 or 16x2 display, useful data is shown.

SD card folders

If you have an SD card reader attached to your controller, folders are supported to a depth of 10 levels. Listing files in Pronterface shows "/path/subpath/file.g". You can write to files in subfolders by including the path (in lowercase). (Hidden files, backup files, and non-GCode files are not included in file listings.)

Endstop trigger reporting

If an endstop is hit while moving towards the endstop, the location at which the firmware thinks the endstop was triggered is output to the serial port. This is useful because the user gets a warning message. Tools like QTMarlin can use this to find acceptable combinations of velocity+acceleration.

Coding paradigm

It is not relevant from the user perspective, but Marlin is split into thematic chunks, and has tried to partially enforce private variables. This is intended to make interactions between modules clearer, and leads to a higher level of encapsulation. We think this will be useful as a preliminary step for porting to other platforms, such as ARM. Lots of RAM (with enabled LCD ~2,200 bytes) was saved by storing character strings in program memory. In the serial communication, a #define-based level of abstraction was enforced, so transfer of information is clear (usually beginning with "echo:"), an error "error:", or just normal protocol, necessary for backwards compatibility.

Interrupt-based temperature measurements

An interrupt is used to manage ADC conversions and enforce checking for critical temperatures. This leads to less blocking in the heater management routine.

Delta compatible

TODO...

CoreXY compatible

Can use a CoreXY table.

Non-standard M-Codes, different from an old version of Sprinter:

Movement:

  • G2 - CW ARC
  • G3 - CCW ARC
  • G10 - Retract according to settings.
  • G11 - Un-retract (recover) according to settings.
  • G29 - Automatic bed probing and compensation.
  • G30 - Probe Z height at the current location.

General:

  • M17 - Enable/Power all stepper motors. Compatibility with ReplicatorG.
  • M18 - Disable all stepper motors; same as M84. Compatibility with ReplicatorG.
  • M31 - Print the time since last M109 or SD print start to the serial out.
  • M42 - Change a single pin's status.
  • M80 - Turn on Power Supply.
  • M81 - Turn off Power Supply.
  • M114 - Output current position to the serial output.
  • M119 - Output Endstop status to the serial output.
  • M428 - Set home offsets based on the current position.

Movement variables:

  • M202 - UNUSED IN MARLIN. Set max acceleration in units/s^2 for travel moves (M202 X1000 Y1000)
  • M203 - Set maximum feedrate that your machine can sustain (M203 X200 Y200 Z300 E10000) in mm/sec.
  • M204 - Set default acceleration: S for print and retract, R for retract moves, T for travel moves (M204 S3000 T7000) in mm/sec^2.
  • M220 - Set the feedrate multiplier in percent. (M220 S95)
  • M301 - Set PID parameters P, I, and D. If PID_ADD_EXTRUSION_RATE is enabled, optionally set C (Kc term) and L (Last-Position-Queue length).
  • M303 - PID autotune. S = target temperature, E = extruder number or -1 for bed, C = cycles.
  • M400 - Finish all buffered moves before processing the next command.

Advance:

  • M200 - Set the filament diameter for volumetric extrusion.
  • M205 - Advanced settings. S[min feedrate] T[min travel feedrate] B[min segment time] X[max XY jerk] Z[max Z jerk] E[max E jerk].

EEPROM:

  • M500 - Store settings in EEPROM.
  • M501 - Restore settings from EEPROM.
  • M502 - Revert to default "factory settings." (Use M500 if you want to store them to EEPROM.)
  • M503 - Print the current settings (as set in memory, not the settings stored in EEPROM.)

Configuring and compilation

Simple configuration tool for Marlin Firmware Features: configuration, compilation(with PlatformIO), help for G-codes and options, console manager

What you need to know before starting:

  • What kind of printer you are using. If you are using a Cartesian printer (like the Prusa i3), you are going to need to calculate the steps/mm for each axis and for the extruder. To figure this out, you can go to http://prusaprinters.org/calculator/ or Triffid_Hunter's_Calibration_Guide. Write down the values you get for everything.
    • You need to know what kind of drive is being used with your printer. If it's a belt, you need to know what kind. If it's a screw, need to know what kind.
    • The Prusa i3 uses belts for X and Y, and screws for Z.
  • A host software like Printrun or Repetier or even Octoprint.
  1. Install the arduino software IDE/toolset, version 1.0.5 or 1.0.6 from http://www.arduino.cc/en/Main/Software
  2. Download the Marlin firmware from https://github.com/MarlinFirmware/Marlin (see the Download Zip button), or use git to clone it (if you know how to use Git).
  3. Extract the firmware to a directory of your choice.
  4. Start the Arduino IDE. Select Tools -> Board -> Arduino Mega 2560 (or whatever your microcontroller is)
  5. Select the correct serial port in Tools ->Serial Port, usually there is only one option.
  6. Open Marlin.ino in /path/to/Marlin/Marlin
  7. Browse to boards.h
    1. This is a list of motherboard types. You'll need to figure out which one you need and write down the word after #define on that line.
      • Example: If you're using a RAMPS 1.4 with a extruder, fan (optional) and heated bed, then you'd need RAMPS_13_EFB.
  8. Browse to Configuration.h
    1. Write down the value given in #define BAUDRATE for later.
    2. At the line that says #define MOTHERBOARD, replace whatever follows MOTHERBOARD with what you chose earlier.
    3. Set the #define EXTRUDERS to the number of extruders that you have.
    4. For the TEMP_SENSOR lines, you have to know what kind of thermistor is used by your hot end and heated bed (if you have one). Set the values for these to ones that match the list directly above the lines.
      • If you have an extruder on E0 and a heated bed, you just need to set TEMP_SENSOR_0 and TEMP_SENSOR_BED.
    5. Scroll down to MAX_HEATER_TEMP. If you know that your hotend shouldn't go above a certain value (the Budaschnozzle should not exceed 240C-242C), then change it here. Same for MAX_BED_TEMP.
    6. Leave the PIDTEMP stuff alone for now, we'll get back to it later.
    7. Further down the page, look for the Mechanical Settings area.
      • For the INVERT_X_DIR and related lines, set it for Mendel if you are using a Mendel-type printer. Otherwise, consult the documentation for your printer design.
      • For X_HOME_DIR and the similar commands for Y and Z, look where your endstops are. If a endstop is configured to be at the 0 position for that axis, the setting here needs to be -1. Otherwise, it needs to be 1.
      • The X_MIN_POS, X_MAX_POS, and related entries should correspond to the printable area on your bed. The defaults are common, but if you have a bigger/smaller print area, you will need to change this.
        • Please note that 0,0 should be the cartesian "bottom left" of your print-bed, if your axis homes beyond the bed in any direction, you can use a *negative value* for the X_MIN_POS and Y_MIN_POS to compensate. (If your prints never wind up in the center of the bed, this is the culprit). Also See Configuring Marlin Bed Dimensions.
      • Ignore the auto bed leveling area for now. Hopefully you will never need it.
    8. Time for the Feed rates and Steps/mm! You're almost done.
      • For #define DEFAULT_AXIS_STEPS_PER_UNIT, you will need to use the values you calculated for your different printer axes and extruder (see above). The order is {X, Y, Z, E}
      • For DEFAULT_MAX_FEEDRATE, this is the fastest (in mm/s) the printer is allowed to go.
        • For a Prusa i3, setting the Z axis value to 2 is a good idea.
      • DEFAULT_MAX_ACCELERATION is something else that should be tuned based on how good you built the hardware of your printer.
      • You should probably turn DEFAULT_ACCELERATION to a lower value initially (like 200) and adjust the acceleration later once you get everything calibrated and tuned.
    9. If you have an LCD or button panel for your printer, uncomment the respective lines for it. Otherwise, save because you are done!
  9. Click the Upload button.
    • If all goes well, the firmware has uploaded.

You are now done with your initial configuration of Marlin! It should give you reasonable results, but there's still a lot of setup to do. Head over to Triffid_Hunter's_Calibration_Guide to continue tweaking your printer.

If you ever need to change one of these firmware settings, open the Marlin project with the Arduino IDE, make your changes to Configuration.h, and re-upload (make sure your host software isn't connected when you try to upload).

Bug reports

KNOWN ISSUES: RepG will display: Unknown: marlin x.y.z

For bug reporting please use the Issue tracker on GitHub