Updated Wiki content

printer_settings/Auxiliary-fan.md

@@ -0,0 +1,38 @@
+# Auxiliary Fan
+
+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 exhaust 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
+
+```ini
+# 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|float / 255 if params.S is defined else 1.0) %}
+    SET_FAN_SPEED FAN={fan} SPEED={speed}
+```

printer_settings/Chamber-temperature.md

@@ -0,0 +1,66 @@
+# Chamber Temperature Control
+
+OrcaSlicer use `M141/M191` command to control active chamber heater.
+
+If your Filament's `Activate temperature control` and your printer `Support control chamber temperature` option are checked , OrcaSlicer will insert `M191` command at the beginning of the gcode (before `Machine G-code`).
+
+![Chamber-Temperature-Control-Printer](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Chamber/Chamber-Temperature-Control-Printer.png?raw=true)
+![Chamber-Temperature-Control-Material](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Chamber/Chamber-Temperature-Control-Material.png?raw=true)
+
+
+> [!NOTE]
+> If the machine is equipped with an auxiliary fan, OrcaSlicer will automatically activate the fan during the heating period to help circulate air in the chamber.
+
+## Using Chamber Temperature Variables in Machine G-code
+
+You can use chamber temperature variables in your `Machine G-code` to control the chamber temperature manually, if desired:
+
+- To set the chamber temperature to the value specified for the first filament:
+  ```gcode
+  M191 S{chamber_temperature[0]}
+  ```
+- To set the chamber temperature to the highest value specified across all filaments:
+  ```gcode
+  M191 S{overall_chamber_temperature}
+  ```
+
+## Klipper
+
+If you are using Klipper, you can define these macros to control the active chamber heater.
+Bellow is a reference configuration for Klipper.
+
+> [!IMPORTANT]
+> Don't forget to change the pin name/values to the actual values you are using in the configuration.
+
+```gcode
+[heater_generic chamber_heater]
+heater_pin:PB10
+max_power:1.0
+# Orca 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}
+        # Orca: uncomment the following line if you want to use heat bed to assist chamber heating
+        # M140 S100
+        TEMPERATURE_WAIT SENSOR="heater_generic chamber_heater" MINIMUM={s-1} MAXIMUM={s+1}
+        M117 Chamber at target temperature
+    {% endif %}
+```

printer_settings/adaptive-bed-mesh.md

@@ -0,0 +1,57 @@
+# Adaptive Bed Mesh Support
+
+Orca Slicer introduces comprehensive support for adaptive bed meshing across a variety of firmware, including Marlin, Klipper, and RepRapFirmware (RRF).
+
+This feature allows users to seamlessly integrate adaptive bed mesh commands within the Machine Start G-code.
+
+The implementation is designed to be straightforward, requiring no additional plugins or alterations to firmware settings, thereby enhancing user experience and print quality directly from Orca Slicer.
+
+![ABM-PrinterConfig](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Adaptative-Bed-Mesh/ABM-PrinterConfig.png?raw=true)
+
+## Settings in Orca Slicer:
+
+`Bed mesh min`: This option sets the min point for the allowed bed mesh area. Due to the probe's XY offset, most printers are unable to probe the entire bed. To ensure the probe point does not go outside the bed area, the minimum and maximum points of the bed mesh should be set appropriately. OrcaSlicer ensures that adaptive_bed_mesh_min/adaptive_bed_mesh_max values do not exceed these min/max points. This information can usually be obtained from your printer manufacturer. The default setting is (-99999, -99999), which means there are no limits, thus allowing probing across the entire bed.
+
+`Bed mesh max`: This option sets the max point for the allowed bed mesh area. Due to the probe's XY offset, most printers are unable to probe the entire bed. To ensure the probe point does not go outside the bed area, the minimum and maximum points of the bed mesh should be set appropriately. OrcaSlicer ensures that adaptive_bed_mesh_min/adaptive_bed_mesh_max values do not exceed these min/max points. This information can usually be obtained from your printer manufacturer. The default setting is (99999, 99999), which means there are no limits, thus allowing probing across the entire bed.
+
+`Probe point distance`: This option sets the preferred distance between probe points (grid size) for the X and Y directions, with the default being 50mm for both X and Y.
+
+`Mesh margin`: This option determines the additional distance by which the adaptive bed mesh area should be expanded in the XY directions.
+
+> [!NOTE]
+> Klipper users: Orca Slicer will adjust adaptive bed mesh area according to the margin. It is recommended to set the margin to 0 in Klipper config or pass 0 when calling BED_MESH_CALIBRATE command(please refer to the example below).
+
+## Available g-code variables for Adaptive Bed Mesh Command
+
+`bed_mesh_probe_count`: Represents the probe count in the X and Y directions. This value is calculated based on the size of the adaptive bed mesh area and the distance between probe points.
+
+`adaptive_bed_mesh_min`: Specifies the minimum coordinates of the adaptive bed mesh area, defining the starting point of the mesh.
+
+`adaptive_bed_mesh_max`: Determines the maximum coordinates of the adaptive bed mesh area, indicating the endpoint of the mesh.
+
+`ALGORITHM`: Identifies the algorithm used for adaptive bed mesh interpolation. This variable is useful for Klipper users. If bed_mesh_probe_count is less than 4, the algorithm is set to `lagrange`. Otherwise, it is set to `bicubic`.
+
+## Example of Adaptive Bed Mesh usage in Orca Slicer:
+
+### Marlin:
+
+```gcode
+; Marlin don't support speicify the probe count yet, so we only specify the probe area
+G29 L{adaptive_bed_mesh_min[0]} R{adaptive_bed_mesh_max[0]} F{adaptive_bed_mesh_min[1]} B{adaptive_bed_mesh_max[1]} T V4
+```
+
+### Klipper:
+
+```gcode
+; Always pass `ADAPTIVE_MARGIN=0` because Orca has already handled `adaptive_bed_mesh_margin` internally
+; Make sure to set ADAPTIVE to 0 otherwise Klipper will use it's own adaptive bed mesh logic
+BED_MESH_CALIBRATE mesh_min={adaptive_bed_mesh_min[0]},{adaptive_bed_mesh_min[1]} mesh_max={adaptive_bed_mesh_max[0]},{adaptive_bed_mesh_max[1]} ALGORITHM=[bed_mesh_algo] PROBE_COUNT={bed_mesh_probe_count[0]},{bed_mesh_probe_count[1]} ADAPTIVE=0 ADAPTIVE_MARGIN=0
+```
+
+### RRF:
+
+```gcode
+M557 X{adaptive_bed_mesh_min[0]}:{adaptive_bed_mesh_max[0]} Y{adaptive_bed_mesh_min[1]}:{adaptive_bed_mesh_max[1]} P{bed_mesh_probe_count[0]}:{bed_mesh_probe_count[1]}
+```
+
+![ABM-Machine-G-code](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Adaptative-Bed-Mesh/ABM-Machine-G-code.png?raw=true)

printer_settings/air-filtration.md

@@ -0,0 +1,39 @@
+# Air Filtration/Exhaust Fan Control in OrcaSlicer
+
+OrcaSlicer use `M106 P3` command to control air-filtration/exhaust fan.
+
+If you are using Klipper, you can define a `M106` macro to control both the normal part cooling fan, auxiliary fan, and exhaust 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.
+
+```ini
+# 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|float / 255 if params.S is defined else 1.0) %}
+    SET_FAN_SPEED FAN={fan} SPEED={speed}
+```

printer_settings/bed-types.md

@@ -0,0 +1,28 @@
+# Multiple bed types
+
+You can enable it in printer settings.
+
+Once enabled, you can select the bed type in the drop-down menu, corresponding bed temperature will be set automatically.
+You can set the bed temperature for each bed type in the filament settings as demonstrated in the following image.
+
+![bed-types](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/bed-types.gif?raw=true)
+
+Orca also support `curr_bed_type` variable in custom G-code.
+For example, the following sample G-codes can detect the selected bed type and adjust the G-code offset accordingly for Klipper:
+
+```c++
+{if curr_bed_type=="Textured PEI Plate"}
+  SET_GCODE_OFFSET Z=-0.05
+{else}
+  SET_GCODE_OFFSET Z=0.0
+{endif}
+```
+
+available bed types are:
+
+```c++
+"Cool Plate"
+"Engineering Plate"
+"High Temp Plate"
+"Textured PEI Plate"
+```