68 lines
2.3 KiB
Python
68 lines
2.3 KiB
Python
from machine import Pin
|
|
import time
|
|
|
|
class HeaterController:
|
|
"""Control heater via opto-coupler relay."""
|
|
def __init__(self, relay_pin=16, min_run_time=300, min_off_time=180):
|
|
"""
|
|
relay_pin: GPIO pin connected to opto-coupler input
|
|
min_run_time: Minimum seconds heater must run before turning off (prevent short cycling)
|
|
min_off_time: Minimum seconds heater must be off before turning on (element protection)
|
|
"""
|
|
self.relay = Pin(relay_pin, Pin.OUT)
|
|
self.relay.off() # Start with heater off (relay normally open)
|
|
|
|
self.min_run_time = min_run_time
|
|
self.min_off_time = min_off_time
|
|
|
|
self.is_on = False
|
|
self.last_state_change = time.ticks_ms()
|
|
|
|
def turn_on(self):
|
|
"""Turn heater on if minimum off time has elapsed."""
|
|
if self.is_on:
|
|
return True # Already on
|
|
|
|
now = time.ticks_ms()
|
|
time_since_change = time.ticks_diff(now, self.last_state_change) / 1000
|
|
|
|
if time_since_change < self.min_off_time:
|
|
remaining = int(self.min_off_time - time_since_change)
|
|
print(f"Heater cooldown: {remaining}s remaining before can turn on")
|
|
return False
|
|
|
|
self.relay.on()
|
|
self.is_on = True
|
|
self.last_state_change = now
|
|
print("Heater turned ON")
|
|
return True
|
|
|
|
def turn_off(self):
|
|
"""Turn heater off if minimum run time has elapsed."""
|
|
if not self.is_on:
|
|
return True # Already off
|
|
|
|
now = time.ticks_ms()
|
|
time_since_change = time.ticks_diff(now, self.last_state_change) / 1000
|
|
|
|
if time_since_change < self.min_run_time:
|
|
remaining = int(self.min_run_time - time_since_change)
|
|
print(f"Heater minimum runtime: {remaining}s remaining before can turn off")
|
|
return False
|
|
|
|
self.relay.off()
|
|
self.is_on = False
|
|
self.last_state_change = now
|
|
print("Heater turned OFF")
|
|
return True
|
|
|
|
def get_state(self):
|
|
"""Return current heater state."""
|
|
return self.is_on
|
|
|
|
def force_off(self):
|
|
"""Emergency shut off (bypasses timers)."""
|
|
self.relay.off()
|
|
self.is_on = False
|
|
self.last_state_change = time.ticks_ms()
|
|
print("Heater FORCE OFF") |