风扇参考配置

本页面整理常见风扇配置方式，包括驱动风扇、7040 风扇和多风扇共用引脚。示例中的引脚需要按实际主板修改。

驱动风扇

驱动风扇常见有两种做法：

方式	适用场景	说明
[output_pin]	需要开机或连接 Klipper 后常开	配置简单，不会按电机状态自动启停
[controller_fan]	希望电机或加热器工作时自动开启	更适合驱动散热风扇

常开风扇

value: 1 表示 Klipper 连接后自动打开该输出。

printer.cfg

[output_pin driver_fan]
pin: <driver_fan_pin>
value: 1

自动驱动风扇

printer.cfg

[controller_fan driver_fan]
pin:
cycle_time: 0.00003
max_power: 1.0
shutdown_speed: 0.0
fan_speed: 0.9
idle_timeout: 90
idle_speed: 0.4
stepper: stepper_x,stepper_y

参数说明：

• fan_speed：电机或加热器工作时的风扇速度。
• idle_timeout：电机停止后继续运行的时间，单位为秒。
• idle_speed：进入空闲等待期间的风扇速度。
• stepper：关联的电机名称，可填写多个。

7040 风扇

部分 7040 风扇可能出现上电或开机就转的问题，需要在固件编译时设置 PWM 初始状态。

信息

在固件编译选项 GPIO pins to set at micro-controller startup 中填写 !<fan_pin> 可让对应风扇输出在启动时保持关闭。请按实际 PWM 引脚修改，! 需要使用英文感叹号。

Loading...

printer.cfg

[fan]
pin:
max_power: 0.9
cycle_time: 0.002
hardware_pwm: false
shutdown_speed: 0

多风扇共用引脚配置

多个风扇需要同时控制时，可使用 [multi_pin]。此方法不适用于步进电机引脚。

printer.cfg

[multi_pin my_fan]
pins: PA1,PA2,PA3,PA4

[fan]
pin: multi_pin:my_fan

注意

多风扇共用引脚前，请确认对应 MOS 管和供电线路能承受总电流。