Files
OnEverControl/backend/app/services/hardware_service.py
T

124 lines
5.0 KiB
Python

# ==============================================================================
# Servicio de Integración de Hardware Industrial (ST1660 / pdtmdl)
# ==============================================================================
import time
from typing import Tuple, Dict, Any, Optional
from app.core.database import db_session
ASCII_STX = "\x02" # Start of text
ASCII_EOF = "\x03" # End of file
def calcular_checksum(comando: str) -> str:
"""Calcula el checksum de 2 dígitos hexadecimales idéntico a VB6 Protocolo.cls."""
raw = comando.encode("latin-1", errors="ignore")
checksum = 0
for b in raw:
checksum = (checksum + b) & 0xFF
checksum = ((0xFF - checksum) + 1) & 0xFF
return f"{checksum:02X}"
def formatear_comando_hardware(direccion: int, comando_payload: str) -> str:
"""Genera la trama física: STX + Addr(2) + Payload + CS(2) + EOF."""
direccion_str = f"{direccion:02d}"
base = f"{ASCII_STX}{direccion_str}{comando_payload}"
cs = calcular_checksum(base)
return f"{base}{cs}{ASCII_EOF}"
class HardwareService:
@staticmethod
def obtener_info_modulo(modulo_id: int) -> Optional[Dict[str, Any]]:
"""Obtiene address, tipo y configuración del módulo desde la tabla `mdl`."""
query = """
SELECT m.ModuloID, m.Nombre, m.Address, m.ModuloEntradaID, m.ModuloSalidaID,
m.duracion_pulso, m.ValidacionTicket
FROM mdl m
WHERE m.ModuloID = %s
"""
with db_session() as conn:
cursor = conn.cursor(as_dict=True)
cursor.execute(query, (modulo_id,))
return cursor.fetchone()
@classmethod
def encolar_apertura(cls, modulo_id: int, ticket_id: int = 0) -> Tuple[bool, Dict[str, Any]]:
"""
Encola un comando de apertura de barrera/molinete en la tabla `pdtmdl`
para que OnEverWPC lo despache al bus RS-485 físico de inmediato.
Resuelve automáticamente módulos virtuales (98, 97) hacia sus placas físicas (20, 21).
"""
t_start = time.perf_counter()
mdl = cls.obtener_info_modulo(modulo_id)
if not mdl:
return False, {"error": f"Módulo {modulo_id} no encontrado en base de datos"}
# 1. Obtener categorías de MdlCatVal para verificar si es Módulo Virtual (Cat 2 = 6) y Sentido (Cat 4)
cat_map = {}
try:
with db_session() as conn:
cursor = conn.cursor()
cursor.execute(
"SELECT CategoriaID, ValorID FROM MdlCatVal WHERE ModuloID = %s",
(modulo_id,),
)
cat_map = {row[0]: row[1] for row in cursor.fetchall()}
except Exception:
pass
tipo_modulo_id = cat_map.get(2, 0)
sentido_id = cat_map.get(4, 0)
nombre_upper = (mdl.get("Nombre") or "").upper()
# 2. Si es Módulo Virtual (tipo 6 o dirección virtual >= 90), resolver el módulo físico real
target_id = modulo_id
target_mdl = mdl
if tipo_modulo_id == 6 or mdl.get("Address", 0) >= 90:
if (sentido_id == 1 or "ENTRADA" in nombre_upper or "INGRESO" in nombre_upper) and mdl.get("ModuloEntradaID"):
target_id = mdl["ModuloEntradaID"]
elif (sentido_id == 2 or "SALIDA" in nombre_upper or "EGRESO" in nombre_upper) and mdl.get("ModuloSalidaID"):
target_id = mdl["ModuloSalidaID"]
if target_id != modulo_id:
fisico = cls.obtener_info_modulo(target_id)
if fisico:
target_mdl = fisico
address = target_mdl.get("Address", 1)
duracion = target_mdl.get("duracion_pulso") or 500
# 3. Comando universal de apertura por pulso de barrera (O3)
payload = "O3"
trama_comando = formatear_comando_hardware(address, payload)
sql_insert = """
INSERT INTO pdtmdl (PdtMdlID, ModuloID, Comando, Inmediato, Extra)
VALUES ((SELECT COALESCE(MAX(PdtMdlID), 0) + 1 FROM pdtmdl), %s, %s, 1, %s)
"""
extra_info = str(ticket_id or 0)[:20]
with db_session() as conn:
cursor = conn.cursor()
# Encolar para la placa física real (ej: Modulo 100009 con Addr 20 o Modulo 100013 con Addr 21)
cursor.execute(sql_insert, (target_id, trama_comando, extra_info))
# Si el módulo llamado era virtual, encolar también una entrada con el ID virtual
# pero con la trama física, garantizando compatibilidad con cualquier hilo de sondeo
if target_id != modulo_id:
cursor.execute(sql_insert, (modulo_id, trama_comando, extra_info))
latencia = (time.perf_counter() - t_start) * 1000
return True, {
"modulo_id": modulo_id,
"modulo_solicitado": modulo_id,
"modulo_fisico_target": target_id,
"address": address,
"address_fisico": address,
"payload": payload,
"comando_trama": trama_comando,
"latencia_ms": round(latencia, 2),
}