diff --git a/models/dragino/lsn50-v2/docs/electrical-limits.md b/models/dragino/lsn50-v2/docs/electrical-limits.md new file mode 100644 index 0000000..cd9d58c --- /dev/null +++ b/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/`. \ No newline at end of file