Replicape: Getting Started
NO LONGER MAINTAINED
This page should not be update as it is no longer being maintained. It has been replaced with Replicape Getting Started Guide.
Like to contribute to improving docs? Now, anyone can!
This page is continuosly under development, but is aimed as a basic "what to do when you get your Replicape". If you have any questions/comments, post them in the G+ community or find someone on #replicape on freenode's IRC to edit things to be more coherent. Throughout this document, you can use Umikaze and Kamikaze interchangeably. The only real difference is the underlying OS (Debian for Kamikaze, Ubuntu for Umikaze).
Moving forward, it's preferable to use the Umikaze image.
The Replicape/Redeem community is mostly active in three places:
- Replicape Board
- BeagleBone Black or a BeagleBone Black Wireless
- 12V to 24V power supply, capable of at least 10A output (more if have a heated print bed)
- 3D Printer
- Monitor with microHDMI to HDMI cable (for troubleshooting)
- Keyboard (for troubleshooting)
- Minimum of a 4GB microSD card
Installing Umikaze or Kamikaze
The first step to running the Replicape board with Redeem is to install an OS on the BBB. It is recommended that you download and install the latest pre-build Umikaze (preferred) or Kamikaze image on the SD card then it will update the BBB image.
Now you're looking at how to setup Redeem and calibrate it to your printer's hardware. This section isn't exhaustive yet, if you need this page to add a specific section about something, go ask for it by reaching out in the community section
If you have your BeagleBone plugged into the network, you can connect a monitor and keyboard to get the IP address assigned to the board when it boots. When the stack boots, you will see the Toggle interface (you will need to rotate your monitor to portrait mode to make it easier to work with. Assuming you're running Umikaze 2.0.8 or higher, you can hit Alt-F2 on the keyboard to change to another terminal, then log in with the username ubuntu and the password temppwd. Once logged in, enter ipconfig eth0 and you will see the IP address in the information. Use that IP to connect via web browser to get to OctoPrint.
Once you get connected via SSH, it is STRONGLY recommended that you change the password for the ubuntu user. You use the passwd (yes, that's how it is spelled) command. This is different from the user that you will set up in OctoPrint.
For physical wiring of the board go here. Once the board is wired and powered, you can connect to OctoPrint via a web browser.
Once you connect to the OctoPrint interface, you will need to step through setup the first time. As you step through the setup:
- Set a username and password for OctoPrint
- It's recommended that you keep Access Control Enabled for security reasons.
- Set your print bed dimensions
- Axis speeds can be left at the defaults, as they only control the manual movements that you make through OctoPrint.
Linux Beginner? Help is here
To those of you new to the Linux environment, here are a few steps I would recommend some to read up on a few basic linux skills
Also, if you find that redeem fails to start, and there's nothing obvious in the log you get out of octoprint, that might mean there's a typo in one of your config files. To see where, run systemctl status -n 100 redeem on your BBB, it should point you straight to what you need to change.
Redeem's and Kamikaze's pages are pretty complete already, you're here reading sort of a "where do I find information about specific topics?"
The answer is:
- Replicape's page for anything to do with hardware connections (wiring, outputs, etc.)
- Redeem's page for anything to do with what features the software holds, and what G and M-codes do
- Kamikaze's page for anything regarding the Kamikaze image, including the latest release link for Kamikaze (network, updates, etc).
- The Marlin to Redeem guide, helping those of you coming from Marlin appreciate what the differences in Redeem are and why.
Setting up Redeem with endstops
In case you missed it, check Elias' youtube video on endstops.
MOSFETS turn on and stay on until redeem actually starts
This can be addressed with a patched Uboot, in which case you will see the mosfets on for a few seconds until the boot reinitializes the pin outputs to low until Redeem can take over.