Añadir models/dragino/lsn50-v2/docs/electrical-limits.md

models/dragino/lsn50-v2/docs/electrical-limits.md

@@ -0,0 +1,54 @@
+# Límites y advertencias eléctricas — Dragino LSN50 v2
+
+## Objetivo
+
+Fijar las advertencias eléctricas relevantes del modelo base para evitar errores de integración en futuros kits.
+
+## Advertencia principal
+
+Las entradas digitales no deben recibir `5V` directos.
+
+En la documentación trabajada quedó claro que, cuando `PA12` subía demasiado, existía un riesgo real para el GPIO.
+
+## Caso documentado que originó esta advertencia
+
+En el trabajo con `PA12` se observaron:
+
+- tensiones intermedias
+- comportamiento inestable
+- riesgo de ver casi `5V` en la entrada
+- estados no correlacionados con la realidad física si la entrada quedaba flotante
+
+## Lección consolidada
+
+Los problemas reales fueron:
+
+- flotación o alta impedancia
+- inyección de niveles no compatibles
+- diagnóstico erróneo del bit del payload
+- interpretación de una línea conmutada como si fuese un `+5V` permanente
+
+## Consecuencia práctica
+
+Cuando un sensor externo pueda entregar `5V` o comportamientos ambiguos, hay que proteger la entrada con el circuito adecuado.
+
+En el caso documentado se resolvió con:
+
+- `pull-up`
+- diodo de bloqueo
+
+Pero ese circuito concreto pertenece al kit correspondiente, no al modelo base en abstracto.
+
+## Nota sobre la salida `+5V`
+
+La documentación trabajada deja claro que el `+5V` puede estar gestionado por firmware y no estar permanente.
+
+Por tanto:
+
+- no asumir que el rail `+5V` es constante
+- no asumir que una medición sin carga representa el comportamiento real
+- considerar siempre la lógica de ventana `5VT` cuando se use ese rail para alimentar un sensor
+
+## Recomendación documental
+
+Si en un futuro aparece otro kit basado en `LSN50 v2` con un sensor distinto, este archivo debe seguir siendo válido como advertencia base y el circuito concreto debe documentarse en `25-kits/`.