Files
bambuddy/backend/app/services/print_scheduler.py
T
maziggy d48abe0f6a Add File Manager and enhanced Queue features
File Manager:
- Add full File Manager page for browsing local library files
- Implement folder hierarchy with create/rename/delete operations
- Add file uploads with drag-and-drop support
- Enable adding sliced files directly to print queue
- Add linked folders with external path mounting

Queue Enhancements:
- Add plate selection for multi-plate 3MF files
- Add print options (bed levelling, flow calibration, vibration
  calibration, layer inspection, timelapse, use AMS)
- Fix print_count increment to only occur on actual prints

Testing:
- Add backend integration tests for library API (15 tests)
- Add backend integration tests for queue print options (8 tests)
- Add frontend tests for EditQueueItemModal (10 tests)
- Suppress console noise in frontend test suite

Closes #94
2026-01-19 13:29:37 +01:00

392 lines
16 KiB
Python

"""Print scheduler service - processes the print queue."""
import asyncio
import logging
from datetime import datetime
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from backend.app.core.config import settings
from backend.app.core.database import async_session
from backend.app.models.archive import PrintArchive
from backend.app.models.print_queue import PrintQueueItem
from backend.app.models.printer import Printer
from backend.app.models.smart_plug import SmartPlug
from backend.app.services.bambu_ftp import delete_file_async, get_ftp_retry_settings, upload_file_async, with_ftp_retry
from backend.app.services.printer_manager import printer_manager
from backend.app.services.tasmota import tasmota_service
logger = logging.getLogger(__name__)
class PrintScheduler:
"""Background scheduler that processes the print queue."""
def __init__(self):
self._running = False
self._check_interval = 30 # seconds
self._power_on_wait_time = 180 # seconds to wait for printer after power on (3 min)
self._power_on_check_interval = 10 # seconds between connection checks
async def run(self):
"""Main loop - check queue every interval."""
self._running = True
logger.info("Print scheduler started")
while self._running:
try:
await self.check_queue()
except Exception as e:
logger.error(f"Scheduler error: {e}")
await asyncio.sleep(self._check_interval)
def stop(self):
"""Stop the scheduler."""
self._running = False
logger.info("Print scheduler stopped")
async def check_queue(self):
"""Check for prints ready to start."""
async with async_session() as db:
# Get all pending items, ordered by printer and position
result = await db.execute(
select(PrintQueueItem)
.where(PrintQueueItem.status == "pending")
.order_by(PrintQueueItem.printer_id, PrintQueueItem.position)
)
items = list(result.scalars().all())
if not items:
return
# Group by printer - only process first item per printer
processed_printers = set()
for item in items:
if item.printer_id in processed_printers:
continue
# Check scheduled time first (scheduled_time is stored in UTC from ISO string)
if item.scheduled_time and item.scheduled_time > datetime.utcnow():
continue
# Skip items that require manual start
if item.manual_start:
continue
# Check if printer is idle
printer_idle = self._is_printer_idle(item.printer_id)
printer_connected = printer_manager.is_connected(item.printer_id)
# If printer not connected, try to power on via smart plug
if not printer_connected:
plug = await self._get_smart_plug(db, item.printer_id)
if plug and plug.auto_on and plug.enabled:
logger.info(f"Printer {item.printer_id} offline, attempting to power on via smart plug")
powered_on = await self._power_on_and_wait(plug, item.printer_id, db)
if powered_on:
printer_connected = True
printer_idle = self._is_printer_idle(item.printer_id)
else:
logger.warning(f"Could not power on printer {item.printer_id} via smart plug")
processed_printers.add(item.printer_id)
continue
else:
# No plug or auto_on disabled
processed_printers.add(item.printer_id)
continue
# Check if printer is idle (busy with another print)
if not printer_idle:
processed_printers.add(item.printer_id)
continue
# Check condition (previous print success)
if item.require_previous_success:
if not await self._check_previous_success(db, item):
item.status = "skipped"
item.error_message = "Previous print failed or was aborted"
item.completed_at = datetime.now()
await db.commit()
logger.info(f"Skipped queue item {item.id} - previous print failed")
continue
# Start the print
await self._start_print(db, item)
processed_printers.add(item.printer_id)
def _is_printer_idle(self, printer_id: int) -> bool:
"""Check if a printer is connected and idle."""
if not printer_manager.is_connected(printer_id):
return False
state = printer_manager.get_status(printer_id)
if not state:
return False
# Printer is idle if state is IDLE or FINISH
return state.state in ("IDLE", "FINISH", "unknown")
async def _get_smart_plug(self, db: AsyncSession, printer_id: int) -> SmartPlug | None:
"""Get the smart plug associated with a printer."""
result = await db.execute(select(SmartPlug).where(SmartPlug.printer_id == printer_id))
return result.scalar_one_or_none()
async def _power_on_and_wait(self, plug: SmartPlug, printer_id: int, db: AsyncSession) -> bool:
"""Turn on smart plug and wait for printer to connect.
Returns True if printer connected successfully within timeout.
"""
# Check current plug state
status = await tasmota_service.get_status(plug)
if not status.get("reachable"):
logger.warning(f"Smart plug '{plug.name}' is not reachable")
return False
# Turn on if not already on
if status.get("state") != "ON":
success = await tasmota_service.turn_on(plug)
if not success:
logger.warning(f"Failed to turn on smart plug '{plug.name}'")
return False
logger.info(f"Powered on smart plug '{plug.name}' for printer {printer_id}")
# Get printer from database for connection
result = await db.execute(select(Printer).where(Printer.id == printer_id))
printer = result.scalar_one_or_none()
if not printer:
logger.error(f"Printer {printer_id} not found in database")
return False
# Wait for printer to boot (give it some time before trying to connect)
logger.info(f"Waiting 30s for printer {printer_id} to boot...")
await asyncio.sleep(30)
# Try to connect to the printer periodically
elapsed = 30 # Already waited 30s
while elapsed < self._power_on_wait_time:
# Try to connect
logger.info(f"Attempting to connect to printer {printer_id}...")
try:
connected = await printer_manager.connect_printer(printer)
if connected:
logger.info(f"Printer {printer_id} connected after {elapsed}s")
# Give it a moment to stabilize and get status
await asyncio.sleep(5)
return True
except Exception as e:
logger.debug(f"Connection attempt failed: {e}")
await asyncio.sleep(self._power_on_check_interval)
elapsed += self._power_on_check_interval
logger.debug(f"Waiting for printer {printer_id} to connect... ({elapsed}s)")
logger.warning(f"Printer {printer_id} did not connect within {self._power_on_wait_time}s after power on")
return False
async def _check_previous_success(self, db: AsyncSession, item: PrintQueueItem) -> bool:
"""Check if the previous print on this printer succeeded."""
# Find the most recent completed queue item for this printer
result = await db.execute(
select(PrintQueueItem)
.where(PrintQueueItem.printer_id == item.printer_id)
.where(PrintQueueItem.id != item.id)
.where(PrintQueueItem.status.in_(["completed", "failed", "skipped", "aborted"]))
.order_by(PrintQueueItem.completed_at.desc())
.limit(1)
)
prev_item = result.scalar_one_or_none()
# If no previous item, assume success (first in queue)
if not prev_item:
return True
return prev_item.status == "completed"
async def _power_off_if_needed(self, db: AsyncSession, item: PrintQueueItem):
"""Power off printer if auto_off_after is enabled (waits for cooldown)."""
if not item.auto_off_after:
return
plug = await self._get_smart_plug(db, item.printer_id)
if plug and plug.enabled:
logger.info(f"Auto-off: Waiting for printer {item.printer_id} to cool down before power off...")
# Wait for cooldown (up to 10 minutes)
await printer_manager.wait_for_cooldown(item.printer_id, target_temp=50.0, timeout=600)
logger.info(f"Auto-off: Powering off printer {item.printer_id}")
await tasmota_service.turn_off(plug)
async def _start_print(self, db: AsyncSession, item: PrintQueueItem):
"""Upload file and start print for a queue item."""
logger.info(f"Starting queue item {item.id}")
# Get archive
result = await db.execute(select(PrintArchive).where(PrintArchive.id == item.archive_id))
archive = result.scalar_one_or_none()
if not archive:
item.status = "failed"
item.error_message = "Archive not found"
item.completed_at = datetime.utcnow()
await db.commit()
logger.error(f"Queue item {item.id}: Archive {item.archive_id} not found")
await self._power_off_if_needed(db, item)
return
# Get printer
result = await db.execute(select(Printer).where(Printer.id == item.printer_id))
printer = result.scalar_one_or_none()
if not printer:
item.status = "failed"
item.error_message = "Printer not found"
item.completed_at = datetime.utcnow()
await db.commit()
logger.error(f"Queue item {item.id}: Printer {item.printer_id} not found")
await self._power_off_if_needed(db, item)
return
# Check printer is connected
if not printer_manager.is_connected(item.printer_id):
item.status = "failed"
item.error_message = "Printer not connected"
item.completed_at = datetime.utcnow()
await db.commit()
logger.error(f"Queue item {item.id}: Printer {item.printer_id} not connected")
await self._power_off_if_needed(db, item)
return
# Get file path
file_path = settings.base_dir / archive.file_path
if not file_path.exists():
item.status = "failed"
item.error_message = "Archive file not found on disk"
item.completed_at = datetime.utcnow()
await db.commit()
logger.error(f"Queue item {item.id}: File not found: {file_path}")
await self._power_off_if_needed(db, item)
return
# Upload file to printer via FTP
# Use a clean filename to avoid issues with double extensions like .gcode.3mf
base_name = archive.filename
if base_name.endswith(".gcode.3mf"):
base_name = base_name[:-10] # Remove .gcode.3mf
elif base_name.endswith(".3mf"):
base_name = base_name[:-4] # Remove .3mf
remote_filename = f"{base_name}.3mf"
# Upload to root directory (not /cache/) - the start_print command references
# files by name only (ftp://{filename}), so they must be in the root
remote_path = f"/{remote_filename}"
# Get FTP retry settings
ftp_retry_enabled, ftp_retry_count, ftp_retry_delay, ftp_timeout = await get_ftp_retry_settings()
# Delete existing file if present (avoids 553 error on overwrite)
try:
await delete_file_async(
printer.ip_address,
printer.access_code,
remote_path,
socket_timeout=ftp_timeout,
printer_model=printer.model,
)
except Exception:
pass # File may not exist, that's fine
try:
if ftp_retry_enabled:
uploaded = await with_ftp_retry(
upload_file_async,
printer.ip_address,
printer.access_code,
file_path,
remote_path,
socket_timeout=ftp_timeout,
printer_model=printer.model,
max_retries=ftp_retry_count,
retry_delay=ftp_retry_delay,
operation_name=f"Upload print to {printer.name}",
)
else:
uploaded = await upload_file_async(
printer.ip_address,
printer.access_code,
file_path,
remote_path,
socket_timeout=ftp_timeout,
printer_model=printer.model,
)
except Exception as e:
uploaded = False
logger.error(f"Queue item {item.id}: FTP error: {e}")
if not uploaded:
item.status = "failed"
item.error_message = "Failed to upload file to printer"
item.completed_at = datetime.utcnow()
await db.commit()
logger.error(f"Queue item {item.id}: FTP upload failed")
await self._power_off_if_needed(db, item)
return
# Register as expected print so we don't create a duplicate archive
from backend.app.main import register_expected_print
register_expected_print(item.printer_id, remote_filename, archive.id)
# Parse AMS mapping if stored
ams_mapping = None
if item.ams_mapping:
try:
import json
ams_mapping = json.loads(item.ams_mapping)
except json.JSONDecodeError:
logger.warning(f"Queue item {item.id}: Invalid AMS mapping JSON, ignoring")
# Start the print with AMS mapping, plate_id and print options
started = printer_manager.start_print(
item.printer_id,
remote_filename,
plate_id=item.plate_id or 1,
ams_mapping=ams_mapping,
bed_levelling=item.bed_levelling,
flow_cali=item.flow_cali,
vibration_cali=item.vibration_cali,
layer_inspect=item.layer_inspect,
timelapse=item.timelapse,
use_ams=item.use_ams,
)
if started:
item.status = "printing"
item.started_at = datetime.utcnow()
await db.commit()
logger.info(f"Queue item {item.id}: Print started - {archive.filename}")
# MQTT relay - publish queue job started
try:
from backend.app.services.mqtt_relay import mqtt_relay
await mqtt_relay.on_queue_job_started(
job_id=item.id,
filename=archive.filename,
printer_id=printer.id,
printer_name=printer.name,
printer_serial=printer.serial_number,
)
except Exception:
pass # Don't fail if MQTT fails
else:
item.status = "failed"
item.error_message = "Failed to send print command"
item.completed_at = datetime.utcnow()
await db.commit()
logger.error(f"Queue item {item.id}: Failed to start print")
await self._power_off_if_needed(db, item)
# Global scheduler instance
scheduler = PrintScheduler()