Software

From
Revision as of 02:37, 5 August 2021 by Tim (talk | contribs)

Replimat is developed using the git version control system, on the github hosting service, in the replimat git repository as well as in the repositories of the upstream software projects themselves.

Follow these instructions to install and use the software portions of the Replimat project and the tools to modify them. Much of this software is intended to work with the replimat controller.

Setting up prerequisites

Linux

Fedora

Open a terminal and type the following:

sudo dnf install git openscad rust cargo rabbitvcs-nautilus rabbitvcs-gedit rabbitvcs-cli kicad arduino keepassxc yosys gimp inkscape vim

Some distributions, such as 64 bit Fedora, put 64 bit libraries in the /usr/lib64 directory, whereas nautilus-python (the program that lets us extend nautilus) assumes all libraries are in the /usr/lib directory. This is a nautilus-python bug. The current workaround is to create a symlink:

ln -s /usr/lib64/libpython2.6.so /usr/lib/libpython2.6.so

NopSCADlib requires some setup:

sudo sh -c 'echo "export OPENSCADPATH=$HOME/Documents/GitHub/replimat/lib/openscad" >>/etc/profile'

Meikian Live

Meikian Live (formely named CWLive) is a GNU/Linux live distribution initially focused on Clone Wars community, but intended to all the RepRap users and developers. Based on Debian GNU/Linux, it includes most of the Software, Firmware, useful links and other related stuff you can use on a day to day as a reprapper.

Pop! OS

sudo apt install meld git openscad rustc cargo rabbitvcs-nautilus rabbitvcs-gedit rabbitvcs-cli kicad arduino gnome-tweak-tool obs-studio obs-plugins fritzing subversion keepassxc yosys openscad freecad gimp inkscape cura exfat-fuse python3-markdown codespell peek autokey filelight yagv vim vokoscreen-ng

To get the latest IceStudio, download the appimage from icestudio.io

NopSCADlib requires some setup:

sudo sh -c 'echo "export OPENSCADPATH=$HOME/Documents/GitHub/replimat/lib/openscad" >>/etc/profile'

Add the following to /etc/profile as well

if [ -d "$HOME/Documents/GitHub/replimat/lib/openscad/NopSCADlib/scripts/" ] ; then
  PATH="$PATH:$HOME/Documents/GitHub/replimat/lib/openscad/NopSCADlib/scripts/"
fi

Arduino doesn't run out of the box on recent Ubuntu releases. We need to patch a library to allow it to work:

sudo patchelf --add-needed /usr/lib/x86_64-linux-gnu/libserialport.so.0 /usr/lib/x86_64-linux-gnu/liblistSerialsj.so.1.4.0

Download and unpack U8glib-HAL arduino library into ~/Arduino/libraries/

Download Marlin firmware and unpack into ~/Documents/GitHub/Marlin/

Ubuntu

sudo apt install meld git openscad rustc cargo rabbitvcs-nautilus rabbitvcs-gedit rabbitvcs-cli kicad arduino gnome-tweak-tool obs-studio obs-plugins fritzing subversion keepassxc yosys openscad freecad gimp inkscape cura exfat-fuse python3-markdown codespell ubuntu-gnome-default-settings vanilla-gnome-default-settings vanilla-gnome-desktop ubuntu-gnome-desktop peek filelight yagv vim vokoscreen-ng libserialport0 patchelf

NopSCADlib requires some setup:

sudo sh -c 'echo "export OPENSCADPATH=$HOME/Documents/GitHub/replimat/lib/openscad" >>/etc/profile'

Ubuntu 20.10 requires a symlink in /usr/bin for the ImageMagick command line utility:

sudo ln -s /usr/bin/convert /usr/bin/magick

Arduino doesn't run out of the box on recent Ubuntu releases. We need to patch a library to allow it to work:

sudo patchelf --add-needed /usr/lib/x86_64-linux-gnu/libserialport.so.0 /usr/lib/x86_64-linux-gnu/liblistSerialsj.so.1.4.0

Download and unpack U8glib-HAL arduino library into ~/Arduino/libraries/

Download Marlin firmware and unpack into ~/Documents/GitHub/Marlin/

Redox

Redox OS is an operating system written in the Rust programming language, and a high-value build target for Replimat. Expanding the instructions here, for installing the software necessary for building and modifying Replimat to work on Redox OS would be an excellent way to contribute to the project.

Windows

CAD

Cloning the git repository

  • If you haven't already, install git.
  • Join Github
  • Using the command line client:
  • Using the Github Desktop:

play.replimat.org

LeoCAD / LDraw

The term "LDraw" can be used to refer to the original DOS based LDraw program, the LDraw parts library, the LDraw file format or the LDraw System Of Tools.

  • Bitbeam parts for LDraw
  • LDraw Parts Library: Parts library
  • LDview: Viewer
  • MLCad: Editor
  • LeoCAD: Editor
  • LDCad: Editor
  • LPub3D: Publishing tool
  • LICreator: Publishing tool
  • LSynth: Add-On
  • LDGlite: Viewer
  • POV-Ray: Renderer
  • LGEO Parts Library: POV-Ray parts library
  • MPDCenter: Utility
  • LDFind: Utility
  • LSulpt: Converter
  • Offline Parts Catalog: Catalog

OpenSCAD

Replimat parts are modeled with important features oriented toward the X axis origin, and centered on the grid location closest to the origin or with a mounting hole centered at that location.

A set of CAD functions are available as part of the MCAD library for the free and open source OpenSCAD constructive solid geometry software, mostly within gridbeam.scad. It contains functions for solid and hollow beams of configurable size and orientation, flat surfaces with and without notched corners, and easy hole-aligned translation:

// zFrame(segments) - create a vertical frame 'segments' long
// xFrame(segments) - create a horizontal frame along the X axis
// yFrame(segments) - create a horizontal frame along the Y axis
// topPlate(width, depth, corners) - create a plate width and depth in 'segments', corners == 1 notches corners
// bottomPlate(width, depth, corners) - like topPlate, but aligns plate to underside of frames
// backPlate(width, height, corners) - like topPlate but aligns plate to back side of frames
// frontPlate(width, height, corners) - like topPlate, but aligns plate to front side of frames
// translateFrame([x, y, z]) - translate frames or plates in X, Y, or Z axes in units 'segments'

There's also an M-Bitbeam OpenSCAD library and another Gridbeam and Bitbeam OpenSCAD and OpenJSCAD library.

Additional information can be found in the OpenSCAD User Manual

  • Inkscape to OpenSCAD converter
  • OpenSCAD Runner - A Python library to interface with and run the OpenSCAD interpreter
  • OpenSCAD Documentation Generator - This package generates wiki-ready GitHub flavored markdown documentation pages from in-line source code comments. This is similar to Doxygen or JavaDoc, but designed for use with OpenSCAD code. Example images can be generated automatically from short example scripts
  • Parts and projects in the Replimat github repository are implemented using NopSCADlib

FreeCAD

A FreeCAD Replimat library is currently under development. BOLTS and FreeCAD Library serve as useful starting points.

OpenJSCAD

Inkscape

CGAL

DXF2Papercraft

Rust

truescad

Clone git repository:

mkdir ~/Documents/GitHub/truescad
cd ~/Documents/GitHub/truescad/
git clone https://github.com/hmeyer/truescad

Install some dependencies (Ubuntu):

sudo apt install librust-glib-sys-dev librust-cairo-rs+gobject-sys-dev librust-pango-dev librust-atk-sys-dev librust-gdk-pixbuf-dev librust-gdk-dev

Build truescad:

cargo build

Solvespace

Finite element analysis

Voxel

CADQuery

Misc

VR

OpenSpace3D

Unity

Garry's mod

Bills of material

3D Scanning

CAM

Images

Nesting

Electronics

Firmware

Packaging

Windows


References


Computer vision

To Be Sorted