smart_plug.py 3.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. from datetime import datetime
  2. from sqlalchemy import Boolean, DateTime, Float, ForeignKey, Integer, String, func
  3. from sqlalchemy.orm import Mapped, mapped_column, relationship
  4. from backend.app.core.database import Base
  5. class SmartPlug(Base):
  6. """Smart plug for printer power control (Tasmota or Home Assistant)."""
  7. __tablename__ = "smart_plugs"
  8. id: Mapped[int] = mapped_column(primary_key=True)
  9. name: Mapped[str] = mapped_column(String(100))
  10. ip_address: Mapped[str | None] = mapped_column(String(45), nullable=True) # IPv4/IPv6 (required for Tasmota)
  11. # Plug type: "tasmota" (default) or "homeassistant"
  12. plug_type: Mapped[str] = mapped_column(String(20), default="tasmota")
  13. # Home Assistant entity ID (e.g., "switch.printer_plug")
  14. ha_entity_id: Mapped[str | None] = mapped_column(String(100), nullable=True)
  15. # Home Assistant energy sensor entities (optional, for separate energy sensors)
  16. ha_power_entity: Mapped[str | None] = mapped_column(String(100), nullable=True) # sensor.xxx_power
  17. ha_energy_today_entity: Mapped[str | None] = mapped_column(String(100), nullable=True) # sensor.xxx_today
  18. ha_energy_total_entity: Mapped[str | None] = mapped_column(String(100), nullable=True) # sensor.xxx_total
  19. # Link to printer (1:1)
  20. printer_id: Mapped[int | None] = mapped_column(
  21. ForeignKey("printers.id", ondelete="SET NULL"), unique=True, nullable=True
  22. )
  23. # Automation settings
  24. enabled: Mapped[bool] = mapped_column(Boolean, default=True)
  25. auto_on: Mapped[bool] = mapped_column(Boolean, default=True) # Turn on at print start
  26. auto_off: Mapped[bool] = mapped_column(Boolean, default=True) # Turn off at print complete/fail
  27. # Turn-off delay mode: "time" or "temperature"
  28. off_delay_mode: Mapped[str] = mapped_column(String(20), default="time")
  29. off_delay_minutes: Mapped[int] = mapped_column(Integer, default=5) # For time mode
  30. off_temp_threshold: Mapped[int] = mapped_column(Integer, default=70) # For temp mode (°C)
  31. # Optional auth (some Tasmota configs require it)
  32. username: Mapped[str | None] = mapped_column(String(50), nullable=True)
  33. password: Mapped[str | None] = mapped_column(String(100), nullable=True)
  34. # Power alerts
  35. power_alert_enabled: Mapped[bool] = mapped_column(Boolean, default=False)
  36. power_alert_high: Mapped[float | None] = mapped_column(Float, nullable=True) # Alert when power > this (watts)
  37. power_alert_low: Mapped[float | None] = mapped_column(Float, nullable=True) # Alert when power < this (watts)
  38. power_alert_last_triggered: Mapped[datetime | None] = mapped_column(DateTime, nullable=True) # Cooldown tracking
  39. # Schedule (time-based on/off)
  40. schedule_enabled: Mapped[bool] = mapped_column(Boolean, default=False)
  41. schedule_on_time: Mapped[str | None] = mapped_column(String(5), nullable=True) # "HH:MM" format
  42. schedule_off_time: Mapped[str | None] = mapped_column(String(5), nullable=True) # "HH:MM" format
  43. # Switchbar visibility
  44. show_in_switchbar: Mapped[bool] = mapped_column(Boolean, default=False)
  45. # Status tracking
  46. last_state: Mapped[str | None] = mapped_column(String(10), nullable=True) # "ON"/"OFF"
  47. last_checked: Mapped[datetime | None] = mapped_column(DateTime, nullable=True)
  48. auto_off_executed: Mapped[bool] = mapped_column(Boolean, default=False) # True when auto-off was triggered
  49. auto_off_pending: Mapped[bool] = mapped_column(Boolean, default=False) # True when waiting for cooldown
  50. auto_off_pending_since: Mapped[datetime | None] = mapped_column(
  51. DateTime, nullable=True
  52. ) # When auto-off was scheduled
  53. # Timestamps
  54. created_at: Mapped[datetime] = mapped_column(DateTime, server_default=func.now())
  55. updated_at: Mapped[datetime] = mapped_column(DateTime, server_default=func.now(), onupdate=func.now())
  56. # Relationship
  57. printer: Mapped["Printer"] = relationship(back_populates="smart_plug")
  58. from backend.app.models.printer import Printer # noqa: E402