smart_plug.py 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142
  1. from datetime import datetime
  2. from typing import Literal
  3. from pydantic import BaseModel, Field, model_validator
  4. class SmartPlugBase(BaseModel):
  5. name: str = Field(..., min_length=1, max_length=100)
  6. plug_type: Literal["tasmota", "homeassistant"] = "tasmota"
  7. # Tasmota fields (required when plug_type="tasmota")
  8. ip_address: str | None = Field(default=None, pattern=r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$")
  9. username: str | None = None
  10. password: str | None = None
  11. # Home Assistant fields (required when plug_type="homeassistant")
  12. ha_entity_id: str | None = Field(default=None, pattern=r"^(switch|light|input_boolean)\.[a-z0-9_]+$")
  13. printer_id: int | None = None
  14. enabled: bool = True
  15. auto_on: bool = True
  16. auto_off: bool = True
  17. off_delay_mode: Literal["time", "temperature"] = "time"
  18. off_delay_minutes: int = Field(default=5, ge=0, le=60)
  19. off_temp_threshold: int = Field(default=70, ge=30, le=150)
  20. # Power alerts
  21. power_alert_enabled: bool = False
  22. power_alert_high: float | None = Field(default=None, ge=0, le=5000) # Alert when power > this (watts)
  23. power_alert_low: float | None = Field(default=None, ge=0, le=5000) # Alert when power < this (watts)
  24. # Schedule
  25. schedule_enabled: bool = False
  26. schedule_on_time: str | None = Field(default=None, pattern=r"^([01]\d|2[0-3]):[0-5]\d$") # HH:MM format
  27. schedule_off_time: str | None = Field(default=None, pattern=r"^([01]\d|2[0-3]):[0-5]\d$") # HH:MM format
  28. # Switchbar visibility
  29. show_in_switchbar: bool = False
  30. @model_validator(mode="after")
  31. def validate_plug_type_fields(self) -> "SmartPlugBase":
  32. if self.plug_type == "tasmota" and not self.ip_address:
  33. raise ValueError("ip_address is required for Tasmota plugs")
  34. if self.plug_type == "homeassistant" and not self.ha_entity_id:
  35. raise ValueError("ha_entity_id is required for Home Assistant plugs")
  36. return self
  37. class SmartPlugCreate(SmartPlugBase):
  38. pass
  39. class SmartPlugUpdate(BaseModel):
  40. name: str | None = None
  41. plug_type: Literal["tasmota", "homeassistant"] | None = None
  42. ip_address: str | None = None
  43. ha_entity_id: str | None = None
  44. printer_id: int | None = None
  45. enabled: bool | None = None
  46. auto_on: bool | None = None
  47. auto_off: bool | None = None
  48. off_delay_mode: Literal["time", "temperature"] | None = None
  49. off_delay_minutes: int | None = Field(default=None, ge=0, le=60)
  50. off_temp_threshold: int | None = Field(default=None, ge=30, le=150)
  51. username: str | None = None
  52. password: str | None = None
  53. # Power alerts
  54. power_alert_enabled: bool | None = None
  55. power_alert_high: float | None = Field(default=None, ge=0, le=5000)
  56. power_alert_low: float | None = Field(default=None, ge=0, le=5000)
  57. # Schedule
  58. schedule_enabled: bool | None = None
  59. schedule_on_time: str | None = Field(default=None, pattern=r"^([01]\d|2[0-3]):[0-5]\d$")
  60. schedule_off_time: str | None = Field(default=None, pattern=r"^([01]\d|2[0-3]):[0-5]\d$")
  61. # Switchbar visibility
  62. show_in_switchbar: bool | None = None
  63. class SmartPlugResponse(SmartPlugBase):
  64. id: int
  65. last_state: str | None = None
  66. last_checked: datetime | None = None
  67. auto_off_executed: bool = False # True when auto-off was triggered after print
  68. power_alert_last_triggered: datetime | None = None
  69. created_at: datetime
  70. updated_at: datetime
  71. class Config:
  72. from_attributes = True
  73. class SmartPlugControl(BaseModel):
  74. action: Literal["on", "off", "toggle"]
  75. class SmartPlugEnergy(BaseModel):
  76. """Energy monitoring data from a smart plug."""
  77. power: float | None = None # Current watts
  78. voltage: float | None = None # Volts
  79. current: float | None = None # Amps
  80. today: float | None = None # kWh used today
  81. yesterday: float | None = None # kWh used yesterday
  82. total: float | None = None # Total kWh
  83. factor: float | None = None # Power factor (0-1)
  84. apparent_power: float | None = None # VA
  85. reactive_power: float | None = None # VAr
  86. class SmartPlugStatus(BaseModel):
  87. state: str | None = None # "ON", "OFF", or None if unreachable
  88. reachable: bool = True
  89. device_name: str | None = None
  90. energy: SmartPlugEnergy | None = None # Energy data if available
  91. class SmartPlugTestConnection(BaseModel):
  92. ip_address: str = Field(..., pattern=r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$")
  93. username: str | None = None
  94. password: str | None = None
  95. # Home Assistant schemas
  96. class HATestConnectionRequest(BaseModel):
  97. """Request to test Home Assistant connection."""
  98. url: str = Field(..., min_length=1)
  99. token: str = Field(..., min_length=1)
  100. class HATestConnectionResponse(BaseModel):
  101. """Response from HA connection test."""
  102. success: bool
  103. message: str | None = None
  104. error: str | None = None
  105. class HAEntity(BaseModel):
  106. """A Home Assistant entity that can be used as a smart plug."""
  107. entity_id: str
  108. friendly_name: str
  109. state: str | None = None
  110. domain: str # "switch", "light", "input_boolean"