2009-01-25 00:48:56 +01:00
|
|
|
/*
|
2014-02-09 18:46:34 +01:00
|
|
|
protocol.h - controls Grbl execution protocol and procedures
|
2014-08-07 13:58:04 +02:00
|
|
|
Part of Grbl v0.9
|
2009-01-25 00:48:56 +01:00
|
|
|
|
2015-01-15 06:14:52 +01:00
|
|
|
Copyright (c) 2012-2015 Sungeun K. Jeon
|
2009-01-25 00:48:56 +01:00
|
|
|
|
|
|
|
Grbl is free software: you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
Grbl is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
GNU General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with Grbl. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
2014-08-07 13:58:04 +02:00
|
|
|
/*
|
|
|
|
This file is based on work from Grbl v0.8, distributed under the
|
|
|
|
terms of the MIT-license. See COPYING for more details.
|
|
|
|
Copyright (c) 2009-2011 Simen Svale Skogsrud
|
|
|
|
Copyright (c) 2011-2012 Sungeun K. Jeon
|
|
|
|
*/
|
|
|
|
|
2011-05-31 22:45:38 +02:00
|
|
|
#ifndef protocol_h
|
|
|
|
#define protocol_h
|
2009-01-25 00:48:56 +01:00
|
|
|
|
2012-10-22 03:18:24 +02:00
|
|
|
// Line buffer size from the serial input stream to be executed.
|
|
|
|
// NOTE: Not a problem except for extreme cases, but the line buffer size can be too small
|
|
|
|
// and g-code blocks can get truncated. Officially, the g-code standards support up to 256
|
|
|
|
// characters. In future versions, this will be increased, when we know how much extra
|
2014-01-11 04:22:10 +01:00
|
|
|
// memory space we can invest into here or we re-write the g-code parser not to have this
|
2012-10-22 03:18:24 +02:00
|
|
|
// buffer.
|
2012-11-09 03:23:47 +01:00
|
|
|
#ifndef LINE_BUFFER_SIZE
|
Settings refactoring. Bug fixes. Misc new features.
This is likely the last major change to the v0.9 code base before push
to master. Only two minor things remain on the agenda (CoreXY support,
force clear EEPROM, and an extremely low federate bug).
- NEW! Grbl is now compile-able and may be flashed directly through the
Arduino IDE. Only minor changes were required for this compatibility.
See the Wiki to learn how to do it.
- New status reporting mask to turn on and off what Grbl sends back.
This includes machine coordinates, work coordinates, serial RX buffer
usage, and planner buffer usage. Expandable to more information on user
request, but that’s it for now.
- Settings have been completely renumbered to allow for future new
settings to be installed without having to constantly reshuffle and
renumber all of the settings every time.
- All settings masks have been standardized to mean bit 0 = X, bit 1 =
Y, and bit 2 = Z, to reduce confusion on how they work. The invert
masks used by the internal Grbl system were updated to accommodate this
change as well.
- New invert probe pin setting, which does what it sounds like.
- Fixed a probing cycle bug, where it would freeze intermittently, and
removed some redundant code.
- Homing may now be set to the origin wherever the limit switches are.
Traditionally machine coordinates should always be in negative space,
but when limit switches on are on the opposite side, the machine
coordinate would be set to -max_travel for the axis. Now you can always
make it [0,0,0] via a compile-time option in config.h. (Soft limits
routine was updated to account for this as well.)
- Probe coordinate message immediately after a probing cycle may now
be turned off via a compile-time option in config.h. By default the
probing location is always reported.
- Reduced the N_ARC_CORRECTION default value to reflect the changes in
how circles are generated by an arc tolerance, rather than a fixed arc
segment setting.
- Increased the incoming line buffer limit from 70 to 80 characters.
Had some extra memory space to invest into this.
- Fixed a bug where tool number T was not being tracked and reported
correctly.
- Added a print free memory function for debugging purposes. Not used
otherwise.
- Realtime rate report should now work during feed holds, but it hasn’t
been tested yet.
- Updated the streaming scripts with MIT-license and added the simple
streaming to the main stream.py script to allow for settings to be sent.
- Some minor code refactoring to improve flash efficiency. Reduced the
flash by several hundred KB, which was re-invested in some of these new
features.
2014-07-26 23:01:34 +02:00
|
|
|
#define LINE_BUFFER_SIZE 80
|
2012-11-09 03:23:47 +01:00
|
|
|
#endif
|
2012-10-22 00:55:59 +02:00
|
|
|
|
2014-02-09 18:46:34 +01:00
|
|
|
// Starts Grbl main loop. It handles all incoming characters from the serial port and executes
|
|
|
|
// them as they complete. It is also responsible for finishing the initialization procedures.
|
|
|
|
void protocol_main_loop();
|
|
|
|
|
2015-01-15 06:14:52 +01:00
|
|
|
// Checks and executes a realtime command at various stop points in main program
|
|
|
|
void protocol_execute_realtime();
|
2011-12-09 02:47:48 +01:00
|
|
|
|
2014-02-09 18:46:34 +01:00
|
|
|
// Notify the stepper subsystem to start executing the g-code program in buffer.
|
|
|
|
// void protocol_cycle_start();
|
|
|
|
|
|
|
|
// Reinitializes the buffer after a feed hold for a resume.
|
|
|
|
// void protocol_cycle_reinitialize();
|
|
|
|
|
|
|
|
// Initiates a feed hold of the running program
|
|
|
|
// void protocol_feed_hold();
|
|
|
|
|
|
|
|
// Executes the auto cycle feature, if enabled.
|
|
|
|
void protocol_auto_cycle_start();
|
|
|
|
|
|
|
|
// Block until all buffered steps are executed
|
|
|
|
void protocol_buffer_synchronize();
|
New startup script setting. New dry run, check gcode switches. New system state variable. Lots of reorganizing.
(All v0.8 features installed. Still likely buggy, but now thourough
testing will need to start to squash them all. As soon as we're done,
this will be pushed to master and v0.9 development will be started.
Please report ANY issues to us so we can get this rolled out ASAP.)
- User startup script! A user can now save one (up to 5 as compile-time
option) block of g-code in EEPROM memory. This will be run everytime
Grbl resets. Mainly to be used as a way to set your preferences, like
G21, G54, etc.
- New dry run and check g-code switches. Dry run moves ALL motions at
rapids rate ignoring spindle, coolant, and dwell commands. For rapid
physical proofing of your code. The check g-code switch ignores all
motion and provides the user a way to check if there are any errors in
their program that Grbl may not like.
- Program restart! (sort of). Program restart is typically an advanced
feature that allows users to restart a program mid-stream. The check
g-code switch can perform this feature by enabling the switch at the
start of the program, and disabling it at the desired point with some
minimal changes.
- New system state variable. This state variable tracks all of the
different state processes that Grbl performs, i.e. cycle start, feed
hold, homing, etc. This is mainly for making managing of these task
easier and more clear.
- Position lost state variable. Only when homing is enabled, Grbl will
refuse to move until homing is completed and position is known. This is
mainly for safety. Otherwise, it will let users fend for themselves.
- Moved the default settings defines into config.h. The plan is to
eventually create a set of config.h's for particular as-built machines
to help users from doing it themselves.
- Moved around misc defines into .h files. And lots of other little
things.
2012-11-03 18:32:23 +01:00
|
|
|
|
2009-01-25 00:48:56 +01:00
|
|
|
#endif
|