You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
77 lines
5.8 KiB
Markdown
77 lines
5.8 KiB
Markdown
5 years ago
|
# Marlin 3D Printer Firmware
|
||
9 years ago
|
|
||
6 years ago
|
![GitHub](https://img.shields.io/github/license/marlinfirmware/marlin.svg)
|
||
|
![GitHub contributors](https://img.shields.io/github/contributors/marlinfirmware/marlin.svg)
|
||
|
![GitHub Release Date](https://img.shields.io/github/release-date/marlinfirmware/marlin.svg)
|
||
5 years ago
|
[![Build Status](https://github.com/MarlinFirmware/Marlin/workflows/CI/badge.svg?branch=bugfix-2.0.x)](https://github.com/MarlinFirmware/Marlin/actions)
|
||
9 years ago
|
|
||
5 years ago
|
<img align="right" width=175 src="buildroot/share/pixmaps/logo/marlin-250.png" />
|
||
8 years ago
|
|
||
|
Additional documentation can be found at the [Marlin Home Page](http://marlinfw.org/).
|
||
5 years ago
|
Please let us know if Marlin misbehaves in any way. Volunteers are standing by!
|
||
8 years ago
|
|
||
5 years ago
|
## Marlin 2.0
|
||
8 years ago
|
|
||
6 years ago
|
Marlin 2.0 takes this popular RepRap firmware to the next level by adding support for much faster 32-bit and ARM-based boards while improving support for 8-bit AVR boards. Read about Marlin's decision to use a "Hardware Abstraction Layer" below.
|
||
7 years ago
|
|
||
7 years ago
|
Download earlier versions of Marlin on the [Releases page](https://github.com/MarlinFirmware/Marlin/releases).
|
||
8 years ago
|
|
||
7 years ago
|
## Building Marlin 2.0
|
||
|
|
||
5 years ago
|
To build Marlin 2.0 you'll need [Arduino IDE 1.8.8 or newer](https://www.arduino.cc/en/main/software) or [PlatformIO](http://docs.platformio.org/en/latest/ide.html#platformio-ide). Detailed build and install instructions are posted at:
|
||
7 years ago
|
|
||
5 years ago
|
- [Installing Marlin (Arduino)](http://marlinfw.org/docs/basics/install_arduino.html)
|
||
|
- [Installing Marlin (VSCode)](http://marlinfw.org/docs/basics/install_platformio_vscode.html).
|
||
7 years ago
|
|
||
5 years ago
|
### Supported Platforms
|
||
7 years ago
|
|
||
5 years ago
|
Platform|MCU|Example Boards
|
||
|
--------|---|-------
|
||
|
[Arduino AVR](https://www.arduino.cc/)|ATmega|RAMPS, Melzi, RAMBo
|
||
|
[Teensy++ 2.0](http://www.microchip.com/wwwproducts/en/AT90USB1286)|AT90USB1286|Printrboard
|
||
|
[Arduino Due](https://www.arduino.cc/en/Guide/ArduinoDue)|SAM3X8E|RAMPS-FD, RADDS, RAMPS4DUE
|
||
|
[LPC1768](http://www.nxp.com/products/microcontrollers-and-processors/arm-based-processors-and-mcus/lpc-cortex-m-mcus/lpc1700-cortex-m3/512kb-flash-64kb-sram-ethernet-usb-lqfp100-package:LPC1768FBD100)|ARM® Cortex-M3|MKS SBASE, Re-ARM, Selena Compact
|
||
|
[LPC1769](https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/lpc1700-cortex-m3/512kb-flash-64kb-sram-ethernet-usb-lqfp100-package:LPC1769FBD100)|ARM® Cortex-M3|Smoothieboard, Azteeg X5 mini, TH3D EZBoard
|
||
|
[STM32F103](https://www.st.com/en/microcontrollers-microprocessors/stm32f103.html)|ARM® Cortex-M3|Malyan M200, GTM32 Pro, MKS Robin, BTT SKR Mini
|
||
|
[STM32F401](https://www.st.com/en/microcontrollers-microprocessors/stm32f401.html)|ARM® Cortex-M4|ARMED, Rumba32, SKR Pro, Lerdge, FYSETC S6
|
||
|
[STM32F7x6](https://www.st.com/en/microcontrollers-microprocessors/stm32f7x6.html)|ARM® Cortex-M7|The Borg, RemRam V1
|
||
|
[SAMD51P20A](https://www.adafruit.com/product/4064)|ARM® Cortex-M4|Adafruit Grand Central M4
|
||
|
[Teensy 3.5](https://www.pjrc.com/store/teensy35.html)|ARM® Cortex-M4|
|
||
|
[Teensy 3.6](https://www.pjrc.com/store/teensy36.html)|ARM® Cortex-M4|
|
||
8 years ago
|
|
||
5 years ago
|
## Submitting Changes
|
||
8 years ago
|
|
||
5 years ago
|
- Submit **Bug Fixes** as Pull Requests to the ([bugfix-2.0.x](https://github.com/MarlinFirmware/Marlin/tree/bugfix-2.0.x)) branch.
|
||
|
- Submit **New Features** to the ([dev-2.1.x](https://github.com/MarlinFirmware/Marlin/tree/dev-2.1.x)) branch.
|
||
7 years ago
|
- Follow the [Coding Standards](http://marlinfw.org/docs/development/coding_standards.html) to gain points with the maintainers.
|
||
|
- Please submit your questions and concerns to the [Issue Queue](https://github.com/MarlinFirmware/Marlin/issues).
|
||
8 years ago
|
|
||
5 years ago
|
## Marlin Support
|
||
|
|
||
|
For best results getting help with configuration and troubleshooting, please use the following resources:
|
||
|
|
||
|
- [Marlin Documentation](http://marlinfw.org) - Official Marlin documentation
|
||
|
- [Marlin Discord](https://discord.gg/n5NJ59y) - Discuss issues with Marlin users and developers
|
||
|
- Facebook Group ["Marlin Firmware"](https://www.facebook.com/groups/1049718498464482/)
|
||
|
- RepRap.org [Marlin Forum](http://forums.reprap.org/list.php?415)
|
||
|
- [Tom's 3D Forums](https://discuss.toms3d.org/)
|
||
|
- Facebook Group ["Marlin Firmware for 3D Printers"](https://www.facebook.com/groups/3Dtechtalk/)
|
||
|
- [Marlin Configuration](https://www.youtube.com/results?search_query=marlin+configuration) on YouTube
|
||
9 years ago
|
|
||
|
## Credits
|
||
|
|
||
|
The current Marlin dev team consists of:
|
||
6 years ago
|
|
||
5 years ago
|
- Scott Lahteine [[@thinkyhead](https://github.com/thinkyhead)] - USA [Donate](http://www.thinkyhead.com/donate-to-marlin) / Flattr: [![Flattr Scott](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=thinkyhead&url=https://github.com/MarlinFirmware/Marlin&title=Marlin&language=&tags=github&category=software)
|
||
6 years ago
|
- Roxanne Neufeld [[@Roxy-3D](https://github.com/Roxy-3D)] - USA
|
||
|
- Chris Pepper [[@p3p](https://github.com/p3p)] - UK
|
||
5 years ago
|
- Bob Kuhn [[@Bob-the-Kuhn](https://github.com/Bob-the-Kuhn)] - USA
|
||
6 years ago
|
- João Brazio [[@jbrazio](https://github.com/jbrazio)] - Portugal
|
||
6 years ago
|
- Erik van der Zalm [[@ErikZalm](https://github.com/ErikZalm)] - Netherlands [![Flattr Erik](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=ErikZalm&url=https://github.com/MarlinFirmware/Marlin&title=Marlin&language=&tags=github&category=software)
|
||
9 years ago
|
|
||
|
## License
|
||
|
|
||
8 years ago
|
Marlin is published under the [GPL license](/LICENSE) because we believe in open development. The GPL comes with both rights and obligations. Whether you use Marlin firmware as the driver for your open or closed-source product, you must keep Marlin open, and you must provide your compatible Marlin source code to end users upon request. The most straightforward way to comply with the Marlin license is to make a fork of Marlin on Github, perform your modifications, and direct users to your modified fork.
|
||
9 years ago
|
|
||
|
While we can't prevent the use of this code in products (3D printers, CNC, etc.) that are closed source or crippled by a patent, we would prefer that you choose another firmware or, better yet, make your own.
|