//
// Klipper Filament Switch Sensor Configuration
// 断料检测传感器配置
// 功能: 监控3D打印机耗材状态，检测断料并自动暂停打印
// 硬件接口: 限位开关/光电传感器连接至主控板GPIO
//
[filament_switch_sensor 断料监测]
# 传感器配置块定义
# 创建一个名为"断料监测"的断料传感器实例
# 此传感器通过监测耗材存在状态来实现断料检测
# 断料时自动暂停打印设置
# 当传感器检测到耗材耗尽时，自动暂停打印进程
# 可选值: True (启用) / False (禁用，仅发送警告不暂停)
pause_on_runout: True
# 传感器开关引脚配置
# 指定连接传感器的GPIO引脚
# ^PC2 表示：
# - PC2: 引脚名称（具体根据主板定义，如STM32的PC2引脚）
# - ^: 引脚逻辑反转（即传感器常闭接法，断开时触发）
# 如果传感器在耗材存在时闭合，则使用^前缀
# 如果传感器在耗材存在时断开，则去掉^前缀
# 物理连接: 传感器通常为三线式（VCC, GND, SIGNAL）
# SIGNAL线连接至PC2，并配置适当的上拉/下拉电阻
switch_pin: ^PC2
# 断料检测触发时的G-code序列
# 当传感器检测到断料时，执行以下命令
# 注意: 此处的缩进非常重要，必须使用空格（通常2或4个空格）
runout_gcode:
# 1. 暂停打印
# PAUSE命令是Klipper内置的打印暂停命令，执行以下操作：
# - 停止挤出机移动
# - 回抽少量耗材（防止漏料）
# - 将喷头移离打印件（避免热烫）
# - 等待用户操作
PAUSE
# 2. 发送断料提示信息
# M118命令发送消息到控制终端和LCD屏幕
# 消息内容："断料,暂停打印"
# 注意：中文消息可能需要固件支持UTF-8编码
M118 断料,暂停打印
# 可选扩展功能（取消注释以启用）：
# M300 P1000 S800 # 播放提示音（频率800Hz，持续1秒）
# G4 P5000 # 等待5秒，确认用户已收到提示
# LED_ON # 打开报警LED（需配置LED控制）
# 耗材恢复插入时的G-code序列
# 当传感器检测到耗材重新插入时，执行以下命令
# 此功能允许用户恢复打印而无需重启打印作业
insert_gcode:
# 发送耗材恢复提示信息
# 通知用户耗材已重新插入，可继续打印
# 注意：恢复打印需要手动操作（如点击继续）
M118 断料恢复
# 可选扩展功能（取消注释以启用）：
# M118 请准备恢复打印 # 附加提示信息
# M300 P500 S1000 # 播放确认音
# LED_OFF # 关闭报警LED
# G4 P2000 # 等待2秒，确保耗材到位
# 可选高级配置参数（取消注释并根据需要修改）：
# event_delay: 3.0 # 事件延迟（秒），防止误触发
# pause_delay: 0.5 # 暂停延迟（秒）
# runout_distance: 50 # 触发后额外挤出距离（毫米）
# switch_type: # 开关类型（默认机械开关）
# mechanical # 机械开关（接触式）
# hall # 霍尔传感器
# photoelectric # 光电传感器
# encoder # 编码器（用于测量耗材流动）
# 安装调试指南：
# 1. 将传感器安装在挤出机入口附近
# 2. 确保耗材路径平滑，不会意外触发
# 3. 测试传感器响应：
# - 手动拉出耗材，应触发暂停
# - 重新插入耗材，应发送恢复提示
# 4. 调整传感器位置，确保耗材存在时可靠触发
# 5. 使用Klipper终端命令检查传感器状态：
# - QUERY_FILAMENT_SENSOR SENSOR="断料监测"
# 故障排除：
# 1. 如果传感器状态相反，移除switch_pin的^前缀或添加^
# 2. 如果误触发频繁，增加event_delay值
# 3. 确保传感器接线正确（VCC, GND, SIGNAL）
# 4. 检查Klipper日志中的传感器状态消息
# 兼容性说明：
# 1. 此配置适用于Klipper固件v0.10.0及以上版本
# 2. 确保主板引脚定义正确（参考Klipper主板配置文件）
# 3. PAUSE命令需要正确的[gcode_macro PAUSE]配置
# 安全注意事项：
# 1. 暂停后喷头仍保持高温，小心烫伤
# 2. 恢复打印前确保耗材已正确加载
# 3. 建议测试断料恢复流程，避免打印质量问题
