Klipper Homing Timeout Issue

Problem Description

A communication timeout error occurs during the homing process:

Error during homing z: Communication timeout during homing

This mainly occurs during Z-axis homing with multiple MCUs. Klipper requires a response within 0.025 seconds.

• Adjust Timeout
• Manage KlipperScreen

Method 1: Adjust Timeout

Modify Timeout Configuration

sed -i 's/TRSYNC_TIMEOUT = [0-9.]*$/TRSYNC_TIMEOUT = 0.05/' ~/klipper/klippy/mcu.py

Restart Service to Apply

sudo systemctl restart klipper

Related Commands

# View current setting
grep "TRSYNC_TIMEOUT =" ~/klipper/klippy/mcu.py

# Restore default setting
sed -i 's/TRSYNC_TIMEOUT = [0-9.]*$/TRSYNC_TIMEOUT = 0.025/' ~/klipper/klippy/mcu.py

Method 2: Manage KlipperScreen

Temporarily disable KlipperScreen to release system resources, resolving communication timeout issues during homing.

1. Download Necessary Files

Standard System:

git clone https://cnb.cool/3dmellow/public/klipper-klipperscreen-manager
curl -# -L --retry 3 --retry-delay 2 -o ~/klipper/klippy/extras/gcode_shell_command.py https://raw.githubusercontent.com/dw-0/kiauh/master/kiauh/extensions/gcode_shell_cmd/assets/gcode_shell_command.py

Fast System:

cd /data
git clone https://cnb.cool/3dmellow/public/klipper-klipperscreen-manager
curl -# -L --retry 3 --retry-delay 2 -o /data/klipper/klippy/extras/gcode_shell_command.py https://raw.githubusercontent.com/dw-0/kiauh/master/kiauh/extensions/gcode_shell_cmd/assets/gcode_shell_command.py

2. Set Script Permissions

Standard System:

cd ~/klipper-klipperscreen-manager
chmod +x ~/klipper-klipperscreen-manager/scripts/*.sh

Fast System:

cd /data/klipper-klipperscreen-manager
chmod +x /data/klipper-klipperscreen-manager/scripts/*.sh

3. Create Configuration File

• Create klipper_macros.cfg file in the Klipper configuration directory
• Add the following at the top of printer.cfg:

  [include klipper_macros.cfg]

4. Configure Macro Commands

• Add the following content to klipper_macros.cfg:
• Note: /data/klipper-klipperscreen-manager/scripts/ needs to be changed to the actual path

# ===== KlipperScreen Control Macros =====
# Author: MELLOW-张伟
# Description: Used to manage KlipperScreen shutdown and automatic recovery

[gcode_shell_command disable_klipperscreen]
command: sh /data/klipper-klipperscreen-manager/scripts/disable_klipperscreen.sh
timeout: 5.0
verbose: True

[gcode_shell_command enable_klipperscreen]
command: sh /data/klipper-klipperscreen-manager/scripts/enable_klipperscreen.sh
timeout: 5.0
verbose: True

[gcode_macro RESTART_KlipperScreen]
variable_time: 60  # Default wait time (seconds)
gcode:
    {% set wait_time = params.TIME|default(printer["gcode_macro RESTART_KlipperScreen"].time)|int %}
    {action_respond_info("Wait time: %s seconds" % wait_time)}
    RUN_SHELL_COMMAND CMD=disable_klipperscreen PARAMS={wait_time}

[gcode_macro ENABLE_KlipperScreen]
gcode:
    {action_respond_info("Starting KlipperScreen immediately")}
    RUN_SHELL_COMMAND CMD=enable_klipperscreen

5. Usage

Temporarily Disable KlipperScreen:

# Use default 60-second wait time
RESTART_KlipperScreen

# Use custom wait time (120 seconds)
RESTART_KlipperScreen TIME=120

Manually Restart KlipperScreen Immediately:

ENABLE_KlipperScreen

How It Works

This method releases system resources by temporarily disabling the KlipperScreen interface, reducing CPU load and thus avoiding communication timeout issues during the homing process.

Prerequisites

• Confirm Klipper is installed
• Current user is the Klipper installation user
• File paths are correct