Go to file
Sonny Jeon 79e0fd594b Added step pulse delay after direction set (Compile-time option only). Updated read me.
Added a compile-time only experimental feature that creates a
user-specified time delay between a step pulse and a direction pin set
(in config.h). This is for users with hardware-specific issues
(opto-couplers) that need more than a few microseconds between events,
which can lead to slowly progressing step drift after many many
direction changes. We suggest to try the hack/fix posted in the Wiki
before using this, as this experimental feature may cause Grbl to take
a performance hit at high step rates and about complex curves.
2012-06-26 21:48:42 -06:00
doc Initial v0.8 ALPHA commit. Features multi-tasking run-time command execution (feed hold, cycle start, reset, status query). Extensive re-structuring of code for future features. 2011-12-08 18:47:48 -07:00
script Streaming script argparse bugfix. 2012-01-27 19:51:16 -07:00
.gitignore merged master 2011-01-31 19:42:56 +01:00
config.h Added step pulse delay after direction set (Compile-time option only). Updated read me. 2012-06-26 21:48:42 -06:00
COPYING renamed file 2009-01-26 10:51:02 +01:00
eeprom.c formatting 2011-01-31 23:04:39 +01:00
eeprom.h Added runtime configurable global settings with eeprom persitence 2010-03-07 20:29:18 +01:00
gcode.c Minor fix related to spindle_stop() crashing abort in certain cases. 2012-03-10 12:34:09 -07:00
gcode.h G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
limits.c Minor updates. 2012-03-05 12:01:02 -07:00
limits.h added support for limit switches and homing action 2011-02-20 00:29:56 +01:00
main.c Minor fix related to spindle_stop() crashing abort in certain cases. 2012-03-10 12:34:09 -07:00
Makefile Minor updates. 2012-03-05 12:01:02 -07:00
motion_control.c Program stop support (M0,M1*,M2,M30*), proper position retainment upon reset, misc minor updates. 2012-01-28 20:41:08 -07:00
motion_control.h G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
nuts_bolts.c G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
nuts_bolts.h Minor include related compile fix. Added experimental XON/XOFF flow control. Not officially supported! 2012-02-25 09:06:42 -07:00
planner.c G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
planner.h G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
print.c Program stop support (M0,M1*,M2,M30*), proper position retainment upon reset, misc minor updates. 2012-01-28 20:41:08 -07:00
print.h Program stop support (M0,M1*,M2,M30*), proper position retainment upon reset, misc minor updates. 2012-01-28 20:41:08 -07:00
protocol.c G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
protocol.h G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
readme.textile Added step pulse delay after direction set (Compile-time option only). Updated read me. 2012-06-26 21:48:42 -06:00
serial.c Minor fix related to spindle_stop() crashing abort in certain cases. 2012-03-10 12:34:09 -07:00
serial.h G54 work coordinate support (w/ G10,G92.1). Re-factored g-code parser with error checking. Minor compiler compatibility changes. 2012-02-11 11:59:35 -07:00
settings.c Position reporting, refactored system variables, serial print fixes, updated streaming scripts. 2012-01-06 10:10:41 -07:00
settings.h Position reporting, refactored system variables, serial print fixes, updated streaming scripts. 2012-01-06 10:10:41 -07:00
spindle_control.c Minor fix related to spindle_stop() crashing abort in certain cases. 2012-03-10 12:34:09 -07:00
spindle_control.h refactored block buffer into separate module motion_plan pending the addition of the actual look ahead planner 2011-01-14 16:45:18 +01:00
stepper.c Added step pulse delay after direction set (Compile-time option only). Updated read me. 2012-06-26 21:48:42 -06:00
stepper.h Spindle DDR pins init minor fix. 2012-02-12 11:02:23 -07:00

h1. Grbl - An embedded g-code interpreter and motion-controller for the Arduino/AVR328 microcontroller
    
Grbl is a no-compromise, high performance, low cost alternative to parallel-port-based motion control for CNC milling. It will run on a vanilla Arduino (Duemillanove/Uno) as long as it sports an Atmega 328. 

The controller is written in highly optimized C utilizing every clever feature of the AVR-chips to achieve precise timing and asynchronous operation. It is able to maintain more than 30kHz of stable, jitter free control pulses.

It accepts standards-compliant G-code and has been tested with the output of several CAM tools with no problems. Arcs, circles and helical motion are fully supported, as well as, other basic functional g-code commands. Functions and variables are not currently supported, but may be included in future releases in a form of a pre-processor.

Grbl includes full acceleration management with look ahead. That means the controller will look up to 18 motions into the future and plan its velocities ahead to deliver smooth acceleration and jerk-free cornering.

*Changelog for v0.8 from v0.7:*
  - *ALPHA status: _Under heavy development. Code state may significantly change with each push as new features are integrated._*
  - Major structural overhaul to allow for multi-tasking events and new feature sets
  - New run-time command control: Feed hold (pause), Cycle start (resume), Reset (abort), Status reporting
  - Controlled feed hold with deceleration to ensure no skipped steps and loss of location.
  - After feed hold, cycle accelerations are re-planned and may be resumed.
  - Re-factored g-code parser with robust error-checking.
  - Work coordinate system (G54), offsets(G92), and machine coordinate system support. G10 work coordinate settings support. (Up to 6 work coordinate systems(G54-G59) available as a compile-time option.)
  - Program stop(M0,M1*,M2,M30) initial support. Optional stop to do.
  - System reset re-initializes grbl without resetting the Arduino and retains machine/home position and work coordinates.
  - Restructured planner and stepper modules to become independent and ready for future features.
  - Reduced serial read buffer to 128 characters and increased write buffer to 64 characters.
  - Misc bug fixes and removed deprecated acceleration enabled code.  
  - Planned features: Jog mode, full-featured status reporting, runtime settings such as toggling block delete.
  - Advanced compile-time options: Up to 6 work coordinate systems(G54-G59), XON/XOFF flow control (limited support), direction and step pulse time delay.
  

*Important note for Atmega 168 users:* Going forward, support for Atmega 168 will be dropped due to its limited memory and speed. However, legacy Grbl v0.51 "in the branch called 'v0_51' is still available for use.

_The project was initially inspired by the Arduino GCode Interpreter by Mike Ellery_