OSE Marlin and Github

From Open Source Ecology
Jump to: navigation, search

This article will describe how to obtain the latest version of OSE Marlin from Github, load them into the Arduino IDE, and upload the sketch to your arduino.


If you don't already have a local copy of the OSE Marlin git repository, you should setup a local sandbox and clone the remote repository into it. To do so, open a terminal and type:

mkdir $HOME/sandbox/ose_marlin
pushd $HOME/sandbox/ose_marlin
git clone https://github.com/OpenSourceEcology/3D-Printer-OSE-Marlin.git

If you do already have a local copy of the git repo on your system, make sure to update it using the `git pull` command

pushd $HOME/sandbox/ose_marlin
git pull

HintLightbulb.png Hint: Always pull recent changes down before you start editing any code

Choose relevant Configuration.h file

Because OSE supports a number of printers in the D3D variety, OSE_Marlin has many distinct configuration.h files. To use the relevant configuration file for your printer, symlink Configuration.h to the relevant configuration file to the 'Configuration.h' file.

For example, to use the configuration file for the 2018-04 model of the 3d printer using the Titan Aero extruder and an LCD screen:

pushd $HOME/sandbox/ose_marlin/OSE_Marlin

# Right now Configuration.h is replaced by a link. We remove this link:

rm Configuration.h

# We create a symlink called Configuration.h and point it to Configuration_TitanAero_lcd.1804.h
# Symlink is a symbolic link

ln -s Configuration_TitanAero_lcd.1804.h Configuration.h

Open Sketch in Arduino IDE

Now you can open the sketch in the Arduino IDE:

  1. Open 'Arduino IDE'
  2. Click 'File' -> 'Open...'
  3. Browse to 'OSE_Marlin.ino' file within the git repo cloned above, located in '/home/<your_username>/sandbox/ose_marlin/OSE_Marlin/OSE_Marlin.ino'


HintLightbulb.png Hint: Note that using the LCD screen requires a special Arduino library. Now the OSE code requires this library even when we don't use the LCD. Note that a non-persistent OSE Linux will not save this library?

HintLightbulb.png Hint: Download library at U8glib Download

For example, using the REPRAP_DISCOUNT_FULL_GRAPHIC_SMART_CONTROLLER LCD screen, you need to download & import the appropriate u8glib library into your Arduino IDE. Use the u8glib_arduino_v1.14.zip file (latest version?)

  1. Open Arduino Environment
  2. Go to Sketch->Include Library->Add .ZIP Library...
  3. Select your downloaded ZIP file
  4. Done.

Update Arduino

To update your 3d printer's arduino, click the 'Verify' checkbox in the Arduino IDE, followed by the 'Upload' button.