diff --git a/guides/3dchameleon/index.html b/guides/3dchameleon/index.html index ceb3fba..a02adda 100644 --- a/guides/3dchameleon/index.html +++ b/guides/3dchameleon/index.html @@ -1008,10 +1008,10 @@

BOM

-SKR Mini E3 V2 +BTT MMB $34.99 1 -Amazon +BTT @@ -1022,10 +1022,10 @@

BOM

These wires are only sufficient to run steppers, not heaters -12V PSU -$7.39 +24V PSU +$12.99 1 -Amazon +Amazon This PSU is only sufficient to run steppers, not heaters diff --git a/print_page/index.html b/print_page/index.html index 0d9ea12..e2d9da8 100644 --- a/print_page/index.html +++ b/print_page/index.html @@ -2474,10 +2474,10 @@

BOM

-SKR Mini E3 V2 +BTT MMB $34.99 1 -Amazon +BTT @@ -2488,10 +2488,10 @@

BOM

These wires are only sufficient to run steppers, not heaters -12V PSU -$7.39 +24V PSU +$12.99 1 -Amazon +Amazon This PSU is only sufficient to run steppers, not heaters diff --git a/search/search_index.json b/search/search_index.json index 06f7a96..070aa23 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Welcome to the 3MS Documentation","text":"

The 3MS is short for MMMS, which stands for Modular Multi Material System

Discord

Join the 3MS channel at the Happy Hare Discord server here.

Join the 3MS Discord:

"},{"location":"#inspiration","title":"Inspiration","text":""},{"location":"#sample-prints","title":"Sample Prints","text":"Sample Prints SheepCalendarVoron CubeT-RexLizard

Model: Sheep by Cipis

Model: Monolith Cryptic Calendar by Sevro

Model: Voron Cube (bundled with OrcaSlicer), painted by me in OrcaSlicer

Printed at 50% scale

Model: T-rex by Cipis

Model: Striped lizard with pupils by EngMike

"},{"location":"#photos","title":"Photos","text":"Photos Full Printer3MSY Splitter"},{"location":"#videos","title":"Videos","text":"West3D Video Series

Thank you to Allen Rowand from West3D for making this ongoing series on the 3MS.

"},{"location":"#why-3ms","title":"Why 3MS?","text":"

Why use the 3MS when there are many other multi-material systems?

Here are a few reasons:

With that said, there are a few reasons why you might not want to/be able to use the 3MS:

"},{"location":"#requirements","title":"Requirements","text":"

To use the 3MS, your setup has to meet the following requirements:

"},{"location":"#how-it-works","title":"How it works","text":"

Think of the 3MS as an extension to your current extruder's length. It allows for switching filaments without compromising any of the benefits of your printer's extruder.

The 3MS's motors work together with your printer's extruder. This way, there won't be any additional resistance from pulling the filament through a disabled extruder. Also, unloads and loads to/from the printer's extruder are fully synchronized with the 3MS. This allows for even faster toolchanges!

"},{"location":"#get-started","title":"Get Started","text":"

To get started with the 3MS, see the Master Instructions.

Get Started

"},{"location":"#what-about-the-3dchameleon","title":"What about the 3DChameleon?","text":"

I recently created a klipper plugin for the 3DChameleon after purchasing a unit. I'm sure my Chameleon could have worked if I had tuned it further, but after several months with only partial success, I gave up. I am still open to pull requests for 3dchameleon-klipper and will do my best to respond to issues there, but I won't be able to test it myself anymore.

If you are having reliability issues with the 3DChameleon, see 3DChameleon Conversion.

"},{"location":"compare/","title":"Comparison of Multimaterial Systems","text":"

Not sure if you want to use the 3MS? Check this comparison between several common multimaterial systems.

"},{"location":"instructions/","title":"Instructions","text":""},{"location":"instructions/#master-instructions","title":"Master Instructions","text":"

Due to the modularity of the 3MS, there are many ways to set it up. This guide attempts to encompass all supported ways of setting up the 3MS.

"},{"location":"instructions/#basic-steps","title":"Basic Steps","text":"

The basic steps this guide will follow are:

  1. Getting a BOM
  2. Assembling your 3MS
  3. Configuring your 3MS
  4. Calibrating your 3MS
"},{"location":"instructions/#0-explanations","title":"0. Explanations","text":"

Before starting the instructions, a basic understanding of how the 3MS works is recommended. There are two types of components in the 3MS:

The number of filaments you will be able to print with is equal to the number of filament units you have. For example, two filament units will let you print with two colors. It is important to note that one filament unit will NOT let you print in multimaterial.

"},{"location":"instructions/#1-getting-a-bom","title":"1. Getting a BOM","text":"

Go to BOM to view the bill of materials for the number of filament units you want. Example BOM for two filament units and a SKR Mini E3 V2:

Name Price Quantity Link Notes SKR Mini E3 V2 $34.99 1 Amazon Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters NEMA17 Stepper Motor $9.99 2 Amazon You can use a pancake stepper if you want, but it will have less torque MK8 Metal Extruder $9.99 2 Amazon Capricorn PTFE Tubing $11.49 1 Amazon You likely won't need this for every unit, as this is usually too long for only one unit"},{"location":"instructions/#2-assembling-your-3ms","title":"2. Assembling your 3MS","text":"

Follow Assembly to assemble your 3MS.

"},{"location":"instructions/#3-configuring-your-3ms","title":"3. Configuring your 3MS","text":"

Set up Happy Hare firmware following this guide.

"},{"location":"instructions/#4-calibrating-your-3ms","title":"4. Calibrating your 3MS","text":"

After installing and configuring Happy Hare, the 3MS requires some calibrations. Follow Calibration to calibrate your 3MS.

"},{"location":"contributing/","title":"Contributing","text":"

If you want to contribute to the 3MS project, follow the instructions below.

"},{"location":"contributing/#development-setup","title":"Development Setup","text":"

Follow Development Setup to setup your system for development with the 3MS.

"},{"location":"contributing/#pull-request","title":"Pull Request","text":"

Finally, submit a pull request. A developer will get back to you soon with feedback, before merging your pull request into the main project.

Thank you for your contribution to the 3MS project!

"},{"location":"contributing/devsetup/","title":"Development Setup","text":"

Follow this guide to setup your system for development with the 3MS.

"},{"location":"contributing/devsetup/#documentation-changes","title":"Documentation Changes","text":"
  1. Fork the 3MS repository
  2. Create a new branch for your pull request (from the docs branch)
  3. Install Python.
  4. Install Pipenv.
  5. In your terminal, navigate to the 3MS folder, and run:
    pipenv install\npipenv shell\n
  6. Develop changes in the new branch, using the following command to run the documentation locally:
    mkdocs serve\n
"},{"location":"guides/3dchameleon/","title":"3DChameleon to 3MS Conversion","text":"

Follow this guide to convert a 3DChameleon to a 3MS.

"},{"location":"guides/3dchameleon/#bom","title":"BOM","text":"Name Price Quantity Link Notes SKR Mini E3 V2 $34.99 1 Amazon Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters MK8 Metal Extruder $9.99 2 Amazon Alternatively, you can use this Dual-drive MK8 based extruder

The final cost of this upgrade is around $70.

"},{"location":"guides/3dchameleon/#instructions","title":"Instructions","text":"
  1. Release the eight bolts on the 3DChameleon unit to remove the two NEMA17 stepper motors.
  2. Unplug the NEMA17's from the 3DChameleon electronics board
  3. Remove the PTFE tubes from the 3DChameleon unit and the Y-splitter

Next, follow the Master Instructions except for the BOM section.

"},{"location":"hidden/hidden-assembly/","title":"Hidden assembly","text":""},{"location":"hidden/hidden-assembly/#3ms-kit-assembly","title":"3MS Kit Assembly","text":"

This page is under construction

This page is the assembly instructions for future 3MS kits. Instructions on this page will change, so don't follow it until 3MS Kits are officially released. Anything on this page is subject to change.

Tip

Even though each step only looks like it has one image, if you click on the image you can view several more images for each step.

"},{"location":"hidden/hidden-assembly/#electronics-assembly","title":"Electronics Assembly","text":""},{"location":"hidden/hidden-assembly/#step-1-preparing-the-power-cables","title":"Step 1 Preparing the Power Cables","text":""},{"location":"hidden/hidden-assembly/#step-2-connecting-the-power-supply","title":"Step 2 Connecting the Power Supply","text":""},{"location":"hidden/hidden-assembly/#step-3-connecting-the-control-board","title":"Step 3 Connecting the Control Board","text":""},{"location":"hidden/hidden-assembly/#step-4-adding-jumpers","title":"Step 4 Adding Jumpers","text":""},{"location":"hidden/hidden-assembly/#step-5-install-the-stepper-drivers","title":"Step 5 Install the Stepper Drivers","text":""},{"location":"hidden/hidden-assembly/#printed-parts","title":"Printed Parts","text":""},{"location":"hidden/hidden-assembly/#step-1-extruder-mounts","title":"Step 1 Extruder Mounts","text":""},{"location":"hidden/hidden-assembly/#step-2-y-splitter","title":"Step 2 Y-Splitter","text":""},{"location":"hidden/hidden-assembly/#hardware-assembly","title":"Hardware Assembly","text":""},{"location":"hidden/hidden-assembly/#step-1-assemble-extruders","title":"Step 1 Assemble Extruders","text":""},{"location":"setup/assembly/","title":"Assembly","text":"

Follow this guide to assemble your 3MS.

"},{"location":"setup/assembly/#printed-parts","title":"Printed Parts","text":""},{"location":"setup/assembly/#mounting","title":"Mounting","text":""},{"location":"setup/assembly/#y-splitters","title":"Y-Splitters","text":""},{"location":"setup/assembly/#filament-units-assembly","title":"Filament Units Assembly","text":"
  1. If using any mounting parts, place it on the face of your NEMA17 motor.
  2. Assemble the MK8 extruders using the instructions that came with them.
  3. Repeat for all filament units.
"},{"location":"setup/assembly/#wiring","title":"Wiring","text":"

Note for Certain Printers

If your printer has Klipper running internally (not on an external computer like a Raspberry Pi), the controller (if not a main MCU config) is plugged into a USB port on the printer itself.

Follow one of the following guides based on your controller:

Recommended: BTT MMB

Other Controllers:

"},{"location":"setup/bom/","title":"BOM","text":""},{"location":"setup/bom/#controller-choice","title":"Controller Choice","text":"

First, choose the control board you want to use in your 3MS. Choose a controller from the available ones here.

"},{"location":"setup/bom/#number-of-filament-units","title":"Number of filament units","text":"

First, choose the number of filament units you want. Each filament unit lets you print with an additional filament. Two filament units are the minimum. You can add or remove filament units after building, but the BOM and configuration will vary based on how many filament units you want.

"},{"location":"setup/bom/#controller-boms","title":"Controller BOMs","text":"

Choose the BOM for your chosen controller from the list below:

Recommended: BTT MMB

Other Controllers:

"},{"location":"setup/bom/#filament-unit-boms","title":"Filament Unit BOMs","text":"

For each filament unit, purchase this BOM:

Name Quantity Price Link Notes NEMA17 Stepper Motor 1 $9.99 Amazon You can use a pancake stepper if you want, but it will have less torque MK8 Metal Extruder 1 $9.99 Amazon Alternatively, you can use this Dual-drive MK8 based extruder PTFE Tubing 1 $8.99 Amazon You likely won't need this for every unit, as this is usually too long for only one unit"},{"location":"setup/calibration/","title":"Calibration","text":"

Follow this guide to calibrate your 3MS.

Original Documentation

This guide is a simplified version of the official Happy Hare documentation. I highly recommend you read it as it contains useful information and goes more in detail if you are having trouble with the calibrations.

"},{"location":"setup/calibration/#verify-filament-sensors","title":"Verify Filament Sensors","text":"

Before calibrating, it is important to ensure that your filament sensors are working properly.

Run in your Klipper console:

QUERY_ENDSTOPS\n

and verify the output. For each endstop, open means no filament detected, and TRIGGERED means filament present. Re-run the command several times, inserting/removing filament to each of the sensors, to verify that each filament sensor properly detects filament.

"},{"location":"setup/calibration/#gear-steppers","title":"Gear Steppers","text":"

First, calibrate your gear steppers (filament units). The goal of this calibration is to ensure the filament actually moves as far as expected.

First, detach the PTFE tubing from each of the filament units.

For each filament unit (gate), repeat the following steps:

  1. Manually load filament until it sticks out slightly from the end of the filament unit
  2. Cut the tip of the filament to be flush with the PTFE coupler (side cutters are good for this).
  3. Run the following commands in your Klipper console:

    MMU_SELECT GATE=n\nMMU_TEST_MOVE MOVE=100\n

    where n is the gate number you are calibrating (starting at zero).

  4. The filament should move forwards. If it moves backwards, invert your gear stepper. Measure the distance the filament moved out of the extruder. Using side cutters the same as before can be helpful for this. Run the following command in your Klipper console:

    MMU_CALIBRATE_GEAR MEASURED=n\n

    where n is the measured distance.

  5. Repeat step c. The filament should move exactly 100mm.

"},{"location":"setup/calibration/#encoder-if-installed","title":"Encoder (if installed)","text":"

If you are using an encoder, like a BTT SFS (Smart Filament Sensor), you need to calibrate your encoder.

  1. Load your filament manually to its parking position at the start of the Y-splitter.
  2. Run in your Klipper console:

    MMU_CALIBRATE_ENCODER\n
"},{"location":"setup/calibration/#inverting-a-gear-stepper","title":"Inverting a Gear Stepper","text":"

If you notice any of your gear steppers moving filament in the opposite direction as expected, you need to invert the gear stepper. There are two options to do this:

To invert a gear stepper in software, open mmu_hardware.cfg and invert the dir_pin for the respective stepper.

Example, if T1 is moving backwards:

BeforeAfter mmu_hardware.cfg
[stepper_mmu_gear_1]\n...\ndir_pin: mmu: PC5\n
mmu_hardware.cfg
[stepper_mmu_gear_1]\n...\ndir_pin: !mmu: PC5 # <-- Note the ! in front of mmu\n

Tip

If the pin already has a ! in front of it, remove it to invert it.

Restart Klipper.

"},{"location":"setup/controllers/","title":"Controllers","text":"

Follow this guide to determine which controller to use in your 3MS.

"},{"location":"setup/controllers/#options","title":"Options","text":"

The 3MS works on multiple different controllers.

Info

If your printer's mainboard has spare stepper ports, you can use them to control 3MS steppers. You can open an issue on Github (there's a template) to get a configuration made for your specific setup. Any controllers listed with \"(main MCU)\" use those spare stepper plugs.

Choose one of the following supported controllers (a checked box indicates it is fully tested, and an empty box indicates testers wanted):

"},{"location":"setup/controllers/bttmmb/","title":"BTT MMB","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/bttmmb/#bom","title":"BOM","text":"Name Price Quantity Link Notes BTT MMB $34.99 1 BTT Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/bttmmb/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 M1 1 M2 2 M3 3 M4

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the MMB board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Following this image, locate the HVIN and GND inputs (top left)

  4. Route the two wires inside closest to the HVIN and GND inputs

  5. Using the markings on the board, plug the red wire into the HVIN terminal on the MMB
  6. Using the markings on the board, plug the black wire into the GND terminal on the MMB
  7. Plug in the VUSB jumper

  8. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your MMB, Stepper motors, and/or PSU can be badly damaged.

  9. Plug the PSU screw terminals into the PSU wire

Plug the MMB into your Klipper host with the cable that came with it.

If the MMB lights up, you wired it correctly!

"},{"location":"setup/controllers/bttoctopusmain/","title":"BTT Octopus (main MCU)","text":"

Warning

This configuration may not work with the BTT Octopus Pro.

Max filament units: 4

MCU Name: main

"},{"location":"setup/controllers/bttoctopusmain/#main-mcu","title":"main MCU","text":"

This configuration is a main MCU configuration, meaning that your printer should already be running off a BTT Octopus and you don't need to purchase one.

"},{"location":"setup/controllers/bttoctopusmain/#bom","title":"BOM","text":"

Per filament unit:

1x TMC2209 ($7 each)

"},{"location":"setup/controllers/bttoctopusmain/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 MOTOR7 1 MOTOR6 2 MOTOR5 3 MOTOR4"},{"location":"setup/controllers/einsyrambo-skrminie3v2/","title":"Einsy RAMBo (main MCU) with SKR Mini E3 V2","text":"

Danger

This guide is an expert guide only

Info

This modification is designed for the Prusa MK3/S/S+, and depends on this Klipper configuration.

"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#why","title":"Why?","text":"

When printing fast, the TMC2130's on the Einsy RAMBo can get quite loud. The TMC2209's on the SKR Mini are much quieter and support denser microstepping.

"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#bom","title":"BOM","text":"Name Price Quantity Link Notes PSU -> Einsy Cable $7.99 1 PartsBuilt3D Stepperonline NEMA17 $9.99 each Amazon 2 Replaces current XY motors"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#wiring","title":"Wiring","text":"

First, unplug the 3MS steppers from the SKR Mini, and the XY steppers from the Einsy RAMBo. The motors will need to be switched due to different connector types between boards.

This table outlines the major wiring of this modification.

Einsy RAMBo SKR Mini E3 V2 Motor PSU+ POWER+ PSU- POWER- XM 3ms0 YM 3ms1 XM X YM Y"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#configuration","title":"Configuration","text":"

In your printer.cfg, comment out these lines:

printer.cfg
#[include klipper-prusa-mk3s/mk3s/steppers.cfg]\n#[include klipper-prusa-mk3s/mk3s/tmc2130.cfg]\n

Next, copy the contents of 3ms/controllers/einsy_rambo_with_skr_mini/xy-motors.cfg and ze-motors.cfg to klipper-prusa-mk3s/skr/xy.cfg, and klipper-prusa-mk3s/mk3s/ze.cfg, respectively.

Add the following new lines:

printer.cfg
[include klipper-prusa-mk3s/skr/xy.cfg]\n[include klipper-prusa-mk3s/mk3s/ze.cfg]\n

Restart Klipper.

"},{"location":"setup/controllers/geetech-a30t/","title":"Geetech A30T","text":"

Contributed by @ImChrono

Max filament units: 7

MCU Name: 3ms

"},{"location":"setup/controllers/geetech-a30t/#bom","title":"BOM","text":"Name Price Quantity Link Notes Geetech A30T $34.99 1 Geetech Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 24V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/geetech-a30t/#firmware","title":"Firmware","text":"

To flash Klipper firmware to the A30T, run the following command and see the following screenshot:

cd ~/klipper\nmake menuconfig\n

Next, connect the BOOT0 jumper on the A30T and run:

stm32flash -i ',,,,,' -v -w out/klipper.bin -g 0 /dev/serial/by-id/<your-mcu-id-here>\n
"},{"location":"setup/controllers/geetech-a30t/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 X 1 Y 2 Z0 3 Z1 4 E1 5 E2 6 E3

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug two red wires into the positive terminal of the screw terminals
  2. Plug two black wires into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the motherboard, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Route the four wires inside closest to your chosen input

  4. Using the markings on the board, plug the two red wires into the positive terminal on the motherboard
  5. Using the markings on the board, plug the two black wires into the negative terminal on the motherboard
  6. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your motherboard, Stepper motors, and/or PSU can be badly damaged.

  7. Plug the PSU screw terminals into the PSU wire

If the motherboard lights up, you wired it correctly!

Finally, plug the motherboard into your Klipper host with the cable that came with it.

"},{"location":"setup/controllers/geetech-a30t/#uart-conversion","title":"UART Conversion","text":""},{"location":"setup/controllers/geetech-a30t/#attention-proceed-with-caution","title":"\u26a0\ufe0f Attention: Proceed with Caution! \u26a0\ufe0f","text":"

This modification involves delicate hardware changes that require precision and attention to detail. Mistakes in wiring or soldering can permanently damage your GTM32_103_V1 board.

You proceed at your own risk.

"},{"location":"setup/controllers/geetech-a30t/#overview","title":"Overview","text":"

This guide details the process of modifying the GTM32_103_V1 3D printer controller board to enable UART capabilities. The GTM32_103_V1 board features 7 TMC2208 drivers operating in standalone mode by default. This modification involves removing the SD card slot and repurposing its pinouts for UART communication.

"},{"location":"setup/controllers/geetech-a30t/#features-of-the-modification","title":"Features of the Modification","text":""},{"location":"setup/controllers/geetech-a30t/#hardware-changes","title":"Hardware Changes","text":""},{"location":"setup/controllers/geetech-a30t/#components-modified","title":"Components Modified","text":" TCM2208 Driver SD Card Pin STM32 Pin Motor0 9 PC7 Motor1 8 PC9 Motor2 7 PC8 Motor3 5 PC12 Motor4 3 PD2 Motor5 2 PC11 Motor6 1 PC10"},{"location":"setup/controllers/geetech-a30t/#procedure","title":"Procedure","text":"
  1. Remove Pull down resistor from each driver:
  2. Desolder the SMD 1k\u2126 resistor carefully to avoid damaging the surrounding components.
TMCDriver PCB Code Motor0 R53 Motor1 R57 Motor2 R62 Motor3 R120 Motor4 R71 Motor5 R95 Motor6 R105
  1. Remove the SD Card Slot:
  2. Desolder the SD card slot carefully to avoid damaging the surrounding components.
  3. Repurpose the Pinouts:
  4. Rewire the SD card pins according to the table above.
  5. Connect each pin to its corresponding UART connection for the TMC2208 drivers.
"},{"location":"setup/controllers/geetech-a30t/#testing-and-validation","title":"Testing and Validation","text":"

After completing the hardware changes: 1. Connect the board to your 3D printer and power it on. 2. Use your firmware to verify UART communication with each TMC2208 driver. 3. Check for successful responses from the drivers using a terminal or debugging tool.

"},{"location":"setup/controllers/geetech-a30t/#photos","title":"Photos","text":"

Add your photos here to demonstrate the modification process and results: - Close-up of the TMC driver

-Close-up of the TMC driver with resistor removed (solder the uart pint to the red signed pin)

"},{"location":"setup/controllers/geetech-a30t/#uart-configuration","title":"UART Configuration","text":"

When configuring this board with Happy Hare firmware, be sure to use UART-mmu.cfg and UART-mmu_hardware.cfg (renaming to mmu.cfg and mmu_hardware.cfg respectively).

"},{"location":"setup/controllers/mellowflyd7/","title":"Mellow Fly D7","text":"

Max filament units: 7

MCU Name: 3ms

"},{"location":"setup/controllers/mellowflyd7/#bom","title":"BOM","text":"Name Price Quantity Link Notes Mellow Fly D7 1 Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/mellowflyd7/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 X 1 Y 2 Z 3 Z1 4 Z2 5 E0

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the board board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Using the markings on the board, plug the red wire into the positive terminal on the board

  4. Using the markings on the board, plug the black wire into the negative terminal on the board
  5. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your board, Stepper motors, and/or PSU can be badly damaged.

  6. Plug the PSU screw terminals into the PSU wire

If the board lights up, you wired it correctly!

Finally, plug the board into your Klipper host with the cable that came with it.

"},{"location":"setup/controllers/minirambo/","title":"Mini RAMBo","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/minirambo/#bom","title":"BOM","text":"Name Price Quantity Link Notes Mini RAMBo 1 Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/minirambo/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 XM 1 YM 2 ZAM or ZBM 3 E0M

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the RAMBo board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Route the two wires inside closest to your chosen input

  4. Using the markings on the board, plug the red wire into the positive terminal on the RAMBo
  5. Using the markings on the board, plug the black wire into the negative terminal on the RAMBo
  6. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your RAMBo, Stepper motors, and/or PSU can be badly damaged.

  7. Plug the PSU screw terminals into the PSU wire

If the RAMBo lights up, you wired it correctly!

Finally, plug the RAMBo into your Klipper host with the cable that came with it.

"},{"location":"setup/controllers/skrminie3v2/","title":"BTT SKR Mini E3 V2","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/skrminie3v2/#bom","title":"BOM","text":"Name Price Quantity Link Notes SKR Mini E3 V2 $34.99 1 Amazon Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/skrminie3v2/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 XM 1 YM 2 ZAM or ZBM 3 E0M

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the SKR board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Following this image, choose either the DCIN or POWER input

  4. Route the two wires inside closest to your chosen input
  5. Using the markings on the board, plug the red wire into the positive terminal on the SKR
  6. Using the markings on the board, plug the black wire into the negative terminal on the SKR
  7. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your SKR, Stepper motors, and/or PSU can be badly damaged.

  8. Plug the PSU screw terminals into the PSU wire

If the SKR lights up, you wired it correctly!

Finally, plug the SKR into your Klipper host with the blue cable that came with it.

"},{"location":"setup/controllers/skrpico/","title":"BTT SKR Pico","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/skrpico/#bom","title":"BOM","text":"Name Price Quantity Link Notes SKR Pico $35.99 1 Amazon Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/skrpico/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 X 1 Y 2 Z1 or Z2 3 E

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the SKR board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Following this image, locate the POWER input

  4. Route the two wires inside closest to the POWER input
  5. Using the markings on the board, plug the red wire into the positive terminal on the SKR
  6. Using the markings on the board, plug the black wire into the negative terminal on the SKR
  7. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your SKR, Stepper motors, and/or PSU can be badly damaged.

  8. Plug the PSU screw terminals into the PSU wire

If the SKR lights up, you wired it correctly!

Finally, plug the SKR into your Klipper host with the blue cable that came with it.

"},{"location":"setup/controllers/zm384main/","title":"Zonestar ZM384 (main MCU)","text":"

Max filament units: 3

MCU Name: main

"},{"location":"setup/controllers/zm384main/#main-mcu","title":"main MCU","text":"

This configuration is a main MCU configuration, meaning that your printer should already be running off a ZM384 and you don't need to purchase one.

Filament Unit # Motor Port 0 E0 1 E1 2 E2 3 E3"}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Welcome to the 3MS Documentation","text":"

The 3MS is short for MMMS, which stands for Modular Multi Material System

Discord

Join the 3MS channel at the Happy Hare Discord server here.

Join the 3MS Discord:

"},{"location":"#inspiration","title":"Inspiration","text":""},{"location":"#sample-prints","title":"Sample Prints","text":"Sample Prints SheepCalendarVoron CubeT-RexLizard

Model: Sheep by Cipis

Model: Monolith Cryptic Calendar by Sevro

Model: Voron Cube (bundled with OrcaSlicer), painted by me in OrcaSlicer

Printed at 50% scale

Model: T-rex by Cipis

Model: Striped lizard with pupils by EngMike

"},{"location":"#photos","title":"Photos","text":"Photos Full Printer3MSY Splitter"},{"location":"#videos","title":"Videos","text":"West3D Video Series

Thank you to Allen Rowand from West3D for making this ongoing series on the 3MS.

"},{"location":"#why-3ms","title":"Why 3MS?","text":"

Why use the 3MS when there are many other multi-material systems?

Here are a few reasons:

With that said, there are a few reasons why you might not want to/be able to use the 3MS:

"},{"location":"#requirements","title":"Requirements","text":"

To use the 3MS, your setup has to meet the following requirements:

"},{"location":"#how-it-works","title":"How it works","text":"

Think of the 3MS as an extension to your current extruder's length. It allows for switching filaments without compromising any of the benefits of your printer's extruder.

The 3MS's motors work together with your printer's extruder. This way, there won't be any additional resistance from pulling the filament through a disabled extruder. Also, unloads and loads to/from the printer's extruder are fully synchronized with the 3MS. This allows for even faster toolchanges!

"},{"location":"#get-started","title":"Get Started","text":"

To get started with the 3MS, see the Master Instructions.

Get Started

"},{"location":"#what-about-the-3dchameleon","title":"What about the 3DChameleon?","text":"

I recently created a klipper plugin for the 3DChameleon after purchasing a unit. I'm sure my Chameleon could have worked if I had tuned it further, but after several months with only partial success, I gave up. I am still open to pull requests for 3dchameleon-klipper and will do my best to respond to issues there, but I won't be able to test it myself anymore.

If you are having reliability issues with the 3DChameleon, see 3DChameleon Conversion.

"},{"location":"compare/","title":"Comparison of Multimaterial Systems","text":"

Not sure if you want to use the 3MS? Check this comparison between several common multimaterial systems.

"},{"location":"instructions/","title":"Instructions","text":""},{"location":"instructions/#master-instructions","title":"Master Instructions","text":"

Due to the modularity of the 3MS, there are many ways to set it up. This guide attempts to encompass all supported ways of setting up the 3MS.

"},{"location":"instructions/#basic-steps","title":"Basic Steps","text":"

The basic steps this guide will follow are:

  1. Getting a BOM
  2. Assembling your 3MS
  3. Configuring your 3MS
  4. Calibrating your 3MS
"},{"location":"instructions/#0-explanations","title":"0. Explanations","text":"

Before starting the instructions, a basic understanding of how the 3MS works is recommended. There are two types of components in the 3MS:

The number of filaments you will be able to print with is equal to the number of filament units you have. For example, two filament units will let you print with two colors. It is important to note that one filament unit will NOT let you print in multimaterial.

"},{"location":"instructions/#1-getting-a-bom","title":"1. Getting a BOM","text":"

Go to BOM to view the bill of materials for the number of filament units you want. Example BOM for two filament units and a SKR Mini E3 V2:

Name Price Quantity Link Notes SKR Mini E3 V2 $34.99 1 Amazon Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters NEMA17 Stepper Motor $9.99 2 Amazon You can use a pancake stepper if you want, but it will have less torque MK8 Metal Extruder $9.99 2 Amazon Capricorn PTFE Tubing $11.49 1 Amazon You likely won't need this for every unit, as this is usually too long for only one unit"},{"location":"instructions/#2-assembling-your-3ms","title":"2. Assembling your 3MS","text":"

Follow Assembly to assemble your 3MS.

"},{"location":"instructions/#3-configuring-your-3ms","title":"3. Configuring your 3MS","text":"

Set up Happy Hare firmware following this guide.

"},{"location":"instructions/#4-calibrating-your-3ms","title":"4. Calibrating your 3MS","text":"

After installing and configuring Happy Hare, the 3MS requires some calibrations. Follow Calibration to calibrate your 3MS.

"},{"location":"contributing/","title":"Contributing","text":"

If you want to contribute to the 3MS project, follow the instructions below.

"},{"location":"contributing/#development-setup","title":"Development Setup","text":"

Follow Development Setup to setup your system for development with the 3MS.

"},{"location":"contributing/#pull-request","title":"Pull Request","text":"

Finally, submit a pull request. A developer will get back to you soon with feedback, before merging your pull request into the main project.

Thank you for your contribution to the 3MS project!

"},{"location":"contributing/devsetup/","title":"Development Setup","text":"

Follow this guide to setup your system for development with the 3MS.

"},{"location":"contributing/devsetup/#documentation-changes","title":"Documentation Changes","text":"
  1. Fork the 3MS repository
  2. Create a new branch for your pull request (from the docs branch)
  3. Install Python.
  4. Install Pipenv.
  5. In your terminal, navigate to the 3MS folder, and run:
    pipenv install\npipenv shell\n
  6. Develop changes in the new branch, using the following command to run the documentation locally:
    mkdocs serve\n
"},{"location":"guides/3dchameleon/","title":"3DChameleon to 3MS Conversion","text":"

Follow this guide to convert a 3DChameleon to a 3MS.

"},{"location":"guides/3dchameleon/#bom","title":"BOM","text":"Name Price Quantity Link Notes BTT MMB $34.99 1 BTT Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 24V PSU $12.99 1 Amazon This PSU is only sufficient to run steppers, not heaters MK8 Metal Extruder $9.99 2 Amazon Alternatively, you can use this Dual-drive MK8 based extruder

The final cost of this upgrade is around $70.

"},{"location":"guides/3dchameleon/#instructions","title":"Instructions","text":"
  1. Release the eight bolts on the 3DChameleon unit to remove the two NEMA17 stepper motors.
  2. Unplug the NEMA17's from the 3DChameleon electronics board
  3. Remove the PTFE tubes from the 3DChameleon unit and the Y-splitter

Next, follow the Master Instructions except for the BOM section.

"},{"location":"hidden/hidden-assembly/","title":"Hidden assembly","text":""},{"location":"hidden/hidden-assembly/#3ms-kit-assembly","title":"3MS Kit Assembly","text":"

This page is under construction

This page is the assembly instructions for future 3MS kits. Instructions on this page will change, so don't follow it until 3MS Kits are officially released. Anything on this page is subject to change.

Tip

Even though each step only looks like it has one image, if you click on the image you can view several more images for each step.

"},{"location":"hidden/hidden-assembly/#electronics-assembly","title":"Electronics Assembly","text":""},{"location":"hidden/hidden-assembly/#step-1-preparing-the-power-cables","title":"Step 1 Preparing the Power Cables","text":""},{"location":"hidden/hidden-assembly/#step-2-connecting-the-power-supply","title":"Step 2 Connecting the Power Supply","text":""},{"location":"hidden/hidden-assembly/#step-3-connecting-the-control-board","title":"Step 3 Connecting the Control Board","text":""},{"location":"hidden/hidden-assembly/#step-4-adding-jumpers","title":"Step 4 Adding Jumpers","text":""},{"location":"hidden/hidden-assembly/#step-5-install-the-stepper-drivers","title":"Step 5 Install the Stepper Drivers","text":""},{"location":"hidden/hidden-assembly/#printed-parts","title":"Printed Parts","text":""},{"location":"hidden/hidden-assembly/#step-1-extruder-mounts","title":"Step 1 Extruder Mounts","text":""},{"location":"hidden/hidden-assembly/#step-2-y-splitter","title":"Step 2 Y-Splitter","text":""},{"location":"hidden/hidden-assembly/#hardware-assembly","title":"Hardware Assembly","text":""},{"location":"hidden/hidden-assembly/#step-1-assemble-extruders","title":"Step 1 Assemble Extruders","text":""},{"location":"setup/assembly/","title":"Assembly","text":"

Follow this guide to assemble your 3MS.

"},{"location":"setup/assembly/#printed-parts","title":"Printed Parts","text":""},{"location":"setup/assembly/#mounting","title":"Mounting","text":""},{"location":"setup/assembly/#y-splitters","title":"Y-Splitters","text":""},{"location":"setup/assembly/#filament-units-assembly","title":"Filament Units Assembly","text":"
  1. If using any mounting parts, place it on the face of your NEMA17 motor.
  2. Assemble the MK8 extruders using the instructions that came with them.
  3. Repeat for all filament units.
"},{"location":"setup/assembly/#wiring","title":"Wiring","text":"

Note for Certain Printers

If your printer has Klipper running internally (not on an external computer like a Raspberry Pi), the controller (if not a main MCU config) is plugged into a USB port on the printer itself.

Follow one of the following guides based on your controller:

Recommended: BTT MMB

Other Controllers:

"},{"location":"setup/bom/","title":"BOM","text":""},{"location":"setup/bom/#controller-choice","title":"Controller Choice","text":"

First, choose the control board you want to use in your 3MS. Choose a controller from the available ones here.

"},{"location":"setup/bom/#number-of-filament-units","title":"Number of filament units","text":"

First, choose the number of filament units you want. Each filament unit lets you print with an additional filament. Two filament units are the minimum. You can add or remove filament units after building, but the BOM and configuration will vary based on how many filament units you want.

"},{"location":"setup/bom/#controller-boms","title":"Controller BOMs","text":"

Choose the BOM for your chosen controller from the list below:

Recommended: BTT MMB

Other Controllers:

"},{"location":"setup/bom/#filament-unit-boms","title":"Filament Unit BOMs","text":"

For each filament unit, purchase this BOM:

Name Quantity Price Link Notes NEMA17 Stepper Motor 1 $9.99 Amazon You can use a pancake stepper if you want, but it will have less torque MK8 Metal Extruder 1 $9.99 Amazon Alternatively, you can use this Dual-drive MK8 based extruder PTFE Tubing 1 $8.99 Amazon You likely won't need this for every unit, as this is usually too long for only one unit"},{"location":"setup/calibration/","title":"Calibration","text":"

Follow this guide to calibrate your 3MS.

Original Documentation

This guide is a simplified version of the official Happy Hare documentation. I highly recommend you read it as it contains useful information and goes more in detail if you are having trouble with the calibrations.

"},{"location":"setup/calibration/#verify-filament-sensors","title":"Verify Filament Sensors","text":"

Before calibrating, it is important to ensure that your filament sensors are working properly.

Run in your Klipper console:

QUERY_ENDSTOPS\n

and verify the output. For each endstop, open means no filament detected, and TRIGGERED means filament present. Re-run the command several times, inserting/removing filament to each of the sensors, to verify that each filament sensor properly detects filament.

"},{"location":"setup/calibration/#gear-steppers","title":"Gear Steppers","text":"

First, calibrate your gear steppers (filament units). The goal of this calibration is to ensure the filament actually moves as far as expected.

First, detach the PTFE tubing from each of the filament units.

For each filament unit (gate), repeat the following steps:

  1. Manually load filament until it sticks out slightly from the end of the filament unit
  2. Cut the tip of the filament to be flush with the PTFE coupler (side cutters are good for this).
  3. Run the following commands in your Klipper console:

    MMU_SELECT GATE=n\nMMU_TEST_MOVE MOVE=100\n

    where n is the gate number you are calibrating (starting at zero).

  4. The filament should move forwards. If it moves backwards, invert your gear stepper. Measure the distance the filament moved out of the extruder. Using side cutters the same as before can be helpful for this. Run the following command in your Klipper console:

    MMU_CALIBRATE_GEAR MEASURED=n\n

    where n is the measured distance.

  5. Repeat step c. The filament should move exactly 100mm.

"},{"location":"setup/calibration/#encoder-if-installed","title":"Encoder (if installed)","text":"

If you are using an encoder, like a BTT SFS (Smart Filament Sensor), you need to calibrate your encoder.

  1. Load your filament manually to its parking position at the start of the Y-splitter.
  2. Run in your Klipper console:

    MMU_CALIBRATE_ENCODER\n
"},{"location":"setup/calibration/#inverting-a-gear-stepper","title":"Inverting a Gear Stepper","text":"

If you notice any of your gear steppers moving filament in the opposite direction as expected, you need to invert the gear stepper. There are two options to do this:

To invert a gear stepper in software, open mmu_hardware.cfg and invert the dir_pin for the respective stepper.

Example, if T1 is moving backwards:

BeforeAfter mmu_hardware.cfg
[stepper_mmu_gear_1]\n...\ndir_pin: mmu: PC5\n
mmu_hardware.cfg
[stepper_mmu_gear_1]\n...\ndir_pin: !mmu: PC5 # <-- Note the ! in front of mmu\n

Tip

If the pin already has a ! in front of it, remove it to invert it.

Restart Klipper.

"},{"location":"setup/controllers/","title":"Controllers","text":"

Follow this guide to determine which controller to use in your 3MS.

"},{"location":"setup/controllers/#options","title":"Options","text":"

The 3MS works on multiple different controllers.

Info

If your printer's mainboard has spare stepper ports, you can use them to control 3MS steppers. You can open an issue on Github (there's a template) to get a configuration made for your specific setup. Any controllers listed with \"(main MCU)\" use those spare stepper plugs.

Choose one of the following supported controllers (a checked box indicates it is fully tested, and an empty box indicates testers wanted):

"},{"location":"setup/controllers/bttmmb/","title":"BTT MMB","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/bttmmb/#bom","title":"BOM","text":"Name Price Quantity Link Notes BTT MMB $34.99 1 BTT Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/bttmmb/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 M1 1 M2 2 M3 3 M4

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the MMB board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Following this image, locate the HVIN and GND inputs (top left)

  4. Route the two wires inside closest to the HVIN and GND inputs

  5. Using the markings on the board, plug the red wire into the HVIN terminal on the MMB
  6. Using the markings on the board, plug the black wire into the GND terminal on the MMB
  7. Plug in the VUSB jumper

  8. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your MMB, Stepper motors, and/or PSU can be badly damaged.

  9. Plug the PSU screw terminals into the PSU wire

Plug the MMB into your Klipper host with the cable that came with it.

If the MMB lights up, you wired it correctly!

"},{"location":"setup/controllers/bttoctopusmain/","title":"BTT Octopus (main MCU)","text":"

Warning

This configuration may not work with the BTT Octopus Pro.

Max filament units: 4

MCU Name: main

"},{"location":"setup/controllers/bttoctopusmain/#main-mcu","title":"main MCU","text":"

This configuration is a main MCU configuration, meaning that your printer should already be running off a BTT Octopus and you don't need to purchase one.

"},{"location":"setup/controllers/bttoctopusmain/#bom","title":"BOM","text":"

Per filament unit:

1x TMC2209 ($7 each)

"},{"location":"setup/controllers/bttoctopusmain/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 MOTOR7 1 MOTOR6 2 MOTOR5 3 MOTOR4"},{"location":"setup/controllers/einsyrambo-skrminie3v2/","title":"Einsy RAMBo (main MCU) with SKR Mini E3 V2","text":"

Danger

This guide is an expert guide only

Info

This modification is designed for the Prusa MK3/S/S+, and depends on this Klipper configuration.

"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#why","title":"Why?","text":"

When printing fast, the TMC2130's on the Einsy RAMBo can get quite loud. The TMC2209's on the SKR Mini are much quieter and support denser microstepping.

"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#bom","title":"BOM","text":"Name Price Quantity Link Notes PSU -> Einsy Cable $7.99 1 PartsBuilt3D Stepperonline NEMA17 $9.99 each Amazon 2 Replaces current XY motors"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#wiring","title":"Wiring","text":"

First, unplug the 3MS steppers from the SKR Mini, and the XY steppers from the Einsy RAMBo. The motors will need to be switched due to different connector types between boards.

This table outlines the major wiring of this modification.

Einsy RAMBo SKR Mini E3 V2 Motor PSU+ POWER+ PSU- POWER- XM 3ms0 YM 3ms1 XM X YM Y"},{"location":"setup/controllers/einsyrambo-skrminie3v2/#configuration","title":"Configuration","text":"

In your printer.cfg, comment out these lines:

printer.cfg
#[include klipper-prusa-mk3s/mk3s/steppers.cfg]\n#[include klipper-prusa-mk3s/mk3s/tmc2130.cfg]\n

Next, copy the contents of 3ms/controllers/einsy_rambo_with_skr_mini/xy-motors.cfg and ze-motors.cfg to klipper-prusa-mk3s/skr/xy.cfg, and klipper-prusa-mk3s/mk3s/ze.cfg, respectively.

Add the following new lines:

printer.cfg
[include klipper-prusa-mk3s/skr/xy.cfg]\n[include klipper-prusa-mk3s/mk3s/ze.cfg]\n

Restart Klipper.

"},{"location":"setup/controllers/geetech-a30t/","title":"Geetech A30T","text":"

Contributed by @ImChrono

Max filament units: 7

MCU Name: 3ms

"},{"location":"setup/controllers/geetech-a30t/#bom","title":"BOM","text":"Name Price Quantity Link Notes Geetech A30T $34.99 1 Geetech Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 24V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/geetech-a30t/#firmware","title":"Firmware","text":"

To flash Klipper firmware to the A30T, run the following command and see the following screenshot:

cd ~/klipper\nmake menuconfig\n

Next, connect the BOOT0 jumper on the A30T and run:

stm32flash -i ',,,,,' -v -w out/klipper.bin -g 0 /dev/serial/by-id/<your-mcu-id-here>\n
"},{"location":"setup/controllers/geetech-a30t/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 X 1 Y 2 Z0 3 Z1 4 E1 5 E2 6 E3

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug two red wires into the positive terminal of the screw terminals
  2. Plug two black wires into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the motherboard, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Route the four wires inside closest to your chosen input

  4. Using the markings on the board, plug the two red wires into the positive terminal on the motherboard
  5. Using the markings on the board, plug the two black wires into the negative terminal on the motherboard
  6. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your motherboard, Stepper motors, and/or PSU can be badly damaged.

  7. Plug the PSU screw terminals into the PSU wire

If the motherboard lights up, you wired it correctly!

Finally, plug the motherboard into your Klipper host with the cable that came with it.

"},{"location":"setup/controllers/geetech-a30t/#uart-conversion","title":"UART Conversion","text":""},{"location":"setup/controllers/geetech-a30t/#attention-proceed-with-caution","title":"\u26a0\ufe0f Attention: Proceed with Caution! \u26a0\ufe0f","text":"

This modification involves delicate hardware changes that require precision and attention to detail. Mistakes in wiring or soldering can permanently damage your GTM32_103_V1 board.

You proceed at your own risk.

"},{"location":"setup/controllers/geetech-a30t/#overview","title":"Overview","text":"

This guide details the process of modifying the GTM32_103_V1 3D printer controller board to enable UART capabilities. The GTM32_103_V1 board features 7 TMC2208 drivers operating in standalone mode by default. This modification involves removing the SD card slot and repurposing its pinouts for UART communication.

"},{"location":"setup/controllers/geetech-a30t/#features-of-the-modification","title":"Features of the Modification","text":""},{"location":"setup/controllers/geetech-a30t/#hardware-changes","title":"Hardware Changes","text":""},{"location":"setup/controllers/geetech-a30t/#components-modified","title":"Components Modified","text":" TCM2208 Driver SD Card Pin STM32 Pin Motor0 9 PC7 Motor1 8 PC9 Motor2 7 PC8 Motor3 5 PC12 Motor4 3 PD2 Motor5 2 PC11 Motor6 1 PC10"},{"location":"setup/controllers/geetech-a30t/#procedure","title":"Procedure","text":"
  1. Remove Pull down resistor from each driver:
  2. Desolder the SMD 1k\u2126 resistor carefully to avoid damaging the surrounding components.
TMCDriver PCB Code Motor0 R53 Motor1 R57 Motor2 R62 Motor3 R120 Motor4 R71 Motor5 R95 Motor6 R105
  1. Remove the SD Card Slot:
  2. Desolder the SD card slot carefully to avoid damaging the surrounding components.
  3. Repurpose the Pinouts:
  4. Rewire the SD card pins according to the table above.
  5. Connect each pin to its corresponding UART connection for the TMC2208 drivers.
"},{"location":"setup/controllers/geetech-a30t/#testing-and-validation","title":"Testing and Validation","text":"

After completing the hardware changes: 1. Connect the board to your 3D printer and power it on. 2. Use your firmware to verify UART communication with each TMC2208 driver. 3. Check for successful responses from the drivers using a terminal or debugging tool.

"},{"location":"setup/controllers/geetech-a30t/#photos","title":"Photos","text":"

Add your photos here to demonstrate the modification process and results: - Close-up of the TMC driver

-Close-up of the TMC driver with resistor removed (solder the uart pint to the red signed pin)

"},{"location":"setup/controllers/geetech-a30t/#uart-configuration","title":"UART Configuration","text":"

When configuring this board with Happy Hare firmware, be sure to use UART-mmu.cfg and UART-mmu_hardware.cfg (renaming to mmu.cfg and mmu_hardware.cfg respectively).

"},{"location":"setup/controllers/mellowflyd7/","title":"Mellow Fly D7","text":"

Max filament units: 7

MCU Name: 3ms

"},{"location":"setup/controllers/mellowflyd7/#bom","title":"BOM","text":"Name Price Quantity Link Notes Mellow Fly D7 1 Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/mellowflyd7/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 X 1 Y 2 Z 3 Z1 4 Z2 5 E0

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the board board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Using the markings on the board, plug the red wire into the positive terminal on the board

  4. Using the markings on the board, plug the black wire into the negative terminal on the board
  5. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your board, Stepper motors, and/or PSU can be badly damaged.

  6. Plug the PSU screw terminals into the PSU wire

If the board lights up, you wired it correctly!

Finally, plug the board into your Klipper host with the cable that came with it.

"},{"location":"setup/controllers/minirambo/","title":"Mini RAMBo","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/minirambo/#bom","title":"BOM","text":"Name Price Quantity Link Notes Mini RAMBo 1 Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/minirambo/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 XM 1 YM 2 ZAM or ZBM 3 E0M

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the RAMBo board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Route the two wires inside closest to your chosen input

  4. Using the markings on the board, plug the red wire into the positive terminal on the RAMBo
  5. Using the markings on the board, plug the black wire into the negative terminal on the RAMBo
  6. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your RAMBo, Stepper motors, and/or PSU can be badly damaged.

  7. Plug the PSU screw terminals into the PSU wire

If the RAMBo lights up, you wired it correctly!

Finally, plug the RAMBo into your Klipper host with the cable that came with it.

"},{"location":"setup/controllers/skrminie3v2/","title":"BTT SKR Mini E3 V2","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/skrminie3v2/#bom","title":"BOM","text":"Name Price Quantity Link Notes SKR Mini E3 V2 $34.99 1 Amazon Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/skrminie3v2/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 XM 1 YM 2 ZAM or ZBM 3 E0M

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the SKR board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Following this image, choose either the DCIN or POWER input

  4. Route the two wires inside closest to your chosen input
  5. Using the markings on the board, plug the red wire into the positive terminal on the SKR
  6. Using the markings on the board, plug the black wire into the negative terminal on the SKR
  7. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your SKR, Stepper motors, and/or PSU can be badly damaged.

  8. Plug the PSU screw terminals into the PSU wire

If the SKR lights up, you wired it correctly!

Finally, plug the SKR into your Klipper host with the blue cable that came with it.

"},{"location":"setup/controllers/skrpico/","title":"BTT SKR Pico","text":"

Max filament units: 4

MCU Name: 3ms

"},{"location":"setup/controllers/skrpico/#bom","title":"BOM","text":"Name Price Quantity Link Notes SKR Pico $35.99 1 Amazon Duponts $9.99 1 Amazon These wires are only sufficient to run steppers, not heaters 12V PSU $7.39 1 Amazon This PSU is only sufficient to run steppers, not heaters"},{"location":"setup/controllers/skrpico/#wiring","title":"Wiring","text":"

Route the wires from the NEMA17's to the controller board. Follow this table to determine which port to plug the motors into:

Filament Unit # Motor Port 0 X 1 Y 2 Z1 or Z2 3 E

Now, grab your 12V PSU and two M-M duponts, one red and one black (M-M means that there is metal coming out of both ends of the cable). Plug the PSU into the wall, but don't plug the screw terminals into the PSU (the screw terminals have green)

  1. Plug the red wire into the positive terminal of the screw terminals
  2. Plug the black wire into the negative terminal of the screw terminals

    Danger

    These dupont cables are too thin to run much more than the stepper motors. If you run a heater or other power-intensive device off of the SKR board, the duponts and/or PSU can melt/catch fire. To reduce the risk of this, you can double up on the duponts or get thicker wires.

  3. Following this image, locate the POWER input

  4. Route the two wires inside closest to the POWER input
  5. Using the markings on the board, plug the red wire into the positive terminal on the SKR
  6. Using the markings on the board, plug the black wire into the negative terminal on the SKR
  7. Verify all connections

    Warning

    If the wires are plugged into the wrong place, or swapped polarities, your SKR, Stepper motors, and/or PSU can be badly damaged.

  8. Plug the PSU screw terminals into the PSU wire

If the SKR lights up, you wired it correctly!

Finally, plug the SKR into your Klipper host with the blue cable that came with it.

"},{"location":"setup/controllers/zm384main/","title":"Zonestar ZM384 (main MCU)","text":"

Max filament units: 3

MCU Name: main

"},{"location":"setup/controllers/zm384main/#main-mcu","title":"main MCU","text":"

This configuration is a main MCU configuration, meaning that your printer should already be running off a ZM384 and you don't need to purchase one.

Filament Unit # Motor Port 0 E0 1 E1 2 E2 3 E3"}]} \ No newline at end of file