Klipper 风扇/气泵/断料/堵料配置

**两线风扇**

output_pin 输出引脚：

```bash
# printer.cfg 最简单的启停风扇，连接 HE0 输出引脚
[output_pin simple_fan]
pin: PC8

# 启停控制
SET_PIN PIN=simple_fan VALUE=0|1

```

**启停控制**

```bash
## 自锁按钮
[gcode_button fan_lock_switch]
pin: PA2 
press_gcode:
  SET_PIN PIN=simple_fan VALUE=1
release_gcode:
  SET_PIN PIN=simple_fan VALUE=0
```

**断料、堵料检测配置参考**

![](/media/202503/2025-03-13_145847_9030850.12398442530945741.png)

**缺料检测功能配置指南**

#### 1. **核心配置参数**
在Klipper固件中，缺料检测通过`filament_motion_sensor`模块实现，需在`printer.cfg`中添加以下配置：
```ini
[filament_motion_sensor 堵转检测]
detection_length: 10.0  # 检测长度建议7-12mm
extruder: extruder      # 对应挤出机名称
switch_pin: PA8         # 信号接口（需根据主板引脚图选择）
pause_on_runout: True   # 自动暂停打印
runout_gcode:
  M118 "检测到缺料"     # 触发后发送提示（英文系统需改提示语）
  M600                  # 执行换料流程
event_delay: 3.0        # 事件延迟（避免误触发）
```
此配置支持耗材耗尽时自动暂停并提示，需注意`switch_pin`需与物理传感器接线匹配。

#### 2. **硬件选型建议**
• **限位开关改装方案**：Creality系列打印机（如Ender 3）的Z轴限位开关可改装为传感器，通过3D打印支架固定（如ID:4547442模型），利用SPDT开关特性检测耗材状态。
• **低摩擦设计**：推荐使用608轴承+PTFE管导向结构（参考ID:4937795），减少耗材通过阻力，尤其适合柔性材料。
• **安装位置优化**：传感器应靠近挤出机（距离<30cm）以降低耗材浪费，直接驱动机型可安装在Z轴框架顶部（ID:4547442案例）。

#### 3. **电气连接要点**
• 双线接线法：仅需连接信号线（S）和地线（-），部分主板需通过JST-XH接口接入GPIO（如Octopus主板案例）。
• 电压匹配：确认传感器工作电压（通常3.3V/5V），部分限位开关需改造PCB线路（ID:3857824方案）。

#### 4. **调试与测试**
1. 执行`TEST_FILAMENT_SENSOR SENSOR=堵转检测`命令验证传感器状态
2. 手动抽拉耗材观察`query_filament_sensor`返回值变化
3. 模拟断料触发`M600`流程，测试恢复续打功能

#### 5. **常见问题处理**
• **误触发**：增大`detection_length`至15mm或添加`event_delay: 5.0`
• **响应延迟**：检查PTFE管与轴承的配合间隙（建议0.2-0.5mm）
• **固件不识别**：确认`[extruder]`部分已正确定义挤出机参数

> 注：部分开源传感器模型（如ID:2665162、ID:2443425）提供可下载的STL文件和接线图，可通过[非凡3D打印社区](https://www.cn2220.com)获取完整设计方案。

## 参考文档
[1.【思兼-Klipper 篇17】基于 Klipper 的必趣 Manta 牌夏日降温电风扇
](https://www.cnblogs.com/sjqlwy/p/klipper_fan.html)
[2. klipper的gcode_button](https://www.klipper3d.org/zh/Config_Reference.html#gcode_button)
[3. klipper的output_pin](https://www.klipper3d.org/zh/Config_Reference.html#output_pin)
[4.必趣BIGTREETECH 新款 SFS V2.0 断料堵料智能耗材检测模块](https://www.bilibili.com/video/BV1fu4y1z715/)
[5. Klipper耗材移动传感器配置](https://www.klipper3d.org/zh/Config_Reference.html#filament_motion_sensor)