This drop down will be populated by candidate serial ports. Only certain ports are actual serial ports connected to Grbl/Arduino.
The easiest way to tell is to look at the list before you plug in your USB connector (presuming you are using USB serial), close Grbl Controller, plug in the USB connector, open Grbl Controller and look at the list again. The item that is new is the desired COM port.
Open – Close/Reset
Open or close the COM port. Opening the COM port will reset Grbl and set coordinates to 0,0,0. You will see a version message from Grbl appear in the status window a few seconds after pressing this button.
Closing the COM port has the effect of stopping the last operation on the Grbl. It is not a substitute for a proper emergency stop, but it is a good way to quickly stop an action. If you don’t have limit switches wired in, there is no guarantee that the motors will stop in time when you press Close/Reset.
On some Linux systems, Grbl Controller needs to be started with sudo to get permission to open the COM port.
Brings up a file chooser dialog to pick your file to send to Grbl. On most systems you can choose a file while the COM port is being opened (to save some time).
Will start sending file as soon as pressed. If Grbl Controller is still connecting with Grbl, the file will be sent immediately after all initialization is complete.
The file being sent will be stopped mid-stream. Currently there is no way to restart a stopped send of file.
If you have enabled aggressive preload in the options, pressing Stop may result in a longer wait for the stopped state due to commands already queued in Grbl.
Progress Bar and Runtime
The progress bar shows a percent of lines sent from the file. The Runtime display shows a realtime display of the number of hours, minutes and seconds that the file has been in the process of being sent. The Runtime will stop when the file has been completely sent, thus showing how long it took to send the file.
Enter GCode commands to execute immediately.
It has been observed that Grbl occasionally enters a state where specifying simple X1, Z30, etc. commands do not work. You must first preface with a G0 or G1. Once that is done, it should again be possible to send further commands with just the X, Y or Z command directly.
Hit the Enter key to accept the command.
The position entered will be interpreted in inches or millimeters depending on the mode specified in the options (Grbl v0.8c+).
Machine/Work Coordinates LCDs
The machine coordinates are X,Y,Z coordinates that are referenced from the point of opening the COM port to Grbl. The machine coordinates are primarily useful for homing.
The work coordinates are the X,Y,Z coordinates that may be reset back to 0 if desired and all commands will reference the new work coordinates.
Grbl Controller, starting version 3.1, displays Grbl’s coordinates in the LCD displays. It never computes these values from entered commands. It attempts to provide reasonably up-to-date values of at least once a second during file sends.
When zeroing the coodinates, it is normal for the work coordinates to be off by a tiny fraction from 0, such as 0.001.
If you have enabled “inches” mode in the options, the display will show inches, otherwise, it normally shows millimeters.
This displays the last known Grbl operational state. This is normally going to show Idle or Run, but may contain other states. Only available with Grbl 0.8c+.
Axis Adjust/Jog and Step Size
Use the buttons to move the motors by the amount relative, specified by the Step Size value.
If you have enabled “inches” mode in the options, the Step Size will be interpreted in inches, otherwise, it will be interpreted in millimeters.
Absolute coordinates after adjust
If enabled, when you enter a command in the Manual GCode entry, the values are interpreted in absolute work coordinates.
For example, if you want to move the X coordinates to 10 and the display is showing 2, then enter X10 for your command.
If disabled, when you enter a command in the Manual GCode entry, the value will be relative to the current coordinates.
For example, if you want to move the X coordinates to 10 and the display is showing 2, then enter X8 for your command.
Which mode you choose is dependent on how you prefer to work with Grbl Controller.
Enables or disables the spindle motor, provided you have that capability wired into your board and to an external motor controller.
Reset Control – Soft Reset Grbl
This sends a special reset command to Grbl which causes it to reboot and reinitialize. It does not affect machine coordinates, but it will reset work coordinates to match machine coordinates. Use Zero Position to restore work coordinates to 0.
Reset Control – Unlock Grbl
There are certain conditions where Grbl gets conflicting commands or otherwise enters an error state. If this happens, it will “lock” to prevent commands from causing harm to equipment.
Use this button to unlock Grbl, but only after you have ensured that the CNC mill is in proper operational condition.
Simply resets the work coordinates to 0, but is used frequently to restore operation from a new coordinate base, such as after aligning the spindle/bit over what is considered position 0,0,0 on the work piece.
After running a file, this is used to move the spindle up and over the work piece back over X=0 and Y=0. The Z coordinate will be three mm higher than the highest point of Z-travel during the file send.
This brings up a dialog that is dynamically populated with available adjustable settings in the Grbl software. The number of settings varies with Grbl version. Any settings that are changed will be sent to Grbl and it will update its non-volatile memory.