Browse Source

Readme Version 1.1.0

Scott Lahteine 7 years ago
parent
commit
c095ee9ce9
1 changed files with 58 additions and 117 deletions
  1. 58
    117
      README.md

+ 58
- 117
README.md View File

@@ -1,140 +1,81 @@
1 1
 # Marlin 3D Printer Firmware
2
+<img align="right" src="../../raw/1.1.x/buildroot/share/pixmaps/logo/marlin-250.png" />
3
+
4
+## Marlin 1.1.0
5
+
6
+Marlin 1.1 represents an evolutionary leap over Marlin 1.0.2. It is the result of over two years of effort by several volunteers around the world who have paid meticulous and sometimes obsessive attention to every detail. For this release we focused on code quality, performance, stability, and overall user experience. Several new features have also been added, many of which require no extra hardware.
7
+
8
+For complete Marlin documentation click over to the [Marlin Homepage <marlinfw.org>](http://marlinfw.org/), where you will find in-depth articles, how-to videos, and tutorials on every aspect of Marlin, as the site develops. For release notes, see the [Releases](https://github.com/MarlinFirmware/Marlin/releases) page.
9
+
10
+## Stable Release Branch
11
+
12
+This Release branch contains the latest tagged version of Marlin (currently 1.1.0 – May 2017).
13
+
14
+Previous releases of Marlin include [1.0.2-2](https://github.com/MarlinFirmware/Marlin/tree/1.0.2-2) (December 2016) and [1.0.1](https://github.com/MarlinFirmware/Marlin/tree/1.0.1) (December 2014). Any version of Marlin prior to 1.0.1 (when we started tagging versions) can be collectively referred to as Marlin 1.0.0.
15
+
16
+## Contributing to Marlin
17
+
18
+Click on the [Issue Queue](https://github.com/MarlinFirmware/Marlin/issues) and [Pull Requests](https://github.com/MarlinFirmware/Marlin/pulls) links above at any time to see what we're currently working on.
19
+
20
+To submit patches and new features for Marlin 1.1 check out the [bugfix-1.1.x](https://github.com/MarlinFirmware/Marlin/tree/bugfix-1.1.x) branch, add your commits, and submit a Pull Request back to the `bugfix-1.1.x` branch. Periodically that branch will form the basis for the next minor release.
21
+
22
+Note that our "bugfix" branch will always contain the latest patches to the current release version. These patches may not be widely tested. As always, when using "nightly" builds of Marlin, proceed with full caution.
23
+
24
+## Current Status: In Development
25
+
26
+Marlin development has reached an important milestone with its first stable release in over 2 years. During this period we focused on cleaning up the code and making it more modern, consistent, readable, and sensible.
27
+
28
+## Future Development
29
+
30
+Arduino IDE now supports folder hierarchies, so Marlin 1.1 is the last "flat" version of Marlin. Version 1.2 will have a hierarchical file structure, and will form the starting-point for our integration of 32-bit CPU support.
2 31
 
3
-[![Build Status](https://travis-ci.org/MarlinFirmware/Marlin.svg?branch=RCBugFix)](https://travis-ci.org/MarlinFirmware/Marlin)
4 32
 [![Coverity Scan Build Status](https://scan.coverity.com/projects/2224/badge.svg)](https://scan.coverity.com/projects/2224)
33
+[![Travis Build Status](https://travis-ci.org/MarlinFirmware/Marlin.svg)](https://travis-ci.org/MarlinFirmware/Marlin)
5 34
 
6
-<img align="top" width=175 src="buildroot/share/pixmaps/logo/marlin-250.png" />
7
-
8
-Additional documentation can be found at [The Marlin Documentation Project](https://www.marlinfw.org/).
9
-Please test this firmware and inform us if it misbehaves in any way, volunteers are standing by!
10
-
11
-## Release Candidate -- Marlin 1.1.0-RCBugFix - 6 Dec 2016
12
-
13
-__Not for production use – use with caution!__
14
-
15
-You can download earlier versions of Marlin on the [Releases page](https://github.com/MarlinFirmware/Marlin/releases). (The latest "stable" release of Marlin is 1.0.2-1.)
16
-
17
-The latest Release Candidate lives in the ["RC" branch](https://github.com/MarlinFirmware/Marlin/tree/RC). Bugs that we find in the current Release Candidate are patched in the ["RCBugFix" branch](https://github.com/MarlinFirmware/Marlin/tree/RCBugFix), so during beta testing this is where you can always find the latest code on its way towards release.
18
-
19
-## Recent Changes
20
-- RCBugFix
21
-  - Fixed broken MBL
22
-  - M600 heater timeout option
23
-
24
-- RC8 - 06 Dec 2016
25
-  - Major performance improvement for Graphical LCDs
26
-  - Simplified probe configuration
27
-  - Enable Auto Bed Leveling by type
28
-  - Reduce serial communication errors
29
-  - Make Bilinear (Mesh) Grid Leveling available for non-delta
30
-  - Support for Trinamic TMC2130 SilentStepStick SPI-based drivers
31
-  - Add `M211` to Enable/Disable Software Endstops
32
-  - Add `M355` to turn the case light on/off and set brightness
33
-  - Improved I2C class with full master/slave support
34
-  - Add `G38.2` `G38.3` command option for CNC style probing
35
-  - Add `MINIMUM_STEPPER_PULSE` option to adjust step pulse duration
36
-  - Add `R` parameter support for `G2`/`G3`
37
-  - Add `M43` optional command (`PINS_DEBUGGING`)
38
-  - Remove SCARA axis scaling
39
-  - Improved sanity checking of configuration
40
-  - Improved support for PlatformIO and command-line build
41
-  - Usable `DELTA_CALIBRATION_MENU`
42
-  - Support for Printrbot Rev.F
43
-  - New and updated languages
44
-
45
-- RC7 - 26 Jul 2016
46
-  - Add Print Job Timer and Print Counter (`PRINTCOUNTER`)
47
-  - New `M600` Filament Change (`FILAMENT_CHANGE_FEATURE`)
48
-  - New `G12` Nozzle Clean (`NOZZLE_CLEAN_FEATURE`)
49
-  - New `G27` Nozzle Park (`NOZZLE_PARK_FEATURE`)
50
-  - Add support for `COREYZ`
51
-  - Add a new Advance Extrusion algorithm (`LIN_ADVANCE`)
52
-  - Add support for inches, Fahrenheit, Kelvin units (`INCH_MODE_SUPPORT`, `TEMPERATURE_UNITS_SUPPORT`)
53
-  - Better handling of `G92` shifting of the coordinate space
54
-  - Add Greek and Croatian languages
55
-  - Improve the Manual (Mesh) Bed Leveling user interface
56
-  - Add support for more boards, controllers, and probes:
57
-    - Vellemann K8400 (`BOARD_K8400`)
58
-    - RigidBot V2 (`BOARD_RIGIDBOARD_V2`)
59
-    - Cartesio UI (`BOARD_CNCONTROLS_12`)
60
-    - BLTouch probe sensor (`BLTOUCH`)
61
-    - Viki 2 with RAMPS and MKS boards
62
-  - Improve support for `DELTA` and other kinematics
63
-  - Improve thermal management, add `WATCH_BED_TEMP_PERIOD`
64
-  - Better handling of toolchange, multiple tools
65
-  - Add support for two X steppers `X_DUAL_STEPPER_DRIVERS`
66
-  - Add support for `SINGLENOZZLE`, `MIXING_EXTRUDER`, and `SWITCHING_EXTRUDER`
67
-  - Simplified probe configuration, allow usage without bed leveling
68
-  - And much more… See the [1.1.0-RC7 Change Log](https://github.com/MarlinFirmware/Marlin/releases/tag/1.1.0-RC7) for the complete list of changes.
69
-
70
-- RC6 - 24 Apr 2016
71
-  - Marlin now requires Arduino version 1.6.0 or later
72
-  - Completed support for CoreXY / CoreXZ
73
-  - See the [1.1.0-RC6 Change Log](https://github.com/MarlinFirmware/Marlin/releases/tag/1.1.0-RC6) for all the changes.
74
-
75
-- RC5 - 01 Apr 2016
76
-  - Warn if compiling with older versions (<1.50) of Arduino
77
-  - Fix various LCD menu issues
78
-  - Add formal support for MKSv1.3 and Sainsmart (RAMPS variants)
79
-  - Fix bugs in M104, M109, and M190
80
-  - Fix broken M404 command
81
-  - Fix issues with M23 and "Start SD Print"
82
-  - More output for M111
83
-  - Rename FILAMENT_SENSOR to FILAMENT_WIDTH_SENSOR
84
-  - Fix SD card bugs
85
-  - and a lot more
86
-  - See the [1.1.0-RC5 Change Log](https://github.com/MarlinFirmware/Marlin/releases/tag/1.1.0-RC5) for more!
87
-
88
-- RC4 - 24 Mar 2016
89
-  - Many lingering bugs and nagging issues addressed
90
-  - Improvements to LCD menus, CoreXY/CoreXZ, Delta, Bed Leveling, and more…
91
-
92
-- RC3 - 01 Dec 2015
93
-  - A number of language sensitive strings have been revised
94
-  - Formatting of the LCD display has been improved to handle negative coordinates better
95
-  - Various compiler-related issues have been corrected
96
-
97
-- RC2 - 29 Sep 2015
98
-  - File styling reverted
99
-  - LCD update frequency reduced
100
-
101
-- RC1 - 19 Sep 2015
102
-  - Published for testing
103
-
104
-## Submitting Patches
105
-Proposed patches should be submitted as a Pull Request against the [RCBugFix](https://github.com/MarlinFirmware/Marlin/tree/RCBugFix) branch.
106
-
107
-- Don't submit new feature proposals. The RCBugFix branch is for fixing bugs in existing features.
108
-- Do submit questions and concerns. The "naive" question is often the one we forget to ask.
109
-- Follow the proper coding style. Pull requests with styling errors will be delayed. See our [Coding Standards](https://github.com/MarlinFirmware/Marlin/wiki/DNE-Coding-Standards) page for more information.
110
-
111
-### [RepRap.org Wiki Page](http://reprap.org/wiki/Marlin)
35
+##### [RepRap.org Wiki Page](http://reprap.org/wiki/Marlin)
36
+##### [Marlin Home Page](http://marlinfw.org/)
37
+##### [Marlin Discussion Forum](http://forums.reprap.org/list.php?415)
112 38
 
113 39
 ## Credits
114 40
 
115 41
 The current Marlin dev team consists of:
116
-
42
+ - Roxanne Neufeld [@Roxy-3D] - English
117 43
  - Scott Lahteine [@thinkyhead] - English
118
- - [@Wurstnase] - Deutsch, English
119
- - F. Malpartida [@fmalpartida] - English, Spanish
44
+ - Bob Kuhn [@Bob-the-Kuhn] - English
45
+ - Andreas Hardtung [@AnHardt] - Deutsch, English
46
+ - Nico Tonnhofer [@Wurstnase] - Deutsch, English
120 47
  - Jochen Groppe [@CONSULitAS] - Deutsch, English
48
+ - João Brazio [@jbrazio] - Portuguese, English
49
+ - Bo Hermannsen [@boelle] - Danish, English
50
+ - Bob Cousins [@bobc] - English
121 51
  - [@maverikou]
122 52
  - Chris Palmer [@nophead]
123 53
  - [@paclema]
124
- - Edward Patel [@epatel] - Swedish, English
125 54
  - Erik van der Zalm [@ErikZalm]
126 55
  - David Braam [@daid]
127 56
  - Bernhard Kubicek [@bkubicek]
128
- - Roxanne Neufeld [@Roxy-3DPrintBoard] - English
129 57
 
130 58
 More features have been added by:
131
-  - Alberto Cotronei [@MagoKimbra]
132
-  - Lampmaker,
133
-  - Bradley Feldman,
134
-  - and others...
59
+ - Alberto Cotronei [@MagoKimbra] - English, Italian
60
+ - Thomas Moore [@tcm0116]
61
+ - Ernesto Martinez [@emartinez167]
62
+ - Petr Zahradnik [@clexpert]
63
+ - Kai [@Kaibob2]
64
+ - Edward Patel [@epatel]
65
+ - F. Malpartida [@fmalpartida] - English, Spanish
66
+ - [@esenapaj] - English, Japanese
67
+ - [@benlye]
68
+ - [@Tannoo]
69
+ - [@teemuatlut]
70
+ - [@bgort]
71
+ - [@LVD-AC]
72
+ - [@paulusjacobus]
73
+ - ...and many others
135 74
 
136 75
 ## License
137 76
 
138
-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.
77
+Marlin is published under the [GPL license](/COPYING.md) 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.
139 78
 
140 79
 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.
80
+
81
+[![Flattr this git repo](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)

Loading…
Cancel
Save