From 4f48afd6fe42f745b6db4fd20281a14a7fdf016d Mon Sep 17 00:00:00 2001
From: SoftFever <softfeverever@gmail.com>
Date: Sat, 11 Nov 2023 23:30:54 +0800
Subject: [PATCH] update WIKI for exhuast/auxiliar fan and active chamber
 temperature features

---
 doc/Auxiliary-fan.md       | 36 +++++++++++++++++++++++++++++++++++-
 doc/Chamber-temperature.md | 37 ++++++++++++++++++++++++++++++++++++-
 doc/air-filtration.md      | 36 +++++++++++++++++++++++++++++++++++-
 3 files changed, 106 insertions(+), 3 deletions(-)

diff --git a/doc/Auxiliary-fan.md b/doc/Auxiliary-fan.md
index 6d3f66599c9..25e601d640d 100644
--- a/doc/Auxiliary-fan.md
+++ b/doc/Auxiliary-fan.md
@@ -1 +1,35 @@
-WIP
\ No newline at end of file
+OrcaSlicer use `M106 P2` command to control auxiliary cooling fan.
+
+If you are using Klipper, you can define a `M106` macro to control the both normal part cooling fan and auxiliary fan and exhuast fan.  
+Below is a reference configuration for Klipper.   
+*Note: Don't forget to change the pin name to the actual pin name you are using in the configuration*
+
+```
+# instead of using [fan], we define the default part cooling fan with [fan_generic] here
+# this is the default part cooling fan
+[fan_generic fan0]
+pin: PA7
+cycle_time: 0.01
+hardware_pwm: false
+
+# this is the auxiliary fan
+# comment out it if you don't have auxiliary fan
+[fan_generic fan2]
+pin: PA8
+cycle_time: 0.01
+hardware_pwm: false
+
+# this is the exhaust fan
+# comment out it if you don't have exhaust fan
+[fan_generic fan3]
+pin: PA9
+cycle_time: 0.01
+hardware_pwm: false
+
+[gcode_macro M106]
+gcode:
+    {% set fan = 'fan' + (params.P|int if params.P is defined else 0)|string %}
+    {% set speed = (params.S|int if params.S is defined else 255) %}
+    SET_FAN_SPEED FAN={fan} SPEED={speed}
+
+```
diff --git a/doc/Chamber-temperature.md b/doc/Chamber-temperature.md
index 1fc1779bda8..d9fe37e6769 100644
--- a/doc/Chamber-temperature.md
+++ b/doc/Chamber-temperature.md
@@ -1 +1,36 @@
-WIP...
\ No newline at end of file
+OrcaSlicer use `M141/M191` command to control active chamber heater.  
+If you are using Klipper, you can define these macros to control the active chamber heater.  
+Bellow is a reference configuration for Klipper.   
+*Note: Don't forget to change the pin name/values to the actual values you are using in the configuration*
+
+```
+[heater_generic chamber_heater]
+heater_pin:PB10
+max_power:1.0
+# Note: here the temperature sensor should be the sensor you are using for chamber temperature, not the PTC sensor
+sensor_type:NTC 100K MGB18-104F39050L32
+sensor_pin:PA1
+control = pid
+pid_Kp = 63.418 
+pid_ki = 0.960
+pid_kd = 1244.716
+min_temp:0
+max_temp:70
+
+[gcode_macro M141]
+gcode:
+    SET_HEATER_TEMPERATURE HEATER=chamber_heater TARGET={params.S|default(0)}
+
+[gcode_macro M191]
+gcode:
+    {% set s = params.S|float %}
+    {% if s == 0 %}
+        # If target temperature is 0, do nothing
+        M117 Chamber heating cancelled
+    {% else %}
+        SET_HEATER_TEMPERATURE HEATER=chamber_heater TARGET={s}
+        TEMPERATURE_WAIT SENSOR="heater_generic chamber_heater" MINIMUM={s-1} MAXIMUM={s+1}
+        M117 Chamber at target temperature
+    {% endif %}
+
+```
\ No newline at end of file
diff --git a/doc/air-filtration.md b/doc/air-filtration.md
index 6d3f66599c9..88eee29b2e1 100644
--- a/doc/air-filtration.md
+++ b/doc/air-filtration.md
@@ -1 +1,35 @@
-WIP
\ No newline at end of file
+OrcaSlicer use `M106 P3` command to control air-filtration/exhuast fan.
+
+If you are using Klipper, you can define a `M106` macro to control the both normal part cooling fan and auxiliary fan and exhuast fan.  
+Below is a reference configuration for Klipper.   
+*Note: Don't forget to change the pin name to the actual pin name you are using in the configuration*
+
+```
+# instead of using [fan], we define the default part cooling fan with [fan_generic] here
+# this is the default part cooling fan
+[fan_generic fan0]
+pin: PA7
+cycle_time: 0.01
+hardware_pwm: false
+
+# this is the auxiliary fan
+# comment out it if you don't have auxiliary fan
+[fan_generic fan2]
+pin: PA8
+cycle_time: 0.01
+hardware_pwm: false
+
+# this is the exhaust fan
+# comment out it if you don't have exhaust fan
+[fan_generic fan3]
+pin: PA9
+cycle_time: 0.01
+hardware_pwm: false
+
+[gcode_macro M106]
+gcode:
+    {% set fan = 'fan' + (params.P|int if params.P is defined else 0)|string %}
+    {% set speed = (params.S|int if params.S is defined else 255) %}
+    SET_FAN_SPEED FAN={fan} SPEED={speed}
+
+```