Klipper-常用命令

**相关链接：**
- 宏教程：https://klipper.discourse.group/t/macro-creation-tutorial
- 命令模版：https://www.klipper3d.org/zh/Command_Templates.html
- 状态参考：https://www.klipper3d.org/zh/Status_Reference.html

```bash
# 打印内容
M117 <输出内容>  # 打印内容到通知
M118 <输出内容>  # 打印内容到控制台

# 读取指定状态(有些只能通过写GCode方式读取,控制台读会报错)
[gcode_macro state_print]
gcode:
  # [fan]  # 对象
  M117 {printer.fan.speed}  # 对象名称无空格可直接获取
  # [output_pin beeper]  # 对象
  M117 {printer["output_pin beeper"].value}  # 对象名称中有空格的需使用该方式获取

# output_pin 引脚控制
SET_PIN PIN=<引脚名称> VALUE=<设定值>

# 获取归位后的轴的行程限制
M118 {printer.toolhead.axis_minimum}  # 获取MIN_所有
M118 {printer.toolhead.axis_maximum}  # 获取MAX_所有
M118 {printer.toolhead.axis_maximum.x}  # 获取指定MAX_x

# gcode_macro 判断归位
{% if "z" in printer.toolhead.homed_axes %}     # 判断Z是否已归位
  G28 X Y                                       # 以归位,只归位XY
{% else %}
  G28 X Y Z                                     # 没有归位,XYZ全部归位
{% endif %}
```

## 内置宏
```bash
ACTIVATE_EXTRUDER  # 激活挤出机
BED_MESH_CALIBRATE  # 执行网格床平整
BED_MESH_CLEAR  # 清除网格，不进行Z轴调整
BED_MESH_MAP  # 序列化网格并输出到终端
BED_MESH_OFFSET  # 添加X/Y偏移到网格查找
BED_MESH_OUTPUT  # 检索插值的网格Z点
BED_MESH_PROFILE  # 床网格持久化存储管理
CALC_MEASURED_SKEW  # 根据测量的打印计算偏斜
CANCEL_PRINT  # 取消打印
CANCEL_PRINT_BASE  # 'CANCEL_PRINT'的重命名内置
CLEAR_PAUSE  # 清除当前的暂停状态，不恢复打印
DUMP_TMC  # 读取并显示TMC步进驱动器寄存器
FIRMWARE_RESTART  # 重启固件、主机并重新加载配置
GET_CURRENT_SKEW  # 报告当前打印机偏斜
GET_POSITION  # 返回工具头当前位置的信息
GET_TIMELAPSE_SETUP  # 输出缩时摄影设置
HELP  # 报告可用的扩展G-Code命令列表
HYPERLAPSE  # 开始/停止延时拍摄
INIT_TMC  # 初始化TMC步进驱动器寄存器
MANUAL_PROBE  # 启动手动探针辅助脚本
PAUSE  # 暂停打印
PAUSE_BASE  # 'PAUSE'的重命名内置
PID_CALIBRATE  # 运行PID校准测试
PRINT_END  # 打印结束
PRINT_START  # 打印开始
PROBE  # 在当前XY位置探测Z高度
PROBE_ACCURACY  # 在当前XY位置探测Z高度精度
PROBE_CALIBRATE  # 校准探针的z_offset
QUERY_ADC  # 报告模拟引脚的最后一个值
QUERY_ENDSTOPS  # 报告每个限位开关的状态
QUERY_FILAMENT_SENSOR  # 查询丝材传感器的状态
QUERY_PROBE  # 返回Z探针的状态
RESPOND  # 回显消息，前面加上前缀
RESTART  # 重新加载配置文件并重启
RESTORE_GCODE_STATE  # 恢复先前保存的G-Code状态
RESUME  # 恢复打印
RESUME_BASE  # 'RESUME'的重命名内置
RUN_SHELL_COMMAND  # 运行Linux shell命令
SAVE_CONFIG  # 覆盖配置文件并重启
SAVE_GCODE_STATE  # 保存G-Code坐标状态
SCREWS_TILT_CALCULATE  # 工具，通过计算帮助调整床平整螺丝
SDCARD_PRINT_FILE  # 加载SD卡文件并开始打印，可能包括子目录中的文件
SDCARD_RESET_FILE  # 清除加载的SD卡文件，如有必要，停止打印
SET_DISPLAY_GROUP  # 设置活动显示组
SET_DISPLAY_TEXT  # 设置或清除显示消息
SET_EXTRUDER_ROTATION_DISTANCE  # 设置挤出机旋转距离
SET_FILAMENT_SENSOR  # 设置丝材传感器开关
SET_GCODE_OFFSET  # 设置G-Code位置的虚拟偏移
SET_GCODE_VARIABLE  # 设置G-Code宏变量的值
SET_HEATER_TEMPERATURE  # 设置加热器温度
SET_IDLE_TIMEOUT  # 设置空闲超时（秒）
SET_INPUT_SHAPER  # 设置输入整形器的笛卡尔参数
SET_PAUSE_AT_LAYER  # 指定层数暂停
SET_PAUSE_NEXT_LAYER  # 下一层暂停
SET_PIN  # 设置输出引脚的值
SET_PRESSURE_ADVANCE  # 设置压力提前参数
SET_PRINT_STATS_INFO  # 覆盖获取pause_next_layer和pause_at_layer功能
SET_PRINT_STATS_INFO_BASE  # 'SET_PRINT_STATS_INFO'的重命名内置
SET_SKEW  # 根据测量物体的长度设置偏斜
SET_STEPPER_ENABLE  # 通过名称启用/禁用个别步进电机
SET_TMC_CURRENT  # 设置TMC驱动器的电流
SET_TMC_FIELD  # 设置TMC驱动器寄存器字段
SET_VELOCITY_LIMIT  # 设置打印机速度限制
SKEW_PROFILE  # 偏斜校正的配置文件管理
STATUS  # 报告打印机状态
STEPPER_BUZZ  # 振荡给定步进电机以帮助识别它
SYNC_EXTRUDER_MOTION  # 设置挤出机步进电机运动队列
TEMPERATURE_WAIT  # 等待传感器达到温度
TEST_STREAM_DELAY  # 辅助宏，用于查找流和停放延迟
TIMELAPSE_RENDER  # 渲染缩时视频并等待结果
TIMELAPSE_TAKE_FRAME  # 延时拍摄
TUNING_TOWER  # 工具，用于在每个Z高度调整参数
TURN_OFF_HEATERS  # 关闭所有加热器
UPDATE_DELAYED_GCODE  # 更新延迟G-Code的持续时间
Z_ENDSTOP_CALIBRATE  # 校准Z限位
Z_OFFSET_APPLY_ENDSTOP  # 调整z限位位置
Z_OFFSET_APPLY_PROBE  # 调整探针的z_offset
_CLIENT_EXTRUDE  # 喷头温度足够，可以挤出
_CLIENT_RETRACT  # 喷头温度足够，可以回抽
_SET_TIMELAPSE_SETUP  # 设置延时摄影的用户参数
_TIMELAPSE_NEW_FRAME  # 调用延时拍摄，必须是单独的宏
_TOOLHEAD_PARK_PAUSE_CANCEL  # 助手  # PAUSE和CANCEL_PRINT中使用的停放工具头
```