.` | | `webhooks` | `state`, `state_message` | | `system_stats` | `sysload`, `cputime`, `memavail` | ### Send GCode ```bash curl -s -X POST "http://:7125/printer/gcode/script" \ -H "Content-Type: application/json" \ -d '{"script": "QUERY_ENDSTOPS"}' ``` ### Query Endstops ```bash curl -s "http://:7125/printer/query_endstops/status" ``` --- ## Phase 5: Calibration Sequences ### Probe Z-Offset (PROBE_CALIBRATE) 1. Verify printer is homed: send `G28` 2. Start calibration: `PROBE_CALIBRATE` 3. Guide user through paper test at nozzle 4. Accept: `TESTZ Z=-0.1` (adjust in steps) 5. Finalize: `ACCEPT` 6. Save: `SAVE_CONFIG` (triggers firmware restart automatically) ### Bed Mesh Calibration 1. Home all axes: `G28` 2. Optional: heat bed to print temp first 3. Run: `BED_MESH_CALIBRATE` 4. Save profile: `BED_MESH_PROFILE SAVE=default` 5. Save to config: `SAVE_CONFIG` ### Axis Twist Compensation **Before running, always validate calibrate_end_x:** ``` max_safe_end_x = stepper_x.position_max + probe.x_offset ``` If `calibrate_end_x > max_safe_end_x` → fix it first (see Phase 2 edit workflow) Then: 1. Home: `G28` 2. Run: `AXIS_TWIST_COMPENSATION_CALIBRATE` 3. Follow prompts for paper test at each probe point 4. Save: `SAVE_CONFIG` ### PID Tuning Hotend: ```gcode PID_CALIBRATE HEATER=extruder TARGET=200 SAVE_CONFIG ``` Bed: ```gcode PID_CALIBRATE HEATER=heater_bed TARGET=60 SAVE_CONFIG ``` ### Pressure Advance Method 1 — Tuning tower (manual): ```gcode SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500 TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005 ``` Print a tuning tower model. Measure optimal layer. Calculate: `PA = START + FACTOR × best_layer_height_mm` Method 2 — Set directly after finding value: ```gcode SET_PRESSURE_ADVANCE ADVANCE=0.04 ``` Then add to `[extruder]` in config and `SAVE_CONFIG`. ### Resonance / Input Shaper Calibration 1. Verify `[adxl345]` or other accelerometer configured 2. Home: `G28` 3. Test accelerometer: `ACCELEROMETER_QUERY` 4. Measure noise baseline: `MEASURE_AXES_NOISE` 5. Calibrate X: `SHAPER_CALIBRATE AXIS=X` 6. Calibrate Y: `SHAPER_CALIBRATE AXIS=Y` 7. Review results and apply recommended shaper 8. `SAVE_CONFIG` ### Screws Tilt Adjust 1. Home: `G28` 2. Run: `SCREWS_TILT_CALCULATE` 3. Read output — each screw shows turn direction (CW/CCW) and amount (HH:MM) 4. Re-run until all screws show < 0:05 deviation ### TMC Driver Diagnostics Dump driver state: ```gcode DUMP_TMC STEPPER=stepper_x DUMP_TMC STEPPER=stepper_y DUMP_TMC STEPPER=stepper_z DUMP_TMC STEPPER=extruder ``` Adjust current at runtime (test only — add to config to persist): ```gcode SET_TMC_CURRENT STEPPER=stepper_x CURRENT=0.8 HOLDCURRENT=0.5 ``` --- ## Phase 6: Troubleshooting Use `references/troubleshooting.md` for the full error → cause → fix database. **Workflow for any error message the user pastes:** 1. Extract the error pattern (error type + coordinates/values if present) 2. Match against known patterns in the troubleshooting reference 3. Pull the relevant config sections from `printer_context.json` 4. Compute the specific fix values using the validation formulas 5. Present the diagnosis with the exact lines to change 6. Offer to apply the fix automatically (Phase 2 edit workflow) **Common error patterns (quick reference):** | Error | Cause | Fix | |-------|-------|-----| | `Move out of range: X Y Z [step]` | Nozzle would exceed axis limit; often probe offset not accounted in calibration coords | Reduce `calibrate_end_x` / `mesh_max` by `abs(probe.x_offset)` | | `Must home axis first` | Axes not homed before move command | Run `G28` | | `Endstop stepper_x still triggered` | Endstop stuck or wiring fault | Check `QUERY_ENDSTOPS`, check endstop pin polarity | | `Unable to read tmc uart ... IFCNT` | TMC UART comms failure | Check motor power and UART wiring; power cycle | | `TMC reports error: ... OvertempError` | TMC driver too hot | Reduce `run_current`, improve cooling | | `TMC reports error: ShortToGND` | Shorted motor wire | Check motor wiring | | `TMC reports error: Undervoltage` | PSU voltage dip | Check PSU and wiring connections | | `Heater extruder not heating at expected rate` | PID tuning needed or heater/sensor issue | Run `PID_CALIBRATE HEATER=extruder TARGET=200` | | `Probe triggered prior to movement` | BLTouch in wrong state or z_offset too high | Run `BLTOUCH_DEBUG COMMAND=reset` then re-home | | `Timeout on connect` | Moonraker not running or wrong IP | Verify printer IP and that Moonraker is running | | `Lost communication with MCU` | USB disconnect or firmware crash | Run `FIRMWARE_RESTART`; check USB cable | --- ## Phase 7: Config Section Reference Use `references/config_sections.md` for the complete parameter reference. Key sections and their most commonly tuned parameters: ### [printer] ```ini kinematics: cartesian # cartesian|corexy|corexz|delta|deltesian|polar max_velocity: 300 # mm/s — runtime tunable via SET_VELOCITY_LIMIT max_accel: 7000 # mm/s² — runtime tunable max_z_velocity: 15 # mm/s (cartesian only) max_z_accel: 100 # mm/s² (cartesian only) minimum_cruise_ratio: 0.5 # 0.0–1.0, reduces top speed of short moves square_corner_velocity: 5.0 # mm/s, higher = less deceleration at corners ``` ### [stepper_x/y/z] ```ini rotation_distance: 40 # mm per full motor rotation microsteps: 16 # 8|16|32|64|128 position_min: 0 # soft limit minimum position_max: 246 # soft limit maximum — CRITICAL for range checks position_endstop: 0 # endstop position (must match position_min or position_max) homing_speed: 80 # mm/s ``` ### [extruder] ```ini rotation_distance: 7.687 # mm per motor rotation (direct drive ~7-8, bowden ~20-40) nozzle_diameter: 0.400 pressure_advance: 0.04 # 0 = disabled; typical range 0.02–0.12 for direct pressure_advance_smooth_time: 0.04 max_extrude_cross_section: 5 # max mm² cross section (4 × nozzle_diameter² is safe default) ``` ### [bltouch] / [probe] ```ini x_offset: -62 # probe X position relative to nozzle (negative = left of nozzle) y_offset: -12 # probe Y position relative to nozzle (negative = in front) # z_offset: stored in SAVE_CONFIG block samples: 3 # number of probe samples samples_result: median # average|median sample_retract_dist: 5.0 samples_tolerance: 0.01 # max deviation between samples (mm) samples_tolerance_retries: 3 ``` ### [bed_mesh] ```ini mesh_min: 60, 30 # PROBE coordinates (not nozzle!) mesh_max: 170, 220 # PROBE coordinates probe_count: 5, 5 # grid points per axis algorithm: bicubic # lagrange (≤3×3) | bicubic (≥4×4 recommended) fade_start: 1 # mm height to start fading mesh correction fade_end: 10 # mm height where mesh correction reaches zero (0=disabled) ``` ### [axis_twist_compensation] ```ini calibrate_start_x: 20 # PROBE X coordinate — nozzle = start_x - x_offset calibrate_end_x: 183 # PROBE X coordinate — nozzle = end_x - x_offset calibrate_y: 117.5 # PROBE Y coordinate — nozzle = calibrate_y - y_offset # Rule: nozzle must be within [position_min, position_max] # Formula: calibrate_end_x <= position_max + x_offset (when x_offset < 0) ``` ### [safe_z_home] ```ini home_xy_position: 108.5, 117.5 # NOZZLE position for Z homing (not probe!) speed: 120 z_hop: 10 z_hop_speed: 5 ``` ### [tmc2209 stepper_x] ```ini run_current: 0.750 # Amps RMS — start at 70% rated current hold_current: 0.500 # Optional — Klipper docs recommend omitting stealthchop_threshold: 999999 # 999999=always stealthChop; 0=always spreadCycle interpolate: True # micro-step interpolation (small positional error) driver_SGTHRS: 255 # stallGuard threshold for sensorless homing (if used) ``` ### [input_shaper] ```ini shaper_type_x: 3hump_ei # mzv|ei|2hump_ei|3hump_ei|zv|zvd shaper_freq_x: 66.2 # Hz — from SHAPER_CALIBRATE shaper_type_y: ei shaper_freq_y: 45.0 ``` ### [firmware_retraction] ```ini retract_length: 0.5 # mm — direct drive: 0.4–1.0; bowden: 4–7 retract_speed: 60 # mm/s unretract_extra_length: 0 unretract_speed: 60 ``` --- ## Moonraker API Quick Reference Base URL: `http://:7125` | Method | Endpoint | Purpose | |--------|----------|---------| | GET | `/printer/info` | Klipper state, version, hostname | | GET | `/server/files/config/printer.cfg` | Read printer.cfg | | GET | `/server/files/list?root=config` | List all config files | | POST | `/server/files/upload` (multipart) | Upload/overwrite a config file | | POST | `/printer/firmware_restart` | Firmware restart (apply config changes) | | POST | `/printer/gcode/script` | Send GCode command (JSON body: `{"script":"..."}`) | | GET | `/printer/objects/list` | List all queryable printer objects | | GET | `/printer/objects/query?=` | Query live printer state | | GET | `/printer/query_endstops/status` | Endstop states | | POST | `/printer/gcode/script` `{"script":"SAVE_CONFIG"}` | Persist calibration data | | GET | `/server/info` | Moonraker version, registered components | | POST | `/machine/reboot` | Reboot the host (Pi) | | POST | `/machine/shutdown` | Shutdown the host | ### File Upload (curl) ```bash curl -X POST "http://:7125/server/files/upload" \ -F "root=config" \ -F "file=@/path/to/printer.cfg;filename=printer.cfg" ``` ### GCode Send (curl) ```bash curl -X POST "http://:7125/printer/gcode/script" \ -H "Content-Type: application/json" \ -d '{"script": "G28"}' ``` ### Object Query (curl) ```bash curl "http://:7125/printer/objects/query?extruder&heater_bed&toolhead" ``` --- ## Platform Notes The AI performs all config fetching, parsing, and editing **inline** using `curl` (available on both Windows and Linux) and direct text analysis. The scripts in `scripts/` are provided as reference implementations and work on **Linux/macOS** (require `python3`). On Windows, the AI executes the equivalent logic directly — do not rely on the shell scripts. When running on the Klipper host directly (via SSH), the scripts work without modification. --- ## File Structure ``` klipper-manager/ ├── SKILL.md # This file ├── references/ │ ├── config_sections.md # Full parameter reference for all config sections │ ├── gcodes.md # All supported G-codes and extended commands │ ├── troubleshooting.md # Error patterns → causes → fixes │ └── moonraker_api.md # Full Moonraker API reference ├── scripts/ │ ├── fetch_config.sh # Fetch printer.cfg from Moonraker │ ├── upload_config.sh # Upload modified config │ ├── send_gcode.sh # Send a GCode command │ ├── query_status.sh # Query printer status objects │ └── diagnose.sh # Full diagnostic run └── state/ └── printer_context.json # Persisted printer state (auto-created) ``` Base directory: `file:///C:/Users/santi/.config/opencode/skills/klipper-manager`