Login

FAQ & Support

Universal interactive reference for mechanics, calibration, and troubleshooting of 3D printers

The belt transfers torque from the stepper motor to the carriage. Print quality and geometric accuracy directly depend on its tension.

Signs of under-tension (loose belts):
  • Layer shifting: the belt skips over pulley teeth during sudden acceleration or direction changes.
  • Backlash & roundness loss: circular holes become oval, and corners get rounded.
  • Ghosting / ringing: the loose belt vibrates like a guitar string, creating waves on walls.
Signs of over-tension (too tight):
  • Humming or squeaking: stepper motor and idler bearings experience heavy radial loads.
  • Overheating motors: motors run hotter than 65-70°C and might skip steps due to overload.
  • Wear: internal belt fibers and teeth wear down prematurely; motor shafts can bend.
Tuning Method ("Guitar String" test): Move the carriage to one extreme end. Pluck the belt at its longest free span. It should emit a clean, low bass hum (like a thick guitar string), not sag silently. When pressed with moderate finger force, it should deflect no more than 5–8 mm.
On V-Slot profile printers, carriages move on plastic (POM/polycarbonate) rollers. Eccentric spacers are hexagonal metal bushings with an offset center. They adjust the pressure of the wheels against the aluminum extrusion slot.

How to adjust: Turn the eccentric nut with a wrench very slowly (2–5 degrees at a time). A full 360-degree rotation returns the roller to its loosest point.

Correct Adjustment Criteria:
  • Zero Wobble: Wiggle the carriage perpendicular to the movement direction; there should be no play or wobble.
  • Slip Test: Hold a wheel with your fingers and try to spin it. The wheel should slip with noticeable friction on the profile. If it spins freely without moving the carriage, it is too loose. If it is impossible to rotate with your fingers, it is too tight.
  • Smoothness: Roll the carriage along the full length of the extrusion. The movement must be smooth, without clicking or "speed bumps" (which indicate flat spots on over-tightened rollers).
Illustrative Diagram
      [Нормальный прижим]               [Слишком слабо] / [Слишком туго]
       +---------------+                 +---------------+
       |  |  Профиль |  |                 |  |  Профиль |  |
       | ()  V-Slot  () |                 |()   Люфт    ()| -> Каретка шатается
       +---------------+                 +---------------+
         ^ Эксцентрик                      ^ Ролик стачивается в пыль
A metal drive pulley is mounted on the stepper motor shaft. It is secured using one or two tiny headless screws called grub screws.

Cause of the shift: If a grub screw loosens, the pulley will periodically slip on the motor shaft. The motor rotates correctly, but the carriage lags, producing steps on the print. Since the belt feels perfectly tight, this often misleads beginners.

Solution:
  1. The stepper motor shaft is D-shaped (one side is flat).
  2. Loosen both grub screws on the pulley.
  3. Rotate the pulley so that one of the grub screws is aligned directly with the flat face (D-cut) of the shaft.
  4. Tighten this grub screw first until it is fully locked. Then, tighten the second grub screw resting on the round side of the shaft.
The brass lead screw nut converts the rotation of the steel Z-screw into vertical carriage movement.

Rule: The two screws securing the brass nut to the metal bracket must be loosened by 0.5 to 1 turn.

Physics: Steel lead screws (T8 rods) are rarely perfectly straight. If the brass nut is locked down rigidly, the lead screw's wobble will push the carriage left and right as it rotates. This causes Z-Wobble (horizontal banding on walls) or completely binds the Z-axis when the carriage gets close to the stepper motor.

How it works: The floating brass nut can wiggle in the horizontal plane to absorb lead screw runout, while remaining rigid vertically to transmit steps accurately.
Illustrative Diagram
                  [Свободная гайка (Floating Nut)]
                      
                         ||           ||
                         || Ходовой   ||
                         ||  винт     ||
                       +-||-----------||-+
                       | |#|  Люфт    |#|| <-- Винты ослаблены на 0.5-1 оборот
                       | |#| 0.5 мм   |#||     Гайка может плавать по горизонтали
                       +-||-----------||-+
                         ||           ||
On printers with dual Z lead screws (like the Ender-3 with upgrades or CR-10), the left and right sides of the X-gantry can fall out of sync when the motors are powered off, causing the gantry to sag on one side.

Solutions:
  1. Mechanical Sync (Belt Loop): Installing a closed-loop timing belt and pulleys on the top ends of the Z lead screws. This links them together, preventing independent rotation. Highly effective for single or dual driver configurations.
  2. Independent Drivers (Z-Tilt / G34): If each motor is driven by a separate stepper driver on the control board (e.g., Z1 and Z2 slots), Klipper or Marlin can auto-align the gantry by probing the bed on the left and right edges, adjusting the motors independently to level the axis.
In CoreXY kinematics, two belts work together to control X and Y movement. If the belt lengths or tensions differ, the X-gantry will skew (known as racking), causing the axes to lose squareness.

Tuning Steps:
  1. Gantry Alignment: Loosen the belt tensioners. Slide the X-gantry all the way forward against the front frame corners. Secure it with blocks or clamps on both sides to force it perfectly parallel to the frame.
  2. Equalize Tension: Tension both belts symmetrically. You can match the tension by plucking the belts and measuring the audio frequency (e.g., ~130 Hz over a 15 cm span) using a phone spectrum app. Both belts must ring at the same pitch.
  3. Skew Diagnostic: Print a 100x100 mm square frame and measure the diagonals. Any difference indicates skew. In Klipper, minor racking can be corrected via the [skew_correction] module.
Delta printers use three vertical carriages moving synchronously along columns set at 120-degree angles. Any minor physical offset in rod lengths or column angles causes the nozzle to move in a "bowl" shape (curved path) instead of a flat plane.

Key Parameters to Calibrate:
  • Delta Radius: The main value governing movement flatness. If the nozzle digs into the center of the bed but lifts off near the edges, the radius is too small.
  • Endstop Offsets: Compensates for slight differences in the height of the physical endstop sensors on each column.
  • Diagonal Rod Length: Sets the physical scale of the print. If parts are too small or too large in X/Y, the rod length must be adjusted.
It is highly recommended to use automatic calibration using Klipper's DELTA_CALIBRATE or Marlin's G33 command.
Extruder clicking occurs when the stepper motor attempts to feed filament into the hotend, but encounters resistance that exceeds its torque. The motor snaps backward (skips steps), making a clicking sound.

Primary Causes:
  • Nozzle Clog: Debris or burnt filament is trapped inside the nozzle. Solve by needle cleaning or performing a "Cold Pull".
  • Low Extrusion Temperature: The plastic is not melting fast enough. Increase the hotend temperature by 5-10°C.
  • Too High Print Speed: The volumetric flow rate exceeds the heating capability of the hotend. Lower the print speed or switch to a high-flow nozzle.
  • Nozzle Too Close to Bed: Zero clearance on the first layer physically blocks plastic flow. Adjust Z-offset.
  • Over-tightened Feeder Tension: The drive gear squishes the filament into an oval shape, causing it to bind inside the Bowden tube.
Heat Creep is a process where heat from the heater block travels up the thermal break into the cold zone of the extruder heatsink.

Symptom: The print starts perfectly. However, after 15–30 minutes, the extruder starts clicking and stops feeding. If pulled out, the filament tip looks swollen like a bulb.

Physics: Filament softens prematurely inside the transition zone/heatsink, expands under pressure, and sticks to the inner walls of the throat. The motor cannot push this sticky plug.

How to resolve:
  • Check the Hotend Fan: It must run at 100% capacity, blow directly onto the heatsink fins, and have all blades intact.
  • Thermal Paste: Apply a thin coat of thermal paste to the cold end of the heatbreak before inserting it into the heatsink (never apply it to the hot end thread inside the block).
  • Bowden Tube Sealing: In "lining" hotends, the PTFE tube touches the nozzle. If it burns or backs out, a gap is created where melted plastic pools. Cut the damaged end perfectly square at 90° and push it firmly against the nozzle.
Illustrative Diagram
                  [Схема Хотенда]
                  
                 +---------------+
                 |   Радиатор    | <- Должен быть ХОЛОДНЫМ (Зона 20-40°C)
                 | (Cold End)    |
                 +---------------+
                 |  Термобарьер  | <- Граница перехода температур
                 +---------------+
                 |  Нагреватель  | <- Горячая зона (200-250°C)
                 |  (Hot End)    |
                 +---------------+
Extruder step calibration ensures that when the printer requests 100 mm of filament, it feeds exactly 100 mm.

Step-by-step Guide:
  1. Preheat the nozzle to your filament's printing temperature (e.g., 200°C for PLA).
  2. Measure 120 mm of filament from the extruder entrance up the strand. Mark this point with a marker.
  3. Command the extruder to feed 100 mm of filament at a slow speed (using the G-code below).
  4. Measure the distance from the extruder entrance to your mark. Ideally, it should be 20 mm (120 - 100 = 20).
  5. If it is different, calculate the new steps/mm using the formula:
    New Steps = (Current Steps * 100) / Actual Length Fed.
  6. Find your current steps by sending M503 and locating the E value in the M92 response.
Commands / G-Code
G91 ; Относительные координаты (Relative coordinates)
G1 F100 E100 ; Выдавить 100 мм на скорости 100 мм/мин (Extrude 100mm at 100mm/min)
; После расчетов обновите и сохраните (Update and save after calculations):
M92 E101.08 ; Пример нового значения (Example new E-steps value)
M500 ; Сохранить в EEPROM (Save to EEPROM)
The nozzle material determines your maximum printing speed and how well it resists wear from abrasive filaments.

  • Brass: Excellent thermal conductivity and low cost. Ideal for standard filaments (PLA, PETG, ABS). However, it degrades rapidly when printing with carbon fiber, glow-in-the-dark, wood, or metal-filled filaments.
  • Hardened Steel: Extremely wear-resistant. It has lower thermal conductivity than brass, meaning you usually need to increase your printing temperature by 5-15°C.
  • Plated Copper: High thermal performance with non-stick plating. Perfect for high-speed and high-temperature printing of non-abrasive materials.
  • Ruby Tipped Nozzle: A brass body with a ruby gemstone insert. Offers brass thermal conductivity with near-infinite wear resistance. Downside: very expensive and brittle if it crashes into the bed.
Almost all 3D printing filaments are hygroscopic, meaning they absorb moisture from the air. PETG, TPU, Nylon, and PVA are particularly sensitive.

Signs of wet filament:
  • Popping or crackling sounds from the nozzle during printing (trapped moisture boiling and vaporizing).
  • Excessive stringing and oozing that cannot be tuned out via retraction settings.
  • Rough surface texture and tiny pitting or voids in extrusion lines.
Drying temperature guidelines (use a filament dryer or heated bed under a cardboard box for 4-6 hours):
  • PLA: 45–50°C (temperatures above 55°C will fuse the filament winds on the spool).
  • PETG / ABS: 60–65°C.
  • TPU (flexible): 50–55°C.
  • Nylon: 70–80°C (must be dried and fed from a drybox during printing).
This happens because the control board reads the Z-axis endstop or probe as constantly active or triggered (state: TRIGGERED).

Firmware Logic: Before moving down to home, the printer checks the endstop status. If it reads "TRIGGERED", it assumes the nozzle is already touching the bed. To release the sensor, the board commands the Z-axis to move up. Since the signal remains active (due to wire break or configuration issue), the printer drives Z upward until it hits the frame.

Diagnostics: Manually move the Z-axis up by 50 mm and send the command M119. If z_min reports TRIGGERED, there is an electrical break or configuration error.

Common Causes:
  • Broken wire: Most endstops are wired in a Normally Closed (NC) loop. An electrical break breaks the loop, triggering the safety mechanism.
  • Inverted logic: Endstop logic is inverted in firmware (e.g., Z_MIN_ENDSTOP_INVERTING in Marlin, or missing/extra exclamation mark in Klipper's pin configuration: pin: ^!PC2).
Commands / G-Code
M119 ; Отправить в терминал для опроса статуса концевиков (Send to query endstop status)
Z-offset is the distance value between the trigger point of the auto-leveling probe (or endstop) and the physical tip of the nozzle.

Paper Calibration Method:
  1. Clean the nozzle tip of any filament residue and heat the bed to printing temperature (e.g., 60°C).
  2. Home all axes (G28).
  3. Place a standard sheet of A4 printer paper (approx. 0.1 mm thick) underneath the nozzle.
  4. Manually move the Z-axis to position 0.0 mm.
  5. Adjust your Z-offset via the printer's screen or console while sliding the paper. The nozzle should grab the paper with noticeable drag, allowing you to push and pull it without ripping the fibers.
  6. Save the settings to EEPROM using the M500 command.
Illustrative Diagram
   [Слишком близко]              [Идеальный зазор]             [Слишком далеко]
    (Пластик выдавливается)       (Ровные плоские линии)        (Круглые нити, не липнут)
     +-----+-----+                 +-----+-----+                 +-----+-----+
     |/ / /|/ / /|                 |===========|                 | ( )   ( ) |
  ===+===========+===           ===+===========+===           ===+===========+===
Bed leveling sensors automate compensation for uneven print beds, but need to be tested to prevent head crashes.

  • Inductive Probes: Detect metal targets only. Test by placing a steel spatula or screwdriver under the probe face. The LED indicator should light up. Running M119 should show TRIGGERED when the metal is close, and open when removed.
  • BLTouch / CRTouch: Upon boot, the probe runs a self-test by deploying and retracting the pin twice. You can manually test deployment using the console commands below. If the LED flashes red constantly, it indicates a self-test fault.
Commands / G-Code
; Команды для тестирования BLTouch (Marlin/Klipper)
M280 P0 S10 ; Выдвинуть щуп (Deploy probe pin)
M280 P0 S90 ; Задвинуть щуп (Retract probe pin)
M280 P0 S120 ; Режим тестирования (Self-test loop)
M280 P0 S160 ; Сбросить ошибку (Reset alarm / Error state)
Bed Mesh is a firmware heightmap of the bed. The probe measures surface variation across a grid, and the firmware dynamically adjusts the Z height during XY movement to follow the bed contour.

Key Limit: Bed mesh is intended to compensate for minor warping of the spring steel plate or glass (within 0.1 - 0.3 mm). If your printer has mechanical play (sagging X-gantry, loose V-rollers, misaligned Z screws), the mesh will attempt to compensate for mechanical slop rather than real bed warping. This prints physically warped models and heavily loads the Z axis. Always level the bed manually using leveling wheels before creating a bed mesh.
PID (Proportional-Integral-Derivative) control is a mathematical algorithm regulating heater power. Instead of full-power on/off cycles (Bang-Bang mode), the controller throttle current smoothly as the heater nears target temperature.

Hotend PID Autotune Steps:
  1. Send the autotune command (shown in the code block). The heater will pulse temperature for several cycles.
  2. Wait for completion (~5 mins). The console will print the final Kp, Ki, Kd coefficients.
  3. Save the applied settings to memory using M500.
Caution: Before running a bed autotune, ensure that Bed PID support is active in your firmware (#define PIDTEMPBED in Marlin). Otherwise, calling a bed tune with index E-1 may redirect control to the first active channel (hotend E0), causing the nozzle to overheat uncontrollably.
Commands / G-Code
; Калибровка хотенда до 230°C, 8 циклов (Tune hotend to 230°C, 8 cycles)
M303 E0 S230 C8 U1
; Калибровка стола до 80°C, 8 циклов (Tune heated bed to 80°C, 8 cycles)
M303 E-1 S80 C8 U1
; Сохранение результатов в EEPROM (Save to EEPROM)
M500
The Thermal Runaway safety system triggers when the printer drives current to the heater cartridge, but the thermistor fails to read the expected temperature rise. This prevents fire hazards if the heater falls out of the block.

What to check:
  • Thermistor Mounting: Thin wires may be crushed by the retaining screw on the block or broken inside.
  • Heater Wiring Connections: High-current screw terminals on the control board or cable harness connectors are loose.
  • Incorrect Fan Duct Airflow: Part-cooling fan is blowing air directly onto the heater block, cooling it faster than the cartridge can heat it. Always use a silicone sock.
These errors show that the temperature readings have fallen outside of safe firmware boundaries.

  • MINTEMP (typically Temp < 5°C): Indicates an open circuit in the thermistor wiring (resistance goes to infinity). This also happens if the printer is kept in an unheated room or garage during winter.
  • MAXTEMP (typically Temp > 275–300°C): Indicates a short circuit (resistance drops to zero), often caused by the thermistor signal wires touching each other under the metal clamping screw.
For safety reasons, the control board enters a locked halt state immediately. Inspect, repair, or replace the thermistor assembly.
A layer shift occurs when a stepper motor loses synchronization and skips steps. The printer continues printing, unaware of the physical offset.

Solutions:
  • Nozzle Collision: The nozzle strikes curled edges of the print (due to over-extrusion or bad cooling). Turn on Z-Hop in your slicer.
  • Loose Belt or Pulley: Check belt tension and ensure the drive pulley's grub screws are tight.
  • Driver Overheating: Stepper drivers enter thermal protection for a fraction of a second, disabling motors. Ensure the mainboard cooling fan is active.
  • High Accelerations: Heavy beds (Y-axis) cannot cope with inertia at high speeds. Lower the acceleration limits (500–1000 mm/s² is safe for standard beds).
Illustrative Diagram
           [Нормальная деталь]             [Сдвиг слоев (Layer Shift)]
                 +-----+                             +-----+
                 |     |                             |     |
                 |     |                          +--+     |
                 |     |                          |        |
                 +-----+                          +--------+
Z-Wobble is a print defect characterized by repeating horizontal bands on vertical walls. The pitch of the wave exactly matches the lead screw thread pitch (usually 8 mm or 2 mm).

How to eliminate:
  • Loosen the brass Z-nut mounting screws by 0.5-1 turn to let it float horizontally.
  • Check your couplers: ensure there is a gap between the motor shaft and the Z-screw inside the coupling.
  • Remove upper rigid bearings from the Z-screw tops. The upper ends of the rods should float freely to prevent bending the gantry.
  • Ensure correct motor-to-nut alignment, adding shims or spacers to the stepper mounts if needed.
Stringing and oozing occur when molten filament leaks out of the nozzle during non-printing travels under pressure and gravity.

How to prevent:
  • Tune Retraction: Pulls the filament back before travel. Bowden extruders require 4–7 mm of travel; Direct Drive systems need 0.5–2 mm.
  • Decrease Hotend Temp: Overheated filament has very low viscosity. Lower your nozzle temperature by 5-15°C.
  • Dry the Filament: Boiling moisture inside the nozzle creates micro-explosions that push plastic out (see Filament section).
  • Slicer Seam Settings: Align the layer starts on sharp corners to hide entry/exit blobs.
Plastics shrink as they cool. The upper layers cool faster than the layer attached to the hot bed, exerting upward leverage on corners.

How to fix:
  • Clean the Print Bed: Finger oils ruin adhesion. Clean with warm soapy water or wipe with Isopropyl Alcohol (IPA).
  • Bed Adhesives: Use glue stick (PVP-based), dedicated 3D printing sprays, or upgrade to a textured PEI spring steel sheet.
  • Bed Temperature: Increase bed heater targets (PLA: 60°C, PETG: 75-80°C, ABS: 100-110°C).
  • Use a Brim: Add a 5–10 mm brim in your slicer settings to anchor corners down.
  • Prevent Drafts: For materials like ABS/Nylon, drafts accelerate cooling. Install a printer enclosure.
Input Shaping is a resonance compensation algorithm. The firmware (typically Klipper) monitors carriage moves and modulates motor pulses in anti-phase to cancel structural vibrations.

Effect: Removes ghosting / ringing (wavy patterns adjacent to sharp corners or text on printed walls), enabling you to double or triple your print speed without losing quality.

Tuning: Set up using an ADXL345 accelerometer wired to the control board to measure resonances directly, or print a calibration tower to measure and input frequency values manually.
Filament inside the melt zone acts like a compressed spring. When accelerating, flow lags behind; when decelerating before a corner, residual pressure pushes out excess plastic, causing bulges.

Principle: Linear Advance (Marlin) / Pressure Advance (Klipper) compensates for this elasticity by over-pressurizing the nozzle during acceleration and backing off pressure (micro-retraction) ahead of deceleration.

Result: Wall corners remain sharp and dimensions accurate, and layer start/stop seams become uniform and less visible. Tune by printing a test pattern to find the optimal K coefficient.
Unprivileged LXC containers in Proxmox lack direct permission to dynamically read /dev mount points. When reconnecting a printer, its path (like /dev/ttyUSB0) might change, dropping the printer link.

Solution (udev + bind-mount):
  1. Identify your printer's Vendor and Product ID using lsusb on the Proxmox host.
  2. Create a udev rule on the host to create a stable symlink (shown in the code block).
  3. Reload the host rules: udevadm control --reload-rules && udevadm trigger.
  4. Mount the symlink into the container by editing the LXC configuration file (/etc/pve/lxc/[ID].conf):
    lxc.mount.entry: /dev/ttyUSB_printer dev/ttyUSB_printer none bind,optional,create=file.
Commands / G-Code
# Создать файл /etc/udev/rules.d/99-printer.rules на хосте Proxmox:
# (Replace idVendor and idProduct with your values)
KERNEL=="ttyUSB*", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="7523", SYMLINK+="ttyUSB_printer", MODE="0666"
When a safety threshold is breached (Thermal Runaway, bad sensor, or a manual emergency stop M112), the firmware immediately enters a locked Halted / Shutdown state.

The MCU shuts down all heating elements, cuts motor power, and ceases processing standard serial commands via USB.

Recovery: Software reconnect attempts from OctoPrint or Klipper will fail. You must physically toggle the printer's power switch off for 5-10 seconds, then turn it back on. This resets the MCU flags, allowing the host server to re-establish connection.
During UV exposure, the resin polymerizes and bonds to both the aluminum build plate and the transparent FEP film at the bottom of the vat. When the Z-axis lifts, the print must peel off the FEP film.

Why it fails and stays in the vat:
  • Insufficient Bottom Exposure Time: The initial bottom layers need to be exposed 5 to 10 times longer than standard layers (e.g., 25–35 seconds vs 2.5 seconds) to build a strong bond with the metal.
  • Improper Build Plate Leveling: If Z=0 is calibrated incorrectly or the plate is tilted, the first layer will not squeeze tightly against the FEP, preventing proper adhesion. Re-level the build plate.
  • Slick or Dirty Build Plate: The metal plate requires a textured surface and must be entirely free of grease. Sand it lightly with fine sandpaper if it is too smooth, and clean with IPA.
FEP film is a consumable. It must be tensioned like a drum to allow the cured resin layer to release easily with minimum upward flex.

Tensioning Method: When mounting a new FEP sheet, tighten the frame screws incrementally in a star pattern. You can verify the tension using an audio analyzer app on your phone. Tap the film: it should resonate at a frequency of 250–330 Hz.

When to replace:
  • The film turns cloudy or matte (scatters UV light, degrading print sharpness).
  • Deep dents, wrinkles, or scratches appear, which increase suction force.
  • Punctures or pinholes are detected (replace immediately to prevent resin leaking onto the LCD screen).
Hollowing prints reduces weight and saves expensive resin. However, if you do not design venting/drainage holes, two major issues occur:

  1. Suction Cup Effect: As the build plate retracts upward, a vacuum is created inside the sealed hollow chamber. The massive suction force can pull the print off the supports, separate layers, or cause blowouts on walls.
  2. Trapped Liquid Resin: Uncured liquid resin remains trapped inside the hollow core. Over time, it chemically degrades the cured shell, causing the print to crack, leak toxic chemicals, or split open.
Rule: Always place at least two drainage holes (2–3 mm diameter) as close to the build plate base as possible using your slicer (e.g., Chitubox, Lychee). This vents air and allows trapped resin to drain out.