Skip to content
Allows any machines and robots to be controlled by G-Code
Branch: master
Clone or download
Latest commit b1845f6 Nov 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
.gitignore Initial commit Oct 31, 2018
LICENSE Initial commit Oct 31, 2018
README.md Update README.md Nov 29, 2018
gcode.cpp Add files via upload Nov 13, 2018
gcode.h

README.md

G-Code Arduino Library

https://tinkersprojects.com/
This is a library that alows any machine or robot to be controlled by G-Code

Features

  • serial or character input
  • Customisable

What is G-Code?

G-Code is the instructions that 3D Printer and CNC used to create there part. G-Code is a set of instruction commands sent to the controller of the machine to be performed. Position, feed rate, and tool used are some of the items that G-Code can control. The G-Code can either be sent from the computer or saved on an SD card.

Why make this library?

This library allows any machine or robot to be controlled by G-Code. It makes it quick and easy to set up with CNC and machine software and gives much better control over the communications and commands.

Why use this?

If your project requires computer control or a set of instruction, a library like this will help simplify this process of making it your self.

Functions

SETUP

gcode(),
gcode(void (*CallBack)()),
gcode(int numbercommands, commandscallback *commandArray),
gcode(int numbercommands, commandscallback *commandArray, void (*CallBack)());

This Function is used to declare this class so that it can be used in the program. There are 4 different functions, each with variables that can be set. The callback is used to link a call back function used after each command is available. commandArray is an array of callback that interupt the program to execute the command. Numbercommands is the number of items within commandArray.

void begin(),
void begin(int bitrate)

This Function must be called if the serial interface is wanting to be used. Bitrate is the bitrate of the serial port. If this is called, there is no need to Serial.begin();, it is apart of the begin function.

SEND

void comment(String comment)

This Function is to send comments back through the serial. Comment would be the comment that would be sent back.

RECEIVE

bool available(),
bool available(char inChar)

This function reads the incoming data and returns true then the command is ready to for the program to read an control the machine. InChar is the input from a source like an SD card.

double GetValue(char commandLetter)

This function is to return the values for a command letter. CommandLetter is the command letter that is requested to be returned.

Example

Example 1: simplePloter

#include <gcode.h>

void homing();
commandscallback commands[1] = {{"g28",homing}};
gcode Commands(1,commands);

void setup()
{
  Commands.begin();
}

void loop() 
{
  if(Commands.available())
  {
    gotoLocation(Commands.GetValue('X'),Commands.GetValue('Y'));
  }
}

void homing()
{
  // code to home machine
}

void gotoLocation(double x,double y)
{
  // code to run machine to location
}

Example 2: CoreXY/HBot

#include <gcode.h>

void homing();
commandscallback commands[1] = {{"g28",homing}};
gcode Commands(1,commands);

void setup()
{
  Commands.begin();
}

void loop() 
{
  if(Commands.available())
  {
    gotoLocation(Commands.GetValue('X'),Commands.GetValue('Y'));
  }
}

void homing()
{
  // code to home machine
}

void gotoLocation(double X,double Y)
{
  double YCurrent = 0.5*(stepperA.currentPosition() + stepperB.currentPosition());
  double XCurrent = 0.5*(stepperA.currentPosition() - stepperB.currentPosition());
  double R = sqrt((Y-YCurrent)*(Y-YCurrent)+(X-XCurrent)*(X-XCurrent));
  double t = R/Speed;

  double Speeda = abs(a - stepperA.currentPosition())/t;
  double Speedb = abs(b - stepperB.currentPosition())/t;
  double ANewPosition = X+Y;
  double BNewPosition = X-Y;


  // code to run machine to location using:
  //  - ANewPosition and BNewPosition
  //  - ASpeed and BSpeed
}

Example 3: RobotWithSD

#include <gcode.h>
#include <SPI.h>
#include <SD.h>

void homing();
commandscallback commands[1] = {{"g28",homing}};
gcode Commands(1,commands);

void setup()
{
  Commands.begin();

  if (!SD.begin(chipSelect)) 
  {
    Commands.comment("Card failed");
    while (1);
  }

  File dataFile = SD.open("test.gcode");


  if (dataFile) 
  {
    while (dataFile.available()) 
    {
      if(Commands.available(dataFile.read()))
      {
        gotoLocation(Commands.GetValue('X'),Commands.GetValue('Y'));
      }
    }
    dataFile.close();
  }
  else
  {
    Commands.comment("error opening file");
  }
}

void loop() 
{
}

void homing()
{
  // code to home machine
}

void gotoLocation(double x,double y)
{
  // code to run machine to location
}
You can’t perform that action at this time.