smart_plugs.py 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843
  1. """API routes for smart plug management."""
  2. import logging
  3. from datetime import datetime, timedelta, timezone
  4. from fastapi import APIRouter, Body, Depends, HTTPException
  5. from pydantic import BaseModel
  6. from sqlalchemy import select
  7. from sqlalchemy.ext.asyncio import AsyncSession
  8. from backend.app.api.routes.settings import get_setting
  9. from backend.app.core.auth import RequirePermissionIfAuthEnabled
  10. from backend.app.core.database import get_db
  11. from backend.app.core.permissions import Permission
  12. from backend.app.models.printer import Printer
  13. from backend.app.models.smart_plug import SmartPlug
  14. from backend.app.models.user import User
  15. from backend.app.schemas.smart_plug import (
  16. HAEntity,
  17. HASensorEntity,
  18. HATestConnectionRequest,
  19. HATestConnectionResponse,
  20. RESTTestConnectionRequest,
  21. RESTTestConnectionResponse,
  22. SmartPlugControl,
  23. SmartPlugCreate,
  24. SmartPlugEnergy,
  25. SmartPlugResponse,
  26. SmartPlugStatus,
  27. SmartPlugTestConnection,
  28. SmartPlugUpdate,
  29. )
  30. from backend.app.services.discovery import tasmota_scanner
  31. from backend.app.services.homeassistant import homeassistant_service
  32. from backend.app.services.mqtt_relay import mqtt_relay
  33. from backend.app.services.notification_service import notification_service
  34. from backend.app.services.printer_manager import printer_manager
  35. from backend.app.services.rest_smart_plug import rest_smart_plug_service
  36. from backend.app.services.tasmota import tasmota_service
  37. logger = logging.getLogger(__name__)
  38. router = APIRouter(prefix="/smart-plugs", tags=["smart-plugs"])
  39. @router.get("/", response_model=list[SmartPlugResponse])
  40. async def list_smart_plugs(
  41. db: AsyncSession = Depends(get_db),
  42. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  43. ):
  44. """List all smart plugs."""
  45. result = await db.execute(select(SmartPlug).order_by(SmartPlug.name))
  46. return list(result.scalars().all())
  47. @router.post("/", response_model=SmartPlugResponse)
  48. async def create_smart_plug(
  49. data: SmartPlugCreate,
  50. db: AsyncSession = Depends(get_db),
  51. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_CREATE),
  52. ):
  53. """Create a new smart plug."""
  54. # Validate printer_id if provided
  55. if data.printer_id:
  56. result = await db.execute(select(Printer).where(Printer.id == data.printer_id))
  57. if not result.scalar_one_or_none():
  58. raise HTTPException(400, "Printer not found")
  59. # Check if printer already has a plug assigned
  60. # Tasmota plugs: only one per printer (physical power device)
  61. # HA entities: allow multiple per printer (for different automations)
  62. if data.plug_type == "tasmota":
  63. result = await db.execute(
  64. select(SmartPlug).where(
  65. SmartPlug.printer_id == data.printer_id,
  66. SmartPlug.plug_type == "tasmota",
  67. )
  68. )
  69. if result.scalar_one_or_none():
  70. raise HTTPException(400, "This printer already has a Tasmota plug assigned")
  71. # For MQTT plugs, ensure MQTT broker is configured and service is connected
  72. if data.plug_type == "mqtt":
  73. # Try to configure the smart plug service if not already configured
  74. if not mqtt_relay.smart_plug_service.is_configured():
  75. # Get MQTT broker settings from database
  76. mqtt_broker = await get_setting(db, "mqtt_broker") or ""
  77. if not mqtt_broker:
  78. raise HTTPException(
  79. 400,
  80. "MQTT broker not configured. Please set MQTT broker address in Settings → Network → MQTT Publishing.",
  81. )
  82. # Configure the smart plug service with broker settings
  83. mqtt_settings = {
  84. "mqtt_enabled": True, # Enable for smart plug subscription
  85. "mqtt_broker": mqtt_broker,
  86. "mqtt_port": int(await get_setting(db, "mqtt_port") or "1883"),
  87. "mqtt_username": await get_setting(db, "mqtt_username") or "",
  88. "mqtt_password": await get_setting(db, "mqtt_password") or "",
  89. "mqtt_use_tls": (await get_setting(db, "mqtt_use_tls") or "false") == "true",
  90. }
  91. await mqtt_relay.smart_plug_service.configure(mqtt_settings)
  92. # Check if connection succeeded
  93. if not mqtt_relay.smart_plug_service.is_configured():
  94. raise HTTPException(
  95. 400,
  96. f"Failed to connect to MQTT broker at {mqtt_broker}. Please check your MQTT settings.",
  97. )
  98. plug_data = data.model_dump()
  99. # For HA entities, default auto_on and auto_off to False
  100. # (they're for automations, not power control like Tasmota plugs)
  101. if data.plug_type == "homeassistant":
  102. plug_data["auto_on"] = False
  103. plug_data["auto_off"] = False
  104. plug = SmartPlug(**plug_data)
  105. db.add(plug)
  106. await db.commit()
  107. await db.refresh(plug)
  108. # Subscribe MQTT plugs to their topics
  109. if plug.plug_type == "mqtt":
  110. # Determine effective topics (new fields take priority, fall back to legacy)
  111. power_topic = plug.mqtt_power_topic or plug.mqtt_topic
  112. energy_topic = plug.mqtt_energy_topic
  113. state_topic = plug.mqtt_state_topic
  114. # Only subscribe if at least one topic is configured
  115. if power_topic or energy_topic or state_topic:
  116. mqtt_relay.smart_plug_service.subscribe(
  117. plug_id=plug.id,
  118. # Power source (path is optional)
  119. power_topic=power_topic,
  120. power_path=plug.mqtt_power_path,
  121. power_multiplier=plug.mqtt_power_multiplier or plug.mqtt_multiplier or 1.0,
  122. # Energy source (path is optional)
  123. energy_topic=energy_topic,
  124. energy_path=plug.mqtt_energy_path,
  125. energy_multiplier=plug.mqtt_energy_multiplier or plug.mqtt_multiplier or 1.0,
  126. # State source (path is optional)
  127. state_topic=state_topic,
  128. state_path=plug.mqtt_state_path,
  129. state_on_value=plug.mqtt_state_on_value,
  130. )
  131. topics = [t for t in [power_topic, energy_topic, state_topic] if t]
  132. logger.info("Created MQTT plug '%s' subscribed to %s", plug.name, ", ".join(set(topics)))
  133. elif plug.plug_type == "homeassistant":
  134. logger.info("Created Home Assistant plug '%s' (%s)", plug.name, plug.ha_entity_id)
  135. else:
  136. logger.info("Created Tasmota plug '%s' at %s", plug.name, plug.ip_address)
  137. return plug
  138. @router.get("/by-printer/{printer_id}", response_model=SmartPlugResponse | None)
  139. async def get_smart_plug_by_printer(
  140. printer_id: int,
  141. db: AsyncSession = Depends(get_db),
  142. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  143. ):
  144. """Get the main smart plug assigned to a printer.
  145. When multiple plugs are assigned (e.g., a regular plug + script),
  146. returns the main (non-script) plug for power control.
  147. """
  148. result = await db.execute(select(SmartPlug).where(SmartPlug.printer_id == printer_id))
  149. plugs = result.scalars().all()
  150. if not plugs:
  151. return None
  152. # If multiple plugs, prefer the non-script one (main power plug)
  153. for plug in plugs:
  154. is_script = plug.plug_type == "homeassistant" and plug.ha_entity_id and plug.ha_entity_id.startswith("script.")
  155. if not is_script:
  156. return plug
  157. # All are scripts, return the first one
  158. return plugs[0]
  159. @router.get("/by-printer/{printer_id}/scripts", response_model=list[SmartPlugResponse])
  160. async def get_script_plugs_by_printer(
  161. printer_id: int,
  162. db: AsyncSession = Depends(get_db),
  163. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  164. ):
  165. """Get all HA entities assigned to a printer for display on printer card.
  166. Returns HA entities (switches, scripts, lights, etc.) for the printer that have
  167. show_on_printer_card enabled.
  168. Used to display action buttons alongside the main power plug.
  169. """
  170. result = await db.execute(select(SmartPlug).where(SmartPlug.printer_id == printer_id))
  171. plugs = result.scalars().all()
  172. # Filter to HA entities with show_on_printer_card enabled
  173. ha_entities = [
  174. plug for plug in plugs if plug.plug_type == "homeassistant" and plug.ha_entity_id and plug.show_on_printer_card
  175. ]
  176. return ha_entities
  177. # Tasmota Discovery Endpoints
  178. # NOTE: These must be defined BEFORE /{plug_id} routes to avoid path conflicts
  179. class TasmotaScanRequest(BaseModel):
  180. """Request to scan for Tasmota devices."""
  181. from_ip: str | None = None # Starting IP (auto-detected if not provided)
  182. to_ip: str | None = None # Ending IP (auto-detected if not provided)
  183. timeout: float = 1.0 # Connection timeout per host
  184. def get_local_network_range() -> tuple[str, str]:
  185. """Auto-detect local network and return IP range to scan."""
  186. import socket
  187. try:
  188. # Get local IP by connecting to a public DNS (doesn't actually send data)
  189. s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
  190. s.connect(("8.8.8.8", 80))
  191. local_ip = s.getsockname()[0]
  192. s.close()
  193. # Parse IP and create range (assume /24 subnet)
  194. parts = local_ip.split(".")
  195. base = ".".join(parts[:3])
  196. from_ip = f"{base}.1"
  197. to_ip = f"{base}.254"
  198. logger.info("Auto-detected network: %s - %s (local IP: %s)", from_ip, to_ip, local_ip)
  199. return from_ip, to_ip
  200. except OSError as e:
  201. logger.error("Failed to detect local network: %s", e)
  202. # Fallback to common home network
  203. return "192.168.1.1", "192.168.1.254"
  204. class TasmotaScanStatus(BaseModel):
  205. """Tasmota scan status response."""
  206. running: bool
  207. scanned: int
  208. total: int
  209. class DiscoveredTasmotaDevice(BaseModel):
  210. """Discovered Tasmota device."""
  211. ip_address: str
  212. name: str
  213. module: int | None = None
  214. state: str | None = None
  215. discovered_at: str | None = None
  216. @router.post("/discover/scan", response_model=TasmotaScanStatus)
  217. async def start_tasmota_scan(
  218. request: TasmotaScanRequest | None = Body(default=None),
  219. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  220. ):
  221. """Start an IP range scan for Tasmota devices.
  222. Auto-detects local network if no IP range provided.
  223. """
  224. import asyncio
  225. # Auto-detect network
  226. from_ip, to_ip = get_local_network_range()
  227. timeout = request.timeout if request else 1.0
  228. # Start scan in background
  229. asyncio.create_task(tasmota_scanner.scan_range(from_ip, to_ip, timeout))
  230. # Return immediate status
  231. scanned, total = tasmota_scanner.progress
  232. return TasmotaScanStatus(
  233. running=tasmota_scanner.is_running,
  234. scanned=scanned,
  235. total=total,
  236. )
  237. @router.get("/discover/status", response_model=TasmotaScanStatus)
  238. async def get_tasmota_scan_status(
  239. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  240. ):
  241. """Get the current Tasmota scan status."""
  242. scanned, total = tasmota_scanner.progress
  243. return TasmotaScanStatus(
  244. running=tasmota_scanner.is_running,
  245. scanned=scanned,
  246. total=total,
  247. )
  248. @router.post("/discover/stop", response_model=TasmotaScanStatus)
  249. async def stop_tasmota_scan(
  250. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  251. ):
  252. """Stop the current Tasmota scan."""
  253. tasmota_scanner.stop()
  254. scanned, total = tasmota_scanner.progress
  255. return TasmotaScanStatus(
  256. running=tasmota_scanner.is_running,
  257. scanned=scanned,
  258. total=total,
  259. )
  260. @router.get("/discover/devices", response_model=list[DiscoveredTasmotaDevice])
  261. async def get_discovered_tasmota_devices(
  262. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  263. ):
  264. """Get list of discovered Tasmota devices."""
  265. return [
  266. DiscoveredTasmotaDevice(
  267. ip_address=d["ip_address"],
  268. name=d["name"],
  269. module=d.get("module"),
  270. state=d.get("state"),
  271. discovered_at=d.get("discovered_at"),
  272. )
  273. for d in tasmota_scanner.discovered_devices
  274. ]
  275. # Home Assistant Discovery Endpoints
  276. @router.post("/ha/test-connection", response_model=HATestConnectionResponse)
  277. async def test_ha_connection(
  278. request: HATestConnectionRequest,
  279. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_CONTROL),
  280. ):
  281. """Test connection to Home Assistant."""
  282. result = await homeassistant_service.test_connection(request.url, request.token)
  283. return HATestConnectionResponse(**result)
  284. @router.post("/rest/test-connection", response_model=RESTTestConnectionResponse)
  285. async def test_rest_connection(
  286. request: RESTTestConnectionRequest,
  287. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_CONTROL),
  288. ):
  289. """Test connection to a REST/HTTP endpoint."""
  290. result = await rest_smart_plug_service.test_connection(request.url, request.method, request.headers)
  291. return RESTTestConnectionResponse(**result)
  292. @router.get("/ha/entities", response_model=list[HAEntity])
  293. async def list_ha_entities(
  294. db: AsyncSession = Depends(get_db),
  295. search: str | None = None,
  296. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  297. ):
  298. """List available Home Assistant entities.
  299. By default, returns switch/light/input_boolean entities.
  300. When search is provided, searches ALL entities by entity_id or friendly_name.
  301. Requires HA connection settings to be configured in Settings.
  302. """
  303. from backend.app.api.routes.settings import get_homeassistant_settings
  304. ha_settings = await get_homeassistant_settings(db)
  305. ha_url = ha_settings["ha_url"]
  306. ha_token = ha_settings["ha_token"]
  307. if not ha_url or not ha_token:
  308. raise HTTPException(
  309. 400, "Home Assistant not configured. Please set HA URL and token in Settings → Network → Home Assistant."
  310. )
  311. entities = await homeassistant_service.list_entities(ha_url, ha_token, search)
  312. return [HAEntity(**e) for e in entities]
  313. @router.get("/ha/sensors", response_model=list[HASensorEntity])
  314. async def list_ha_sensor_entities(
  315. db: AsyncSession = Depends(get_db),
  316. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  317. ):
  318. """List available Home Assistant sensor entities for energy monitoring.
  319. Returns sensors with power/energy units (W, kW, kWh, Wh).
  320. Requires HA connection settings to be configured in Settings.
  321. """
  322. from backend.app.api.routes.settings import get_homeassistant_settings
  323. ha_settings = await get_homeassistant_settings(db)
  324. ha_url = ha_settings["ha_url"]
  325. ha_token = ha_settings["ha_token"]
  326. if not ha_url or not ha_token:
  327. raise HTTPException(
  328. 400, "Home Assistant not configured. Please set HA URL and token in Settings → Network → Home Assistant."
  329. )
  330. sensors = await homeassistant_service.list_sensor_entities(ha_url, ha_token)
  331. return [HASensorEntity(**s) for s in sensors]
  332. @router.get("/{plug_id}", response_model=SmartPlugResponse)
  333. async def get_smart_plug(
  334. plug_id: int,
  335. db: AsyncSession = Depends(get_db),
  336. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  337. ):
  338. """Get a specific smart plug."""
  339. result = await db.execute(select(SmartPlug).where(SmartPlug.id == plug_id))
  340. plug = result.scalar_one_or_none()
  341. if not plug:
  342. raise HTTPException(404, "Smart plug not found")
  343. return plug
  344. @router.patch("/{plug_id}", response_model=SmartPlugResponse)
  345. async def update_smart_plug(
  346. plug_id: int,
  347. data: SmartPlugUpdate,
  348. db: AsyncSession = Depends(get_db),
  349. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_UPDATE),
  350. ):
  351. """Update a smart plug."""
  352. result = await db.execute(select(SmartPlug).where(SmartPlug.id == plug_id))
  353. plug = result.scalar_one_or_none()
  354. if not plug:
  355. raise HTTPException(404, "Smart plug not found")
  356. update_data = data.model_dump(exclude_unset=True)
  357. # Validate new printer_id if being changed
  358. if "printer_id" in update_data and update_data["printer_id"]:
  359. new_printer_id = update_data["printer_id"]
  360. # Check printer exists
  361. result = await db.execute(select(Printer).where(Printer.id == new_printer_id))
  362. if not result.scalar_one_or_none():
  363. raise HTTPException(400, "Printer not found")
  364. # Check if that printer already has a different Tasmota plug assigned
  365. # Tasmota plugs: only one per printer (physical power device)
  366. # HA entities: allow multiple per printer (for different automations)
  367. new_plug_type = update_data.get("plug_type", plug.plug_type)
  368. if new_plug_type == "tasmota":
  369. result = await db.execute(
  370. select(SmartPlug).where(
  371. SmartPlug.printer_id == new_printer_id,
  372. SmartPlug.id != plug_id,
  373. SmartPlug.plug_type == "tasmota",
  374. )
  375. )
  376. if result.scalar_one_or_none():
  377. raise HTTPException(400, "This printer already has a Tasmota plug assigned")
  378. # Track old MQTT settings for comparison
  379. old_plug_type = plug.plug_type
  380. old_mqtt_config = {
  381. "power_topic": plug.mqtt_power_topic or plug.mqtt_topic,
  382. "power_path": plug.mqtt_power_path,
  383. "power_multiplier": plug.mqtt_power_multiplier,
  384. "energy_topic": plug.mqtt_energy_topic or plug.mqtt_topic,
  385. "energy_path": plug.mqtt_energy_path,
  386. "energy_multiplier": plug.mqtt_energy_multiplier,
  387. "state_topic": plug.mqtt_state_topic or plug.mqtt_topic,
  388. "state_path": plug.mqtt_state_path,
  389. "state_on_value": plug.mqtt_state_on_value,
  390. }
  391. for field, value in update_data.items():
  392. setattr(plug, field, value)
  393. await db.commit()
  394. await db.refresh(plug)
  395. # Handle MQTT subscription changes
  396. if old_plug_type == "mqtt" and plug.plug_type != "mqtt":
  397. # Changed away from MQTT - unsubscribe
  398. mqtt_relay.smart_plug_service.unsubscribe(plug.id)
  399. elif plug.plug_type == "mqtt":
  400. # Check if any MQTT config changed
  401. new_mqtt_config = {
  402. "power_topic": plug.mqtt_power_topic or plug.mqtt_topic,
  403. "power_path": plug.mqtt_power_path,
  404. "power_multiplier": plug.mqtt_power_multiplier,
  405. "energy_topic": plug.mqtt_energy_topic or plug.mqtt_topic,
  406. "energy_path": plug.mqtt_energy_path,
  407. "energy_multiplier": plug.mqtt_energy_multiplier,
  408. "state_topic": plug.mqtt_state_topic or plug.mqtt_topic,
  409. "state_path": plug.mqtt_state_path,
  410. "state_on_value": plug.mqtt_state_on_value,
  411. }
  412. mqtt_changed = old_plug_type != "mqtt" or old_mqtt_config != new_mqtt_config
  413. if mqtt_changed:
  414. # Unsubscribe from old topics first
  415. if old_plug_type == "mqtt":
  416. mqtt_relay.smart_plug_service.unsubscribe(plug.id)
  417. # Subscribe to new topics
  418. power_topic = plug.mqtt_power_topic or plug.mqtt_topic
  419. energy_topic = plug.mqtt_energy_topic
  420. state_topic = plug.mqtt_state_topic
  421. # Only subscribe if at least one topic is configured
  422. if power_topic or energy_topic or state_topic:
  423. mqtt_relay.smart_plug_service.subscribe(
  424. plug_id=plug.id,
  425. # Power source (path is optional)
  426. power_topic=power_topic,
  427. power_path=plug.mqtt_power_path,
  428. power_multiplier=plug.mqtt_power_multiplier or plug.mqtt_multiplier or 1.0,
  429. # Energy source (path is optional)
  430. energy_topic=energy_topic,
  431. energy_path=plug.mqtt_energy_path,
  432. energy_multiplier=plug.mqtt_energy_multiplier or plug.mqtt_multiplier or 1.0,
  433. # State source (path is optional)
  434. state_topic=state_topic,
  435. state_path=plug.mqtt_state_path,
  436. state_on_value=plug.mqtt_state_on_value,
  437. )
  438. logger.info("Updated smart plug '%s'", plug.name)
  439. return plug
  440. @router.delete("/{plug_id}")
  441. async def delete_smart_plug(
  442. plug_id: int,
  443. db: AsyncSession = Depends(get_db),
  444. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_DELETE),
  445. ):
  446. """Delete a smart plug."""
  447. result = await db.execute(select(SmartPlug).where(SmartPlug.id == plug_id))
  448. plug = result.scalar_one_or_none()
  449. if not plug:
  450. raise HTTPException(404, "Smart plug not found")
  451. plug_name = plug.name
  452. plug_type = plug.plug_type
  453. # Unsubscribe MQTT plug before deletion
  454. if plug_type == "mqtt":
  455. mqtt_relay.smart_plug_service.unsubscribe(plug_id)
  456. await db.delete(plug)
  457. await db.commit()
  458. logger.info("Deleted smart plug '%s'", plug_name)
  459. return {"message": "Smart plug deleted"}
  460. async def _get_service_for_plug(plug: SmartPlug, db: AsyncSession):
  461. """Get the appropriate service for the plug type.
  462. For HA plugs, configures the service with current settings from DB.
  463. """
  464. if plug.plug_type == "homeassistant":
  465. # Configure HA service with current settings
  466. from backend.app.api.routes.settings import get_homeassistant_settings
  467. ha_settings = await get_homeassistant_settings(db)
  468. homeassistant_service.configure(ha_settings["ha_url"], ha_settings["ha_token"])
  469. return homeassistant_service
  470. if plug.plug_type == "rest":
  471. return rest_smart_plug_service
  472. return tasmota_service
  473. @router.post("/{plug_id}/control")
  474. async def control_smart_plug(
  475. plug_id: int,
  476. control: SmartPlugControl,
  477. db: AsyncSession = Depends(get_db),
  478. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_CONTROL),
  479. ):
  480. """Manual control: on/off/toggle."""
  481. result = await db.execute(select(SmartPlug).where(SmartPlug.id == plug_id))
  482. plug = result.scalar_one_or_none()
  483. if not plug:
  484. raise HTTPException(404, "Smart plug not found")
  485. # MQTT plugs are monitor-only - cannot control them
  486. if plug.plug_type == "mqtt":
  487. raise HTTPException(
  488. 400,
  489. "MQTT plugs are monitor-only. Use your MQTT broker or home automation system to control them.",
  490. )
  491. service = await _get_service_for_plug(plug, db)
  492. if control.action == "on":
  493. success = await service.turn_on(plug)
  494. expected_state = "ON"
  495. elif control.action == "off":
  496. success = await service.turn_off(plug)
  497. expected_state = "OFF"
  498. elif control.action == "toggle":
  499. success = await service.toggle(plug)
  500. expected_state = None # Unknown after toggle
  501. else:
  502. raise HTTPException(400, f"Invalid action: {control.action}")
  503. if not success:
  504. raise HTTPException(503, "Failed to communicate with device")
  505. # Update last state and reset auto_off_executed when turning on
  506. if expected_state:
  507. plug.last_state = expected_state
  508. if expected_state == "ON":
  509. plug.auto_off_executed = False # Reset flag when manually turning on
  510. elif expected_state == "OFF" and plug.printer_id:
  511. # Mark printer offline immediately for faster UI update
  512. printer_manager.mark_printer_offline(plug.printer_id)
  513. plug.last_checked = datetime.now(timezone.utc)
  514. await db.commit()
  515. # Trigger associated scripts if this is a main (non-script) plug
  516. is_main_plug = not (
  517. plug.plug_type == "homeassistant" and plug.ha_entity_id and plug.ha_entity_id.startswith("script.")
  518. )
  519. if is_main_plug and plug.printer_id and expected_state:
  520. await trigger_associated_scripts(plug.printer_id, expected_state, db)
  521. # MQTT relay - publish smart plug state change
  522. if expected_state:
  523. try:
  524. from backend.app.services.mqtt_relay import mqtt_relay
  525. # Get printer name if linked
  526. printer_name = None
  527. if plug.printer_id:
  528. result = await db.execute(select(Printer).where(Printer.id == plug.printer_id))
  529. printer = result.scalar_one_or_none()
  530. printer_name = printer.name if printer else None
  531. await mqtt_relay.on_smart_plug_state(
  532. plug_id=plug.id,
  533. plug_name=plug.name,
  534. state="on" if expected_state == "ON" else "off",
  535. printer_id=plug.printer_id,
  536. printer_name=printer_name,
  537. )
  538. except Exception:
  539. pass # Don't fail if MQTT fails
  540. return {"success": True, "action": control.action}
  541. async def trigger_associated_scripts(printer_id: int, plug_state: str, db: AsyncSession):
  542. """Trigger scripts linked to a printer based on main plug state change.
  543. When the main plug turns ON, triggers scripts with auto_on=True.
  544. When the main plug turns OFF, triggers scripts with auto_off=True.
  545. """
  546. result = await db.execute(select(SmartPlug).where(SmartPlug.printer_id == printer_id))
  547. plugs = result.scalars().all()
  548. # Find scripts that should be triggered
  549. for plug in plugs:
  550. is_script = plug.plug_type == "homeassistant" and plug.ha_entity_id and plug.ha_entity_id.startswith("script.")
  551. if not is_script:
  552. continue
  553. should_trigger = False
  554. if plug_state == "ON" and plug.auto_on:
  555. should_trigger = True
  556. logger.info("Auto-triggering script '%s' on printer power-on", plug.name)
  557. elif plug_state == "OFF" and plug.auto_off:
  558. should_trigger = True
  559. logger.info("Auto-triggering script '%s' on printer power-off", plug.name)
  560. if should_trigger:
  561. try:
  562. service = await _get_service_for_plug(plug, db)
  563. await service.turn_on(plug) # Scripts are triggered by calling turn_on
  564. except Exception as e:
  565. logger.error("Failed to trigger script '%s': %s", plug.name, e)
  566. @router.get("/{plug_id}/status", response_model=SmartPlugStatus)
  567. async def get_plug_status(
  568. plug_id: int,
  569. db: AsyncSession = Depends(get_db),
  570. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_READ),
  571. ):
  572. """Get current plug status from device including energy data."""
  573. result = await db.execute(select(SmartPlug).where(SmartPlug.id == plug_id))
  574. plug = result.scalar_one_or_none()
  575. if not plug:
  576. raise HTTPException(404, "Smart plug not found")
  577. # Handle MQTT plugs - get data from subscription service
  578. if plug.plug_type == "mqtt":
  579. data = mqtt_relay.smart_plug_service.get_plug_data(plug_id)
  580. is_reachable = mqtt_relay.smart_plug_service.is_reachable(plug_id)
  581. if data:
  582. # Update last state in database
  583. if is_reachable and data.state:
  584. plug.last_state = data.state
  585. plug.last_checked = datetime.now(timezone.utc)
  586. await db.commit()
  587. energy_data = None
  588. if data.power is not None or data.energy is not None:
  589. energy_data = SmartPlugEnergy(
  590. power=data.power,
  591. today=data.energy,
  592. )
  593. # Check power alerts
  594. if data.power is not None:
  595. await check_power_alerts(plug, data.power, db)
  596. return SmartPlugStatus(
  597. state=data.state,
  598. reachable=is_reachable,
  599. device_name=None,
  600. energy=energy_data,
  601. )
  602. # No data received yet
  603. return SmartPlugStatus(
  604. state=None,
  605. reachable=False,
  606. device_name=None,
  607. energy=None,
  608. )
  609. # Handle Tasmota/HomeAssistant plugs
  610. service = await _get_service_for_plug(plug, db)
  611. status = await service.get_status(plug)
  612. # Update last state in database
  613. if status["reachable"]:
  614. plug.last_state = status["state"]
  615. plug.last_checked = datetime.now(timezone.utc)
  616. await db.commit()
  617. # Fetch energy data if device is reachable
  618. energy_data = None
  619. if status["reachable"]:
  620. energy = await service.get_energy(plug)
  621. if energy:
  622. energy_data = SmartPlugEnergy(**energy)
  623. # Check power alerts
  624. await check_power_alerts(plug, energy.get("power"), db)
  625. return SmartPlugStatus(
  626. state=status["state"],
  627. reachable=status["reachable"],
  628. device_name=status.get("device_name"),
  629. energy=energy_data,
  630. )
  631. async def check_power_alerts(plug: SmartPlug, current_power: float | None, db: AsyncSession):
  632. """Check if power crosses alert thresholds and send notifications."""
  633. if not plug.power_alert_enabled or current_power is None:
  634. return
  635. # Cooldown: don't alert more than once per 5 minutes
  636. cooldown_minutes = 5
  637. if plug.power_alert_last_triggered:
  638. last_triggered = plug.power_alert_last_triggered
  639. if last_triggered.tzinfo is None:
  640. last_triggered = last_triggered.replace(tzinfo=timezone.utc)
  641. time_since_last = datetime.now(timezone.utc) - last_triggered
  642. if time_since_last < timedelta(minutes=cooldown_minutes):
  643. return
  644. alert_triggered = False
  645. alert_type = None
  646. threshold = None
  647. # Check high threshold
  648. if plug.power_alert_high is not None and current_power > plug.power_alert_high:
  649. alert_triggered = True
  650. alert_type = "high"
  651. threshold = plug.power_alert_high
  652. # Check low threshold
  653. if plug.power_alert_low is not None and current_power < plug.power_alert_low:
  654. alert_triggered = True
  655. alert_type = "low"
  656. threshold = plug.power_alert_low
  657. if alert_triggered:
  658. plug.power_alert_last_triggered = datetime.now(timezone.utc)
  659. await db.commit()
  660. # Send notification
  661. title = f"Power Alert: {plug.name}"
  662. if alert_type == "high":
  663. message = f"Power consumption is {current_power:.1f}W, above threshold of {threshold:.1f}W"
  664. else:
  665. message = f"Power consumption is {current_power:.1f}W, below threshold of {threshold:.1f}W"
  666. logger.info("Power alert triggered for %s: %s", plug.name, message)
  667. # Use printer_error event type for power alerts (closest match)
  668. await notification_service.send_notification(
  669. event_type="printer_error",
  670. title=title,
  671. message=message,
  672. printer_id=plug.printer_id,
  673. printer_name=plug.name,
  674. context={
  675. "error_type": f"Power {alert_type.title()}",
  676. "error_detail": message,
  677. },
  678. )
  679. @router.post("/test-connection")
  680. async def test_connection(
  681. data: SmartPlugTestConnection,
  682. _: User | None = RequirePermissionIfAuthEnabled(Permission.SMART_PLUGS_CONTROL),
  683. ):
  684. """Test connection to a Tasmota device."""
  685. result = await tasmota_service.test_connection(
  686. data.ip_address,
  687. data.username,
  688. data.password,
  689. )
  690. if not result["success"]:
  691. raise HTTPException(503, result.get("error", "Failed to connect to device"))
  692. return {
  693. "success": True,
  694. "state": result["state"],
  695. "device_name": result.get("device_name"),
  696. }