Program structure

Preparing programs

Preparing a program is easy. Programs are plain text files with comments and step data.

Comments

You can write as many comment lines as you want - they must start with #. The first comment line is treated as the short program description - make it brief and meaningful.

You can also add inline comments after a step line:

120:10:10 # This is an inline comment

Program steps

Each line of the program represents a single step, with three numbers separated by colons:

target_temp_C : ramp_minutes : dwell_minutes

• target_temp_C - target temperature in Celsius to reach in this step
• ramp_minutes - how long (in minutes) to take to reach the target temperature
• dwell_minutes - how long (in minutes) to hold at the target temperature

Both time values can be 0, but all three fields must be present.

Maximum temperature: 1350°C (enforced by MAX_Temperature in preferences).

Example program:

# Short, clear description of the program.
# Full description on as many lines you wish -
#   just remember the default program limit is 10KiB
# Format: target_temp_C:ramp_minutes:dwell_minutes
95:30:20
134:20:30
# You can add as many comments as you wish
97:80:30
360:180:20
600:100:30 # You can even comment each line
970:120:50
600:90:0 # Ramp down - dwell of 0 means move on immediately

By default, programs are limited to 10KiB and 40 steps. Both limits can be changed in ESP32Kiln.h.

Operating on programs

You can place programs directly in the data/programs/ directory and upload them to SPIFFS along with other data. You can also upload programs through the web interface (Profiles page).

Once a program is uploaded, you can browse, delete, or load it from either the LCD menu or the web interface. When you load a program it is copied into run memory - changes to the file on disk after loading do not affect the running program.